docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Struct TrackedDeviceModel

    Models a tracked device.

    Inherited Members
    ValueType.Equals(object)
    ValueType.GetHashCode()
    ValueType.ToString()
    object.Equals(object, object)
    object.GetType()
    object.ReferenceEquals(object, object)
    Namespace: UnityEngine.XR.Interaction.Toolkit.UI
    Assembly: Unity.XR.Interaction.Toolkit.dll
    Syntax
    public struct TrackedDeviceModel

    Constructors

    TrackedDeviceModel(int)

    Initializes and returns an instance of TrackedDeviceModel.

    Declaration
    public TrackedDeviceModel(int pointerId)
    Parameters
    Type Name Description
    int pointerId

    The pointer id.

    Properties

    changedThisFrame

    Checks whether this model has meaningfully changed this frame. This is used by the UI system to avoid excessive work. Use OnFrameFinished() to reset.

    Declaration
    public readonly bool changedThisFrame { get; }
    Property Value
    Type Description
    bool

    currentRaycast

    The last ray cast done for this model.

    Declaration
    public readonly RaycastResult currentRaycast { get; }
    Property Value
    Type Description
    RaycastResult
    See Also
    pointerCurrentRaycast

    currentRaycastEndpointIndex

    The endpoint index within the list of ray cast points that the currentRaycast refers to when a hit occurred. Otherwise, a value of 0 if no hit occurred.

    Declaration
    public readonly int currentRaycastEndpointIndex { get; }
    Property Value
    Type Description
    int
    See Also
    currentRaycast
    raycastPoints
    rayHitIndex

    isScrollable

    Tracks whether the current hovered UI elements support scrolling.

    Declaration
    public bool isScrollable { readonly get; set; }
    Property Value
    Type Description
    bool

    orientation

    The world starting orientation of the cast for the tracked device.

    Declaration
    public Quaternion orientation { get; set; }
    Property Value
    Type Description
    Quaternion

    pointerId

    (Read Only) A unique Id to identify this model from others within the UI system.

    Declaration
    public readonly int pointerId { get; }
    Property Value
    Type Description
    int

    position

    The world starting position of the cast for the tracked device.

    Declaration
    public Vector3 position { get; set; }
    Property Value
    Type Description
    Vector3

    raycastLayerMask

    Layer mask for ray casts.

    Declaration
    public LayerMask raycastLayerMask { get; set; }
    Property Value
    Type Description
    LayerMask

    raycastPoints

    A series of Ray segments used to hit UI.

    Declaration
    public List<Vector3> raycastPoints { get; set; }
    Property Value
    Type Description
    List<Vector3>
    Remarks

    A polygonal chain represented by a list of endpoints which form line segments to approximate the curve. Each line segment is where the ray cast starts and ends. World space coordinates.

    scrollDelta

    The amount of scroll since the last update.

    Declaration
    public Vector2 scrollDelta { get; set; }
    Property Value
    Type Description
    Vector2
    See Also
    scrollDelta

    select

    Whether or not the model should be selecting UI at this moment. This is the equivalent of left mouse down for a mouse.

    Declaration
    public bool select { get; set; }
    Property Value
    Type Description
    bool

    selectDelta

    Whether the state of the select option has changed this frame.

    Declaration
    public readonly ButtonDeltaState selectDelta { get; }
    Property Value
    Type Description
    ButtonDeltaState

    selectableObject

    Tracks the current selectable UI element being hovered

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

    Methods

    CopyFrom(TrackedDeviceEventData)

    Copies data from the UI Event Data to this model.

    Declaration
    public void CopyFrom(TrackedDeviceEventData eventData)
    Parameters
    Type Name Description
    TrackedDeviceEventData eventData

    The data to copy from.

    See Also
    CopyTo(TrackedDeviceEventData)

    CopyTo(TrackedDeviceEventData)

    Copies data from this model to the UI Event Data.

    Declaration
    public void CopyTo(TrackedDeviceEventData eventData)
    Parameters
    Type Name Description
    TrackedDeviceEventData eventData

    The event that copies the data.

    See Also
    CopyFrom(TrackedDeviceEventData)

    OnFrameFinished()

    To be called at the end of each frame to reset any tracking of changes within the frame.

    Declaration
    public void OnFrameFinished()
    See Also
    selectDelta
    changedThisFrame

    Reset(bool)

    Resets this object back to defaults.

    Declaration
    public void Reset(bool resetImplementation = true)
    Parameters
    Type Name Description
    bool resetImplementation

    If false, will reset only the external state of the object, and not internal, UI-used variables. Defaults to true.

    In This Article
    Back to top
    Copyright © 2024 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)