Last updated
Last updated
The following parameters and flags are available for all //ezspline
subcommands.
<radii>
Defines the thickness (course) of the spline.
Acceptable values are: one or more comma-separated entries, where each entry is either:
A radius value (e.g., 10
, 6.9
). Radius values must be greater than 0.
A position and radius, separated by a colon, where the position is a decimal between 0 and 1 (e.g., 0:10
, 0.5:15.5
).
Whereby if specified, each position must be strictly ascending, and the first and last entries must be positions of 0
and 1
. If positions are omitted, they will be set and interpolated automatically.
For example
0.5:10
,
2
is illegal because the first entry, which is always position 0.0
, has been specified as position "0.5
"
5
,
0.6:10
,
15
,
0.4:20
,
5
is illegal because the positions are not in strictly ascending order since 0.4 came after 0.6.
-p <kbParameters>
Parameters for the flow of the spline. Determines what path the spline takes through the given node positions.
Provide <tension>:<bias>:<continuity>
, colon-separated in that order (default is 0:0:0
). The expected value range for each parameter is [-1..1]
.
(Note: the order in the diagram (c,t,b) is different than what ezspline expects (t,b,c).)
-q <quality>
Sets the number of samples of the shape per dimension per block. Must be greater than 0.
Defaults to 2.0
(which produces a mediocre result relatively quickly).
If you get air gaps, or a noise-y / unsmoothed appearance, set the quality to a higher value, e.g. -q 5.0
.
Higher values for the -q
parameter can significantly increase processing time. While small values (e.g., -q 2
) are relatively quick, larger values (e.g., -q 10
) may take minutes. Additionally, the benefit of increasing the -q
value diminishes beyond a certain point. We suggest using 2 while testing parameters and rendering with 4-6 for the final placement.
-r <startingRoll>
Allows to rotate the spline shape around the spline's axis, aka. rolling it. Expecting an angle given in degrees.
Defaults to 0
.
-s <stretchFactor>
Allows stretching or compressing the spline shape in the direction of the spline path.
Defaults to 0
.
Note: //ezspline structure
's and //ezspline expressions
's -z
flag overrides this flag. If -z
is on, then -s
does nothing.
-t <angle>
Defines how much to twist the shape along the spline. The input is an angle given in degrees.
Defaults to 0
. (Except for //ezsp rope
, there it's 90)
Specifics: The angle determines how much the shape is rotated throughout the length of the current diameter of the spline. Meaning, that if the diameter is 30 blocks, then after 30 blocks of path length, the shape will have rotated by the given angle.
-n <normalMode>
There are three modes:
CONSISTENT
aims to appear smooth and consistent by "rolling" the spline shape in curves.
HORIZONTAL
prevents the spline shape from "rolling sideways", keeping its initial orientation.
UPRIGHT
makes the internal spline shape's y-axis with the world's y-axis.
The default is CONSISTENT
.
-h
Prints the in-game help page. Shortcut for //help ezspline ...
shows what each parameter does.