VR system. More...

Inheritance diagram for Dragengine.VRSystem:

Static Public Member Functions
Input devices
static int	getDeviceCount ()
	Number of input devices. More...

static InputDevice	getDeviceAt (int index)
	Information for input device at index. More...

static int	indexOfDeviceWithID (String id)
	Index of device with identifier or -1 if absent. More...

static int	indexOfButtonWithID (int device, String id)
	Index of button with identifier on device at index or -1 if absent. More...

static int	indexOfAxisWithID (int device, String id)
	Index of axis with identifier on device at index or -1 if absent. More...

static int	indexOfFeedbackWithID (int device, String id)
	Index of feedback with identifier on device at index or -1 if absent. More...

static bool	getButtonPressed (int device, int button)
	Button at index on device at index is pressed down. More...

static bool	getButtonTouched (int device, int button)
	Button at index on device at index is touched. More...

static float	getAxisValue (int device, int axis)
	Value of axis at index on device at index. More...

static float	getFeedbackValue (int device, int feedback)
	Value of feedback at index on device at index. More...

static void	setFeedbackValue (int device, int feedback, float value)
	Set value of feedback at index on device at index. More...

Parameters
static int	getParameterCount ()
	Number of parameters available. More...

static ModuleParameter	getParameterInfo (int index)
	Parameter information. More...

static ModuleParameter	getParameterInfo (String name)
	Named parameter information or null if not found. More...

static String	getParameterValue (String name)
	Parameter value. More...

static void	setParameterValue (String name, String value)
	Set named parameter value. More...

static String	sendCommand (String command)
	Send command. More...

Management
static bool	runtimeUsable ()
	VR Runtime is usable. More...

static void	startRuntime ()
	Start VR. More...

static void	stopRuntime ()
	Stop VR. More...

static bool	isRuntimeRunning ()
	VR is running. More...

static Camera	getCamera ()
	Camera to render on head mounted display or null. More...

static void	setCamera (Camera camera)
	Set camera to render on head mounted display. More...

static bool	supportsPassthrough ()
	VR Runtime supports presenting user environment inside the rendered world. More...

static bool	getEnablePassthrough ()
	Presenting user environment inside the rendered world is enabled. More...

static void	setEnablePassthrough (bool enable)
	Enable presenting user environment inside the rendered world. More...

static float	getPassthroughTransparency ()
	Transparency of user environment presented inside the rendered world. More...

static void	setPassthroughTransparency (float transparency)
	Set transparency of user environment presented inside the rendered world. More...

void	requestFeatureEyeGazeTracking (VRFeatureSupportLevel level)
	Set feature request level for eye gaze tracking. More...

void	requestFeatureFacialTracking (VRFeatureSupportLevel level)
	Set feature request level for facial tracking. More...

Detailed Description

VR system.

Version: 1.6

This is a native class. This is a pure static class. The class can not be instantiated

Member Function Documentation

◆ getAxisValue()

static float Dragengine.VRSystem.getAxisValue	(	int	device,
		int	axis
	)

static

Value of axis at index on device at index.

◆ getButtonPressed()

static bool Dragengine.VRSystem.getButtonPressed	(	int	device,
		int	button
	)

static

Button at index on device at index is pressed down.

◆ getButtonTouched()

static bool Dragengine.VRSystem.getButtonTouched	(	int	device,
		int	button
	)

static

Button at index on device at index is touched.

◆ getCamera()

static Camera Dragengine.VRSystem.getCamera ( )

static

Camera to render on head mounted display or null.

◆ getDeviceAt()

static InputDevice Dragengine.VRSystem.getDeviceAt ( int index )

static

Information for input device at index.

◆ getDeviceCount()

static int Dragengine.VRSystem.getDeviceCount ( )

static

Number of input devices.

◆ getEnablePassthrough()

static bool Dragengine.VRSystem.getEnablePassthrough ( )

static

Presenting user environment inside the rendered world is enabled.

Version: 1.12

Returns false if SupportsPassthrough() returns false.

◆ getFeedbackValue()

static float Dragengine.VRSystem.getFeedbackValue	(	int	device,
		int	feedback
	)

static

Value of feedback at index on device at index.

◆ getParameterCount()

static int Dragengine.VRSystem.getParameterCount ( )

static

Number of parameters available.

◆ getParameterInfo() [1/2]

static ModuleParameter Dragengine.VRSystem.getParameterInfo ( int index )

static

Parameter information.

Exceptions

EOutOfBoundary index less than 0 or greater than or equal to getParameterCount().

◆ getParameterInfo() [2/2]

static ModuleParameter Dragengine.VRSystem.getParameterInfo ( String name )

static

Named parameter information or null if not found.

◆ getParameterValue()

static String Dragengine.VRSystem.getParameterValue ( String name )

static

Parameter value.

Exceptions

EInvalidParam Parameter with name not found.

◆ getPassthroughTransparency()

static float Dragengine.VRSystem.getPassthroughTransparency ( )

static

Transparency of user environment presented inside the rendered world.

Version: 1.12

Has no effect if SupportsPassthrough() returns false. A value of 0 hides the environment. A value of 1 shows the environment. Values in between blend over.

◆ indexOfAxisWithID()

static int Dragengine.VRSystem.indexOfAxisWithID	(	int	device,
		String	id
	)

static

Index of axis with identifier on device at index or -1 if absent.

◆ indexOfButtonWithID()

static int Dragengine.VRSystem.indexOfButtonWithID	(	int	device,
		String	id
	)

static

Index of button with identifier on device at index or -1 if absent.

◆ indexOfDeviceWithID()

static int Dragengine.VRSystem.indexOfDeviceWithID ( String id )

static

Index of device with identifier or -1 if absent.

◆ indexOfFeedbackWithID()

static int Dragengine.VRSystem.indexOfFeedbackWithID	(	int	device,
		String	id
	)

static

Index of feedback with identifier on device at index or -1 if absent.

◆ isRuntimeRunning()

static bool Dragengine.VRSystem.isRuntimeRunning ( )

static

VR is running.

Version: 1.8

VR systems typically are required to be activated before they can be used. Starting VR connects the engine to the VR system present on the host system and activates VR support on various modules. VR mode can be started and stopped at any time.

◆ requestFeatureEyeGazeTracking()

void Dragengine.VRSystem.requestFeatureEyeGazeTracking ( VRFeatureSupportLevel level )

Set feature request level for eye gaze tracking.

Version: 1.17

Tracking eye gaze features is consider a high privacy operation by most VR environments. Enabling this feature usually requires the user to explicitely agree. Furthermore eye gaze tracking is not required for the majority of games and applications. For these reasons eye gaze tracking is disabled by default. To enable set the feature request level to optional or required.

The set feature request level takes effect only the next time StartRuntime() is called. It has no effect while the VR runtime is running.

If the VR module does not support eye gaze tracking and sFeatureSupport::efslRequired is specified an exception is thrown.

◆ requestFeatureFacialTracking()

void Dragengine.VRSystem.requestFeatureFacialTracking ( VRFeatureSupportLevel level )

Set feature request level for facial tracking.

Version: 1.17

Facial tracking includes eye tracking and mouth tracking. Tracking facial features is consider a high privacy operation by most VR environments. Enabling this feature usually requires the user to explicitely agree. Furthermore facial tracking typically is an expensive operation and can degrade performance. Last but not least facial tracking is not required for the majority of games and applications. For this reason facial tracking is disabled by default. To enable set the feature request level to optional or required.

The set feature request level takes effect only the next time StartRuntime() is called. It has no effect while the VR runtime is running.

If the VR module does not support facial tracking and sFeatureSupport::efslRequired is specified an exception is thrown.

◆ runtimeUsable()

static bool Dragengine.VRSystem.runtimeUsable ( )

static

VR Runtime is usable.

Returns true if a call to startRuntime() is likely to succeed or not.

◆ sendCommand()

static String Dragengine.VRSystem.sendCommand ( String command )

static

Send command.

◆ setCamera()

static void Dragengine.VRSystem.setCamera ( Camera camera )

static

Set camera to render on head mounted display.

If set to null fades back to safe scene as defined by VR Runtime.

◆ setEnablePassthrough()

static void Dragengine.VRSystem.setEnablePassthrough ( bool enable )

static

Enable presenting user environment inside the rendered world.

Version: 1.12

Has no effect if SupportsPassthrough() returns false.

◆ setFeedbackValue()

static void Dragengine.VRSystem.setFeedbackValue	(	int	device,
		int	feedback,
		float	value
	)

static

Set value of feedback at index on device at index.

◆ setParameterValue()

static void Dragengine.VRSystem.setParameterValue	(	String	name,
		String	value
	)

static

Set named parameter value.

Exceptions

EInvalidParam Parameter with name not found.

◆ setPassthroughTransparency()

static void Dragengine.VRSystem.setPassthroughTransparency ( float transparency )

static

Set transparency of user environment presented inside the rendered world.

Version: 1.12

Has no effect if SupportsPassthrough() returns false. A value of 0 hides the environment. A value of 1 shows the environment. Values in between blend over.

◆ startRuntime()

static void Dragengine.VRSystem.startRuntime ( )

static

Start VR.

VR systems typically are required to be activated before they can be used. Starting VR connects the engine to the VR system present on the host system and activates VR support on various modules. VR mode can be started and stopped at any time.

◆ stopRuntime()

static void Dragengine.VRSystem.stopRuntime ( )

static

Stop VR.

VR systems typically are required to be activated before they can be used. Starting VR connects the engine to the VR system present on the host system and activates VR support on various modules. VR mode can be started and stopped at any time.

◆ supportsPassthrough()

static bool Dragengine.VRSystem.supportsPassthrough ( )

static

VR Runtime supports presenting user environment inside the rendered world.

Version: 1.12

The documentation for this class was generated from the following file:

VRSystem.ds

Static Public Member Functions

Management

Detailed Description

Member Function Documentation

◆ getAxisValue()

◆ getButtonPressed()

◆ getButtonTouched()

◆ getCamera()

◆ getDeviceAt()

◆ getDeviceCount()

◆ getEnablePassthrough()

◆ getFeedbackValue()

◆ getParameterCount()

◆ getParameterInfo() [1/2]

◆ getParameterInfo() [2/2]

◆ getParameterValue()

◆ getPassthroughTransparency()

◆ indexOfAxisWithID()

◆ indexOfButtonWithID()

◆ indexOfDeviceWithID()

◆ indexOfFeedbackWithID()

◆ isRuntimeRunning()

◆ requestFeatureEyeGazeTracking()

◆ requestFeatureFacialTracking()

◆ runtimeUsable()

◆ sendCommand()

◆ setCamera()

◆ setEnablePassthrough()

◆ setFeedbackValue()

◆ setParameterValue()

◆ setPassthroughTransparency()

◆ startRuntime()

◆ stopRuntime()

◆ supportsPassthrough()