sketch voronoi create command

Syntax

sketch voronoi create keyword ...

Primary keywords:

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

Generate a collection of edges in Voronoi pattern (diagram) within
a user-specified domain. Voronoi diagram creation starts with the generation of random seeds, which are then connected, and the connecting lines are bisected at the midpoints. Perpendicular lines are drawn at these midpoints, and Voronoi vertices are created where three or more lines intersect. This results in a Voronoi diagram. By the default, the number of Voronoi 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 Voronoi 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 blocks.

elongation-ratio f

Specify the elongation ratio of Voronoi blocks.

group s1 <slot s2 >

Assign group name s1 in slot s2 (if supplied) to the edges representing Voronoi diagram. 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 diagram.

minimum-length f

Edges shorter than this length will be removed and endpoints merged to provide fully connected Voronoi diagram. 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 diagram 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 blocks satisfying provided criteria. By default, i = 100. The keyword is only active for random Voronoi diagram generation (not the quad or hexagonal).