(Engine-Level Function)
Deprecated. Do not use in new code.
| Description: | Draws a chord in any window. |
| Returns: | Nothing |
Usage:  |
Steady State only. |
| Function Groups: | Graphics |
| Related to: | DrawArcPath | DrawEllipticalPath | DrawPath | DrawPiePath |
| Format: |
DrawChordPath(Left, Bottom, Right, Top, RotateAngle, Object, StartX, StartY, EndX, EndY) |
| Parameters: |
| Left |
| Required. Any numeric expression for the left side of the bounding box. |
| Bottom |
| Required. Any numeric expression for the bottom side of the bounding box. |
| Right |
| Required. Any numeric expression for the right side of the bounding box. |
| Top |
| Required. Any numeric expression for the top side of the bounding box. |
| RotateAngle |
| Required. Any numeric expression for the angle of rotation of the chord in degrees. This represents a rotation about the center of the bounding box. If it is greater than 0, the chord'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 chord 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 chord 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 chord. |
| 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 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 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 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 bounding box. |
| Comments: | This statement is intended for building drawing tools. The chord shape is drawn in white and is exclusive OR'ed onto the screen. The shape of the object is such that the angle defined by the two lines forms a flattened side to an ellipse (if the angle between the lines is less than 180 degrees), or a sliver that has been cut from the ellipse (if the angle is greater than 180 degrees). |
Example:
DrawChordPath(0, 500, 700, 0 { Bounding box for the chord },
90 { Rotate 90 degrees clockwise },
Self() { Draw in this module's window },
550, 470 { One line of angle },
750, 300 { Other line of angle });
This draws an small chord in the upper right hand corner of the screen, with its defining angle 90 degrees out of phase in the lower right hand corner.
