Public Member Functions
void	Initialize ()
	Creates and configures the stereo rendertextures.

void	ValidateNativeTexturePointers ()
	Determines whether the left/right texture handles are still valid, and resets them if needed.

void	GetNativeTexturePointers (out IntPtr leftTexHandle, out IntPtr rightTexHandle)
	Acquires the native output textures upon startup or invalidaiton.

void	SubmitPreviewTextures (GlassesMirrorMode glassesMirrorMode)
	Copies frame data from the HDR input textures to the onscreen preview textures.

Public Attributes
RenderTexture	LeftTexture_GLS
	The left eye rendertexture.

RenderTexture	RightTexture_GLS
	The right eye rendertexture.

RenderTexture	MonoPreviewTex
	The rendertexture used to display onscreen previews for the left or right eye camera.

RenderTexture	StereoPreviewTex
	The rendertexture used to display onscreen previews for the left and right eye cameras in stereo.

Properties
IntPtr	LeftTexHandle `[get, set]`
	The native pointer to the left eye rendertexture.

IntPtr	RightTexHandle `[get, set]`
	The native pointer to the right eye rendertexture.

Private Member Functions
void	CopyTexture (RenderTexture sourceTex, RenderTexture destinationTex, int xOffset=0)

Detailed Description

Definition at line 25 of file SplitStereoTextures.cs.

Member Function Documentation

◆ CopyTexture()

void TiltFive.SplitStereoTextures.CopyTexture	(	RenderTexture	sourceTex,
		RenderTexture	destinationTex,
		int	xOffset = `0`
	)

private

Definition at line 235 of file SplitStereoTextures.cs.

        {
            Graphics.CopyTexture(
                        sourceTex,
                        0,      // srcElement
                        0,      // srcMip
                        0, 0,   // src offset
                        sourceTex.width, sourceTex.height,  // src size
                        destinationTex,
                        0,      // dstElement
                        0,      // dstMip
                        xOffset, 0);  // dst offset
        }

Referenced by TiltFive.SplitStereoTextures.SubmitPreviewTextures().

◆ GetNativeTexturePointers()

void TiltFive.SplitStereoTextures.GetNativeTexturePointers	(	out IntPtr	leftTexHandle,
		out IntPtr	rightTexHandle
	)

Acquires the native output textures upon startup or invalidaiton.

This should be executed after all rendering is complete, including UI and post processing.

Definition at line 130 of file SplitStereoTextures.cs.

        {
            // If the native texture handles were reset by ValidateNativeTexturePointers(), reacquire them
            if(LeftTexHandle == IntPtr.Zero || RightTexHandle == IntPtr.Zero)
            {
                LeftTexHandle = LeftTexture_GLS.GetNativeTexturePtr();
                RightTexHandle = RightTexture_GLS.GetNativeTexturePtr();
            }
 
            leftTexHandle = LeftTexHandle;
            rightTexHandle = RightTexHandle;
        }

References TiltFive.SplitStereoTextures.LeftTexHandle, TiltFive.SplitStereoTextures.LeftTexture_GLS, TiltFive.SplitStereoTextures.RightTexHandle, and TiltFive.SplitStereoTextures.RightTexture_GLS.

Referenced by TiltFive.SplitStereoCamera.PresentStereoImages().

◆ Initialize()

void TiltFive.SplitStereoTextures.Initialize ( )

Creates and configures the stereo rendertextures.

Parameters

renderFormat_UGLS

Definition at line 71 of file SplitStereoTextures.cs.

        {
            LeftTexture_GLS = new RenderTexture(
                DisplaySettings.monoWidth,
                DisplaySettings.height,
                DisplaySettings.depthBuffer,
                DisplaySettings.nativeTextureFormat);
            LeftTexture_GLS.name = "Left Eye Output RenderTexture";
            RightTexture_GLS = new RenderTexture(
                DisplaySettings.monoWidth,
                DisplaySettings.height,
                DisplaySettings.depthBuffer,
                DisplaySettings.nativeTextureFormat);
            RightTexture_GLS.name = "Right Eye Output RenderTexture";
 
            MonoPreviewTex = new RenderTexture(
                DisplaySettings.monoWidth,
                DisplaySettings.height,
                DisplaySettings.depthBuffer,
                RenderTextureFormat.Default);
            MonoPreviewTex.name = "Mono Preview RenderTexture";
            StereoPreviewTex = new RenderTexture(
                DisplaySettings.stereoWidth,
                DisplaySettings.height,
                DisplaySettings.depthBuffer,
                RenderTextureFormat.Default);
            StereoPreviewTex.name = "Stereo Preview RenderTexture";
        }

References TiltFive.DisplaySettings.depthBuffer, TiltFive.DisplaySettings.height, TiltFive.SplitStereoTextures.LeftTexture_GLS, TiltFive.SplitStereoTextures.MonoPreviewTex, TiltFive.DisplaySettings.monoWidth, TiltFive.DisplaySettings.nativeTextureFormat, TiltFive.SplitStereoTextures.RightTexture_GLS, TiltFive.SplitStereoTextures.StereoPreviewTex, and TiltFive.DisplaySettings.stereoWidth.

Referenced by TiltFive.SplitStereoCamera.ConfigureEyeCameras().

◆ SubmitPreviewTextures()

void TiltFive.SplitStereoTextures.SubmitPreviewTextures ( GlassesMirrorMode glassesMirrorMode )

Copies frame data from the HDR input textures to the onscreen preview textures.

Parameters

glassesMirrorMode

Definition at line 147 of file SplitStereoTextures.cs.

        {
            var previewTex = glassesMirrorMode == GlassesMirrorMode.Stereoscopic ? StereoPreviewTex : MonoPreviewTex;
 
            switch (glassesMirrorMode)
            {
                case GlassesMirrorMode.LeftEye:
                    CopyTexture(LeftTexture_GLS, previewTex);
                    break;
                case GlassesMirrorMode.RightEye:
                    CopyTexture(RightTexture_GLS, previewTex);
                    break;
                case GlassesMirrorMode.Stereoscopic:
                    // Copy the two eyes' target textures to a double-wide texture, then display it onscreen.
                    CopyTexture(LeftTexture_GLS, previewTex);
                    CopyTexture(RightTexture_GLS, previewTex, LeftTexture_GLS.width);
                    break;
            }
        }

References TiltFive.SplitStereoTextures.CopyTexture(), TiltFive.SplitStereoTextures.LeftTexture_GLS, TiltFive.SplitStereoTextures.MonoPreviewTex, TiltFive.SplitStereoTextures.RightTexture_GLS, and TiltFive.SplitStereoTextures.StereoPreviewTex.

Referenced by TiltFive.SplitStereoCamera.OnRenderImage().

◆ ValidateNativeTexturePointers()

void TiltFive.SplitStereoTextures.ValidateNativeTexturePointers ( )

Determines whether the left/right texture handles are still valid, and resets them if needed.

This should be executed in OnPreRender(), otherwise IsCreated() always returns true

Definition at line 104 of file SplitStereoTextures.cs.

        {
            /* Render textures have a state (created or not created), and that state can be invalidated.
            There are a few ways this can happen, including the game switching to/from fullscreen,
            or the system screensaver being displayed. When this happens, the native texture pointers we
            pass to the native plugin are also invalidated, and garbage data gets displayed by the glasses.
 
            To fix this, we can check whether the state has been invalidated and reacquire a valid native texture pointer.
            RenderTexture's IsCreated() function reports false if the render texture has been invalidated.
            We must detect this change in OnPreRender(), because IsCreated() reports true within Update().
            If we detect that the render textures have been invalidated, we null out the cached pointers and reacquire.
            */
 
            // Check whether the render textures' states have been invalidated,
            // and reset the cached texture handles if so.
            if (!LeftTexture_GLS.IsCreated() || !RightTexture_GLS.IsCreated())
            {
                LeftTexHandle = System.IntPtr.Zero;
                RightTexHandle = System.IntPtr.Zero;
            }
        }

References TiltFive.SplitStereoTextures.LeftTexHandle, TiltFive.SplitStereoTextures.LeftTexture_GLS, TiltFive.SplitStereoTextures.RightTexHandle, and TiltFive.SplitStereoTextures.RightTexture_GLS.

Referenced by TiltFive.SplitStereoCamera.OnPreRender().

Member Data Documentation

◆ LeftTexture_GLS

RenderTexture TiltFive.SplitStereoTextures.LeftTexture_GLS

The left eye rendertexture.

This is used to send frame data to the glasses.

Definition at line 33 of file SplitStereoTextures.cs.

Referenced by TiltFive.SplitStereoCamera.ConfigureEyeCameras(), TiltFive.SplitStereoTextures.GetNativeTexturePointers(), TiltFive.SplitStereoTextures.Initialize(), TiltFive.SplitStereoCamera.PresentStereoImages(), TiltFive.SplitStereoTextures.SubmitPreviewTextures(), and TiltFive.SplitStereoTextures.ValidateNativeTexturePointers().

◆ MonoPreviewTex

RenderTexture TiltFive.SplitStereoTextures.MonoPreviewTex

The rendertexture used to display onscreen previews for the left or right eye camera.

Definition at line 56 of file SplitStereoTextures.cs.

Referenced by TiltFive.SplitStereoTextures.Initialize(), TiltFive.SplitStereoCamera.OnRenderImage(), and TiltFive.SplitStereoTextures.SubmitPreviewTextures().

◆ RightTexture_GLS

RenderTexture TiltFive.SplitStereoTextures.RightTexture_GLS

The right eye rendertexture.

This is used to send frame data to the glasses.

Definition at line 38 of file SplitStereoTextures.cs.

Referenced by TiltFive.SplitStereoCamera.ConfigureEyeCameras(), TiltFive.SplitStereoTextures.GetNativeTexturePointers(), TiltFive.SplitStereoTextures.Initialize(), TiltFive.SplitStereoCamera.PresentStereoImages(), TiltFive.SplitStereoTextures.SubmitPreviewTextures(), and TiltFive.SplitStereoTextures.ValidateNativeTexturePointers().

◆ StereoPreviewTex

RenderTexture TiltFive.SplitStereoTextures.StereoPreviewTex

The rendertexture used to display onscreen previews for the left and right eye cameras in stereo.

Definition at line 60 of file SplitStereoTextures.cs.

Referenced by TiltFive.SplitStereoTextures.Initialize(), and TiltFive.SplitStereoTextures.SubmitPreviewTextures().

Property Documentation

◆ LeftTexHandle

IntPtr TiltFive.SplitStereoTextures.LeftTexHandle

getsetprivate

The native pointer to the left eye rendertexture.

This is used to pass the left eye texture to unmanaged code

Definition at line 45 of file SplitStereoTextures.cs.

45{ get; set; }

Referenced by TiltFive.SplitStereoTextures.GetNativeTexturePointers(), and TiltFive.SplitStereoTextures.ValidateNativeTexturePointers().

◆ RightTexHandle

IntPtr TiltFive.SplitStereoTextures.RightTexHandle

getsetprivate

The native pointer to the right eye rendertexture.