Indicator

Summary

This function creates an indicator asset and places it in the virtual environment at a specified position. This is useful for adding markers or notes to guide users towards specific areas or assets.

Parameters

Target

Type: Text Default: None

Specifies the name or ARDI ID of the asset you would like to attach the indicator to. If using an asset ID, begin the target with the '#' character.

Text

Type: Text Default: HERE

This parameter allows you to specify the label of the indicator. The label will appear as text, centered on the indicator itself.

Offset

Type: XYZ Coordinates Default: 1,0,0

This parameter allows you to specify an offset value in XYZ Coordinates for which the indicator will be placed associated with the target asset.

Facing

Type: XYZ Coordinates Default: -1,0,0

This parameter allows you to specify an offset value in XYZ Coordinates for which the indicator will be rotated associated with the target asset.

Scale

Type: Float Default: 1

This parameter allows you to specify a scale value that will allow you to enlarge or shrink the indicator based on the amount specified. Values above 1 increase the size where as values below 1 will decrease the size.

Style

Type: Text Default: Large 2D

This parameter allows you to specify the style of the indicator.

These are the main styles that are available:

StyleEffect
Large 2D A large styled indicator with a tapering effect.
Small Top 2D A smaller indicator with an indentation pointing from the top of its side.
Small Mid 2D A smaller indicator with an indentation pointing from the middle of its side.
Speech Mid A speech bubble effect.

Color

Type: RGB Default: 0,1,0

This parameter allows you to specify a color for the indicator. Color is defined as normalized RGB values (values from 0.0 to 1.0) delimited by a ',' .

For example: A value of “0.5,0,1” will create a color with 50% red, 0% green and 100% blue applied to it.

LockToCamera

Type: Boolean Default: True

If true, this parameter will force the indicator to lock itself to the facing direction of the camera, making it so that the indicator always appears fully visible.

See Also

Examples

<indicator target="TankA" text="Primary Tank" offset="0,10,0" facing="-90,0,0" />
The above code will search for the asset named TankA and create an indicator attached to it positioned locally at 0,10,0 and rotated -90 on the X axis. It will have the text Primary Tank.