Purpose
Creates an arc object. You can issue this statement from the MapBasic window in MapInfo Pro.
Syntax
Create Arc
[ Into { Window window_id | Variable var_name } ]
( x1, y1 ) ( x2, y2 )
start_angle end_angle
[ Pen... ]window_id is a window identifier.
var_name is the name of an existing object variable.
x1, y1 specifies one corner of the minimum bounding rectangle (MBR) of an ellipse; the arc produced will be a section of this ellipse.
x2, y2 specifies the opposite corner of the ellipse's MBR.
start_angle specifies the arc's starting angle, in degrees.
end_angle specifies the arc's ending angle, in degrees.
The Pen clause specifies a line style.
Description
The Create Arc statement creates an arc object.
If the statement includes the optional Into Variable clause, the object will be stored in the specified object variable. If the Into clause specifies a window identifier, the object will be stored in the appropriate place in the window (for example, in the editable layer of a Map window). If the Into clause is not provided, MapBasic will attempt to store the object in the topmost window; if objects may not be stored in the topmost window (for example, if the topmost window is a grapher) no object will be created.
The x and y parameters use whatever coordinate system MapBasic is currently using. By default, MapBasic uses a Longitude/Latitude coordinate system, although the Set CoordSys statement can re-configure MapBasic to use a different coordinate system. Note that MapBasic's coordinate system is independent of the coordinate system of any Map window. Objects created on a Layout window, however, are specified in paper units: each x-coordinate represents a distance from the left edge of the page, while each y-coordinate represents the distance from the top edge of the page. For details about paper units, see Set Paper Units statement. By default, MapBasic uses inches as the default paper unit. To use a different paper unit, use the Set Paper Units statement. Before creating objects on a Layout window, you must issue a Set CoordSys Layout statement.
The optional Pen clause specifies a line style. If no Pen clause is specified, the Create Arc statement uses the current MapInfo Pro line style (the style which appears in the Line Style dialog box).
See Also:
Insert statement, Pen clause, Update statement, Set CoordSys statement