|
JSR 216 (Maintenance Release) | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.awt.GraphicsDevice
The GraphicsDevice
class describes the graphics devices
that might be available in a particular graphics environment. These
include screen and printer devices. Note that there can be many screens
and many printers in an instance of GraphicsEnvironment
. Each
graphics device has one or more GraphicsConfiguration
objects
associated with it. These objects specify the different configurations
in which the GraphicsDevice
can be used.
In a multi-screen environment, the GraphicsConfiguration
objects can be used to render components on multiple screens. The
following code sample demonstrates how to create a
Frame
object on each screen
device in the GraphicsEnvironment
:
GraphicsEnvironment ge = GraphicsEnvironment. getLocalGraphicsEnvironment(); GraphicsDevice[] gs = ge.getScreenDevices(); for (int j = 0; j < gs.length; j++) { GraphicsDevice gd = gs[j]; Frame f = new Frame(gd.getDefaultConfiguration()); f.show(); }
Clarifications
The following clarifications apply to implementations of this Profile:
java.awt.Window
.
As a consequence, a Window
in full screen mode
need not span the entire screen.
See:
GraphicsEnvironment
,
GraphicsConfiguration
Field Summary | |
static int |
TYPE_IMAGE_BUFFER
Device is an image buffer. |
static int |
TYPE_PRINTER
Device is a printer. |
static int |
TYPE_RASTER_SCREEN
Device is a raster screen. |
Constructor Summary | |
protected |
GraphicsDevice()
This is an abstract class that cannot be instantiated directly. |
Method Summary | |
abstract int |
getAvailableAcceleratedMemory()
This method returns the number of bytes available in accelerated memory on this device. |
abstract GraphicsConfiguration[] |
getConfigurations()
Returns all of the GraphicsConfiguration
objects associated with this GraphicsDevice . |
abstract GraphicsConfiguration |
getDefaultConfiguration()
Returns the default GraphicsConfiguration
associated with this GraphicsDevice . |
abstract Window |
getFullScreenWindow()
Returns the Window object representing the
full-screen window if the device is in full-screen mode
and the Window is in the same context
as the calling thread. |
abstract String |
getIDstring()
Returns the identification string associated with this GraphicsDevice . |
abstract int |
getType()
Returns the type of this GraphicsDevice . |
abstract boolean |
isFullScreenSupported()
Returns true if this GraphicsDevice
supports full-screen exclusive mode. |
abstract void |
setFullScreenWindow(Window w)
Enter full-screen mode, or return to windowed mode. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final int TYPE_RASTER_SCREEN
public static final int TYPE_PRINTER
public static final int TYPE_IMAGE_BUFFER
Constructor Detail |
protected GraphicsDevice()
GraphicsEnvironment.getScreenDevices()
,
GraphicsEnvironment.getDefaultScreenDevice()
,
GraphicsConfiguration.getDevice()
Method Detail |
public abstract int getType()
GraphicsDevice
.
GraphicsDevice
, which can
either be TYPE_RASTER_SCREEN, TYPE_PRINTER or TYPE_IMAGE_BUFFER.TYPE_RASTER_SCREEN
,
TYPE_PRINTER
,
TYPE_IMAGE_BUFFER
public abstract String getIDstring()
GraphicsDevice
.
A particular program might use more than one
GraphicsDevice
in a GraphicsEnvironment
.
This method returns a String
identifying a
particular GraphicsDevice
in the local
GraphicsEnvironment
. Although there is
no public method to set this String
, a programmer can
use the String
for debugging purposes. Vendors of
the JavaTM Runtime Environment can
format the return value of the String
. To determine
how to interpret the value of the String
, contact the
vendor of your Java Runtime. To find out who the vendor is, from
your program, call the
getProperty
method of the
System class with "java.vendor".
String
that is the identification
of this GraphicsDevice
.public abstract GraphicsConfiguration[] getConfigurations()
GraphicsConfiguration
objects associated with this GraphicsDevice
.
GraphicsConfiguration
objects that are associated with this
GraphicsDevice
.public abstract GraphicsConfiguration getDefaultConfiguration()
GraphicsConfiguration
associated with this GraphicsDevice
.
GraphicsConfiguration
of this GraphicsDevice
.public abstract boolean isFullScreenSupported()
true
if this GraphicsDevice
supports full-screen exclusive mode.
public abstract void setFullScreenWindow(Window w)
If isFullScreenSupported
returns true
, full
screen mode is considered to be exclusive, which implies:
Component.enableInputMethods(false)
to make a component
a non-client of the input method framework.
If isFullScreenSupported
returns
false
, full-screen exclusive mode is simulated by resizing
the window to the size of the screen and positioning it at (0,0).
Please note the clarification for this method.
w
- a window to use as the full-screen window; null
if returning to windowed mode.isFullScreenSupported()
,
getFullScreenWindow()
,
Component.enableInputMethods(boolean)
public abstract Window getFullScreenWindow()
Window
object representing the
full-screen window if the device is in full-screen mode
and the Window
is in the same context
as the calling thread.
Window
is in the same context
as the calling thread; null
otherwise.setFullScreenWindow(Window)
public abstract int getAvailableAcceleratedMemory()
ImageCapabilities
object
associated with a VolatileImage that can be used to determine
whether a particular VolatileImage has been created in accelerated
memory.
VolatileImage.flush()
,
ImageCapabilities.isAccelerated()
|
JSR 216 (Maintenance Release) | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |