sketch tessellate create command

Syntax

sketch tessellate create keyword ...

Primary keywords:

distance    elongation-angle    elongation-ratio    group    hexagonal    keep-domain    minimum-length    number    quad    tries    triangulation

Tessellate a user-specified domain by generating a collection of edges in Voronoi pattern (diagram) or in Trigon pattern. The operation starts with the generation of random seeds, which are then connected forming a Trigon pattern. If the user selects to generate a Voronoi pattern, the connecting lines from the previous step are bisected at the midpoints and perpendicular lines are drawn at these midpoints. This leads to creation of Voronoi vertices where three or more of such lines intersect, resulting in a Voronoi diagram. By the default, the number of Voronoi/Trigon blocks is limited to 10,000 and the maximum number of tries to generate random seeds satisfying provided criteria is limited to 100 (this can be changed using the keywords below).

The distribution of seeds and creation of edges is defined by the following keywords:

distance fmin <fmax >

Specify a distance range used during random generation of seeds. Only those seeds that fall within this range are accepted. If fmax is not specified, fmax = fmin is used. By the default, fmin = fmax = 1.0.

elongation-angle f

Specify the orientation (angle from the vertical v-axis) of the elongation direction of Voronoi/Trigon blocks.

elongation-ratio f

Specify the elongation ratio of Voronoi/Trigon blocks.

group s1 <slot s2 >

Assign group name s1 in slot s2 (if supplied) to the edges representing Voronoi/Trigon pattern. If slot keyword is omitted, slot Default is used.

hexagonal

The block seeds are arranged in a semi-regular hexagonal packing. The seeds spacing is chosen from a uniform distribution with minimum distance fmin and maximum distance fmax.

keep-domain b

If b = True, the domain is preserved. By the default, the domain is deleted each time after creating Voronoi/Trigon blocks.

minimum-length f

Edges shorter than this length will be removed and endpoints merged to provide fully connected Voronoi/Trigon pattern. By the default, minimum-length is set to 0.1.

number i

Specify the maximum number of blocks to be generated. By default, i = 10,000. The keyword is only active for random Voronoi/Trigon blocks generation (not the quad or hexagonal).

quad

The block seeds are arranged in a semi-regular quadrilateral packing. The seeds spacing is chosen from a uniform distribution with minimum distance fmin and maximum distance fmax.

tries i

Number of tries to fill specified region with Voronoi/Trigon blocks satisfying provided criteria. By default, i = 100. The keyword is only active for random Voronoi/Trigon pattern generation (not the quad or hexagonal).

triangulation

Fill the domain with triangular blocks using the Delaunay triangulation (Trigon pattern).