docs.unity3d.com
    Show / Hide Table of Contents

    Class ARTrackedImageManager

    A manager for ARTrackedImages. Uses the XRImageTrackingSubsystem to recognize and track 2D images in the physical environment.

    Inheritance
    Object
    SubsystemLifecycleManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor>
    ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, ARTrackedImage>
    ARTrackedImageManager
    Inherited Members
    ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, ARTrackedImage>.trackables
    ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, ARTrackedImage>.sessionOrigin
    ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, ARTrackedImage>.gameObjectName
    ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, ARTrackedImage>.GetPrefab()
    ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, ARTrackedImage>.m_Trackables
    ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, ARTrackedImage>.m_PendingAdds
    ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, ARTrackedImage>.Awake()
    ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, ARTrackedImage>.Update()
    ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, ARTrackedImage>.OnTrackablesChanged(List<ARTrackedImage>, List<ARTrackedImage>, List<ARTrackedImage>)
    ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, ARTrackedImage>.OnCreateTrackable(ARTrackedImage)
    ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, ARTrackedImage>.OnAfterSetSessionRelativeData(ARTrackedImage, XRTrackedImage)
    ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, ARTrackedImage>.CreateTrackableImmediate(XRTrackedImage)
    ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, ARTrackedImage>.DestroyPendingTrackable(TrackableId)
    SubsystemLifecycleManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor>.subsystem
    SubsystemLifecycleManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor>.descriptor
    SubsystemLifecycleManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor>.CreateSubsystem()
    SubsystemLifecycleManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor>.CreateSubsystemIfNecessary()
    SubsystemLifecycleManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor>.OnEnable()
    SubsystemLifecycleManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor>.OnDisable()
    SubsystemLifecycleManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor>.GetActiveSubsystemInstance()
    SubsystemLifecycleManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor>.OnDestroy()
    SubsystemLifecycleManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor>.OnBeforeStart()
    SubsystemLifecycleManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor>.OnAfterStart()
    Namespace: UnityEngine.XR.ARFoundation
    Syntax
    public sealed class ARTrackedImageManager : ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, ARTrackedImage>

    Properties

    gameObjectName

    The name to be used for the GameObject whenever a new image is detected.

    Declaration
    protected override string gameObjectName { get; }
    Property Value
    Type Description
    String
    Overrides
    UnityEngine.XR.ARFoundation.ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, UnityEngine.XR.ARFoundation.ARTrackedImage>.gameObjectName

    maxNumberOfMovingImages

    The maximum number of moving images to track in realtime. Support may vary between devices and providers. Check for support at runtime with .SubsystemDescriptor.supportsMovingImages.

    Declaration
    public int maxNumberOfMovingImages { get; set; }
    Property Value
    Type Description
    Int32

    referenceLibrary

    The XRReferenceImageLibrary to use during image detection. This is the library of images which will be detected and/or tracked in the physical environment.

    Declaration
    public XRReferenceImageLibrary referenceLibrary { get; set; }
    Property Value
    Type Description
    XRReferenceImageLibrary

    trackedImagePrefab

    If not null, instantiates this prefab for each detected image.

    Declaration
    public GameObject trackedImagePrefab { get; set; }
    Property Value
    Type Description
    GameObject

    Methods

    Awake()

    Initializes private members.

    Declaration
    protected override void Awake()
    Overrides
    UnityEngine.XR.ARFoundation.ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, UnityEngine.XR.ARFoundation.ARTrackedImage>.Awake()

    GetPrefab()

    Declaration
    protected override GameObject GetPrefab()
    Returns
    Type Description
    GameObject
    Overrides
    UnityEngine.XR.ARFoundation.ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, UnityEngine.XR.ARFoundation.ARTrackedImage>.GetPrefab()

    OnAfterSetSessionRelativeData(ARTrackedImage, XRTrackedImage)

    Declaration
    protected override void OnAfterSetSessionRelativeData(ARTrackedImage image, XRTrackedImage sessionRelativeData)
    Parameters
    Type Name Description
    ARTrackedImage image
    XRTrackedImage sessionRelativeData
    Overrides
    UnityEngine.XR.ARFoundation.ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, UnityEngine.XR.ARFoundation.ARTrackedImage>.OnAfterSetSessionRelativeData(UnityEngine.XR.ARFoundation.ARTrackedImage, XRTrackedImage)

    OnBeforeStart()

    Sets the image library on the subsystem before Start() is called on the XRImageTrackingSubsystem.

    Declaration
    protected override void OnBeforeStart()
    Overrides
    UnityEngine.XR.ARFoundation.SubsystemLifecycleManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor>.OnBeforeStart()

    OnTrackablesChanged(List<ARTrackedImage>, List<ARTrackedImage>, List<ARTrackedImage>)

    Invokes the trackedImagesChanged event.

    Declaration
    protected override void OnTrackablesChanged(List<ARTrackedImage> added, List<ARTrackedImage> updated, List<ARTrackedImage> removed)
    Parameters
    Type Name Description
    List<ARTrackedImage> added

    A list of images added this frame.

    List<ARTrackedImage> updated

    A list of images updated this frame.

    List<ARTrackedImage> removed

    A list of images removed this frame.

    Overrides
    UnityEngine.XR.ARFoundation.ARTrackableManager<XRImageTrackingSubsystem, XRImageTrackingSubsystemDescriptor, XRTrackedImage, UnityEngine.XR.ARFoundation.ARTrackedImage>.OnTrackablesChanged(List<UnityEngine.XR.ARFoundation.ARTrackedImage>, List<UnityEngine.XR.ARFoundation.ARTrackedImage>, List<UnityEngine.XR.ARFoundation.ARTrackedImage>)

    Events

    trackedImagesChanged

    Invoked once per frame with information about the ARTrackedImages that have changed, i.e., been added, updated, or removed. This happens just before ARTrackedImages are destroyed, so you can set ARTrackedImage.destroyOnRemoval to false from this event to suppress this behavior.

    Declaration
    public event Action<ARTrackedImagesChangedEventArgs> trackedImagesChanged
    Event Type
    Type Description
    Action<ARTrackedImagesChangedEventArgs>
    Back to top
    Terms of use
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023