All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.awt.GraphicsConfiguration 

java.lang.Object
    |
    +----java.awt.GraphicsConfiguration
public abstract class GraphicsConfiguration
extends Object
This class describes the characteristics of a physical graphics destination such as a printer or monitor. There can be many GraphicsConfiguration objects associated with a single graphics device. For instance, on X11 windowing systems, each visual is a different GraphicsConfiguration. On PCs and Macintoshes, the different screen resolution/color resolution combinations would be different GraphicsConfigurations.

See Also:
GraphicsEnvironment, GraphicsDevice

Constructor Index

o GraphicsConfiguration()

Method Index

o createCompatibleImage(int, int)
Returns a BufferedImage with channel layout and color model compatible with this graphics configuration.
o createCompatibleImage(int, int, int)
Returns a BufferedImage that supports the specified transparency and has a channel layout and color model compatible with this graphics configuration.
o getColorModel()
Returns the color model associated with this configuration.
o getColorModel(int)
Returns the color model associated with this configuration that supports the specified transparency.
o getDefaultTransform()
Returns the default Transform for this configuration.
o getDevice()
Return the graphics device associated with this configuration.
o getNormalizingTransform()
Returns a Transform that can be composed with the default Transform of a Graphics2D so that 72 units in user space will equal 1 inch in device space.

Constructors

o GraphicsConfiguration 
public GraphicsConfiguration()

Methods

o getDevice 
public abstract GraphicsDevice getDevice()
Return the graphics device associated with this configuration.

o createCompatibleImage 
public abstract BufferedImage createCompatibleImage(int width,
                                                    int height)
Returns a BufferedImage with channel layout and color model compatible with this graphics configuration. This method has nothing to do with memory-mapping a device. This BufferedImage has a layout and color model that is closest to this native device configuration and thus can be optimally blitted to this device.

o createCompatibleImage 
public abstract BufferedImage createCompatibleImage(int width,
                                                    int height,
                                                    int transparency)
Returns a BufferedImage that supports the specified transparency and has a channel layout and color model compatible with this graphics configuration. This method has nothing to do with memory-mapping a device. This BufferedImage has a layout and color model that can be optimally blitted to a device with this configuration.

See Also:
OPAQUE, BITMASK, TRANSLUCENT
o getColorModel 
public abstract ColorModel getColorModel()
Returns the color model associated with this configuration.

o getColorModel 
public abstract ColorModel getColorModel(int transparency)
Returns the color model associated with this configuration that supports the specified transparency.

o getDefaultTransform 
public abstract AffineTransform getDefaultTransform()
Returns the default Transform for this configuration. This Transform is typically the Identity transform for most normal screens. Device coordinates for screen and printer devices will 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, this Transform will be the Identity transform.

o getNormalizingTransform 
public abstract AffineTransform getNormalizingTransform()
Returns a Transform that can be composed with the default Transform of a Graphics2D so that 72 units in user space will equal 1 inch in device space. Given a 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 Transform will be identity (e.g. for printers or metafile output) and that this Transform is only as accurate as the information supplied by the underlying system. For image buffers, this Transform will be the Identity transform, since there is no valid distance measurement. 

All Packages  Class Hierarchy  This Package  Previous  Next  Index
Submit a bug or feature