- java.lang.Object
- 
- java.awt.image.Raster
 
- 
- 直系の既知のサブクラス:
- WritableRaster
 
 
 public class Raster extends Object ピクセルで構成される矩形配列を表現するクラスです。 Rasterは、サンプル値が格納されているDataBufferと、指定されたサンプル値をDataBufferから検出する方法が記述されているSampleModelをカプセル化します。Rasterは、平面上の特定の矩形領域(必ずしも(0, 0)を含んでいなくてもよい)を占めるピクセルの値を定義します。 この矩形は、Rasterの境界の矩形と呼ばれ、getBoundsメソッドにより取得され、minX、minY、width、heightの値によって定義されます。 minXとminYの値は、Rasterの左上隅の座標を定義します。 境界の矩形外のピクセルを参照すると、例外がスローされたり、Rasterの関連DataBufferの意図しない要素が参照されることになります。 このような範囲外のアクセスは行わないようにしてください。 SampleModelは、RasterのサンプルがDataBufferのプリミティブ配列要素に格納される方法を記述します。 サンプルは、PixelInterleavedSampleModelやBandedSampleModelのようにデータ要素ごとに1つずつ格納することも、SinglePixelPackedSampleModelやMultiPixelPackedSampleModelのように複数の要素を1つにまとめて格納することもできます。 SampleModelは、サンプルが符号付き拡張形式かどうかも制御します。これにより、符号なしデータをbyte、short、intなどの、Javaの符号付きデータ型として格納できます。 Rasterは平面上のどこにでも存在できますが、SampleModelは(0, 0)から始まる簡易座標体系を利用します。 このため、Rasterは、Rasterの座標体系とSampleModelの座標体系の間でピクセル位置をマッピングできるようにする変換係数を持っています。 SampleModelの座標体系からRasterの座標体系への変換は、getSampleModelTranslateXメソッドとgetSampleModelTranslateYメソッドで取得できます。 RasterはほかのRasterとDataBufferを共有できますが、このためには、このようなRasterを明示的に構築するか、createChildメソッドとcreateTranslatedChildメソッドを使用します。 これらのメソッドによって構築されたRasterに対してgetParentメソッドを使用すると、構築元のRasterへの参照を取得できます。 createTranslatedChildやcreateChildの呼出しによって構築されたRasterでない場合、getParentはnullを返します。 createTranslatedChildメソッドは、現在のRasterのすべてのデータを共有する新しいRasterを返します。新しいRasterは、現在のRasterと同じ幅と高さの境界の矩形を占めますが、開始点が異なります。 たとえば、親のRasterが(10, 10)から(100, 100)までの領域を占める場合、変換後のRasterの領域の始点を(50, 50)に定義すると、親のピクセル(20, 20)と子のピクセル(60, 60)はこれら2つのRasterで共有されるDataBufferで同じ位置を占めます。 対応するSampleModel座標を取得する場合、最初のケースではピクセル座標に(-10, -10)が加算されるのに対し、2番目のケースでは(-50, -50)が加算されます。 親のsampleModelTranslateXとsampleModelTranslateYの値から、子のsampleModelTranslateXとsampleModelTranslateYの値を減算することで、Rasterの親子間の変換が可能です。 createChildメソッドを使うと、親の境界の矩形のサブセットのみを占め、同じ座標体系または変換後の座標体系を持つ新しいRasterや、親のバンドのサブセットを持つ新しいRasterを生成できます。 コンストラクタはすべて保護されています。 Rasterを生成する正しい方法は、このクラスで定義されている静的なcreateメソッドの1つを使うことです。 これらのメソッドを使うと、標準のインタリーブ化されたSampleModel、バンド化されたSampleModel、およびパックされたSampleModelを使うRasterのインスタンスが生成され、外部で生成されたSampleModelとDataBufferを結合して生成される場合と比べて効率的に処理できます。 
- 
- 
フィールドのサマリーフィールド 修飾子と型 フィールド 説明 protected DataBufferdataBufferイメージ・データを格納するDataBufferです。protected intheightこのRasterの高さです。protected intminXこのRasterの左上隅のピクセルのX座標です。protected intminYこのRasterの左上隅のピクセルのY座標です。protected intnumBandsRaster内のバンド数です。protected intnumDataElements1ピクセルあたりのDataBufferデータ要素の数です。protected RasterparentこのRasterの親、またはnullです。protected SampleModelsampleModelこのRasterのピクセルがDataBufferに格納される方法を記述するSampleModelです。protected intsampleModelTranslateXRasterのSampleModelの座標空間からRasterの座標空間へのX変換です。protected intsampleModelTranslateYRasterのSampleModelの座標空間からRasterの座標空間へのY変換です。protected intwidthこのRasterの幅です。
 - 
コンストラクタのサマリーコンストラクタ 修飾子 コンストラクタ 説明 protectedRaster(SampleModel sampleModel, DataBuffer dataBuffer, Point origin)指定されたSampleModelおよびDataBufferを持つRasterを構築します。protectedRaster(SampleModel sampleModel, DataBuffer dataBuffer, Rectangle aRegion, Point sampleModelTranslate, Raster parent)指定されたSampleModel、DataBuffer、および親を使ってRasterを構築します。protectedRaster(SampleModel sampleModel, Point origin)指定されたSampleModelを持つRasterを構築します。
 - 
メソッドのサマリーすべてのメソッド staticメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 static WritableRastercreateBandedRaster(int dataType, int w, int h, int scanlineStride, int[] bankIndices, int[] bandOffsets, Point location)指定されたデータ型、幅、高さ、走査線ストライド、バンク・インデックス、バンド・オフセットを持つ、BandedSampleModelに基づいたRasterを生成します。static WritableRastercreateBandedRaster(int dataType, int w, int h, int bands, Point location)指定されたデータ型、幅、高さ、バンド数を持つ、BandedSampleModelに基づいたRasterを生成します。static WritableRastercreateBandedRaster(DataBuffer dataBuffer, int w, int h, int scanlineStride, int[] bankIndices, int[] bandOffsets, Point location)指定されたDataBuffer、幅、高さ、走査線ストライド、バンク・インデックス、およびバンド・オフセットを持つ、BandedSampleModelに基づいたRasterを生成します。RastercreateChild(int parentX, int parentY, int width, int height, int childMinX, int childMinY, int[] bandList)このRasterのDataBufferのすべてまたは一部を共有する新しいRasterを返します。WritableRastercreateCompatibleWritableRaster()このRasterと同じSampleModelと初期化された新しいDataBufferを持ち、このRasterと同じサイズで互換性があるWritableRasterを生成します。WritableRastercreateCompatibleWritableRaster(int w, int h)指定されたサイズ、新しいSampleModel、および初期化された新しいDataBufferを持ち、互換性があるWritableRasterを生成します。WritableRastercreateCompatibleWritableRaster(int x, int y, int w, int h)指定された位置(minX, minY)とサイズ(width, height)、新しいSampleModel、および初期化された新しいDataBufferを持ち、互換性があるWritableRasterを生成します。WritableRastercreateCompatibleWritableRaster(Rectangle rect)rectによって指定される位置(minX, minY)とサイズ(width, height)、新しいSampleModel、および初期化された新しいDataBufferを持ち、互換性があるWritableRasterを生成します。static WritableRastercreateInterleavedRaster(int dataType, int w, int h, int scanlineStride, int pixelStride, int[] bandOffsets, Point location)指定されたデータ型、幅、高さ、走査線ストライド、ピクセル・ストライド、およびバンド・オフセットを持つ、PixelInterleavedSampleModelに基づいたRasterを生成します。static WritableRastercreateInterleavedRaster(int dataType, int w, int h, int bands, Point location)指定されたデータ型、幅、高さ、およびバンド数を持つ、PixelInterleavedSampleModelに基づいたRasterを生成します。static WritableRastercreateInterleavedRaster(DataBuffer dataBuffer, int w, int h, int scanlineStride, int pixelStride, int[] bandOffsets, Point location)指定されたDataBuffer、幅、高さ、走査線ストライド、ピクセル・ストライド、およびバンド・オフセットを持つ、PixelInterleavedSampleModelに基づいたRasterを生成します。static WritableRastercreatePackedRaster(int dataType, int w, int h, int[] bandMasks, Point location)指定されたデータ型、幅、高さ、およびバンド・マスクを持つ、SinglePixelPackedSampleModelに基づいたRasterを生成します。static WritableRastercreatePackedRaster(int dataType, int w, int h, int bands, int bitsPerBand, Point location)指定されたデータ型、幅、高さ、バンド数、および1バンドあたりのビット数を持つ、パックされたSampleModelに基づいたRasterを生成します。static WritableRastercreatePackedRaster(DataBuffer dataBuffer, int w, int h, int scanlineStride, int[] bandMasks, Point location)指定されたDataBuffer、幅、高さ、走査線ストライド、およびバンド・マスクを持つ、SinglePixelPackedSampleModelに基づいたRasterを生成します。static WritableRastercreatePackedRaster(DataBuffer dataBuffer, int w, int h, int bitsPerPixel, Point location)指定されたDataBuffer、幅、高さ、および1ピクセルあたりのビット数を持つ、MultiPixelPackedSampleModelに基づいたRasterを生成します。static RastercreateRaster(SampleModel sm, DataBuffer db, Point location)指定されたSampleModelとDataBufferを持つRasterを生成します。RastercreateTranslatedChild(int childMinX, int childMinY)このRasterと同じサイズ、SampleModel、およびDataBufferを持ち、位置が異なるRasterを生成します。static WritableRastercreateWritableRaster(SampleModel sm, DataBuffer db, Point location)指定されたSampleModelとDataBufferを持つWritableRasterを生成します。static WritableRastercreateWritableRaster(SampleModel sm, Point location)指定されたSampleModelを持つWritableRasterを生成します。RectanglegetBounds()このRasterの境界のRectangleを返します。DataBuffergetDataBuffer()このRasterに関連したDataBufferを返します。ObjectgetDataElements(int x, int y, int w, int h, Object outData)TransferType型のプリミティブ配列の、指定されたピクセル矩形のピクセル・データを返します。ObjectgetDataElements(int x, int y, Object outData)transferType型のプリミティブ配列内の1つのピクセルのデータを返します。intgetHeight()Rasterの高さをピクセル単位で返します。intgetMinX()Rasterの有効な最小のX座標を返します。intgetMinY()Rasterの有効な最小のY座標を返します。intgetNumBands()このRaster内のバンド数(1ピクセルあたりのサンプル数)を返します。intgetNumDataElements()getDataElementsメソッドおよびsetDataElementsメソッドを使って1ピクセル転送するのに必要なデータ要素の数を返します。RastergetParent()このRasterの親Rasterがあればそれを返します。親がない場合は、nullを返します。double[]getPixel(int x, int y, double[] dArray)指定されたピクセルのサンプルをdouble配列として返します。float[]getPixel(int x, int y, float[] fArray)指定されたピクセルのサンプルをfloat配列として返します。int[]getPixel(int x, int y, int[] iArray)指定されたピクセルのサンプルをint配列として返します。double[]getPixels(int x, int y, int w, int h, double[] dArray)矩形のピクセルのサンプルすべてを、配列要素ごとに1つのサンプルが格納されているdouble配列として返します。float[]getPixels(int x, int y, int w, int h, float[] fArray)矩形のピクセルのサンプルすべてを、配列要素ごとに1つのサンプルが格納されているfloat配列として返します。int[]getPixels(int x, int y, int w, int h, int[] iArray)矩形のピクセルのサンプルすべてを、配列要素ごとに1つのサンプルが格納されているint配列として返します。intgetSample(int x, int y, int b)(x, y)に位置するピクセルの指定されたバンド内のサンプルをintとして返します。doublegetSampleDouble(int x, int y, int b)(x, y)に位置するピクセルの指定されたバンド内のサンプルをdoubleとして返します。floatgetSampleFloat(int x, int y, int b)(x, y)に位置するピクセルの指定されたバンド内のサンプルをfloatとして返します。SampleModelgetSampleModel()イメージ・データのレイアウトを記述するSampleModelを返します。intgetSampleModelTranslateX()SampleModelの座標体系からRasterの座標体系へのX変換を返します。intgetSampleModelTranslateY()SampleModelの座標体系からRasterの座標体系へのY変換を返します。double[]getSamples(int x, int y, int w, int h, int b, double[] dArray)double配列内の指定されたピクセル矩形の、指定されたバンドのサンプルを返します。配列要素ごとに1つのサンプルが返されます。float[]getSamples(int x, int y, int w, int h, int b, float[] fArray)float配列内の指定されたピクセル矩形の、指定されたバンドのサンプルを返します。配列要素ごとに1つのサンプルが返されます。int[]getSamples(int x, int y, int w, int h, int b, int[] iArray)int配列の指定されたピクセルの矩形の、指定されたバンドのサンプルを返します。配列要素ごとに1つのサンプルが返されます。intgetTransferType()getDataElementsメソッドおよびsetDataElementsメソッドを使ってピクセルを転送するのに使用されるTransferTypeを返します。intgetWidth()Rasterの幅をピクセル単位で返します。
 
- 
- 
- 
フィールドの詳細- 
sampleModelprotected SampleModel sampleModel このRasterのピクセルがDataBufferに格納される方法を記述するSampleModelです。
 - 
dataBufferprotected DataBuffer dataBuffer イメージ・データを格納するDataBufferです。
 - 
minXprotected int minX このRasterの左上隅のピクセルのX座標です。
 - 
minYprotected int minY このRasterの左上隅のピクセルのY座標です。
 - 
widthprotected int width このRasterの幅です。
 - 
heightprotected int height このRasterの高さです。
 - 
sampleModelTranslateXprotected int sampleModelTranslateX RasterのSampleModelの座標空間からRasterの座標空間へのX変換です。
 - 
sampleModelTranslateYprotected int sampleModelTranslateY RasterのSampleModelの座標空間からRasterの座標空間へのY変換です。
 - 
numBandsprotected int numBands Raster内のバンド数です。
 - 
numDataElementsprotected int numDataElements 1ピクセルあたりのDataBufferデータ要素の数です。
 - 
parentprotected Raster parent このRasterの親、またはnullです。
 
- 
 - 
コンストラクタの詳細- 
Rasterprotected Raster(SampleModel sampleModel, Point origin) 指定されたSampleModelを持つRasterを構築します。 Rasterは左上隅が原点で、サイズはSampleModelと同じです。 Rasterを記述するために十分な大きさのDataBufferが自動的に生成されます。- パラメータ:
- sampleModel- レイアウトを指定するSampleModel
- origin- 原点を指定したPoint
- 例外:
- RasterFormatException-- origin.x+sampleModel.getWidth()または- origin.y+sampleModel.getHeight()のいずれかの計算で整数型オーバーフローが発生した場合
- NullPointerException-- sampleModelまたは- originがnullである
 
 - 
Rasterprotected Raster(SampleModel sampleModel, DataBuffer dataBuffer, Point origin) 指定されたSampleModelおよびDataBufferを持つRasterを構築します。 Rasterは左上隅が原点で、サイズはSampleModelと同じです。 DataBufferは初期化されておらず、SampleModelに準拠している必要があります。- パラメータ:
- sampleModel- レイアウトを指定するSampleModel
- dataBuffer- イメージ・データを格納するDataBuffer
- origin- 原点を指定するPoint
- 例外:
- RasterFormatException-- origin.x+sampleModel.getWidth()または- origin.y+sampleModel.getHeight()のいずれかの計算で整数型オーバーフローが発生した場合
- NullPointerException-- sampleModelまたは- originがnullである
 
 - 
Rasterprotected Raster(SampleModel sampleModel, DataBuffer dataBuffer, Rectangle aRegion, Point sampleModelTranslate, Raster parent) 指定されたSampleModel、DataBuffer、および親を使ってRasterを構築します。aRegionは新しいRasterの境界の矩形を指定します。 基底Rasterの座標系に変換されるとき、aRegionは基底Rasterによって包含されている必要があります。 基底RasterはRasterの上位オブジェクトであり、親を持ちません。sampleModelTranslateは新しいRasterのsampleModelTranslateX値およびsampleModelTranslateY値を指定します。 このコンストラクタは、通常、他のコンストラクタまたはcreateメソッドによって呼び出されます。直接には使用しないようにしてください。- パラメータ:
- sampleModel- レイアウトを指定するSampleModel
- dataBuffer- イメージ・データを格納するDataBuffer
- aRegion- イメージ領域を指定するRectangle
- sampleModelTranslate- SampleModelからRaster座標への変換を指定するPoint
- parent- このラスターの親(存在する場合)
- 例外:
- NullPointerException-- sampleModel、- dataBuffer、- aRegion、- sampleModelTranslateのいずれかがnullの場合
- RasterFormatException-- aRegionの幅または高さがゼロ以下の場合、あるいは- aRegion.x+aRegion.widthと- aRegion.y+aRegion.heightのいずれかの計算で整数型オーバーフローが発生した場合
 
 
- 
 - 
メソッドの詳細- 
createInterleavedRasterpublic static WritableRaster createInterleavedRaster(int dataType, int w, int h, int bands, Point location) 指定されたデータ型、幅、高さ、およびバンド数を持つ、PixelInterleavedSampleModelに基づいたRasterを生成します。Rasterの左上隅はlocation引数によって指定されます。 locationがnullの場合は、(0, 0)が使用されます。 dataTypeパラメータには、DataBufferクラス定義で列挙される値の1つを指定します。 インタリーブ化された DataBuffer.TYPE_INTRasterはサポートされていません。DataBuffer.TYPE_INT型の1バンドのRasterを生成するには、Raster.createPackedRaster()を使用します。現在サポートされているdataTypeは、TYPE_BYTEとTYPE_USHORTだけです。 - パラメータ:
- dataType- サンプル格納用のデータ形式
- w- イメージ・データの幅(ピクセル単位)
- h- イメージ・データの高さ(ピクセル単位)
- bands- バンド数
- location-- Rasterの左上隅のX座標
- 戻り値:
- 指定されたデータ型、幅、高さ、バンド数を持つWritableRasterオブジェクト
- 例外:
- RasterFormatException-- wまたは- hがゼロ以下の場合、あるいは- location.x+wと- location.y+hのいずれかの計算で整数型オーバーフローが発生した場合
 
 - 
createInterleavedRasterpublic static WritableRaster createInterleavedRaster(int dataType, int w, int h, int scanlineStride, int pixelStride, int[] bandOffsets, Point location) 指定されたデータ型、幅、高さ、走査線ストライド、ピクセル・ストライド、およびバンド・オフセットを持つ、PixelInterleavedSampleModelに基づいたRasterを生成します。 バンド数は、bandOffsets.lengthから推定されます。Rasterの左上隅はlocation引数によって指定されます。 locationがnullの場合は、(0, 0)が使用されます。 dataTypeパラメータには、DataBufferクラス定義で列挙される値の1つを指定します。 インタリーブ化された DataBuffer.TYPE_INTRasterはサポートされていません。DataBuffer.TYPE_INT型の1バンドのRasterを生成するには、Raster.createPackedRaster()を使用します。現在サポートされているdataTypeは、TYPE_BYTEとTYPE_USHORTだけです。 - パラメータ:
- dataType- サンプル格納用のデータ形式
- w- イメージ・データの幅(ピクセル単位)
- h- イメージ・データの高さ(ピクセル単位)
- scanlineStride- イメージ・データの走査線ストライド
- pixelStride- イメージ・データのピクセル・ストライド
- bandOffsets- すべてのバンドのオフセット
- location-- Rasterの左上隅のX座標
- 戻り値:
- 指定されたデータ型、幅、高さ、走査線ストライド、ピクセル・ストライド、およびバンド・オフセットを持つWritableRasterオブジェクト
- 例外:
- RasterFormatException-- wまたは- hがゼロ以下の場合、あるいは- location.x+wと- location.y+hのいずれかの計算で整数型オーバーフローが発生した場合
- IllegalArgumentException-- dataTypeがサポートされているデータ型- DataBuffer.TYPE_BYTEまたは- DataBuffer.TYPE_USHORTのどちらでもない場合。
 
 - 
createBandedRasterpublic static WritableRaster createBandedRaster(int dataType, int w, int h, int bands, Point location) 指定されたデータ型、幅、高さ、バンド数を持つ、BandedSampleModelに基づいたRasterを生成します。Rasterの左上隅はlocation引数によって指定されます。 locationがnullの場合は、(0, 0)が使用されます。 dataTypeパラメータには、DataBufferクラス定義で列挙される値の1つを指定します。 現在サポートされているdataTypeは、TYPE_BYTE、TYPE_USHORT、およびTYPE_INTだけです。 - パラメータ:
- dataType- サンプル格納用のデータ形式
- w- イメージ・データの幅(ピクセル単位)
- h- イメージ・データの高さ(ピクセル単位)
- bands- バンド数
- location-- Rasterの左上隅のX座標
- 戻り値:
- 指定されたデータ型、幅、高さ、バンド数を持つWritableRasterオブジェクト
- 例外:
- RasterFormatException-- wまたは- hがゼロ以下の場合、あるいは- location.x+wと- location.y+hのいずれかの計算で整数型オーバーフローが発生した場合
- ArrayIndexOutOfBoundsException-- bandsが1より小さい場合
 
 - 
createBandedRasterpublic static WritableRaster createBandedRaster(int dataType, int w, int h, int scanlineStride, int[] bankIndices, int[] bandOffsets, Point location) 指定されたデータ型、幅、高さ、走査線ストライド、バンク・インデックス、バンド・オフセットを持つ、BandedSampleModelに基づいたRasterを生成します。 バンド数はbankIndices.lengthとbandOffsets.lengthから推定されます。これら2つの長さは同じである必要があります。Rasterの左上隅はlocation引数によって指定されます。 dataTypeパラメータには、DataBufferクラス定義で列挙される値の1つを指定します。 現在サポートされているdataTypeは、TYPE_BYTE、TYPE_USHORT、およびTYPE_INTだけです。 - パラメータ:
- dataType- サンプル格納用のデータ形式
- w- イメージ・データの幅(ピクセル単位)
- h- イメージ・データの高さ(ピクセル単位)
- scanlineStride- イメージ・データの走査線ストライド
- bankIndices- 各バンドのバンク・インデックス
- bandOffsets- すべてのバンドのオフセット
- location-- Rasterの左上隅のX座標
- 戻り値:
- 指定されたデータ型、幅、高さ、走査線ストライド、バンク・インデックス、およびバンド・オフセットを持つWritableRasterオブジェクト
- 例外:
- RasterFormatException-- wまたは- hがゼロ以下の場合、あるいは- location.x+wと- location.y+hのいずれかの計算で整数型オーバーフローが発生した場合
- IllegalArgumentException-- dataTypeがサポートされているデータ型- DataBuffer.TYPE_BYTE、- DataBuffer.TYPE_USHORT、- DataBuffer.TYPE_INTのいずれでもない場合
- ArrayIndexOutOfBoundsException-- bankIndicesまたは- bandOffsetsが- nullの場合
 
 - 
createPackedRasterpublic static WritableRaster createPackedRaster(int dataType, int w, int h, int[] bandMasks, Point location) 指定されたデータ型、幅、高さ、およびバンド・マスクを持つ、SinglePixelPackedSampleModelに基づいたRasterを生成します。 バンド数はbandMasks.lengthから推定されます。Rasterの左上隅はlocation引数によって指定されます。 locationがnullの場合は、(0, 0)が使用されます。 dataTypeパラメータには、DataBufferクラス定義で列挙される値の1つを指定します。 現在サポートされているdataTypeは、TYPE_BYTE、TYPE_USHORT、およびTYPE_INTだけです。 - パラメータ:
- dataType- サンプル格納用のデータ形式
- w- イメージ・データの幅(ピクセル単位)
- h- イメージ・データの高さ(ピクセル単位)
- bandMasks- 各バンドのエントリを格納する配列
- location-- Rasterの左上隅のX座標
- 戻り値:
- 指定されたデータ型、幅、高さ、およびバンド・マスクを持つWritableRasterオブジェクト
- 例外:
- RasterFormatException-- wまたは- hがゼロ以下の場合、あるいは- location.x+wと- location.y+hのいずれかの計算で整数型オーバーフローが発生した場合
- IllegalArgumentException-- dataTypeがサポートされているデータ型- DataBuffer.TYPE_BYTE、- DataBuffer.TYPE_USHORT、- DataBuffer.TYPE_INTのいずれでもない場合
 
 - 
createPackedRasterpublic static WritableRaster createPackedRaster(int dataType, int w, int h, int bands, int bitsPerBand, Point location) 指定されたデータ型、幅、高さ、バンド数、および1バンドあたりのビット数を持つ、パックされたSampleModelに基づいたRasterを生成します。 バンド数が1の場合、SampleModelはMultiPixelPackedSampleModelになります。バンド数が複数の場合、SampleModelは各バンドがbitsPerBandビットを持つSinglePixelPackedSampleModelになります。 どちらの場合も、対応するSampleModelが要求するdataTypeとbitsPerBandに関する要件を満たさなければいけません。 Rasterの左上隅はlocation引数によって指定されます。 locationがnullの場合は、(0, 0)が使用されます。 dataTypeパラメータには、DataBufferクラス定義で列挙される値の1つを指定します。 現在サポートされているdataTypeは、TYPE_BYTE、TYPE_USHORT、およびTYPE_INTだけです。 - パラメータ:
- dataType- サンプル格納用のデータ形式
- w- イメージ・データの幅(ピクセル単位)
- h- イメージ・データの高さ(ピクセル単位)
- bands- バンド数
- bitsPerBand- バンドごとのビット数
- location-- Rasterの左上隅のX座標
- 戻り値:
- 指定されたデータ型、幅、高さ、バンド数、およびバンドごとのビット数を持つWritableRasterオブジェクト
- 例外:
- RasterFormatException-- wまたは- hがゼロ以下の場合、あるいは- location.x+wと- location.y+hのいずれかの計算で整数型オーバーフローが発生した場合
- IllegalArgumentException-- bitsPerBandと- bandsの積が、- dataTypeが保持するビット数より大きい場合
- IllegalArgumentException-- bitsPerBandまたは- bandsが0以下である場合
- IllegalArgumentException-- dataTypeがサポートされているデータ型- DataBuffer.TYPE_BYTE、- DataBuffer.TYPE_USHORT、- DataBuffer.TYPE_INTのいずれでもない場合
 
 - 
createInterleavedRasterpublic static WritableRaster createInterleavedRaster(DataBuffer dataBuffer, int w, int h, int scanlineStride, int pixelStride, int[] bandOffsets, Point location) 指定されたDataBuffer、幅、高さ、走査線ストライド、ピクセル・ストライド、およびバンド・オフセットを持つ、PixelInterleavedSampleModelに基づいたRasterを生成します。 バンド数は、bandOffsets.lengthから推定されます。 Rasterの左上隅はlocation引数によって指定されます。 locationがnullの場合は、(0, 0)が使用されます。インタリーブ化された DataBuffer.TYPE_INTRasterはサポートされていません。DataBuffer.TYPE_INT型の1バンドのRasterを生成するには、Raster.createPackedRaster()を使用します。- パラメータ:
- dataBuffer- イメージ・データを格納する- DataBuffer
- w- イメージ・データの幅(ピクセル単位)
- h- イメージ・データの高さ(ピクセル単位)
- scanlineStride- イメージ・データの走査線ストライド
- pixelStride- イメージ・データのピクセル・ストライド
- bandOffsets- すべてのバンドのオフセット
- location-- Rasterの左上隅のX座標
- 戻り値:
- 指定されたDataBuffer、幅、高さ、走査線ストライド、ピクセル・ストライド、およびバンド・オフセットを持つWritableRasterオブジェクト。
- 例外:
- RasterFormatException-- wまたは- hがゼロ以下の場合、あるいは- location.x+wと- location.y+hのいずれかの計算で整数型オーバーフローが発生した場合
- IllegalArgumentException-- dataTypeがサポートされているデータ型- DataBuffer.TYPE_BYTE、- DataBuffer.TYPE_USHORTのいずれでもない場合
- RasterFormatException-- dataBufferが複数のバンクを持つ場合。
- NullPointerException-- dataBufferがnullである場合
 
 - 
createBandedRasterpublic static WritableRaster createBandedRaster(DataBuffer dataBuffer, int w, int h, int scanlineStride, int[] bankIndices, int[] bandOffsets, Point location) 指定されたDataBuffer、幅、高さ、走査線ストライド、バンク・インデックス、およびバンド・オフセットを持つ、BandedSampleModelに基づいたRasterを生成します。 バンド数はbankIndices.lengthとbandOffsets.lengthから推定されます。これら2つの長さは同じである必要があります。 Rasterの左上隅はlocation引数によって指定されます。 locationがnullの場合は、(0, 0)が使用されます。- パラメータ:
- dataBuffer- イメージ・データを格納する- DataBuffer
- w- イメージ・データの幅(ピクセル単位)
- h- イメージ・データの高さ(ピクセル単位)
- scanlineStride- イメージ・データの走査線ストライド
- bankIndices- 各バンドのバンク・インデックス
- bandOffsets- すべてのバンドのオフセット
- location-- Rasterの左上隅のX座標
- 戻り値:
- 指定されたDataBuffer、幅、高さ、走査線ストライド、バンク・インデックス、およびバンド・オフセットを持つWritableRasterオブジェクト。
- 例外:
- RasterFormatException-- wまたは- hがゼロ以下の場合、あるいは- location.x+wと- location.y+hのいずれかの計算で整数型オーバーフローが発生した場合
- IllegalArgumentException-- dataTypeがサポートされているデータ型- DataBuffer.TYPE_BYTE、- DataBuffer.TYPE_USHORT、- DataBuffer.TYPE_INTのいずれでもない場合
- NullPointerException-- dataBufferがnullである場合
 
 - 
createPackedRasterpublic static WritableRaster createPackedRaster(DataBuffer dataBuffer, int w, int h, int scanlineStride, int[] bandMasks, Point location) 指定されたDataBuffer、幅、高さ、走査線ストライド、およびバンド・マスクを持つ、SinglePixelPackedSampleModelに基づいたRasterを生成します。 バンド数はbandMasks.lengthから推定されます。 Rasterの左上隅はlocation引数によって指定されます。 locationがnullの場合は、(0, 0)が使用されます。- パラメータ:
- dataBuffer- イメージ・データを格納する- DataBuffer
- w- イメージ・データの幅(ピクセル単位)
- h- イメージ・データの高さ(ピクセル単位)
- scanlineStride- イメージ・データの走査線ストライド
- bandMasks- 各バンドのエントリを格納する配列
- location-- Rasterの左上隅のX座標
- 戻り値:
- 指定されたDataBuffer、幅、高さ、走査線ストライド、およびバンド・マスクを持つWritableRasterオブジェクト。
- 例外:
- RasterFormatException-- wまたは- hがゼロ以下の場合、あるいは- location.x+wと- location.y+hのいずれかの計算で整数型オーバーフローが発生した場合
- IllegalArgumentException-- dataTypeがサポートされているデータ型- DataBuffer.TYPE_BYTE、- DataBuffer.TYPE_USHORT、- DataBuffer.TYPE_INTのいずれでもない場合
- RasterFormatException-- dataBufferが複数のバンクを持つ場合。
- NullPointerException-- dataBufferがnullである場合
 
 - 
createPackedRasterpublic static WritableRaster createPackedRaster(DataBuffer dataBuffer, int w, int h, int bitsPerPixel, Point location) 指定されたDataBuffer、幅、高さ、および1ピクセルあたりのビット数を持つ、MultiPixelPackedSampleModelに基づいたRasterを生成します。 Rasterの左上隅はlocation引数によって指定されます。 locationがnullの場合は、(0, 0)が使用されます。- パラメータ:
- dataBuffer- イメージ・データを格納する- DataBuffer
- w- イメージ・データの幅(ピクセル単位)
- h- イメージ・データの高さ(ピクセル単位)
- bitsPerPixel- 各ピクセルのビット数
- location-- Rasterの左上隅のX座標
- 戻り値:
- 指定されたDataBuffer、幅、高さ、およびピクセルあたりのビット数を持つWritableRasterオブジェクト。
- 例外:
- RasterFormatException-- wまたは- hがゼロ以下の場合、あるいは- location.x+wと- location.y+hのいずれかの計算で整数型オーバーフローが発生した場合
- IllegalArgumentException-- dataTypeがサポートされているデータ型- DataBuffer.TYPE_BYTE、- DataBuffer.TYPE_USHORT、- DataBuffer.TYPE_INTのいずれでもない場合
- RasterFormatException-- dataBufferが複数のバンクを持つ場合。
- NullPointerException-- dataBufferがnullである場合
 
 - 
createRasterpublic static Raster createRaster(SampleModel sm, DataBuffer db, Point location) 指定されたSampleModelとDataBufferを持つRasterを生成します。 Rasterの左上隅はlocation引数によって指定されます。 locationがnullの場合は、(0, 0)が使用されます。- パラメータ:
- sm- 指定された- SampleModel
- db- 指定された- DataBuffer
- location-- Rasterの左上隅のX座標
- 戻り値:
- 指定されたSampleModel、DataBuffer、および位置を持つRaster。
- 例外:
- RasterFormatException-- location.x+sm.getWidth()または- location.y+sm.getHeight()のいずれかの計算で整数型オーバーフローが発生した場合
- RasterFormatException-- dbが複数のバンクを持ち、- smがPixelInterleavedSampleModel、SinglePixelPackedSampleModel、またはMultiPixelPackedSampleModelの場合。
- NullPointerException- SampleModelまたはDataBufferがnullの場合
 
 - 
createWritableRasterpublic static WritableRaster createWritableRaster(SampleModel sm, Point location) 指定されたSampleModelを持つWritableRasterを生成します。 Rasterの左上隅はlocation引数によって指定されます。 locationがnullの場合は、(0, 0)が使用されます。- パラメータ:
- sm- 指定された- SampleModel
- location-- WritableRasterの左上隅のX座標
- 戻り値:
- 指定されたSampleModel、および位置を持つWritableRaster。
- 例外:
- RasterFormatException-- location.x+sm.getWidth()または- location.y+sm.getHeight()のいずれかの計算で整数型オーバーフローが発生した場合
 
 - 
createWritableRasterpublic static WritableRaster createWritableRaster(SampleModel sm, DataBuffer db, Point location) 指定されたSampleModelとDataBufferを持つWritableRasterを生成します。 Rasterの左上隅はlocation引数によって指定されます。 locationがnullの場合は、(0, 0)が使用されます。- パラメータ:
- sm- 指定された- SampleModel
- db- 指定された- DataBuffer
- location-- WritableRasterの左上隅のX座標
- 戻り値:
- 指定されたSampleModel、DataBuffer、および位置を持つWritableRaster。
- 例外:
- RasterFormatException-- location.x+sm.getWidth()または- location.y+sm.getHeight()のいずれかの計算で整数型オーバーフローが発生した場合
- RasterFormatException-- dbが複数のバンクを持ち、- smがPixelInterleavedSampleModel、SinglePixelPackedSampleModel、またはMultiPixelPackedSampleModelの場合。
- NullPointerException- SampleModelまたはDataBufferがnullの場合
 
 - 
getParentpublic Raster getParent() このRasterの親Rasterがあればそれを返します。親がない場合は、nullを返します。- 戻り値:
- 親Rasterまたはnull。
 
 - 
getSampleModelTranslateXpublic final int getSampleModelTranslateX() SampleModelの座標体系からRasterの座標体系へのX変換を返します。 ピクセルのX座標をRasterの座標体系からSampleModelの座標体系に変換するには、この値を減算する必要があります。- 戻り値:
- RasterのSampleModelの座標空間からRasterの座標空間へのX変換です。
 
 - 
getSampleModelTranslateYpublic final int getSampleModelTranslateY() SampleModelの座標体系からRasterの座標体系へのY変換を返します。 ピクセルのY座標をRasterの座標体系からSampleModelの座標体系に変換するには、この値を減算する必要があります。- 戻り値:
- RasterのSampleModelの座標空間からRasterの座標空間へのY変換です。
 
 - 
createCompatibleWritableRasterpublic WritableRaster createCompatibleWritableRaster() このRasterと同じSampleModelと初期化された新しいDataBufferを持ち、このRasterと同じサイズで互換性があるWritableRasterを生成します。- 戻り値:
- 同じサンプル・モデルと新しいデータ・バッファを持ち、互換性があるWritableRaster。
 
 - 
createCompatibleWritableRasterpublic WritableRaster createCompatibleWritableRaster(int w, int h) 指定されたサイズ、新しいSampleModel、および初期化された新しいDataBufferを持ち、互換性があるWritableRasterを生成します。- パラメータ:
- w- 新しい- WritableRasterの指定された幅
- h- 新しい- WritableRasterの指定された幅
- 戻り値:
- 指定されたサイズ、新しいサンプル・モデル、およびデータ・バッファを持ち、互換性があるWritableRaster。
- 例外:
- RasterFormatException- 幅または高さが0以下である場合。
 
 - 
createCompatibleWritableRasterpublic WritableRaster createCompatibleWritableRaster(Rectangle rect) rectによって指定される位置(minX, minY)とサイズ(width, height)、新しいSampleModel、および初期化された新しいDataBufferを持ち、互換性があるWritableRasterを生成します。- パラメータ:
- rect-- WritableRasterのサイズと位置を示す- Rectangle
- 戻り値:
- 指定されたサイズ、位置、新しいサンプル・モデル、およびデータ・バッファを持ち、互換性があるWritableRaster。
- 例外:
- RasterFormatException-- rectの幅または高さがゼロ以下の場合、あるいは- rect.x+rect.widthと- rect.y+rect.heightのいずれかの計算で整数型オーバーフローが発生した場合
- NullPointerException-- rectがnullである場合
 
 - 
createCompatibleWritableRasterpublic WritableRaster createCompatibleWritableRaster(int x, int y, int w, int h) 指定された位置(minX, minY)とサイズ(width, height)、新しいSampleModel、および初期化された新しいDataBufferを持ち、互換性があるWritableRasterを生成します。- パラメータ:
- x-- WritableRasterの左上隅のX座標。
- y-- WritableRasterの左上隅のY座標。
- w- 新しい- WritableRasterの指定された幅
- h- 新しい- WritableRasterの指定された幅
- 戻り値:
- 指定されたサイズ、位置、新しいサンプル・モデル、およびデータ・バッファを持ち、互換性があるWritableRaster。
- 例外:
- RasterFormatException-- wまたは- hがゼロ以下の場合、あるいは- x+wと- y+hのいずれかの計算で整数型オーバーフローが発生した場合
 
 - 
createTranslatedChildpublic Raster createTranslatedChild(int childMinX, int childMinY) このRasterと同じサイズ、SampleModel、およびDataBufferを持ち、位置が異なるRasterを生成します。 新しいRasterは、getParent()メソッドによりアクセス可能な、現在のRasterへの参照を持ちます。- パラメータ:
- childMinX- 新しい- Rasterの左上隅のX座標
- childMinY- 新しい- Rasterの左上隅のY座標
- 戻り値:
- このRasterと同じサイズ、SampleModel、およびデータ・バッファを持ち、指定された位置を持つ新しいRaster。
- 例外:
- RasterFormatException-- childMinX+this.getWidth()または- childMinY+this.getHeight()のいずれかの計算で整数型オーバーフローが発生した場合
 
 - 
createChildpublic Raster createChild(int parentX, int parentY, int width, int height, int childMinX, int childMinY, int[] bandList) このRasterのDataBufferのすべてまたは一部を共有する新しいRasterを返します。 新しいRasterは、getParent()メソッドによりアクセス可能な、現在のRasterへの参照を持ちます。parentX、parentY、width、heightの各パラメータによってこのRasterの座標空間に形成されるRectangleが、共有されるピクセル領域を示します。 このRectangleが現在のRasterの境界内にない場合は、エラーがスローされます。 新しいRasterはさらに、同じ平面上で現在のRasterが使用する座標体系とは異なる座標体系に変換できます。 childMinXパラメータとchildMinYパラメータにより、返されたRasterの左上隅のピクセルの新しい座標(x, y)が指定されます。新しいRaster内の座標(childMinX, childMinY)は、現在のRaster内の座標(parentX, parentY)と同じピクセルにマップされます。 bandListパラメータを使用して、新しいRasterが現在のRasterのバンドのサブセットだけを、場合によっては順序を変更して、格納するように定義できます。 bandListがnullの場合は、現在のRasterのすべてのバンドが現在と同じ順序で格納されます。 現在のRasterの部分領域を保持するが、座標体系とバンドは現在のRasterと共有する新しいRasterを生成するには、childMinXをparentXと同じ値に、childMinYをparentYと同じ値に、bandListをnullにそれぞれ指定して、このメソッドを呼び出します。 - パラメータ:
- parentX- このRasterの座標で左上隅のX座標
- parentY- このRasterの座標で左上隅のY座標
- width- (parentX, parentY)から始まる領域の幅
- height- (parentX, parentY)から始まる領域の高さ。
- childMinX- 返されるRasterの左上隅のX座標
- childMinY- 返されるRasterの左上隅のY座標
- bandList- バンド・インデックスの配列。すべてのバンドを使用する場合はnull
- 戻り値:
- 新しいRaster。
- 例外:
- RasterFormatException- 指定された部分領域がラスター境界の外側にある場合。
- RasterFormatException-- widthまたは- heightが0以下の場合、または- parentX+width、- parentY+height、- childMinX+width、- childMinY+heightのいずれかの計算で整数型オーバーフローが発生した場合
 
 - 
getBoundspublic Rectangle getBounds() このRasterの境界のRectangleを返します。 この関数は、getMinX/MinY/Width/Heightと同じ情報を返します。- 戻り値:
- このRasterのバウンディング・ボックス。
 
 - 
getMinXpublic final int getMinX() Rasterの有効な最小のX座標を返します。- 戻り値:
- このRasterの最小x座標。
 
 - 
getMinYpublic final int getMinY() Rasterの有効な最小のY座標を返します。- 戻り値:
- このRasterの最小y座標。
 
 - 
getWidthpublic final int getWidth() Rasterの幅をピクセル単位で返します。- 戻り値:
- このRasterの幅。
 
 - 
getHeightpublic final int getHeight() Rasterの高さをピクセル単位で返します。- 戻り値:
- このRasterの高さ。
 
 - 
getNumBandspublic final int getNumBands() このRaster内のバンド数(1ピクセルあたりのサンプル数)を返します。- 戻り値:
- このRasterのバンド数。
 
 - 
getNumDataElementspublic final int getNumDataElements() getDataElementsメソッドおよびsetDataElementsメソッドを使って1ピクセル転送するのに必要なデータ要素の数を返します。 これらのメソッドでは、ピクセルがパックされた形式で転送される場合と展開された形式で転送される場合があり、これは、基本となるSampleModelの実装によって決まります。 これらのメソッドを使うと、ピクセルはgetTransferType()によって指定されるプリミティブ型のgetNumDataElements()要素の配列として転送されます。 TransferTypeは、DataBufferのストレージ・データ型と同じでも、異なっていてもかまいません。- 戻り値:
- データ要素数。
 
 - 
getTransferTypepublic final int getTransferType() getDataElementsメソッドおよびsetDataElementsメソッドを使ってピクセルを転送するのに使用されるTransferTypeを返します。 これらのメソッドでは、ピクセルがパックされた形式で転送される場合と展開された形式で転送される場合があり、これは、基本となるSampleModelの実装によって決まります。 これらのメソッドを使うと、ピクセルはgetTransferType()によって指定されるプリミティブ型のgetNumDataElements()要素の配列として転送されます。 TransferTypeは、DataBufferのストレージ・データ型と同じでも、異なっていてもかまいません。 TransferTypeはDataBufferで定義されている型のどれかになります。- 戻り値:
- この転送型。
 
 - 
getDataBufferpublic DataBuffer getDataBuffer() このRasterに関連したDataBufferを返します。- 戻り値:
- このRasterのDataBuffer。
 
 - 
getSampleModelpublic SampleModel getSampleModel() イメージ・データのレイアウトを記述するSampleModelを返します。- 戻り値:
- このRasterのSampleModel。
 
 - 
getDataElementspublic Object getDataElements(int x, int y, Object outData) transferType型のプリミティブ配列内の1つのピクセルのデータを返します。 Java 2D(tm) APIによってサポートされているイメージ・データの場合は、DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、DataBuffer.TYPE_INT、DataBuffer.TYPE_SHORT、DataBuffer.TYPE_FLOAT、またはDataBuffer.TYPE_DOUBLEのいずれかになります。 データはパックされた形式で返されることもあり、その場合、データ転送の効率が上がります。 座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。 ただし、明示的な境界チェックは必ずしも実行されません。 入力オブジェクトがnullでなく、TransferTypeの配列以外のものを参照する場合、ClassCastExceptionがスローされます。- パラメータ:
- x- ピクセル位置のX座標
- y- ピクセル位置のY座標
- outData- getTransferType()によって定義された型とgetNumDataElements()によって定義された長さを持つ配列へのオブジェクト参照。 nullの場合は、適切な型とサイズの配列が割り当てられる
- 戻り値:
- 要求されたピクセル・データを持ち、getTransferType()によって型が定義された配列へのオブジェクト参照
- 例外:
- ArrayIndexOutOfBoundsException- 座標が境界内に存在しない場合、またはoutDataが小さすぎて出力を保持できない場合。
- 関連項目:
- SampleModel.getDataElements(int, int, Object, DataBuffer)
 
 - 
getDataElementspublic Object getDataElements(int x, int y, int w, int h, Object outData) TransferType型のプリミティブ配列の、指定されたピクセル矩形のピクセル・データを返します。 Java 2D APIによってサポートされているイメージ・データの場合は、DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、DataBuffer.TYPE_INT、DataBuffer.TYPE_SHORT、DataBuffer.TYPE_FLOAT、またはDataBuffer.TYPE_DOUBLEのいずれかになります。 データはパックされた形式で返されることもあり、その場合、データ転送の効率が上がります。 座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。 ただし、明示的な境界チェックは必ずしも実行されません。 入力オブジェクトがnullでなく、TransferTypeの配列以外のものを参照する場合、ClassCastExceptionがスローされます。- パラメータ:
- x- 左上のピクセル位置のX座標
- y- 左上のピクセル位置のY座標
- w- ピクセル矩形の幅
- h- ピクセル矩形の高さ
- outData- getTransferType()によって定義された型とw*h*getNumDataElements()によって定義された長さを持つ配列へのオブジェクト参照。 nullの場合は、適切な型とサイズの配列が割り当てられる
- 戻り値:
- 要求されたピクセル・データを持ち、getTransferType()によって型が定義された配列へのオブジェクト参照
- 例外:
- ArrayIndexOutOfBoundsException- 座標が境界内に存在しない場合、またはoutDataが小さすぎて出力を保持できない場合。
- 関連項目:
- SampleModel.getDataElements(int, int, int, int, Object, DataBuffer)
 
 - 
getPixelpublic int[] getPixel(int x, int y, int[] iArray)指定されたピクセルのサンプルをint配列として返します。 座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。 ただし、明示的な境界チェックは必ずしも実行されません。- パラメータ:
- x- ピクセル位置のX座標
- y- ピクセル位置のY座標
- iArray- 必要に応じて事前に割り当てられたint配列
- 戻り値:
- 指定されたピクセルのサンプル
- 例外:
- ArrayIndexOutOfBoundsException- 座標が境界内に存在しない場合、またはiArrayが小さすぎて出力を保持できない場合。
 
 - 
getPixelpublic float[] getPixel(int x, int y, float[] fArray)指定されたピクセルのサンプルをfloat配列として返します。 座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。 ただし、明示的な境界チェックは必ずしも実行されません。- パラメータ:
- x- ピクセル位置のX座標
- y- ピクセル位置のY座標
- fArray- 必要に応じて事前に割り当てられたfloat配列
- 戻り値:
- 指定されたピクセルのサンプル
- 例外:
- ArrayIndexOutOfBoundsException- 座標が境界内に存在しない場合、またはfArrayが小さすぎて出力を保持できない場合。
 
 - 
getPixelpublic double[] getPixel(int x, int y, double[] dArray)指定されたピクセルのサンプルをdouble配列として返します。 座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。 ただし、明示的な境界チェックは必ずしも実行されません。- パラメータ:
- x- ピクセル位置のX座標
- y- ピクセル位置のY座標
- dArray- 必要に応じて事前に割り当てられたdouble配列
- 戻り値:
- 指定されたピクセルのサンプル
- 例外:
- ArrayIndexOutOfBoundsException- 座標が境界内に存在しない場合、またはdArrayが小さすぎて出力を保持できない場合。
 
 - 
getPixelspublic int[] getPixels(int x, int y, int w, int h, int[] iArray)矩形のピクセルのサンプルすべてを、配列要素ごとに1つのサンプルが格納されているint配列として返します。 座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。 ただし、明示的な境界チェックは必ずしも実行されません。- パラメータ:
- x- 左上のピクセル位置のX座標
- y- 左上のピクセル位置のY座標
- w- ピクセル矩形の幅
- h- ピクセル矩形の高さ
- iArray- オプションで事前に割り当てられたint配列
- 戻り値:
- 指定されたピクセル矩形のサンプル
- 例外:
- ArrayIndexOutOfBoundsException- 座標が境界内に存在しない場合、またはiArrayが小さすぎて出力を保持できない場合。
 
 - 
getPixelspublic float[] getPixels(int x, int y, int w, int h, float[] fArray)矩形のピクセルのサンプルすべてを、配列要素ごとに1つのサンプルが格納されているfloat配列として返します。 座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。 ただし、明示的な境界チェックは必ずしも実行されません。- パラメータ:
- x- ピクセル位置のX座標
- y- ピクセル位置のY座標
- w- ピクセル矩形の幅
- h- ピクセル矩形の高さ
- fArray- オプションで事前に割り当てられたfloat配列
- 戻り値:
- 指定されたピクセル矩形のサンプル
- 例外:
- ArrayIndexOutOfBoundsException- 座標が境界内に存在しない場合、またはfArrayが小さすぎて出力を保持できない場合。
 
 - 
getPixelspublic double[] getPixels(int x, int y, int w, int h, double[] dArray)矩形のピクセルのサンプルすべてを、配列要素ごとに1つのサンプルが格納されているdouble配列として返します。 座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。 ただし、明示的な境界チェックは必ずしも実行されません。- パラメータ:
- x- 左上のピクセル位置のX座標
- y- 左上のピクセル位置のY座標
- w- ピクセル矩形の幅
- h- ピクセル矩形の高さ
- dArray- オプションで事前に割り当てられたdouble配列
- 戻り値:
- 指定されたピクセル矩形のサンプル
- 例外:
- ArrayIndexOutOfBoundsException- 座標が境界内に存在しない場合、またはdArrayが小さすぎて出力を保持できない場合。
 
 - 
getSamplepublic int getSample(int x, int y, int b)(x, y)に位置するピクセルの指定されたバンド内のサンプルをintとして返します。 座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。 ただし、明示的な境界チェックは必ずしも実行されません。- パラメータ:
- x- ピクセル位置のX座標
- y- ピクセル位置のY座標
- b- 返されるバンド
- 戻り値:
- 指定された座標にあるピクセルの指定されたバンド内のサンプル
- 例外:
- ArrayIndexOutOfBoundsException- 座標またはバンド・インデックスが境界内にない場合。
 
 - 
getSampleFloatpublic float getSampleFloat(int x, int y, int b)(x, y)に位置するピクセルの指定されたバンド内のサンプルをfloatとして返します。 座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。 ただし、明示的な境界チェックは必ずしも実行されません。- パラメータ:
- x- ピクセル位置のX座標
- y- ピクセル位置のY座標
- b- 返されるバンド
- 戻り値:
- 指定された座標にあるピクセルの指定されたバンド内のサンプル
- 例外:
- ArrayIndexOutOfBoundsException- 座標またはバンド・インデックスが境界内にない場合。
 
 - 
getSampleDoublepublic double getSampleDouble(int x, int y, int b)(x, y)に位置するピクセルの指定されたバンド内のサンプルをdoubleとして返します。 座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。 ただし、明示的な境界チェックは必ずしも実行されません。- パラメータ:
- x- ピクセル位置のX座標
- y- ピクセル位置のY座標
- b- 返されるバンド
- 戻り値:
- 指定された座標にあるピクセルの指定されたバンド内のサンプル
- 例外:
- ArrayIndexOutOfBoundsException- 座標またはバンド・インデックスが境界内にない場合。
 
 - 
getSamplespublic int[] getSamples(int x, int y, int w, int h, int b, int[] iArray)int配列の指定されたピクセルの矩形の、指定されたバンドのサンプルを返します。配列要素ごとに1つのサンプルが返されます。 座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。 ただし、明示的な境界チェックは必ずしも実行されません。- パラメータ:
- x- 左上のピクセル位置のX座標
- y- 左上のピクセル位置のY座標
- w- ピクセル矩形の幅
- h- ピクセル矩形の高さ
- b- 返されるバンド
- iArray- オプションで事前に割り当てられたint配列
- 戻り値:
- 指定された矩形ピクセルの指定されたバンドのサンプル
- 例外:
- ArrayIndexOutOfBoundsException- 座標またはバンド・インデックスが境界内に存在しない場合、またはiArrayが小さすぎて出力を保持できない場合。
 
 - 
getSamplespublic float[] getSamples(int x, int y, int w, int h, int b, float[] fArray)float配列内の指定されたピクセル矩形の、指定されたバンドのサンプルを返します。配列要素ごとに1つのサンプルが返されます。 座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。 ただし、明示的な境界チェックは必ずしも実行されません。- パラメータ:
- x- 左上のピクセル位置のX座標
- y- 左上のピクセル位置のY座標
- w- ピクセル矩形の幅
- h- ピクセル矩形の高さ
- b- 返されるバンド
- fArray- オプションで事前に割り当てられたfloat配列
- 戻り値:
- 指定された矩形ピクセルの指定されたバンドのサンプル
- 例外:
- ArrayIndexOutOfBoundsException- 座標またはバンド・インデックスが境界内に存在しない場合、またはfArrayが小さすぎて出力を保持できない場合。
 
 - 
getSamplespublic double[] getSamples(int x, int y, int w, int h, int b, double[] dArray)double配列内の指定されたピクセル矩形の、指定されたバンドのサンプルを返します。配列要素ごとに1つのサンプルが返されます。 座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。 ただし、明示的な境界チェックは必ずしも実行されません。- パラメータ:
- x- 左上のピクセル位置のX座標
- y- 左上のピクセル位置のY座標
- w- ピクセル矩形の幅
- h- ピクセル矩形の高さ
- b- 返されるバンド
- dArray- オプションで事前に割り当てられたdouble配列
- 戻り値:
- 指定された矩形ピクセルの指定されたバンドのサンプル
- 例外:
- ArrayIndexOutOfBoundsException- 座標またはバンド・インデックスが境界内に存在しない場合、またはdArrayが小さすぎて出力を保持できない場合。
 
 
- 
 
-