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 JFrame object for each GraphicsConfiguration 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]; GraphicsConfiguration[] gc = gd.getConfigurations(); for (int i=0; i < gc.length; i++) { JFrame f = new JFrame(gs[j].getDefaultConfiguration()); Canvas c = new Canvas(gc[i]); Rectangle gcBounds = gc[i].getBounds(); int xoffs = gcBounds.x; int yoffs = gcBounds.y; f.getContentPane().add(c); f.setLocation((i*50)+xoffs, (i*60)+yoffs); f.show(); } }
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 | |
---|---|
int |
getAvailableAcceleratedMemory
() This method returns the number of bytes available in accelerated memory on this device. |
GraphicsConfiguration |
getBestConfiguration
(
GraphicsConfigTemplate
gct) Returns the "best" configuration possible that passes the criteria defined in the GraphicsConfigTemplate . |
abstract GraphicsConfiguration [] |
getConfigurations
() Returns all of the GraphicsConfiguration objects associated with this GraphicsDevice. |
abstract GraphicsConfiguration |
getDefaultConfiguration
() Returns the default GraphicsConfiguration associated with this GraphicsDevice. |
DisplayMode |
getDisplayMode
() Returns the current display mode of this GraphicsDevice. |
DisplayMode [] |
getDisplayModes
() Returns all display modes available for this GraphicsDevice. |
Window |
getFullScreenWindow
() Returns the Window object representing the full-screen window if the device is in full-screen mode. |
abstract String |
getIDstring
() Returns the identification string associated with this GraphicsDevice. |
abstract int |
getType
() Returns the type of this GraphicsDevice. |
boolean |
isDisplayChangeSupported
() Returns true if this GraphicsDevice supports low-level display changes. |
boolean |
isFullScreenSupported
() Returns true if this GraphicsDevice supports full-screen exclusive mode. |
void |
setDisplayMode
(
DisplayMode
dm) Sets the display mode of this graphics device. |
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()
Method Detail |
---|
public abstract int getType()
public abstract String getIDstring()
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 Java TM 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".
public abstract GraphicsConfiguration[] getConfigurations()
public abstract GraphicsConfiguration getDefaultConfiguration()
public GraphicsConfiguration getBestConfiguration(GraphicsConfigTemplate gct)
public boolean isFullScreenSupported()
public void setFullScreenWindow(Window w)
If isFullScreenSupported returns true, full screen mode is considered to be exclusive , which implies:
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).
When entering full-screen exclusive mode, if the window to be used as the full-screen window is not visible, this method will make it visible. It will remain visible when returning to windowed mode.
When returning to windowed mode from an exclusive full-screen window, any display changes made by calling setDisplayMode are automatically restored to their original state.
public Window getFullScreenWindow()
public boolean isDisplayChangeSupported()
public void setDisplayMode(DisplayMode dm)
public DisplayMode getDisplayMode()
public DisplayMode[] getDisplayModes()
public int getAvailableAcceleratedMemory()