Version: 2022.3
LanguageEnglish
  • C#

XRDisplaySubsystem

class in UnityEngine.XR

/

Inherits from:IntegratedSubsystem

/

Implemented in:UnityEngine.XRModule

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Description

An XRDisplaySubsystem controls rendering to a head tracked display.

Properties

contentProtectionEnabledSets or gets the state of content protection for the current active provider. For most providers, content protection allows you to use write only textures for rendering. This stops the ability for apps to read textures from the graphics card and view/record images that may be protected in some way.
disableLegacyRendererDisables the legacy renderer while this XRDisplaySubsystem is active.
displayOpaqueDetermines if the current attached device has an opaque display. Most VR devices are opaque in order to increase the immersive experience, AR devices are transparent to allow for interaction with an augmentation of the current environment.
foveatedRenderingFlagsControls optional behavior of the foveated rendering system.
foveatedRenderingLevelControls the intensity of the foveated rendering system.
hdrOutputSettingsThe HDROutputSettings for the XR Display Subsystem.
occlusionMaskScaleA scale applied to the standard occulsion mask.
reprojectionModeThe kind of reprojection the app requests to stabilize its holographic rendering relative to the user's head motion.
scaleOfAllRenderTargetsControls the size of the textures submitted to the display as a multiplier of the display's default resolution.
scaleOfAllViewportsControls how much of the allocated display texture should be used for rendering.
supportedTextureLayoutsSpecifies all texture layouts supported by this display subsystem. This var is a bit field that could be combination of XRDisplaySubsystem.TextureLayout.
textureLayoutSet DisplaySubsystem to use certain texture layout. Should query supported texture layout through XRDisplaySubsystem.supportedTextureLayouts first for the capabilities.
zFarSet DisplaySubsystem to use zFar for rendering.
zNearSet DisplaySubsystem to use zNear for rendering.

Public Methods

AddGraphicsThreadMirrorViewBlitThis function records the display subsystem's native blit event to the target command buffer. This function is typically called by a scriptable rendering pipeline.
BeginRecordingIfLateLatchedThis function enables late latching recording of constant buffer memory locations which are later patched with the latest pose data.
EndRecordingIfLateLatchedThis function disables late latching recording of constant buffer locations.
GetCullingParametersGets culling parameters for a specific culling pass index.
GetMirrorViewBlitDescGet a mirror view blit operation descriptor from the current display subsystem.
GetPreferredMirrorBlitModeReturns the XR display's preferred mirror blit mode.
GetRenderPassGets an XRRenderPass of a specific index.
GetRenderPassCountThe number of XRRenderPass entries for this XR Display.
GetRenderTextureGiven the UnityXRRenderTextureID returned by IUnityXRDisplayInterface::CreateTexture, return the managed UnityEngine.RenderTexture instance.
GetRenderTextureForRenderPassGiven a render pass, return the RenderTexture instance backing that render pass. If the render pass is invalid, or if the render texture does not exist, return null.
GetSharedDepthTextureForRenderPassGiven a render pass, return the shared depth buffer RenderTexture instance backing that render pass. If the render pass is invalid, or if the render texture does not exist, return null.
MarkTransformLateLatchedThis marks a given GameObject's transform to be late latched in the next frame. Once marked for late latching, the GameObject transform and its descendants will be updated with the latest VR pose updates before rendering is submitted to the GPU.
SetFocusPlaneSets a point in 3D space that acts as the focal point of the Scene for this frame. This helps to improve the visual fidelity of content around this point. You must set this value every frame. Note that specifying body-locked content in focus improves the fidelity of body-locked content at the expense of content not locked to the body. This is especially apparent when the user moves.
SetMSAALevelSet MSAA level for the DisplaySubsystem's render texture.
SetPreferredMirrorBlitModeOverride the XR display's preferred mirror blit mode from the script.
TryGetAppGPUTimeLastFrameRetrieves the time the GPU has spent on executing commands from the application's last frame, as reported by the XR Plugin. Measured in seconds.
TryGetCompositorGPUTimeLastFrameRetrieves the amount of time that the GPU spent executing the compositor renderer during the last frame, as reported by the XR Plugin. Measured in seconds.
TryGetDisplayRefreshRateRetrieves the refresh rate of the display as reported by the XR Plugin.
TryGetDroppedFrameCountRetrieves the number of dropped frames reported by the XR Plugin.
TryGetFramePresentCountRetrieves the number of times the current frame has been drawn to the device as reported by the XR Plugin.
TryGetMotionToPhotonRetrieves the motion-to-photon value as reported by the XR Plugin.

Events

displayFocusChangedEvent sent when XR display focus changes.

Inherited Members

Properties

runningWhether or not the subsystem is running.

Public Methods

DestroyDestroys this instance of a subsystem.
StartStarts an instance of a subsystem.
StopStops an instance of a subsystem.