Class XRRaycastSubsystem

Base class for a raycast subsystem.

Inheritance

object

SubsystemWithProvider

SubsystemWithProvider<XRRaycastSubsystem, XRRaycastSubsystemDescriptor, XRRaycastSubsystem.Provider>

TrackingSubsystem<XRRaycast, XRRaycastSubsystem, XRRaycastSubsystemDescriptor, XRRaycastSubsystem.Provider>

XRRaycastSubsystem

Implements

ISubsystem

Inherited Members

TrackingSubsystem<XRRaycast, XRRaycastSubsystem, XRRaycastSubsystemDescriptor, XRRaycastSubsystem.Provider>.GetChanges(Allocator)

SubsystemWithProvider<XRRaycastSubsystem, XRRaycastSubsystemDescriptor, XRRaycastSubsystem.Provider>.OnCreate()

SubsystemWithProvider<XRRaycastSubsystem, XRRaycastSubsystemDescriptor, XRRaycastSubsystem.Provider>.OnStart()

SubsystemWithProvider<XRRaycastSubsystem, XRRaycastSubsystemDescriptor, XRRaycastSubsystem.Provider>.OnStop()

SubsystemWithProvider<XRRaycastSubsystem, XRRaycastSubsystemDescriptor, XRRaycastSubsystem.Provider>.OnDestroy()

SubsystemWithProvider<XRRaycastSubsystem, XRRaycastSubsystemDescriptor, XRRaycastSubsystem.Provider>.subsystemDescriptor

SubsystemWithProvider<XRRaycastSubsystem, XRRaycastSubsystemDescriptor, XRRaycastSubsystem.Provider>.provider

SubsystemWithProvider.Start()

SubsystemWithProvider.OnStart()

SubsystemWithProvider.Stop()

SubsystemWithProvider.OnStop()

SubsystemWithProvider.Destroy()

SubsystemWithProvider.OnDestroy()

SubsystemWithProvider.running

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: UnityEngine.XR.ARSubsystems

Assembly: Unity.XR.ARSubsystems.dll

Syntax

public class XRRaycastSubsystem : TrackingSubsystem<XRRaycast, XRRaycastSubsystem, XRRaycastSubsystemDescriptor, XRRaycastSubsystem.Provider>, ISubsystem

Remarks

This abstract class should be implemented by an XR provider and instantiated using the SubsystemManager to enumerate the available XRRaycastSubsystemDescriptors.

Constructors

XRRaycastSubsystem()

Constructor. Do not invoke directly; use the SubsystemManager to enumerate the available XRRaycastSubsystemDescriptors and call Create on the desired descriptor.

Declaration

public XRRaycastSubsystem()

Methods

GetChanges(Allocator)

Get the changes to the tracked raycasts (arrays of added, updated and removed) since the last call to this method.

Declaration

public override TrackableChanges<XRRaycast> GetChanges(Allocator allocator)

Parameters

Type	Name	Description
Allocator	allocator	An allocator to use for the returned container.

Returns

Type	Description
TrackableChanges<XRRaycast>	The set of changes since the last call to this method. The caller owns the data and is responsible for calling Dispose() on it.

Overrides

TrackingSubsystem<XRRaycast, XRRaycastSubsystem, XRRaycastSubsystemDescriptor, XRRaycastSubsystem.Provider>.GetChanges(Allocator)

Raycast(Ray, TrackableType, Allocator)

Casts ray against trackables specified with trackableTypeMask.

Declaration

public NativeArray<XRRaycastHit> Raycast(Ray ray, TrackableType trackableTypeMask, Allocator allocator)

Parameters

Type	Name	Description
Ray	ray	A ray in session space.
TrackableType	trackableTypeMask	The types of trackables to test for ray intersections.
Allocator	allocator	The Allocator used to allocate the returned NativeArray.

Returns

Type	Description
NativeArray<XRRaycastHit>	A NativeArray of all the resulting ray intersections.

Raycast(Vector2, TrackableType, Allocator)

Casts a ray originating from screenPoint against trackables specified with trackableTypeMask.

Declaration

public NativeArray<XRRaycastHit> Raycast(Vector2 screenPoint, TrackableType trackableTypeMask, Allocator allocator)

Parameters

Type	Name	Description
Vector2	screenPoint	A point on the screen in normalized screen coordinates (0, 0) - (1, 1).
TrackableType	trackableTypeMask	The types of trackables to test for ray intersections.
Allocator	allocator	The Allocator used to allocate the returned NativeArray.

Returns

Type	Description
NativeArray<XRRaycastHit>	A NativeArray of all the resulting ray intersections.

RemoveRaycast(TrackableId)

Removes an existing raycast by its TrackableId.

Declaration

public void RemoveRaycast(TrackableId trackableId)

Parameters

Type	Name	Description
TrackableId	trackableId	The unique identifier for the raycast to remove.

TryAddRaycast(Ray, float, out XRRaycast)

Attempts to add a new persistent raycast. The raycast will be updated automatically until this subsystem is stopped or destroyed, or the the raycast is removed with RemoveRaycast(TrackableId).

Declaration

public bool TryAddRaycast(Ray ray, float estimatedDistance, out XRRaycast raycast)

Parameters

Type	Name	Description
Ray	ray	A ray relative to the session origin defining the raycast.
float	estimatedDistance	The estimated distance to the raycast target. For example, an average human height might be used to estimate the distance to the floor.
XRRaycast	raycast	The newly added raycast. All spatial data is relative to the session origin.

Returns

Type	Description
bool	True if the raycast was successfully added, or false otherwise.

TryAddRaycast(Vector2, float, out XRRaycast)

Attempts to add a new persistent raycast. The raycast will be updated automatically until this subsystem is stopped or destroyed, or the the raycast is removed with RemoveRaycast(TrackableId).

Declaration

public bool TryAddRaycast(Vector2 screenPoint, float estimatedDistance, out XRRaycast raycast)

Parameters

Type	Name	Description
Vector2	screenPoint	A point on the screen, in normalized screen coorindates (0, 0)..(1, 1).
float	estimatedDistance	The estimated distance to the raycast target. For example, an average human height might be used to estimate the distance to the floor.
XRRaycast	raycast	The newly added raycast. All spatial data is relative to the session origin.

Returns

Type	Description
bool	True if the raycast was successfully added, or false otherwise.

Implements

ISubsystem