モジュール java.desktop

パッケージ javax.imageio

クラスImageTypeSpecifier

java.lang.Object

javax.imageio.ImageTypeSpecifier

public class ImageTypeSpecifier extends Object

イメージの形式、特にSampleModelとColorModelを、便利な方法で指定できるようにするクラスです。

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
protected ColorModel	colorModel	プロトタイプとして使用するColorModelです。
protected SampleModel	sampleModel	プロトタイプとして使用するSampleModelです。

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
ImageTypeSpecifier(ColorModel colorModel, SampleModel sampleModel)	ColorModelとSampleModelから直接ImageTypeSpecifierを構築します。
ImageTypeSpecifier(RenderedImage image)	RenderedImageからImageTypeSpecifierを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
static ImageTypeSpecifier	createBanded(ColorSpace colorSpace, int[] bankIndices, int[] bandOffsets, int dataType, boolean hasAlpha, boolean isAlphaPremultiplied)	ComponentColorModelとBandedSampleModelを使用する、バンドされたイメージ形式の指示子を返して、各チャネルを別々の配列に格納します。
BufferedImage	createBufferedImage(int width, int height)	このオブジェクトに取り入れられた指定に従って、指定された幅と高さのBufferedImageを作成します。
static ImageTypeSpecifier	createFromBufferedImageType(int bufferedImageType)	標準BufferedImage形式の1つ(TYPE_CUSTOM以外)を符号化するImageTypeSpecifierを返します。
static ImageTypeSpecifier	createFromRenderedImage(RenderedImage image)	RenderedImage (BufferedImageの場合もあります)の配置を符号化するImageTypeSpecifierを返します。
static ImageTypeSpecifier	createGrayscale(int bits, int dataType, boolean isSigned)	与えられたビット深度のピクセルを、指定されたデータ型の配列要素にパックする、グレー・スケール・イメージ形式の指示子を返します。
static ImageTypeSpecifier	createGrayscale(int bits, int dataType, boolean isSigned, boolean isAlphaPremultiplied)	与えられたビット深度のピクセルを、指定されたデータ型の配列要素にパックする、グレー・スケールとプラス・アルファのイメージ形式の指示子を返します。
static ImageTypeSpecifier	createIndexed(byte[] redLUT, byte[] greenLUT, byte[] blueLUT, byte[] alphaLUT, int bits, int dataType)	与えられたビット深度のインデックス値を、指定されたデータ型の配列要素にパックする、インデックスされたカラー・イメージ形式の指示子を返します。
static ImageTypeSpecifier	createInterleaved(ColorSpace colorSpace, int[] bandOffsets, int dataType, boolean hasAlpha, boolean isAlphaPremultiplied)	ComponentColorModelとPixelInterleavedSampleModelを使用する、インターリーブされたイメージ形式の指示子を返して、各ピクセル構成要素を別々のbyte、short、またはintに格納します。
static ImageTypeSpecifier	createPacked(ColorSpace colorSpace, int redMask, int greenMask, int blueMask, int alphaMask, int transferType, boolean isAlphaPremultiplied)	DirectColorModelとパックされたSampleModelを使用する、パックされたイメージ形式の指示子を返して、1 byte、short、またはintにパックされた各ピクセルを格納します。
boolean	equals(Object o)	指定されたObjectがImageTypeSpecifierであり、このオブジェクトと等しいSampleModelおよびColorModelを持っている場合は、trueを返します。
int	getBitsPerBand(int band)	与えられたバンドのサンプルを表すために使用されるビット数を返します。
int	getBufferedImageType()	BufferedImageから、イメージ形式を記述する列挙された定数値の1つを含むintを返します。
ColorModel	getColorModel()	オブジェクトで指定されたColorModelを返します。
int	getNumBands()	オブジェクトで指定されたバンドの数を返します。
int	getNumComponents()	オブジェクトで指定された色成分の数を返します。
SampleModel	getSampleModel()	このオブジェクト内にカプセル化された設定に基づくSampleModelを返します。
SampleModel	getSampleModel(int width, int height)	このオブジェクト内にカプセル化された設定に基づくSampleModelを返します。
int	hashCode()	このImageTypeSpecifierのハッシュ・コードを返します。

クラスjava.lang.Objectで宣言されたメソッド

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

フィールド詳細

colorModel

protected ColorModel colorModel

プロトタイプとして使用するColorModelです。

sampleModel

protected SampleModel sampleModel

プロトタイプとして使用するSampleModelです。

コンストラクタの詳細

ImageTypeSpecifier

public ImageTypeSpecifier(ColorModel colorModel, SampleModel sampleModel)

ColorModelとSampleModelから直接ImageTypeSpecifierを構築します。 互換性があるパラメータを提供するのは、呼出し側の役割となります。

パラメータ:

colorModel - ColorModel

sampleModel - SampleModel

例外:

IllegalArgumentException - いずれかのパラメータがnullの場合。

IllegalArgumentException - sampleModelがcolorModelと互換性がない場合。

ImageTypeSpecifier

public ImageTypeSpecifier(RenderedImage image)

RenderedImageからImageTypeSpecifierを構築します。 BufferedImageを使用している場合、より正確な結果を得るために、ファクトリ・メソッドの1つであるcreateFromRenderedImageまたはcreateFromBufferedImageTypeを代わりに使用する必要があります。

パラメータ:

image - RenderedImage

例外:

IllegalArgumentException - 引数がnullの場合。

メソッドの詳細

createPacked

public static ImageTypeSpecifier createPacked(ColorSpace colorSpace, int redMask, int greenMask, int blueMask, int alphaMask, int transferType, boolean isAlphaPremultiplied)

DirectColorModelとパックされたSampleModelを使用する、パックされたイメージ形式の指示子を返して、1 byte、short、またはintにパックされた各ピクセルを格納します。

パラメータ:

colorSpace - 目的のColorSpace。

redMask - 赤のチャネルの位置が示された隣接するマスク。

greenMask - 緑のチャネルの位置が示された隣接するマスク。

blueMask - 青のチャネルの位置が示された隣接するマスク。

alphaMask - アルファ・チャネルの位置が示された隣接するマスク。

transferType - 目的のSampleModel転送タイプ。

isAlphaPremultiplied - 配色チャネルがアルファ・チャネルで倍加される場合、true。

戻り値:

目的の特性を持つImageTypeSpecifier。

例外:

IllegalArgumentException - colorSpaceがnullの場合。

IllegalArgumentException - colorSpaceがタイプTYPE_RGBでない場合。

IllegalArgumentException - マスクに1ビットも設定されていない場合。

IllegalArgumentException - transferTypeがDataBuffer.TYPE_BYTE、DataBuffer.TYPE_USHORT、DataBuffer.TYPE_INTのいずれでもない場合。

createInterleaved

public static ImageTypeSpecifier createInterleaved(ColorSpace colorSpace, int[] bandOffsets, int dataType, boolean hasAlpha, boolean isAlphaPremultiplied)

ComponentColorModelとPixelInterleavedSampleModelを使用する、インターリーブされたイメージ形式の指示子を返して、各ピクセル構成要素を別々のbyte、short、またはintに格納します。

パラメータ:

colorSpace - 目的のColorSpace。

bandOffsets - 各バンドのオフセットを示すintの配列。

dataType - 目的のデータ型を、DataBufferクラスからの列挙法の1つで表したもの。

hasAlpha - アルファ・チャネルが必要な場合、true。

isAlphaPremultiplied - 配色チャネルがアルファ・チャネルで倍加される場合、true。

戻り値:

目的の特性を持つImageTypeSpecifier。

例外:

IllegalArgumentException - colorSpaceがnullの場合。

IllegalArgumentException - bandOffsetsがnullの場合。

IllegalArgumentException - dataTypeが正当なDataBuffer.TYPE_*定数の1つでない場合。

IllegalArgumentException - bandOffsets.lengthがカラー領域成分の数と等しく、hasAlphaがtrueの場合。

createBanded

public static ImageTypeSpecifier createBanded(ColorSpace colorSpace, int[] bankIndices, int[] bandOffsets, int dataType, boolean hasAlpha, boolean isAlphaPremultiplied)

ComponentColorModelとBandedSampleModelを使用する、バンドされたイメージ形式の指示子を返して、各チャネルを別々の配列に格納します。

パラメータ:

colorSpace - 目的のColorSpace。

bankIndices - 各バンドを格納するバンクを示すintの配列。

bandOffsets - バンク内の各バンドの開始オフセットを示すintの配列。

dataType - 目的のデータ型を、DataBufferクラスからの列挙法の1つで表したもの。

hasAlpha - アルファ・チャネルが必要な場合、true。

isAlphaPremultiplied - 配色チャネルがアルファ・チャネルで倍加される場合、true。

戻り値:

目的の特性を持つImageTypeSpecifier。

例外:

IllegalArgumentException - colorSpaceがnullの場合。

IllegalArgumentException - bankIndicesがnullの場合。

IllegalArgumentException - bandOffsetsがnullの場合。

IllegalArgumentException - bankIndicesとbandOffsetsの長さが異なる場合。

IllegalArgumentException - bandOffsets.lengthがカラー領域成分の数と等しく、hasAlphaがtrueの場合。

IllegalArgumentException - dataTypeが正当なDataBuffer.TYPE_*定数の1つでない場合。

createGrayscale

public static ImageTypeSpecifier createGrayscale(int bits, int dataType, boolean isSigned)

与えられたビット深度のピクセルを、指定されたデータ型の配列要素にパックする、グレー・スケール・イメージ形式の指示子を返します。

パラメータ:

bits - グレー表示の値ごとのビット数(1、2、4、8、または16)。

dataType - 目的のデータ型を、DataBufferクラスからの列挙法の1つで表したもの。

isSigned - 負の値が表示される場合、true。

戻り値:

目的の特性を持つImageTypeSpecifier。

例外:

IllegalArgumentException - bitsが1、2、4、8、または16のいずれでもない場合。

IllegalArgumentException - dataTypeがDataBuffer.TYPE_BYTE、DataBuffer.TYPE_SHORT、またはDataBuffer.TYPE_USHORTのいずれでもない場合。

IllegalArgumentException - bitsが指定されたdataTypeのビット・サイズより大きい場合。

createGrayscale

public static ImageTypeSpecifier createGrayscale(int bits, int dataType, boolean isSigned, boolean isAlphaPremultiplied)

与えられたビット深度のピクセルを、指定されたデータ型の配列要素にパックする、グレー・スケールとプラス・アルファのイメージ形式の指示子を返します。

パラメータ:

bits - グレー表示の値ごとのビット数(1、2、4、8、または16)。

dataType - 目的のデータ型を、DataBufferクラスからの列挙法の1つで表したもの。

isSigned - 負の値が表示される場合、true。

isAlphaPremultiplied - 輝度チャネルがアルファ・チャネルで倍加される場合、true。

戻り値:

目的の特性を持つImageTypeSpecifier。

例外:

IllegalArgumentException - bitsが1、2、4、8、または16のいずれでもない場合。

IllegalArgumentException - dataTypeがDataBuffer.TYPE_BYTE、DataBuffer.TYPE_SHORT、またはDataBuffer.TYPE_USHORTのいずれでもない場合。

IllegalArgumentException - bitsが指定されたdataTypeのビット・サイズより大きい場合。

createIndexed

public static ImageTypeSpecifier createIndexed(byte[] redLUT, byte[] greenLUT, byte[] blueLUT, byte[] alphaLUT, int bits, int dataType)

与えられたビット深度のインデックス値を、指定されたデータ型の配列要素にパックする、インデックスされたカラー・イメージ形式の指示子を返します。

パラメータ:

redLUT - 各インデックスに対する赤の値を含むbyteの配列。

greenLUT - 各インデックスに対する*緑の値を含むbyteの配列。

blueLUT - 各インデックスに対する青の値を含むbyteの配列。

alphaLUT - 各インデックスに対するアルファ値または完全に不透明なLUTを作成するためのnullを含むbyteの配列。

bits - 各インデックスのビット数。

dataType - 目的の出力形式を、DataBufferクラスからの列挙法の1つで表したもの。

戻り値:

目的の特性を持つImageTypeSpecifier。

例外:

IllegalArgumentException - redLUTがnullの場合。

IllegalArgumentException - greenLUTがnullの場合。

IllegalArgumentException - blueLUTがnullの場合。

IllegalArgumentException - bitsが1、2、4、8、または16のいずれでもない場合。

IllegalArgumentException - null以外のLUTパラメータが、厳密に1 << bitsの長さを持たない場合。

IllegalArgumentException - dataTypeがDataBuffer.TYPE_BYTE、DataBuffer.TYPE_SHORT、DataBuffer.TYPE_USHORT、またはDataBuffer.TYPE_INTのいずれでもない場合。

IllegalArgumentException - bitsが指定されたdataTypeのビット・サイズより大きい場合。

createFromBufferedImageType

public static ImageTypeSpecifier createFromBufferedImageType(int bufferedImageType)

標準BufferedImage形式の1つ(TYPE_CUSTOM以外)を符号化するImageTypeSpecifierを返します。

パラメータ:

bufferedImageType - 標準BufferedImage形式の1つを表すint。

戻り値:

目的の特性を持つImageTypeSpecifier。

例外:

IllegalArgumentException - bufferedImageTypeが標準形式のいずれでもない、またはTYPE_CUSTOMと等しい場合。

関連項目:

• BufferedImage
• BufferedImage.TYPE_INT_RGB
• BufferedImage.TYPE_INT_ARGB
• BufferedImage.TYPE_INT_ARGB_PRE
• BufferedImage.TYPE_INT_BGR
• BufferedImage.TYPE_3BYTE_BGR
• BufferedImage.TYPE_4BYTE_ABGR
• BufferedImage.TYPE_4BYTE_ABGR_PRE
• BufferedImage.TYPE_USHORT_565_RGB
• BufferedImage.TYPE_USHORT_555_RGB
• BufferedImage.TYPE_BYTE_GRAY
• BufferedImage.TYPE_USHORT_GRAY
• BufferedImage.TYPE_BYTE_BINARY
• BufferedImage.TYPE_BYTE_INDEXED

createFromRenderedImage

public static ImageTypeSpecifier createFromRenderedImage(RenderedImage image)

RenderedImage (BufferedImageの場合もあります)の配置を符号化するImageTypeSpecifierを返します。

パラメータ:

image - RenderedImage

戻り値:

目的の特性を持つImageTypeSpecifier。

例外:

IllegalArgumentException - imageがnullの場合。

getBufferedImageType

public int getBufferedImageType()

BufferedImageから、イメージ形式を記述する列挙された定数値の1つを含むintを返します。

戻り値:

BufferedImage形式を表すint。

関連項目:

• BufferedImage
• BufferedImage.TYPE_CUSTOM
• BufferedImage.TYPE_INT_RGB
• BufferedImage.TYPE_INT_ARGB
• BufferedImage.TYPE_INT_ARGB_PRE
• BufferedImage.TYPE_INT_BGR
• BufferedImage.TYPE_3BYTE_BGR
• BufferedImage.TYPE_4BYTE_ABGR
• BufferedImage.TYPE_4BYTE_ABGR_PRE
• BufferedImage.TYPE_USHORT_565_RGB
• BufferedImage.TYPE_USHORT_555_RGB
• BufferedImage.TYPE_BYTE_GRAY
• BufferedImage.TYPE_USHORT_GRAY
• BufferedImage.TYPE_BYTE_BINARY
• BufferedImage.TYPE_BYTE_INDEXED

getNumComponents

public int getNumComponents()

オブジェクトで指定された色成分の数を返します。 これは、ColorModel.getNumComponentsが返す値と同じです。

戻り値:

イメージ内のコンポーネント数。

getNumBands

public int getNumBands()

オブジェクトで指定されたバンドの数を返します。 これは、SampleModel.getNumBandsが返す値と同じです。

戻り値:

イメージ内のバンド数。

getBitsPerBand

public int getBitsPerBand(int band)

与えられたバンドのサンプルを表すために使用されるビット数を返します。

パラメータ:

band - 照会されるバンドのインデックスをintで表したもの。

戻り値:

ビット数を指定するint。

例外:

IllegalArgumentException - bandが負または最大のバンド・インデックスより大きい場合。

getSampleModel

public SampleModel getSampleModel()

このオブジェクト内にカプセル化された設定に基づくSampleModelを返します。 SampleModelの幅と高さは任意の値に設定されます。

戻り値:

任意の大きさを持つSampleModel。

getSampleModel

public SampleModel getSampleModel(int width, int height)

このオブジェクト内にカプセル化された設定に基づくSampleModelを返します。 SampleModelの幅と高さは提供された値に設定されます。

パラメータ:

width - 返されたSampleModelの目的の幅。

height - 返されたSampleModelの目的の高さ。

戻り値:

与えられた大きさを持つSampleModel。

例外:

IllegalArgumentException - widthまたはheightが負または0の場合。

IllegalArgumentException - widthとheightの積がInteger.MAX_VALUEより大きい場合

getColorModel

public ColorModel getColorModel()

オブジェクトで指定されたColorModelを返します。

戻り値:

ColorModel。

createBufferedImage

public BufferedImage createBufferedImage(int width, int height)

このオブジェクトに取り入れられた指定に従って、指定された幅と高さのBufferedImageを作成します。

パラメータ:

width - 返されたBufferedImageの目的の幅。

height - 返されたBufferedImageの目的の高さ。

戻り値:

新しいBufferedImage。

例外:

IllegalArgumentException - widthまたはheightが負または0の場合。

IllegalArgumentException - widthとheightの積がInteger.MAX_VALUEより大きい場合、またはイメージを格納するために必要な配列要素の数がInteger.MAX_VALUEより大きい場合。

equals

public boolean equals(Object o)

指定されたObjectがImageTypeSpecifierであり、このオブジェクトと等しいSampleModelおよびColorModelを持っている場合は、trueを返します。

オーバーライド:

equals、クラスObject

パラメータ:

o - 等しいかどうかを比較する対象のObject。

戻り値:

与えられたオブジェクトがImageTypeSpecifierと等しい場合、true。

関連項目:

• Object.hashCode()
• HashMap

hashCode

public int hashCode()

このImageTypeSpecifierのハッシュ・コードを返します。

オーバーライド:

hashCode、クラスObject

戻り値:

このImageTypeSpecifierのハッシュ・コード

関連項目:

• Object.equals(java.lang.Object)
• System.identityHashCode(java.lang.Object)