JavaTM Platform
Standard Ed. 6

java.awt.image
クラス BufferedImage

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 で構成されています。RasterSampleModel バンド数および型は、色成分およびアルファ成分を表すために 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) が認識する名前の配列を返します。
 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)
          タイル (tileXtileY) を返します。
 int getTileGridXOffset()
          原点を基準にタイルグリッドの x オフセットを返します。
 int getTileGridYOffset()
          原点を基準にタイルグリッドの 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 の内容に設定します。
 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 を構築します。RasterSampleModel のバンドの数および型が、色成分およびアルファ成分を表すために ColorModel によって要求される数および型と一致しない場合は、RasterFormatException がスローされます。このメソッドは、ColorModelalphaPremultiplied 状態と一致させるために色 Raster データをアルファで乗算または除算できます。この BufferedImage のプロパティーは、StringObject のペアの Hashtable を渡すことによって確立できます。

パラメータ:
cm - 新しいイメージの ColorModel
raster - イメージデータの Raster
isRasterPremultiplied - true の場合、 ラスタのデータはアルファによってあらかじめ乗算されている
properties - StringObject のペアの Hashtable
例外:
RasterFormatException - RasterSampleModel のバンド数および型が、 色成分およびアルファ成分を表すために ColorModel によって要求される数および型と 一致しない場合
IllegalArgumentException - rastercm に対応していない場合
関連項目:
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 を返します。

定義:
インタフェース RenderedImage 内の getColorModel
戻り値:
この BufferedImageColorModel

getRaster

public WritableRaster getRaster()
WritableRaster を返します。

戻り値:
この BufferedImageWriteableRaster

getAlphaRaster

public WritableRaster getAlphaRaster()
別の空間アルファチャネルをサポートする ColorModel オブジェクト (ComponentColorModel および DirectColorModel など) で BufferedImage のアルファチャネルを表す WritableRaster を返します。このイメージの ColorModel と関連したアルファチャネルがない場合には null を返します。IndexColorModel を除くすべての ColorModel オブジェクトに関し、ColorModel がアルファをサポートする場合、このメソッドは、イメージデータの最後のバンドに別のアルファチャネルが格納されていると見なします。イメージがルックアップテーブルにアルファを持つ IndexColorModel を使用する場合、空間的に分離したアルファチャネルが存在しないため、このメソッドは null を返します。このメソッドは新しい WritableRaster を作成しますが、データ配列は共有することになります。

戻り値:
WritableRaster。この BufferedImageColorModel と関連したアルファチャネルを持たない場合は 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 の幅を返します。

定義:
インタフェース RenderedImage 内の getWidth
戻り値:
この BufferedImage の幅

getHeight

public int getHeight()
BufferedImage の高さを返します。

定義:
インタフェース RenderedImage 内の getHeight
戻り値:
この BufferedImage の高さ

getWidth

public int getWidth(ImageObserver observer)
BufferedImage の幅を返します。

定義:
クラス Image 内の getWidth
パラメータ:
observer - 無視される
戻り値:
この BufferedImage の幅
関連項目:
Image.getHeight(java.awt.image.ImageObserver), ImageObserver

getHeight

public int getHeight(ImageObserver observer)
BufferedImage の高さを返します。

定義:
クラス Image 内の getHeight
パラメータ:
observer - 無視される
戻り値:
この BufferedImage の高さ
関連項目:
Image.getWidth(java.awt.image.ImageObserver), ImageObserver

getSource

public ImageProducer getSource()
イメージのピクセルを生成するオブジェクトを返します。

定義:
クラス Image 内の getSource
戻り値:
このイメージのピクセル生成に使用する ImageProducer
関連項目:
ImageProducer

getProperty

public Object getProperty(String name,
                          ImageObserver observer)
イメージのプロパティーを名前で返します。各プロパティー名は、さまざまなイメージの形式で定義されます。特定のイメージでプロパティーが定義されていない場合、このメソッドは UndefinedProperty フィールドを返します。このイメージのプロパティーが不明な場合、このメソッドは null を返し、ImageObserver オブジェクトはあとで通知を受けます。プロパティー名「comment」は、イメージ、ソース、および作成者の説明としてユーザーに提示することができる任意のコメントを格納するために使用されます。

定義:
クラス Image 内の getProperty
パラメータ:
name - プロパティー名
observer - イメージ情報に関する通知を 受け取る ImageObserver
戻り値:
指定された name で表されるプロパティーである Object、またはこのイメージのプロパティーが 定義されていない場合は null
例外:
NullPointerException - プロパティー名が null の場合
関連項目:
ImageObserver, Image.UndefinedProperty

getProperty

public Object getProperty(String name)
イメージのプロパティーを名前で返します。

定義:
インタフェース RenderedImage 内の getProperty
パラメータ:
name - プロパティー名
戻り値:
指定された name で表されるプロパティーである Object
例外:
NullPointerException - プロパティー名が null の場合
関連項目:
Image.UndefinedProperty

getGraphics

public Graphics getGraphics()
このメソッドは Graphics2D を返しますが、ここでは下位互換のために提供されます。Graphics2D を返すように宣言されているため、createGraphics の方が便利です。

定義:
クラス Image 内の getGraphics
戻り値:
このイメージへの描画に使用される 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 表現を返します。

オーバーライド:
クラス Object 内の toString
戻り値:
この BufferedImage を表す String

getSources

public Vector<RenderedImage> getSources()
この BufferedImage のイメージデータの直接のソース (直接のソースのソースではない) である RenderedImage オブジェクトの Vector を返します。BufferedImage に直接のソースについての情報がない場合、このメソッドは null を返します。BufferedImage が直接のソースを持たない場合は、空の Vector を返します。

定義:
インタフェース RenderedImage 内の getSources
戻り値:
この BufferedImage オブジェクトのイメージデータの 直接のソースを格納している Vector。 この BufferedImage が直接のソースについての 情報を持たない場合は null。 この BufferedImage が直接のソースを持たない場合は 空の Vector

getPropertyNames

public String[] getPropertyNames()
getProperty(String) が認識する名前の配列を返します。プロパティー名が認識されない場合は null を返します。

定義:
インタフェース RenderedImage 内の getPropertyNames
戻り値:
getProperty(String) が認識するすべてのプロパティー名を 含む String 配列。 プロパティー名が認識されない場合は null

getMinX

public int getMinX()
この BufferedImage の最小 x 座標を返します。これは常に 0 になります。

定義:
インタフェース RenderedImage 内の getMinX
戻り値:
この BufferedImage の 最小 x 座標

getMinY

public int getMinY()
この BufferedImage の最小 y 座標を返します。これは常に 0 になります。

定義:
インタフェース RenderedImage 内の getMinY
戻り値:
この BufferedImage の 最小 y 座標

getSampleModel

public SampleModel getSampleModel()
この BufferedImage に関連付けられた SampleModel を返します。

定義:
インタフェース RenderedImage 内の getSampleModel
戻り値:
この BufferedImageSampleModel

getNumXTiles

public int getNumXTiles()
x 方向のタイルの数を返します。これは常に 1 になります。

定義:
インタフェース RenderedImage 内の getNumXTiles
戻り値:
x 方向のタイル数

getNumYTiles

public int getNumYTiles()
y 方向のタイルの数を返します。これは常に 1 になります。

定義:
インタフェース RenderedImage 内の getNumYTiles
戻り値:
y 方向のタイル数

getMinTileX

public int getMinTileX()
x 方向の最小タイルインデックスを返します。これは常に 0 になります。

定義:
インタフェース RenderedImage 内の getMinTileX
戻り値:
x 方向の最小タイルインデックス

getMinTileY

public int getMinTileY()
y 方向の最小タイルインデックスを返します。これは常に 0 になります。

定義:
インタフェース RenderedImage 内の getMinTileY
戻り値:
y 方向の最小タイルインデックス

getTileWidth

public int getTileWidth()
タイルの幅をピクセル単位で返します。

定義:
インタフェース RenderedImage 内の getTileWidth
戻り値:
ピクセル単位のタイル幅

getTileHeight

public int getTileHeight()
タイルの高さをピクセル単位で返します。

定義:
インタフェース RenderedImage 内の getTileHeight
戻り値:
ピクセル単位のタイルの高さ

getTileGridXOffset

public int getTileGridXOffset()
原点を基準にタイルグリッドの x オフセットを返します。 たとえば、タイルの位置 (0, 0) の x 座標です。これは常に 0 になります。

定義:
インタフェース RenderedImage 内の getTileGridXOffset
戻り値:
タイルグリッドの x オフセット

getTileGridYOffset

public int getTileGridYOffset()
原点を基準にタイルグリッドの y オフセットを返します。 たとえば、タイルの位置 (0, 0) の y 座標です。これは常に 0 になります。

定義:
インタフェース RenderedImage 内の getTileGridYOffset
戻り値:
タイルグリッドの y オフセット

getTile

public Raster getTile(int tileX,
                      int tileY)
タイル (tileXtileY) を返します。tileX および tileY は、タイル配列のインデックスであり、ピクセルの位置ではありません。返される Raster はアクティブであり、イメージが変更されると更新されます。

定義:
インタフェース RenderedImage 内の getTile
パラメータ:
tileX - タイル配列にある要求されたタイルの x インデックス
tileY - タイル配列にある要求されたタイルの y インデックス
戻り値:
tileX および tileY 引数で定義される タイルを表す Raster
例外:
ArrayIndexOutOfBoundsException - tileXtileY の両方が 0 でない場合

getData

public Raster getData()
イメージを 1 つの大きなタイルとして返します。返された Raster はイメージデータのコピーであり、イメージが変更されても更新されません。

定義:
インタフェース RenderedImage 内の getData
戻り値:
イメージデータのコピーである Raster
関連項目:
setData(Raster)

getData

public Raster getData(Rectangle rect)
BufferedImage の任意の領域を計算して返します。返された Raster はイメージデータのコピーであり、イメージが変更されても更新されません。

定義:
インタフェース RenderedImage 内の getData
パラメータ:
rect - 返される BufferedImage の 領域
戻り値:
BufferedImage の指定された領域の イメージデータのコピーである Raster
関連項目:
setData(Raster)

copyData

public WritableRaster copyData(WritableRaster outRaster)
BufferedImage の任意の矩形領域を計算し、指定された WritableRaster にコピーします。計算される領域は、指定された WritableRaster の境界から決まります。指定された WritableRaster は、このイメージと互換性のある SampleModel を持つ必要があります。outRasternull の場合は、適切な WritableRaster が作成されます。

定義:
インタフェース RenderedImage 内の copyData
パラメータ:
outRaster - イメージの返された部分を保持する WritableRaster、 または null
戻り値:
供給または生成された WritableRaster への参照

setData

public void setData(Raster r)
イメージの矩形領域を指定された Raster である r の内容に設定します。 Raster r は、BufferedImage と同じ座標空間にあるものと仮定されます。このオペレーションは、BufferedImage の境界にクリッピングされます。

定義:
インタフェース WritableRenderedImage 内の setData
パラメータ:
r - 指定したRaster
関連項目:
getData(), getData(Rectangle)

addTileObserver

public void addTileObserver(TileObserver to)
タイルオブザーバを追加します。オブザーバがすでに存在する場合は、複数の通知を受け取ります。

定義:
インタフェース WritableRenderedImage 内の addTileObserver
パラメータ:
to - 指定された TileObserver

removeTileObserver

public void removeTileObserver(TileObserver to)
タイルオブザーバを削除します。オブザーバが登録されていなかった場合は、何も行われません。オブザーバが複数の通知を対象に登録されている場合は、登録対象の通知が 1 つ少なくなります。

定義:
インタフェース WritableRenderedImage 内の removeTileObserver
パラメータ:
to - 指定された TileObserver

isTileWritable

public boolean isTileWritable(int tileX,
                              int tileY)
タイルが書き込み用にチェックアウトされているかどうかを返します。

定義:
インタフェース WritableRenderedImage 内の isTileWritable
パラメータ:
tileX - タイルの x インデックス
tileY - タイルの y インデックス
戻り値:
指定のインデックスによって指定されるタイルが書き込み用に チェックアウトされている場合は true、そうでない場合は false
例外:
ArrayIndexOutOfBoundsException - tileXtileY の両方が 0 でない 場合

getWritableTileIndices

public Point[] getWritableTileIndices()
どのタイルが書き込みのためにチェックアウトされているかを示す Point オブジェクトの配列を返します。チェックアウトされているタイルがない場合は null を返します。

定義:
インタフェース WritableRenderedImage 内の getWritableTileIndices
戻り値:
書き込み用にチェックアウトされているタイルを示す Point 配列。書き込み用にチェックアウトされている タイルがない場合は null

hasTileWriters

public boolean hasTileWriters()
タイルが書き込み用にチェックアウトされているかどうかを返します。意味上は、以下と同じです。
 (getWritableTileIndices() != null).
 

定義:
インタフェース WritableRenderedImage 内の hasTileWriters
戻り値:
タイルが書き込み用にチェックアウトされている場合は true、 そうでない場合は false

getWritableTile

public WritableRaster getWritableTile(int tileX,
                                      int tileY)
書き込みのためにタイルをチェックアウトします。タイルがライターなしの状態から 1 つのライターを持つ状態に変わったときは、登録されているすべての TileObserver が通知を受けます。

定義:
インタフェース WritableRenderedImage 内の getWritableTile
パラメータ:
tileX - タイルの x インデックス
tileY - タイルの y インデックス
戻り値:
指定されたインデックスで示され、書き込み用にチェックアウトされる タイルを表す WritableRaster

releaseWritableTile

public void releaseWritableTile(int tileX,
                                int tileY)
タイルに書き込むためのアクセス権を放棄します。呼び出し側がタイルへの書き込みを続けた場合、結果は保証されません。このメソッドは、getWritableTile(int, int) とペアで呼び出す必要があります。それ以外の方法では結局、結果が未定義となります。タイルが 1 つのライターを持つ状態からライターなしの状態に変わるときは、登録されたすべての TileObservers が通知を受けます。

定義:
インタフェース WritableRenderedImage 内の releaseWritableTile
パラメータ:
tileX - タイルの x インデックス
tileY - タイルの y インデックス

getTransparency

public int getTransparency()
透明度を返します。OPAQUE、BITMASK、TRANSLUCENT のいずれかを返します。

定義:
インタフェース Transparency 内の getTransparency
戻り値:
この BufferedImage の透明度
導入されたバージョン:
1.5
関連項目:
Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。