- 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メソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 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のハッシュ・コードを返します。
-
-
-
フィールドの詳細
-
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)
-
-