java.awt
Class GraphicsConfiguration

java.lang.Object
  |
  +--java.awt.GraphicsConfiguration

public abstract class GraphicsConfiguration

extends Object

Unsafe:

Field Summary

private static BufferCapabilities	defaultBufferCaps
private static ImageCapabilities	defaultImageCaps

Constructor Summary

protected

GraphicsConfiguration() This is an abstract class that cannot be instantiated directly.

Method Summary

abstract java.awt.image.BufferedImage	createCompatibleImage(int width, int height) Suppressed: Returns a BufferedImage with a data layout and color model compatible with this GraphicsConfiguration.
abstract java.awt.image.BufferedImage	createCompatibleImage(int width, int height, int transparency) Suppressed: Returns a BufferedImage that supports the specified transparency and has a data layout and color model compatible with this GraphicsConfiguration.
abstract java.awt.image.VolatileImage	createCompatibleVolatileImage(int width, int height) Suppressed: Returns a VolatileImage with a data layout and color model compatible with this GraphicsConfiguration.
java.awt.image.VolatileImage	createCompatibleVolatileImage(int width, int height, ImageCapabilities caps) Suppressed: Returns a VolatileImage with a data layout and color model compatible with this GraphicsConfiguration, using the specified image capabilities.
abstract Rectangle	getBounds() Suppressed: Returns the bounds of the GraphicsConfiguration in the device coordinates.
BufferCapabilities	getBufferCapabilities() Suppressed: Returns the buffering capabilities of this GraphicsConfiguration.
abstract java.awt.image.ColorModel	getColorModel() Suppressed: Returns the ColorModel associated with this GraphicsConfiguration.
abstract java.awt.image.ColorModel	getColorModel(int transparency) Suppressed: Returns the ColorModel associated with this GraphicsConfiguration that supports the specified transparency.
abstract java.awt.geom.AffineTransform	getDefaultTransform() Suppressed: Returns the default AffineTransform for this GraphicsConfiguration.
abstract GraphicsDevice	getDevice() Suppressed: Returns the GraphicsDevice associated with this GraphicsConfiguration.
ImageCapabilities	getImageCapabilities() Suppressed: Returns the image capabilities of this GraphicsConfiguration.
abstract java.awt.geom.AffineTransform	getNormalizingTransform() Suppressed: Returns a AffineTransform that can be concatenated with the default AffineTransform of a GraphicsConfiguration so that 72 units in user space equals 1 inch in device space.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

defaultBufferCaps

private static BufferCapabilities defaultBufferCaps

defaultImageCaps

private static ImageCapabilities defaultImageCaps

Constructor Detail

GraphicsConfiguration

protected GraphicsConfiguration()

This is an abstract class that cannot be instantiated directly. Instances must be obtained from a suitable factory or query method.

See Also:

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

Method Detail

getDevice

public abstract GraphicsDevice getDevice()

Suppressed: Returns the GraphicsDevice associated with this GraphicsConfiguration.

Returns:

a GraphicsDevice object that is associated with this GraphicsConfiguration.

createCompatibleImage

public abstract java.awt.image.BufferedImage createCompatibleImage(int width,
                                                                   int height)

Suppressed: Returns a BufferedImage with a data layout and color model compatible with this GraphicsConfiguration. This method has nothing to do with memory-mapping a device. The returned BufferedImage has a layout and color model that is closest to this native device configuration and can therefore be optimally blitted to this device.

Parameters:

width - the width of the returned BufferedImage

height - the height of the returned BufferedImage

Returns:

a BufferedImage whose data layout and color model is compatible with this GraphicsConfiguration.

createCompatibleVolatileImage

public abstract java.awt.image.VolatileImage createCompatibleVolatileImage(int width,
                                                                           int height)

Suppressed: Returns a VolatileImage with a data layout and color model compatible with this GraphicsConfiguration. The returned VolatileImage may have data that is stored optimally for the underlying graphics device and may therefore benefit from platform-specific rendering acceleration.

Parameters:

width - the width of the returned VolatileImage

height - the height of the returned VolatileImage

Returns:

a VolatileImage whose data layout and color model is compatible with this GraphicsConfiguration.

See Also:

Component.createVolatileImage(int, int)

createCompatibleVolatileImage

public java.awt.image.VolatileImage createCompatibleVolatileImage(int width,
                                                                  int height,
                                                                  ImageCapabilities caps)
                                                           throws AWTException

Suppressed: Returns a VolatileImage with a data layout and color model compatible with this GraphicsConfiguration, using the specified image capabilities. The returned VolatileImage has a layout and color model that is closest to this native device configuration and can therefore be optimally blitted to this device.

Parameters:

width - the width of the returned VolatileImage

height - the height of the returned VolatileImage

caps - the image capabilities

Returns:

a VolatileImage whose data layout and color model is compatible with this GraphicsConfiguration.

AWTException

Since:

1.4

createCompatibleImage

public abstract java.awt.image.BufferedImage createCompatibleImage(int width,
                                                                   int height,
                                                                   int transparency)

Suppressed: Returns a BufferedImage that supports the specified transparency and has a data layout and color model compatible with this GraphicsConfiguration. This method has nothing to do with memory-mapping a device. The returned BufferedImage has a layout and color model that can be optimally blitted to a device with this GraphicsConfiguration.

Parameters:

width - the width of the returned BufferedImage

height - the height of the returned BufferedImage

transparency - the specified transparency mode

Returns:

a BufferedImage whose data layout and color model is compatible with this GraphicsConfiguration and also supports the specified transparency.

See Also:

Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT

getColorModel

public abstract java.awt.image.ColorModel getColorModel()

Suppressed: Returns the ColorModel associated with this GraphicsConfiguration.

Returns:

a ColorModel object that is associated with this GraphicsConfiguration.

getColorModel

public abstract java.awt.image.ColorModel getColorModel(int transparency)

Suppressed: Returns the ColorModel associated with this GraphicsConfiguration that supports the specified transparency.

Parameters:

transparency - the specified transparency mode

Returns:

a ColorModel object that is associated with this GraphicsConfiguration and supports the specified transparency.

getDefaultTransform

public abstract java.awt.geom.AffineTransform getDefaultTransform()

Suppressed: Returns the default AffineTransform for this GraphicsConfiguration. This AffineTransform is typically the Identity transform for most normal screens. The default AffineTransform maps coordinates onto the device such that 72 user space coordinate units measure approximately 1 inch in device space. The normalizing transform can be used to make this mapping more exact. Coordinates in the coordinate space defined by the default AffineTransform for screen and printer devices have the origin in the upper left-hand corner of the target region of the device, with X coordinates increasing to the right and Y coordinates increasing downwards. For image buffers not associated with a device, such as those not created by createCompatibleImage, this AffineTransform is the Identity transform.

Returns:

the default AffineTransform for this GraphicsConfiguration.

getNormalizingTransform

public abstract java.awt.geom.AffineTransform getNormalizingTransform()

Suppressed: Returns a AffineTransform that can be concatenated with the default AffineTransform of a GraphicsConfiguration so that 72 units in user space equals 1 inch in device space.

For a particular Graphics2D, g, one can reset the transformation to create such a mapping by using the following pseudocode:

      GraphicsConfiguration gc = g.getGraphicsConfiguration();

      g.setTransform(gc.getDefaultTransform());
      g.transform(gc.getNormalizingTransform());
 

Note that sometimes this AffineTransform is identity, such as for printers or metafile output, and that this AffineTransform is only as accurate as the information supplied by the underlying system. For image buffers not associated with a device, such as those not created by createCompatibleImage, this AffineTransform is the Identity transform since there is no valid distance measurement.

Returns:

an AffineTransform to concatenate to the default AffineTransform so that 72 units in user space is mapped to 1 inch in device space.

getBounds

public abstract Rectangle getBounds()

Suppressed: Returns the bounds of the GraphicsConfiguration in the device coordinates. In a multi-screen environment with a virtual device, the bounds can have negative X or Y origins.

Returns:

the bounds of the area covered by this GraphicsConfiguration.

Since:

1.3

getBufferCapabilities

public BufferCapabilities getBufferCapabilities()

Suppressed: Returns the buffering capabilities of this GraphicsConfiguration.

Returns:

the buffering capabilities of this graphics configuration object

Since:

1.4

getImageCapabilities

public ImageCapabilities getImageCapabilities()

Suppressed: Returns the image capabilities of this GraphicsConfiguration.

Returns:

the image capabilities of this graphics configuration object

Since:

1.4