javax.media.nativewindow
public interface AbstractGraphicsDevice extends Cloneable
Modifier and Type | Field and Description |
---|---|
static String |
DEFAULT_CONNECTION
Dummy connection value for a default connection where no native support for multiple devices is available
|
static int |
DEFAULT_UNIT
Default unit id for the 1st device: 0
|
static String |
EXTERNAL_CONNECTION
Dummy connection value for an external connection where no native support for multiple devices is available
|
Modifier and Type | Method and Description |
---|---|
boolean |
close()
Optionally closing the device.
|
String |
getConnection()
Returns the semantic GraphicsDevice connection.
On platforms supporting remote devices, eg via tcp/ip network, the implementation shall return a unique name for each remote address. On X11 for example, the connection string should be as the following example. :0.0 for a local connection
remote.host.net:0.0 for a remote connection
To support multiple local device, see getUnitID() . |
long |
getHandle()
Returns the native handle of the underlying native device,
if such thing exist.
|
String |
getType()
Returns the type of the underlying subsystem, ie
NativeWindowFactory.TYPE_KD, NativeWindowFactory.TYPE_X11, ..
|
String |
getUniqueID()
Returns a unique ID String of this device using
type ,
connection and unitID .The unique ID does not reflect the instance of the device, hence the handle is not included. The unique ID may be used as a key for semantic device mapping. |
int |
getUnitID()
Returns the graphics device
unit ID .The unit ID support multiple graphics device configurations
on a local machine.To support remote device, see getConnection() . |
void |
lock()
Optionally locking the device, utilizing eg
ToolkitLock . |
void |
unlock()
Optionally unlocking the device, utilizing eg
ToolkitLock . |
static final String DEFAULT_CONNECTION
static final String EXTERNAL_CONNECTION
static final int DEFAULT_UNIT
String getType()
String getConnection()
:0.0
for a local connectionremote.host.net:0.0
for a remote connectiongetUnitID()
.int getUnitID()
unit ID
.unit ID
support multiple graphics device configurations
on a local machine.getConnection()
.String getUniqueID()
type
,
connection
and unitID
.long getHandle()
void lock()
ToolkitLock
.
The lock implementation must be recursive.void unlock()
ToolkitLock
.
The lock implementation must be recursive.boolean close()
The default implementation is a NOP
, just setting the handle to null
.
X11GraphicsDevice
,
shall have a enable/disable like javax.media.nativewindow.x11.X11GraphicsDevice#setCloseDisplay(boolean, boolean)
,null
, otherwise false.Copyright 2010 JogAmp Community.