java.awt

Class GraphicsConfiguration

Known Direct Subclasses:
GdkGraphicsConfiguration, QtScreenDeviceConfiguration, XGraphicsConfiguration, XGraphicsConfiguration

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
See Also:
Window, Frame, GraphicsEnvironment, GraphicsDevice

Constructor Summary

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

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

GraphicsConfiguration

protected GraphicsConfiguration()
The default constructor.

Method Details

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

createCompatibleVolatileImage

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

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

GraphicsConfiguration.java -- describes characteristics of graphics Copyright (C) 2000, 2001, 2002 Free Software Foundation This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.