JavaTM 2 Platform
Standard Ed. 5.0

java.awt.image
クラス ComponentSampleModel

java.lang.Object
  上位を拡張 java.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_BYTEDataBuffer.TYPE_USHORT、または DataBuffer.TYPE_INT を使用) で格納できる符号なし整数値を各サンプルに持つイメージデータ、16 ビット (DataBuffer.TYPE_SHORT を使用) で格納できる符号付き整数値を各サンプルに持つデータ、または符号付き float 型または double 型の数値 (それぞれ DataBuffer.TYPE_FLOAT または DataBuffer.TYPE_DOUBLE を使用) を各サンプルに持つデータを表すことができます。このとき、指定された ComponentSampleModel のすべてのサンプルも、同じ精度で格納されます。すべてのストライド、およびオフセットは、負でない数値とする必要があります。このクラスは TYPE_BYTETYPE_USHORTTYPE_SHORTTYPE_INTTYPE_FLOATTYPE_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)
          1 ピクセルのデータを TransferType 型のプリミティブ配列として返します。
 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 配列として返します。
 int[] getPixels(int x, int y, int w, int h, int[] iArray, DataBuffer data)
          指定された矩形ピクセルサンプルを int 配列として返します。
 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 配列として返します。
 int[] getSampleSize()
          すべてのバンドのサンプルあたりのビット数を返します。
 int getSampleSize(int band)
          指定されたバンドのサンプルあたりのビット数を返します。
 int getScanlineStride()
          この ComponentSampleModel の走査線ストライドを返します。
 int hashCode()
          オブジェクトのハッシュコード値を返します。
 void setDataElements(int x, int y, Object obj, DataBuffer data)
          指定された DataBuffer にある単一ピクセルのデータを、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 がゼロ以下の場合
IllegalArgumentException - pixelStride が 0 未満の場合
IllegalArgumentException - scanlineStride が 0 未満の場合
IllegalArgumentException - numBands が 1 未満の場合
IllegalArgumentException - wh の積が 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 がゼロ以下の場合
IllegalArgumentException - pixelStride が 0 未満の場合
IllegalArgumentException - scanlineStride が 0 未満の場合
IllegalArgumentException - bankIndices の長さが bankOffsets の長さと等しくない場合
IllegalArgumentException - bankIndices のバンクインデックスのいずれがゼロより小さい場合
IllegalArgumentException - dataType がサポートされていない場合
メソッドの詳細

createCompatibleSampleModel

public SampleModel createCompatibleSampleModel(int w,
                                               int h)
指定された幅および高さで、新しい ComponentSampleModel を構築します。新しい SampleModel は、この SampleModel と同じ数のバンド、ストレージデータ型、インタリーブ化方式、およびピクセルストライドを持ちます。

定義:
クラス SampleModel 内の createCompatibleSampleModel
パラメータ:
w - 結果として返された SampleModel の幅
h - 結果として返された SampleModel の高さ
戻り値:
指定されたサイズを持つ新しい ComponentSampleModel
例外:
IllegalArgumentException - w または h がゼロ以下の場合

createSubsetSampleModel

public SampleModel createSubsetSampleModel(int[] bands)
この ComponentSampleModel のサブセットを持つ、新しい ComponentSampleModel を構築します。新しい ComponentSampleModel は、既存の ComponentSampleModel を使用できる任意の DataBuffer と組み合わせて使用できます。新しい ComponentSampleModel と DataBuffer の組み合わせは、元の ComponentSampleModel と DataBuffer の組み合わせにあるバンドのサブセットを持つイメージを表します。

定義:
クラス SampleModel 内の createSubsetSampleModel
パラメータ:
bands - この ComponentSampleModel のバンドのサブセット
戻り値:
この ComponentSampleModel のバンドのサブセットで作成された ComponentSampleModel

createDataBuffer

public DataBuffer createDataBuffer()
この ComponentSampleModel と対応する DataBuffer を作成します。DataBuffer のデータ型、バンク数、およびサイズは、この ComponentSampleModel と矛盾しません。

定義:
クラス SampleModel 内の createDataBuffer
戻り値:
この ComponentSampleModel とデータ型、バンク数、およびサイズが同じ DataBuffer

getOffset

public int getOffset(int x,
                     int y)
ピクセル (x, y) の最初のバンドのオフセットを返します。最初のバンドのサンプルは、DataBuffer data から、ComponentSampleModel csm を使って次のようにして取得できます。

        data.getElem(csm.getOffset(x, y));
 

パラメータ:
x, 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, y - 指定されたピクセルの位置
b - 指定されたバンド
戻り値:
指定されたピクセルの指定されたバンドのオフセット

getSampleSize

public final int[] getSampleSize()
すべてのバンドのサンプルあたりのビット数を返します。

定義:
クラス SampleModel 内の getSampleSize
戻り値:
配列内の各要素がバンドを表す、すべてのバンドのサンプルあたりのビット数を含む配列

getSampleSize

public final int getSampleSize(int band)
指定されたバンドのサンプルあたりのビット数を返します。

定義:
クラス SampleModel 内の getSampleSize
パラメータ:
指定されたバンド -
戻り値:
指定されたバンドのサンプルあたりのビット数

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 の場合は、バンド数と等しくなります。

定義:
クラス SampleModel 内の getNumDataElements
戻り値:
getDataElements メソッドと setDataElements メソッドにより 1 ピクセルを転送するために必要なデータ要素の数を返す
関連項目:
SampleModel.getNumDataElements(), SampleModel.getNumBands()

getDataElements

public Object getDataElements(int x,
                              int y,
                              Object obj,
                              DataBuffer data)
1 ピクセルのデータを TransferType 型のプリミティブ配列として返します。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);
 
2 つの SampleModel オブジェクトのバンド数が同じで、対応するバンドの 1 サンプルあたりのビット数が同じで、TransferType も同じ場合は、2 組の DataBufferSampleModel のペアの間で転送を行うには、getDataElements および setDataElements を使用するのが適切です。

objnull でない場合は、TransferType 型のプリミティブ配列になります。そうでない場合は、ClassCastException がスローされます。座標が境界内にない場合や、objnull でなく、ピクセルデータを格納するために十分な大きさでない場合は、ArrayIndexOutOfBoundsException がスローされます。

定義:
クラス SampleModel 内の getDataElements
パラメータ:
x, y - ピクセル位置の座標
obj - null でない場合は、返されたピクセルデータの入るプリミティブ配列
data - イメージデータを格納する DataBuffer
戻り値:
指定されたピクセルのデータ
例外:
NullPointerException - データが null の場合
ArrayIndexOutOfBoundsException - 座標が境界内にない場合、あるいは obj が出力を保持するには小さすぎる場合
関連項目:
setDataElements(int, int, Object, DataBuffer)

getPixel

public int[] getPixel(int x,
                      int y,
                      int[] iArray,
                      DataBuffer data)
指定されたピクセルのすべてのサンプルを int 配列として返します。配列要素にサンプル 1 個が対応します。座標が境界内にない場合は、ArrayIndexOutOfBoundsException がスローされることがあります。

オーバーライド:
クラス SampleModel 内の getPixel
パラメータ:
x, y - ピクセル位置の座標
iArray - null でない場合、この配列内のサンプルを返す
data - イメージデータを格納する DataBuffer
戻り値:
指定されたピクセルのサンプル
例外:
NullPointerException - データが 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 がスローされることがあります。

オーバーライド:
クラス SampleModel 内の getPixels
パラメータ:
x, 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 がスローされることがあります。

定義:
クラス SampleModel 内の getSample
パラメータ:
x, 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 がスローされることがあります。

オーバーライド:
クラス SampleModel 内の getSampleFloat
パラメータ:
x, y - ピクセル位置の座標
b - 返されるバンド
data - イメージデータを格納する DataBuffer
戻り値:
指定されたピクセルの指定されたバンド内のサンプルを表す float 値

getSampleDouble

public double getSampleDouble(int x,
                              int y,
                              int b,
                              DataBuffer data)
(x, y) に位置するピクセルの指定されたバンド内のサンプルを double として返します。座標が境界内にない場合は、ArrayIndexOutOfBoundsException がスローされることがあります。

オーバーライド:
クラス SampleModel 内の getSampleDouble
パラメータ:
x, 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 がスローされることがあります。

オーバーライド:
クラス SampleModel 内の getSamples
パラメータ:
x, 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 にある単一ピクセルのデータを、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);
 
2 つの SampleModel オブジェクトのバンド数が同じで、対応するバンドの 1 サンプルあたりのビット数が同じで、TransferType も同じ場合は、2 組の DataBufferSampleModel のペアの間で転送を行うには、getDataElements および setDataElements を使用するのが適切です。

objtransferType 型のプリミティブ配列でない場合は、ClassCastException がスローされます。座標が境界内にない場合や、obj がピクセルデータを格納するために十分な大きさでない場合は、ArrayIndexOutOfBoundsException がスローされます。

定義:
クラス SampleModel 内の setDataElements
パラメータ:
x, y - ピクセル位置の座標
obj - ピクセルデータを格納するプリミティブ配列
data - イメージデータを格納する DataBuffer
関連項目:
getDataElements(int, int, Object, DataBuffer)

setPixel

public void setPixel(int x,
                     int y,
                     int[] iArray,
                     DataBuffer data)
サンプルの int 配列を入力として使って DataBuffer 内のピクセルを設定します。座標が境界内にない場合は、ArrayIndexOutOfBoundsException がスローされることがあります。

オーバーライド:
クラス SampleModel 内の setPixel
パラメータ:
x, 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 がスローされることがあります。

オーバーライド:
クラス SampleModel 内の setPixels
パラメータ:
x, 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 がスローされることがあります。

定義:
クラス SampleModel 内の setSample
パラメータ:
x, 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 がスローされることがあります。

オーバーライド:
クラス SampleModel 内の setSample
パラメータ:
x, 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 がスローされることがあります。

オーバーライド:
クラス SampleModel 内の setSample
パラメータ:
x, 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 がスローされることがあります。

オーバーライド:
クラス SampleModel 内の setSamples
パラメータ:
x, 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 以外のオブジェクト参照での同値関係を実装します。

Object クラスの equals メソッドは、もっとも比較しやすいオブジェクトの同値関係を実装します。つまり、null 以外の参照値 xy について、このメソッドは xy が同じオブジェクトを参照する (x == ytrue) 場合にだけ true を返します。

通常、このメソッドをオーバーライドする場合は、hashCode メソッドを常にオーバーライドして、「等価なオブジェクトは等価なハッシュコードを保持する必要がある」という hashCode メソッドの汎用規約に従う必要があることに留意してください。

オーバーライド:
クラス Object 内の equals
パラメータ:
o - 比較対象の参照オブジェクト
戻り値:
obj 引数に指定されたオブジェクトとこのオブジェクトが等しい場合は true、そうでない場合は false
関連項目:
Object.hashCode(), Hashtable

hashCode

public int hashCode()
クラス Object の記述:
オブジェクトのハッシュコード値を返します。このメソッドは、java.util.Hashtable によって提供されるようなハッシュテーブルで使用するために用意されています。

hashCode メソッドの一般的な規則を次に示します。

できるかぎり、Object クラスで定義される hashCode メソッドは、異なるオブジェクトについては異なる整数値を返します。通常、これはオブジェクトの内部アドレスを整数値に変換する形で実装されますが、そのような実装テクニックは JavaTM プログラミング言語では不要です。

オーバーライド:
クラス Object 内の hashCode
戻り値:
このオブジェクトのハッシュコード値
関連項目:
Object.equals(java.lang.Object), Hashtable

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。