arc_to
A circular arc to a point.
Signatures
- arc_to( vector via, vector to )
- arc_to( vector to, float radius )
- arc_to( vector to, float radius, bool right )
- arc_to( vector to, float radius, bool right, bool short )
- arc_to( vector to, float radius, bool right, bool short, vector normal )
- arc_to( vector to, vector axisA, float radB, bool right, bool short, vector normal )
Details
The arc_to curve segments adds a circular or elliptic arc to a curve. Constructors (1) to (5) generate circular arcs whereas constructor (6) generates an elliptical arc. The arc extends to the given target point to.
In the first constructor, the arc is defined by a given point that it shall pass.
The other constructors are defined by a specific radius or radial vector plus additional specifications.
The figure shows the four different options for an arc towards point to that can be addressed via the parameters right and short. (The normal points outward of the plane into the reader's direction.)
Parameters
- via
-
An intermediate point on the arc.
- to
-
The target point the arc is drawn to.
- radius
-
The radius of the circular arc.
- axisA
-
One of the two main axes vectors of an elliptic arc.
- radB
-
The radius in the other main axis direction of an elliptic arc.
- right
-
Determines whether the arc follows the right-hand rule (true) or not (false) (default: true).
- short
-
Determines whether the arc takes the shorter (true) or the longer (false) of the two possible routes (default: true).
- normal
-
Determines the axis direction of the arc circle. This should be mostly perpendicular to the connection vector between the formerly last point of the curve and to . If it is found to be parallel to this connection, an alternative orthogonal axis is used. (default: <[0,0,1]>).
