ComponentSampleModel (Java Platform SE 7)

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

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

BandedSampleModel, PixelInterleavedSampleModel
```
public class ComponentSampleModel
extends SampleModel
```
このクラスは、DataBuffer のデータ要素 1 つに 1 つずつピクセルを形成する各サンプルが格納されているイメージデータを表します。DataBuffer は、1 ピクセルを形成する N 個のサンプルを、N 個の別個のデータ配列要素に格納します。異なるバンドが、それぞれ DataBuffer の別のバンクに格納される場合があります。イメージデータを直接処理できるように、アクセス用メソッドが提供されています。このクラスは、各種のインタリーブ (バンドインタリーブ、走査線インタリーブ、およびピクセルインタリーブなど) をサポート可能です。ピクセルストライドは、同じ走査線上の同じバンドにある 2 つのサンプルの間にあるデータ配列要素数です。走査線ストライドは、指定されたサンプルと次の走査線の同じ列の対応するサンプルとの間のデータ配列要素の数です。バンドオフセットは、各バンドが格納されている DataBuffer のバンクにある最初のデータ配列要素からそのバンドの最初のサンプルまでのデータ配列要素数を示します。バンドには 0 から N-1 までの番号が付けられています。このクラスは、8 ビット、16 ビット、または 32 ビット (それぞれ、DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、または DataBuffer.TYPE_INT を使用) で格納できる符号なし整数値を各サンプルに持つイメージデータ、16 ビット (DataBuffer.TYPE_SHORT を使用) で格納できる符号付き整数値を各サンプルに持つデータ、または符号付き float 型または double 型の数値 (それぞれ DataBuffer.TYPE_FLOAT または DataBuffer.TYPE_DOUBLE を使用) を各サンプルに持つデータを表すことができます。このとき、指定された ComponentSampleModel のすべてのサンプルも、同じ精度で格納されます。すべてのストライド、およびオフセットは、負でない数値とする必要があります。このクラスは、TYPE_BYTE、TYPE_USHORT、TYPE_SHORT、TYPE_INT、TYPE_FLOAT、および TYPE_DOUBLE をサポートします。

関連項目:
PixelInterleavedSampleModel、BandedSampleModel

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`protected int[]`	`bandOffsets` データ配列要素にあるすべてのバンドのオフセットです。
`protected int[]`	`bankIndices` イメージデータのバンドを格納する各バンクのインデックスです。
`protected int`	`numBands` この`ComponentSampleModel` 内のバンド数です。
`protected int`	`numBanks` この`ComponentSampleModel` 内のバンク数です。
`protected int`	`pixelStride` この ComponentSampleModel で記述されるイメージデータ領域 (データ配列要素) のピクセルストライドです。
`protected int`	`scanlineStride` この ComponentSampleModel で記述されるイメージデータ領域 (データ配列要素) の走査線ストライドです。

クラス java.awt.image.SampleModel から継承されたフィールド
dataType, height, width

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

コンストラクタ
コンストラクタと説明
`ComponentSampleModel(int dataType, int w, int h, int pixelStride, int scanlineStride, int[] bandOffsets)` 指定されたパラメータで、ComponentSampleModel を構築します。
`ComponentSampleModel(int dataType, int w, int h, int pixelStride, int scanlineStride, int[] bankIndices, int[] bandOffsets)` 指定されたパラメータで、ComponentSampleModel を構築します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`SampleModel`	`createCompatibleSampleModel(int w, int h)` 指定された幅と高さを持つ新しい `ComponentSampleModel` を作成します。
`DataBuffer`	`createDataBuffer()` この `ComponentSampleModel` に対応する `DataBuffer` を構築します。
`SampleModel`	`createSubsetSampleModel(int[] bands)` この ComponentSampleModel のサブセットを持つ、新しい ComponentSampleModel を構築します。
`boolean`	`equals(Object o)` このオブジェクトと他のオブジェクトが等しいかどうかを示します。
`int[]`	`getBandOffsets()` すべてのバンドについて、バンドのオフセットを返します。
`int[]`	`getBankIndices()` すべてのバンクについて、バンクのインデックスを返します。
`Object`	`getDataElements(int x, int y, Object obj, DataBuffer data)` `TransferType` 型のプリミティブ配列内の 1 つのピクセルのデータを返します。
`int`	`getNumDataElements()` `getDataElements(int, int, Object, DataBuffer)` メソッドと `setDataElements(int, int, Object, DataBuffer)` メソッドで、1 つのピクセルを転送するために必要なデータ要素の数を返します。
`int`	`getOffset(int x, int y)` ピクセル (x, y) の最初のバンドのオフセットを返します。
`int`	`getOffset(int x, int y, int b)` ピクセル (x, y) のバンド b のオフセットを返します。
`int[]`	`getPixel(int x, int y, int[] iArray, DataBuffer data)` 指定されたピクセルのすべてのサンプルを int 配列として返します。配列要素にサンプル 1 個が対応します。
`int[]`	`getPixels(int x, int y, int w, int h, int[] iArray, DataBuffer data)` int 配列の指定されたピクセルの矩形のすべてのサンプルを返します。配列要素ごとに 1 つのサンプルが返されます。
`int`	`getPixelStride()` この ComponentSampleModel のピクセルストライドを返します。
`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 として返します。
`int[]`	`getSamples(int x, int y, int w, int h, int b, int[] iArray, DataBuffer data)` 指定されたピクセル矩形に使う、指定されたバンド内のサンプルを int 配列として返します。データ配列要素にサンプル 1 個が対応します。
`int[]`	`getSampleSize()` すべてのバンドのサンプルあたりのビット数を返します。
`int`	`getSampleSize(int band)` 指定されたバンドのサンプルあたりのビット数を返します。
`int`	`getScanlineStride()` この ComponentSampleModel の走査線ストライドを返します。
`int`	`hashCode()` オブジェクトのハッシュコード値を返します。
`void`	`setDataElements(int x, int y, Object obj, DataBuffer data)` 指定された `DataBuffer` の 1 つのピクセルのデータを、`TransferType` 型のプリミティブ配列から設定します。
`void`	`setPixel(int x, int y, int[] iArray, DataBuffer data)` サンプルの int 配列を入力として使って `DataBuffer` 内のピクセルを設定します。
`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) に位置するピクセルの、指定されたバンド内のサンプルを設定します。
`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, int[] iArray, DataBuffer data)` データ配列要素あたり 1 個のサンプルを格納している int 配列から、指定されたピクセル矩形の、指定されたバンドにサンプルを設定します。

クラス java.awt.image.SampleModel から継承されたメソッド
getDataElements, getDataType, getHeight, getNumBands, getPixel, getPixel, getPixels, getPixels, getSamples, getSamples, getTransferType, getWidth, setDataElements, setPixel, setPixel, setPixels, setPixels, setSamples, setSamples

クラス java.lang.Object から継承されたメソッド
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- フィールドの詳細
  - bandOffsets
```
protected int[] bandOffsets
```
    データ配列要素にあるすべてのバンドのオフセットです。
  - bankIndices
```
protected int[] bankIndices
```
    イメージデータのバンドを格納する各バンクのインデックスです。
  - numBands
```
protected int numBands
```
    このComponentSampleModel 内のバンド数です。
  - numBanks
```
protected int numBanks
```
    このComponentSampleModel 内のバンク数です。
  - scanlineStride
```
protected int scanlineStride
```
    この ComponentSampleModel で記述されるイメージデータ領域 (データ配列要素) の走査線ストライドです。
  - pixelStride
```
protected int pixelStride
```
    この ComponentSampleModel で記述されるイメージデータ領域 (データ配列要素) のピクセルストライドです。
- コンストラクタの詳細
  - ComponentSampleModel
```
public ComponentSampleModel(int dataType,
                    int w,
                    int h,
                    int pixelStride,
                    int scanlineStride,
                    int[] bandOffsets)
```
    指定されたパラメータで、ComponentSampleModel を構築します。バンド数は、bandOffsets 配列の長さによって指定されます。すべてのバンドは、DataBuffer の最初のバンクに格納されます。
    
    パラメータ:
    dataType - サンプル格納用のデータ形式
    w - 記述されたイメージデータの領域の幅 (単位はピクセル)
    h - 記述されたイメージデータの領域の高さ (単位はピクセル)
    pixelStride - 記述されるイメージデータの領域のピクセルストライド
    scanlineStride - 記述されるイメージデータの領域のラインストライド
    bandOffsets - すべてのバンドのオフセット
    
    例外:
    
    IllegalArgumentException - w または h が 0 以下である場合
    
    IllegalArgumentException - pixelStride が 0 より小さい場合
    
    IllegalArgumentException - scanlineStride が 0 より小さい場合
    
    IllegalArgumentException - numBands が 1 より小さい場合
    
    IllegalArgumentException - w と h の積が Integer.MAX_VALUE より大きい場合
    
    IllegalArgumentException - dataType がサポートされているデータ型でない場合
  - ComponentSampleModel
```
public ComponentSampleModel(int dataType,
                    int w,
                    int h,
                    int pixelStride,
                    int scanlineStride,
                    int[] bankIndices,
                    int[] bandOffsets)
```
    指定されたパラメータで、ComponentSampleModel を構築します。バンド数は、bandOffsets 配列の長さによって指定されます。異なるバンドは、DataBuffer の別々のバンクに格納されます。
    
    パラメータ:
    dataType - サンプル格納用のデータ形式
    w - 記述されたイメージデータの領域の幅 (単位はピクセル)
    h - 記述されたイメージデータの領域の高さ (単位はピクセル)
    pixelStride - 記述されるイメージデータの領域のピクセルストライド
    scanlineStride - 記述されるイメージデータの領域のラインストライド
    bankIndices - すべてのバンドのバンクインデックス
    bandOffsets - すべてのバンドのバンドオフセット
    
    例外:
    
    IllegalArgumentException - w または h が 0 以下である場合
    
    IllegalArgumentException - pixelStride が 0 より小さい場合
    
    IllegalArgumentException - scanlineStride が 0 より小さい場合
    
    IllegalArgumentException - bankIndices の長さが bankOffsets の長さと等しくない場合
    
    IllegalArgumentException - bandIndices のバンクインデックスのいずれかが 0 より小さい場合
    
    IllegalArgumentException - dataType がサポートされているデータ型でない場合
- メソッドの詳細
  - createCompatibleSampleModel
```
public SampleModel createCompatibleSampleModel(int w,
                                      int h)
```
    指定された幅と高さを持つ新しい ComponentSampleModel を作成します。新しい SampleModel は、この SampleModel と同じ数のバンド、ストレージデータ型、インタリーブ化方式、およびピクセルストライドを持ちます。
    
    定義:
    
    createCompatibleSampleModel、クラス: SampleModel
    
    パラメータ:
    w - 結果として得られる SampleModel の幅
    h - 結果として得られる SampleModel の高さ
    
    戻り値:
    指定されたサイズを持つ新しい ComponentSampleModel
    
    例外:
    
    IllegalArgumentException - w または h が 0 以下である場合
  - createSubsetSampleModel
```
public SampleModel createSubsetSampleModel(int[] bands)
```
    この ComponentSampleModel のサブセットを持つ、新しい ComponentSampleModel を構築します。新しい ComponentSampleModel は、既存の ComponentSampleModel を使用できる任意の DataBuffer と組み合わせて使用できます。新しい ComponentSampleModel と DataBuffer の組み合わせは、元の ComponentSampleModel と DataBuffer の組み合わせにあるバンドのサブセットを持つイメージを表します。
    
    定義:
    
    createSubsetSampleModel、クラス: SampleModel
    
    パラメータ:
    bands - この ComponentSampleModel のバンドのサブセット
    
    戻り値:
    この ComponentSampleModel のバンドのサブセットで作成された ComponentSampleModel。
  - createDataBuffer
```
public DataBuffer createDataBuffer()
```
    この ComponentSampleModel に対応する DataBuffer を構築します。DataBuffer のデータ型、バンク数、およびサイズは、この ComponentSampleModel と矛盾しません。
    
    定義:
    
    createDataBuffer、クラス: SampleModel
    
    戻り値:
    この ComponentSampleModel とデータ型、バンク数、およびサイズが同じ DataBuffer。
  - getOffset
```
public int getOffset(int x,
            int y)
```
    ピクセル (x, y) の最初のバンドのオフセットを返します。最初のバンドのサンプルは、DataBuffer data から、ComponentSampleModel csm を使って次のようにして取得できます。
```
        data.getElem(csm.getOffset(x, y));
 
```
    パラメータ:
    x - ピクセルの X 位置
    y - ピクセルの Y 位置
    
    戻り値:
    指定されたピクセルの最初のバンドのオフセット
  - getOffset
```
public int getOffset(int x,
            int y,
            int b)
```
    ピクセル (x, y) のバンド b のオフセットを返します。バンド b のサンプルは、DataBuffer data から、ComponentSampleModel csm を使って次のようにして取得できます。
```
       data.getElem(csm.getOffset(x, y, b));
 
```
    パラメータ:
    x - 指定されたピクセルの X 位置
    y - 指定されたピクセルの Y 位置
    b - 指定されたバンド
    
    戻り値:
    指定されたピクセルの指定されたバンドのオフセット
  - getSampleSize
```
public final int[] getSampleSize()
```
    すべてのバンドのサンプルあたりのビット数を返します。
    
    定義:
    
    getSampleSize、クラス: SampleModel
    
    戻り値:
    配列内の各要素がバンドを表す、すべてのバンドのサンプルあたりのビット数を含む配列
  - getSampleSize
```
public final int getSampleSize(int band)
```
    指定されたバンドのサンプルあたりのビット数を返します。
    
    定義:
    
    getSampleSize、クラス: SampleModel
    
    パラメータ:
    band - 指定されたバンド
    
    戻り値:
    指定されたバンドのサンプルあたりのビット数
  - getBankIndices
```
public final int[] getBankIndices()
```
    すべてのバンクについて、バンクのインデックスを返します。
    
    戻り値:
    すべてのバンクのバンクインデックス
  - getBandOffsets
```
public final int[] getBandOffsets()
```
    すべてのバンドについて、バンドのオフセットを返します。
    
    戻り値:
    すべてのバンドのバンドオフセット
  - getScanlineStride
```
public final int getScanlineStride()
```
    この ComponentSampleModel の走査線ストライドを返します。
    
    戻り値:
    この ComponentSampleModel の走査線ストライド。
  - getPixelStride
```
public final int getPixelStride()
```
    この ComponentSampleModel のピクセルストライドを返します。
    
    戻り値:
    この ComponentSampleModel のピクセルストライド。
  - getNumDataElements
```
public final int getNumDataElements()
```
    getDataElements(int, int, Object, DataBuffer) メソッドと setDataElements(int, int, Object, DataBuffer) メソッドで、1 つのピクセルを転送するために必要なデータ要素の数を返します。ComponentSampleModel では、これはバンド数と等しくなります。
    
    定義:
    
    getNumDataElements、クラス: SampleModel
    
    戻り値:
    getDataElements メソッドと setDataElements メソッドで 1 ピクセルを転送するために必要なデータ要素の数。
    関連項目:
    SampleModel.getNumDataElements(), SampleModel.getNumBands()
  - getDataElements
```
public Object getDataElements(int x,
                     int y,
                     Object obj,
                     DataBuffer data)
```
    TransferType 型のプリミティブ配列内の 1 つのピクセルのデータを返します。ComponentSampleModel では、これはデータ型と等しくなり、サンプルが配列要素ごとに 1 個ずつ返されます。通常は、Object が自動的に作成され、正しい基本データ型になるように、obj には null が渡されます。
    次のコードは、ComponentSampleModel csm1 によってストレージレイアウトが記述されている DataBuffer db1 から、ComponentSampleModel csm2 によってストレージレイアウトが記述されている DataBuffer db2 へ、1 ピクセルのデータを転送する例です。この転送方法は、getPixel および setPixel を使う方法よりも通常効率的です。
```
       ComponentSampleModel csm1, csm2;
       DataBufferInt db1, db2;
       csm2.setDataElements(x, y,
                            csm1.getDataElements(x, y, null, db1), db2);
 
```
    SampleModel オブジェクトのバンド数が同じで、対応するバンドのサンプルあたりのビット数が同じで、TransferType が同じである場合、2 つの DataBuffer/SampleModel ペア間の転送には、getDataElements および setDataElements を使用するのが適切です。
    obj が null でない場合は、TransferType 型のプリミティブ配列になります。そうでない場合は、ClassCastException がスローされます。座標が境界内にない場合や、obj が null でなく、ピクセルデータを格納するために十分な大きさでない場合は、ArrayIndexOutOfBoundsException がスローされます。
    定義:
    
    getDataElements、クラス: SampleModel
    
    パラメータ:
    x - ピクセル位置の X 座標
    y - ピクセル位置の Y 座標
    obj - null でない場合は、ピクセルデータが返されるプリミティブ配列
    data - イメージデータを格納する DataBuffer
    
    戻り値:
    指定されたピクセルのデータ
    
    例外:
    
    NullPointerException - data が null の場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、または obj が小さすぎて出力を保持できない場合。
    関連項目:
    setDataElements(int, int, Object, DataBuffer)
  - getPixel
```
public int[] getPixel(int x,
             int y,
             int[] iArray,
             DataBuffer data)
```
    指定されたピクセルのすべてのサンプルを int 配列として返します。配列要素にサンプル 1 個が対応します。座標が境界内にない場合は、ArrayIndexOutOfBoundsException がスローされることがあります。
    
    オーバーライド:
    
    getPixel、クラス: SampleModel
    
    パラメータ:
    x - ピクセル位置の X 座標
    y - ピクセル位置の Y 座標
    iArray - null でない場合、この配列内のサンプルを返します
    data - イメージデータを格納する DataBuffer
    
    戻り値:
    指定されたピクセルのサンプル
    
    例外:
    
    NullPointerException - data が null の場合。
    
    ArrayIndexOutOfBoundsException - 座標が境界内に存在しない場合、または iArray が小さすぎて出力を保持できない場合。
    関連項目:
    setPixel(int, int, int[], DataBuffer)
  - getPixels
```
public int[] getPixels(int x,
              int y,
              int w,
              int h,
              int[] iArray,
              DataBuffer data)
```
    int 配列の指定されたピクセルの矩形のすべてのサンプルを返します。配列要素ごとに 1 つのサンプルが返されます。座標が境界内にない場合は、ArrayIndexOutOfBoundsException がスローされることがあります。
    
    オーバーライド:
    
    getPixels、クラス: SampleModel
    
    パラメータ:
    x - 左上のピクセル位置の X 座標
    y - 左上のピクセル位置の Y 座標
    w - ピクセル矩形の幅
    h - ピクセル矩形の高さ
    iArray - null でない場合、この配列内のサンプルを返します
    data - イメージデータを格納する DataBuffer
    
    戻り値:
    指定された領域内のピクセルのサンプル
    関連項目:
    setPixels(int, int, int, int, int[], DataBuffer)
  - getSample
```
public int getSample(int x,
            int y,
            int b,
            DataBuffer data)
```
    (x, y) に位置するピクセルの、指定されたバンド内のサンプルを int として返します。座標が境界内にない場合は、ArrayIndexOutOfBoundsException がスローされることがあります。
    
    定義:
    
    getSample、クラス: SampleModel
    
    パラメータ:
    x - ピクセル位置の X 座標
    y - ピクセル位置の Y 座標
    b - 返されるバンド
    data - イメージデータを格納する DataBuffer
    
    戻り値:
    指定されたピクセルの指定されたバンド内のサンプル
    関連項目:
    setSample(int, int, int, int, DataBuffer)
  - getSampleFloat
```
public float getSampleFloat(int x,
                   int y,
                   int b,
                   DataBuffer data)
```
    (x, y) に位置するピクセルの指定されたバンド内のサンプルを float として返します。座標が境界内にない場合は、ArrayIndexOutOfBoundsException がスローされることがあります。
    
    オーバーライド:
    
    getSampleFloat、クラス: SampleModel
    
    パラメータ:
    x - ピクセル位置の X 座標
    y - ピクセル位置の Y 座標
    b - 返されるバンド
    data - イメージデータを格納する DataBuffer
    
    戻り値:
    指定されたピクセルの指定されたバンド内のサンプルを表す float 値
  - getSampleDouble
```
public double getSampleDouble(int x,
                     int y,
                     int b,
                     DataBuffer data)
```
    (x, y) に位置するピクセルの指定されたバンド内のサンプルを double として返します。座標が境界内にない場合は、ArrayIndexOutOfBoundsException がスローされることがあります。
    
    オーバーライド:
    
    getSampleDouble、クラス: SampleModel
    
    パラメータ:
    x - ピクセル位置の X 座標
    y - ピクセル位置の Y 座標
    b - 返されるバンド
    data - イメージデータを格納する DataBuffer
    
    戻り値:
    指定されたピクセルの指定されたバンド内のサンプルを表す double 値
  - getSamples
```
public int[] getSamples(int x,
               int y,
               int w,
               int h,
               int b,
               int[] iArray,
               DataBuffer data)
```
    指定されたピクセル矩形に使う、指定されたバンド内のサンプルを int 配列として返します。データ配列要素にサンプル 1 個が対応します。座標が境界内にない場合は、ArrayIndexOutOfBoundsException がスローされることがあります。
    
    オーバーライド:
    
    getSamples、クラス: SampleModel
    
    パラメータ:
    x - 左上のピクセル位置の X 座標
    y - 左上のピクセル位置の Y 座標
    w - ピクセル矩形の幅
    h - ピクセル矩形の高さ
    b - 返されるバンド
    iArray - null でない場合、この配列内のサンプルを返す
    data - イメージデータを格納する DataBuffer
    
    戻り値:
    指定されたピクセルの指定されたバンド内のサンプル
    関連項目:
    setSamples(int, int, int, int, int, int[], DataBuffer)
  - setDataElements
```
public void setDataElements(int x,
                   int y,
                   Object obj,
                   DataBuffer data)
```
    指定された DataBuffer の 1 つのピクセルのデータを、TransferType 型のプリミティブ配列から設定します。ComponentSampleModel では、これはデータ型と同じになり、サンプルは各配列要素に 1 個ずつ転送されます。
    次のコードは、ComponentSampleModel csm1 によってストレージレイアウトが記述されている DataBuffer db1 から、ComponentSampleModel csm2 によってストレージレイアウトが記述されている DataBuffer db2 へ、1 ピクセルのデータを転送する例です。この転送方法は、getPixel および setPixel を使う方法よりも通常効率的です。
```
       ComponentSampleModel csm1, csm2;
       DataBufferInt db1, db2;
       csm2.setDataElements(x, y, csm1.getDataElements(x, y, null, db1),
                            db2);
 
```
    SampleModel オブジェクトのバンド数が同じで、対応するバンドのサンプルあたりのビット数が同じで、TransferType が同じである場合、2 つの DataBuffer/SampleModel ペア間の転送には、getDataElements および setDataElements を使用するのが適切です。
    obj が TransferType 型のプリミティブ配列でない場合は、ClassCastException がスローされます。座標が境界内にない場合や、obj がピクセルデータを格納するために十分な大きさでない場合は、ArrayIndexOutOfBoundsException がスローされます。
    定義:
    
    setDataElements、クラス: SampleModel
    
    パラメータ:
    x - ピクセル位置の X 座標
    y - ピクセル位置の Y 座標
    obj - ピクセルデータを格納するプリミティブ配列
    data - イメージデータを格納する DataBuffer
    関連項目:
    getDataElements(int, int, Object, DataBuffer)
  - setPixel
```
public void setPixel(int x,
            int y,
            int[] iArray,
            DataBuffer data)
```
    サンプルの int 配列を入力として使って DataBuffer 内のピクセルを設定します。座標が境界内にない場合は、ArrayIndexOutOfBoundsException がスローされることがあります。
    
    オーバーライド:
    
    setPixel、クラス: SampleModel
    
    パラメータ:
    x - ピクセル位置の X 座標
    y - ピクセル位置の Y 座標
    iArray - int 配列形式の入力サンプル
    data - イメージデータを格納する DataBuffer
    関連項目:
    getPixel(int, int, int[], DataBuffer)
  - setPixels
```
public void setPixels(int x,
             int y,
             int w,
             int h,
             int[] iArray,
             DataBuffer data)
```
    矩形のピクセルのサンプルすべてを、配列要素ごとに 1 つのサンプルが格納されている int 配列から設定します。座標が境界内にない場合は、ArrayIndexOutOfBoundsException がスローされることがあります。
    
    オーバーライド:
    
    setPixels、クラス: SampleModel
    
    パラメータ:
    x - 左上のピクセル位置の X 座標
    y - 左上のピクセル位置の Y 座標
    w - ピクセル矩形の幅
    h - ピクセル矩形の高さ
    iArray - int 配列形式の入力サンプル
    data - イメージデータを格納する DataBuffer
    関連項目:
    getPixels(int, int, int, int, int[], DataBuffer)
  - setSample
```
public void setSample(int x,
             int y,
             int b,
             int s,
             DataBuffer data)
```
    int を入力とし、DataBuffer の (x,y) に位置するピクセルの、指定されたバンドのサンプルを設定します。座標が境界内にない場合は、ArrayIndexOutOfBoundsException がスローされることがあります。
    
    定義:
    
    setSample、クラス: SampleModel
    
    パラメータ:
    x - ピクセル位置の X 座標
    y - ピクセル位置の Y 座標
    b - 設定されるバンド
    s - int の入力サンプル
    data - イメージデータを格納する DataBuffer
    関連項目:
    getSample(int, int, int, DataBuffer)
  - setSample
```
public void setSample(int x,
             int y,
             int b,
             float s,
             DataBuffer data)
```
    float を入力として使用し、DataBuffer 内の (x, y) に位置するピクセルの、指定されたバンド内のサンプルを設定します。座標が境界内にない場合は、ArrayIndexOutOfBoundsException がスローされることがあります。
    
    オーバーライド:
    
    setSample、クラス: SampleModel
    
    パラメータ:
    x - ピクセル位置の X 座標
    y - ピクセル位置の Y 座標
    b - 設定されるバンド
    s - float での入力サンプル
    data - イメージデータを格納する DataBuffer
    関連項目:
    getSample(int, int, int, DataBuffer)
  - setSample
```
public void setSample(int x,
             int y,
             int b,
             double s,
             DataBuffer data)
```
    double を入力として使用し、DataBuffer 内の (x, y) に位置するピクセルの、指定されたバンド内のサンプルを設定します。座標が境界内にない場合は、ArrayIndexOutOfBoundsException がスローされることがあります。
    
    オーバーライド:
    
    setSample、クラス: SampleModel
    
    パラメータ:
    x - ピクセル位置の X 座標
    y - ピクセル位置の Y 座標
    b - 設定されるバンド
    s - double での入力サンプル
    data - イメージデータを格納する DataBuffer
    関連項目:
    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 がスローされることがあります。
    
    オーバーライド:
    
    setSamples、クラス: SampleModel
    
    パラメータ:
    x - 左上のピクセル位置の X 座標
    y - 左上のピクセル位置の Y 座標
    w - ピクセル矩形の幅
    h - ピクセル矩形の高さ
    b - 設定されるバンド
    iArray - int 配列形式の入力サンプル
    data - イメージデータを格納する DataBuffer
    関連項目:
    getSamples(int, int, int, int, int, int[], DataBuffer)
  - equals
```
public boolean equals(Object o)
```
    次のクラスからコピーされた説明: Object
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    equals メソッドは、null 以外のオブジェクト参照での同値関係を実装します。
    - 反射性 (reflexive): null 以外の参照値 x について、x.equals(x) は true を返します。
    - 対称性 (symmetric): null 以外の参照値 x および y について、y.equals(x) が true を返す場合に限り、x.equals(y) は true を返します。
    - 推移性 (transitive): null 以外の参照値 x、y、および z について、x.equals(y) が true を返し、y.equals(z) が true を返す場合、x.equals(z) は true を返します。
    - 一貫性 (consistent): null 以外の参照値 x および y について、x.equals(y) の複数の呼び出しは、このオブジェクトに対する equals による比較で使われた情報が変更されていなければ、一貫して true を返すか、一貫して false を返します。
    - null 以外の参照値 x について、x.equals(null) は false を返します。
    Object クラスの equals メソッドは、もっとも比較しやすいオブジェクトの同値関係を実装します。つまり、null 以外の参照値 x と y について、このメソッドは x と y が同じオブジェクトを参照する (x == y が true) 場合にだけ true を返します。
    通常、このメソッドをオーバーライドする場合は、hashCode メソッドを常にオーバーライドして、「等価なオブジェクトは等価なハッシュコードを保持する必要がある」という hashCode メソッドの汎用規約に従う必要があることに留意してください。
    オーバーライド:
    
    equals、クラス: Object
    
    パラメータ:
    o - 比較対象の参照オブジェクト。
    
    戻り値:
    このオブジェクトが obj 引数と同じである場合は true、それ以外の場合は false。
    関連項目:
    Object.hashCode()、HashMap
  - hashCode
```
public int hashCode()
```
    次のクラスからコピーされた説明: Object
    オブジェクトのハッシュコード値を返します。このメソッドは、HashMap によって提供されるハッシュテーブルなどの、ハッシュテーブルの利点のためにサポートされています。
    hashCode の一般的な規則は次のとおりです。
    - Java アプリケーションの実行中に同じオブジェクトに対して複数回呼び出された場合は常に、このオブジェクトに対する equals の比較で使用される情報が変更されていなければ、hashCode メソッドは常に同じ整数を返す必要があります。ただし、この整数は同じアプリケーションの実行ごとに同じである必要はありません。
    - equals(Object) メソッドに従って 2 つのオブジェクトが等しい場合は、2 つの各オブジェクトに対する hashCode メソッドの呼び出しによって同じ整数の結果が生成される必要があります。
    - Object.equals(java.lang.Object) メソッドに従って 2 つのオブジェクトが等しくない場合は、2 つの各オブジェクトに対する hashCode メソッドの呼び出しによって異なる整数の結果が生成される必要はありません。ただし、プログラマは、等しくないオブジェクトに対して異なる整数の結果を生成すると、ハッシュテーブルのパフォーマンスが向上する可能性があることに注意するようにしてください。
    クラス Object によって定義された hashCode メソッドは、可能なかぎり、異なるオブジェクトに対して異なる整数を返します。(これは通常、オブジェクトの内部アドレスを整数に変換することによって実装されますが、この実装テクニックは Java^TM プログラミング言語では必要ありません。)
    オーバーライド:
    
    hashCode、クラス: Object
    
    戻り値:
    このオブジェクトのハッシュコード値。
    関連項目:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス ComponentSampleModel

フィールドのサマリー

クラス java.awt.image.SampleModel から継承されたフィールド

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

メソッドのサマリー

クラス java.awt.image.SampleModel から継承されたメソッド

クラス java.lang.Object から継承されたメソッド

フィールドの詳細

bandOffsets

bankIndices

numBands

numBanks

scanlineStride

pixelStride

コンストラクタの詳細

ComponentSampleModel

ComponentSampleModel

メソッドの詳細

createCompatibleSampleModel

createSubsetSampleModel

createDataBuffer

getOffset

getOffset

getSampleSize

getSampleSize

getBankIndices

getBandOffsets

getScanlineStride

getPixelStride

getNumDataElements

getDataElements

getPixel

getPixels

getSample

getSampleFloat

getSampleDouble

getSamples

setDataElements

setPixel

setPixels

setSample

setSample

setSample

setSamples

equals

hashCode