BufferedImage (Java Platform SE 8)

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引数としてこの型を使用する場合、デフォルトのsRGB ColorSpaceにある2つの色({0, 0, 0}および{255, 255, 255})を持つIndexColorModelで1ビット・イメージが作成されます。
    適切なマップ・サイズの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, 2016, Oracle and/or its affiliates. All rights reserved.Use is subject to license terms Documentation Redistribution Policyも参照してください。

クラス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