Package com.openinventor.inventor.devices

Class SoGLDevice

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.devices.SoDevice

com.openinventor.inventor.devices.SoGLDevice

public class SoGLDevice
extends SoDevice

OpenGL device management class. This class provides functions to discover, and query information about, GPU devices available in the system through the OpenGL API. You can query, for example, the total memory available on the device.

Please see SoDevice for general information about the device classes.

See SoGLScreenDevice for information about displays attached to a GPU.

See Also:

• SoCpuDevice
• SoGLBufferObject
• SoGLContext
• SoGLScreenDevice

Nested Class Summary

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Method Summary

Modifier and Type	Method	Description
static SoGLDevice	findFirstAvailableDevice()	Returns the first available device found in the system.
static SoGLDevice	getDevice(int index)	Returns the SoGLDevice indicated by index (starting from 0).
static int	getDevicesCount()	Returns the number of GPUs on the sytem.
SoGLDeviceSettings	getDeviceSettings()	Returns an handle of the driver API allowing to modify profile of this device.
SoGLScreenDevice	getMainScreenDevice()	Returns the main screen device connected to the GL device.
SoGLScreenDevice	getScreenDevice(int index)	Returns the SoGLScreenDevice indicated by index (starting from 0).
int	getScreenDevicesCount()	Returns the number of screen devices connected to the GL device.

Methods inherited from class com.openinventor.inventor.devices.SoDevice

getDeviceName, getDriverVersion, getLogicalUnits

Methods inherited from class com.openinventor.inventor.Inventor

dispose, getNativeResourceHandle

Methods inherited from class java.lang.Object

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

Method Details

getScreenDevicesCount

public int getScreenDevicesCount()

Returns the number of screen devices connected to the GL device.

getDevicesCount

public static int getDevicesCount()

Returns the number of GPUs on the sytem.

getMainScreenDevice

public SoGLScreenDevice getMainScreenDevice()

Returns the main screen device connected to the GL device.

getDeviceSettings

public SoGLDeviceSettings getDeviceSettings()

Returns an handle of the driver API allowing to modify profile of this device. The return is depending of the driver manufacturer (NVidia, AMD, Intel...). Returns NULL if the API is not available. E.g.: For Intel driver, NULL is always returned.

getDevice

public static SoGLDevice getDevice(int index)

Returns the SoGLDevice indicated by index (starting from 0).

Parameters:

index - The index of the SoGLDevice.

findFirstAvailableDevice

public static SoGLDevice findFirstAvailableDevice()

Returns the first available device found in the system. Since Open Inventor version 9.7.2, this is guaranteed to be the device that Open Inventor will actually use for rendering.

getScreenDevice

public SoGLScreenDevice getScreenDevice(int index)

Returns the SoGLScreenDevice indicated by index (starting from 0).

Parameters:

index - The index of the SoGLScreenDevice.