Modifier and Type	Class and Description
public static class	GenericStereoDeviceRenderer.GenericEye

Modifier and Type	Field and Description
private final GenericStereoDevice	device
private final int	distortionBits
private final GenericStereoDeviceRenderer.GenericEye[]	eyes
private final DimensionImmutable[]	eyeTextureSizes
private long	frameStart
private static final String	shaderChromaSuffix
private static final String	shaderPlainSuffix
private static final String	shaderPrefix01
private static final String	shaderTimewarpSuffix
private ShaderProgram	sp
private final int	textureCount
private final GLUniformData	texUnit0 if texUnit0 is null: no post-processing
private final DimensionImmutable	totalTextureSize
private final ViewerPose	viewerPose
private static final DimensionImmutable	zeroSize

Access	Constructor and Description
pack-priv	GenericStereoDeviceRenderer(final GenericStereoDevice context, final int distortionBits, final int textureCount, final float[] eyePositionOffset, final EyeParameter[] eyeParam, final float pixelsPerDisplayPixel, final int textureUnit, final DimensionImmutable[] eyeTextureSizes, final DimensionImmutable totalTextureSize, final RectangleImmutable[] eyeViewports)

Method Summary

Modifier and Type	Method and Description
public final void	beginFrame(final GL gl) Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.beginFrame. Notifying that a new frame is about to start.
public final void	dispose(final GL gl) Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.dispose. Release all OpenGL related resources
public final void	endFrame(final GL gl) Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.endFrame. Notifying that the frame has been rendered completely.
public StereoDevice	getDevice() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getDevice. Returns the `StereoDevice` of this `StereoDeviceRenderer` instance.
public final int	getDistortionBits() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getDistortionBits. Returns used distortion compensation bits, e.g. `DISTORTION_BARREL`, in case the stereoscopic display requires such, i.e. in case lenses are utilized.
public final StereoDeviceRenderer.Eye	getEye(final int eyeNum) Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getEye. Returns the `Eye` instance for the denoted `eyeNum`.
public final DimensionImmutable[]	getEyeSurfaceSize() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getEyeSurfaceSize. Returns the surface size for each eye's a single image in pixel units.
public final ViewerPose	getLastViewerPose() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getLastViewerPose. Returns the last `ViewerPose`.
public final int	getTextureCount() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getTextureCount. Returns the used texture-image count for post-processing, see `ppAvailable()`.
public final int	getTextureUnit() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getTextureUnit. Returns the desired texture-image unit for post-processing, see `ppAvailable()`.
public final DimensionImmutable	getTotalSurfaceSize() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getTotalSurfaceSize. Returns the total surface size required for the complete images in pixel units.
public final void	init(final GL gl) Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.init. Initialize OpenGL related resources
public final boolean	ppAvailable() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppAvailable. Returns `true` if stereoscopic post-processing is required and available, otherwise `false`.
public final void	ppBegin(final GL gl) Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppBegin. Begin stereoscopic post-processing, see `ppAvailable()`.
public final void	ppEnd(final GL gl) Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppEnd. End stereoscopic post-processing, see `ppAvailable()`.
public final void	ppOneEye(final GL gl, final int eyeNum) Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppOneEye. Performs stereoscopic post-processing for one eye, see `ppAvailable()`.
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.
public final ViewerPose	updateViewerPose() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.updateViewerPose. Updates the `ViewerPose` and returns it.
public final boolean	usesSideBySideStereo() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.usesSideBySideStereo. Method returns `true` if using side-by-side (SBS) stereoscopic images, otherwise `false`.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

Field Detail

device	back to summary
private final GenericStereoDevice device

distortionBits	back to summary
private final int distortionBits

eyes	back to summary
private final GenericStereoDeviceRenderer.GenericEye[] eyes

eyeTextureSizes	back to summary
private final DimensionImmutable[] eyeTextureSizes

frameStart	back to summary
private long frameStart

shaderChromaSuffix	back to summary
private static final String shaderChromaSuffix

shaderPlainSuffix	back to summary
private static final String shaderPlainSuffix

shaderPrefix01	back to summary
private static final String shaderPrefix01

shaderTimewarpSuffix	back to summary
private static final String shaderTimewarpSuffix

sp	back to summary
private ShaderProgram sp

textureCount	back to summary
private final int textureCount

texUnit0	back to summary
private final GLUniformData texUnit0 if texUnit0 is null: no post-processing

totalTextureSize	back to summary
private final DimensionImmutable totalTextureSize

viewerPose	back to summary
private final ViewerPose viewerPose

zeroSize	back to summary
private static final DimensionImmutable zeroSize

Constructor Detail

GenericStereoDeviceRenderer	back to summary
pack-priv GenericStereoDeviceRenderer(final GenericStereoDevice context, final int distortionBits, final int textureCount, final float[] eyePositionOffset, final EyeParameter[] eyeParam, final float pixelsPerDisplayPixel, final int textureUnit, final DimensionImmutable[] eyeTextureSizes, final DimensionImmutable totalTextureSize, final RectangleImmutable[] eyeViewports)

Method Detail

beginFrame	back to summary
public final void beginFrame(final GL gl) Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.beginFrame. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.beginFrame. Notifying that a new frame is about to start. Annotations @Override

beginFrame

back to summary

public final void beginFrame(final GL gl)

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.beginFrame.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.beginFrame.

Notifying that a new frame is about to start.

Annotations

@Override

dispose	back to summary
public final void dispose(final GL gl) Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.dispose. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.dispose. Release all OpenGL related resources Annotations @Override

dispose

back to summary

public final void dispose(final GL gl)

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.dispose.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.dispose.

Release all OpenGL related resources

Annotations

@Override

endFrame	back to summary
public final void endFrame(final GL gl) Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.endFrame. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.endFrame. Notifying that the frame has been rendered completely. Annotations @Override

endFrame

back to summary

public final void endFrame(final GL gl)

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.endFrame.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.endFrame.

Notifying that the frame has been rendered completely.

Annotations

@Override

getDevice back to summary

getDevice	back to summary
public StereoDevice getDevice() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getDevice. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getDevice. Returns the `StereoDevice` of this `StereoDeviceRenderer` instance. Annotations @Override

public StereoDevice getDevice()

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getDevice.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getDevice.

Returns the StereoDevice of this StereoDeviceRenderer instance.

Annotations

@Override

getDistortionBits back to summary

getDistortionBits	back to summary
public final int getDistortionBits() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getDistortionBits. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getDistortionBits. Returns used distortion compensation bits, e.g. `DISTORTION_BARREL`, in case the stereoscopic display requires such, i.e. in case lenses are utilized. Distortion requires `post-processing`. Annotations @Override

public final int getDistortionBits()

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getDistortionBits.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getDistortionBits.

Returns used distortion compensation bits, e.g. DISTORTION_BARREL, in case the stereoscopic display requires such, i.e. in case lenses are utilized.

Distortion requires post-processing.

Annotations

@Override

getEye back to summary

getEye	back to summary
public final StereoDeviceRenderer.Eye getEye(final int eyeNum) Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getEye. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getEye. Returns the `Eye` instance for the denoted `eyeNum`. Annotations @Override

public final StereoDeviceRenderer.Eye getEye(final int eyeNum)

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getEye.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getEye.

Returns the Eye instance for the denoted eyeNum.

Annotations

@Override

getEyeSurfaceSize	back to summary
public final DimensionImmutable[] getEyeSurfaceSize() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getEyeSurfaceSize. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getEyeSurfaceSize. Returns the surface size for each eye's a single image in pixel units. Annotations @Override

getEyeSurfaceSize

back to summary

public final DimensionImmutable[] getEyeSurfaceSize()

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getEyeSurfaceSize.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getEyeSurfaceSize.

Returns the surface size for each eye's a single image in pixel units.

Annotations

@Override

getLastViewerPose back to summary

getLastViewerPose	back to summary
public final ViewerPose getLastViewerPose() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getLastViewerPose. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getLastViewerPose. Returns the last `ViewerPose`. Annotations @Override

public final ViewerPose getLastViewerPose()

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getLastViewerPose.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getLastViewerPose.

Returns the last ViewerPose.

Annotations

@Override

getTextureCount back to summary

getTextureCount	back to summary
public final int getTextureCount() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getTextureCount. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getTextureCount. Returns the used texture-image count for post-processing, see `ppAvailable()`. In case the renderer does not support multiple textures for post-processing, or no post-processing at all, method returns zero despite the request from `StereoDevice#createRenderer(int, int, float[], com.jogamp.opengl.math.FovHVHalves[], float)`. Annotations @Override

public final int getTextureCount()

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getTextureCount.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getTextureCount.

Returns the used texture-image count for post-processing, see ppAvailable().

In case the renderer does not support multiple textures for post-processing, or no post-processing at all, method returns zero despite the request from StereoDevice#createRenderer(int, int, float[], com.jogamp.opengl.math.FovHVHalves[], float).

Annotations

@Override

getTextureUnit back to summary

getTextureUnit	back to summary
public final int getTextureUnit() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getTextureUnit. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getTextureUnit. Returns the desired texture-image unit for post-processing, see `ppAvailable()`. Annotations @Override

public final int getTextureUnit()

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getTextureUnit.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getTextureUnit.

Returns the desired texture-image unit for post-processing, see ppAvailable().

Annotations

@Override

getTotalSurfaceSize back to summary

getTotalSurfaceSize	back to summary
public final DimensionImmutable getTotalSurfaceSize() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getTotalSurfaceSize. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getTotalSurfaceSize. Returns the total surface size required for the complete images in pixel units. If `usesSideBySideStereo()` the total size spans over both `getEyeSurfaceSize()`, side-by-side. Otherwise the size is equal to `getEyeSurfaceSize()`. Annotations @Override

public final DimensionImmutable getTotalSurfaceSize()

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getTotalSurfaceSize.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.getTotalSurfaceSize.

Returns the total surface size required for the complete images in pixel units.

If usesSideBySideStereo() the total size spans over both getEyeSurfaceSize(), side-by-side.

Otherwise the size is equal to getEyeSurfaceSize().

Annotations

@Override

init	back to summary
public final void init(final GL gl) Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.init. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.init. Initialize OpenGL related resources Annotations @Override

init

back to summary

public final void init(final GL gl)

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.init.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.init.

Initialize OpenGL related resources

Annotations

@Override

ppAvailable back to summary

ppAvailable	back to summary
public final boolean ppAvailable() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppAvailable. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppAvailable. Returns `true` if stereoscopic post-processing is required and available, otherwise `false`. Stereoscopic post-processing is available if: one of the distortion bits are set, see `getDistortionBits()` If stereoscopic post-processing is used the following post-processing methods must be called to before `endFrame()`: `ppBegin(GL)` `ppOneEye(GL, int)` for both eyes `ppEnd(GL)` Annotations @Override

public final boolean ppAvailable()

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppAvailable.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppAvailable.

Returns true if stereoscopic post-processing is required and available, otherwise false.

Stereoscopic post-processing is available if:

one of the distortion bits are set, see getDistortionBits()

If stereoscopic post-processing is used the following post-processing methods must be called to before endFrame():

Annotations

@Override

ppBegin back to summary

ppBegin	back to summary
public final void ppBegin(final GL gl) Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppBegin. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppBegin. Begin stereoscopic post-processing, see `ppAvailable()`. `updateViewerPose(int)` for both eyes must be called upfront when rendering upstream `StereoGLEventListener`. Annotations @Override

public final void ppBegin(final GL gl)

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppBegin.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppBegin.

Begin stereoscopic post-processing, see ppAvailable().

updateViewerPose(int) for both eyes must be called upfront when rendering upstream StereoGLEventListener.

Annotations

@Override

ppEnd back to summary

ppEnd	back to summary
public final void ppEnd(final GL gl) Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppEnd. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppEnd. End stereoscopic post-processing, see `ppAvailable()`. Annotations @Override

public final void ppEnd(final GL gl)

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppEnd.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppEnd.

End stereoscopic post-processing, see ppAvailable().

Annotations

@Override

ppOneEye back to summary

ppOneEye	back to summary
public final void ppOneEye(final GL gl, final int eyeNum) Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppOneEye. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppOneEye. Performs stereoscopic post-processing for one eye, see `ppAvailable()`. Annotations @Override

public final void ppOneEye(final GL gl, final int eyeNum)

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppOneEye.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.ppOneEye.

Performs stereoscopic post-processing for one eye, see ppAvailable().

Annotations

@Override

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Doc from java.lang.Object.toString. Returns a string representation of the object. Returns:String a string representation of the object Annotations @Override

toString

back to summary

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object.

Returns:String

a string representation of the object

Annotations

@Override

updateViewerPose back to summary

updateViewerPose	back to summary
public final ViewerPose updateViewerPose() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.updateViewerPose. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.updateViewerPose. Updates the `ViewerPose` and returns it. Annotations @Override

public final ViewerPose updateViewerPose()

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.updateViewerPose.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.updateViewerPose.

Updates the ViewerPose and returns it.

Annotations

@Override

usesSideBySideStereo back to summary

usesSideBySideStereo	back to summary
public final boolean usesSideBySideStereo() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.usesSideBySideStereo. Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.usesSideBySideStereo. Method returns `true` if using side-by-side (SBS) stereoscopic images, otherwise `false`. SBS requires that both eye's images are presented side-by-side in the final framebuffer. Either the renderer presents the images side-by-side according to the `eye's viewport`, or `post-processing` is utilized to merge `textures` to a side-by-side configuration. Annotations @Override

public final boolean usesSideBySideStereo()

Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.usesSideBySideStereo.

Doc from com.jogamp.opengl.util.stereo.StereoDeviceRenderer.usesSideBySideStereo.

Method returns true if using side-by-side (SBS) stereoscopic images, otherwise false.

SBS requires that both eye's images are presented side-by-side in the final framebuffer.

Either the renderer presents the images side-by-side according to the eye's viewport, or post-processing is utilized to merge textures to a side-by-side configuration.

Annotations

@Override

jogamp.opengl.util.stereo back to summary

public Class GenericStereoDeviceRenderer.GenericEye

Class Inheritance

extends Object
implements Eye

java.lang.Object
jogamp.opengl.util.stereo.GenericStereoDeviceRenderer.GenericEye

All Implemented Interfaces

com.jogamp.opengl.util.stereo.StereoDeviceRenderer.Eye

Field Summary

Modifier and Type	Field and Description
private final int	distortionBits
private final int	eyeName
private final EyeParameter	eyeParameter
private final GLUniformData	eyeRotationEnd
private final GLUniformData	eyeRotationStart
private final GLUniformData	eyeToSourceUVOffset
private final GLUniformData	eyeToSourceUVScale
private final int	indexCount
private final GLArrayDataServer	indices
private final GLArrayDataServer	iVBO 2+2+2+2+2: { vec2 position, vec2 color, vec2 texCoordR, vec2 texCoordG, vec2 texCoordB }
private final GLArrayData	vboParams
private final GLArrayData	vboPos
private final GLArrayData	vboTexCoordsB
private final GLArrayData	vboTexCoordsG
private final GLArrayData	vboTexCoordsR
private final int	vertexCount
private final RectangleImmutable	viewport

Constructor Summary

Access	Constructor and Description
pack-priv	GenericEye(final GenericStereoDevice device, final int distortionBits, final float[] eyePositionOffset, final EyeParameter eyeParam, final DimensionImmutable textureSize, final RectangleImmutable eyeViewport)

Method Summary

Modifier and Type	Method and Description
pack-priv void	dispose(final GL2ES2 gl)
pack-priv void	enableVBO(final GL2ES2 gl, final boolean enable)
public final EyeParameter	getEyeParameter() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.Eye.getEyeParameter. Returns the `EyeParameter` of this eye.
public final RectangleImmutable	getViewport() Implements com.jogamp.opengl.util.stereo.StereoDeviceRenderer.Eye.getViewport. Returns the viewport for this eye.
private void	linkData(final GL2ES2 gl, final ShaderProgram sp)
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.
pack-priv void	updateUniform(final GL2ES2 gl, final ShaderProgram sp)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

Field Detail

distortionBits	back to summary
private final int distortionBits

eyeName	back to summary
private final int eyeName

eyeParameter	back to summary
private final EyeParameter eyeParameter

eyeRotationEnd	back to summary
private final GLUniformData eyeRotationEnd

eyeRotationStart	back to summary
private final GLUniformData eyeRotationStart

eyeToSourceUVOffset	back to summary
private final GLUniformData eyeToSourceUVOffset

eyeToSourceUVScale	back to summary
private final GLUniformData eyeToSourceUVScale

indexCount	back to summary
private final int indexCount

indices	back to summary
private final GLArrayDataServer indices

iVBO	back to summary
private final GLArrayDataServer iVBO 2+2+2+2+2: { vec2 position, vec2 color, vec2 texCoordR, vec2 texCoordG, vec2 texCoordB }

vboParams	back to summary
private final GLArrayData vboParams

vboPos	back to summary
private final GLArrayData vboPos

vboTexCoordsB	back to summary
private final GLArrayData vboTexCoordsB

vboTexCoordsG	back to summary
private final GLArrayData vboTexCoordsG

vboTexCoordsR	back to summary
private final GLArrayData vboTexCoordsR

vertexCount	back to summary
private final int vertexCount

viewport	back to summary
private final RectangleImmutable viewport

Constructor Detail

GenericEye	back to summary
pack-priv GenericEye(final GenericStereoDevice device, final int distortionBits, final float[] eyePositionOffset, final EyeParameter eyeParam, final DimensionImmutable textureSize, final RectangleImmutable eyeViewport)