java.awt.color

java.awt.color提供用於顏色空間的類。它包含了基於國際色彩聯盟 (ICC) 配置檔案格式規範（版本 3.4，1997 年 8 月 15 日）的顏色空間實現。它還包含了基於 ICC 配置檔案格式規範的顏色配置檔案。

基本介紹

• 中文名：java.awt.color
• 外文名：無
• 提供：用於顏色空間的類
• 包含了：基於國際色彩聯盟

簡單描述

從以下版本開始： 1.2

詳細介紹

public class Color extends Object implements Serializable下列類的父類：

System Color

該類封裝了使用 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 組成成分的值的字元串。

變數

white

public static final Color white白色。

lightGray

public static final Color lightGray淺灰色。

gray

public static final Color gray灰色。

darkGray

public static final Color darkGray深灰色。

black

public static final Color black黑色。

red

public static final Color red紅色。

pink

public static final Color pink粉紅色。

orange

public static final Color orange桔黃色。

yellow

public static final Color yellow黃色。

green

public static finalColorgreen綠色。

magenta

public static final Color magenta品紅色。

cyan

public static final Color cyan青色。

blue

public static final Color blue藍色。

構造方法

Color

public Color(int r, int g, int b)用指定的紅、綠和藍色成分創建一個顏色。三個參數都必須在 0-255 範圍內。

繪製時實際使用的顏色取決於對給定的輸出設備有效的顏色空間中最匹配的顏色。

參數：r - 紅色成分。 g - 綠色成分。 b - 藍色成分。參見：getRed.,getGreen.,getBlue.,getRGB

Color

public Color(int rgb)用指定的 RGB 值創建一個顏色，其中參數的 16-23 位表示紅色成分，8-15 位表示綠色成分，0-7 位表示藍色成分。0 表示這個基色成分沒有參與顏色構成。

參數：rgb - 給出紅色、綠色和藍色成分的整數。參見：getRGBdefault,getRed.,getGreen.,getBlue.,getRGB.

Colorpublic Color(float r, float g, float b)用指定的紅、綠和藍色值創建一個顏色，其中每個值在 0.0-1.0 範圍內。0.0 值表示這個基色成分沒有貢獻。值 1.0 表示這個基色成分的最大飽和度。

顯示時實際使用的顏色取決於給定的輸出設備的可用顏色空間中最匹配的顏色。

參數：r - 紅色成分 g - 綠色成分 b - 藍色成分參見：getRed.,getGreen.,getBlue.,getRGB.方法

常用方法

getRed

public int getRed()獲取這個顏色的紅色成分。返回結果是一個位於 0 和 255 之間的整數。

返回值：這個顏色的紅色成分。參見：getRGB

getGreen

public int getGreen()獲得這個顏色的綠色成分。返回結果是一個位於 0 和 255 之間的整數。

返回值：這個顏色的綠色成分。參見：getRGB

getBlue

public int getBlue()獲取這個顏色的藍色成分。返回結果是一個位於 0 和 255 之間的整數。

返回值：這個顏色的蘭色成分。參見：getRGB

getRGB

public int getRGB()獲取表示預設的 RGB ColorModel 中的顏色的 RGB 值。顏色的紅、綠和藍色成分被分別縮放為位於 0 ( 缺少這個基色 ) 和 255 ( 完全飽和 ) 之間的值。返回整數的 24-31 位是 0xff ，16-23 位表示紅色值，8-15 位表示綠色值，0-7 位表示藍色值。

參見：getRGBdefault,getRed,getGreen,getBlue

brighter

publicColorbrighter()創建這個顏色的淺顏色版本。

該方法在這個顏色的三個 RGB 成分中的每個成分上施加一個任意的比例因子，來創建一個顏色相同，但較淺的版本。雖然 brighter 和 darker 是一對逆操作，由於捨入誤差，執行一系列這兩個方法的調用的結果可能不一致。

返回值：一個新建 Color 對象， 這個顏色的更淺版本。參見：darker

darker

publicColordarker()創建這個顏色的深顏色版本。

返回值：一個新建 Color 對象， 這個顏色的深顏色版本。參見：brighter

hashCode

public int hashCode()計算這個顏色的散列碼。

返回值：這個對象的散列碼。覆蓋：類Object中的hashCode

equals

public booleanequals(Objectobj)確定另一個對象是否與這個顏色相同。

若且唯若參數不為 null ，並且存在一個紅色、綠色和藍色值與這個對象相同的 Color 對象時，結果為 true 。

參數：obj - 比較的對象。返回值：如果是相同對象，則返回 true ，否則返回 false 。覆蓋：類Object中的equals

toString

publicStringtoString()創建一個表示這個顏色和它的 RGB 組成成分的值的字元串。

返回值：表示這個顏色的 String 對象。覆蓋：類Object中的toString

decode

public staticColordecode(Stringnm) throwsNumberFormatException將一個字元串轉換為一個整數，並返回指定的顏色。這個方法處理用於表示八進制和十六進制數的字元串格式。

參數：nm - 將顏色表示為 24 位整數的字元串。返回值：新顏色拋出：NumberFormatException若指定的字元串不能解釋為一個十進制，八進制或十六進制整數。參見：decode

getColor

public staticColorgetColor(Stringnm)查找系統特性中的一個顏色。

參數被當作要獲得的系統特性名來處理。其後，這個特性的字元串值被解釋為一個整數，這個整數接著被轉換成一個顏色。

若指定的特性未找到，或不能當作一個整數來分析，將返回 null 。

參數：nm - 顏色特性的名字返回值：特性的顏色值。參見：getProperty,getInteger,Color

getColor

第一個參數被當做獲得的系統特性名來處理。其後，這個特性的字元串值被解釋為一個整數，這個整數接著被轉換為一個顏色。

若指定的特性未找到，或不能當作一個整數來分析，則返回由第二個參數指定的顏色。

參數：nm - 顏色特性的名字 v - 預設的顏色值。返回值：特性的顏色值。參見：getProperty,getInteger,Color

getColor

若指定的特性未找到，或不能當作一個整數來分析，則使用整數值 v 來替代，並將其轉換為一個顏色。

參數：nm - 顏色特性的名字。 v - 預設的整數顏色值。返回值：特性的顏色值。參見：getProperty,getInteger,Color

HSBtoRGB

HSBtoRGB 返回的整數對整數值中的 0&endash;23 位的顏色值進行編碼，方法 getRGB 使用相同的格式。這個整數可作為帶一個單個整數參數的Color構造子的一個參數。

參數：hue - 顏色的色元。 saturation - 顏色的飽和度。 brightness - 顏色的亮度。返回值：含色調、飽和度和亮度的顏色的 RGB 值。參見：getRGB,Color

RGBtoHSB

若 hsbvals 參數為 null ，則分配一個新的數組來返回結果。否則。該方法返回 hsbvals數組，和存放在數組中的值。

參數：r - 這個顏色的紅色成分。 g - 這個顏色的綠色成分。 b - 這個顏色的藍色成分。 hsbvals - 用於返回三個 HSB 值的數組，或為 null 。返回值：一個包含三個元素的數組，每個元素包含顏色的色調、飽和度和亮度 (按此排序) ，來表示紅色、綠色和藍色成分。參見：getRGB,Color

getHSBColor

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 對象