=====ImageLabel=====

====Summary====

This function allows you to attach an image to the marker.

====Parameters====

===Image===

//Type: Text
Default: None//

This is the name of the image file to be attached to the marker. The image must be placed in the proper folder location as defined by the ARDI AR Script System.

The default location is:

**<scriptname>/<file name>**

===Name===

//Type: Text
Default: None//


Specifies the name of the object to be added to the marker. This name can be referred to later by other scripts in order to modify and/or interact with it in some way, such as with the [[remove_ar]] function. 

If an object of the same type has the same name, this script will modify the existing object instead of creating a new one.

===Offset===

//Type: [[XYZ Coordinates]]
Default: **0,0,0**//

This parameter allows you to specify the offset position of the image.

===Scale===

//Type: [[XY Coordinates]]
Default: **1,1**//

This parameter allows you to specify the width and height of the image.

===Rect===

//Type: [[Box]]
Default: **10,10,-10,-10**//

This parameter allows you to specify a specific rectangle width and height as offset co-ordinates to the marker. The image will resize and re-position to fit these co-ordinates. Co-ordinates are entered as **UpperLeftX,UpperLeftY,BottomRightX,BottomRightY**.


===Stays===

//Type: [[Bool]]
Default: **false**//

This parameter will allow you to force the image to remain visible even after the following Script Step.

===Facing===

//Type: [[XYZ Coordinates]]
Default:**90,0,0**//

This parameter allows you to specify the direction in which the Image Label is facing. Values are entered as **x,y,z** rotation values.

====Example====

<code>
  <imagelabel name="Device1Off" image="Device1/Off.png" rect="-140,-10,-120,10"/>
</code>

> The above code will create an image label using the graphic file **Off.png** that is stored on the asset **Device1**. The image will be placed relative to the marker using the [[Box]] values **-140,-10,-120,10**, where -140,-10 is the location of the upper left corner and -120,10 is the location of the bottom right corner in relation to the marker. It will also be given the name **Device1Off**, which can be referenced if it needs to be removed or modified on a later part of the script.
====See Also====
[[addmesh_ar]] [[addshape_ar]] [[indicator_ar]]