BufferedImage (Java Platform SE 7)

java.lang.Object
- java.awt.Image
- - java.awt.image.BufferedImage

すべての実装されたインタフェース:

RenderedImage, WritableRenderedImage, Transparency
```
public class BufferedImage
extends Image
implements WritableRenderedImage, Transparency
```
BufferedImage サブクラスは、イメージデータのアクセス可能なバッファーを備えた Image を記述します。BufferedImage は、ColorModel およびイメージデータの Raster で構成されています。Raster の SampleModel バンド数および型は、色成分およびアルファ成分を表すために ColorModel によって要求される数および型と一致している必要があります。すべての BufferedImage オブジェクトの左上隅の座標は (0, 0) です。このため、BufferedImage の作成に使用される Raster は minX=0 および minY=0 である必要があります。
このクラスは、Raster のデータの取り出し方法と設定方法、および ColorModel の色の記述方法に依存します。

関連項目:
ColorModel、Raster、WritableRaster

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static int`	`TYPE_3BYTE_BGR` 青、緑、および赤が 3 バイトに格納された 8 ビット RGB 色成分 (Windows スタイルの BGR カラーモデルに対応) によるイメージを表します。
`static int`	`TYPE_4BYTE_ABGR` 青、緑、および赤が 3 バイトに格納され、1 バイトのアルファを持つ 8 ビット RGBA 色成分によるイメージを表します。
`static int`	`TYPE_4BYTE_ABGR_PRE` 青、緑、および赤が 3 バイトに格納され、1 バイトのアルファを持つ 8 ビット RGBA 色成分によるイメージを表します。
`static int`	`TYPE_BYTE_BINARY` 不透明な byte パックの 1、2、または 4 ビットイメージを表します。
`static int`	`TYPE_BYTE_GRAY` 符号なし byte グレースケールイメージ (インデックスなし) を表します。
`static int`	`TYPE_BYTE_INDEXED` インデックス付き byte イメージを表します。
`static int`	`TYPE_CUSTOM` イメージ型が認識されないので、イメージは必ずカスタマイズされています。
`static int`	`TYPE_INT_ARGB` 整数型ピクセルにパックされた 8 ビット RGBA 色成分によるイメージを表します。
`static int`	`TYPE_INT_ARGB_PRE` 整数型ピクセルにパックされた 8 ビット RGBA 色成分によるイメージを表します。
`static int`	`TYPE_INT_BGR` 青、緑、および赤が整数型ピクセルにパックされた 8 ビット RGB 色成分 (Windows スタイルまたは Solaris スタイルの BGR カラーモデルに対応) によるイメージを表します。
`static int`	`TYPE_INT_RGB` 整数型ピクセルにパックされた 8 ビット RGB 色成分によるイメージを表します。
`static int`	`TYPE_USHORT_555_RGB` アルファなしの 5-5-5 RGB 色成分 (5 ビットの赤、5 ビットの緑、5 ビットの青) によるイメージを表します。
`static int`	`TYPE_USHORT_565_RGB` アルファなしの 5-6-5 RGB 色成分 (5 ビットの赤、6 ビットの緑、5 ビットの青) によるイメージを表します。
`static int`	`TYPE_USHORT_GRAY` 符号なし short グレースケールイメージ (インデックスなし) を表します。

クラス java.awt.Image から継承されたフィールド
accelerationPriority, SCALE_AREA_AVERAGING, SCALE_DEFAULT, SCALE_FAST, SCALE_REPLICATE, SCALE_SMOOTH, UndefinedProperty

インタフェース java.awt.Transparency から継承されたフィールド
BITMASK, OPAQUE, TRANSLUCENT

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

コンストラクタ
コンストラクタと説明
`BufferedImage(ColorModel cm, WritableRaster raster, boolean isRasterPremultiplied, Hashtable<?,?> properties)` 指定された `ColorModel` と `Raster` で新しい `BufferedImage` を構築します。
`BufferedImage(int width, int height, int imageType)` 定義済みイメージ型の中の 1 つで `BufferedImage` を構築します。
`BufferedImage(int width, int height, int imageType, IndexColorModel cm)` 定義済みイメージ型の TYPE_BYTE_BINARY または TYPE_BYTE_INDEXED のどちらかで `BufferedImage` を構築します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`void`	`addTileObserver(TileObserver to)` タイルオブザーバを追加します。
`void`	`coerceData(boolean isAlphaPremultiplied)` `isAlphaPremultiplied` 変数で指定された状態にデータを一致させます。
`WritableRaster`	`copyData(WritableRaster outRaster)` `BufferedImage` の任意の矩形領域を計算し、指定された `WritableRaster` にコピーします。
`Graphics2D`	`createGraphics()` この `BufferedImage` に描画するために使用できる `Graphics2D` を作成します。
`WritableRaster`	`getAlphaRaster()` 別の空間アルファチャネルをサポートする `ColorModel` オブジェクト (`ComponentColorModel` および `DirectColorModel` など) で `BufferedImage` のアルファチャネルを表す `WritableRaster` を返します。
`ColorModel`	`getColorModel()` `ColorModel` を返します。
`Raster`	`getData()` イメージを 1 つの大きなタイルとして返します。
`Raster`	`getData(Rectangle rect)` `BufferedImage` の任意の領域を計算して返します。
`Graphics`	`getGraphics()` このメソッドは `Graphics2D` を返しますが、ここでは下位互換性のために提供されます。
`int`	`getHeight()` `BufferedImage` の高さを返します。
`int`	`getHeight(ImageObserver observer)` `BufferedImage` の高さを返します。
`int`	`getMinTileX()` x 方向の最小タイルインデックスを返します。
`int`	`getMinTileY()` y 方向の最小タイルインデックスを返します。
`int`	`getMinX()` この `BufferedImage` の最小 x 座標を返します。
`int`	`getMinY()` この `BufferedImage` の最小 y 座標を返します。
`int`	`getNumXTiles()` x 方向のタイルの数を返します。
`int`	`getNumYTiles()` y 方向のタイルの数を返します。
`Object`	`getProperty(String name)` イメージのプロパティーを名前で返します。
`Object`	`getProperty(String name, ImageObserver observer)` イメージのプロパティーを名前で返します。
`String[]`	`getPropertyNames()` `getProperty(String)` が認識する名前の配列を返すか、プロパティー名が認識されない場合は `null` を返します。
`WritableRaster`	`getRaster()` `WritableRaster` を返します。
`int`	`getRGB(int x, int y)` デフォルト RGB カラーモデル (TYPE_INT_ARGB) およびデフォルト sRGB カラースペースで整数型ピクセルを返します。
`int[]`	`getRGB(int startX, int startY, int w, int h, int[] rgbArray, int offset, int scansize)` デフォルト RGB カラーモデル (TYPE_INT_ARGB) およびデフォルト sRGB カラースペースでイメージデータの一部から整数型ピクセルの配列を返します。
`SampleModel`	`getSampleModel()` この `BufferedImage` に関連付けられた `SampleModel` を返します。
`ImageProducer`	`getSource()` イメージのピクセルを生成するオブジェクトを返します。
`Vector<RenderedImage>`	`getSources()` この `BufferedImage` のイメージデータの直接のソース (直接のソースのソースではない) である `RenderedImage` オブジェクトの `Vector` を返します。
`BufferedImage`	`getSubimage(int x, int y, int w, int h)` 指定された矩形領域で定義されるサブイメージを返します。
`Raster`	`getTile(int tileX, int tileY)` タイル (`tileX`, `tileY`) を返します。
`int`	`getTileGridXOffset()` 原点を基準にタイルグリッドの x オフセットを返します。たとえば、タイルの位置 (0, 0) の x 座標です。
`int`	`getTileGridYOffset()` 原点を基準にタイルグリッドの y オフセットを返します。たとえば、タイルの位置 (0, 0) の y 座標です。
`int`	`getTileHeight()` タイルの高さをピクセル単位で返します。
`int`	`getTileWidth()` タイルの幅をピクセル単位で返します。
`int`	`getTransparency()` 透明度を返します。
`int`	`getType()` イメージ型を返します。
`int`	`getWidth()` `BufferedImage` の幅を返します。
`int`	`getWidth(ImageObserver observer)` `BufferedImage` の幅を返します。
`WritableRaster`	`getWritableTile(int tileX, int tileY)` 書き込みのためにタイルをチェックアウトします。
`Point[]`	`getWritableTileIndices()` どのタイルが書き込みのためにチェックアウトされているかを示す `Point` オブジェクトの配列を返します。
`boolean`	`hasTileWriters()` タイルが書き込み用にチェックアウトされているかどうかを返します。
`boolean`	`isAlphaPremultiplied()` アルファがあらかじめ乗算されているかどうかを返します。
`boolean`	`isTileWritable(int tileX, int tileY)` タイルが書き込み用にチェックアウトされているかどうかを返します。
`void`	`releaseWritableTile(int tileX, int tileY)` タイルに書き込むためのアクセス権を放棄します。
`void`	`removeTileObserver(TileObserver to)` タイルオブザーバを削除します。
`void`	`setData(Raster r)` イメージの矩形領域を指定された `Raster` である `r` の内容に設定します。Raster r は、`BufferedImage` と同じ座標空間にあるものと仮定されます。
`void`	`setRGB(int x, int y, int rgb)` この `BufferedImage` のピクセルを、指定された RGB 値に設定します。
`void`	`setRGB(int startX, int startY, int w, int h, int[] rgbArray, int offset, int scansize)` デフォルト RGB カラーモデル (TYPE_INT_ARGB) およびデフォルト sRGB カラースペースで、int ピクセルの配列をイメージデータの一部に設定します。
`String`	`toString()` この `BufferedImage` オブジェクトおよびその値の `String` 表現を返します。

クラス java.awt.Image から継承されたメソッド
flush, getAccelerationPriority, getCapabilities, getScaledInstance, setAccelerationPriority

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- フィールドの詳細
  - TYPE_CUSTOM
```
public static final int TYPE_CUSTOM
```
    イメージ型が認識されないので、イメージは必ずカスタマイズされています。この型は、getType() メソッドの戻り値としてだけ使用されます。
    
    関連項目:
    定数フィールド値
  - TYPE_INT_RGB
```
public static final int TYPE_INT_RGB
```
    整数型ピクセルにパックされた 8 ビット RGB 色成分によるイメージを表します。このイメージは DirectColorModel (アルファなし) を持ちます。不透明でないアルファを持つデータをこの型のイメージに格納する場合、AlphaComposite のドキュメントの説明のとおりに、カラーデータをあらかじめ乗算されていない形式に調整し、アルファを破棄する必要があります。
    
    関連項目:
    定数フィールド値
  - TYPE_INT_ARGB
```
public static final int TYPE_INT_ARGB
```
    整数型ピクセルにパックされた 8 ビット RGBA 色成分によるイメージを表します。このイメージは、DirectColorModel (アルファあり) を持ちます。このイメージのカラーデータには、アルファがあらかじめ乗算されていません。この型が BufferedImage コンストラクタへの imageType 引数として使用される場合、作成されるイメージは JDK 1.1 以前のリリースで作成されるイメージと一貫性があります。
    
    関連項目:
    定数フィールド値
  - TYPE_INT_ARGB_PRE
```
public static final int TYPE_INT_ARGB_PRE
```
    整数型ピクセルにパックされた 8 ビット RGBA 色成分によるイメージを表します。このイメージは、DirectColorModel (アルファあり) を持ちます。このイメージのカラーデータには、アルファがあらかじめ乗算されています。
    
    関連項目:
    定数フィールド値
  - TYPE_INT_BGR
```
public static final int TYPE_INT_BGR
```
    青、緑、および赤が整数型ピクセルにパックされた 8 ビット RGB 色成分 (Windows スタイルまたは Solaris スタイルの BGR カラーモデルに対応) によるイメージを表します。アルファはありません。このイメージは DirectColorModel を持ちます。不透明でないアルファを持つデータをこの型のイメージに格納する場合、AlphaComposite のドキュメントの説明のとおりに、カラーデータをあらかじめ乗算されていない形式に調整し、アルファを破棄する必要があります。
    
    関連項目:
    定数フィールド値
  - TYPE_3BYTE_BGR
```
public static final int TYPE_3BYTE_BGR
```
    青、緑、および赤が 3 バイトに格納された 8 ビット RGB 色成分 (Windows スタイルの BGR カラーモデルに対応) によるイメージを表します。アルファはありません。イメージは ComponentColorModel を持ちます。不透明でないアルファを持つデータをこの型のイメージに格納する場合、AlphaComposite のドキュメントの説明のとおりに、カラーデータをあらかじめ乗算されていない形式に調整し、アルファを破棄する必要があります。
    
    関連項目:
    定数フィールド値
  - TYPE_4BYTE_ABGR
```
public static final int TYPE_4BYTE_ABGR
```
    青、緑、および赤が 3 バイトに格納され、1 バイトのアルファを持つ 8 ビット RGBA 色成分によるイメージを表します。このイメージは、ComponentColorModel (アルファあり) を持ちます。このイメージのカラーデータには、アルファがあらかじめ乗算されていません。byte データは、各ピクセルの byte アドレスの小さい方から A、B、G、R の順序で単一 byte 配列にインタリーブされます。
    
    関連項目:
    定数フィールド値
  - TYPE_4BYTE_ABGR_PRE
```
public static final int TYPE_4BYTE_ABGR_PRE
```
    青、緑、および赤が 3 バイトに格納され、1 バイトのアルファを持つ 8 ビット RGBA 色成分によるイメージを表します。このイメージは、ComponentColorModel (アルファあり) を持ちます。このイメージのカラーデータには、アルファがあらかじめ乗算されています。byte データは、各ピクセルの byte アドレスの小さい方から A、B、G、R の順序で単一 byte 配列にインタリーブされます。
    
    関連項目:
    定数フィールド値
  - TYPE_USHORT_565_RGB
```
public static final int TYPE_USHORT_565_RGB
```
    アルファなしの 5-6-5 RGB 色成分 (5 ビットの赤、6 ビットの緑、5 ビットの青) によるイメージを表します。このイメージは DirectColorModel を持ちます。不透明でないアルファを持つデータをこの型のイメージに格納する場合、AlphaComposite のドキュメントの説明のとおりに、カラーデータをあらかじめ乗算されていない形式に調整し、アルファを破棄する必要があります。
    
    関連項目:
    定数フィールド値
  - TYPE_USHORT_555_RGB
```
public static final int TYPE_USHORT_555_RGB
```
    アルファなしの 5-5-5 RGB 色成分 (5 ビットの赤、5 ビットの緑、5 ビットの青) によるイメージを表します。このイメージは DirectColorModel を持ちます。不透明でないアルファを持つデータをこの型のイメージに格納する場合、AlphaComposite のドキュメントの説明のとおりに、カラーデータをあらかじめ乗算されていない形式に調整し、アルファを破棄する必要があります。
    
    関連項目:
    定数フィールド値
  - TYPE_BYTE_GRAY
```
public static final int TYPE_BYTE_GRAY
```
    符号なし byte グレースケールイメージ (インデックスなし) を表します。このイメージは、CS_GRAY ColorSpace を持つ ComponentColorModel を持ちます。不透明でないアルファを持つデータをこの型のイメージに格納する場合、AlphaComposite のドキュメントの説明のとおりに、カラーデータをあらかじめ乗算されていない形式に調整し、アルファを破棄する必要があります。
    
    関連項目:
    定数フィールド値
  - TYPE_USHORT_GRAY
```
public static final int TYPE_USHORT_GRAY
```
    符号なし short グレースケールイメージ (インデックスなし) を表します。このイメージは、CS_GRAY ColorSpace を持つ ComponentColorModel を持ちます。不透明でないアルファを持つデータをこの型のイメージに格納する場合、AlphaComposite のドキュメントの説明のとおりに、カラーデータをあらかじめ乗算されていない形式に調整し、アルファを破棄する必要があります。
    
    関連項目:
    定数フィールド値
  - TYPE_BYTE_BINARY
```
public static final int TYPE_BYTE_BINARY
```
    不透明な byte パックの 1、2、または 4 ビットイメージを表します。このイメージは IndexColorModel (アルファなし) を持ちます。imageType 引数をとり ColorModel 引数をとらない BufferedImage コンストラクタの imageType 引数としてこの型を使用する場合、IndexColorModel はデフォルト sRGB ColorSpace の 2 つの色 ({0, 0, 0} および {255, 255, 255}) で作成されます。
    適切なマップサイズの ColorModel を提供することにより、ColorModel 引数をとる BufferedImage コンストラクタを介して、ピクセルあたりのビット数が 2 または 4 のイメージを構築します。
    ピクセルあたりのビット数が 8 のイメージは、ColorModel に応じて TYPE_BYTE_INDEXED または TYPE_BYTE_GRAY を使用します。
    色データをこの型のイメージに格納する場合、IndexColorModel によって、カラーマップのもっとも近い色が判断され、結果のインデックスが格納されます。IndexColorModel カラーマップの色によっては、アルファ成分または色成分の近似および損失が発生する可能性があります。
    
    関連項目:
    定数フィールド値
  - TYPE_BYTE_INDEXED
```
public static final int TYPE_BYTE_INDEXED
```
    インデックス付き byte イメージを表します。imageType 引数をとり ColorModel 引数はとらない BufferedImage コンストラクタの imageType 引数としてこの型が使用される場合、IndexColorModel はデフォルト sRGB ColorSpace の 256 色 6/6/6 カラーキューブパレット (216 - 255 以外の色はグレースケール値) で作成されます。
    色データをこの型のイメージに格納する場合、IndexColorModel によって、カラーマップのもっとも近い色が判断され、結果のインデックスが格納されます。IndexColorModel カラーマップの色によっては、アルファ成分または色成分の近似および損失が発生する可能性があります。
    
    関連項目:
    定数フィールド値
- コンストラクタの詳細
  - BufferedImage
```
public BufferedImage(int width,
             int height,
             int imageType)
```
    定義済みイメージ型の中の 1 つで BufferedImage を構築します。イメージの ColorSpace は、デフォルトの sRGB 領域になります。
    
    パラメータ:
    width - 作成されたイメージの幅
    height - 作成されたイメージの高さ
    imageType - 作成されたイメージの形式
    関連項目:
    ColorSpace, TYPE_INT_RGB, TYPE_INT_ARGB, TYPE_INT_ARGB_PRE, TYPE_INT_BGR, TYPE_3BYTE_BGR, TYPE_4BYTE_ABGR, TYPE_4BYTE_ABGR_PRE, TYPE_BYTE_GRAY, TYPE_USHORT_GRAY, TYPE_BYTE_BINARY, TYPE_BYTE_INDEXED, TYPE_USHORT_565_RGB, TYPE_USHORT_555_RGB
  - BufferedImage
```
public BufferedImage(int width,
             int height,
             int imageType,
             IndexColorModel cm)
```
    定義済みイメージ型の TYPE_BYTE_BINARY または TYPE_BYTE_INDEXED のどちらかで BufferedImage を構築します。
    イメージ型が TYPE_BYTE_BINARY の場合は、イメージのピクセルあたりのビット数 (1、2、または 4) の決定にカラーモデル内のエントリ数が使用されます。カラーモデル内のエントリ数が 1 または 2 の場合、イメージのピクセルあたりのビット数は 1 になり、エントリ数が 3 または 4 の場合は、2 になります。エントリ数が 5 - 16 の場合は、4 になります。そうでない場合は、IllegalArgumentException がスローされます。
    
    パラメータ:
    width - 作成されたイメージの幅
    height - 作成されたイメージの高さ
    imageType - 作成されたイメージの形式
    cm - 作成されたイメージの IndexColorModel
    
    例外:
    
    IllegalArgumentException - imageType が TYPE_BYTE_BINARY または TYPE_BYTE_INDEXED でない場合、あるいは imageType が TYPE_BYTE_BINARY で、カラーマップが 16 を超えるエントリを持つ場合。
    関連項目:
    TYPE_BYTE_BINARY, TYPE_BYTE_INDEXED
  - BufferedImage
```
public BufferedImage(ColorModel cm,
             WritableRaster raster,
             boolean isRasterPremultiplied,
             Hashtable<?,?> properties)
```
    指定された ColorModel と Raster で新しい BufferedImage を構築します。Raster の SampleModel のバンドの数および型が、色成分およびアルファ成分を表すために ColorModel によって要求される数および型と一致しない場合は、RasterFormatException がスローされます。このメソッドは、ColorModel の alphaPremultiplied 状態と一致させるために色 Raster データをアルファで乗算または除算できます。この BufferedImage のプロパティーは、String と Object のペアの Hashtable を渡すことによって確立できます。
    
    パラメータ:
    cm - 新しいイメージの ColorModel
    raster - イメージデータの Raster
    isRasterPremultiplied - true の場合、ラスタのデータはアルファによってあらかじめ乗算されている。
    properties - String と Object ペアの Hashtable。
    
    例外:
    
    RasterFormatException - Raster の SampleModel のバンド数および型が、色成分およびアルファ成分を表すために ColorModel によって要求される数および型と一致しない場合。
    
    IllegalArgumentException - raster が cm に対応していない場合
    関連項目:
    ColorModel、Raster、WritableRaster
- メソッドの詳細
  - getType
```
public int getType()
```
    イメージ型を返します。ただし、不明型の場合は、TYPE_CUSTOM が返されます。
    
    戻り値:
    この BufferedImage のイメージ型。
    関連項目:
    TYPE_INT_RGB, TYPE_INT_ARGB, TYPE_INT_ARGB_PRE, TYPE_INT_BGR, TYPE_3BYTE_BGR, TYPE_4BYTE_ABGR, TYPE_4BYTE_ABGR_PRE, TYPE_BYTE_GRAY, TYPE_BYTE_BINARY, TYPE_BYTE_INDEXED, TYPE_USHORT_GRAY, TYPE_USHORT_565_RGB, TYPE_USHORT_555_RGB, TYPE_CUSTOM
  - getColorModel
```
public ColorModel getColorModel()
```
    ColorModel を返します。
    
    定義:
    
    getColorModel、インタフェース: RenderedImage
    
    戻り値:
    この BufferedImage の ColorModel。
  - getRaster
```
public WritableRaster getRaster()
```
    WritableRaster を返します。
    
    戻り値:
    この BufferedImage の WriteableRaster。
  - getAlphaRaster
```
public WritableRaster getAlphaRaster()
```
    別の空間アルファチャネルをサポートする ColorModel オブジェクト (ComponentColorModel および DirectColorModel など) で BufferedImage のアルファチャネルを表す WritableRaster を返します。このイメージの ColorModel と関連したアルファチャネルがない場合には null を返します。IndexColorModel を除くすべての ColorModel オブジェクトに関し、ColorModel がアルファをサポートする場合、このメソッドは、イメージデータの最後のバンドに別のアルファチャネルが格納されていると見なします。イメージがルックアップテーブルにアルファを持つ IndexColorModel を使用する場合、空間的に分離したアルファチャネルが存在しないため、このメソッドは null を返します。このメソッドは新しい WritableRaster を作成しますが、データ配列は共有することになります。
    
    戻り値:
    WritableRaster。この BufferedImage が ColorModel と関連したアルファチャネルを持たない場合は null。
  - getRGB
```
public int getRGB(int x,
         int y)
```
    デフォルト RGB カラーモデル (TYPE_INT_ARGB) およびデフォルト sRGB カラースペースで整数型ピクセルを返します。デフォルトモデルがイメージ ColorModel と一致しない場合には色変換が行われます。このメソッドを使用する場合、返されたデータの各色成分の精度はわずか 8 ビットです。
    座標が境界内にない場合は、ArrayOutOfBoundsException がスローされることがあります。ただし、明示的な境界チェックは必ずしも実行されません。
    
    パラメータ:
    x - デフォルト RGB カラーモデルおよび sRGB カラースペースでの取得対象ピクセルの X 座標
    y - デフォルト RGB カラーモデルおよび sRGB カラースペースでの取得対象ピクセルの Y 座標
    
    戻り値:
    デフォルト RGB カラーモデルおよびデフォルト sRGB カラースペースの整数型ピクセル
    関連項目:
    setRGB(int, int, int), setRGB(int, int, int, int, int[], int, int)
  - getRGB
```
public int[] getRGB(int startX,
           int startY,
           int w,
           int h,
           int[] rgbArray,
           int offset,
           int scansize)
```
    デフォルト RGB カラーモデル (TYPE_INT_ARGB) およびデフォルト sRGB カラースペースでイメージデータの一部から整数型ピクセルの配列を返します。デフォルトモデルがイメージ ColorModel と一致しない場合は色変換が行われます。このメソッドを使用する場合、返されたデータの各色成分の精度はわずか 8 ビットです。イメージの座標 (x, y) を指定した場合、ARGB ピクセルには次のようにしてアクセスできます。
```
    pixel   = rgbArray[offset + (y-startY)*scansize + (x-startX)]; 
```
    領域が境界内にない場合は、ArrayOutOfBoundsException がスローされることがあります。ただし、明示的な境界チェックは必ずしも実行されません。
    パラメータ:
    startX - 始点の X 座標
    startY - 始点の Y 座標
    w - 領域の幅
    h - 領域の高さ
    rgbArray - null でない場合、rgb ピクセルはここに書き込まれる
    offset - rgbArray へのオフセット
    scansize - rgbArray の走査線ストライド
    
    戻り値:
    RGB ピクセルの配列
    関連項目:
    setRGB(int, int, int), setRGB(int, int, int, int, int[], int, int)
  - setRGB
```
public void setRGB(int x,
          int y,
          int rgb)
```
    この BufferedImage のピクセルを、指定された RGB 値に設定します。ピクセルは、デフォルト RGB カラーモデル (TYPE_INT_ARGB) およびデフォルト sRGB カラースペースにあると見なされます。IndexColorModel を持つイメージの場合、もっとも近い色のインデックスが選択されます。
    座標が境界内にない場合は、ArrayOutOfBoundsException がスローされることがあります。ただし、明示的な境界チェックは必ずしも実行されません。
    
    パラメータ:
    x - 設定されるピクセルの X 座標
    y - 設定されるピクセルの Y 座標
    rgb - RGB 値
    関連項目:
    getRGB(int, int), getRGB(int, int, int, int, int[], int, int)
  - setRGB
```
public void setRGB(int startX,
          int startY,
          int w,
          int h,
          int[] rgbArray,
          int offset,
          int scansize)
```
    デフォルト RGB カラーモデル (TYPE_INT_ARGB) およびデフォルト sRGB カラースペースで、int ピクセルの配列をイメージデータの一部に設定します。デフォルトモデルがイメージ ColorModel と一致しない場合は色変換が行われます。このメソッドを使用する場合、返されたデータの各色成分の精度はわずか 8 ビットです。このイメージの座標 (x, y) を指定した場合、ARGB ピクセルには次のようにしてアクセスできます。
```
    pixel   = rgbArray[offset + (y-startY)*scansize + (x-startX)];
 
```
    警告:ディザリングは行われません。
    領域が境界内にない場合は、ArrayOutOfBoundsException がスローされることがあります。ただし、明示的な境界チェックは必ずしも実行されません。
    パラメータ:
    startX - 始点の X 座標
    startY - 始点の Y 座標
    w - 領域の幅
    h - 領域の高さ
    rgbArray - rgb ピクセル
    offset - rgbArray へのオフセット
    scansize - rgbArray の走査線ストライド
    関連項目:
    getRGB(int, int), getRGB(int, int, int, int, int[], int, int)
  - getWidth
```
public int getWidth()
```
    BufferedImage の幅を返します。
    
    定義:
    
    getWidth、インタフェース: RenderedImage
    
    戻り値:
    この BufferedImage の幅
  - getHeight
```
public int getHeight()
```
    BufferedImage の高さを返します。
    
    定義:
    
    getHeight、インタフェース: RenderedImage
    
    戻り値:
    この BufferedImage の高さ
  - getWidth
```
public int getWidth(ImageObserver observer)
```
    BufferedImage の幅を返します。
    
    定義:
    
    getWidth、クラス: Image
    
    パラメータ:
    observer - 無視される
    
    戻り値:
    この BufferedImage の幅
    関連項目:
    Image.getHeight(java.awt.image.ImageObserver)、ImageObserver
  - getHeight
```
public int getHeight(ImageObserver observer)
```
    BufferedImage の高さを返します。
    
    定義:
    
    getHeight、クラス: Image
    
    パラメータ:
    observer - 無視される
    
    戻り値:
    この BufferedImage の高さ
    関連項目:
    Image.getWidth(java.awt.image.ImageObserver)、ImageObserver
  - getSource
```
public ImageProducer getSource()
```
    イメージのピクセルを生成するオブジェクトを返します。
    
    定義:
    
    getSource、クラス: Image
    
    戻り値:
    このイメージのピクセル生成に使用する ImageProducer。
    関連項目:
    ImageProducer
  - getProperty
```
public Object getProperty(String name,
                 ImageObserver observer)
```
    イメージのプロパティーを名前で返します。各プロパティー名は、さまざまなイメージの形式で定義されます。特定のイメージでプロパティーが定義されていない場合、このメソッドは UndefinedProperty フィールドを返します。このイメージのプロパティーが不明な場合、このメソッドは null を返し、ImageObserver オブジェクトはあとで通知を受けます。プロパティー名「comment」は、イメージ、ソース、および作成者の説明としてユーザーに提示することができる任意のコメントを格納するために使用されます。
    
    定義:
    
    getProperty、クラス: Image
    
    パラメータ:
    name - プロパティー名
    observer - イメージ情報に関する通知を受け取る ImageObserver
    
    戻り値:
    指定された name で表されるプロパティーである Object、またはこのイメージのプロパティーが定義されていない場合は null。
    
    例外:
    
    NullPointerException - プロパティー名が null の場合。
    関連項目:
    ImageObserver、Image.UndefinedProperty
  - getProperty
```
public Object getProperty(String name)
```
    イメージのプロパティーを名前で返します。
    
    定義:
    
    getProperty、インタフェース: RenderedImage
    
    パラメータ:
    name - プロパティー名
    
    戻り値:
    指定された name で表されるプロパティーである Object。
    
    例外:
    
    NullPointerException - プロパティー名が null の場合。
    関連項目:
    Image.UndefinedProperty
  - getGraphics
```
public Graphics getGraphics()
```
    このメソッドは Graphics2D を返しますが、ここでは下位互換のために提供されます。Graphics2D を返すように宣言されているため、createGraphics の方が便利です。
    
    定義:
    
    getGraphics、クラス: Image
    
    戻り値:
    このイメージへの描画に使用できる Graphics2D。
    関連項目:
    Graphics、Component.createImage(int, int)
  - createGraphics
```
public Graphics2D createGraphics()
```
    この BufferedImage に描画するために使用できる Graphics2D を作成します。
    
    戻り値:
    このイメージへの描画に使用される Graphics2D。
  - getSubimage
```
public BufferedImage getSubimage(int x,
                        int y,
                        int w,
                        int h)
```
    指定された矩形領域で定義されるサブイメージを返します。返される BufferedImage は、オリジナルイメージと同じデータ配列を共有します。
    
    パラメータ:
    x - 指定された矩形領域の左上隅の X 座標
    y - 指定された矩形領域の左上隅の Y 座標
    w - 指定された矩形領域の幅
    h - 指定された矩形領域の高さ
    
    戻り値:
    この BufferedImage のサブイメージを表す BufferedImage。
    
    例外:
    
    RasterFormatException - 指定された領域がこの BufferedImage 内に含まれていない場合。
  - isAlphaPremultiplied
```
public boolean isAlphaPremultiplied()
```
    アルファがあらかじめ乗算されているかどうかを返します。アルファがない場合は false を返します。
    
    戻り値:
    アルファがあらかじめ乗算されている場合は true、そうでない場合は false。
  - coerceData
```
public void coerceData(boolean isAlphaPremultiplied)
```
    isAlphaPremultiplied 変数で指定された状態にデータを一致させます。このメソッドは、カラーラスタデータをアルファで乗算または除算します。データが正しい状態にある場合には、処理は行いません。
    
    パラメータ:
    isAlphaPremultiplied - アルファがあらかじめ乗算されている場合は true、そうでない場合は false。
  - toString
```
public String toString()
```
    この BufferedImage オブジェクトおよびその値の String 表現を返します。
    
    オーバーライド:
    
    toString、クラス: Object
    
    戻り値:
    この BufferedImage を表す String。
  - getSources
```
public Vector<RenderedImage> getSources()
```
    この BufferedImage のイメージデータの直接のソース (直接のソースのソースではない) である RenderedImage オブジェクトの Vector を返します。BufferedImage に直接のソースについての情報がない場合、このメソッドは null を返します。BufferedImage が直接のソースを持たない場合は、空の Vector を返します。
    
    定義:
    
    getSources、インタフェース: RenderedImage
    
    戻り値:
    この BufferedImage オブジェクトのイメージデータの直接のソースを格納している Vector。この BufferedImage が直接のソースについての情報を持たない場合は null。この BufferedImage が直接のソースを持たない場合は空の Vector。
  - getPropertyNames
```
public String[] getPropertyNames()
```
    getProperty(String) が認識する名前の配列を返すか、プロパティー名が認識されない場合は null を返します。
    
    定義:
    
    getPropertyNames、インタフェース: RenderedImage
    
    戻り値:
    getProperty(String) が認識するすべてのプロパティー名を含む String 配列。プロパティー名が認識されない場合は null。
  - getMinX
```
public int getMinX()
```
    この BufferedImage の最小 x 座標を返します。これは常に 0 になります。
    
    定義:
    
    getMinX、インタフェース: RenderedImage
    
    戻り値:
    この BufferedImage の最小 x 座標。
  - getMinY
```
public int getMinY()
```
    この BufferedImage の最小 y 座標を返します。これは常に 0 になります。
    
    定義:
    
    getMinY、インタフェース: RenderedImage
    
    戻り値:
    この BufferedImage の最小 y 座標。
  - getSampleModel
```
public SampleModel getSampleModel()
```
    この BufferedImage に関連付けられた SampleModel を返します。
    
    定義:
    
    getSampleModel、インタフェース: RenderedImage
    
    戻り値:
    この BufferedImage の SampleModel。
  - getNumXTiles
```
public int getNumXTiles()
```
    x 方向のタイルの数を返します。これは常に 1 になります。
    
    定義:
    
    getNumXTiles、インタフェース: RenderedImage
    
    戻り値:
    x 方向のタイル数
  - getNumYTiles
```
public int getNumYTiles()
```
    y 方向のタイルの数を返します。これは常に 1 になります。
    
    定義:
    
    getNumYTiles、インタフェース: RenderedImage
    
    戻り値:
    y 方向のタイル数
  - getMinTileX
```
public int getMinTileX()
```
    x 方向の最小タイルインデックスを返します。これは常に 0 になります。
    
    定義:
    
    getMinTileX、インタフェース: RenderedImage
    
    戻り値:
    x 方向の最小タイルインデックス
  - getMinTileY
```
public int getMinTileY()
```
    y 方向の最小タイルインデックスを返します。これは常に 0 になります。
    
    定義:
    
    getMinTileY、インタフェース: RenderedImage
    
    戻り値:
    y 方向の最小タイルインデックス
  - getTileWidth
```
public int getTileWidth()
```
    タイルの幅をピクセル単位で返します。
    
    定義:
    
    getTileWidth、インタフェース: RenderedImage
    
    戻り値:
    ピクセル単位のタイル幅。
  - getTileHeight
```
public int getTileHeight()
```
    タイルの高さをピクセル単位で返します。
    
    定義:
    
    getTileHeight、インタフェース: RenderedImage
    
    戻り値:
    ピクセル単位のタイルの高さ。
  - getTileGridXOffset
```
public int getTileGridXOffset()
```
    原点を基準にタイルグリッドの x オフセットを返します。たとえば、タイルの位置 (0, 0) の x 座標です。これは常に 0 になります。
    
    定義:
    
    getTileGridXOffset、インタフェース: RenderedImage
    
    戻り値:
    タイルグリッドの x オフセット
  - getTileGridYOffset
```
public int getTileGridYOffset()
```
    原点を基準にタイルグリッドの y オフセットを返します。たとえば、タイルの位置 (0, 0) の y 座標です。これは常に 0 になります。
    
    定義:
    
    getTileGridYOffset、インタフェース: RenderedImage
    
    戻り値:
    タイルグリッドの y オフセット
  - getTile
```
public Raster getTile(int tileX,
             int tileY)
```
    タイル (tileX, tileY) を返します。tileX および tileY はタイル配列内でのインデックスであり、ピクセル位置ではありません。返される Raster はアクティブであり、イメージが変更されると更新されます。
    
    定義:
    
    getTile、インタフェース: RenderedImage
    
    パラメータ:
    tileX - タイル配列にある要求されたタイルの x インデックス
    tileY - タイル配列にある要求されたタイルの y インデックス
    
    戻り値:
    tileX および tileY 引数で定義されるタイルを表す Raster。
    
    例外:
    
    ArrayIndexOutOfBoundsException - tileX と tileY の両方が 0 でない場合
  - getData
```
public Raster getData()
```
    イメージを 1 つの大きなタイルとして返します。返された Raster はイメージデータのコピーであり、イメージが変更されても更新されません。
    
    定義:
    
    getData、インタフェース: RenderedImage
    
    戻り値:
    イメージデータのコピーである Raster。
    関連項目:
    setData(Raster)
  - getData
```
public Raster getData(Rectangle rect)
```
    BufferedImage の任意の領域を計算して返します。返された Raster はイメージデータのコピーであり、イメージが変更されても更新されません。
    
    定義:
    
    getData、インタフェース: RenderedImage
    
    パラメータ:
    rect - 返される BufferedImage の領域。
    
    戻り値:
    BufferedImage の指定された領域のイメージデータのコピーである Raster
    関連項目:
    setData(Raster)
  - copyData
```
public WritableRaster copyData(WritableRaster outRaster)
```
    BufferedImage の任意の矩形領域を計算し、指定された WritableRaster にコピーします。計算される領域は、指定された WritableRaster の境界から決まります。指定された WritableRaster は、このイメージと互換性のある SampleModel を持つ必要があります。outRaster が null の場合は、適切な WritableRaster が作成されます。
    
    定義:
    
    copyData、インタフェース: RenderedImage
    
    パラメータ:
    outRaster - イメージの返された部分を保持する WritableRaster、または null
    
    戻り値:
    供給または生成された WritableRaster への参照。
  - setData
```
public void setData(Raster r)
```
    イメージの矩形領域を指定された Raster である r の内容に設定します。Raster r は、BufferedImage と同じ座標空間にあるものと仮定されます。このオペレーションは、BufferedImage の境界にクリッピングされます。
    
    定義:
    
    setData、インタフェース: WritableRenderedImage
    
    パラメータ:
    r - 指定されたRaster
    関連項目:
    getData(), getData(Rectangle)
  - addTileObserver
```
public void addTileObserver(TileObserver to)
```
    タイルオブザーバを追加します。オブザーバがすでに存在する場合は、複数の通知を受け取ります。
    
    定義:
    
    addTileObserver、インタフェース: WritableRenderedImage
    
    パラメータ:
    to - 指定された TileObserver
  - removeTileObserver
```
public void removeTileObserver(TileObserver to)
```
    タイルオブザーバを削除します。オブザーバが登録されていなかった場合は、何も行われません。オブザーバが複数の通知を対象に登録されている場合は、登録対象の通知が 1 つ少なくなります。
    
    定義:
    
    removeTileObserver、インタフェース: WritableRenderedImage
    
    パラメータ:
    to - 指定された TileObserver。
  - isTileWritable
```
public boolean isTileWritable(int tileX,
                     int tileY)
```
    タイルが書き込み用にチェックアウトされているかどうかを返します。
    
    定義:
    
    isTileWritable、インタフェース: WritableRenderedImage
    
    パラメータ:
    tileX - タイルの x インデックス。
    tileY - タイルの y インデックス。
    
    戻り値:
    指定のインデックスによって指定されるタイルが書き込み用にチェックアウトされている場合は true、そうでない場合は false。
    
    例外:
    
    ArrayIndexOutOfBoundsException - tileX と tileY の両方が 0 でない場合
  - getWritableTileIndices
```
public Point[] getWritableTileIndices()
```
    どのタイルが書き込みのためにチェックアウトされているかを示す Point オブジェクトの配列を返します。チェックアウトされているタイルがない場合は null を返します。
    
    定義:
    
    getWritableTileIndices、インタフェース: WritableRenderedImage
    
    戻り値:
    書き込み用にチェックアウトされているタイルを示す Point 配列。書き込み用にチェックアウトされているタイルがない場合は null。
  - hasTileWriters
```
public boolean hasTileWriters()
```
    タイルが書き込み用にチェックアウトされているかどうかを返します。意味上は、次と同じです。
```
 (getWritableTileIndices() != null).
 
```
    定義:
    
    hasTileWriters、インタフェース: WritableRenderedImage
    
    戻り値:
    タイルが書き込み用にチェックアウトされている場合は true、そうでない場合は false。
  - getWritableTile
```
public WritableRaster getWritableTile(int tileX,
                             int tileY)
```
    書き込みのためにタイルをチェックアウトします。タイルがライターなしの状態から 1 つのライターを持つ状態に変わったときは、登録されているすべての TileObservers が通知を受けます。
    
    定義:
    
    getWritableTile、インタフェース: WritableRenderedImage
    
    パラメータ:
    tileX - タイルの x インデックス
    tileY - タイルの y インデックス
    
    戻り値:
    指定されたインデックスで示され、書き込み用にチェックアウトされるタイルを表す WritableRaster。
  - releaseWritableTile
```
public void releaseWritableTile(int tileX,
                       int tileY)
```
    タイルに書き込むためのアクセス権を放棄します。呼び出し側がタイルへの書き込みを続けた場合、結果は保証されません。このメソッドは、getWritableTile(int, int) とペアで呼び出す必要があります。それ以外の方法では結局、結果が未定義となります。タイルが 1 つのライターを持つ状態からライターなしの状態に変わるときは、登録されたすべての TileObservers が通知を受けます。
    
    定義:
    
    releaseWritableTile、インタフェース: WritableRenderedImage
    
    パラメータ:
    tileX - タイルの x インデックス
    tileY - タイルの y インデックス
  - getTransparency
```
public int getTransparency()
```
    透明度を返します。OPAQUE、BITMASK、TRANSLUCENT のいずれかを返します。
    
    定義:
    
    getTransparency、インタフェース: Transparency
    
    戻り値:
    この BufferedImage の透明度。
    導入されたバージョン:
    
    1.5
    
    関連項目:
    Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT

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

クラス BufferedImage

フィールドのサマリー

クラス java.awt.Image から継承されたフィールド

インタフェース java.awt.Transparency から継承されたフィールド

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

メソッドのサマリー

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

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

フィールドの詳細

TYPE_CUSTOM

TYPE_INT_RGB

TYPE_INT_ARGB

TYPE_INT_ARGB_PRE

TYPE_INT_BGR

TYPE_3BYTE_BGR

TYPE_4BYTE_ABGR

TYPE_4BYTE_ABGR_PRE

TYPE_USHORT_565_RGB

TYPE_USHORT_555_RGB

TYPE_BYTE_GRAY

TYPE_USHORT_GRAY

TYPE_BYTE_BINARY

TYPE_BYTE_INDEXED

コンストラクタの詳細

BufferedImage

BufferedImage

BufferedImage

メソッドの詳細

getType

getColorModel

getRaster

getAlphaRaster

getRGB

getRGB

setRGB

setRGB

getWidth

getHeight

getWidth

getHeight

getSource

getProperty

getProperty

getGraphics

createGraphics

getSubimage

isAlphaPremultiplied

coerceData

toString

getSources

getPropertyNames

getMinX

getMinY

getSampleModel

getNumXTiles

getNumYTiles

getMinTileX

getMinTileY

getTileWidth

getTileHeight

getTileGridXOffset

getTileGridYOffset

getTile

getData

getData

copyData

setData

addTileObserver

removeTileObserver

isTileWritable

getWritableTileIndices

hasTileWriters

getWritableTile

releaseWritableTile

getTransparency