java.awt.image
クラス ComponentColorModel

java.lang.Object
  |
  +--java.awt.image.ColorModel
        |
        +--java.awt.image.ComponentColorModel

すべての実装インタフェース:

Transparency

public class ComponentColorModel

extends ColorModel

これは ColorModel クラスの 1 つで、ピクセル値を扱います。このピクセル値は、色情報およびアルファ情報を個別のサンプルとして表現し、各サンプルを個別のデータ要素に格納します。このクラスは、任意の ColorSpace とともに使用できます。ピクセル値に含むカラーサンプルの数は、ColorSpace にある色成分の数と等しくなければなりません。アルファサンプルは、単一でもかまいません。

transferType 型のプリミティブ配列ピクセル表現を使うメソッドの場合、配列の長さはカラーサンプルおよびアルファサンプルの数と等しくなります。配列にはカラーサンプルが最初に格納され、アルファサンプルがあれば、そのあとに格納されます。カラーサンプルの順序は、ColorSpace で指定します。通常、この順序はカラースペースタイプの名前を反映します。たとえば、TYPE_RGB のインデックス 0 は赤、インデックス 1 は緑、そしてインデックス 2 は青になります。サポートされる転送タイプは、DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、および DataBuffer.TYPE_INT です。

表示、あるいはイメージ処理のためにピクセル値を色成分またはアルファ成分に変換する処理は、サンプルと成分の 1 対 1 対応になります。ピクセル値のカラーサンプルまたはアルファサンプルのビット数は、ComponentColorModel コンストラクタに渡された、対応する色成分またはアルファ成分のビット数と異なる場合があります。このクラスは、サンプル値の最下位 n ビットが成分の値を格納していると見なします。このとき n は、コンストラクタに渡された成分の有効ビットの数です。また、より上位にあるサンプル値の任意のビットについては、すべて 0 であると見なされます。

ComponentColorModel で使う成分の数が 1 (つまり、単一の色成分のみで、アルファ成分がない) 以外の場合は、単一の int ピクセル表示を使うメソッドは IllegalArgumentException をスローします。

ComponentColorModel は、ComponentSampleModel、BandedSampleModel、または PixelInterleavedSampleModel と組み合わせて、BufferedImage の作成に使えます。

関連項目:

ColorModel, ColorSpace, ComponentSampleModel, BandedSampleModel, PixelInterleavedSampleModel, BufferedImage

クラス java.awt.image.ColorModel から継承したフィールド

pixel_bits, transferType

インタフェース java.awt.Transparency から継承したフィールド

BITMASK, OPAQUE, TRANSLUCENT

コンストラクタの概要

ComponentColorModel(ColorSpace colorSpace, int[] bits, boolean hasAlpha, boolean isAlphaPremultiplied, int transparency, int transferType)
指定されたパラメータから、ComponentColorModel を構築します。

メソッドの概要

ColorModel	coerceData(WritableRaster raster, boolean isAlphaPremultiplied) ラスタデータが isAlphaPremultiplied 変数で指定された状態と一致するようにします。
SampleModel	createCompatibleSampleModel(int w, int h) 指定された幅および高さで、この ColorModel と互換性のあるデータレイアウトを持つ SampleModel を作成します。
WritableRaster	createCompatibleWritableRaster(int w, int h) 指定された幅および高さで、この ColorModel と互換性のあるデータレイアウト (SampleModel) を持つ WritableRaster を作成します。
boolean	equals(Object obj) このカラーモデルと別のカラーモデルとが等しいかどうかを比較します。
int	getAlpha(int pixel) 指定されたピクセルのアルファ成分を、0 〜 255 の範囲でスケーリングして返します。
int	getAlpha(Object inData) 指定されたピクセルのアルファ成分を 0 〜 255 の範囲でスケーリングして返します。
WritableRaster	getAlphaRaster(WritableRaster raster) イメージのアルファチャネルを表現する Raster を、入力された Raster から抽出して返します。
int	getBlue(int pixel) 指定されたピクセルの青成分をデフォルトの RGB ColorSpace (sRGB) で 0 〜 255 の範囲でスケーリングして返します。
int	getBlue(Object inData) 指定されたピクセルの青色成分を、デフォルトの RGB ColorSpace (sRGB) で 0 〜 255 の範囲でスケーリングして返します。
int[]	getComponents(int pixel, int[] components, int offset) この ColorModel のピクセルを指定して、非正規化された色成分またはアルファ成分の配列を返します。
int[]	getComponents(Object pixel, int[] components, int offset) この ColorModel のピクセルを指定して、標準化されていない色成分またはアルファ成分の配列を返します。
int	getDataElement(int[] components, int offset) 非正規化された色成分あるいはアルファ成分の配列を指定して、この ColorModel の int として表現されるピクセル値を返します。
Object	getDataElements(int[] components, int offset, Object obj) 非正規化された色成分またはアルファ成分の配列を指定して、この ColorModel のピクセルのデータ要素配列表現を返します。
Object	getDataElements(int rgb, Object pixel) デフォルトの RGB カラーモデルの int ピクセル表現を指定して、この ColorModel のピクセルデータ要素配列表現を返します。
int	getGreen(int pixel) 指定されたピクセルの緑成分をデフォルトの RGB ColorSpace (sRGB) で 0 〜 255 の範囲でスケーリングして返します。
int	getGreen(Object inData) 指定されたピクセルの緑色成分を、デフォルトの RGB ColorSpace (sRGB) で 0 〜 255 の範囲でスケーリングして返します。
int	getRed(int pixel) 指定されたピクセルの赤成分をデフォルトの RGB ColorSpace (sRGB) で 0 〜 255 の範囲でスケーリングして返します。
int	getRed(Object inData) 指定されたピクセルの赤色成分を、デフォルトの RGB ColorSpace (sRGB) で 0 〜 255 の範囲でスケーリングして返します。
int	getRGB(int pixel) デフォルトの RGB カラーモデル形式で、ピクセルの色成分またはアルファ成分を返します。
int	getRGB(Object inData) デフォルトの RGB カラーモデル形式で、ピクセルの色成分またはアルファ成分を返します。
boolean	isCompatibleRaster(Raster raster) raster がこの ColorModel と互換性がある場合に true を返し、そうでない場合は false を返します。
boolean	isCompatibleSampleModel(SampleModel sm) 指定された SampleModel がこの ColorModel と互換性があるかどうかを判定します。

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

finalize, getColorSpace, getComponentSize, getComponentSize, getNormalizedComponents, getNumColorComponents, getNumComponents, getPixelSize, getRGBdefault, getTransferType, getTransparency, getUnnormalizedComponents, hasAlpha, hashCode, isAlphaPremultiplied, toString

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

clone, getClass, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

ComponentColorModel

public ComponentColorModel(ColorSpace colorSpace,
                           int[] bits,
                           boolean hasAlpha,
                           boolean isAlphaPremultiplied,
                           int transparency,
                           int transferType)

指定されたパラメータから、ComponentColorModel を構築します。色成分は、指定された ColorSpace に入ります。bits 配列は、色成分およびアルファ成分ごとの有効ビット数を指定します。ピクセル値にアルファ情報がない場合、配列の長さは ColorSpace にある成分数になります。また、アルファ情報がある場合は、成分数よりも 1 大きくなります。配列の長さが成分の数と一致しない場合は、IllegalArgumentException がスローされます。hasAlpha は、アルファ情報の有無を示します。hasAlpha が true の場合、boolean 型の isAlphaPremultiplied は、ピクセル値にあるカラーサンプルおよびアルファサンプルを評価する方法を指定します。boolean が true の場合は、カラーサンプルはアルファサンプルと乗算されたと見なされます。transparency は、このカラーモデルで表現できるアルファ値を指定します。許容されている transparency 値は、OPAQUE、BITMASK または TRANSLUCENT です。transferType は、ピクセル値を表現するために使うプリミティブ配列の型です。bits 配列には、ピクセル値から変換されたあとの、色成分およびアルファ成分ごとの有効ビット数が格納されます。

パラメータ:

colorSpace - このカラーモデルに関連した ColorSpace

bits - 1 成分当たりの有効ビット数

hasAlpha - true の場合、このカラーモデルはアルファをサポートする

isAlphaPremultiplied - true の場合、アルファはあらかじめ乗算されている

transparency - このカラーモデルで表すことができるアルファ値を指定する

transferType - ピクセル値を表現するために使われるプリミティブ配列の型を指定する

例外:

IllegalArgumentException - bits 配列の長さが成分数と一致しない場合

関連項目:

ColorSpace, Transparency

メソッドの詳細

getRed

public int getRed(int pixel)

指定されたピクセルの赤成分をデフォルトの RGB ColorSpace (sRGB) で 0 〜 255 の範囲でスケーリングして返します。必要な場合は、色変換が行われます。ピクセルの値は int として指定されます。戻り値は、あらかじめ乗算されていない値です。アルファがあらかじめ乗算されている場合、このメソッドは値を返す前にアルファを除算します。アルファ値が 0 の場合、赤の値は 0 になります。

オーバーライド:

クラス ColorModel 内の getRed

パラメータ:

pixel - 赤色成分を取得するピクセル

戻り値:

指定されたピクセルの赤色成分 (int)

例外:

IllegalArgumentException - この ColorModel に 2 つ以上の成分がある場合

getGreen

public int getGreen(int pixel)

指定されたピクセルの緑成分をデフォルトの RGB ColorSpace (sRGB) で 0 〜 255 の範囲でスケーリングして返します。必要な場合は、色変換が行われます。ピクセルの値は int として指定されます。戻り値は、あらかじめ乗算されていない値です。アルファがあらかじめ乗算されている場合、このメソッドは値を返す前にアルファを除算します。アルファ値が 0 の場合、緑の値は 0 になります。

オーバーライド:

クラス ColorModel 内の getGreen

パラメータ:

pixel - 緑色成分を取得するピクセル

戻り値:

指定されたピクセルの緑色成分 (int)

例外:

IllegalArgumentException - この ColorModel に 2 つ以上の成分がある場合

getBlue

public int getBlue(int pixel)

指定されたピクセルの青成分をデフォルトの RGB ColorSpace (sRGB) で 0 〜 255 の範囲でスケーリングして返します。必要な場合は、色変換が行われます。ピクセルの値は int として指定されます。戻り値は、あらかじめ乗算されていない値です。アルファがあらかじめ乗算されている場合、このメソッドは値を返す前にアルファを除算します。アルファ値が 0 の場合、青の値は 0 になります。

オーバーライド:

クラス ColorModel 内の getBlue

パラメータ:

pixel - 青色成分を取得するピクセル

戻り値:

指定されたピクセルの青色成分 (int)

例外:

IllegalArgumentException - この ColorModel に 2 つ以上の成分がある場合

getAlpha

public int getAlpha(int pixel)

指定されたピクセルのアルファ成分を、0 〜 255 の範囲でスケーリングして返します。ピクセル値は int として指定されます。

オーバーライド:

クラス ColorModel 内の getAlpha

パラメータ:

pixel - アルファ成分を取得するピクセル

戻り値:

指定されたピクセルのアルファ成分 (int)

例外:

IllegalArgumentException - この ColorModel に 2 つ以上の成分がある場合

getRGB

public int getRGB(int pixel)

デフォルトの RGB カラーモデル形式で、ピクセルの色成分またはアルファ成分を返します。必要な場合は、色変換が行われます。戻り値は、あらかじめ乗算されていない値です。アルファがあらかじめ乗算されている場合、このメソッドは値を返す前にアルファを色成分で除算します。アルファ値が 0 の場合、カラー値も 0 になります。

オーバーライド:

クラス ColorModel 内の getRGB

パラメータ:

pixel - 色成分またはアルファ成分を取得するピクセル

戻り値:

指定されたピクセルの色成分またはアルファ成分 (int)

例外:

IllegalArgumentException - この ColorModel に 2 つ以上の成分がある場合

getRed

public int getRed(Object inData)

指定されたピクセルの赤色成分を、デフォルトの RGB ColorSpace (sRGB) で 0 〜 255 の範囲でスケーリングして返します。必要な場合は、色変換が行われます。pixel 値は、オブジェクト参照として渡された transferType 型のデータ要素からなる配列によって指定されます。戻り値は、あらかじめ乗算されていない値です。アルファがあらかじめ乗算されている場合、このメソッドは値を返す前にアルファを除算します。アルファ値が 0 の場合、赤の値は 0 になります。ComponentColorModel はサブクラス化できるので、サブクラスがこのメソッドの実装を継承しますが、サブクラスがその実装をオーバーライドしないで、しかもサポートされていない transferType を使用した場合、例外がスローされます。

オーバーライド:

クラス ColorModel 内の getRed

パラメータ:

inData - 赤色成分を取得するピクセル。transferType 型のデータ要素の配列で指定する

戻り値:

指定されたピクセルの赤色成分 (int)

例外:

ClassCastException - inData が transferType 型のプリミティブ配列でない場合

ArrayIndexOutOfBoundsException - inData がこの ColorModel のピクセル値を保持するのに十分な大きさでない場合

UnsupportedOperationException - この ComponentColorModel の転送型が、サポートされている転送型 (DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、または DataBuffer.TYPE_INT) でない場合

getGreen

public int getGreen(Object inData)

指定されたピクセルの緑色成分を、デフォルトの RGB ColorSpace (sRGB) で 0 〜 255 の範囲でスケーリングして返します。必要な場合は、色変換が行われます。pixel 値は、オブジェクト参照として渡された transferType 型のデータ要素からなる配列によって指定されます。戻り値は、あらかじめ乗算されていない値です。アルファがあらかじめ乗算されている場合、このメソッドは値を返す前にアルファを除算します。アルファ値が 0 の場合、緑の値は 0 になります。ComponentColorModel はサブクラス化できるので、サブクラスはこのメソッドの実装を継承しますが、サブクラスがその実装をオーバーライドしないで、しかもサポートされていない transferType を使用した場合、例外がスローされます。

オーバーライド:

クラス ColorModel 内の getGreen

パラメータ:

inData - 緑色成分を取得するピクセル。transferType 型のデータ要素の配列で指定する

戻り値:

指定されたピクセルの緑色成分 (int)

例外:

ClassCastException - inData が transferType 型のプリミティブ配列でない場合

ArrayIndexOutOfBoundsException - inData がこの ColorModel のピクセル値を保持するのに十分な大きさでない場合

UnsupportedOperationException - この ComponentColorModel の転送型が、サポートされている転送型 (DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、または DataBuffer.TYPE_INT) でない場合

getBlue

public int getBlue(Object inData)

指定されたピクセルの青色成分を、デフォルトの RGB ColorSpace (sRGB) で 0 〜 255 の範囲でスケーリングして返します。必要な場合は、色変換が行われます。pixel 値は、オブジェクト参照として渡された transferType 型のデータ要素からなる配列によって指定されます。戻り値は、あらかじめ乗算されていない値です。アルファがあらかじめ乗算されている場合、このメソッドは値を返す前にアルファを除算します。アルファ値が 0 の場合、青の値は 0 になります。ComponentColorModel はサブクラス化できるので、サブクラスはこのメソッドの実装を継承しますが、サブクラスがその実装をオーバーライドしないで、しかもサポートされていない transferType を使用した場合、例外がスローされます。

オーバーライド:

クラス ColorModel 内の getBlue

パラメータ:

inData - 青色成分を取得するピクセル。transferType 型のデータ要素の配列で指定する

戻り値:

指定されたピクセルの青色成分 (int)

例外:

ClassCastException - inData が transferType 型のプリミティブ配列でない場合

ArrayIndexOutOfBoundsException - inData がこの ColorModel のピクセル値を保持するのに十分な大きさでない場合

UnsupportedOperationException - この ComponentColorModel の転送型が、サポートされている転送型 (DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、または DataBuffer.TYPE_INT) でない場合

getAlpha

public int getAlpha(Object inData)

指定されたピクセルのアルファ成分を 0 〜 255 の範囲でスケーリングして返します。ピクセルの値は、オブジェクト参照として渡された transferType 型のデータ要素からなる配列によって指定されます。ComponentColorModel はサブクラス化できるので、サブクラスはこのメソッドの実装を継承しますが、サブクラスがその実装をオーバーライドしないで、しかもサポートされていない transferType を使用した場合、例外がスローされます。

オーバーライド:

クラス ColorModel 内の getAlpha

パラメータ:

inData - アルファ成分を取得するピクセル。transferType 型のデータ要素の配列で指定する

戻り値:

指定されたピクセルのアルファ成分 (int)

例外:

ClassCastException - inData が transferType 型のプリミティブ配列でない場合

ArrayIndexOutOfBoundsException - inData がこの ColorModel のピクセル値を保持するのに十分な大きさでない場合

UnsupportedOperationException - この ComponentColorModel の転送型が、サポートされている転送型 (DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、または DataBuffer.TYPE_INT) でない場合

getRGB

public int getRGB(Object inData)

デフォルトの RGB カラーモデル形式で、ピクセルの色成分またはアルファ成分を返します。必要な場合は、色変換が行われます。ピクセルの値は、オブジェクト参照として渡された transferType 型のデータ要素からなる配列によって指定されます。戻り値は、あらかじめ乗算されていない値です。アルファがあらかじめ乗算されていた場合、このメソッドは色成分でアルファを除算します。アルファ値が 0 の場合、カラー値は 0 になります。ComponentColorModel はサブクラス化できるので、サブクラスはこのメソッドの実装を継承しますが、サブクラスがその実装をオーバーライドしないで、しかもサポートされていない transferType を使用した場合、例外がスローされます。

オーバーライド:

クラス ColorModel 内の getRGB

パラメータ:

inData - 色成分またはアルファ成分を取得するピクセル。transferType 型のデータ要素の配列で指定する

戻り値:

指定されたピクセルの色成分またはアルファ成分 (int)

例外:

ClassCastException - inData が transferType 型のプリミティブ配列でない場合

ArrayIndexOutOfBoundsException - inData がこの ColorModel のピクセル値を保持するのに十分な大きさでない場合

UnsupportedOperationException - この ComponentColorModel の転送型が、サポートされている転送型 (DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、または DataBuffer.TYPE_INT) でない場合

関連項目:

ColorModel.getRGBdefault()

getDataElements

public Object getDataElements(int rgb,
                              Object pixel)

デフォルトの RGB カラーモデルの int ピクセル表現を指定して、この ColorModel のピクセルデータ要素配列表現を返します。その後この配列は、WritableRaster オブジェクトの setDataElements メソッドに渡すことができます。pixel パラメータが null である場合は、新しい配列が割り当てられます。ComponentColorModel はサブクラス化できるので、サブクラスはこのメソッドの実装を継承しますが、サブクラスがその実装をオーバーライドしないで、しかもサポートされていない transferType を使用した場合、例外がスローされます。

オーバーライド:

クラス ColorModel 内の getDataElements

パラメータ:

rgb -

pixel - ピクセルの整数表現

例外:

ClassCastException - pixel が null でなく、transferType 型のプリミティブ配列でないとき

ArrayIndexOutOfBoundsException - pixel がこの ColorModel のピクセル値を保持するのに十分な大きさでない場合

UnsupportedOperationException - この ComponentColorModel の転送型が、サポートされている転送型 (DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、または DataBuffer.TYPE_INT) でない場合

関連項目:

WritableRaster.setDataElements(int, int, java.lang.Object), SampleModel.setDataElements(int, int, java.lang.Object, java.awt.image.DataBuffer)

getComponents

public int[] getComponents(int pixel,
                           int[] components,
                           int offset)

この ColorModel のピクセルを指定して、非正規化された色成分またはアルファ成分の配列を返します。色成分やアルファ成分は、components 配列の offset の位置から格納されます。これは、配列がこのメソッドによって割り当てられた場合でも同じです。

オーバーライド:

クラス ColorModel 内の getComponents

パラメータ:

pixel - 整数で指定されるピクセル値

components - 標準化されていない色成分またはアルファ成分を格納する int 配列。components 配列が null の場合は、新しい配列が割り当てられる

offset - components 配列内のオフセット

戻り値:

components 配列

例外:

IllegalArgumentException - この ColorModel に 2 つ以上の成分がある場合

ArrayIndexOutOfBoundsException - components 配列が null でない場合に、offset からのすべての色成分およびアルファ成分を保持するのに十分な大きさでないとき

getComponents

public int[] getComponents(Object pixel,
                           int[] components,
                           int offset)

この ColorModel のピクセルを指定して、標準化されていない色成分またはアルファ成分の配列を返します。pixel の値は、オブジェクト参照として渡された transferType 型のデータ要素による配列で指定されます。色成分やアルファ成分は、components 配列の offset の位置から格納されます。これは、配列がこのメソッドによって割り当てられた場合でも同じです。ComponentColorModel はサブクラス化できるので、サブクラスはこのメソッドの実装を継承しますが、サブクラスがその実装をオーバーライドしないで、しかもサポートされていない transferType を使用した場合、このメソッドは例外をスローすることがあります。

オーバーライド:

クラス ColorModel 内の getComponents

パラメータ:

pixel - transferType 型のデータ要素の配列で指定されるピクセル値

components - 標準化されていない色成分またはアルファ成分を格納する int 配列。components 配列が null の場合は、新しい配列が割り当てられる

offset - components 配列内のオフセット

戻り値:

components 配列

例外:

UnsupportedOperationException - この ComponentColorModel の転送型が、サポートされている転送型 (DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、または DataBuffer.TYPE_INT) でない場合

ClassCastException - pixel が transferType 型のプリミティブ配列でない場合

IllegalArgumentException - components 配列が null でない場合に、offset からのすべての色成分およびアルファ成分を保持するのに十分な大きさでないとき。あるいは、pixel がこの ColorModel のピクセル値を保持するのに十分な大きさでない場合

getDataElement

public int getDataElement(int[] components,
                          int offset)

非正規化された色成分あるいはアルファ成分の配列を指定して、この ColorModel の int として表現されるピクセル値を返します。

オーバーライド:

クラス ColorModel 内の getDataElement

パラメータ:

components - 標準化されていない色成分またはアルファ成分の配列

offset - components 配列内のオフセット

戻り値:

int で表現されたピクセル値

例外:

IllegalArgumentException - この ColorModel に 2 つ以上の成分がある場合

getDataElements

public Object getDataElements(int[] components,
                              int offset,
                              Object obj)

非正規化された色成分またはアルファ成分の配列を指定して、この ColorModel のピクセルのデータ要素配列表現を返します。この配列は、WritableRaster オブジェクトの setDataElements メソッドに渡すことができます。

オーバーライド:

クラス ColorModel 内の getDataElements

パラメータ:

components - 標準化されていない色成分またはアルファ成分の配列

offset - components 配列内の int オフセット

obj - ピクセルのデータ要素配列表現を格納するオブジェクト。obj 変数が null の場合は、新しい配列が割り当てられる。obj が null でない場合は、transferType 型のプリミティブ配列でなければならない。obj がこの ColorModel のピクセル値を保持するのに十分な大きさでない場合は、ArrayIndexOutOfBoundsException がスローされる。ComponentColorModel はサブクラス化できるので、サブクラスはこのメソッドの実装を継承するが、サブクラスがその実装をオーバーライドしないで、しかもサポートされていない transferType を使用した場合、例外がスローされる

戻り値:

この ColorModel のピクセルのデータ要素配列表現

例外:

IllegalArgumentException - components 配列が、offset からのすべての色成分およびアルファ成分を保持するのに十分な大きさでない場合

ClassCastException - obj が null でなく、transferType 型のプリミティブ配列でないとき

ArrayIndexOutOfBoundsException - obj がこの ColorModel のピクセル値を保持するのに十分な大きさでない場合

UnsupportedOperationException - この ComponentColorModel の転送型が、サポートされている転送型 (DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、または DataBuffer.TYPE_INT) でない場合

関連項目:

WritableRaster.setDataElements(int, int, java.lang.Object), SampleModel.setDataElements(int, int, java.lang.Object, java.awt.image.DataBuffer)

coerceData

public ColorModel coerceData(WritableRaster raster,
                             boolean isAlphaPremultiplied)

ラスタデータが isAlphaPremultiplied 変数で指定された状態と一致するようにします。このとき、データはこの ColorModel によって現在正しく記述されていると見なされます。このメソッドは、カラーラスタデータをアルファで乗算または除算します。データが正しい状態にある場合には、処理は行いません。データが強制的に型変換される必要がある場合、このメソッドは isAlphaPremultiplied フラグを正しく設定した、この ColorModel のインスタンスも返します。ColorModel はサブクラス化できるので、サブクラスはこのメソッドの実装を継承しますが、サブクラスがその実装をオーバーライドしないで、しかもサポートされていない transferType を使用した場合、例外がスローされます。

オーバーライド:

クラス ColorModel 内の coerceData

例外:

NullPointerException - raster が null で、強制変換が必要な場合

UnsupportedOperationException - この ComponentColorModel の転送型が、サポートされている転送型 (DataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、または DataBuffer.TYPE_INT) でない場合

isCompatibleRaster

public boolean isCompatibleRaster(Raster raster)

raster がこの ColorModel と互換性がある場合に true を返し、そうでない場合は false を返します。

オーバーライド:

クラス ColorModel 内の isCompatibleRaster

パラメータ:

raster - 互換性を判定する Raster オブジェクト

戻り値:

raster がこの ColorModel と互換性がある場合は true、そうでない場合は false

createCompatibleWritableRaster

public WritableRaster createCompatibleWritableRaster(int w,
                                                     int h)

指定された幅および高さで、この ColorModel と互換性のあるデータレイアウト (SampleModel) を持つ WritableRaster を作成します。

オーバーライド:

クラス ColorModel 内の createCompatibleWritableRaster

パラメータ:

w - 生成する WritableRaster の幅

h - 生成する WritableRaster の高さ

戻り値:

この ColorModel と互換性のある WritableRaster

関連項目:

WritableRaster, SampleModel

createCompatibleSampleModel

public SampleModel createCompatibleSampleModel(int w,
                                               int h)

指定された幅および高さで、この ColorModel と互換性のあるデータレイアウトを持つ SampleModel を作成します。

オーバーライド:

クラス ColorModel 内の createCompatibleSampleModel

パラメータ:

w - 生成する SampleModel の幅

h - 生成する SampleModel の高さ

戻り値:

この ColorModel と互換性のある SampleModel

関連項目:

SampleModel

isCompatibleSampleModel

public boolean isCompatibleSampleModel(SampleModel sm)

指定された SampleModel がこの ColorModel と互換性があるかどうかを判定します。

オーバーライド:

クラス ColorModel 内の isCompatibleSampleModel

パラメータ:

sm - 互換性を判定する SampleModel

戻り値:

SampleModel がこの ColorModel と互換性がある場合は true、そうでない場合は false

関連項目:

SampleModel

getAlphaRaster

public WritableRaster getAlphaRaster(WritableRaster raster)

イメージのアルファチャネルを表現する Raster を、入力された Raster から抽出して返します。このメソッドは、この ColorModel に関連した Raster オブジェクトにアルファバンドがあれば、そのアルファバンドをイメージデータの最終バンドとして格納していると見なします。この ColorModel に関連した空間アルファチャネルがほかにない場合は、null を返します。このメソッドは新しい Raster を作成しますが、データ配列は共有することになります。

オーバーライド:

クラス ColorModel 内の getAlphaRaster

パラメータ:

raster - アルファチャネルを抽出する WritableRaster

戻り値:

イメージのアルファチャネルが格納されている WritableRaster

equals

public boolean equals(Object obj)

このカラーモデルと別のカラーモデルとが等しいかどうかを比較します。

オーバーライド:

クラス ColorModel 内の equals

パラメータ:

obj - このカラーモデルと比較するオブジェクト

戻り値:

2 つのカラーモデルオブジェクトが等しい場合は true、そうでない場合は false