java.awt
Class GraphicsDevice
java.lang.Object
|
+--java.awt.GraphicsDevice
public abstract class
GraphicsDeviceextends
Object This describes a graphics device available to the given environment. This
includes screen and printer devices, and the different configurations for
each device. Also, this allows you to create virtual devices which operate
over a multi-screen environment.
Since:Author:- Eric Blake <ebb9@email.byu.edu>
See Also:
TYPE_IMAGE_BUFFER
public static final int TYPE_IMAGE_BUFFER
Device is an image buffer not visible to the user.
TYPE_PRINTER
public static final int TYPE_PRINTER
Device is a printer.
TYPE_RASTER_SCREEN
public static final int TYPE_RASTER_SCREEN
Device is a raster screen.
GraphicsDevice
protected GraphicsDevice()
The default constructor.
See Also:
getAvailableAcceleratedMemory
public int getAvailableAcceleratedMemory()
Return the number of bytes available in accelerated memory on this
device. The device may support creation or caching on a first-come,
first-served basis, depending on the operating system and driver.
Memory may be a finite resource, and because of multi-threading, you
are not guaranteed that the result of this method ensures your image
will successfully be put in accelerated memory. A negative result means
the memory is unlimited. The default implementation assumes no special
memory is available, and returns 0.
Returns:
- the size of accelerated memory available
See Also:
getBestConfiguration
public GraphicsConfiguration getBestConfiguration(java.awt.GraphicsConfigTemplate template)
Return the best configuration, according to the criteria in the given
template.
Parameters:
Returns:
Throws:
getConfigurations
public GraphicsConfiguration[] getConfigurations()
Return all configurations valid for this device.
Returns:
- an array of configurations
getDefaultConfiguration
public GraphicsConfiguration getDefaultConfiguration()
Return the default configuration for this device.
Returns:
- the default configuration
getDisplayMode
public DisplayMode getDisplayMode()
Returns the current display mode of this device, or null if unknown.
Since:Returns:
See Also:
getDisplayModes
public DisplayMode[] getDisplayModes()
Return an array of all available display modes. This implementation
returns a 0-length array, so subclasses must override this.
Since:Returns:
- the array of available modes
getFullScreenWindow
public Window getFullScreenWindow()
Returns the current full-screen window of the device, or null if no
window is full-screen.
Since:Returns:
See Also:
getIDstring
public String getIDstring()
Returns an identification string for the device. This can be
vendor-specific, and may be useful for debugging.
Returns:
getType
public int getType()
Returns the type of the device.
Returns:
See Also:
isDisplayChangeSupported
public boolean isDisplayChangeSupported()
Returns whether this device supports low-level display changes. This may
depend on whether full-screen exclusive mode is available.
XXX The default implementation returns false for now.
Since:Returns:
- true if display changes are supported
See Also:
isFullScreenSupported
public boolean isFullScreenSupported()
Returns true if the device supports full-screen exclusive mode. The
default implementation returns true; subclass it if this is not the case.
Since:Returns:
- true if full screen support is available
setDisplayMode
public void setDisplayMode(java.awt.DisplayMode mode)
Sets the display mode. This may be dependent on the availability of
full-screen exclusive mode.
Since:Parameters:
Throws:
See Also:
setFullScreenWindow
public synchronized void setFullScreenWindow(java.awt.Window w)
Toggle the given window between full screen and normal mode. The previous
full-screen window, if different, is restored; if the given window is
null, no window will be full screen. If
isFullScreenSupported()
returns true, full screen mode is
considered to be exclusive, which implies:
- Windows cannot overlap the full-screen window. All other application
windows will always appear beneath the full-screen window in the
Z-order.
- Input method windows are disabled. It is advisable to call
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).
XXX Not yet implemented in Classpath.
Since:Parameters:
See Also: