Array Parameters

PreviousScatter Parameters NextSelections

Last updated 1 month ago

Array Parameters

and place multiple shapes along a path. The following parameters apply to these commands:

Distance: `-g <gap>`

Control how close all placements are by defining the gap distance between each placement.

Defaults to 0. Meaning, in a straight line each placement comes right after another with no gap.

Positive values will increase that distance and place fewer structures in total. Negative values cause the placements to overlap.

Examples

//ezarray Clipboard`` -g <gap> (with the clipboard being a default vanilla oak tree for no particular reason)

//ezar Cl`` -g 0 : (default value, placements are right next to each other)

//ezar Cl`` -g 10 : (placements are now further apart)

//ezar Cl`` -g -3 (negative values cause placements to overlap)

Progressive Scaling: `-q <radii>`

Similar to , this modifier allows scaling of the placements using relative values, e.g. 1 keeps the scale as is, 2 doubles the size, and 0.5 halfs the size.

The scaling factors are defined as a progression along the spline. This means you may specify as many comma-separated scaling factors as you like, and the spline path will smoothly interpolate through all entries.

The syntax is the same as in //ezspline:

Examples

//ezarray Clipboard`` -q <radii>

//ezar Cl`` -q 1

(default value, no scaling applied)

//ezar Cl`` -q 0.3,3

(placements are down-scaled by a factor of 0.3 at the beginning of the path and slowly get bigger up to triple their original size towards the end of the spline path)

//ezar Cl`` -q 1.5,0.5,5.0,2.0,0.2

(Tree is being scaled progressively through all given values throughout the spline path)

//ezar Cl`` -q 1.5,0.5,5.0,2.0,0.2 -o 0.7,1.3

(Combining progressive scaling -q with -o)

Path Parameters: `-p <kbParameters>`

Modifies how the path is created from the input (convex selection) points.

Spline orientation: `-n <normalMode>`

Modifies how the ORTHOGONAL option for the <primary> and <secondary> arguments behave.

Examples

//ezarray Clipboard Orthogonal Constant-n <normalMode>

//ezar Cl O C`` -n CONSISTENT

(default value)

//ezar Cl O C`` -n UPRIGHT

(placements are not as tilted anymore)

Snap placements to surfaces: `-b`

By default, structures are placed along the spline path that's induced by the input (convex selection) points. This flag moves the placement positions to the nearest surface block instead, in case the position on the path is in midair or submerged in blocks.

By default the maximum search range is 96 blocks. The maximum search range can be set in the config. If no surface block is found within that range, the original position will be used instead.

Example

GIF comparing

//ezarray Clipboard (placements are placed along path)

//ezarray Clipboard`` -b (placements positions moved to nearest surface block)

PreviousScatter Parameters NextSelections

Last updated 1 month ago

and place multiple shapes along a path. The following parameters apply to these commands:

Distance: `-g <gap>`

Control how close all placements are by defining the gap distance between each placement.

Defaults to 0. Meaning, in a straight line each placement comes right after another with no gap.

Positive values will increase that distance and place fewer structures in total. Negative values cause the placements to overlap.

Examples

//ezarray Clipboard`` -g <gap> (with the clipboard being a default vanilla oak tree for no particular reason)

//ezar Cl`` -g 0 : (default value, placements are right next to each other)

//ezar Cl`` -g 10 : (placements are now further apart)

//ezar Cl`` -g -3 (negative values cause placements to overlap)

Progressive Scaling: `-q <radii>`

Similar to , this modifier allows scaling of the placements using relative values, e.g. 1 keeps the scale as is, 2 doubles the size, and 0.5 halfs the size.

The syntax is the same as in //ezspline:

Examples

//ezarray Clipboard`` -q <radii>

//ezar Cl`` -q 1

(default value, no scaling applied)

//ezar Cl`` -q 0.3,3

(placements are down-scaled by a factor of 0.3 at the beginning of the path and slowly get bigger up to triple their original size towards the end of the spline path)

//ezar Cl`` -q 1.5,0.5,5.0,2.0,0.2

(Tree is being scaled progressively through all given values throughout the spline path)

//ezar Cl`` -q 1.5,0.5,5.0,2.0,0.2 -o 0.7,1.3

(Combining progressive scaling -q with -o)

Path Parameters: `-p <kbParameters>`

Modifies how the path is created from the input (convex selection) points.

See //ezspline documentation:

Spline orientation: `-n <normalMode>`

Modifies how the ORTHOGONAL option for the <primary> and <secondary> arguments behave.

See //ezspline documentation:

Examples

//ezarray Clipboard Orthogonal Constant-n <normalMode>

//ezar Cl O C`` -n CONSISTENT

(default value)

//ezar Cl O C`` -n UPRIGHT

(placements are not as tilted anymore)

Snap placements to surfaces: `-b`

By default the maximum search range is 96 blocks. The maximum search range can be set in the config. If no surface block is found within that range, the original position will be used instead.

Example

GIF comparing

//ezarray Clipboard (placements are placed along path)

//ezarray Clipboard`` -b (placements positions moved to nearest surface block)