Creates a new ellipse object on the terrain.
createEllipse(position, radiusX, radiusY, [lineColor], [fillColor], [name]);
|
Parameter |
Description |
|
position |
The position of the object, defined by its coordinates in the 3D world Can be one of the following: SGCoord3D, SGCoord2D, SGPosition |
|
radiusX |
The radius of the ellipse along its X axis |
|
radiusY |
The radius of the ellipse along its Y axis |
|
lineColor |
Optional, default: sgLime The color of the object outline Can be one of the following: SGColor, HTML color string (e.g., “#FF0000”), a number that represents ABGR color (e.g., 0xAA0000FF) or one of the predefined Skyline Globe colors (e.g., sgRed). For a complete list of the predefined colors, see Skyline Globe Colors |
|
fillColor |
Optional, default: sgDimgray The color of the object filling Can be one of the following: SGColor, HTML color string (e.g., “#FF0000”), a number that represents ABGR color (e.g., 0xAA0000FF) or one of the predefined Skyline Globe colors (e.g., sgRed). For a complete list of the predefined colors, see Skyline Globe Colors |
|
name |
Optional The node name |
Return Value
An SGNode object. If the method fails, the return value is null. SGWorld.lastError will contain the failure reason.
Remarks
To modify other properties of the ellipse, access the node innerObj. See SGNode.innerObj property and ITerrainEllipse5 interface for more details.
The default ellipse is drawn on the terrain surface. To modify this behavior, change the heightType property of the position parameter (SGCoord3D and SGPosition object only). If SGCoord2D is entered as the first parameter, the ellipse will be drawn on the terrain surface.