Point

(Engine-Level Function)

Description:	Returns a two-dimensional point, or location, in a window.
Returns:	Point
Usage:	Steady State only.
Function Groups:	Graphics
Related to:	Path | Rotate | Trajectory | Vertex
Format:	Point(X, Y, Rotation, Trajectory)
Parameters:

X

Required. A numeric constant, that describes the reference x-axis location of the point. Expressions are not permitted here. If it is desired to change the x coordinate, use the Trajectory or Rotation parameters.

Y

Required. A numeric constant, that describes the reference y-axis location of the point. Expressions are not permitted here. If it is desired to change the y coordinate, use the Trajectory or Rotation parameters.

Rotation

Required. Any expression that returns a Rotate value. This specifies any translation of this point from its reference position (X, Y) by rotation about another point. If this is invalid, no rotation is performed, but the Point is still valid.

Trajectory

Required. Any expression that returns a Trajectory value. This specifies any translation of this point from its reference position of (X, Y) along a path. If this is invalid, no translation is performed, but the Point is still valid.

Comments:

A point describes an (x, y) location. Points may be animated to rotate around another point by specifying a Rotate value, or they may be animated to travel along a path by specifying a Trajectory value, both of which are described below. Points are used in certain functions (such as GUIChord), in the Rotate value, and in the Vertex value.

Examples:

centerPt = Point(489, 122.5, INVALID, INVALID);
startAnglePt = Point(609, 27, INVALID, INVALID);
endAnglePt = Point(586, 243, INVALID, INVALID);

This defines 3 points that are neither translated nor rotated. They can be used in a Vertex or a Rotate function, like in the following example.

GUIPie(395, 187, 583, 58 { Bounding box for pie },
       1, 1, 1, 1, 1, 0, 0 { No scaling, trajectory or rotation },
       1, 0 { Pie is visible; reserved },
       0, 0, 0 { Cannot be focused/selected },
       12, 15 { Red fill outlined in white },
       Vertex(1 { Double smooth },
       centerPt, startAnglePt, endAnglePt));