类 java.awt.Color

java.lang.Object
   |
   +----java.awt.Color

public class Color

extends Object

implements Serializable

下列类的父类：

SystemColor

该类封装了使用 RGB 格式的颜色。在 RGB 格式中，颜色的红、绿、蓝成分分别用一个位于 0-255 范围内的整数表示。0 表示这个基色成分没有贡献颜色。 255 表示这个颜色成分的最大饱和度。

虽然，Color 类基于包含三个成分的 RGB 模型，它还为 RGB 和 HSB 颜色之间的转换提供了一系列便利方法。可参见 Foley, van Dam, Feiner, and Hughes, Computer Graphics: Principles and Practice ，来查看 RGB 和 HSB 颜色模型的定义。

变量索引

black

黑色。

blue

兰色。

cyan

青色。

darkGray

深灰色。

gray

灰色。

green

绿色。

lightGray

浅灰色。

magenta

品红色。

orange

桔黄色。

pink

粉红色。

red

红色。

white

白色。

yellow

黄色。

构造子索引

Color(float, float, float)

用指定的红、绿和兰色值创建一个颜色，其中每个值在 0.0-1.0 范围内。

Color(int)

用指定的 RGB 值创建一个颜色，其中参数的 16-23 位表示红色成分，8-15 位表示绿色成分，0-7 位表示兰色成分。

Color(int, int, int)

用指定的红、绿和兰色成分创建一个颜色。

方法索引

brighter()

创建这个颜色的浅颜色版本。

darker()

创建这个颜色的深颜色版本。

decode(String)

将一个字符串转换为一个整数，并返回指定的颜色。

equals(Object)

确定另一个对象是否与这个颜色相同。

getBlue()

获取这个颜色的兰色成分。

getColor(String)

查找系统特性中的一个颜色。

getColor(String, Color)

查找系统特性中的一个颜色。

getColor(String, int)

查找系统特性中的一个颜色。

getGreen()

获得这个颜色的绿色成分。

getHSBColor(float, float, float)

创建一个基于为 HSB 颜色模型提供的值的 Color 对象。

getRed()

获取这个颜色的红色成分。

getRGB()

获取表示缺省的 RGB ColorModel 中的颜色的 RGB 值。

hashCode()

计算这个颜色的散列码。

HSBtoRGB(float, float, float)

将用 HSB 模型指定的颜色的成分转换为等价的 RGB 模型的值的集合。

RGBtoHSB(int, int, int, float[])

将用 RGB 模式指定的颜色的成分转换为等价的 HSB 模型的三基色的色调、饱和度和亮度值集合。

toString()

创建一个表示这个颜色和它的 RGB 组成成分的值的字符串。

变量

 public static final Color white

白色。

 public static final Color lightGray

浅灰色。

 public static final Color gray

灰色。

 public static final Color darkGray

深灰色。

 public static final Color black

黑色。

 public static final Color red

红色。

 public static final Color pink

粉红色。

 public static final Color orange

桔黄色。

 public static final Color yellow

黄色。

 public static final Color green

绿色。

 public static final Color magenta

品红色。

 public static final Color cyan

青色。

 public static final Color blue

兰色。

构造子

 public Color(int r,
              int g,
              int b)

用指定的红、绿和兰色成分创建一个颜色。三个参数都必须在 0-255 范围内。

绘制时实际使用的颜色取决于对给定的输出设备有效的颜色空间中最匹配的颜色。

参数：

r - 红色成分。

g - 绿色成分。

b - 兰色成分。

参见：

getRed., getGreen., getBlue., getRGB.

 public Color(int rgb)

用指定的 RGB 值创建一个颜色，其中参数的 16-23 位表示红色成分，8-15 位表示绿色成分，0-7 位表示兰色成分。0 表示这个基色成分没有参与颜色构成。

绘制时实际使用的颜色取决于对给定的输出设备有效的颜色空间中最匹配的颜色。

参数：

rgb - 给出红色、绿色和兰色成分的整数。

参见：

getRGBdefault, getRed., getGreen., getBlue., getRGB.

 public Color(float r,
              float g,
              float b)

用指定的红、绿和兰色值创建一个颜色，其中每个值在 0.0-1.0 范围内。0.0 值表示这个基色成分没有贡献。值 1.0 表示这个基色成分的最大饱和度。

显示时实际使用的颜色取决于给定的输出设备的可用颜色空间中最匹配的颜色。

参数：

r - 红色成分

g - 绿色成分

b - 兰色成分

参见：

getRed., getGreen., getBlue., getRGB.

方法

 public int getRed()

获取这个颜色的红色成分。返回结果是一个位于 0 和 255 之间的整数。

返回值：

这个颜色的红色成分。

参见：

getRGB

 public int getGreen()

获得这个颜色的绿色成分。返回结果是一个位于 0 和 255 之间的整数。

返回值：

这个颜色的绿色成分。

参见：

getRGB

 public int getBlue()

获取这个颜色的兰色成分。返回结果是一个位于 0 和 255 之间的整数。

返回值：

这个颜色的兰色成分。

参见：

getRGB

 public int getRGB()

获取表示缺省的 RGB ColorModel 中的颜色的 RGB 值。颜色的红、绿和兰色成分被分别缩放为位于 0 ( 缺少这个基色 ) 和 255 ( 完全饱和 ) 之间的值。返回整数的 24-31 位是 0xff ，16-23 位表示红色值，8-15 位表示绿色值，0-7 位表示兰色值。

参见：

getRGBdefault, getRed, getGreen, getBlue

 public Color brighter()

创建这个颜色的浅颜色版本。

该方法在这个颜色的三个 RGB 成分中的每个成分上施加一个任意的比例因子，来创建一个颜色相同，但较浅的版本。虽然 brighter 和 darker 是一对逆操作，由于舍入误差，执行一系列这两个方法的调用的结果可能不一致。

返回值：

一个新建 Color 对象， 这个颜色的更浅版本。

参见：

darker

 public Color darker()

创建这个颜色的深颜色版本。

该方法在这个颜色的三个 RGB 成分中的每个成分上施加一个任意的比例因子，来创建一个颜色相同，但颜色较深的版本。 虽然 brighter 和 darker 是一对逆操作，由于舍入误差，执行一系列这两个方法的调用的结果可能不一致。

返回值：

一个新建 Color 对象， 这个颜色的深颜色版本。

参见：

brighter

 public int hashCode()

计算这个颜色的散列码。

返回值：

这个对象的散列码。

覆盖：

类 Object 中的 hashCode

 public boolean equals(Object obj)

确定另一个对象是否与这个颜色相同。

当且仅当参数不为 null ，并且存在一个红色、绿色和兰色值与这个对象相同的 Color 对象时，结果为 true 。

参数：

obj - 比较的对象。

返回值：

如果是相同对象，则返回 true ，否则返回 false 。

覆盖：

类 Object 中的 equals

 public String toString()

创建一个表示这个颜色和它的 RGB 组成成分的值的字符串。

返回值：

表示这个颜色的 String 对象。

覆盖：

类 Object 中的 toString

 public static Color decode(String nm) throws NumberFormatException

将一个字符串转换为一个整数，并返回指定的颜色。这个方法处理用于表示八进制和十六进制数的字符串格式。

参数：

nm - 将颜色表示为 24 位整数的字符串。

返回值：

新颜色

抛出： NumberFormatException

若指定的字符串不能解释为一个十进制，八进制或十六进制整数。

参见：

decode

 public static Color getColor(String nm)

查找系统特性中的一个颜色。

参数被当作要获得的系统特性名来处理。其后，这个特性的字符串值被解释为一个整数，这个整数接着被转换成一个颜色。

若指定的特性未找到，或不能当作一个整数来分析，将返回 null 。

参数：

nm - 颜色特性的名字

返回值：

特性的颜色值。

参见：

getProperty, getInteger, Color

 public static Color getColor(String nm,
                              Color v)

查找系统特性中的一个颜色。

第一个参数被当做获得的系统特性名来处理。其后，这个特性的字符串值被解释为一个整数，这个整数接着被转换为一个颜色。

若指定的特性未找到，或不能当作一个整数来分析，则返回由第二个参数指定的颜色。

参数：

nm - 颜色特性的名字

v - 缺省的颜色值。

返回值：

特性的颜色值。

参见：

getProperty, getInteger, Color

 public static Color getColor(String nm,
                              int v)

查找系统特性中的一个颜色。

第一个参数被当做获得的系统特性名来处理。其后，这个特性的字符串值被解释为一个整数，这个整数接着被转换为一个颜色。

若指定的特性未找到，或不能当作一个整数来分析，则使用整数值 v 来替代，并将其转换为一个颜色。

参数：

nm - 颜色特性的名字。

v - 缺省的整数颜色值。

返回值：

特性的颜色值。

参见：

getProperty, getInteger, Color

 public static int HSBtoRGB(float hue,
                            float saturation,
                            float brightness)

将由 HSB 模型指定的颜色的成分转换为等价的 RGB 模型的值的集合。

HSBtoRGB 返回的整数对整数值中的 0&endash;23 位的颜色值进行编码，方法 getRGB 使用相同的格式。这个整数可作为带一个单个整数参数的Color 构造子的一个参数。

参数：

hue - 颜色的色元。

saturation - 颜色的饱和度。

brightness - 颜色的亮度。

返回值：

含色调、饱和度和亮度的颜色的 RGB 值。

参见：

getRGB, Color

 public static float[] RGBtoHSB(int r,
                                int g,
                                int b,
                                float hsbvals[])

将用 RGB 模式指定的颜色的成分转换为等价的 HSB 模型的三基色的色调、饱和度和亮度值集合。

若 hsbvals 参数为 null ，则分配一个新的数组来返回结果。否则。该方法返回 hsbvals 数组，和存放在数组中的值。

参数：

r - 这个颜色的红色成分。

g - 这个颜色的绿色成分。

b - 这个颜色的兰色成分。

hsbvals - 用于返回三个 HSB 值的数组，或为 null 。

返回值：

一个包含三个元素的数组，每个元素包含颜色的色调、饱和度和亮度 (按此排序) ，来表示红色、绿色和兰色成分。

参见：

getRGB, Color

 public static Color getHSBColor(float h,
                                 float s,
                                 float b)

创建一个基于为 HSB 颜色模型提供的值的 Color 对象。

三个成分的每一个成分应是位于 0 和 1 之间的浮点数 ( 在 0.0 ≤ h, s, b ≤ 1.0 之间的数值 ) 。

参数：

h - 色元。

s - 颜色的饱和度。

b - 颜色的亮度。

返回值：

一个指定色调、饱和度和亮度的 Color 对象。