Software Customisation Reference Manual

Name	Type	Purpose
Orientation	ORIENTATION Get/Set	Orientation of the arc.
Position	POSITION Get/Set	Origin/Centre of the arc.
Radius	REAL Get/Set	Radius of the arc
StartAngle	REAL Get/Set	Angle from X axes to start of the arc.
EndAngle	REAL Get/Set	Angle from X axes to end of the arc.
Sense	BOOLEAN Get/Set	Arc sense: ·0 for clockwise ·1 for anti-clockwise

Name	Result	Purpose
Arc( POSITION, ORIENTATION, REAL, REAL, REAL,BOOLEAN)	ARC	Creates an arc with the given Position, Orientation, Start Angle, End Angle, Radius. If the last argument is TRUE, the arc is clockwise.
String()	STRING	Returns the arc as a string

Name	Result	Purpose
StartPosition(POSITION)	ARC	Returns a new arc, based on the original, where the start angle, if defined as the angle from the centre of the arc through the passed position mapped onto the arc plane, forms the X axis.
EndPosition(POSITION)	ARC	As StartPosition, but for the EndAngle.
Through(POSITION)	ARC	Returns a new arc, where the radius (of the full circle) passes through the passed position when mapped onto the arc plane.
ChordHeight(REAL)	ARC	Returns a new arc, based on the original, where the EndAngle is in such a position to produce the passed chord height. Chord height > Radius or Chord height < 0 return unset objects. New arc should not produce subtended angle > 180.
Chord(REAL)	ARC	Returns a new arc, maintaining the original StartAngle, so the EndAngle is at the specified distance from the Start Chord length > Radius * 2 or < 0 return an unset object.
Circle()	ARC	Returns a full circle definition of the arc.
Circle(BOOLEAN)	ARC	Returns a full circle definition of the arc. If True, the arc is anti-clock-wise
Complement()	ARC	Returns the complementary arc of the arc definition (the remainder of the circle)

Name	Result	Purpose
AnglePosition(REAL)	POSITION	Returns the position at the specified angle on the arc.

Name	Result	Purpose
AngleDirection(REAL)	DIRECTION	Returns the direction from the centre of the arc through a point at the given angle from the X axis
StartTangent()	DIRECTION	Returns the direction out of the arc, tangential to the start angle line. The “sense” of the arc is used.
EndTangent()	DIRECTION	Returns the direction out of the arc, tangential to the end angle line. The “sense” of the arc is used.
AngleTangent(REAL)	DIRECTION	Returns the direction, tangential to the angle passed.

Name	Result	Purpose
XYOffset(POSITION)	XYPOSITION	Returns the position, mapped onto the arc plane, in term of an XY offset from the arc plane origin

Name	Result	Purpose
Proportion(REAL)	REAL	Returns the position, in terms of an angle from the X axis, at the proportion from the start angle of the arc: Angle = (EndAngle - StartAngle) * <real> + StartAngle
Angle()	REAL	Returns the subtended angle of the arc
Near(POSITION)	REAL	Returns the position, in terms of an angle from the X axis, to the position on the arc plane of the passed position

Name	Result	Purpose
Chord()	REAL	Returns the chord length between the start and end of the arc definition
Length()	REAL	Returns the true length of the arc line
ChordHeight()	REAL	Returns the chord height of the arc line

Name	Result	Purpose
Intersections(LINE)	REAL ARRAY	Returns the intersection points, in terms of angles from the X axis, of the passed line (mapped onto arc plane) with the circle defined by the arc
Intersections(PLANE)	REAL ARRAY	Returns the intersection points, in terms of angles from the X axis, of the passed plane with the circle defined by the arc
Intersections(ARC)	REAL ARRAY	Returns the intersection points, in terms of angles from the X axis, of the circle implied by the passed arc with the circle defined by the arc The Arcs must be in the same plane, i.e. the angle between Z components of the direction must be 0 or 180

Name	Result	Purpose
Tangents(POSITION)	REAL ARRAY	Returns the points of tangency on the arc circle from the passed position, in terms of angles from the X axis,
Tangents(ARC)	REAL ARRAY	Returns the points of tangency on the arc circle for the passed arc circle, in terms of angles from the X axis
Split()	REAL ARRAY	Splits the arc into a non-zero number of segments
Pole()	POSITION	Returns the pole position of the arc

Name	Result	Purpose
On(POSITION)	BOOLEAN	Returns true if the passed position lies on the arc line
OnProjected(POSITION)	BOOLEAN	Returns true if the passed position, when projected onto the arc line, lies within it
OnExtended(POSITION)	BOOLEAN	Returns true if the passed position, when mapped onto the arc line, lies outside it