java.awt

Class 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

UNKNOWN: updated to 1.4

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.
abstract VolatileImage	createCompatibleVolatileImage(int width, int height, int transparency) Returns a buffered volatile image optimized to this device, and with the given transparency.
VolatileImage	createCompatibleVolatileImage(int width, int height, ImageCapabilities caps, int transparency) Creates a volatile image with the specified capabilities and 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.

Constructor Detail

GraphicsConfiguration

protected GraphicsConfiguration()

The default constructor.

Method Detail

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

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

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

createCompatibleVolatileImage

public 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. 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)

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

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

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

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

getDevice

public abstract GraphicsDevice getDevice()

Gets the associated device that this configuration describes.

Returns: the device

getImageCapabilities

public ImageCapabilities getImageCapabilities()

Returns the imaging capabilities of this configuration.

Returns: the image capabilities

Since: 1.4

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