|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Image | +--java.awt.image.BufferedImage
BufferedImage
サブクラスは、イメージデータのアクセス可能なバッファを備えた Image
を記述します。BufferedImage
は、ColorModel
およびイメージデータの Raster
で構成されます。Raster
の SampleModel
のバンド数および型は、色成分およびアルファ成分を表すために ColorModel
によって要求される数および型と一致しなければなりません。すべての BufferedImage
オブジェクトの左上隅の座標は (0, 0) です。そのため、BufferedImage
を作成するために使用される Raster
は minX=0 および minY=0 でなければなりません。
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 パックバイナリイメージを表します。 |
static int |
TYPE_BYTE_GRAY
符号なし byte グレースケールイメージ (インデックスなし) を表します。 |
static int |
TYPE_BYTE_INDEXED
インデックス付き byte イメージを表します。 |
static int |
TYPE_CUSTOM
イメージタイプが認識されないので、イメージはカスタマイズされているはずです。 |
static int |
TYPE_INT_ARGB
int ピクセルにパックされた 8 ビット RGBA 色成分によるイメージを表します。 |
static int |
TYPE_INT_ARGB_PRE
int ピクセルにパックされた 8 ビット RGBA 色成分によるイメージを表します。 |
static int |
TYPE_INT_BGR
青、緑、および赤が int ピクセルにパックされた 8 ビット RGB 色成分 (Windows スタイルまたは Solaris スタイルの BGR カラーモデルに対応) によるイメージを表します。 |
static int |
TYPE_INT_RGB
int ピクセルにパックされた 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 から継承したフィールド |
SCALE_AREA_AVERAGING,
SCALE_DEFAULT,
SCALE_FAST,
SCALE_REPLICATE,
SCALE_SMOOTH,
UndefinedProperty |
コンストラクタの概要 | |
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 を返します。 |
ColorModel |
getColorModel()
ColorModel を返します。 |
Raster |
getData()
イメージを 1 つの大きなタイルとして返します。 |
Raster |
getData(Rectangle rect)
BufferedImage の任意の領域を計算して返します。 |
Graphics |
getGraphics()
このメソッドは Graphics2D を返しますが、ここでは下位互換のために提供されます。 |
int |
getHeight()
BufferedImage の高さを返します。 |
int |
getHeight(ImageObserver observer)
イメージの実際の高さを返します。 |
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 ピクセルを返します。 |
int[] |
getRGB(int startX,
int startY,
int w,
int h,
int[] rgbArray,
int offset,
int scansize)
デフォルト RGB カラーモデル (TYPE_INT_ARGB) およびデフォルト sRGB カラースペースでイメージデータの一部から int ピクセルの配列を返します。 |
SampleModel |
getSampleModel()
この BufferedImage に関連付けられた SampleModel を返します。 |
ImageProducer |
getSource()
イメージのピクセルを生成するオブジェクトを返します。 |
Vector |
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 |
getType()
イメージタイプを返します。 |
int |
getWidth()
BufferedImage の幅を返します。 |
int |
getWidth(ImageObserver observer)
イメージの実際の幅を返します。 |
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 から継承したメソッド |
getScaledInstance |
クラス java.lang.Object から継承したメソッド |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
フィールドの詳細 |
public static final int TYPE_CUSTOM
public static final int TYPE_INT_RGB
DirectColorModel
(アルファなし) を持ちます。public static final int TYPE_INT_ARGB
DirectColorModel
(アルファあり) を持ちます。このイメージのカラーデータには、アルファがあらかじめ乗算されてはいません。このタイプが BufferedImage
コンストラクタへの imageType
引数として使用される場合、作成されるイメージは JDK 1.1 以前のリリースで作成されるイメージと一貫性があります。public static final int TYPE_INT_ARGB_PRE
DirectColorModel
(アルファあり) を持ちます。このイメージのカラーデータは、アルファがあらかじめ乗算されています。public static final int TYPE_INT_BGR
ComponentColorModel
を持ちます。public static final int TYPE_3BYTE_BGR
ComponentColorModel
を持ちます。public static final int TYPE_4BYTE_ABGR
ComponentColorModel
(アルファあり) を持ちます。このイメージのカラーデータには、アルファがあらかじめ乗算されてはいません。byte データは、各ピクセルの byte アドレスの小さい方から A、B、G、R の順序で単一 byte 配列にインタリーブされます。public static final int TYPE_4BYTE_ABGR_PRE
ComponentColorModel
(アルファあり) を持ちます。このイメージのカラーデータには、アルファがあらかじめ乗算されています。byte データは、各ピクセルの byte アドレスの小さい方から A、B、G、R の順序で単一 byte 配列にインタリーブされます。public static final int TYPE_USHORT_565_RGB
DirectColorModel
を持ちます。public static final int TYPE_USHORT_555_RGB
DirectColorModel
を持ちます。public static final int TYPE_BYTE_GRAY
ColorSpace
を持つ ComponentColorModel
を持ちます。public static final int TYPE_USHORT_GRAY
ColorSpace
を持つ ComponentColorModel
を持ちます。public static final int TYPE_BYTE_BINARY
IndexColorModel
(アルファなし) を持ちます。imageType
引数をとり ColorModel
引数をとらない BufferedImage
コンストラクタの imageType
引数としてこのタイプが使用される場合、IndexColorModel
はデフォルト sRGB ColorSpace
の 2 つの色 ({0, 0, 0} および {255, 255, 255}) で作成されます。public static final int TYPE_BYTE_INDEXED
imageType
引数はとり ColorModel
引数はとらない BufferedImage
コンストラクタの imageType
引数としてこのタイプが使用される場合、IndexColorModel
はデフォルト sRGB ColorSpace の 256 色 6/6/6 カラーキューブパレット (216-255 以外の色はグレースケール値) で作成されます。コンストラクタの詳細 |
public BufferedImage(int width, int height, int imageType)
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
public BufferedImage(int width, int height, int imageType, IndexColorModel cm)
BufferedImage
を構築します。width
- 作成するイメージの幅height
- 作成するイメージの高さimageType
- 作成するイメージのタイプcm
- 作成するイメージの IndexColorModel
TYPE_BYTE_BINARY
,
TYPE_BYTE_INDEXED
public BufferedImage(ColorModel cm, WritableRaster raster, boolean isRasterPremultiplied, Hashtable properties)
ColorModel
および Raster
を指定して、新しい BufferedImage
を構築します。Raster
の SampleModel
のバンドの数および型が、色成分およびアルファ成分を表すために ColorModel
によって要求される数および型と一致しない場合は、RasterFormatException
がスローされます。このメソッドは、ColorModel
の alphaPremultiplied
状態と一致させるために色 Raster
データをアルファで乗算または除算できます。この BufferedImage
のプロパティは、String
と Object
のペアの Hashtable
を渡すことによって確立できます。ColorModel
- 新しいイメージの ColorModel
raster
- イメージデータの Raster
isRasterPremultiplied
- true
の場合、ラスタのデータはアルファによって左から乗算されているproperties
- String
と Object
のペアの Hashtable
RasterFormatException
- Raster
の SampleModel
のバンド数および型が、色成分およびアルファ成分を表すために ColorModel
によって要求される数および型と一致しない場合IllegalArgumentException
- raster
が cm
に対応していない場合ColorModel
,
Raster
,
WritableRaster
メソッドの詳細 |
public int getType()
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
public ColorModel getColorModel()
ColorModel
を返します。BufferedImage
の ColorModel
public WritableRaster getRaster()
WritableRaster
を返します。BufferedImage
の WriteableRaster
public WritableRaster getAlphaRaster()
ColorModel
オブジェクト (ComponentColorModel
および DirectColorModel
など) で BufferedImage
のアルファチャネルを表す WritableRaster
を返します。このイメージの ColorModel
と関連付けられたアルファチャネルがない場合には null
を返します。IndexColorModel
を除くすべての ColorModel
オブジェクトに関し、ColorModel
がアルファをサポートする場合、このメソッドは、イメージデータの最後のバンドに別のアルファチャネルが格納されていると見なします。イメージがルックアップテーブルにアルファを持つ IndexColorModel
を使用する場合、このメソッドは null
を返します。その理由は、空間的に分離したアルファチャネルがないからです。このメソッドは新しい WritableRaster
を作成しますが、データ配列は共有されます。WritableRaster
。この BufferedImage
が ColorModel
と関連付けられているアルファチャネルを持たない場合は null
public int getRGB(int x, int y)
ColorModel
と一致しない場合には色変換が行われます。このメソッドを使用する場合、返されたデータの各色成分の精度はわずか 8 ビットです。x, y
- デフォルト RGB カラーモデルおよび sRGB カラースペースでの取得対象ピクセルの座標public int[] getRGB(int startX, int startY, int w, int h, int[] rgbArray, int offset, int scansize)
ColorModel
と一致しない場合には色変換が行われます。このメソッドを使用する場合、返されたデータの各色成分の精度はわずか 8 ビットです。イメージの座標 (x, y) を指定した場合、ARGB ピクセルには次のようにしてアクセスできます。
pixel = rgbArray[offset + (y-startY)*scansize + (x-startX)];
startX, startY
- 開始座標w
- 領域の幅h
- 領域の高さrgbArray
- null
でない場合、rgb ピクセルはここに書き込まれるoffset
- rgbArray
のオフセットscansize
- rgbArray
の走査線のストライドIllegalArgumentException
- 指定されたデータ型が不明の場合public void setRGB(int x, int y, int rgb)
BufferedImage
のピクセルを、指定された RGB 値に設定します。ピクセルは、デフォルト RGB カラーモデル (TYPE_INT_ARGB) およびデフォルト sRGB カラースペースにあると見なされます。IndexColorModel
を持つイメージの場合、もっとも近い色のインデックスが選択されます。x, y
- 設定するピクセルの座標rgb
- RGB 値public void setRGB(int startX, int startY, int w, int h, int[] rgbArray, int offset, int scansize)
ColorModel
と一致しない場合は色変換が行われます。このメソッドを使用する場合、返されたデータの各色成分の精度はわずか 8 ビットです。このイメージの座標 (x, y) を指定した場合、ARGB ピクセルには次のようにしてアクセスできます。
pixel = rgbArray[offset + (y-startY)*scansize + (x-startX)];警告: ディザリングは行われません。
startX, startY
- 開始座標w
- 領域の幅h
- 領域の高さrgbArray
- rgb ピクセルoffset
- rgbArray
のオフセットscansize
- rgbArray
の走査線のストライドpublic int getWidth()
BufferedImage
の幅を返します。BufferedImage
の幅public int getHeight()
BufferedImage
の高さを返します。BufferedImage
の高さpublic int getWidth(ImageObserver observer)
ImageObserver
はあとで通知を受け、-1
を返されます。observer
- イメージについての情報を受け取る ImageObserver
-1
Image.getHeight(ImageObserver)
,
ImageObserver
public int getHeight(ImageObserver observer)
ImageObserver
はあとで通知を受け、-1
を返されます。observer
- イメージについての情報を受け取る ImageObserver
-1
Image.getWidth(ImageObserver)
,
ImageObserver
public ImageProducer getSource()
ImageProducer
ImageProducer
public Object getProperty(String name, ImageObserver observer)
UndefinedProperty
フィールドを返します。このイメージのプロパティが不明な場合、このメソッドは null
を返し、ImageObserver
オブジェクトはあとで通知を受けます。プロパティ名「comment」は、イメージ、ソース、および作成者の説明としてユーザに提示することができる任意のコメントを格納するために使用されます。name
- プロパティ名observer
- イメージ情報に関する通知を受け取る ImageObserver
name
で表されるプロパティである Object
。このイメージのプロパティが不明の場合は null
ImageObserver
,
Image.UndefinedProperty
public Object getProperty(String name)
name
- プロパティ名name
で表されるプロパティである Object
public void flush()
public Graphics getGraphics()
Graphics2D
を返しますが、ここでは下位互換のために提供されます。Graphics2D
を返すように宣言されているため、createGraphics の方が便利です。Graphics2D
public Graphics2D createGraphics()
BufferedImage
に描画するために使用できる Graphics2D
を作成します。Graphics2D
public BufferedImage getSubimage(int x, int y, int w, int h)
BufferedImage
は、オリジナルイメージと同じデータ配列を共有します。x, y
- 矩形領域の左上隅の座標w
- 矩形領域の幅h
- 矩形領域の高さBufferedImage
のサブイメージを表す BufferedImage
RasterFormatException
- 指定された領域がこの BufferedImage
内に含まれていない場合public boolean isAlphaPremultiplied()
true
が返されます。true
、そうでない場合は false
public void coerceData(boolean isAlphaPremultiplied)
isAlphaPremultiplied
変数で指定された状態にデータを一致させます。カラーラスタデータをアルファで乗算または除算します。データが正しい状態にある場合、処理は行われません。isAlphaPremultiplied
- アルファがあらかじめ乗算されている場合は true
、そうでない場合は false
public String toString()
BufferedImage
オブジェクトとその値の String
表現を返します。BufferedImage
を表す String
public Vector getSources()
BufferedImage
のイメージデータの直接のソース (直接のソースのソースではない) である RenderedImage
オブジェクトの Vector
を返します。BufferedImage
に直接のソースについての情報がない場合、このメソッドは null
を返します。BufferedImage
が直接のソースを持たない場合は、空の Vector
を返します。BufferedImage
オブジェクトのイメージデータの直接のソースを格納している Vector
。この BufferedImage
が直接のソースについての情報を持たない場合は null
。この BufferedImage
が直接のソースを持たない場合は空の Vector
public String[] getPropertyNames()
null
を返します。getProperty(String)
が認識するすべてのプロパティ名が格納されている String
配列。プロパティ名が認識されない場合は null
public int getMinX()
BufferedImage
の最小 x 座標を返します。これは常に 0 になります。BufferedImage
の最小 x 座標public int getMinY()
BufferedImage
の最小 y 座標を返します。これは常に 0 になります。BufferedImage
の最小 y 座標public SampleModel getSampleModel()
BufferedImage
に関連付けられた SampleModel
を返します。BufferedImage
の SampleModel
public int getNumXTiles()
public int getNumYTiles()
public int getMinTileX()
public int getMinTileY()
public int getTileWidth()
public int getTileHeight()
public int getTileGridXOffset()
public int getTileGridYOffset()
public Raster getTile(int tileX, int tileY)
tileX
, tileY
) を返します。tileX
および tileY
は、タイル配列のインデックスであり、ピクセルの位置ではありません。返される Raster
はアクティブであり、イメージが変更されると更新されます。tileX
- タイル配列の要求されたタイルの x インデックスtileY
- タイル配列の要求されたタイルの y インデックスtileX
および tileY
引数で定義されるタイルを表す Raster
ArrayIndexOutOfBoundsException
- tileX
と tileY
の両方が 0 でない場合public Raster getData()
Raster
はイメージデータのコピーであり、イメージが変更されても更新されません。Raster
public Raster getData(Rectangle rect)
BufferedImage
の任意の領域を計算して返します。返された Raster
はイメージデータのコピーであり、イメージが変更されても更新されません。rect
- 返された BufferedImage
の領域BufferedImage
の指定された領域のイメージデータのコピーである Raster
public WritableRaster copyData(WritableRaster outRaster)
BufferedImage
の任意の矩形領域を計算し、指定された WritableRaster
にコピーします。計算される領域は、指定された WritableRaster
の境界から決まります。指定された WritableRaster
は、このイメージと互換性のある SampleModel
を持つ必要があります。outRaster
が null
の場合は、適切な WritableRaster
が作成されます。outRaster
- イメージの返された部分を格納する WritableRaster
または null
WritableRaster
への参照public void setData(Raster r)
Raster
である r
の内容に設定します。Raster
r
は、BufferedImage
と同じ座標空間にあるものと仮定されます。このオペレーションは、BufferedImage
の境界にクリッピングされます。r
- Raster
public void addTileObserver(TileObserver to)
to
- TileObserver
public void removeTileObserver(TileObserver to)
to
- TileObserver
public boolean isTileWritable(int tileX, int tileY)
tileX
- タイルの x インデックスtileY
- タイルの y インデックスtrue
、そうでない場合は false
ArrayIndexOutOfBoundsException
- tileX
と tileY
の両方が 0 でない場合public Point[] getWritableTileIndices()
Point
オブジェクトの配列を返します。チェックアウトされているタイルがない場合には null
を返します。Point
配列。書き込み用にチェックアウトされているタイルがない場合は null
public boolean hasTileWriters()
(getWritableTileIndices() != null).
true
、そうでない場合は false
public WritableRaster getWritableTile(int tileX, int tileY)
TileObserver
が通知を受けます。tileX
- タイルの x インデックスtileY
- タイルの y インデックスWritableRaster
public void releaseWritableTile(int tileX, int tileY)
TileObservers
が通知を受けます。tileX
- タイルの x インデックスtileY
- タイルの y インデックス
|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |