GraphicsConfiguration (Java Platform SE 8 )

java.lang.Object
- java.awt.GraphicsConfiguration

```
public abstract class GraphicsConfiguration
extends Object
```
GraphicsConfiguration类描述了诸如打印机或显示器之类的图形目的地的特征。可以有许多与单个图形设备相关GraphicsConfiguration对象，表示不同的绘图模式或功能。平台对应的本机结构将有所不同。例如，在X11窗口系统中，每个视觉是不同的GraphicsConfiguration 。在Microsoft Windows上， GraphicsConfiguration代表当前分辨率和颜色深度可用的PixelFormats。
在桌面区域可跨越多个物理屏幕设备的虚拟设备多屏幕环境中， GraphicsConfiguration对象的边界相对于虚拟坐标系。当设置组件的位置时，使用getBounds获取所需的GraphicsConfiguration的边界，并偏移位置，坐标为GraphicsConfiguration ，如下面的代码示例所示：
```
  Frame f = new Frame(gc);  // where gc is a GraphicsConfiguration
      Rectangle bounds = gc.getBounds();
      f.setLocation(10 + bounds.x, 10 + bounds.y); 
```
要确定您的环境是否是虚拟设备环境，请在系统中的所有GraphicsConfiguration对象上调用getBounds 。如果返回范围的任何一个起始点不是（0,0），则您的环境是虚拟设备环境。

您还可以使用getBounds来确定虚拟设备的边界。要做到这一点，首先在系统中的所有GraphicsConfiguration对象上调用getBounds 。然后计算从调用返回的所有边界的并getBounds为getBounds 。联合是虚拟设备的界限。以下代码示例计算虚拟设备的边界。
```
   Rectangle virtualBounds = new Rectangle(); GraphicsEnvironment ge = GraphicsEnvironment. getLocalGraphicsEnvironment(); GraphicsDevice[] gs = ge.getScreenDevices(); for (int j = 0; j < gs.length; j++) { GraphicsDevice gd = gs[j]; GraphicsConfiguration[] gc = gd.getConfigurations(); for (int i=0; i < gc.length; i++) { virtualBounds = virtualBounds.union(gc[i].getBounds()); } }  
```
另请参见：

Window ， Frame ， GraphicsEnvironment ， GraphicsDevice

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`GraphicsConfiguration()` 这是一个无法直接实例化的抽象类。

方法摘要

所有方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`BufferedImage`	`createCompatibleImage(int width, int height)` 返回一个`BufferedImage` ，其数据布局和颜色模型与此`GraphicsConfiguration` 。
`BufferedImage`	`createCompatibleImage(int width, int height, int transparency)` 返回 `BufferedImage`支持指定透明度，与此相适应的数据布局和颜色模型 `GraphicsConfiguration` 。
`VolatileImage`	`createCompatibleVolatileImage(int width, int height)` 返回一个`VolatileImage` ，具有与此`GraphicsConfiguration`的数据布局和颜色模型。
`VolatileImage`	`createCompatibleVolatileImage(int width, int height, ImageCapabilities caps)` 使用指定的图像功能返回`VolatileImage` ，其数据布局和颜色模型与此`GraphicsConfiguration`兼容。
`VolatileImage`	`createCompatibleVolatileImage(int width, int height, ImageCapabilities caps, int transparency)` 使用指定的图像功能和透明度值返回`VolatileImage` ，其中包含与此`GraphicsConfiguration`的数据布局和颜色模型。
`VolatileImage`	`createCompatibleVolatileImage(int width, int height, int transparency)` 返回一个`VolatileImage`与数据布局和颜色模型与此`GraphicsConfiguration` 。
`abstract Rectangle`	`getBounds()` 返回的边界 `GraphicsConfiguration`在设备坐标。
`BufferCapabilities`	`getBufferCapabilities()` 返回此 `GraphicsConfiguration` 。
`abstract ColorModel`	`getColorModel()` 返回`ColorModel`与此相关`GraphicsConfiguration` 。
`abstract ColorModel`	`getColorModel(int transparency)` 返回 `ColorModel`与此相关 `GraphicsConfiguration`支持指定透明度。
`abstract AffineTransform`	`getDefaultTransform()` 返回默认`AffineTransform`这个`GraphicsConfiguration` 。
`abstract GraphicsDevice`	`getDevice()` 返回`GraphicsDevice`与此相关`GraphicsConfiguration` 。
`ImageCapabilities`	`getImageCapabilities()` 返回此 `GraphicsConfiguration`的图像 `GraphicsConfiguration` 。
`abstract AffineTransform`	`getNormalizingTransform()` 返回一个 `AffineTransform`可与默认级联 `AffineTransform`一个的 `GraphicsConfiguration` ，使得单元72在用户空间等于设备空间的1英寸。
`boolean`	`isTranslucencyCapable()` 返回此 `GraphicsConfiguration`是否支持 `PERPIXEL_TRANSLUCENT`类型的半透明。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - GraphicsConfiguration
```
protected GraphicsConfiguration()
```
    这是一个无法直接实例化的抽象类。必须从合适的工厂或查询方法获取实例。
    
    另请参见：
    
    GraphicsDevice.getConfigurations() ， GraphicsDevice.getDefaultConfiguration() ， GraphicsDevice.getBestConfiguration(java.awt.GraphicsConfigTemplate) ， Graphics2D.getDeviceConfiguration()
- 方法详细信息
  - getDevice
```
public abstract GraphicsDevice getDevice()
```
    返回GraphicsDevice与此相关GraphicsConfiguration 。
    
    结果
    
    与此 GraphicsConfiguration的 GraphicsDevice对象。
  - createCompatibleImage
```
public BufferedImage createCompatibleImage(int width,
                                           int height)
```
    返回BufferedImage与数据布局和颜色模型与此GraphicsConfiguration 。该方法与设备的内存映射无关。返回的BufferedImage具有最接近此本机设备配置的布局和颜色模型，因此可以将其优化为该设备。
    
    参数
    
    width - 返回的宽度 BufferedImage
    
    height - 返回的高度 BufferedImage
    
    结果
    
    一个 BufferedImage的数据布局和颜色模型与此 GraphicsConfiguration 。
  - createCompatibleImage
```
public BufferedImage createCompatibleImage(int width,
                                           int height,
                                           int transparency)
```
    返回BufferedImage支持指定透明度，与此相适应的数据布局和颜色模型GraphicsConfiguration 。该方法与设备的内存映射无关。返回的BufferedImage具有布局和颜色模型，可以通过此GraphicsConfiguration地切换到设备。
    
    参数
    
    width - 返回的宽度 BufferedImage
    
    height - 返回的高度 BufferedImage
    
    transparency - 指定的透明度模式
    
    结果
    
    一个 BufferedImage ，其数据布局和颜色模型与此 GraphicsConfiguration ，并且还支持指定的透明度。
    
    异常
    
    IllegalArgumentException - 如果透明度不是有效值
    
    另请参见：
    
    Transparency.OPAQUE ， Transparency.BITMASK ， Transparency.TRANSLUCENT
  - createCompatibleVolatileImage
```
public VolatileImage createCompatibleVolatileImage(int width,
                                                   int height)
```
    返回一个VolatileImage ，具有与此GraphicsConfiguration的数据布局和颜色模型。返回的VolatileImage可能具有对底层图形设备进行最佳存储的数据，因此可能受益于平台特定的渲染加速。
    
    参数
    
    width - 返回的宽度 VolatileImage
    
    height - 返回的高度 VolatileImage
    
    结果
    
    一个 VolatileImage ，其数据布局和颜色模型与此 GraphicsConfiguration 。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    Component.createVolatileImage(int, int)
  - createCompatibleVolatileImage
```
public VolatileImage createCompatibleVolatileImage(int width,
                                                   int height,
                                                   int transparency)
```
    返回一个VolatileImage ，其数据布局和颜色模型与此GraphicsConfiguration 。返回的VolatileImage可能具有对底层图形设备进行最佳存储的数据，因此可能受益于平台特定的渲染加速。
    
    参数
    
    width - 返回的宽度 VolatileImage
    
    height - 返回的高度 VolatileImage
    
    transparency - 指定的透明度模式
    
    结果
    
    一个 VolatileImage ，其数据布局和颜色模型与此 GraphicsConfiguration 。
    
    异常
    
    IllegalArgumentException - 如果透明度不是有效值
    
    从以下版本开始：
    
    1.5
    
    另请参见：
    
    Transparency.OPAQUE ， Transparency.BITMASK ， Transparency.TRANSLUCENT ， Component.createVolatileImage(int, int)
  - createCompatibleVolatileImage
```
public VolatileImage createCompatibleVolatileImage(int width,
                                                   int height,
                                                   ImageCapabilities caps)
                                            throws AWTException
```
    使用指定的图像功能返回VolatileImage ，其中包含与此GraphicsConfiguration的数据布局和颜色模型。如果caps参数为null，则会被有效地忽略，并且此方法将创建一个VolatileImage，而不考虑ImageCapabilities约束。返回的VolatileImage具有最接近此本机设备配置的布局和颜色模型，因此可以将其优化为该设备。
    
    参数
    
    width - 返回的宽度为 VolatileImage
    
    height - 返回的高度 VolatileImage
    
    caps - 图像功能
    
    结果
    
    一个 VolatileImage ，其数据布局和颜色模型与此 GraphicsConfiguration 。
    
    异常
    
    AWTException - 如果图形配置不能满足提供的图像功能
    
    从以下版本开始：
    
    1.4
  - createCompatibleVolatileImage
```
public VolatileImage createCompatibleVolatileImage(int width,
                                                   int height,
                                                   ImageCapabilities caps,
                                                   int transparency)
                                            throws AWTException
```
    使用指定的图像功能和透明度值返回VolatileImage ，其中包含与此GraphicsConfiguration的数据布局和颜色模型。如果caps参数为空，则会被有效地忽略，并且此方法将创建一个VolatileImage，而不考虑ImageCapabilities约束。返回的VolatileImage具有最接近此本机设备配置的布局和颜色模型，因此可以将其优化为该设备。
    
    参数
    
    width - 返回的宽度 VolatileImage
    
    height - 返回的高度 VolatileImage
    
    caps - 图像功能
    
    transparency - 指定的透明度模式
    
    结果
    
    一个 VolatileImage其数据布局和颜色模型与此 GraphicsConfiguration 。
    
    异常
    
    IllegalArgumentException - 如果透明度不是有效值
    
    AWTException - 如果图形配置不能满足提供的图像功能
    
    从以下版本开始：
    
    1.5
    
    另请参见：
    
    Transparency.OPAQUE ， Transparency.BITMASK ， Transparency.TRANSLUCENT ， Component.createVolatileImage(int, int)
  - getColorModel
```
public abstract ColorModel getColorModel()
```
    返回ColorModel与此相关GraphicsConfiguration 。
    
    结果
    
    一个与此 GraphicsConfiguration的 ColorModel对象。
  - getColorModel
```
public abstract ColorModel getColorModel(int transparency)
```
    返回 ColorModel与此相关 GraphicsConfiguration支持指定透明度。
    
    参数
    
    transparency - 指定的透明度模式
    
    结果
    
    与此 GraphicsConfiguration并支持指定透明度的 ColorModel对象，如果透明度不是有效值，则为null。
    
    另请参见：
    
    Transparency.OPAQUE ， Transparency.BITMASK ， Transparency.TRANSLUCENT
  - getDefaultTransform
```
public abstract AffineTransform getDefaultTransform()
```
    返回默认AffineTransform这个GraphicsConfiguration 。这个AffineTransform是大多数普通屏幕的身份转换。默认AffineTransform将AffineTransform映射到设备上，使得72个用户空间坐标单位在设备空间中测量大约1英寸。归一化变换可用于使此映射更精确。屏幕和打印机设备默认AffineTransform定义的坐标空间中的坐标位于设备目标区域的左上角，X坐标向右增加，Y坐标向下增加。对于不与设备相关联的图像缓冲区，例如不是由createCompatibleImage创建的createCompatibleImage ，此AffineTransform是Identity变换。
    
    结果
    
    默认 AffineTransform为这个 GraphicsConfiguration 。
  - getNormalizingTransform
```
public abstract AffineTransform getNormalizingTransform()
```
    返回一个AffineTransform可与默认级联AffineTransform一个的GraphicsConfiguration ，使得单元72在用户空间等于设备空间的1英寸。
    对于特定的Graphics2D ，g，可以通过使用以下伪代码来重置转换以创建此类映射：
```
  GraphicsConfiguration gc = g.getDeviceConfiguration();

      g.setTransform(gc.getDefaultTransform());
      g.transform(gc.getNormalizingTransform()); 
```
    请注意，有时这个AffineTransform是身份，例如打印机或图元文件的输出，而这个AffineTransform与底层系统提供的信息一样准确。对于不与设备相关联的图像缓冲区（如createCompatibleImage未创建的图像缓冲区），此AffineTransform是Identity变换，因为没有有效的距离测量。
    结果
    
    一个 AffineTransform连接到默认的 AffineTransform ，以便在设备空间 AffineTransform用户空间中的72个单位映射到1英寸。
  - getBounds
```
public abstract Rectangle getBounds()
```
    返回设备坐标中的GraphicsConfiguration的边界。在具有虚拟设备的多屏幕环境中，边界可以具有负X或Y原点。
    
    结果
    
    该区域覆盖范围 GraphicsConfiguration 。
    
    从以下版本开始：
    
    1.3
  - getBufferCapabilities
```
public BufferCapabilities getBufferCapabilities()
```
    返回此 GraphicsConfiguration 。
    
    结果
    
    该图形配置对象的缓冲功能
    
    从以下版本开始：
    
    1.4
  - getImageCapabilities
```
public ImageCapabilities getImageCapabilities()
```
    返回这个 GraphicsConfiguration的图像 GraphicsConfiguration 。
    
    结果
    
    该图形配置对象的图像功能
    
    从以下版本开始：
    
    1.4
  - isTranslucencyCapable
```
public boolean isTranslucencyCapable()
```
    返回这个 GraphicsConfiguration是否支持 PERPIXEL_TRANSLUCENT的半透明。
    
    结果
    
    给定的GraphicsConfiguration是否支持半透明效果。
    
    从以下版本开始：
    
    1.7
    
    另请参见：
    
    Window.setBackground(Color)

Class GraphicsConfiguration

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

GraphicsConfiguration

方法详细信息

getDevice

createCompatibleImage

createCompatibleImage

createCompatibleVolatileImage

createCompatibleVolatileImage

createCompatibleVolatileImage

createCompatibleVolatileImage

getColorModel

getColorModel

getDefaultTransform

getNormalizingTransform

getBounds

getBufferCapabilities

getImageCapabilities

isTranslucencyCapable