ColorSpace.doc

概述软件包类使用树已过时索引帮助JavaTM 2 PlatformStandard Ed. 6 上一个类 下一个类框架 无框架 摘要： 嵌套 | 字段 | 构造方法 | 方法详细信息： 字段 | 构造方法 | 方法java.awt.color类 ColorSpacejava.lang.Object java.awt.color.ColorSpace所有已实现的接口：Serializable直接已知子类：ICC_ColorSpacepublic abstract class ColorSpaceextends Objectimplements Serializable此抽象类用做一个颜色空间标记，标识 Color 对象的特定颜色空间，或者通过 ColorModel 对象标识 Image、BufferedImage 或 GraphicsDevice 的特定颜色空间。此类包含了可将指定颜色空间中的颜色与 sRGB 和定义良好的 CIEXYZ 颜色空间中的颜色进行相互转换的方法。对于此类中的各个方法，颜色以颜色分量数组表示，颜色分量则是以每个 ColorSpace 定义的标准化范围中的 float 数表示。对于多数 ColorSpace（例如 sRGB）而言，此范围是 0.0 到 1.0。但是某些 ColorSpace 的颜色分量具有不同的范围值。此类提供了查询每个分量最小和最大标准化值的方法。定义了多个变量，用来表示颜色空间类型（如 TYPE_RGB、TYPE_XYZ 等等）和特定颜色空间（如 CS_sRGB 和 CS_CIEXYZ）。sRGB 指的是标准的 RGB 颜色空间。有关更多信息，请参阅 /pub/WWW/Graphics/Color/sRGB.html。提供对定义良好的 CIEXYZ 颜色空间相互转换的方法是为了支持在任意两个颜色空间之间进行高精确度的变换。用户期望 ColorSpace（如 ICC_ColorSpace）的特定子类实现能支持基于基础平台颜色管理系统的高性能变换。toCIEXYZ/fromCIEXYZ 方法使用的 CS_CIEXYZ 空间可以描述如下： CIEXYZ 观看照度：200 勒克斯 观看白色点：CIE D50 介质白色点：“完全反射漫射面”- D50 介质黑色点：0 勒克斯或 0 反射率 流光：1 环绕：介质白色点的 20 介质说明：反射输出（例如，RLAB，Hunt 观看介质） 注：对于要为此变换空间创建 ICC 配置文件的开发人员，可采用下列方法。使用简单的 Von Kries 适用模式将白色点放入 3X3 的矩阵参数中；将流光和环绕效果放入三个一维检索表中（假定每个表都使用了监视器最低限度的模型）。另请参见：ICC_ColorSpace, 序列化表格字段摘要static intCS_CIEXYZ上面定义的 CIEXYZ 变换颜色空间。static intCS_GRAY内置的线性灰度颜色空间。static intCS_LINEAR_RGB内置的线性 RGB 颜色空间。static intCS_PYCCPhoto YCC 变换颜色空间。static intCS_sRGBsRGB 颜色空间的定义位于 /pub/WWW/Graphics/Color/sRGB.html。static intTYPE_2CLRGeneric 2 分量颜色空间。static intTYPE_3CLRGeneric 3 分量颜色空间。static intTYPE_4CLRGeneric 4 分量颜色空间。static intTYPE_5CLRGeneric 5 分量颜色空间。static intTYPE_6CLRGeneric 6 分量颜色空间。static intTYPE_7CLRGeneric 7 分量颜色空间。static intTYPE_8CLRGeneric 8 分量颜色空间。static intTYPE_9CLRGeneric 9 分量颜色空间。static intTYPE_ACLRGeneric 10 分量颜色空间。static intTYPE_BCLRGeneric 11 分量颜色空间。static intTYPE_CCLRGeneric 12 分量颜色空间。static intTYPE_CMYCMY 颜色空间的任意颜色系列。static intTYPE_CMYKCMYK 颜色空间的任意颜色系列。static intTYPE_DCLRGeneric 13 分量颜色空间。static intTYPE_ECLRGeneric 14 分量颜色空间。static intTYPE_FCLRGeneric 15 分量颜色空间。static intTYPE_GRAYGRAY 颜色空间的任意颜色系列。static intTYPE_HLSHLS 颜色空间的任意颜色系列。static intTYPE_HSVHSV 颜色空间的任意颜色系列。static intTYPE_LabLab 颜色空间的任意颜色系列。static intTYPE_LuvLuv 颜色空间的任意颜色系列。static intTYPE_RGBRGB 颜色空间的任意颜色系列。static intTYPE_XYZXYZ 颜色空间的任意颜色系列。static intTYPE_YCbCrYCbCr 颜色空间的任意颜色系列。static intTYPE_YxyYxy 颜色空间的任意颜色系列。 构造方法摘要protectedColorSpace(int type, int numcomponents)构造一个给定颜色空间类型和分量数的 ColorSpace。 方法摘要abstract floatfromCIEXYZ(float colorvalue)将假定为 CS_CIEXYZ 变换颜色空间中的颜色值转换成此 ColorSpace 中的值。abstract floatfromRGB(float rgbvalue)将假定为默认 CS_sRGB 颜色空间中的颜色值转换成此 ColorSpace 中的值。static ColorSpacegetInstance(int colorspace)返回表示特定于预定义颜色空间之一的 ColorSpace。floatgetMaxValue(int component)返回指定分量的最大标准化颜色分量值。floatgetMinValue(int component)返回指定分量的最小标准化颜色分量值。StringgetName(int idx)返回给定分量索引处的分量名称。intgetNumComponents()返回此 ColorSpace 的分量数。intgetType()返回此 ColorSpace 的颜色空间类型（例如 TYPE_RGB、TYPE_XYZ）。booleanisCS_sRGB()如果 ColorSpace 是 CS_sRGB，则返回 true。abstract floattoCIEXYZ(float colorvalue)将假定为此 ColorSpace 中的颜色值转换成 CS_CIEXYZ 变换颜色空间中的值。abstract floattoRGB(float colorvalue)将假定为此 ColorSpace 中的颜色值转换成默认 CS_sRGB 颜色空间中的值。 从类 java.lang.Object 继承的方法clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait字段详细信息 TYPE_XYZpublic static final int TYPE_XYZXYZ 颜色空间的任意颜色系列。 另请参见：常量字段值 TYPE_Labpublic static final int TYPE_LabLab 颜色空间的任意颜色系列。 另请参见：常量字段值 TYPE_Luvpublic static final int TYPE_LuvLuv 颜色空间的任意颜色系列。 另请参见：常量字段值 TYPE_YCbCrpublic static final int TYPE_YCbCrYCbCr 颜色空间的任意颜色系列。 另请参见：常量字段值 TYPE_Yxypublic static final int TYPE_YxyYxy 颜色空间的任意颜色系列。 另请参见：常量字段值 TYPE_RGBpublic static final int TYPE_RGBRGB 颜色空间的任意颜色系列。 另请参见：常量字段值 TYPE_GRAYpublic static final int TYPE_GRAYGRAY 颜色空间的任意颜色系列。 另请参见：常量字段值 TYPE_HSVpublic static final int TYPE_HSVHSV 颜色空间的任意颜色系列。 另请参见：常量字段值 TYPE_HLSpublic static final int TYPE_HLSHLS 颜色空间的任意颜色系列。 另请参见：常量字段值 TYPE_CMYKpublic static final int TYPE_CMYKCMYK 颜色空间的任意颜色系列。 另请参见：常量字段值 TYPE_CMYpublic static final int TYPE_CMYCMY 颜色空间的任意颜色系列。 另请参见：常量字段值 TYPE_2CLRpublic static final int TYPE_2CLRGeneric 2 分量颜色空间。 另请参见：常量字段值 TYPE_3CLRpublic static final int TYPE_3CLRGeneric 3 分量颜色空间。 另请参见：常量字段值 TYPE_4CLRpublic static final int TYPE_4CLRGeneric 4 分量颜色空间。 另请参见：常量字段值 TYPE_5CLRpublic static final int TYPE_5CLRGeneric 5 分量颜色空间。 另请参见：常量字段值 TYPE_6CLRpublic static final int TYPE_6CLRGeneric 6 分量颜色空间。 另请参见：常量字段值 TYPE_7CLRpublic static final int TYPE_7CLRGeneric 7 分量颜色空间。 另请参见：常量字段值 TYPE_8CLRpublic static final int TYPE_8CLRGeneric 8 分量颜色空间。 另请参见：常量字段值 TYPE_9CLRpublic static final int TYPE_9CLRGeneric 9 分量颜色空间。 另请参见：常量字段值 TYPE_ACLRpublic static final int TYPE_ACLRGeneric 10 分量颜色空间。 另请参见：常量字段值 TYPE_BCLRpublic static final int TYPE_BCLRGeneric 11 分量颜色空间。 另请参见：常量字段值 TYPE_CCLRpublic static final int TYPE_CCLRGeneric 12 分量颜色空间。 另请参见：常量字段值 TYPE_DCLRpublic static final int TYPE_DCLRGeneric 13 分量颜色空间。 另请参见：常量字段值 TYPE_ECLRpublic static final int TYPE_ECLRGeneric 14 分量颜色空间。 另请参见：常量字段值 TYPE_FCLRpublic static final int TYPE_FCLRGeneric 15 分量颜色空间。 另请参见：常量字段值 CS_sRGBpublic static final int CS_sRGBsRGB 颜色空间的定义位于 /pub/WWW/Graphics/Color/sRGB.html。 另请参见：常量字段值 CS_LINEAR_RGBpublic static final int CS_LINEAR_RGB内置的线性 RGB 颜色空间。此空间基于与 CS_sRGB 相同的 RGB 原色，但是有一个线性色调再现曲线。 另请参见：常量字段值 CS_CIEXYZpublic static final int CS_CIEXYZ上面定义的 CIEXYZ 变换颜色空间。 另请参见：常量字段值 CS_PYCCpublic static final int CS_PYCCPhoto YCC 变换颜色空间。 另请参见：常量字段值 CS_GRAYpublic static final int CS_GRAY内置的线性灰度颜色空间。 另请参见：常量字段值 构造方法详细信息 ColorSpaceprotected ColorSpace(int type, int numcomponents)构造一个给定颜色空间类型和分量数的 ColorSpace。 参数：type- ColorSpace 类型常量之一numcomponents- 颜色空间中的分量数 方法详细信息 getInstancepublic static ColorSpace getInstance(int colorspace)返回表示特定于预定义颜色空间之一的 ColorSpace。 参数：colorspace- 由某个预定义的类常量标识的特定颜色空间（如 CS_sRGB、CS_LINEAR_RGB、CS_CIEXYZ、CS_GRAY 或 CS_PYCC）返回：请求的 ColorSpace 对象 isCS_sRGBpublic boolean isCS_sRGB()如果 ColorSpace 是 CS_sRGB，则返回 true。 返回：如果这是一个 CS_sRGB 颜色空间，则返回 true；如果不是，则返回 false toRGBpublic abstract float toRGB(float colorvalue)将假定为此 ColorSpace 中的颜色值转换成默认 CS_sRGB 颜色空间中的值。 此方法使用可在输入和输出颜色之间生成最佳感知匹配的算法来转换颜色值。为了完成颜色值的色度变换，应该首先使用此颜色空间的 toCIEXYZ 方法将颜色值从输入颜色空间转换到 CS_CIEXYZ 颜色空间，然后使用 CS_sRGB 颜色空间的 fromCIEXYZ 方法将其从 CS_CIEXYZ 转换到输出颜色空间。有关更多信息，请参阅 toCIEXYZ 和 fromCIEXYZ。参数：colorvalue- 一个长度至少为此 ColorSpace 中分量数的 float 数组返回：一个长度为 3 的 float 数组抛出：ArrayIndexOutOfBoundsException- 如果数组长度小于此 ColorSpace 中的分量数 fromRGBpublic abstract float fromRGB(float rgbvalue)将假定为默认 CS_sRGB 颜色空间中的颜色值转换成此 ColorSpace 中的值。 此方法使用可在输入和输出颜色之间生成最佳感知匹配的算法来转换颜色值。为了完成颜色值的色度变换，应该首先使用 CS_sRGB 颜色空间的 toCIEXYZ 方法将颜色值从输入颜色空间变换到 CS_CIEXYZ 颜色空间，然后使用此颜色空间的 fromCIEXYZ 方法将其从 CS_CIEXYZ 变换到输出颜色空间。有关更多信息，请参阅 toCIEXYZ 和 fromCIEXYZ。参数：rgbvalue- 一个长度至少为 3 的 float 数组返回：一个长度等于 ColorSpace 中分量数的 float 数组抛出：ArrayIndexOutOfBoundsException- 如果数组长度小于 3 toCIEXYZpublic abstract float toCIEXYZ(float colorvalue)将假定为此 ColorSpace 中的颜色值转换成 CS_CIEXYZ 变换颜色空间中的值。 此方法使用相对色度来转换颜色值，由国际色彩联盟标准所定义。这意味着此方法所返回的 XYZ 值是用相对于 CS_CIEXYZ 颜色空间的 D50 白色点来表示的。这种表示方法在两步骤的颜色变换过程中是很有用的，即将输入颜色空间中的颜色转换为 CS_CIEXYZ，然后再转换为输出颜色空间中的颜色。此表示形式与使用色度计由给定颜色值所测量的 XYZ 值不同。计算使用当前 CIE 推荐的做法所测量的 XYZ 值还需要进一步的转换。有关更多信息，请参阅 ICC_ColorSpace 的 toCIEXYZ 方法。参数：colorvalue- 一个长度至少为此 ColorSpace 中分量数的 float 数组返回：一个长度为 3 的 float 数组抛出：ArrayIndexOutOfBoundsException- 如果数组长度小于此 ColorSpace 中的分量数。 fromCIEXYZpublic abstract float fromCIEXYZ(float colorvalue)将假定为 CS_CIEXYZ 变换颜色空间中的颜色值转换成此 ColorSpace 中的值。 此方法使用相对色度来转换颜色值，由国际色彩联盟标准所定义。这意味着此方法所返回的 XYZ 参数值是用相对于 CS_CIEXYZ 颜色空间的 D50 白色点来表示的。这种表示方法在两步骤的颜色变换过程中是很有用的，即将输入颜色空间中的颜色转换为 CS_CIEXYZ，然后再转换为输出颜色空间中的颜色。此方法返回的颜色值与色度计测量时生成并传递给方法的 XYZ 值不同。如果 XYZ 值对应于使用当前 CIE 推荐的做法所测量的值，则在将其传递给此方法前必须将其转换成 D50 的相对值。有关更多信息，请参阅 ICC_ColorSpace 的 fromCIEXYZ 方法。参数：colorvalue- 一个长度至少为 3 的 float 数组返回：一个长度等于 ColorSpace 中分量数的 float 数组抛出：ArrayIndexOutOfBoundsException- 如果数组长度小于 3 getTypepublic int getType()返回此 ColorSpace 的颜色空间类型（例如 TYPE_RGB、TYPE_XYZ）。类型定义了颜色空间的分量数和对它的解释，例如，TYPE_RGB 表示具有三个分量的颜色空间：红色、绿色和蓝色。它并不定义空间的特定颜色特征（如，原色的色度）。 返回：表示此 ColorSpace 类型的类型常量 getNumComponentspublic int getNumComponents()返回此 ColorS