> For the complete documentation index, see [llms.txt](https://docs.overthereality.ai/over-sdk-manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.overthereality.ai/over-sdk-manual/sdk-editor/assets/ar-image-targets.md). # AR Image Targets ### **Before You Begin - Adding a New AR Image Target** * Select an image to be used as a target for recognition. * Visit .
* Upload the selected image. * Drop the image, enter a title, and specify the image’s width either in real-world units or after printing.
* Print the image. ### **Add AR Image Target in Scene** In the **Over SDK**, inside the **AR Image Targets** section, you will find a list of all the images you’ve previously added, as explained earlier in the setup process. Each image in the list is displayed with its associated details. When you select an image from the list, a "Spawn" button will appear in the corresponding cell. By clicking the "Spawn" button, the selected AR Image Target will be automatically added to your Unity scene, ready to be used for augmented reality tracking.
### **Display Objects with AR Image Targets** After successfully adding the AR Image Target asset to the scene, you can start attaching additional 3D objects to it. These objects should be added as **direct children** of the AR Image Target in the Unity hierarchy. Any 3D objects you attach will be displayed in the scene whenever the camera recognizes the corresponding image target in real-time. This allows you to create immersive AR experiences, with your 3D objects appearing in the exact position and orientation relative to the recognized image. Be sure to position the 3D objects correctly in the scene for accurate alignment when the target image is recognized.
### AR Image Target Behavior and Settings We provide various behaviors and configuration options for AR Image Targets. These settings allow you to control how objects interact with the image target, including visibility, behavior upon loss of tracking, and scaling according to the target size. By leveraging these options, you can customize the AR experience to suit your specific needs and create dynamic, engaging content. #### **Movable** This behavior makes the associated object respond dynamically to the AR Image Target. The object will disappear when the target is no longer visible or tracked, and it will scale in size based on the target’s dimensions. This behavior is useful when you want the object to adjust to changes in the target’s visibility and size. #### **Static** The object spawns when the image target is first detected and remains fixed in the AR scene thereafter. Even if the target is lost or its size changes, the object will stay in place and retain its original size, offering a stable presence. #### **Custom** This behavior exposes the relevant fields so that the user can select and configure them according to their needs. This allows the user to fine-tune how the object behaves when the image target is tracked or lost, including the options for hiding, stopping, and scaling. * **HideIfLost** - the object associated with the AR Image Target will be hidden if the target is no longer detected by the system * **StopIfLost** - this option causes the object to stop functioning if the image target is no longer detected. After losing track of the target, the object cannot be re-detected or resume its previous behavior until the target is brought back into view * **AssetFollowSize** - the object will scale in size based on the size of the AR Image Target --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.overthereality.ai/over-sdk-manual/sdk-editor/assets/ar-image-targets.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.