Skip to main content

class XRDisplayContext

(Niantic.Lightship.AR.Utilities.XRDisplayContext)

Overview​

Container for data relevant to rendering in relation to the XR camera's display

class XRDisplayContext {
	public:
		// fields
	
		 static float OccludeeEyeDepth = DefaultOccludeeEyeDepth;

		// methods
	
		static ScreenOrientation GetScreenOrientation();
	};

Detailed Documentation​

Container for data relevant to rendering in relation to the XR camera's display

Fields​

OccludeeEyeDepth​

static float OccludeeEyeDepth = DefaultOccludeeEyeDepth

Linear eye-depth from the camera to the occludee.

Methods​

GetScreenOrientation​

static ScreenOrientation GetScreenOrientation()

For Lightship, it is important to know the screen orientation in order to know how to rotate the camera input image received from the XRCameraSubsystem. The UnityEngine.Screen.orientation property only returns ScreenOrientation.Portrait when called in Editor, presumably because there is no rotation offset between the camera image and the displayed screen image in Editor. Thus, use this method to get the screen orientation value expected by Lightship's APIs, regardless of the active platform.

    Returns:

    The corrected screen orientation. When running XR in Lightship's Playback mode, the returned value will match the screen orientation recorded in the dataset's current frame. Else, will return the UnityEngine.Screen.orientation value.