- 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 intTYPE_3BYTE_BGR青、緑、および赤が3バイトに格納された8ビットRGB色成分(WindowsスタイルのBGRカラー・モデルに対応)によるイメージを表します。static intTYPE_4BYTE_ABGR青、緑、および赤が3バイトに格納され、1バイトのアルファを持つ8ビットRGBA色成分によるイメージを表します。static intTYPE_4BYTE_ABGR_PRE青、緑、および赤が3バイトに格納され、1バイトのアルファを持つ8ビットRGBA色成分によるイメージを表します。static intTYPE_BYTE_BINARY不透明なbyteパックの1、2、または4ビット・イメージを表します。static intTYPE_BYTE_GRAY符号なしbyteグレー・スケール・イメージ(インデックスなし)を表します。static intTYPE_BYTE_INDEXEDインデックス付きbyteイメージを表します。static intTYPE_CUSTOMイメージ型が認識されないので、イメージは必ずカスタマイズされています。static intTYPE_INT_ARGB整数型ピクセルにパックされた8ビットRGBA色成分によるイメージを表します。static intTYPE_INT_ARGB_PRE整数型ピクセルにパックされた8ビットRGBA色成分によるイメージを表します。static intTYPE_INT_BGR青、緑、および赤が整数型ピクセルにパックされた8ビットRGB色成分(WindowsスタイルまたはSolarisスタイルのBGRカラー・モデルに対応)によるイメージを表します。static intTYPE_INT_RGB整数型ピクセルにパックされた8ビットRGB色成分によるイメージを表します。static intTYPE_USHORT_555_RGBアルファなしの5-5-5 RGB色成分(5ビットの赤、5ビットの緑、5ビットの青)によるイメージを表します。static intTYPE_USHORT_565_RGBアルファなしの5-6-5 RGB色成分(5ビットの赤、6ビットの緑、5ビットの青)によるイメージを表します。static intTYPE_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(int width, int height, int imageType)定義済みイメージ型の中の1つでBufferedImageを構築します。BufferedImage(int width, int height, int imageType, IndexColorModel cm)定義済みイメージ型のTYPE_BYTE_BINARYまたはTYPE_BYTE_INDEXEDのどちらかでBufferedImageを構築します。BufferedImage(ColorModel cm, WritableRaster raster, boolean isRasterPremultiplied, Hashtable<?,?> properties)指定されたColorModelとRasterで新しいBufferedImageを構築します。
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 voidaddTileObserver(TileObserver to)タイル・オブザーバを追加します。voidcoerceData(boolean isAlphaPremultiplied)isAlphaPremultiplied変数で指定された状態にデータを一致させます。WritableRastercopyData(WritableRaster outRaster)BufferedImageの任意の矩形領域を計算し、指定されたWritableRasterにコピーします。Graphics2DcreateGraphics()このBufferedImageに描画するために使用できるGraphics2Dを作成します。WritableRastergetAlphaRaster()別の空間アルファ・チャネルをサポートするColorModelオブジェクト(ComponentColorModelおよびDirectColorModelなど)でBufferedImageのアルファ・チャネルを表すWritableRasterを返します。ColorModelgetColorModel()ColorModelを返します。RastergetData()イメージを1つの大きなタイルとして返します。RastergetData(Rectangle rect)BufferedImageの任意の領域を計算して返します。GraphicsgetGraphics()このメソッドはGraphics2Dを返しますが、ここでは下位互換性のために提供されます。intgetHeight()BufferedImageの高さを返します。intgetHeight(ImageObserver observer)BufferedImageの高さを返します。intgetMinTileX()x方向の最小タイル・インデックスを返します。intgetMinTileY()y方向の最小タイル・インデックスを返します。intgetMinX()このBufferedImageの最小x座標を返します。intgetMinY()このBufferedImageの最小y座標を返します。intgetNumXTiles()x方向のタイルの数を返します。intgetNumYTiles()y方向のタイルの数を返します。ObjectgetProperty(String name)イメージのプロパティを名前で返します。ObjectgetProperty(String name, ImageObserver observer)イメージのプロパティを名前で返します。String[]getPropertyNames()getProperty(String)が認識する名前の配列を返すか、プロパティ名が認識されない場合はnullを返します。WritableRastergetRaster()WritableRasterを返します。intgetRGB(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カラー・スペースでイメージ・データの一部から整数型ピクセルの配列を返します。SampleModelgetSampleModel()このBufferedImageに関連付けられたSampleModelを返します。ImageProducergetSource()イメージのピクセルを生成するオブジェクトを返します。Vector<RenderedImage>getSources()このBufferedImageのイメージ・データの直接のソース(直接のソースのソースではありません)であるRenderedImageオブジェクトのVectorを返します。BufferedImagegetSubimage(int x, int y, int w, int h)指定された矩形領域で定義されるサブイメージを返します。RastergetTile(int tileX, int tileY)タイル(tileX,tileY)を返します。intgetTileGridXOffset()原点を基準にタイル・グリッドのxオフセットを返します。たとえば、タイルの位置(0, 0)のx座標です。intgetTileGridYOffset()原点を基準にタイル・グリッドのyオフセットを返します。たとえば、タイルの位置(0, 0)のy座標です。intgetTileHeight()タイルの高さをピクセル単位で返します。intgetTileWidth()タイルの幅をピクセル単位で返します。intgetTransparency()透明度を返します。intgetType()イメージ型を返します。intgetWidth()BufferedImageの幅を返します。intgetWidth(ImageObserver observer)BufferedImageの幅を返します。WritableRastergetWritableTile(int tileX, int tileY)書込みのためにタイルをチェック・アウトします。Point[]getWritableTileIndices()どのタイルが書込みのためにチェック・アウトされているかを示すPointオブジェクトの配列を返します。booleanhasTileWriters()タイルが書込み用にチェック・アウトされているかどうかを返します。booleanisAlphaPremultiplied()アルファがあらかじめ乗算されているかどうかを返します。booleanisTileWritable(int tileX, int tileY)タイルが書込み用にチェック・アウトされているかどうかを返します。voidreleaseWritableTile(int tileX, int tileY)タイルに書き込むためのアクセス権を放棄します。voidremoveTileObserver(TileObserver to)タイル・オブザーバを削除します。voidsetData(Raster r)イメージの矩形領域を、指定されたRaster rの内容に設定します。BufferedImageと同じ座標空間にあると想定されます。voidsetRGB(int x, int y, int rgb)このBufferedImageのピクセルを、指定されたRGB値に設定します。voidsetRGB(int startX, int startY, int w, int h, int[] rgbArray, int offset, int scansize)デフォルトRGBカラー・モデル(TYPE_INT_ARGB)およびデフォルトsRGBカラー・スペースで、intピクセルの配列をイメージ・データの一部に設定します。StringtoString()このBufferedImageオブジェクトおよびその値のString表現を返します。-
クラス java.awt.Imageで宣言されたメソッド
flush, getAccelerationPriority, getCapabilities, getScaledInstance, setAccelerationPriority
-
-
-
-
フィールドの詳細
-
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_GRAYColorSpaceを持つComponentColorModelを持ちます。 不透明でないアルファを持つデータをこの型のイメージに格納する場合、AlphaCompositeのドキュメントの説明のとおりに、カラー・データをあらかじめ乗算されていない形式に調整し、アルファを破棄する必要があります。- 関連項目:
- 定数フィールド値
-
TYPE_USHORT_GRAY
public static final int TYPE_USHORT_GRAY
符号なしshortグレー・スケール・イメージ(インデックスなし)を表します。 このイメージは、CS_GRAYColorSpaceを持つComponentColorModelを持ちます。 不透明でないアルファを持つデータをこの型のイメージに格納する場合、AlphaCompositeのドキュメントの説明のとおりに、カラー・データをあらかじめ乗算されていない形式に調整し、アルファを破棄する必要があります。- 関連項目:
- 定数フィールド値
-
TYPE_BYTE_BINARY
public static final int TYPE_BYTE_BINARY
不透明なbyteパックの1、2、または4ビット・イメージを表します。 このイメージはIndexColorModel(アルファなし)を持ちます。imageType引数をとりColorModel引数をとらないBufferedImageコンストラクタのimageType引数としてこの型を使用する場合、デフォルトのsRGBColorSpaceにある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- 新しいイメージのColorModelraster- イメージ・データのRasterisRasterPremultiplied-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のWritableRaster。
-
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表現を返します。
-
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の内容に設定します。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
-
-