ComponentSampleModel (Java Platform SE 8)

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

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

BandedSampleModel, PixelInterleavedSampleModel
```
public class ComponentSampleModel
extends SampleModel
```
このクラスは、DataBufferのデータ要素1つに1つずつピクセルを形成する各サンプルが格納されているイメージ・データを表します。これは、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™プログラミング言語では必要ありません。)
    オーバーライド:
    
    hashCode、クラスObject
    
    戻り値:
    
    このオブジェクトのハッシュ・コード値。
    
    関連項目:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

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

クラス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