=====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:

^**Style**^**Effect**^
|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: [[Bool]]
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====
[[addmesh]] [[addshape]] [[addbeacon]] [[addparticle]] [[remove]]
====Examples====

<code>
<indicator target="TankA" text="Primary Tank" offset="0,10,0" facing="-90,0,0" />
</code>

> 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**.