GraphicsConfiguration (Java Platform SE 8)

java.lang.Object
- java.awt.GraphicsConfiguration

```
public abstract class GraphicsConfiguration
extends Object
```
GraphicsConfigurationクラスは、プリンタやモニターなどのグラフィックス・デスティネーションの特性を記述します。1つのグラフィックス・デバイスには、異なる描画モードまたは機能を表す多くの関連する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の呼び出しから返された境界のすべての和集合を計算します。和集合が仮想デバイスの境界です。次のコード・サンプルは、仮想デバイスの境界を計算したものです。
```
      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

コンストラクタのサマリー

コンストラクタ
修飾子コンストラクタと説明

protected GraphicsConfiguration()
これは、インスタンスを直接には生成できない抽象クラスです。

コンストラクタ
修飾子	コンストラクタと説明
`protected`	`GraphicsConfiguration()` これは、インスタンスを直接には生成できない抽象クラスです。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド抽象メソッド具象メソッド
修飾子と型	メソッドと説明
`BufferedImage`	`createCompatibleImage(int width, int height)` この`GraphicsConfiguration`と互換性のあるデータ・レイアウトとカラー・モデルを持つ`BufferedImage`を返します。
`BufferedImage`	`createCompatibleImage(int width, int height, int transparency)` 指定された透明度をサポートし、この`GraphicsConfiguration`と互換性のあるデータ・レイアウトとカラー・モデルを持つ`BufferedImage`を返します。
`VolatileImage`	`createCompatibleVolatileImage(int width, int height)` この`GraphicsConfiguration`と互換性のあるデータ・レイアウトとカラー・モデルを持つ`VolatileImage`を返します。
`VolatileImage`	`createCompatibleVolatileImage(int width, int height, ImageCapabilities caps)` 指定されたイメージ機能を使用して、この`GraphicsConfiguration`と互換性のあるデータ・レイアウトとカラー・モデルを持つ`VolatileImage`を返します。
`VolatileImage`	`createCompatibleVolatileImage(int width, int height, ImageCapabilities caps, int transparency)` 指定されたイメージ機能と透明度の値を使用して、この`GraphicsConfiguration`と互換性のあるデータ・レイアウトとカラー・モデルを持つ`VolatileImage`を返します。
`VolatileImage`	`createCompatibleVolatileImage(int width, int height, int transparency)` この`GraphicsConfiguration`と互換性のあるデータ・レイアウトとカラー・モデルを持つ`VolatileImage`を返します。
`abstract Rectangle`	`getBounds()` デバイス座標内の`GraphicsConfiguration`の境界を返します。
`BufferCapabilities`	`getBufferCapabilities()` この`GraphicsConfiguration`のバッファリング機能を返します。
`abstract ColorModel`	`getColorModel()` この`GraphicsConfiguration`に関連付けられた`ColorModel`を返します。
`abstract ColorModel`	`getColorModel(int transparency)` 指定された透明度をサポートする、この`GraphicsConfiguration`に関連付けられた`ColorModel`を返します。
`abstract AffineTransform`	`getDefaultTransform()` この`GraphicsConfiguration`のデフォルトの`AffineTransform`を返します。
`abstract GraphicsDevice`	`getDevice()` この`GraphicsConfiguration`に関連付けられた`GraphicsDevice`を返します。
`ImageCapabilities`	`getImageCapabilities()` この`GraphicsConfiguration`のイメージ機能を返します。
`abstract AffineTransform`	`getNormalizingTransform()` ユーザー空間内の72単位がデバイス空間内の1インチに等しくなるように、`GraphicsConfiguration`のデフォルトの`AffineTransform`に連結できる`AffineTransform`を返します。
`boolean`	`isTranslucencyCapable()` この`GraphicsConfiguration`が半透明性の種類`PERPIXEL_TRANSLUCENT`をサポートしているかどうかを返します。

クラス 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()
```
    このGraphicsConfigurationに関連付けられたGraphicsDeviceを返します。
    
    戻り値:
    
    このGraphicsConfigurationに関連付けられたGraphicsDeviceオブジェクト。
  - createCompatibleImage
```
public BufferedImage createCompatibleImage(int width,
                                           int height)
```
    このGraphicsConfigurationと互換性のあるデータ・レイアウトとカラー・モデルを持つBufferedImageを返します。このメソッドは、デバイスをメモリー・マッピングすることとは無関係です。返されたBufferedImageは、このネイティブなデバイス構成にもっとも近いレイアウトとカラー・モデルを持っているため、このデバイスに最適にブリットできます。
    
    パラメータ:
    
    width - 返された次の幅: BufferedImage
    
    height - 返された次の高さ: BufferedImage
    
    戻り値:
    
    データ・レイアウトとカラー・モデルがこのGraphicsConfigurationと互換性のあるBufferedImage。
  - createCompatibleImage
```
public BufferedImage createCompatibleImage(int width,
                                           int height,
                                           int transparency)
```
    指定された透明度をサポートし、このGraphicsConfigurationと互換性のあるデータ・レイアウトとカラー・モデルを持つBufferedImageを返します。このメソッドは、デバイスをメモリー・マッピングすることとは無関係です。返されるBufferedImageは、このGraphicsConfigurationを持つデバイスに最適にブリットできるレイアウトおよびカラー・モデルを持ちます。
    
    パラメータ:
    
    width - 返された次の幅: BufferedImage
    
    height - 返された次の高さ: BufferedImage
    
    transparency - 指定された透明度モード
    
    戻り値:
    
    データ・レイアウトとカラー・モデルがこのGraphicsConfigurationと互換性があり、指定された透明度をサポートするBufferedImage。
    
    例外:
    
    IllegalArgumentException - 透明度が有効な値でない場合
    
    関連項目:
    
    Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT
  - createCompatibleVolatileImage
```
public VolatileImage createCompatibleVolatileImage(int width,
                                                   int height)
```
    このGraphicsConfigurationと互換性のあるデータ・レイアウトとカラー・モデルを持つVolatileImageを返します。返されたVolatileImageには、基本となるグラフィックス・デバイスのために最適に格納されたデータが含まれている可能性があるため、プラットフォーム固有の描画の高速化の利点が得られる可能性があります。
    
    パラメータ:
    
    width - 返された次の幅: VolatileImage
    
    height - 返された次の高さ: VolatileImage
    
    戻り値:
    
    データ・レイアウトとカラー・モデルがこのGraphicsConfigurationと互換性のあるVolatileImage。
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    
    Component.createVolatileImage(int, int)
  - createCompatibleVolatileImage
```
public VolatileImage createCompatibleVolatileImage(int width,
                                                   int height,
                                                   int transparency)
```
    このGraphicsConfigurationと互換性のあるデータ・レイアウトとカラー・モデルを持つVolatileImageを返します。返されたVolatileImageには、基本となるグラフィックス・デバイスのために最適に格納されたデータが含まれている可能性があるため、プラットフォーム固有の描画の高速化の利点が得られる可能性があります。
    
    パラメータ:
    
    width - 返された次の幅: VolatileImage
    
    height - 返された次の高さ: VolatileImage
    
    transparency - 指定された透明度モード
    
    戻り値:
    
    データ・レイアウトとカラー・モデルがこのGraphicsConfigurationと互換性のあるVolatileImage。
    
    例外:
    
    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
```
    指定されたイメージ機能を使用して、このGraphicsConfigurationと互換性のあるデータ・レイアウトとカラー・モデルを持つVolatileImageを返します。capsパラメータがnullである場合は、このパラメータが事実上無視され、このメソッドはImageCapabilities制約には関係なくVolatileImageを作成します。返されたVolatileImageは、このネイティブなデバイス構成にもっとも近いレイアウトとカラー・モデルを持っているため、このデバイスに最適にブリットできます。
    
    パラメータ:
    
    width - 返された次の幅: VolatileImage
    
    height - 返された次の高さ: VolatileImage
    
    caps - イメージ機能
    
    戻り値:
    
    データ・レイアウトとカラー・モデルがこのGraphicsConfigurationと互換性のあるVolatileImage。
    
    例外:
    
    AWTException - 指定されたイメージ機能をこのグラフィックス構成が満足できなかった場合
    
    導入されたバージョン:
    
    1.4
  - createCompatibleVolatileImage
```
public VolatileImage createCompatibleVolatileImage(int width,
                                                   int height,
                                                   ImageCapabilities caps,
                                                   int transparency)
                                            throws AWTException
```
    指定されたイメージ機能と透明度の値を使用して、このGraphicsConfigurationと互換性のあるデータ・レイアウトとカラー・モデルを持つVolatileImageを返します。capsパラメータがnullである場合は、このパラメータが事実上無視され、このメソッドはImageCapabilities制約には関係なくVolatileImageを作成します。返されたVolatileImageは、このネイティブなデバイス構成にもっとも近いレイアウトとカラー・モデルを持っているため、このデバイスに最適にブリットできます。
    
    パラメータ:
    
    width - 返された次の幅: VolatileImage
    
    height - 返された次の高さ: VolatileImage
    
    caps - イメージ機能
    
    transparency - 指定された透明度モード
    
    戻り値:
    
    データ・レイアウトとカラー・モデルがこのGraphicsConfigurationと互換性のあるVolatileImage。
    
    例外:
    
    IllegalArgumentException - 透明度が有効な値でない場合
    
    AWTException - 指定されたイメージ機能をこのグラフィックス構成が満足できなかった場合
    
    導入されたバージョン:
    
    1.5
    
    関連項目:
    
    Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT, Component.createVolatileImage(int, int)
  - getColorModel
```
public abstract ColorModel getColorModel()
```
    このGraphicsConfigurationに関連付けられたColorModelを返します。
    
    戻り値:
    
    このGraphicsConfigurationに関連付けられたColorModelオブジェクト。
  - getColorModel
```
public abstract ColorModel getColorModel(int transparency)
```
    指定された透明度をサポートする、このGraphicsConfigurationに関連付けられたColorModelを返します。
    
    パラメータ:
    
    transparency - 指定された透明度モード
    
    戻り値:
    
    このGraphicsConfigurationに関連し、指定された透明度をサポートするColorModelオブジェクト。透明度が有効な値でない場合はnull。
    
    関連項目:
    
    Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT
  - getDefaultTransform
```
public abstract AffineTransform getDefaultTransform()
```
    このGraphicsConfigurationのデフォルトのAffineTransformを返します。このAffineTransformは通常、ほとんどの標準画面では恒等変換になります。デフォルトのAffineTransformは、72ユーザー空間座標単位がデバイス空間のおよそ1インチに対応するようにデバイスに座標をマッピングします。正規化変換を使用すると、このマッピングをより正確にすることができます。画面デバイスとプリンタ・デバイスのデフォルトのAffineTransformで定義されている座標空間の座標は、デバイスのターゲット領域の左上隅に原点を持ち、X座標は右方向に、Y座標は下方向に値が増加します。createCompatibleImageで作成されない、デバイスに関連していないイメージ・バッファなどでは、このAffineTransformは恒等変換になります。
    
    戻り値:
    
    このGraphicsConfigurationのデフォルトのAffineTransform。
  - getNormalizingTransform
```
public abstract AffineTransform getNormalizingTransform()
```
    ユーザー空間内の72単位がデバイス空間内の1インチに等しくなるように、GraphicsConfigurationのデフォルトのAffineTransformに連結できるAffineTransformを返します。
    gという特定のGraphics2Dでは、次の擬似コードを使って変換をリセットし、このようなマッピングを作成できます。
```
      GraphicsConfiguration gc = g.getDeviceConfiguration();

      g.setTransform(gc.getDefaultTransform());
      g.transform(gc.getNormalizingTransform());
 
```
    ただし、このAffineTransformは場合によって、たとえばプリンタ出力やメタファイル出力の場合に恒等変換になり、このAffineTransformの正確さは元にあるシステムによって指定される情報と同じ程度になります。createCompatibleImageで作成されない、デバイスに関連していないイメージ・バッファなどでは、有効な距離測定法がないため、このAffineTransformは恒等変換になります。
    戻り値:
    
    ユーザー空間の72単位がデバイス空間の1インチに相当するように、デフォルトのAffineTransformに連結するAffineTransform。
  - getBounds
```
public abstract Rectangle getBounds()
```
    デバイス座標内のGraphicsConfigurationの境界を返します。仮想デバイスを持つマルチスクリーン環境では、境界は負のXまたはYの原点を持つことができます。
    
    戻り値:
    
    このGraphicsConfigurationによってカバーされる領域境界。
    
    導入されたバージョン:
    
    1.3
  - getBufferCapabilities
```
public BufferCapabilities getBufferCapabilities()
```
    このGraphicsConfigurationのバッファリング機能を返します。
    
    戻り値:
    
    このグラフィックス構成オブジェクトのバッファリング機能
    
    導入されたバージョン:
    
    1.4
  - getImageCapabilities
```
public ImageCapabilities getImageCapabilities()
```
    このGraphicsConfigurationのイメージ機能を返します。
    
    戻り値:
    
    このグラフィックス構成オブジェクトのイメージ機能
    
    導入されたバージョン:
    
    1.4
  - isTranslucencyCapable
```
public boolean isTranslucencyCapable()
```
    このGraphicsConfigurationが半透明性の種類PERPIXEL_TRANSLUCENTをサポートしているかどうかを返します。
    
    戻り値:
    
    指定されたGraphicsConfigurationが半透明性効果をサポートしているかどうか。
    
    導入されたバージョン:
    
    1.7
    
    関連項目:
    
    Window.setBackground(Color)

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスGraphicsConfiguration

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

GraphicsConfiguration

メソッドの詳細

getDevice

createCompatibleImage

createCompatibleImage

createCompatibleVolatileImage

createCompatibleVolatileImage

createCompatibleVolatileImage

createCompatibleVolatileImage

getColorModel

getColorModel

getDefaultTransform

getNormalizingTransform

getBounds

getBufferCapabilities

getImageCapabilities

isTranslucencyCapable