docs.unity3d.com
    Show / Hide Table of Contents

    Class TrackedDevicePhysicsRaycaster

    Physics-based UI Raycaster for Tracked Devices (e.g. XR Controllers). Detects UI elements with physics colliders attached to their GameObjects.

    Inheritance
    Object
    UIBehaviour
    BaseRaycaster
    TrackedDevicePhysicsRaycaster
    Inherited Members
    BaseRaycaster.ToString()
    BaseRaycaster.OnEnable()
    BaseRaycaster.OnDisable()
    BaseRaycaster.OnCanvasHierarchyChanged()
    BaseRaycaster.OnTransformParentChanged()
    BaseRaycaster.priority
    BaseRaycaster.sortOrderPriority
    BaseRaycaster.renderOrderPriority
    BaseRaycaster.rootRaycaster
    UIBehaviour.Start()
    UIBehaviour.OnDestroy()
    UIBehaviour.IsActive()
    UnityEngine.EventSystems.UIBehaviour.OnValidate()
    UnityEngine.EventSystems.UIBehaviour.Reset()
    UIBehaviour.OnRectTransformDimensionsChange()
    UIBehaviour.OnBeforeTransformParentChanged()
    UIBehaviour.OnDidApplyAnimationProperties()
    UIBehaviour.OnCanvasGroupChanged()
    UIBehaviour.IsDestroyed()
    Namespace: UnityEngine.XR.Interaction.Toolkit.UI
    Syntax
    [AddComponentMenu("Event/Tracked Device Physics Raycaster", 11)]
    [HelpURL("https://docs.unity3d.com/Packages/com.unity.xr.interaction.toolkit@2.0/api/UnityEngine.XR.Interaction.Toolkit.UI.TrackedDevicePhysicsRaycaster.html")]
    public class TrackedDevicePhysicsRaycaster : BaseRaycaster
    Remarks

    Does not need to be attached to any canvas. UI elements are any element inheriting from IEventSystemHandler. Designed to work with XRUIInputModule, which configures the final screen position once all hits are tallied.

    Properties

    eventCamera

    See BaseRaycaster.eventCamera.

    Declaration
    public override Camera eventCamera { get; }
    Property Value
    Type Description
    Camera
    Overrides
    BaseRaycaster.eventCamera

    eventMask

    Layer mask used to filter events. Always combined with the ray cast mask of the IUIInteractor.

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

    maxRayIntersections

    Max number of ray intersections allowed to be found.

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

    Value will be clamped to greater than 0.

    raycastTriggerInteraction

    Specifies whether the ray cast should hit triggers.

    Declaration
    public QueryTriggerInteraction raycastTriggerInteraction { get; set; }
    Property Value
    Type Description
    QueryTriggerInteraction

    Methods

    Awake()

    See MonoBehaviour.Awake.

    Declaration
    protected override void Awake()
    Overrides
    UIBehaviour.Awake()

    Raycast(PointerEventData, List<RaycastResult>)

    Performs a ray cast against all physics objects using this event.

    Declaration
    public override void Raycast(PointerEventData eventData, List<RaycastResult> resultAppendList)
    Parameters
    Type Name Description
    PointerEventData eventData

    Data containing where and how to ray cast.

    List<RaycastResult> resultAppendList

    The resultant hits from the ray cast.

    Overrides
    BaseRaycaster.Raycast(PointerEventData, List<RaycastResult>)
    Remarks

    Will only process events of type TrackedDeviceEventData.

    SetEventCamera(Camera)

    Sets the event camera for this ray caster. The event camera is used to determine the screen position and display of the ray cast results.

    Declaration
    public void SetEventCamera(Camera newEventCamera)
    Parameters
    Type Name Description
    Camera newEventCamera

    The new Camera to set as this ray caster's eventCamera.

    See Also

    PhysicsRaycaster
    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