create3DArrow Method

Creates a new 3D arrow object on the terrain.

create3DArrow(headPosition, direction, length, height, [arrowStyle], [lineColor], [fillColor], [name]);

 

Parameter

Description

headPosition

The position of the arrow head

Can be one of the following: SGCoord3D, SGCoord2D, SGPosition

direction

The arrow direction.

An angle between 0º and 360º, where 0º is North and 180º is South

length

The arrow length from head to tail

Height

The height of the object from top to bottom (not its height above the ground).

arrowStyle

Optional, default: sgArrowStyleWideAngular

The arrow style

Can be one of the following: sgArrowStyleLine , sgArrowStyleLineTail, sgArrowStyleWide, sgArrowStyleWideAngular

lineColor

Optional, default: sgLime

The color of the object outline

It 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 3D arrow, access the node innerObj. See SGNode.innerObj property and ITerrain3DArrow5 interface for more details.

Unlike a 2D object (e.g., rectangle), a 3D object has volume and cannot be drawn on the terrain surface. Therefore, if specifying the position of a 3D object using  SGCoord2D, its height will be set to 0 and its height type will we set to sgHeightRelative.