DrawArcPath

(Engine-Level Function)

Deprecated. Do not use in new code.

Description: Draws an arc in any window.
Returns: Nothing
Usage: Steady State only.
Function Groups: Graphics
Related to: DrawChordPath | DrawEllipticalPath | DrawPath | DrawPiePath
Format: DrawArcPath(Left, Bottom, Right, Top, RotateAngle, Object, StartX, StartY, EndX, EndY)
Parameters:  
Left   
Required. Any numeric expression for the left side of the arc's bounding box.
Bottom   
Required. Any numeric expression for the bottom side of the arc's bounding box.
Right   
Required. Any numeric expression for the right side of the arc's bounding box.
Top   
Required. Any numeric expression for the top side of the arc's bounding box.
RotateAngle   
Required. Any numeric expression for the angle of rotation of the arc in degrees. This represents a rotation about the center of the bounding box. If it is greater than 0, the arc's shape will still be defined by the proportions of the bounding box, but will no longer be within its (un-rotated) screen coordinates. Note that although the arc itself will rotate RotateAngle degrees, neither of the endpoints for the lines defined by StartX, StartY, and EndX, EndY will be affected (i.e. the arc will not 'line up' with the angled lines).
Object   
Required. Any expression for the object value that defines the window in which to draw the arc.
StartX   
Required. Any numeric expression for the X coordinate of an endpoint of a line that defines the starting angle. The other endpoint is the center of the arc's bounding box.
StartY   
Required. Any numeric expression for the Y coordinate of an endpoint of a line that defines the starting angle. The other endpoint is the center of the arc's bounding box.
EndX   
Required. Any numeric expression for the X coordinate of an endpoint of a line that defines the ending angle. The other endpoint is the center of the arc's bounding box.
EndY   
Required. Any numeric expression for the Y coordinate of an endpoint of a line that defines the ending angle. The other endpoint is the center of the arc's bounding box.
Comments: This statement is intended for building drawing tools. The arc is drawn in white and is exclusive OR'ed onto the screen.

Example:

  DrawArcPath(0, 500, 700, 0 { Bounding box for the arc },
              0 { No rotation occurs }, 
              Self() { Draw in this module's window },
              XLoc(), YLoc() { One angled line follows mouse },
              750, 300 { Other line of angle });  

This draws an arc on the screen that has a horizontal line at its 0 degree position and whose second line of its open angle follows the mouse. As the mouse moves and changes the angle of the two lines, the arc will follow its path, and more or less of it will appear.