Class AROcclusionManager

The manager for the occlusion subsystem.

Inheritance
object
Object
Component
Behaviour
MonoBehaviour
SubsystemLifecycleManager<XROcclusionSubsystem, XROcclusionSubsystemDescriptor, XROcclusionSubsystem.Provider>
AROcclusionManager
Inherited Members
Component.GetComponent<T>()
Component.TryGetComponent<T>(out T)
Component.GetComponentInChildren<T>()
Component.GetComponentsInChildren<T>()
Component.GetComponentInParent<T>()
Component.GetComponentsInParent<T>()
Component.GetComponents<T>()
Object.GetHashCode()
Object.InstantiateAsync<T>(T)
Object.InstantiateAsync<T>(T, Transform)
Object.InstantiateAsync<T>(T, Vector3, Quaternion)
Object.InstantiateAsync<T>(T, Transform, Vector3, Quaternion)
Object.Instantiate<T>(T)
Object.Instantiate<T>(T, Vector3, Quaternion)
Object.Instantiate<T>(T, Vector3, Quaternion, Transform)
Object.Instantiate<T>(T, Transform)
Object.DestroyObject(Object)
Object.FindObjectsOfType<T>()
Object.FindObjectsByType<T>(FindObjectsSortMode)
Object.FindObjectsByType<T>(FindObjectsInactive, FindObjectsSortMode)
Object.FindObjectOfType<T>()
Object.FindFirstObjectByType<T>()
Object.FindAnyObjectByType<T>()
Object.FindFirstObjectByType<T>(FindObjectsInactive)
Object.FindAnyObjectByType<T>(FindObjectsInactive)
Namespace: UnityEngine.XR.ARFoundation
Assembly: Unity.XR.ARFoundation.dll
Syntax
[DisallowMultipleComponent]
[DefaultExecutionOrder(-2147483647)]
public sealed class AROcclusionManager : SubsystemLifecycleManager<XROcclusionSubsystem, XROcclusionSubsystemDescriptor, XROcclusionSubsystem.Provider>

Properties

currentEnvironmentDepthMode

Get the current environment depth mode in use by the subsystem.

Declaration
public EnvironmentDepthMode currentEnvironmentDepthMode { get; }
Property Value
Type Description
EnvironmentDepthMode

currentHumanDepthMode

Get the current human segmentation depth mode in use by the subsystem.

Declaration
public HumanSegmentationDepthMode currentHumanDepthMode { get; }
Property Value
Type Description
HumanSegmentationDepthMode

currentHumanStencilMode

Get the current mode in use for generating the human segmentation stencil mode.

Declaration
public HumanSegmentationStencilMode currentHumanStencilMode { get; }
Property Value
Type Description
HumanSegmentationStencilMode

currentOcclusionPreferenceMode

Get the current occlusion preference mode in use by the subsystem.

Declaration
public OcclusionPreferenceMode currentOcclusionPreferenceMode { get; }
Property Value
Type Description
OcclusionPreferenceMode

environmentDepthConfidenceTexture

The environment depth confidence texture.

Declaration
public Texture2D environmentDepthConfidenceTexture { get; }
Property Value
Type Description
Texture2D

The environment depth confidence texture, if any. Otherwise, null.

environmentDepthTemporalSmoothingEnabled

Whether temporal smoothing is applied to the environment depth image. Query for support with environmentDepthTemporalSmoothingSupported.

Declaration
public bool environmentDepthTemporalSmoothingEnabled { get; }
Property Value
Type Description
bool

Read Only.

environmentDepthTemporalSmoothingRequested

Whether temporal smoothing should be applied to the environment depth image. Query for support with environmentDepthTemporalSmoothingSupported.

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

When true, temporal smoothing is applied to the environment depth image. Otherwise, no temporal smoothing is applied.

environmentDepthTexture

The environment depth texture.

Declaration
public Texture2D environmentDepthTexture { get; }
Property Value
Type Description
Texture2D

The environment depth texture, if any. Otherwise, null.

humanDepthTexture

The human segmentation depth texture.

Declaration
public Texture2D humanDepthTexture { get; }
Property Value
Type Description
Texture2D

The human segmentation depth texture, if any. Otherwise, null.

humanStencilTexture

The human segmentation stencil texture.

Declaration
public Texture2D humanStencilTexture { get; }
Property Value
Type Description
Texture2D

The human segmentation stencil texture, if any. Otherwise, null.

requestedEnvironmentDepthMode

Get or set the requested environment depth mode.

Declaration
public EnvironmentDepthMode requestedEnvironmentDepthMode { get; set; }
Property Value
Type Description
EnvironmentDepthMode

requestedHumanDepthMode

Get or set the requested human segmentation depth mode.

Declaration
public HumanSegmentationDepthMode requestedHumanDepthMode { get; set; }
Property Value
Type Description
HumanSegmentationDepthMode

requestedHumanStencilMode

The requested mode for generating the human segmentation stencil texture.

Declaration
public HumanSegmentationStencilMode requestedHumanStencilMode { get; set; }
Property Value
Type Description
HumanSegmentationStencilMode

requestedOcclusionPreferenceMode

Get or set the requested occlusion preference mode.

Declaration
public OcclusionPreferenceMode requestedOcclusionPreferenceMode { get; set; }
Property Value
Type Description
OcclusionPreferenceMode

Methods

OnBeforeStart()

Callback before the subsystem is started (but after it is created).

Declaration
protected override void OnBeforeStart()
Overrides

OnDisable()

Callback when the manager is being disabled.

Declaration
protected override void OnDisable()
Overrides

TryAcquireEnvironmentDepthConfidenceCpuImage(out XRCpuImage)

Attempt to get the latest environment depth confidence CPU image. This provides direct access to the raw pixel data.

Declaration
public bool TryAcquireEnvironmentDepthConfidenceCpuImage(out XRCpuImage cpuImage)
Parameters
Type Name Description
XRCpuImage cpuImage

If this method returns true, an acquired XRCpuImage.
Returns
Type Description
bool

Returns true if the CPU image was acquired. Returns false otherwise.
Remarks

The XRCpuImage must be disposed to avoid resource leaks.

TryAcquireEnvironmentDepthCpuImage(out XRCpuImage)

Attempt to get the latest environment depth CPU image. This provides direct access to the raw pixel data.

Declaration
public bool TryAcquireEnvironmentDepthCpuImage(out XRCpuImage cpuImage)
Parameters
Type Name Description
XRCpuImage cpuImage

If this method returns true, an acquired XRCpuImage.
Returns
Type Description
bool

Returns true if the CPU image was acquired. Returns false otherwise.
Remarks

The XRCpuImage must be disposed to avoid resource leaks.

TryAcquireHumanDepthCpuImage(out XRCpuImage)

Attempt to get the latest human depth CPU image. This provides direct access to the raw pixel data.

Declaration
public bool TryAcquireHumanDepthCpuImage(out XRCpuImage cpuImage)
Parameters
Type Name Description
XRCpuImage cpuImage

If this method returns true, an acquired XRCpuImage.
Returns
Type Description
bool

Returns true if the CPU image was acquired. Returns false otherwise.
Remarks

The XRCpuImage must be disposed to avoid resource leaks.

TryAcquireHumanStencilCpuImage(out XRCpuImage)

Attempt to get the latest human stencil CPU image. This provides directly access to the raw pixel data.

Declaration
public bool TryAcquireHumanStencilCpuImage(out XRCpuImage cpuImage)
Parameters
Type Name Description
XRCpuImage cpuImage

If this method returns true, an acquired XRCpuImage.
Returns
Type Description
bool

Returns true if the CPU image was acquired. Returns false otherwise.
Remarks

The XRCpuImage must be disposed to avoid resource leaks.

TryAcquireRawEnvironmentDepthCpuImage(out XRCpuImage)

Attempt to get the latest raw environment depth CPU image. This provides direct access to the raw pixel data.

Declaration
public bool TryAcquireRawEnvironmentDepthCpuImage(out XRCpuImage cpuImage)
Parameters
Type Name Description
XRCpuImage cpuImage

If this method returns true, an acquired XRCpuImage.
Returns
Type Description
bool

Returns true if the CPU image was acquired. Returns false otherwise.
Remarks
Note

The XRCpuImage must be disposed to avoid resource leaks. This differs from TryAcquireEnvironmentDepthCpuImage(out XRCpuImage) in that it always tries to acquire the raw environment depth image, whereas TryAcquireEnvironmentDepthCpuImage(out XRCpuImage) depends on the value of environmentDepthTemporalSmoothingEnabled.

TryAcquireSmoothedEnvironmentDepthCpuImage(out XRCpuImage)

Attempt to get the latest smoothed environment depth CPU image. This provides direct access to the raw pixel data.

Declaration
public bool TryAcquireSmoothedEnvironmentDepthCpuImage(out XRCpuImage cpuImage)
Parameters
Type Name Description
XRCpuImage cpuImage

If this method returns true, an acquired XRCpuImage.
Returns
Type Description
bool

Returns true if the CPU image was acquired. Returns false otherwise.
Remarks
Note

The XRCpuImage must be disposed to avoid resource leaks. This differs from TryAcquireEnvironmentDepthCpuImage(out XRCpuImage) in that it always tries to acquire the smoothed environment depth image, whereas TryAcquireEnvironmentDepthCpuImage(out XRCpuImage) depends on the value of environmentDepthTemporalSmoothingEnabled.

Update()

Callback as the manager is being updated.

Declaration
public void Update()

Events

frameReceived

An event which fires each time an occlusion camera frame is received.

Declaration
public event Action<AROcclusionFrameEventArgs> frameReceived
Event Type
Type Description
Action<AROcclusionFrameEventArgs>