java.awt
Class GraphicsConfiguration

java.lang.Object
  extended by java.awt.GraphicsConfiguration

public abstract class GraphicsConfiguration
extends Object

This class describes the configuration of various graphics devices, such as a monitor or printer. Different configurations may exist for the same device, according to the different native modes supported.

Virtual devices are supported (for example, in a multiple screen environment, a virtual device covers all screens simultaneously); the configuration will have a non-zero relative coordinate system in such a case.

Since:
1.0
See Also:
Window, Frame, GraphicsEnvironment, GraphicsDevice

Constructor Summary
protected GraphicsConfiguration()
          The default constructor.
 
Method Summary
abstract  BufferedImage createCompatibleImage(int w, int h)
          Returns a buffered image optimized to this device, so that blitting can be supported in the buffered image.
abstract  BufferedImage createCompatibleImage(int w, int h, int transparency)
          Returns a buffered image optimized to this device, and with the specified transparency, so that blitting can be supported in the buffered image.
abstract  VolatileImage createCompatibleVolatileImage(int w, int h)
          Returns a buffered volatile image optimized to this device, so that blitting can be supported in the buffered image.
 VolatileImage createCompatibleVolatileImage(int w, int h, ImageCapabilities caps)
          Returns a buffered volatile image optimized to this device, and with the given capabilities, so that blitting can be supported in the buffered image.
 VolatileImage createCompatibleVolatileImage(int width, int height, ImageCapabilities caps, int transparency)
          Creates a volatile image with the specified capabilities and transparency.
abstract  VolatileImage createCompatibleVolatileImage(int width, int height, int transparency)
          Returns a buffered volatile image optimized to this device, and with the given transparency.
abstract  Rectangle getBounds()
          Returns the bounds of the configuration, in device coordinates.
 BufferCapabilities getBufferCapabilities()
          Returns the buffering capabilities of this configuration.
abstract  ColorModel getColorModel()
          Gets the color model of the corresponding device.
abstract  ColorModel getColorModel(int transparency)
          Gets a color model for the corresponding device which supports the desired transparency level.
abstract  AffineTransform getDefaultTransform()
          Returns a transform that maps user coordinates to device coordinates.
abstract  GraphicsDevice getDevice()
          Gets the associated device that this configuration describes.
 ImageCapabilities getImageCapabilities()
          Returns the imaging capabilities of this configuration.
abstract  AffineTransform getNormalizingTransform()
          Returns a transform that maps user coordinates to device coordinates.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

GraphicsConfiguration

protected GraphicsConfiguration()
The default constructor.

See Also:
GraphicsDevice.getConfigurations(), GraphicsDevice.getDefaultConfiguration(), GraphicsDevice.getBestConfiguration(GraphicsConfigTemplate), Graphics2D.getDeviceConfiguration()
Method Detail

getDevice

public abstract GraphicsDevice getDevice()
Gets the associated device that this configuration describes.

Returns:
the device

createCompatibleImage

public abstract BufferedImage createCompatibleImage(int w,
                                                    int h)
Returns a buffered image optimized to this device, so that blitting can be supported in the buffered image.

Parameters:
w - the width of the buffer
h - the height of the buffer
Returns:
the buffered image, or null if none is supported

createCompatibleVolatileImage

public abstract VolatileImage createCompatibleVolatileImage(int w,
                                                            int h)
Returns a buffered volatile image optimized to this device, so that blitting can be supported in the buffered image. Because the buffer is volatile, it can be optimized by native graphics accelerators.

Parameters:
w - the width of the buffer
h - the height of the buffer
Returns:
the buffered image, or null if none is supported
Since:
1.4
See Also:
Component.createVolatileImage(int, int)

createCompatibleVolatileImage

public VolatileImage createCompatibleVolatileImage(int w,
                                                   int h,
                                                   ImageCapabilities caps)
                                            throws AWTException
Returns a buffered volatile image optimized to this device, and with the given capabilities, so that blitting can be supported in the buffered image. Because the buffer is volatile, it can be optimized by native graphics accelerators.

Parameters:
w - the width of the buffer
h - the height of the buffer
caps - the desired capabilities of the image buffer
Returns:
the buffered image, or null if none is supported
Throws:
AWTException - if the capabilities cannot be met
Since:
1.4

createCompatibleVolatileImage

public abstract VolatileImage createCompatibleVolatileImage(int width,
                                                            int height,
                                                            int transparency)
Returns a buffered volatile image optimized to this device, and with the given transparency. Because the buffer is volatile, it can be optimized by native graphics accelerators.

Parameters:
width - the width of the buffer
height - the height of the buffer
transparency - the transparency value for the buffer
Returns:
the buffered image, or null if none is supported
Since:
1.5

createCompatibleVolatileImage

public VolatileImage createCompatibleVolatileImage(int width,
                                                   int height,
                                                   ImageCapabilities caps,
                                                   int transparency)
                                            throws AWTException
Creates a volatile image with the specified capabilities and transparency. If the backend cannot meet the requested capabilities and transparency, an AWTException is thrown.

Parameters:
width - the width of the image
height - the height of the image
caps - the requested capabilities
transparency - the required transparency
Returns:
a volatile image with the specified capabilites and transparency
Throws:
AWTException - if the required capabilities and transparency cannot be met
Since:
1.5

createCompatibleImage

public abstract BufferedImage createCompatibleImage(int w,
                                                    int h,
                                                    int transparency)
Returns a buffered image optimized to this device, and with the specified transparency, so that blitting can be supported in the buffered image.

Parameters:
w - the width of the buffer
h - the height of the buffer
transparency - the transparency of the buffer
Returns:
the buffered image, or null if none is supported
See Also:
Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT

getColorModel

public abstract ColorModel getColorModel()
Gets the color model of the corresponding device.

Returns:
the color model

getColorModel

public abstract ColorModel getColorModel(int transparency)
Gets a color model for the corresponding device which supports the desired transparency level.

Parameters:
transparency - the transparency of the model
Returns:
the color model, with transparency
See Also:
Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT

getDefaultTransform

public abstract AffineTransform getDefaultTransform()
Returns a transform that maps user coordinates to device coordinates. The preferred mapping is about 72 user units to 1 inch (2.54 cm) of physical space. This is often the identity transform. The device coordinates have the origin at the upper left, with increasing x to the right, and increasing y to the bottom.

Returns:
the transformation from user space to device space
See Also:
getNormalizingTransform()

getNormalizingTransform

public abstract AffineTransform getNormalizingTransform()
Returns a transform that maps user coordinates to device coordinates. The exact mapping is 72 user units to 1 inch (2.54 cm) of physical space. This is often the identity transform. The device coordinates have the origin at the upper left, with increasing x to the right, and increasing y to the bottom. Note that this is more accurate (and thus, sometimes more costly) than the default transform.

Returns:
the normalized transformation from user space to device space
See Also:
getDefaultTransform()

getBounds

public abstract Rectangle getBounds()
Returns the bounds of the configuration, in device coordinates. If this is a virtual device (for example, encompassing several screens), the bounds may have a non-zero origin.

Returns:
the device bounds
Since:
1.3

getBufferCapabilities

public BufferCapabilities getBufferCapabilities()
Returns the buffering capabilities of this configuration.

Returns:
the buffer capabilities
Since:
1.4

getImageCapabilities

public ImageCapabilities getImageCapabilities()
Returns the imaging capabilities of this configuration.

Returns:
the image capabilities
Since:
1.4