com.jme3.input.vr.lwjgl_openvr

Class LWJGLOpenVR

java.lang.Object

com.jme3.input.vr.lwjgl_openvr.LWJGLOpenVR

All Implemented Interfaces:

VRAPI

public class LWJGLOpenVR
extends java.lang.Object
implements VRAPI

A class that wraps an OpenVR system.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.nio.IntBuffer	hmdErrorStore
protected org.lwjgl.openvr.TrackedDevicePose[]	hmdTrackedDevicePoses
protected Matrix4f[]	poseMatrices

Constructor Summary

Constructors

Constructor and Description
LWJGLOpenVR(VREnvironment environment) Create a new OpenVR system attached to the given VR environment.

Method Summary

Modifier and Type	Method and Description
static Matrix4f	convertSteamVRMatrix3ToMatrix4f(org.lwjgl.openvr.HmdMatrix34 hmdMatrix, Matrix4f mat) Convert specific OpenVR HmdMatrix34 into JME Matrix4f
static Matrix4f	convertSteamVRMatrix4ToMatrix4f(org.lwjgl.openvr.HmdMatrix44 hmdMatrix, Matrix4f mat) Convert specific OpenVR HmdMatrix34_t into JME Matrix4f
void	destroy() Close the link with underlying VR system and free all attached resources.
java.lang.Object	getCompositor() Get the object that wraps natively the VR compositor.
int	getDisplayFrequency() Get the Head Mounted Device (HMD) display frequency.
Matrix4f	getHMDMatrixPoseLeftEye() Returns the transform between the view space and left eye space.
Matrix4f	getHMDMatrixPoseRightEye() Returns the transform between the view space and right eye space.
Matrix4f	getHMDMatrixProjectionLeftEye(Camera cam) Get the Head Mounted Device (HMD) left eye projection matrix.
Matrix4f	getHMDMatrixProjectionRightEye(Camera cam) Get the Head Mounted Device (HMD) right eye projection matrix.
Vector3f	getHMDVectorPoseLeftEye() Get the Head Mounted Device (HMD) left eye pose (position of the eye from the head) as a vector.
Vector3f	getHMDVectorPoseRightEye() Get the Head Mounted Device (HMD) right eye pose (position of the eye from the head) as a vector.
float	getInterpupillaryDistance() Get the Head Mounted Device (HMD) interpupilar distance in meters.
java.lang.String	getName() Get the name of the underlying VR system.
Quaternion	getOrientation() Get the Head Mounted Device (HMD) orientation.
Matrix4f[]	getPoseMatrices()
Vector3f	getPosition() Get the Head Mounted Device (HMD) position.
void	getPositionAndOrientation(Vector3f storePos, Quaternion storeRot) Get the Head Mounted Device (HMD) position and orientation.
void	getRenderSize(Vector2f store) Get the size of a Head Mounted Device (HMD) rendering area in pixels.
Vector3f	getSeatedToAbsolutePosition() Get the seated to absolute position.
HmdType	getType() Get the Head Mounted Device (HMD) type.
LWJGLOpenVRInput	getVRinput() Get the input provided by the underlying VR system.
java.lang.Object	getVRSystem() Get the object that wraps natively the VR system.
long	initCamera(boolean allowed) Initialize the headset camera.
boolean	initialize() Initialize this object from a VR system.
boolean	initVRCompositor(boolean allowed) Initialize the VR compositor that will be used for rendering.
boolean	isInitialized() Check if the VR API is initialized.
void	printLatencyInfoToConsole(boolean set) Set if latency information has to be logged.
void	reset() Reset the VR system.
void	setFlipEyes(boolean set) Flip the left and right eye.
void	setTrackingSpace(boolean isSeated)
void	updatePose() Update Head Mounted Device (HMD) pose internal storage.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

hmdTrackedDevicePoses

protected org.lwjgl.openvr.TrackedDevicePose[] hmdTrackedDevicePoses

hmdErrorStore

protected java.nio.IntBuffer hmdErrorStore

poseMatrices

protected Matrix4f[] poseMatrices

Constructor Detail

LWJGLOpenVR

public LWJGLOpenVR(VREnvironment environment)

Create a new OpenVR system attached to the given VR environment.

Parameters:

environment - the VR environment to which this API is attached.

Method Detail

convertSteamVRMatrix3ToMatrix4f

public static Matrix4f convertSteamVRMatrix3ToMatrix4f(org.lwjgl.openvr.HmdMatrix34 hmdMatrix,
                                                       Matrix4f mat)

Convert specific OpenVR HmdMatrix34 into JME Matrix4f

Parameters:

hmdMatrix - the input matrix

mat - the converted matrix

Returns:

the converted matrix

convertSteamVRMatrix4ToMatrix4f

public static Matrix4f convertSteamVRMatrix4ToMatrix4f(org.lwjgl.openvr.HmdMatrix44 hmdMatrix,
                                                       Matrix4f mat)

Convert specific OpenVR HmdMatrix34_t into JME Matrix4f

Parameters:

hmdMatrix - the input matrix

mat - the converted matrix

Returns:

the converted matrix

getVRinput

public LWJGLOpenVRInput getVRinput()

Description copied from interface: VRAPI

Get the input provided by the underlying VR system.

Specified by:

getVRinput in interface VRAPI

Returns:

the input provided by the underlying VR system.

getVRSystem

public java.lang.Object getVRSystem()

Description copied from interface: VRAPI

Get the object that wraps natively the VR system.

Specified by:

getVRSystem in interface VRAPI

Returns:

the object that wraps natively the VR system.

getCompositor

public java.lang.Object getCompositor()

Description copied from interface: VRAPI

Get the object that wraps natively the VR compositor.

Specified by:

getCompositor in interface VRAPI

Returns:

the object that wraps natively the VR system.

getName

public java.lang.String getName()

Description copied from interface: VRAPI

Get the name of the underlying VR system.

Specified by:

getName in interface VRAPI

Returns:

the name of the underlying VR system.

setFlipEyes

public void setFlipEyes(boolean set)

Description copied from interface: VRAPI

Flip the left and right eye.

Specified by:

setFlipEyes in interface VRAPI

Parameters:

set - true if the eyes has to be flipped and false otherwise.

printLatencyInfoToConsole

public void printLatencyInfoToConsole(boolean set)

Description copied from interface: VRAPI

Set if latency information has to be logged.

Specified by:

printLatencyInfoToConsole in interface VRAPI

Parameters:

set - true if latency information has to be logged and false otherwise.

getDisplayFrequency

public int getDisplayFrequency()

Description copied from interface: VRAPI

Get the Head Mounted Device (HMD) display frequency.

Specified by:

getDisplayFrequency in interface VRAPI

Returns:

the Head Mounted Device (HMD) display frequency.

initialize

public boolean initialize()

Description copied from interface: VRAPI

Initialize this object from a VR system. All the native bindings to underlying VR system should be done within this method.

Specified by:

initialize in interface VRAPI

Returns:

true if the initialization is a success and false otherwise.

initVRCompositor

public boolean initVRCompositor(boolean allowed)

Description copied from interface: VRAPI

Initialize the VR compositor that will be used for rendering.

Specified by:

initVRCompositor in interface VRAPI

Parameters:

allowed - true if the use of VR compositor is allowed and false otherwise.

Returns:

true if the initialization is a success and false otherwise.

initCamera

public long initCamera(boolean allowed)

Initialize the headset camera.

Parameters:

allowed - true is the use of the headset camera is allowed and false otherwise.

Returns:

token for camera

destroy

public void destroy()

Description copied from interface: VRAPI

Close the link with underlying VR system and free all attached resources.

Specified by:

destroy in interface VRAPI

isInitialized

public boolean isInitialized()

Description copied from interface: VRAPI

Check if the VR API is initialized.

Specified by:

isInitialized in interface VRAPI

Returns:

true if the VR API is initialized and false otherwise.

See Also:

VRAPI.initialize()

reset

public void reset()

Description copied from interface: VRAPI

Reset the VR system. After a call to this method, the current position of the HMD should be the origin (i-e the observer without any combined transformation).

Specified by:

reset in interface VRAPI

getRenderSize

public void getRenderSize(Vector2f store)

Description copied from interface: VRAPI

Get the size of a Head Mounted Device (HMD) rendering area in pixels.

Specified by:

getRenderSize in interface VRAPI

Parameters:

store - the size of a Head Mounted Device (HMD) rendering area in pixels (modified).

getInterpupillaryDistance

public float getInterpupillaryDistance()

Description copied from interface: VRAPI

Get the Head Mounted Device (HMD) interpupilar distance in meters.

Specified by:

getInterpupillaryDistance in interface VRAPI

Returns:

the Head Mounted Device (HMD) interpupilar distance in meters.

getOrientation

public Quaternion getOrientation()

Description copied from interface: VRAPI

Get the Head Mounted Device (HMD) orientation.

Specified by:

getOrientation in interface VRAPI

Returns:

the Head Mounted Device (HMD) orientation.

getPosition

public Vector3f getPosition()

Description copied from interface: VRAPI

Get the Head Mounted Device (HMD) position.

Specified by:

getPosition in interface VRAPI

Returns:

the Head Mounted Device (HMD) orientation.

getPositionAndOrientation

public void getPositionAndOrientation(Vector3f storePos,
                                      Quaternion storeRot)

Description copied from interface: VRAPI

Get the Head Mounted Device (HMD) position and orientation.

Specified by:

getPositionAndOrientation in interface VRAPI

Parameters:

storePos - the Head Mounted Device (HMD) position (modified).

storeRot - the Head Mounted Device (HMD) rotation (modified).

updatePose

public void updatePose()

Description copied from interface: VRAPI

Update Head Mounted Device (HMD) pose internal storage. This method should be called before other calls to HMD position/orientation access.

Specified by:

updatePose in interface VRAPI

getHMDMatrixProjectionLeftEye

public Matrix4f getHMDMatrixProjectionLeftEye(Camera cam)

Description copied from interface: VRAPI

Get the Head Mounted Device (HMD) left eye projection matrix.

Specified by:

getHMDMatrixProjectionLeftEye in interface VRAPI

Parameters:

cam - the camera attached to the left eye.

Returns:

the Head Mounted Device (HMD) left eye projection matrix.

getHMDMatrixProjectionRightEye

public Matrix4f getHMDMatrixProjectionRightEye(Camera cam)

Description copied from interface: VRAPI

Get the Head Mounted Device (HMD) right eye projection matrix.

Specified by:

getHMDMatrixProjectionRightEye in interface VRAPI

Parameters:

cam - the camera attached to the right eye.

Returns:

the Head Mounted Device (HMD) right eye projection matrix.

getHMDVectorPoseLeftEye

public Vector3f getHMDVectorPoseLeftEye()

Description copied from interface: VRAPI

Get the Head Mounted Device (HMD) left eye pose (position of the eye from the head) as a vector.

Specified by:

getHMDVectorPoseLeftEye in interface VRAPI

Returns:

the Head Mounted Device (HMD) left eye pose as a vector.

getHMDVectorPoseRightEye

public Vector3f getHMDVectorPoseRightEye()

Description copied from interface: VRAPI

Get the Head Mounted Device (HMD) right eye pose (position of the eye from the head) as a vector.

Specified by:

getHMDVectorPoseRightEye in interface VRAPI

Returns:

the Head Mounted Device (HMD) right eye pose as a vector.

getSeatedToAbsolutePosition

public Vector3f getSeatedToAbsolutePosition()

Description copied from interface: VRAPI

Get the seated to absolute position.

Specified by:

getSeatedToAbsolutePosition in interface VRAPI

Returns:

the seated to absolute position.

getHMDMatrixPoseLeftEye

public Matrix4f getHMDMatrixPoseLeftEye()

Description copied from interface: VRAPI

Returns the transform between the view space and left eye space. Eye space is the per-eye flavor of view space that provides stereo disparity. Instead of Model * View * Projection the model is Model * View * Eye * Projection. Normally View and Eye will be multiplied together and treated as View. This matrix incorporates the user's interpupillary distance (IPD).

Specified by:

getHMDMatrixPoseLeftEye in interface VRAPI

Returns:

the transform between the view space and eye space.

getHMDMatrixPoseRightEye

public Matrix4f getHMDMatrixPoseRightEye()

Description copied from interface: VRAPI

Returns the transform between the view space and right eye space. Eye space is the per-eye flavor of view space that provides stereo disparity. Instead of Model * View * Projection the model is Model * View * Eye * Projection. Normally View and Eye will be multiplied together and treated as View. This matrix incorporates the user's interpupillary distance (IPD).

Specified by:

getHMDMatrixPoseRightEye in interface VRAPI

Returns:

the transform between the view space and eye space.

getType

public HmdType getType()

Description copied from interface: VRAPI

Get the Head Mounted Device (HMD) type.

Specified by:

getType in interface VRAPI

Returns:

the Head Mounted Device (HMD) type.

setTrackingSpace

public void setTrackingSpace(boolean isSeated)

getPoseMatrices

public Matrix4f[] getPoseMatrices()