Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

java.awt
Class GraphicsConfiguration  view GraphicsConfiguration download GraphicsConfiguration.java

java.lang.Object
  extended byjava.awt.GraphicsConfiguration

public abstract class GraphicsConfiguration
extends java.lang.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

Constructor Summary
protected GraphicsConfiguration()
          The default constructor.
 
Method Summary
abstract  java.awt.image.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  java.awt.image.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  java.awt.image.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.
 java.awt.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  java.awt.image.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  java.awt.image.ColorModel getColorModel()
          Gets the color model of the corresponding device.
abstract  java.awt.image.ColorModel getColorModel(int transparency)
          Gets a color model for the corresponding device which supports the desired transparency level.
abstract  java.awt.geom.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  java.awt.geom.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.

Method Detail

getDevice

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


createCompatibleImage

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


createCompatibleVolatileImage

public abstract java.awt.image.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.

Since:
1.4

createCompatibleVolatileImage

public java.awt.image.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.

Since:
1.4

createCompatibleVolatileImage

public abstract java.awt.image.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.

Since:
1.5

createCompatibleImage

public abstract java.awt.image.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.


getColorModel

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


getColorModel

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


getDefaultTransform

public abstract java.awt.geom.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.


getNormalizingTransform

public abstract java.awt.geom.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.


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.

Since:
1.3

getBufferCapabilities

public BufferCapabilities getBufferCapabilities()
                                         throws gnu.classpath.NotImplementedException
Returns the buffering capabilities of this configuration.

Since:
1.4

getImageCapabilities

public ImageCapabilities getImageCapabilities()
                                       throws gnu.classpath.NotImplementedException
Returns the imaging capabilities of this configuration.

Since:
1.4