===== Arc (Statement) =====

==== Format ====

**arc** [[numericexpressions|x_position]], [[numericexpressions|y_position]], [[numericexpressions|width]], [[numericexpressions|height]], [[numericexpressions|start_angle]], [[numericexpressions|width_angle]]\\
**arc** ( [[numericexpressions|x_position]], [[numericexpressions|y_position]], [[numericexpressions|width]], [[numericexpressions|height]], [[numericexpressions|start_angle]], [[numericexpressions|width_angle]] )\\
**arc** [[numericexpressions|center_x_position]], [[numericexpressions|center_y_position]], [[numericexpressions|radius]], [[numericexpressions|start_angle]], [[numericexpressions|width_angle]]\\
**arc** ( [[numericexpressions|center_x_position]], [[numericexpressions|center_y_position]], [[numericexpressions|radius]], [[numericexpressions|start_angle]], [[numericexpressions|width_angle]] )


==== Description ====

Draws an arc (part of a circle or ellipse) inside the rectangle defined by a bounding rectangle (defined by [[numericexpressions|x_position]], [[numericexpressions|y_position]], [[numericexpressions|width]], and [[numericexpressions|height]]) or by a square bounding a circle (defined by [[numericexpressions|center_x_position]], [[numericexpressions|center_y_position]], [[numericexpressions|radius]]).  The angles are defined from the 12 o'clock position in a clockwise direction in radians. 

Arc may also be used to draw an un-filled circle or an ellipse by defining the angular width to go all the way around (2*pi).

==== Example ====

<code>
# arc_example.kbs
# 2012-12-29 j.m.reneau
#
# example of arc statement added on 0.9.9.25

clg
color black
for t = 1 to 100 step 3
   arc 150-t,150-t,t*2,t*2,0,pi*2*t/100
next t
</code>
draws\\
{{:arc_example.png|arc_example}}


==== See Also ====
{{page>en:start#Graphics - Drawing&noheader}}

==== History ====
|0.9.9.25|New To Version|
|1.99.99.65|Added bounding square defined by circle|