Version: 2019.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.
reprojectionModeThe kind of reprojection the app requests to stabilize its holographic rendering relative to the user's head motion.
singlePassRenderingDisabledReturns true when single pass stereo rendering is disabled and returns false if otherwise.
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.
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.
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.
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.
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.