java.awt.image
クラス PixelInterleavedSampleModel

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

public class PixelInterleavedSampleModel
extends ComponentSampleModel

このクラスは、ピクセルインタリーブ化方式で格納され、ピクセルの各サンプルが DataBuffer の 1 データ要素を占めるイメージデータを表します。このクラスは、ComponentSampleModel をサブクラス化しますが、ピクセルインタリーブ化されたイメージデータへのアクセスに、ComponentSampleModel を使うよりも効率的な実装を提供します。このクラスは、すべてのバンドのサンプルデータを DataBuffer の単一バンクに格納します。イメージデータを直接処理できるように、アクセス用メソッドが提供されています。ピクセルストライドは、同じ走査線上の同じバンドにある 2 つのサンプルの間にあるデータ配列要素数です。走査線ストライドは、指定されたサンプルと次の走査線の同じ列の対応するサンプルとの間のデータ配列要素の数です。バンドオフセットは、各バンドが格納されている DataBuffer のバンクにある最初のデータ配列要素からそのバンドの最初のサンプルまでのデータ配列要素数を示します。バンドには、0 〜 N-1 の範囲の番号が付けられています。 バンクインデックスは、データバッファーのバンクと、イメージデータのバンドとの対応を示します。このクラスは、TYPE_BYTE、TYPE_USHORT、TYPE_SHORT、TYPE_INT、TYPE_FLOAT、および TYPE_DOUBLE の各データ型をサポートします。

フィールドの概要

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

bandOffsets, bankIndices, numBands, numBanks, pixelStride, scanlineStride

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

dataType, height, width

コンストラクタの概要

PixelInterleavedSampleModel(int dataType, int w, int h, int pixelStride, int scanlineStride, int[] bandOffsets)
指定されたパラメータを持つ PixelInterleavedSampleModel を構築します。

メソッドの概要

SampleModel	createCompatibleSampleModel(int w, int h) 指定された幅と高さを持つ新しい PixelInterleavedSampleModel を生成します。
SampleModel	createSubsetSampleModel(int[] bands) この PixelInterleavedSampleModel のバンドのサブセットを持つ新しい PixelInterleavedSampleModel を生成します。
int	hashCode() オブジェクトのハッシュコード値を返します。

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

createDataBuffer, equals, getBandOffsets, getBankIndices, getDataElements, getNumDataElements, getOffset, getOffset, getPixel, getPixels, getPixelStride, getSample, getSampleDouble, getSampleFloat, getSamples, getSampleSize, getSampleSize, getScanlineStride, setDataElements, setPixel, setPixels, setSample, setSample, setSample, setSamples

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

コンストラクタの詳細

PixelInterleavedSampleModel

public PixelInterleavedSampleModel(int dataType,
                                   int w,
                                   int h,
                                   int pixelStride,
                                   int scanlineStride,
                                   int[] bandOffsets)

指定されたパラメータを持つ PixelInterleavedSampleModel を構築します。バンド数は、bandOffsets 配列の長さによって指定されます。

パラメータ:

dataType - サンプルの格納のためのデータ型

w - 記述されたイメージデータの領域の幅 (単位はピクセル)

h - 記述されたイメージデータの領域の高さ (単位はピクセル)

pixelStride - イメージデータのピクセルストライド

scanlineStride - イメージデータの走査線ストライド

bandOffsets - すべてのバンドのオフセット

例外:

IllegalArgumentException - w または h がゼロ以下の場合

IllegalArgumentException - バンド間のオフセットのいずれかが走査線ストライドより大きい場合

IllegalArgumentException - pixelStride と w の積が scanlineStride より大きい場合

IllegalArgumentException - pixelStride がバンド間のオフセットより小さい場合

IllegalArgumentException - dataType がサポートされているデータ型でない場合

メソッドの詳細

createCompatibleSampleModel

public SampleModel createCompatibleSampleModel(int w,
                                               int h)

指定された幅と高さを持つ新しい PixelInterleavedSampleModel を生成します。新しい PixelInterleavedSampleModel は、この PixelInterleavedSampleModel と同じバンド数、ストレージデータ型、ピクセルストライドを持ちます。バンドオフセットは、すべてのバンドオフセットの最小値がゼロになるように圧縮できます。

オーバーライド:

クラス ComponentSampleModel 内の createCompatibleSampleModel

パラメータ:

w - 結果として得られる SampleModel の幅

h - 結果として得られる SampleModel の高さ

戻り値:

指定された幅と高さを持つ新しい SampleModel

例外:

IllegalArgumentException - w または h がゼロ以下の場合

createSubsetSampleModel

public SampleModel createSubsetSampleModel(int[] bands)

この PixelInterleavedSampleModel のバンドのサブセットを持つ新しい PixelInterleavedSampleModel を生成します。新しい PixelInterleavedSampleModel は、既存の PixelInterleavedSampleModel と組み合わせて使用できる DataBuffer であればどの DataBuffer とも組み合わせて使用できます。新しい PixelInterleavedSampleModel と DataBuffer の組み合わせは、元の組み合わせのバンドのサブセットを持つイメージを表します。

オーバーライド:

クラス ComponentSampleModel 内の createSubsetSampleModel

パラメータ:

bands - この ComponentSampleModel のバンドのサブセット

戻り値:

この ComponentSampleModel のバンドのサブセットで作成された ComponentSampleModel

hashCode

public int hashCode()

クラス Object の記述:

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

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

• Java アプリケーションの実行中に同じオブジェクト上で複数回呼び出される場合は必ず、このオブジェクトに対する equals による比較で使われた情報が変更されていなければ、hashCode メソッドは同じ整数を一貫して返さなければならない。ただし、この整数は同じアプリケーションの実行ごとに同じである必要はない
• equals(Object) メソッドで 2 つのオブジェクトが等価とされた場合、どちらのオブジェクトで hashCode メソッドを呼び出しても結果は同じ整数値にならなければならない
• Object.equals(java.lang.Object) メソッドで 2 つのオブジェクトが等価でないとされた場合は、これらのオブジェクトに対して hashCode メソッドを呼び出したときに、結果が異なる整数値にならなくてもかまわない。しかし、等しくないオブジェクトについては異なる整数値が生成されるようにすれば、ハッシュテーブルのパフォーマンスを上げることができる

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

オーバーライド:

クラス ComponentSampleModel 内の hashCode

戻り値:

このオブジェクトのハッシュコード値

関連項目:

Object.equals(java.lang.Object), Hashtable