java.awt.color.ColorSpace

すべての実装されたインタフェース:: Serializable

直系の既知のサブクラス:: ICC_ColorSpace

public abstract class ColorSpace
extends Object
implements Serializable

この抽象クラスは、Colorオブジェクトの特定のカラー・スペースを特定するためのカラー・スペース・タグとして機能するため、またはColorModelオブジェクト(Image、BufferedImageまたはGraphicsDeviceを介した)として機能するために使用されます。このクラスには、特定のカラー・スペースとsRGB、および特定のカラー・スペースと明確に定義されたCIEXYZカラー・スペースの間でカラーを変換するメソッドがあります。

このクラスのメソッド用に、色は、各ColorSpaceによって定義される正規化された範囲内で浮動小数として表される色コンポーネントの配列として表されます。 ColorSpaces (例: sRGB)の多くの場合、範囲は0.0から1.0です。ただし、ColorSpacesの中には、異なる範囲の値を持つコンポーネントが含まれているものがあります。標準化された値の最小値と最大値は、成分ごとに用意されているメソッドを使用して照会できます。

カラー・スペースタイプ(e.g. TYPE_RGB, TYPE_XYZ, etc.)を参照する目的で定義された複数の変数で、特定のカラー・スペース(例: CS_sRGBおよびCS_CIEXYZ)を参照します。sRGBは、提案される標準のRGBカラー・スペースです。詳細は、http://www.w3.org/pub/WWW/Graphics/Color/sRGB.htmlを参照してください。

明確に定義されたCIEXYZカラー・スペースとの間で変換を行うメソッドの目的は、2つのカラー・スペースの間で高精度の変換をサポートすることです。 ColorSpace (e.g. ICC_ColorSpace)のサブクラスの特定の実装では、基になるプラットフォーム色管理システムに基づいた高パフォーマンス変換がサポートされることが想定されています。

toCIEXYZ/fromCIEXYZメソッドで使用されるCS_CIEXYZスペースは、次のように記述できます:


     CIEXYZ
     viewing illuminance: 200 lux
     viewing white point: CIE D50
     media white point: "that of a perfectly reflecting diffuser" -- D50
     media black point: 0 lux or 0 Reflectance
     flare: 1 percent
     surround: 20percent of the media white point
     media description: reflection print (i.e., RLAB, Hunt viewing media)
     note: For developers creating an ICC profile for this conversion
           space, the following is applicable. Use a simple Von Kries
           white point adaptation folded into the 3X3 matrix parameters
           and fold the flare and surround effects into the three
           one-dimensional lookup tables (assuming one uses the minimal
           model for monitors).

関連項目:: ICC_ColorSpace、直列化された形式

フィールドのサマリー

フィールド
修飾子と型	フィールド	説明
`static int`	`CS_CIEXYZ`	上で定義されたCIEXYZ変換カラー・スペースです。
`static int`	`CS_GRAY`	組込みリニア・グレー・スケール・カラー・スペースです。
`static int`	`CS_LINEAR_RGB`	組込みリニアRGBカラー・スペースです。
`static int`	`CS_PYCC`	Photo YCC変換カラー・スペースです。
`static int`	`CS_sRGB`	http://www.w3.org/pub/WWW/Graphics/Color/sRGB.htmlで定義されたsRGBのカラー・スペース。
`static int`	`TYPE_2CLR`	ジェネリック2成分カラー・スペースです。
`static int`	`TYPE_3CLR`	ジェネリック3成分カラー・スペースです。
`static int`	`TYPE_4CLR`	ジェネリック4成分カラー・スペースです。
`static int`	`TYPE_5CLR`	ジェネリック5成分カラー・スペースです。
`static int`	`TYPE_6CLR`	ジェネリック6成分カラー・スペースです。
`static int`	`TYPE_7CLR`	ジェネリック7成分カラー・スペースです。
`static int`	`TYPE_8CLR`	ジェネリック8成分カラー・スペースです。
`static int`	`TYPE_9CLR`	ジェネリック9成分カラー・スペースです。
`static int`	`TYPE_ACLR`	ジェネリック10成分カラー・スペースです。
`static int`	`TYPE_BCLR`	ジェネリック11成分カラー・スペースです。
`static int`	`TYPE_CCLR`	ジェネリック12成分カラー・スペースです。
`static int`	`TYPE_CMY`	CMYカラー・スペース・ファミリのどれかです。
`static int`	`TYPE_CMYK`	CMYKカラー・スペース・ファミリのどれかです。
`static int`	`TYPE_DCLR`	ジェネリック13成分カラー・スペースです。
`static int`	`TYPE_ECLR`	ジェネリック14成分カラー・スペースです。
`static int`	`TYPE_FCLR`	ジェネリック15成分カラー・スペースです。
`static int`	`TYPE_GRAY`	GRAYカラー・スペース・ファミリのどれかです。
`static int`	`TYPE_HLS`	HLSカラー・スペース・ファミリのどれかです。
`static int`	`TYPE_HSV`	HSVカラー・スペース・ファミリのどれかです。
`static int`	`TYPE_Lab`	Labカラー・スペース・ファミリのどれかです。
`static int`	`TYPE_Luv`	Luvカラー・スペース・ファミリのどれかです。
`static int`	`TYPE_RGB`	RGBカラー・スペース・ファミリのどれかです。
`static int`	`TYPE_XYZ`	XYZカラー・スペース・ファミリのどれかです。
`static int`	`TYPE_YCbCr`	YCbCrカラー・スペース・ファミリのどれかです。
`static int`	`TYPE_Yxy`	Yxyカラー・スペース・ファミリのどれかです。

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

コンストラクタ
修飾子	コンストラクタ	説明
`protected`	`ColorSpace(int type, int numcomponents)`	カラー・スペース型およびコンポーネント数で指定された`ColorSpace`オブジェクトを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
`abstract float[]`	`fromCIEXYZ(float[] colorvalue)`	`CS_CIEXYZ`変換カラー・スペース内にあるとみなされる色値をこの`ColorSpace`に変換します。
`abstract float[]`	`fromRGB(float[] rgbvalue)`	色の値をデフォルトの`CS_sRGB`カラー・スペースとみなし、この`ColorSpace`に変換します。
`static ColorSpace`	`getInstance(int colorspace)`	特定の事前定義済のカラー・スペースの1つを表す`ColorSpace`を返します。
`float`	`getMaxValue(int component)`	指定された成分について、標準化された成分値の最大値を返します。
`float`	`getMinValue(int component)`	指定された成分について、標準化された成分値の最小値を返します。
`String`	`getName(int idx)`	指定された成分インデックスで、成分の名前を返します。
`int`	`getNumComponents()`	このColorSpaceの成分数を返します。
`int`	`getType()`	この`ColorSpace` (例: `TYPE_RGB`、`TYPE_XYZ`、...)のカラー・スペース・タイプを返します。
`boolean`	`isCS_sRGB()`	`ColorSpace`が`CS_sRGB`の場合はtrueを返します。
`abstract float[]`	`toCIEXYZ(float[] colorvalue)`	`ColorSpace`内にあるとみなされる色値を`CS_CIEXYZ`変換のカラー・スペースに変換します。
`abstract float[]`	`toRGB(float[] colorvalue)`	`ColorSpace`で想定された色の値をデフォルトの`CS_sRGB`カラー・スペースの値に変換します。

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

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

フィールド詳細
- TYPE_XYZ
  
  @Native public static final int TYPE_XYZ
  
  XYZカラー・スペース・ファミリのどれかです。
  
  関連項目:
  
  定数フィールド値
- TYPE_Lab
  
  @Native public static final int TYPE_Lab
  
  Labカラー・スペース・ファミリのどれかです。
  
  関連項目:
  
  定数フィールド値
- TYPE_Luv
  
  @Native public static final int TYPE_Luv
  
  Luvカラー・スペース・ファミリのどれかです。
  
  関連項目:
  
  定数フィールド値
- TYPE_YCbCr
  
  @Native public static final int TYPE_YCbCr
  
  YCbCrカラー・スペース・ファミリのどれかです。
  
  関連項目:
  
  定数フィールド値
- TYPE_Yxy
  
  @Native public static final int TYPE_Yxy
  
  Yxyカラー・スペース・ファミリのどれかです。
  
  関連項目:
  
  定数フィールド値
- TYPE_RGB
  
  @Native public static final int TYPE_RGB
  
  RGBカラー・スペース・ファミリのどれかです。
  
  関連項目:
  
  定数フィールド値
- TYPE_GRAY
  
  @Native public static final int TYPE_GRAY
  
  GRAYカラー・スペース・ファミリのどれかです。
  
  関連項目:
  
  定数フィールド値
- TYPE_HSV
  
  @Native public static final int TYPE_HSV
  
  HSVカラー・スペース・ファミリのどれかです。
  
  関連項目:
  
  定数フィールド値
- TYPE_HLS
  
  @Native public static final int TYPE_HLS
  
  HLSカラー・スペース・ファミリのどれかです。
  
  関連項目:
  
  定数フィールド値
- TYPE_CMYK
  
  @Native public static final int TYPE_CMYK
  
  CMYKカラー・スペース・ファミリのどれかです。
  
  関連項目:
  
  定数フィールド値
- TYPE_CMY
  
  @Native public static final int TYPE_CMY
  
  CMYカラー・スペース・ファミリのどれかです。
  
  関連項目:
  
  定数フィールド値
- TYPE_2CLR
  
  @Native public static final int TYPE_2CLR
  
  ジェネリック2成分カラー・スペースです。
  
  関連項目:
  
  定数フィールド値
- TYPE_3CLR
  
  @Native public static final int TYPE_3CLR
  
  ジェネリック3成分カラー・スペースです。
  
  関連項目:
  
  定数フィールド値
- TYPE_4CLR
  
  @Native public static final int TYPE_4CLR
  
  ジェネリック4成分カラー・スペースです。
  
  関連項目:
  
  定数フィールド値
- TYPE_5CLR
  
  @Native public static final int TYPE_5CLR
  
  ジェネリック5成分カラー・スペースです。
  
  関連項目:
  
  定数フィールド値
- TYPE_6CLR
  
  @Native public static final int TYPE_6CLR
  
  ジェネリック6成分カラー・スペースです。
  
  関連項目:
  
  定数フィールド値
- TYPE_7CLR
  
  @Native public static final int TYPE_7CLR
  
  ジェネリック7成分カラー・スペースです。
  
  関連項目:
  
  定数フィールド値
- TYPE_8CLR
  
  @Native public static final int TYPE_8CLR
  
  ジェネリック8成分カラー・スペースです。
  
  関連項目:
  
  定数フィールド値
- TYPE_9CLR
  
  @Native public static final int TYPE_9CLR
  
  ジェネリック9成分カラー・スペースです。
  
  関連項目:
  
  定数フィールド値
- TYPE_ACLR
  
  @Native public static final int TYPE_ACLR
  
  ジェネリック10成分カラー・スペースです。
  
  関連項目:
  
  定数フィールド値
- TYPE_BCLR
  
  @Native public static final int TYPE_BCLR
  
  ジェネリック11成分カラー・スペースです。
  
  関連項目:
  
  定数フィールド値
- TYPE_CCLR
  
  @Native public static final int TYPE_CCLR
  
  ジェネリック12成分カラー・スペースです。
  
  関連項目:
  
  定数フィールド値
- TYPE_DCLR
  
  @Native public static final int TYPE_DCLR
  
  ジェネリック13成分カラー・スペースです。
  
  関連項目:
  
  定数フィールド値
- TYPE_ECLR
  
  @Native public static final int TYPE_ECLR
  
  ジェネリック14成分カラー・スペースです。
  
  関連項目:
  
  定数フィールド値
- TYPE_FCLR
  
  @Native public static final int TYPE_FCLR
  
  ジェネリック15成分カラー・スペースです。
  
  関連項目:
  
  定数フィールド値
- CS_sRGB
  
  @Native public static final int CS_sRGB
  
  http://www.w3.org/pub/WWW/Graphics/Color/sRGB.htmlで定義されたsRGBのカラー・スペース。
  
  関連項目:
  
  定数フィールド値
- CS_LINEAR_RGB
  
  @Native public static final int CS_LINEAR_RGB
  
  組込みリニアRGBカラー・スペースです。このスペースは、CS_sRGBと同じRGBプライマリに基づいていますが、線形着信音が再現曲線になっています。
  
  関連項目:
  
  定数フィールド値
- CS_CIEXYZ
  
  @Native public static final int CS_CIEXYZ
  
  上で定義されたCIEXYZ変換カラー・スペースです。
  
  関連項目:
  
  定数フィールド値
- CS_PYCC
  
  @Native public static final int CS_PYCC
  
  Photo YCC変換カラー・スペースです。
  
  関連項目:
  
  定数フィールド値
- CS_GRAY
  
  @Native public static final int CS_GRAY
  
  組込みリニア・グレー・スケール・カラー・スペースです。
  
  関連項目:
  
  定数フィールド値
コンストラクタの詳細
- ColorSpace
  
  protected ColorSpace(int type, int numcomponents)
  
  カラー・スペース型およびコンポーネント数で指定されたColorSpaceオブジェクトを構築します。
  
  パラメータ:
  
  type - ColorSpaceタイプ定数のいずれか
  
  numcomponents - カラー・スペース内の成分の数
メソッドの詳細
- getInstance
  
  public static ColorSpace getInstance(int colorspace)
  
  特定の事前定義済のカラー・スペースの1つを表すColorSpaceを返します。
  
  パラメータ:
  
  colorspace - 事前定義されたクラス定数の1つで識別される特定のカラー・スペース(例: CS_sRGB、CS_LINEAR_RGB、CS_CIEXYZ、CS_GRAY、CS_PYCC)
  
  戻り値:
  
  要求されたColorSpaceオブジェクト
- isCS_sRGB
  
  public boolean isCS_sRGB()
  
  ColorSpaceがCS_sRGBの場合はtrueを返します。
  
  戻り値:
  
  これがCS_sRGBカラー・スペースである場合はtrue、そうでない場合はfalse
- toRGB
  
  public abstract float[] toRGB(float[] colorvalue)
  
  ColorSpaceで想定された色の値をデフォルトのCS_sRGBカラー・スペースの値に変換します。
  このメソッドでは、入力と出力の色がもっとも知覚的に近い色を作成できるように設計されたアルゴリズムを使って、カラー値を変換します。色値をcolorimetricに変換するには、このカラー・スペースのtoCIEXYZメソッドを使用して、最初に入力カラー・スペースからCS_CIEXYZカラー・スペースに変換し、次にCS_sRGBカラー・スペースのfromCIEXYZメソッドを使用してCS_CIEXYZから出力カラー・スペースに変換する必要があります。詳細は、toCIEXYZおよびfromCIEXYZを参照してください。
  
  パラメータ:
  
  colorvalue - 長さが少なくともこのColorSpaceのコンポーネント数である浮動小数配列
  
  戻り値:
  
  長さが3のfloat配列
  
  例外:
  
  ArrayIndexOutOfBoundsException - 配列の長さがこのColorSpace内のコンポーネントの数以上でない場合
- fromRGB
  
  public abstract float[] fromRGB(float[] rgbvalue)
  
  色の値をデフォルトのCS_sRGBカラー・スペースとみなし、このColorSpaceに変換します。
  このメソッドでは、入力と出力の色がもっとも知覚的に近い色を作成できるように設計されたアルゴリズムを使って、カラー値を変換します。色値をcolorimetricに変換するには、CS_sRGBカラー・スペースのtoCIEXYZメソッドを使用して、最初に入力カラー・スペースからCS_CIEXYZカラー・スペースに変換し、次にこのカラー・スペースのfromCIEXYZメソッドを使用してCS_CIEXYZから出力カラー・スペースに変換する必要があります。詳細は、toCIEXYZおよびfromCIEXYZを参照してください。
  
  パラメータ:
  
  rgbvalue - 少なくとも3の長さを持つfloat配列
  
  戻り値:
  
  このColorSpaceのコンポーネント数と長さが等しい浮動小数配列
  
  例外:
  
  ArrayIndexOutOfBoundsException - 配列の長さが3に満たない場合
- toCIEXYZ
  
  public abstract float[] toCIEXYZ(float[] colorvalue)
  
  ColorSpace内にあるとみなされる色値をCS_CIEXYZ変換のカラー・スペースに変換します。
  このメソッドは、International Color Consortium基準で定義されている相対色度測定を使ってカラー値を変換します。つまり、このメソッドによって返されたXYZの値は、CS_CIEXYZカラー・スペースのD50ホワイト・ポイントを基準にして表されます。この表現は、入力カラー・スペースからCS_CIEXYZに色を変換し、出力カラー・スペースに変換する2段階の色変換プロセスで役に立ちます。この表現は、指定されたカラー値から色度計を使って測定するXYZ値と同じではありません。現在CIE推奨の計算方法を使って測定されているXYZ値を計算するには、さらに詳細な変換が必要です。詳細は、ICC_ColorSpaceのtoCIEXYZメソッドを参照してください。
  
  パラメータ:
  
  colorvalue - 長さが少なくともこのColorSpaceのコンポーネント数である浮動小数配列
  
  戻り値:
  
  長さが3のfloat配列
  
  例外:
  
  ArrayIndexOutOfBoundsException - 配列の長さが、このColorSpace内のコンポーネントの数以上でない場合。
- fromCIEXYZ
  
  public abstract float[] fromCIEXYZ(float[] colorvalue)
  
  CS_CIEXYZ変換カラー・スペース内にあるとみなされる色値をこのColorSpaceに変換します。
  このメソッドは、International Color Consortium基準で定義されている相対色度測定を使ってカラー値を変換します。つまり、このメソッドによって取得されたXYZ引数の値は、CS_CIEXYZカラー・スペースのD50ホワイト・ポイントを基準にして表されます。この表現は、入力カラー・スペースからCS_CIEXYZに色を変換し、出力カラー・スペースに変換する2段階の色変換プロセスで役に立ちます。このメソッドが返すカラー値は、色度計で測定するときにメソッドに渡されるXYZ値を生成するカラー値ではありません。現在CIE推奨の計算方法を使った測定値に対応するXYZ値を計算済みの場合は、その値がこのメソッドに渡される前にD50相対値に変換する必要があります。詳細は、ICC_ColorSpaceのfromCIEXYZメソッドを参照してください。
  
  パラメータ:
  
  colorvalue - 少なくとも3の長さを持つfloat配列
  
  戻り値:
  
  このColorSpaceのコンポーネント数と長さが等しい浮動小数配列
  
  例外:
  
  ArrayIndexOutOfBoundsException - 配列の長さが3に満たない場合
- getType
  
  public int getType()
  
  このColorSpace (例: TYPE_RGB、TYPE_XYZ、...)のカラー・スペース・タイプを返します。このタイプでは、カラー・スペースのコンポーネント数および解釈を定義します。たとえば、TYPE_RGBは、3つのコンポーネントでカラー・スペースを識別 - 赤、緑および青。領域の特定の色の特性(原色の色度など)は定義されません。
  
  戻り値:
  
  このColorSpaceのタイプを表すタイプ定数
- getNumComponents
  
  public int getNumComponents()
  
  このColorSpaceの成分数を返します。
  
  戻り値:
  
  このColorSpace内のコンポーネントの数
- getName
  
  public String getName(int idx)
  
  指定された成分インデックスで、成分の名前を返します。
  
  パラメータ:
  
  idx - 成分インデックス
  
  戻り値:
  
  指定されたインデックスの成分の名前
  
  例外:
  
  IllegalArgumentException - idxが0より小さいか、numComponents - 1より大きい場合
- getMinValue
  
  public float getMinValue(int component)
  
  指定された成分について、標準化された成分値の最小値を返します。この抽象クラスのデフォルトの実装は、すべての成分に対して0.0を返します。必要に応じて、サブクラスがこのメソッドをオーバーライドする必要があります。
  
  パラメータ:
  
  component - 成分インデックス
  
  戻り値:
  
  標準化された成分値の最小値
  
  例外:
  
  IllegalArgumentException - コンポーネントが0より小さいか、numComponents - 1より大きい場合
  
  導入されたバージョン:
  
  1.4
- getMaxValue
  
  public float getMaxValue(int component)
  
  指定された成分について、標準化された成分値の最大値を返します。この抽象クラスのデフォルトの実装は、すべての成分に対して1.0を返します。必要に応じて、サブクラスがこのメソッドをオーバーライドする必要があります。
  
  パラメータ:
  
  component - 成分インデックス
  
  戻り値:
  
  標準化された成分値の最大値
  
  例外:
  
  IllegalArgumentException - コンポーネントが0より小さいか、numComponents - 1より大きい場合
  
  導入されたバージョン:
  
  1.4

クラスColorSpace

フィールドのサマリー

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

メソッドのサマリー

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

フィールド詳細

TYPE_XYZ

TYPE_Lab

TYPE_Luv

TYPE_YCbCr

TYPE_Yxy

TYPE_RGB

TYPE_GRAY

TYPE_HSV

TYPE_HLS

TYPE_CMYK

TYPE_CMY

TYPE_2CLR

TYPE_3CLR

TYPE_4CLR

TYPE_5CLR

TYPE_6CLR

TYPE_7CLR

TYPE_8CLR

TYPE_9CLR

TYPE_ACLR

TYPE_BCLR

TYPE_CCLR

TYPE_DCLR

TYPE_ECLR

TYPE_FCLR

CS_sRGB

CS_LINEAR_RGB

CS_CIEXYZ

CS_PYCC

CS_GRAY

コンストラクタの詳細

ColorSpace

メソッドの詳細

getInstance

isCS_sRGB

toRGB

fromRGB

toCIEXYZ

fromCIEXYZ

getType

getNumComponents

getName

getMinValue

getMaxValue