Class GraphicsConfiguration

protected GraphicsConfiguration()

The default constructor.

See Also:

GraphicsDevice.getConfigurations(), GraphicsDevice.getDefaultConfiguration(), GraphicsDevice.getBestConfiguration(GraphicsConfigTemplate), Graphics2D.getDeviceConfiguration()

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

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

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)

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

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

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

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

public BufferCapabilities getBufferCapabilities()

Returns the buffering capabilities of this configuration.

Returns:

the buffer capabilities

Since:

1.4

public abstract ColorModel getColorModel()

Gets the color model of the corresponding device.

Returns:

the color model

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

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()

public abstract GraphicsDevice getDevice()

Gets the associated device that this configuration describes.

Returns:

the device

public ImageCapabilities getImageCapabilities()

Returns the imaging capabilities of this configuration.

Returns:

the image capabilities

Since:

1.4

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()