helix
Creates a modifier of a transformation along helical lines.
Signatures
- helix( vector axis, float angle )
- helix( vector onset, vector axis, float angle )
Details
The helix transformation is a space point transformation that rotates all space points around a given axis. The amount of the rotation, i.e., the rotation angle, changes linearly with the point's position along the axis, resulting in a helical twisting.
Note: The length of the axis vector is significant. The angle parameter defines the total rotation angle distributed evenly along the length of the axis vector. This means one full angle twist occurs along the length of the axis vector. Therefore, using a unit vector for the axis will result in a much tighter twist compared to using a longer vector.
Example
document.render_vis_smooth = true
make helix( <[0.5, 0.5, 1.0]>, <[0.0, 0.0, 1.0]>, PI/2.0 ) >>
subdiv( 0.05, <[0.0, 0.0, 1.0]> ) >> box()
Result of the example: helix transformation on a subdivided box.
Return value
A helix transformation modifier.
Parameters
- axis
-
Vector pointing in the helix direction. The length of this vector determines the distribution of the rotation angle.
- angle
-
Defines the angle of rotation (in radians) along the vector axis. Positive values follow a right-handed helix, negative values a left-handed one.
- onset
-
A space point that acts as the onset of the axis and thus as the origin of the helix transformation.
