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 で構成されています。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 を作成します。
void	flush() 最適化情報をキャッシュに 格納するために使用されているすべてのリソースをフラッシュします。
WritableRaster	getAlphaRaster() 別の空間アルファチャネル をサポートする ColorModel オブジェクト (ComponentColorModel および DirectColorModel など) で BufferedImage のアルファチャネルを表す WritableRaster を返します。
ImageCapabilities	getCapabilities(GraphicsConfiguration gc) このメソッドは Image.getCapabilities(gc) をオーバーライドし、その surfaceManager の機能を取得します。
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) タイル (tileX, tileY) を返します。
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 から継承されたメソッド

getAccelerationPriority, 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 を返します。

定義:

インタフェース RenderedImage 内の getColorModel

戻り値:

この 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, y - デフォルト RGB カラーモデルおよび sRGB カラースペースでの取得対象ピクセルの座標

戻り値:

デフォルト 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, startY - 開始座標

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, 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, startY - 開始座標

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

flush

public void flush()

最適化情報をキャッシュに格納するために使用されているすべてのリソースをフラッシュします。基本となるピクセルデータは影響を受けません。

定義:

クラス Image 内の flush

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, 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

戻り値:

この BufferedImage の SampleModel

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)

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

定義:

インタフェース RenderedImage 内の getTile

パラメータ:

tileX - タイル配列にある要求されたタイルの x インデックス

tileY - タイル配列にある要求されたタイルの y インデックス

戻り値:

tileX および tileY 引数で定義されるタイルを表す Raster

例外:

ArrayIndexOutOfBoundsException - tileX と tileY の両方が 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 を持つ必要があります。outRaster が null の場合は、適切な 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 - tileX と tileY の両方が 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

getCapabilities

public ImageCapabilities getCapabilities(GraphicsConfiguration gc)

このメソッドは Image.getCapabilities(gc) をオーバーライドし、その surfaceManager の機能を取得します。つまり、高速化された BufferedImage オブジェクトはこの高速化を示す caps オブジェクトを返すことがあります。

オーバーライド:

クラス Image 内の getCapabilities

パラメータ:

gc - GraphicsConfiguration オブジェクト。このパラメータの値が null の場合、デフォルトの GraphicsConfiguration のイメージ機能が取得される

戻り値:

指定された GraphicsConfiguration のこの Image の機能についての情報を持つ ImageCapabilities オブジェクト

関連項目:

VolatileImage.getCapabilities()