java.lang.Object
- java.awt.image.SampleModel

直系の既知のサブクラス:

ComponentSampleModel, MultiPixelPackedSampleModel, SinglePixelPackedSampleModel
```
public abstract class SampleModel
extends Object
```
この抽象クラスは、イメージにあるピクセルのサンプルを抽出するインタフェースを定義します。イメージ・データはすべて、ピクセルのコレクションとして表現されます。各ピクセルは多数のサンプルで構成されます。サンプルはイメージの1バンドのデータです。バンドはイメージにある特定のタイプのすべてのサンプルで構成されます。たとえばピクセルが、赤色成分、緑色成分、青色成分を表す3つのサンプルを含んでいるとします。このピクセルを含むイメージには3つのバンドがあります。 1つのバンドはイメージのすべてのピクセルのすべての赤色サンプルで構成されます。 2つめのバンドはすべての緑色サンプルで構成され、残りのバンドはすべての青色サンプルで構成されます。ピクセルはさまざまな形式で格納できます。たとえば、特定のバンドのすべてのサンプルを連続して格納したり、単一のピクセルのすべてのサンプルを連続して格納したりできます。
SampleModelのサブクラスは、unsigned 8-bit byte、signed 16-bit shortなどの、表現可能なサンプルのデータ型を指定します。メモリー上でのサンプルの配置方法も指定可能です。 Java 2D(TM) APIでは、組込み型のイメージ処理演算子では、使用可能なすべてのサンプル・データ型の演算を行わず、16ビット以下の符号なし整数のサンプルの演算だけを実行します。演算子によっては、より多くのサンプル・データ型に対応しているものもあります。
ピクセルの集合は、DataBufferとSampleModelで構成されるRasterとして表されます。 SampleModelを使うと、DataBuffer内のサンプルにアクセスできます。また、DataBufferでサンプルおよびピクセルを直接操作するためにプログラマが使用できる低レベルの情報を提供します。
このクラスは、一般にはイメージ処理のためのフォール・バック・メソッドです。より効率的にコードを記述すれば、適切なサブクラスにSampleModelをキャストして、DataBufferのピクセルを直接操作するために必要な情報を抽出できます。

関連項目:

DataBuffer, Raster, ComponentSampleModel, PixelInterleavedSampleModel, BandedSampleModel, MultiPixelPackedSampleModel, SinglePixelPackedSampleModel

フィールドのサマリー

フィールド
修飾子と型	フィールド	説明
`protected int`	`dataType`	ピクセル・データを格納するDataBufferのデータ型です。
`protected int`	`height`	このSampleModelが記述するイメージ・データの領域の高さ(単位はピクセル)です。
`protected int`	`numBands`	このSampleModelが記述するイメージ・データのバンド数です。
`protected int`	`width`	このSampleModelが記述するイメージ・データの領域の幅(単位はピクセル)です。

コンストラクタのサマリー

コンストラクタ
コンストラクタ説明

SampleModel(int dataType, int w, int h, int numBands)
指定されたパラメータを使ってSampleModelを構築します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド抽象メソッド具象メソッド
修飾子と型	メソッド	説明
`abstract SampleModel`	`createCompatibleSampleModel(int w, int h)`	このSampleModelの形式でデータが記述されている、幅と高さが異なるSampleModelを生成します。
`abstract DataBuffer`	`createDataBuffer()`	このSampleModelに対応するDataBufferを生成します。
`abstract SampleModel`	`createSubsetSampleModel(int[] bands)`	このSampleModelのバンドのサブセットを使って新しいSampleModelを生成します。
`Object`	`getDataElements(int x, int y, int w, int h, Object obj, DataBuffer data)`	TransferType型のプリミティブ配列の、指定されたピクセル矩形のピクセル・データを返します。
`abstract Object`	`getDataElements(int x, int y, Object obj, DataBuffer data)`	transferType型のプリミティブ配列内の1つのピクセルのデータを返します。
`int`	`getDataType()`	ピクセル・データが格納されているDataBufferのデータ型を返します。
`int`	`getHeight()`	高さをピクセル数で返します。
`int`	`getNumBands()`	イメージ・データのバンドの総数を返します。
`abstract int`	`getNumDataElements()`	getDataElementsメソッドおよびsetDataElementsメソッドを使って1ピクセル転送するのに必要なデータ要素の数を返します。
`double[]`	`getPixel(int x, int y, double[] dArray, DataBuffer data)`	doubleの配列内の指定されたピクセルのサンプルを返します。
`float[]`	`getPixel(int x, int y, float[] fArray, DataBuffer data)`	floatの配列内の指定されたピクセルのサンプルを返します。
`int[]`	`getPixel(int x, int y, int[] iArray, DataBuffer data)`	int配列内の指定されたピクセルのサンプルを返します。配列要素ごとに1つのサンプルが返されます。
`double[]`	`getPixels(int x, int y, int w, int h, double[] dArray, DataBuffer data)`	double配列のピクセル矩形のすべてのサンプルを返します。配列要素ごとに1つのサンプルが返されます。
`float[]`	`getPixels(int x, int y, int w, int h, float[] fArray, DataBuffer data)`	float配列のピクセル矩形のすべてのサンプルを返します。配列要素ごとに1つのサンプルが返されます。
`int[]`	`getPixels(int x, int y, int w, int h, int[] iArray, DataBuffer data)`	int配列のピクセル矩形のすべてのサンプルを返します。配列要素ごとに1つのサンプルが返されます。
`abstract int`	`getSample(int x, int y, int b, DataBuffer data)`	(x, y)に位置するピクセルの指定されたバンド内のサンプルをintとして返します。
`double`	`getSampleDouble(int x, int y, int b, DataBuffer data)`	(x, y)に位置するピクセルの指定されたバンド内のサンプルをdoubleとして返します。
`float`	`getSampleFloat(int x, int y, int b, DataBuffer data)`	(x, y)に位置するピクセルの指定されたバンド内のサンプルをfloatとして返します。
`double[]`	`getSamples(int x, int y, int w, int h, int b, double[] dArray, DataBuffer data)`	double配列内の指定されたピクセル矩形の、指定されたバンドのサンプルを返します。配列要素ごとに1つのサンプルが返されます。
`float[]`	`getSamples(int x, int y, int w, int h, int b, float[] fArray, DataBuffer data)`	float配列内の指定されたピクセル矩形の、指定されたバンドのサンプルを返します。配列要素ごとに1つのサンプルが返されます。
`int[]`	`getSamples(int x, int y, int w, int h, int b, int[] iArray, DataBuffer data)`	int配列の指定されたピクセルの矩形の、指定されたバンドのサンプルを返します。配列要素ごとに1つのサンプルが返されます。
`abstract int[]`	`getSampleSize()`	すべてのバンドについて、サンプルのビットのサイズを返します。
`abstract int`	`getSampleSize(int band)`	指定されたバンドについて、サンプルのビットのサイズを返します。
`int`	`getTransferType()`	getDataElementsメソッドおよびsetDataElementsメソッドを使ってピクセルを転送するのに使用されるTransferTypeを返します。
`int`	`getWidth()`	幅をピクセル数で返します。
`void`	`setDataElements(int x, int y, int w, int h, Object obj, DataBuffer data)`	TransferType型のプリミティブ配列から、指定されたDataBuffer内のピクセル矩形のデータを設定します。
`abstract void`	`setDataElements(int x, int y, Object obj, DataBuffer data)`	指定されたDataBufferの1つのピクセルのデータを、TransferType型のプリミティブ配列から設定します。
`void`	`setPixel(int x, int y, double[] dArray, DataBuffer data)`	サンプルのdouble配列を入力として、DataBuffer内のピクセルを設定します。
`void`	`setPixel(int x, int y, float[] fArray, DataBuffer data)`	サンプルのfloat配列を入力として使ってDataBuffer内のピクセルを設定します。
`void`	`setPixel(int x, int y, int[] iArray, DataBuffer data)`	サンプルのint配列を入力として使ってDataBuffer内のピクセルを設定します。
`void`	`setPixels(int x, int y, int w, int h, double[] dArray, DataBuffer data)`	矩形のピクセルのサンプルすべてを、配列要素ごとに1つのサンプルが格納されているdouble配列から設定します。
`void`	`setPixels(int x, int y, int w, int h, float[] fArray, DataBuffer data)`	矩形のピクセルのサンプルすべてを、配列要素ごとに1つのサンプルが格納されているfloat配列から設定します。
`void`	`setPixels(int x, int y, int w, int h, int[] iArray, DataBuffer data)`	矩形のピクセルのサンプルすべてを、配列要素ごとに1つのサンプルが格納されているint配列から設定します。
`void`	`setSample(int x, int y, int b, double s, DataBuffer data)`	doubleを入力として使用し、DataBuffer内の(x, y)に位置するピクセルの、指定されたバンド内のサンプルを設定します。
`void`	`setSample(int x, int y, int b, float s, DataBuffer data)`	floatを入力として使用し、DataBuffer内の(x, y)に位置するピクセルの、指定されたバンド内のサンプルを設定します。
`abstract void`	`setSample(int x, int y, int b, int s, DataBuffer data)`	intを入力とし、DataBufferの(x,y)に位置するピクセルの、指定されたバンドのサンプルを設定します。
`void`	`setSamples(int x, int y, int w, int h, int b, double[] dArray, DataBuffer data)`	指定された矩形ピクセルの指定されたバンドのサンプルを、配列要素ごとに1つのサンプルが格納されているdouble配列から設定します。
`void`	`setSamples(int x, int y, int w, int h, int b, float[] fArray, DataBuffer data)`	指定された矩形ピクセルの指定されたバンドのサンプルを、配列要素ごとに1つのサンプルが格納されているfloat配列から設定します。
`void`	`setSamples(int x, int y, int w, int h, int b, int[] iArray, DataBuffer data)`	指定された矩形ピクセルの指定されたバンドのサンプルを、配列要素ごとに1つのサンプルが格納されているint配列から設定します。

クラス java.lang.Objectで宣言されたメソッド
clone、equals、finalize、getClass、hashCode、notify、notifyAll、toString、wait、wait、wait

- フィールドの詳細
  - width
```
protected int width
```
    このSampleModelが記述するイメージ・データの領域の幅(単位はピクセル)です。
  - height
```
protected int height
```
    このSampleModelが記述するイメージ・データの領域の高さ(単位はピクセル)です。
  - numBands
```
protected int numBands
```
    このSampleModelが記述するイメージ・データのバンド数です。
  - dataType
```
protected int dataType
```
    ピクセル・データを格納するDataBufferのデータ型です。
    
    関連項目:
    
    DataBuffer
- コンストラクタの詳細
  - SampleModel
```
public SampleModel(int dataType,
                   int w,
                   int h,
                   int numBands)
```
    指定されたパラメータを使ってSampleModelを構築します。
    
    パラメータ:
    
    dataType - ピクセル・データを格納するDataBufferのデータ型。
    
    w - イメージ・データの領域の幅(単位はピクセル)。
    
    h - イメージ・データの領域の高さ(単位はピクセル)。
    
    numBands - イメージ・データのバンド数。
    
    例外:
    
    IllegalArgumentException - wまたはhが0以下である場合
    
    IllegalArgumentException - wとhの積がInteger.MAX_VALUEより大きい場合
    
    IllegalArgumentException - dataTypeがサポートされているデータ型でない場合
- メソッドの詳細
  - getWidth
```
public final int getWidth()
```
    幅をピクセル数で返します。
    
    戻り値:
    
    このSampleModelが記述するイメージ・データの領域の幅(ピクセル単位)。
  - getHeight
```
public final int getHeight()
```
    高さをピクセル数で返します。
    
    戻り値:
    
    このSampleModelが記述するイメージ・データの領域の高さ(ピクセル単位)。
  - getNumBands
```
public final int getNumBands()
```
    イメージ・データのバンドの総数を返します。
    
    戻り値:
    
    このSampleModelが記述するイメージ・データのバンド数。
  - getNumDataElements
```
public abstract int getNumDataElements()
```
    getDataElementsメソッドおよびsetDataElementsメソッドを使って1ピクセル転送するのに必要なデータ要素の数を返します。これらのメソッドでは、ピクセルがパックされた形式で転送される場合と展開された形式で転送される場合があり、これは、SampleModelの実装によって決まります。これらのメソッドを使うと、ピクセルはgetTransferType()によって指定されるプリミティブ型のgetNumDataElements()要素の配列として転送されます。 TransferTypeは、ストレージDataTypeと同じでも、異なっていてもかまいません。
    
    戻り値:
    
    データ要素数。
    
    関連項目:
    
    getDataElements(int, int, Object, DataBuffer), getDataElements(int, int, int, int, Object, DataBuffer), setDataElements(int, int, Object, DataBuffer), setDataElements(int, int, int, int, Object, DataBuffer), getTransferType()
  - getDataType
```
public final int getDataType()
```
    ピクセル・データが格納されているDataBufferのデータ型を返します。
    
    戻り値:
    
    データ型。
  - getTransferType
```
public int getTransferType()
```
    getDataElementsメソッドおよびsetDataElementsメソッドを使ってピクセルを転送するのに使用されるTransferTypeを返します。これらのメソッドでは、ピクセルがパックされた形式で転送される場合と展開された形式で転送される場合があり、これは、SampleModelの実装によって決まります。これらのメソッドを使うと、ピクセルはgetTransferType()によって指定されるプリミティブ型のgetNumDataElements()要素の配列として転送されます。 TransferTypeは、ストレージDataTypeと同じでも、異なっていてもかまいません。 TransferTypeはDataBufferで定義されている型のどれかになります。
    
    戻り値:
    
    転送型
    
    関連項目:
    
    getDataElements(int, int, Object, DataBuffer)、getDataElements(int, int, int, int, Object, DataBuffer)、setDataElements(int, int, Object, DataBuffer)、setDataElements(int, int, int, int, Object, DataBuffer)、getNumDataElements()、DataBuffer
  - getPixel
```
public int[] getPixel(int x,
                      int y,
                      int[] iArray,
                      DataBuffer data)
```
    int配列内の指定されたピクセルのサンプルを返します。配列要素ごとに1つのサンプルが返されます。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - ピクセル位置のX座標
    
    y - ピクセル位置のY座標
    
    iArray - nullでない場合、この配列内のサンプルを返します
    
    data - イメージ・データを格納するDataBuffer
    
    戻り値:
    
    指定されたピクセルのサンプル
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、またはiArrayが小さすぎて出力を保持できない場合。
    
    関連項目:
    
    setPixel(int, int, int[], DataBuffer)
  - getDataElements
```
public abstract Object getDataElements(int x,
                                       int y,
                                       Object obj,
                                       DataBuffer data)
```
    transferType型のプリミティブ配列内の1つのピクセルのデータを返します。 Java 2D APIによってサポートされているイメージ・データの場合は、DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、DataBuffer.TYPE_INT、DataBuffer.TYPE_SHORT、DataBuffer.TYPE_FLOAT、またはDataBuffer.TYPE_DOUBLEのいずれかになります。データはパックされた形式で返されることもあり、その場合、データ転送の効率が上がります。通常は、Objectが自動的に作成され、正しい基本データ型になるように、objにはnullが渡されます。
    次のコードは、SampleModel sm1によってストレージ・レイアウトが記述されているDataBuffer db1から、SampleModel sm2によってストレージ・レイアウトが記述されているDataBuffer db2へ、1ピクセルのデータを転送する例です。通常、この転送はgetPixelとsetPixelを使うよりも効率的です。
    SampleModel sm1, sm2; DataBuffer db1, db2; sm2.setDataElements(x, y, sm1.getDataElements(x, y, null, db1), db2);
    SampleModelのバンド数が同じで、対応するバンドのサンプルあたりのビット数が同じで、TransferTypeが同じである場合、2つのDataBuffer/SampleModel間の転送には、getDataElements/setDataElementsを使用するのが適切です。
    objがnullでない場合は、TransferType型のプリミティブ配列になります。そうでない場合は、ClassCastExceptionがスローされます。座標が境界内にない場合、またはobjがnullでなく、ピクセル・データを格納するために十分なサイズでない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    パラメータ:
    
    x - ピクセル位置のX座標。
    
    y - ピクセル位置のY座標。
    
    obj - nullでない場合は、ピクセル・データが返されるプリミティブ配列。
    
    data - イメージ・データを格納するDataBuffer。
    
    戻り値:
    
    指定されたピクセルのデータ要素
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、またはobjが小さすぎて出力を保持できない場合。
    
    関連項目:
    
    getNumDataElements(), getTransferType(), DataBuffer, setDataElements(int, int, Object, DataBuffer)
  - getDataElements
```
public Object getDataElements(int x,
                              int y,
                              int w,
                              int h,
                              Object obj,
                              DataBuffer data)
```
    TransferType型のプリミティブ配列の、指定されたピクセル矩形のピクセル・データを返します。 Java 2D APIによってサポートされているイメージ・データの場合は、DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、DataBuffer.TYPE_INT、DataBuffer.TYPE_SHORT、DataBuffer.TYPE_FLOAT、またはDataBuffer.TYPE_DOUBLEのいずれかになります。データはパックされた形式で返されることもあり、その場合、データ転送の効率が上がります。通常は、Objectが自動的に作成され、正しい基本データ型になるように、objにはnullが渡されます。
    次のコードは、SampleModel sm1によってストレージ・レイアウトが記述されているDataBuffer db1から、SampleModel sm2によってストレージ・レイアウトが記述されているDataBuffer db2へ、ピクセルの矩形領域のデータを転送する例です。通常、この転送はgetPixels/setPixelsを使うよりも効率的です。
    SampleModel sm1, sm2; DataBuffer db1, db2; sm2.setDataElements(x, y, w, h, sm1.getDataElements(x, y, w, h, null, db1), db2);
    SampleModelのバンド数が同じで、対応するバンドのサンプルあたりのビット数が同じで、TransferTypeが同じである場合、2つのDataBuffer/SampleModel間の転送には、getDataElements/setDataElementsを使用するのが適切です。
    objがnullでない場合は、TransferType型のプリミティブ配列になります。そうでない場合は、ClassCastExceptionがスローされます。座標が境界内にない場合、またはobjがnullでなく、ピクセル・データを格納するために十分なサイズでない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    パラメータ:
    
    x - ピクセル矩形の最小のX座標。
    
    y - ピクセル矩形の最小のY座標。
    
    w - ピクセル矩形の幅。
    
    h - ピクセル矩形の高さ。
    
    obj - nullでない場合は、ピクセル・データが返されるプリミティブ配列。
    
    data - イメージ・データを格納するDataBuffer。
    
    戻り値:
    
    指定されたピクセル領域のデータ要素
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、またはobjが小さすぎて出力を保持できない場合。
    
    関連項目:
    
    getNumDataElements()、getTransferType()、setDataElements(int, int, int, int, Object, DataBuffer)、DataBuffer
  - setDataElements
```
public abstract void setDataElements(int x,
                                     int y,
                                     Object obj,
                                     DataBuffer data)
```
    指定されたDataBufferの1つのピクセルのデータを、TransferType型のプリミティブ配列から設定します。 Java 2D APIによってサポートされているイメージ・データの場合は、DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、DataBuffer.TYPE_INT、DataBuffer.TYPE_SHORT、DataBuffer.TYPE_FLOAT、またはDataBuffer.TYPE_DOUBLEのいずれかになります。配列内のデータはパックされた形式で返されることもあり、その場合、データ転送の効率が上がります。
    次のコードは、SampleModel sm1によってストレージ・レイアウトが記述されているDataBuffer db1から、SampleModel sm2によってストレージ・レイアウトが記述されているDataBuffer db2へ、1ピクセルのデータを転送する例です。通常、この転送はgetPixelとsetPixelを使うよりも効率的です。
    SampleModel sm1, sm2; DataBuffer db1, db2; sm2.setDataElements(x, y, sm1.getDataElements(x, y, null, db1), db2);
    SampleModelのバンド数が同じで、対応するバンドのサンプルあたりのビット数が同じで、TransferTypeが同じである場合、2つのDataBuffer/SampleModel間の転送には、getDataElements/setDataElementsを使用するのが適切です。
    objは、TransferType型のプリミティブ配列になります。そうでない場合は、ClassCastExceptionがスローされます。座標が境界内にない場合、またはobjがピクセル・データを格納するために十分なサイズでない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    パラメータ:
    
    x - ピクセル位置のX座標。
    
    y - ピクセル位置のY座標。
    
    obj - ピクセル・データを格納するプリミティブ配列。
    
    data - イメージ・データを格納するDataBuffer。
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、またはobjが小さすぎて入力を保持できない場合。
    
    関連項目:
    
    getNumDataElements()、getTransferType()、getDataElements(int, int, Object, DataBuffer)、DataBuffer
  - setDataElements
```
public void setDataElements(int x,
                            int y,
                            int w,
                            int h,
                            Object obj,
                            DataBuffer data)
```
    TransferType型のプリミティブ配列から、指定されたDataBuffer内のピクセル矩形のデータを設定します。 Java 2D APIによってサポートされているイメージ・データの場合は、DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、DataBuffer.TYPE_INT、DataBuffer.TYPE_SHORT、DataBuffer.TYPE_FLOAT、またはDataBuffer.TYPE_DOUBLEのいずれかになります。配列内のデータはパックされた形式で返されることもあり、その場合、データ転送の効率が上がります。
    次のコードは、SampleModel sm1によってストレージ・レイアウトが記述されているDataBuffer db1から、SampleModel sm2によってストレージ・レイアウトが記述されているDataBuffer db2へ、ピクセルの矩形領域のデータを転送する例です。通常、この転送はgetPixels/setPixelsを使うよりも効率的です。
    SampleModel sm1, sm2; DataBuffer db1, db2; sm2.setDataElements(x, y, w, h, sm1.getDataElements(x, y, w, h, null, db1), db2);
    SampleModelのバンド数が同じで、対応するバンドのサンプルあたりのビット数が同じで、TransferTypeが同じである場合、2つのDataBuffer/SampleModel間の転送には、getDataElements/setDataElementsを使用するのが適切です。
    objは、TransferType型のプリミティブ配列になります。そうでない場合は、ClassCastExceptionがスローされます。座標が境界内にない場合、またはobjがピクセル・データを格納するために十分なサイズでない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    パラメータ:
    
    x - ピクセル矩形の最小のX座標。
    
    y - ピクセル矩形の最小のY座標。
    
    w - ピクセル矩形の幅。
    
    h - ピクセル矩形の高さ。
    
    obj - ピクセル・データを格納するプリミティブ配列。
    
    data - イメージ・データを格納するDataBuffer。
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、またはobjが小さすぎて入力を保持できない場合。
    
    関連項目:
    
    getNumDataElements()、getTransferType()、getDataElements(int, int, int, int, Object, DataBuffer)、DataBuffer
  - getPixel
```
public float[] getPixel(int x,
                        int y,
                        float[] fArray,
                        DataBuffer data)
```
    floatの配列内の指定されたピクセルのサンプルを返します。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - ピクセル位置のX座標。
    
    y - ピクセル位置のY座標。
    
    fArray - nullでない場合、この配列内のサンプルを返します。
    
    data - イメージ・データを格納するDataBuffer。
    
    戻り値:
    
    指定されたピクセルのサンプル
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、またはfArrayが小さすぎて出力を保持できない場合。
    
    関連項目:
    
    setPixel(int, int, float[], DataBuffer)
  - getPixel
```
public double[] getPixel(int x,
                         int y,
                         double[] dArray,
                         DataBuffer data)
```
    doubleの配列内の指定されたピクセルのサンプルを返します。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - ピクセル位置のX座標。
    
    y - ピクセル位置のY座標。
    
    dArray - nullでない場合、この配列内のサンプルを返します。
    
    data - イメージ・データを格納するDataBuffer。
    
    戻り値:
    
    指定されたピクセルのサンプル
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、またはdArrayが小さすぎて出力を保持できない場合。
    
    関連項目:
    
    setPixel(int, int, double[], DataBuffer)
  - getPixels
```
public int[] getPixels(int x,
                       int y,
                       int w,
                       int h,
                       int[] iArray,
                       DataBuffer data)
```
    int配列のピクセル矩形のすべてのサンプルを返します。配列要素ごとに1つのサンプルが返されます。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - 左上のピクセル位置のX座標。
    
    y - 左上のピクセル位置のY座標。
    
    w - ピクセル矩形の幅。
    
    h - ピクセル矩形の高さ。
    
    iArray - nullでない場合、この配列内のサンプルを返します。
    
    data - イメージ・データを格納するDataBuffer。
    
    戻り値:
    
    指定されたピクセル領域のサンプル
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、またはiArrayが小さすぎて出力を保持できない場合。
    
    関連項目:
    
    setPixels(int, int, int, int, int[], DataBuffer)
  - getPixels
```
public float[] getPixels(int x,
                         int y,
                         int w,
                         int h,
                         float[] fArray,
                         DataBuffer data)
```
    float配列のピクセル矩形のすべてのサンプルを返します。配列要素ごとに1つのサンプルが返されます。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - 左上のピクセル位置のX座標。
    
    y - 左上のピクセル位置のY座標。
    
    w - ピクセル矩形の幅。
    
    h - ピクセル矩形の高さ。
    
    fArray - nullでない場合、この配列内のサンプルを返します。
    
    data - イメージ・データを格納するDataBuffer。
    
    戻り値:
    
    指定されたピクセル領域のサンプル
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、またはfArrayが小さすぎて出力を保持できない場合。
    
    関連項目:
    
    setPixels(int, int, int, int, float[], DataBuffer)
  - getPixels
```
public double[] getPixels(int x,
                          int y,
                          int w,
                          int h,
                          double[] dArray,
                          DataBuffer data)
```
    double配列のピクセル矩形のすべてのサンプルを返します。配列要素ごとに1つのサンプルが返されます。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - 左上のピクセル位置のX座標。
    
    y - 左上のピクセル位置のY座標。
    
    w - ピクセル矩形の幅。
    
    h - ピクセル矩形の高さ。
    
    dArray - nullでない場合、この配列内のサンプルを返します。
    
    data - イメージ・データを格納するDataBuffer。
    
    戻り値:
    
    指定されたピクセル領域のサンプル
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、またはdArrayが小さすぎて出力を保持できない場合。
    
    関連項目:
    
    setPixels(int, int, int, int, double[], DataBuffer)
  - getSample
```
public abstract int getSample(int x,
                              int y,
                              int b,
                              DataBuffer data)
```
    (x, y)に位置するピクセルの指定されたバンド内のサンプルをintとして返します。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - ピクセル位置のX座標。
    
    y - ピクセル位置のY座標。
    
    b - 返されるバンド。
    
    data - イメージ・データを格納するDataBuffer。
    
    戻り値:
    
    指定されたピクセルに対する指定されたバンドのサンプル
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標またはバンド・インデックスが境界内にない場合。
    
    関連項目:
    
    setSample(int, int, int, int, DataBuffer)
  - getSampleFloat
```
public float getSampleFloat(int x,
                            int y,
                            int b,
                            DataBuffer data)
```
    (x, y)に位置するピクセルの指定されたバンド内のサンプルをfloatとして返します。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - ピクセル位置のX座標。
    
    y - ピクセル位置のY座標。
    
    b - 返されるバンド。
    
    data - イメージ・データを格納するDataBuffer。
    
    戻り値:
    
    指定されたピクセルに対する指定されたバンドのサンプル
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標またはバンド・インデックスが境界内にない場合。
  - getSampleDouble
```
public double getSampleDouble(int x,
                              int y,
                              int b,
                              DataBuffer data)
```
    (x, y)に位置するピクセルの指定されたバンド内のサンプルをdoubleとして返します。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - ピクセル位置のX座標。
    
    y - ピクセル位置のY座標。
    
    b - 返されるバンド。
    
    data - イメージ・データを格納するDataBuffer。
    
    戻り値:
    
    指定されたピクセルに対する指定されたバンドのサンプル
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標またはバンド・インデックスが境界内にない場合。
  - getSamples
```
public int[] getSamples(int x,
                        int y,
                        int w,
                        int h,
                        int b,
                        int[] iArray,
                        DataBuffer data)
```
    int配列の指定されたピクセルの矩形の、指定されたバンドのサンプルを返します。配列要素ごとに1つのサンプルが返されます。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - 左上のピクセル位置のX座標。
    
    y - 左上のピクセル位置のY座標。
    
    w - ピクセル矩形の幅。
    
    h - ピクセル矩形の高さ。
    
    b - 返されるバンド。
    
    iArray - nullでない場合、この配列内のサンプルを返します。
    
    data - イメージ・データを格納するDataBuffer。
    
    戻り値:
    
    指定されたピクセル領域の指定されたバンドのサンプル
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標またはバンド・インデックスが境界内に存在しない場合、またはiArrayが小さすぎて出力を保持できない場合。
    
    関連項目:
    
    setSamples(int, int, int, int, int, int[], DataBuffer)
  - getSamples
```
public float[] getSamples(int x,
                          int y,
                          int w,
                          int h,
                          int b,
                          float[] fArray,
                          DataBuffer data)
```
    float配列内の指定されたピクセル矩形の、指定されたバンドのサンプルを返します。配列要素ごとに1つのサンプルが返されます。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - 左上のピクセル位置のX座標。
    
    y - 左上のピクセル位置のY座標。
    
    w - ピクセル矩形の幅。
    
    h - ピクセル矩形の高さ。
    
    b - 返されるバンド。
    
    fArray - nullでない場合、この配列内のサンプルを返します。
    
    data - イメージ・データを格納するDataBuffer。
    
    戻り値:
    
    指定されたピクセル領域の指定されたバンドのサンプル
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標またはバンド・インデックスが境界内に存在しない場合、またはfArrayが小さすぎて出力を保持できない場合。
    
    関連項目:
    
    setSamples(int, int, int, int, int, float[], DataBuffer)
  - getSamples
```
public double[] getSamples(int x,
                           int y,
                           int w,
                           int h,
                           int b,
                           double[] dArray,
                           DataBuffer data)
```
    double配列内の指定されたピクセル矩形の、指定されたバンドのサンプルを返します。配列要素ごとに1つのサンプルが返されます。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - 左上のピクセル位置のX座標。
    
    y - 左上のピクセル位置のY座標。
    
    w - ピクセル矩形の幅。
    
    h - ピクセル矩形の高さ。
    
    b - 返されるバンド。
    
    dArray - nullでない場合、この配列内のサンプルを返します。
    
    data - イメージ・データを格納するDataBuffer。
    
    戻り値:
    
    指定されたピクセル領域の指定されたバンドのサンプル
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標またはバンド・インデックスが境界内に存在しない場合、またはdArrayが小さすぎて出力を保持できない場合。
    
    関連項目:
    
    setSamples(int, int, int, int, int, double[], DataBuffer)
  - setPixel
```
public void setPixel(int x,
                     int y,
                     int[] iArray,
                     DataBuffer data)
```
    サンプルのint配列を入力として使ってDataBuffer内のピクセルを設定します。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - ピクセル位置のX座標。
    
    y - ピクセル位置のY座標。
    
    iArray - int配列形式の入力サンプル。
    
    data - イメージ・データを格納するDataBuffer。
    
    例外:
    
    NullPointerException - iArrayまたはデータがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、またはiArrayが小さすぎて入力を保持できない場合。
    
    関連項目:
    
    getPixel(int, int, int[], DataBuffer)
  - setPixel
```
public void setPixel(int x,
                     int y,
                     float[] fArray,
                     DataBuffer data)
```
    サンプルのfloat配列を入力として使ってDataBuffer内のピクセルを設定します。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - ピクセル位置のX座標。
    
    y - ピクセル位置のY座標。
    
    fArray - float配列の入力サンプル。
    
    data - イメージ・データを格納するDataBuffer。
    
    例外:
    
    NullPointerException - fArrayまたはデータがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、またはfArrayが小さすぎて入力を保持できない場合。
    
    関連項目:
    
    getPixel(int, int, float[], DataBuffer)
  - setPixel
```
public void setPixel(int x,
                     int y,
                     double[] dArray,
                     DataBuffer data)
```
    サンプルのdouble配列を入力として、DataBuffer内のピクセルを設定します。
    
    パラメータ:
    
    x - ピクセル位置のX座標。
    
    y - ピクセル位置のY座標。
    
    dArray - double配列の入力サンプル。
    
    data - イメージ・データを格納するDataBuffer。
    
    例外:
    
    NullPointerException - dArrayまたはデータがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、またはfArrayが小さすぎて入力を保持できない場合。
    
    関連項目:
    
    getPixel(int, int, double[], DataBuffer)
  - setPixels
```
public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      int[] iArray,
                      DataBuffer data)
```
    矩形のピクセルのサンプルすべてを、配列要素ごとに1つのサンプルが格納されているint配列から設定します。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - 左上のピクセル位置のX座標。
    
    y - 左上のピクセル位置のY座標。
    
    w - ピクセル矩形の幅。
    
    h - ピクセル矩形の高さ。
    
    iArray - int配列形式の入力サンプル。
    
    data - イメージ・データを格納するDataBuffer。
    
    例外:
    
    NullPointerException - iArrayまたはデータがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、またはiArrayが小さすぎて入力を保持できない場合。
    
    関連項目:
    
    getPixels(int, int, int, int, int[], DataBuffer)
  - setPixels
```
public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      float[] fArray,
                      DataBuffer data)
```
    矩形のピクセルのサンプルすべてを、配列要素ごとに1つのサンプルが格納されているfloat配列から設定します。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - 左上のピクセル位置のX座標。
    
    y - 左上のピクセル位置のY座標。
    
    w - ピクセル矩形の幅。
    
    h - ピクセル矩形の高さ。
    
    fArray - float配列の入力サンプル。
    
    data - イメージ・データを格納するDataBuffer。
    
    例外:
    
    NullPointerException - fArrayまたはデータがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、またはfArrayが小さすぎて入力を保持できない場合。
    
    関連項目:
    
    getPixels(int, int, int, int, float[], DataBuffer)
  - setPixels
```
public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      double[] dArray,
                      DataBuffer data)
```
    矩形のピクセルのサンプルすべてを、配列要素ごとに1つのサンプルが格納されているdouble配列から設定します。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - 左上のピクセル位置のX座標。
    
    y - 左上のピクセル位置のY座標。
    
    w - ピクセル矩形の幅。
    
    h - ピクセル矩形の高さ。
    
    dArray - double配列の入力サンプル。
    
    data - イメージ・データを格納するDataBuffer。
    
    例外:
    
    NullPointerException - dArrayまたはデータがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、またはdArrayが小さすぎて入力を保持できない場合。
    
    関連項目:
    
    getPixels(int, int, int, int, double[], DataBuffer)
  - setSample
```
public abstract void setSample(int x,
                               int y,
                               int b,
                               int s,
                               DataBuffer data)
```
    intを入力とし、DataBufferの(x,y)に位置するピクセルの、指定されたバンドのサンプルを設定します。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - ピクセル位置のX座標。
    
    y - ピクセル位置のY座標。
    
    b - 設定されるバンド。
    
    s - intの入力サンプル。
    
    data - イメージ・データを格納するDataBuffer。
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標またはバンド・インデックスが境界内にない場合。
    
    関連項目:
    
    getSample(int, int, int, DataBuffer)
  - setSample
```
public void setSample(int x,
                      int y,
                      int b,
                      float s,
                      DataBuffer data)
```
    floatを入力として使用し、DataBuffer内の(x, y)に位置するピクセルの、指定されたバンド内のサンプルを設定します。このメソッドのデフォルトの実装は、入力floatサンプルをintにキャストし、次にこのint値を使用してsetSample(int, int, int, DataBuffer)メソッドを呼び出します。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - ピクセル位置のX座標。
    
    y - ピクセル位置のY座標。
    
    b - 設定されるバンド。
    
    s - floatでの入力サンプル。
    
    data - イメージ・データを格納するDataBuffer。
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標またはバンド・インデックスが境界内にない場合。
    
    関連項目:
    
    getSample(int, int, int, DataBuffer)
  - setSample
```
public void setSample(int x,
                      int y,
                      int b,
                      double s,
                      DataBuffer data)
```
    doubleを入力として使用し、DataBuffer内の(x, y)に位置するピクセルの、指定されたバンド内のサンプルを設定します。このメソッドのデフォルトの実装は、入力doubleサンプルをintにキャストし、次にこのint値を使用してsetSample(int, int, int, DataBuffer)メソッドを呼び出します。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - ピクセル位置のX座標。
    
    y - ピクセル位置のY座標。
    
    b - 設定されるバンド。
    
    s - doubleでの入力サンプル。
    
    data - イメージ・データを格納するDataBuffer。
    
    例外:
    
    NullPointerException - dataがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標またはバンド・インデックスが境界内にない場合。
    
    関連項目:
    
    getSample(int, int, int, DataBuffer)
  - setSamples
```
public void setSamples(int x,
                       int y,
                       int w,
                       int h,
                       int b,
                       int[] iArray,
                       DataBuffer data)
```
    指定された矩形ピクセルの指定されたバンドのサンプルを、配列要素ごとに1つのサンプルが格納されているint配列から設定します。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - 左上のピクセル位置のX座標。
    
    y - 左上のピクセル位置のY座標。
    
    w - ピクセル矩形の幅。
    
    h - ピクセル矩形の高さ。
    
    b - 設定されるバンド。
    
    iArray - int配列形式の入力サンプル。
    
    data - イメージ・データを格納するDataBuffer。
    
    例外:
    
    NullPointerException - iArrayまたはデータがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標またはバンド・インデックスが境界内に存在しない場合、またはiArrayが小さすぎて入力を保持できない場合。
    
    関連項目:
    
    getSamples(int, int, int, int, int, int[], DataBuffer)
  - setSamples
```
public void setSamples(int x,
                       int y,
                       int w,
                       int h,
                       int b,
                       float[] fArray,
                       DataBuffer data)
```
    指定された矩形ピクセルの指定されたバンドのサンプルを、配列要素ごとに1つのサンプルが格納されているfloat配列から設定します。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - 左上のピクセル位置のX座標。
    
    y - 左上のピクセル位置のY座標。
    
    w - ピクセル矩形の幅。
    
    h - ピクセル矩形の高さ。
    
    b - 設定されるバンド。
    
    fArray - float配列の入力サンプル。
    
    data - イメージ・データを格納するDataBuffer。
    
    例外:
    
    NullPointerException - fArrayまたはデータがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標またはバンド・インデックスが境界内に存在しない場合、またはfArrayが小さすぎて入力を保持できない場合。
    
    関連項目:
    
    getSamples(int, int, int, int, int, float[], DataBuffer)
  - setSamples
```
public void setSamples(int x,
                       int y,
                       int w,
                       int h,
                       int b,
                       double[] dArray,
                       DataBuffer data)
```
    指定された矩形ピクセルの指定されたバンドのサンプルを、配列要素ごとに1つのサンプルが格納されているdouble配列から設定します。座標が境界内にない場合は、ArrayIndexOutOfBoundsExceptionがスローされます。
    
    パラメータ:
    
    x - 左上のピクセル位置のX座標。
    
    y - 左上のピクセル位置のY座標。
    
    w - ピクセル矩形の幅。
    
    h - ピクセル矩形の高さ。
    
    b - 設定されるバンド。
    
    dArray - double配列の入力サンプル。
    
    data - イメージ・データを格納するDataBuffer。
    
    例外:
    
    NullPointerException - dArrayまたはデータがnullの場合。
    
    ArrayIndexOutOfBoundsException - 座標またはバンド・インデックスが境界内に存在しない場合、またはdArrayが小さすぎて入力を保持できない場合。
    
    関連項目:
    
    getSamples(int, int, int, int, int, double[], DataBuffer)
  - createCompatibleSampleModel
```
public abstract SampleModel createCompatibleSampleModel(int w,
                                                        int h)
```
    このSampleModelの形式でデータが記述されている、幅と高さが異なるSampleModelを生成します。
    
    パラメータ:
    
    w - イメージ・データの幅
    
    h - イメージ・データの高さ
    
    戻り値:
    
    このSampleModelと同じイメージ・データを記述し、サイズが異なるSampleModel。
  - createSubsetSampleModel
```
public abstract SampleModel createSubsetSampleModel(int[] bands)
```
    このSampleModelのバンドのサブセットを使って新しいSampleModelを生成します。
    
    パラメータ:
    
    bands - このSampleModelのバンドのサブセット
    
    戻り値:
    
    このSampleModelのバンドのサブセットを持つSampleModel。
  - createDataBuffer
```
public abstract DataBuffer createDataBuffer()
```
    このSampleModelに対応するDataBufferを生成します。 DataBufferの幅と高さはこのSampleModelの幅と高さと一致します。
    
    戻り値:
    
    このSampleModelに対するDataBuffer。
  - getSampleSize
```
public abstract int[] getSampleSize()
```
    すべてのバンドについて、サンプルのビットのサイズを返します。
    
    戻り値:
    
    すべてのバンドについてのサンプルのサイズ。
  - getSampleSize
```
public abstract int getSampleSize(int band)
```
    指定されたバンドについて、サンプルのビットのサイズを返します。
    
    パラメータ:
    
    band - 指定されたバンド
    
    戻り値:
    
    指定されたバンドのサンプルのサイズ

クラスSampleModel

フィールドのサマリー

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectで宣言されたメソッド

フィールドの詳細

width

height

numBands

dataType

コンストラクタの詳細

SampleModel

メソッドの詳細

getWidth

getHeight

getNumBands

getNumDataElements

getDataType

getTransferType

getPixel

getDataElements

getDataElements

setDataElements

setDataElements

getPixel

getPixel

getPixels

getPixels

getPixels

getSample

getSampleFloat

getSampleDouble

getSamples

getSamples

getSamples

setPixel

setPixel

setPixel

setPixels

setPixels

setPixels

setSample

setSample

setSample

setSamples

setSamples

setSamples

createCompatibleSampleModel

createSubsetSampleModel

createDataBuffer

getSampleSize

getSampleSize