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 を構築します。

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

createDataBuffer, 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, equals, finalize, getClass, hashCode, 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 が 0 以下の場合

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 の高さ

例外:

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

createSubsetSampleModel

public SampleModel createSubsetSampleModel(int[] bands)

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

オーバーライド:

クラス ComponentSampleModel 内の createSubsetSampleModel