| Line 1: |
Line 1: |
| | + | __NOTOC__ |
| | + | |
| | gc:'''drawArc''' is a function that is part of [[:Category:gc|gc]] (Graphics Context). | | gc:'''drawArc''' is a function that is part of [[:Category:gc|gc]] (Graphics Context). |
| | + | |
| | + | |
| | + | Draws an arc in the rectangle with upper left corner (x,y) and pixel ''width'' and ''height''. The arc is drawn beginning at ''startAngle'' degrees and ending at ''endAngle''. |
| | + | Zero degrees points to the right and 90 degrees points up (standard mathematical practice but worth mentioning since the y axis is inverted). |
| | + | |
| | {{Since|3.0}} | | {{Since|3.0}} |
| | | | |
| | == Syntax == | | == Syntax == |
| − | '''drawArc'''(arg1, arg2, arg3 [,arg4]) | + | gc:'''drawArc'''(x, y, width, height, start angle, finish angle) |
| | | | |
| | {| class="wikitable" | | {| class="wikitable" |
| Line 9: |
Line 16: |
| | ! Parameter !! Type !! Description | | ! Parameter !! Type !! Description |
| | |- | | |- |
| − | | <u><center>arg1</center></u> || TypeOfArg1 || Description of arg1 | + | | <u><center>x</center></u> || number || The x-coordinate of the upper-left point |
| | |- | | |- |
| − | | <u><center>arg2</center></u> || TypeOfArg2 || Description of arg2 | + | | <u><center>y</center></u> || number || The x-coordinate of the upper-left point |
| | |- | | |- |
| − | | <u><center>arg3</center></u> || TypeOfArg3 || Description of arg3 | + | | <u><center>width</center></u> || number || Width of the rectangle containing the arc |
| | |- | | |- |
| − | | <u><center>arg4</center></u> || TypeOfArg4 || Description of arg4 | + | | <u><center>height</center></u> || number || Height of the rectangle containing the arc |
| | + | |
| | + | |- |
| | + | | <u><center>start angle</center></u> || number || start angle |
| | + | |
| | + | |- |
| | + | | <u><center>finish angle</center></u> || number || finish angle |
| | |} | | |} |
| | | | |
| | == Example == | | == Example == |
| − | <syntaxhighlight></syntaxhighlight> | + | <syntaxhighlight>gc:drawArc(10, 10, 20, 30, 0, 120)</syntaxhighlight> |
| | + | |
| | + | == Good to know == |
| | + | |
| | + | To draw a circle, the width and height must be equal length and the start and end angles must be 0 and 360. If width and height are different lengths, this routine will draw an oval. |
| | | | |
| | <br /><br /> | | <br /><br /> |
| | | | |
| | [[Category:gc]] | | [[Category:gc]] |