Mnemonics

'ARC'

Define/Draw Arc

GUI Display/Printer 

Formats

1.

Draw Arc (Starting/Ending Angles)

'ARC'(x,y,radius,aspect,angle_1,angle_2)

2.

Draw Arc (Radial Coordinates)

'ARC'(x,y,radius,aspect,startRadialX,startRadialY,endRadialX,endRadialY)

Where:

angle_1

Angle (in degrees) measured counter clockwise from the right-center (3 o'clock) position of the arc circle to the starting point of the arc. Numeric expression.

angle_2

Angle (in degrees) measured counter clockwise from the right-center (3 o'clock) position of the arc circle to the ending point of the arc. Numeric expression.

aspect

Aspect ratio/viewpoint. (Ratio=1 results in no tilt.) Numeric expression.

startRadialX
startRadialY

Coordinates along a line that extends from the center of the drawing, in graphical units. The point where this line intersects with the arc circle defines the start of the arc. Numeric expression.

endRadialX
endRadialY

Coordinates along a line that extends from the center of the drawing, in graphical units. The point where this line intersects with the arc circle defines the end of the arc. Numeric expression.

radius

Radius of the arc circle, in graphical units. Numeric expression.

x,y

Coordinates for the center of the drawing, in graphical units. Numeric expression.

(Support for the Radial Coordinates format was added in PxPlus 2020.)

Description

Use 'ARC' to draw (print) an arc on the device. Use graphical units or @X(col) / @Y(line) functions for x,y and radius.

When drawing the arc, it can extend in either of two ways:

The 'ARC' mnemonic uses the current attributes for 'PEN' mnemonic.

For PDFs and Windows graphical drawing, entering a ratio=0 means no ratio. A ratio < 0 is invalid and results in an Error 29: Invalid Mnemonic or position specification.

See Also

@X(col) / @Y(line) Convert X/Y Coordinates
'PEN' Define Pen Style

Example

The examples below draw two different colored arcs. Aspect ratio=3 tilts the resulting drawing into an elliptical "shape". (Since this ellipsis is really two arcs as opposed to an enclosed shape, 'FILL' mnemonic attributes do not apply.)

Aspect ratio=1 joins the arcs in a circular shape instead.

 

print 'pen'(1,3,1)
print 'arc'(800,250,75,3,1,75)
print 'pen'(3,1,9)
print 'arc'(800,250,75,3,75,1)

 

print 'pen'(1,1,12)
print 'arc'(800,250,100,1,900,250,800,150)
print 'pen'(1,1,9)
print 'arc'(800,250,100,1,800,150,900,250)