|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一個類別 下一個類別 | 框架 無框架 | |||||||||
摘要: 巢狀 | 欄位 | 建構子 | 方法 | 詳細資訊: 欄位 | 建構子 | 方法 |
java.lang.Object java.awt.Color
public class Color
Color
類別用於封裝預設 sRGB 顏色空間中的顏色,或者用於封裝由 ColorSpace
標識的任意顏色空間中的顏色。每種顏色都有一個隱式的 alpha 值 1.0,或者有一個在建構子中提供的顯式的 alpha 值。alpha 值定義了顏色的透明度,可用一個在 0.0 - 1.0 或 0 - 255 範圍內的浮點值表示它。alpha 值為 1.0 或 255 則意味著顏色完全是不透明的,alpha 值為 0 或 0.0 則意味著顏色是完全透明的。在使用顯式的 alpha 值建構 Color
時,或者在獲取某個 Color
的顏色/alpha 份量時,從不將顏色份量預乘 alpha 份量。
Java 2D(tm) API 的預設顏色空間是 sRGB,這是一個被推薦使用的標準 RGB 顏色空間。有關 sRGB 的更多資訊,請參閱 http://www.w3.org/pub/WWW/Graphics/Color/sRGB.html。
ColorSpace
,
AlphaComposite
,
序列化表格欄位摘要 | |
---|---|
static Color |
black
黑色。 |
static Color |
BLACK
黑色。 |
static Color |
blue
藍色。 |
static Color |
BLUE
藍色。 |
static Color |
cyan
青色。 |
static Color |
CYAN
青色。 |
static Color |
DARK_GRAY
深灰色。 |
static Color |
darkGray
深灰色。 |
static Color |
gray
灰色。 |
static Color |
GRAY
灰色。 |
static Color |
green
綠色。 |
static Color |
GREEN
綠色。 |
static Color |
LIGHT_GRAY
淺灰色。 |
static Color |
lightGray
淺灰色。 |
static Color |
magenta
洋紅色。 |
static Color |
MAGENTA
洋紅色。 |
static Color |
orange
桔黃色。 |
static Color |
ORANGE
桔黃色。 |
static Color |
pink
粉紅色。 |
static Color |
PINK
粉紅色。 |
static Color |
red
紅色。 |
static Color |
RED
紅色。 |
static Color |
white
白色。 |
static Color |
WHITE
白色。 |
static Color |
yellow
黃色。 |
static Color |
YELLOW
黃色。 |
從介面 java.awt.Transparency 繼承的欄位 |
---|
BITMASK, OPAQUE, TRANSLUCENT |
建構子摘要 | |
---|---|
Color(ColorSpace cspace,
float[] components,
float alpha)
創建具有 float 陣列中指定的顏色份量和指定的 alpha 值的指定 ColorSpace 中的顏色。 |
|
Color(float r,
float g,
float b)
創建具有指定紅色、綠色和藍色值的不透明的 sRGB 顏色,這三個顏色值都在 (0.0 - 1.0) 的範圍內。 |
|
Color(float r,
float g,
float b,
float a)
創建具有指定紅色、綠色、藍色和 alpha 值的 sRGB 顏色,這些值都在 (0.0 - 1.0) 的範圍內。 |
|
Color(int rgb)
創建具有指定組合的 RGB 值的不透明的 sRGB 顏色,此 sRGB 值的 16-23 位表示紅色份量,8-15 位表示綠色份量,0-7 位表示藍色份量。 |
|
Color(int rgba,
boolean hasalpha)
創建具有指定組合的 RGBA 值的 sRGB 顏色,此 RGBA 值的 24-31 位表示 alpha 份量,16-23 位表示紅色份量,8-15 位表示綠色份量,0-7 位表示藍色份量。 |
|
Color(int r,
int g,
int b)
創建具有指定紅色、綠色和藍色值的不透明的 sRGB 顏色,這些值都在 (0 - 255) 的範圍內。 |
|
Color(int r,
int g,
int b,
int a)
創建具有指定紅色、綠色、藍色和 alpha 值的 sRGB 顏色,這些值都在 (0 - 255) 的範圍內。 |
方法摘要 | |
---|---|
Color |
brighter()
創建一個新 Color ,它具有比此 Color 更亮的顏色。 |
PaintContext |
createContext(ColorModel cm,
Rectangle r,
Rectangle2D r2d,
AffineTransform xform,
RenderingHints hints)
創建並返回用來產生固定顏色網要的 PaintContext 。 |
Color |
darker()
創建一個新 Color ,它具有比此 Color 更暗的顏色。 |
static Color |
decode(String nm)
將 String 轉換成整數,並返回指定的不透明 Color 。 |
boolean |
equals(Object obj)
確定另一個物件是否與此 Color 相同。 |
int |
getAlpha()
返回位於範圍 0-255 中的 alpha 份量。 |
int |
getBlue()
返回預設 sRGB 空間中位於範圍 0-255 中的藍色份量。 |
static Color |
getColor(String nm)
尋找系統屬性中的一種顏色。 |
static Color |
getColor(String nm,
Color v)
尋找系統屬性中的一種顏色。 |
static Color |
getColor(String nm,
int v)
尋找系統屬性中的一種顏色。 |
float[] |
getColorComponents(ColorSpace cspace,
float[] compArray)
根據由 cspace 參數指定的 ColorSpace ,返回一個 float 陣列,該陣列只包含 Color 的顏色份量。 |
float[] |
getColorComponents(float[] compArray)
根據 Color 的 ColorSpace ,返回一個 float 陣列,該陣列只包含 Color 的顏色份量。 |
ColorSpace |
getColorSpace()
返回此 Color 的 ColorSpace 。 |
float[] |
getComponents(ColorSpace cspace,
float[] compArray)
根據由 cspace 參數指定的 ColorSpace ,返回一個 float 陣列,該陣列只包含 Color 的 alpha 份量。 |
float[] |
getComponents(float[] compArray)
根據 Color 的 ColorSpace ,返回一個 float 陣列,該陣列包含 Color 的顏色份量和 alpha 份量。 |
int |
getGreen()
返回預設 sRGB 空間中位於範圍 0-255 中的綠色份量。 |
static Color |
getHSBColor(float h,
float s,
float b)
根據所指定的數值,創建一個基於 HSB 顏色模型的 Color 物件。 |
int |
getRed()
返回預設 sRGB 空間中位於範圍 0-255 中的紅色份量。 |
int |
getRGB()
返回預設 sRGB ColorModel 中表示顏色的 RGB 值。 |
float[] |
getRGBColorComponents(float[] compArray)
根據預設的 sRGB color space,返回一個 float 陣列,該陣列只包含 Color 的顏色份量。 |
float[] |
getRGBComponents(float[] compArray)
根據預設的 sRGB color space,返回一個 float 陣列,該陣列包含 Color 的顏色份量和 alpha 份量。 |
int |
getTransparency()
返回此 Color 的透明網要。 |
int |
hashCode()
計算此 Color 的雜湊碼。 |
static int |
HSBtoRGB(float hue,
float saturation,
float brightness)
將由 HSB 模型指定的顏色份量轉換為等價的預設 RGB 模型的值的集合。 |
static float[] |
RGBtoHSB(int r,
int g,
int b,
float[] hsbvals)
將預設 RGB 網要指定的顏色份量轉換為等價的色調、飽和度和亮度值的集合,這三個值是 HSB 模型的三個份量。 |
String |
toString()
返回此 Color 的字元串表示形式。 |
從類別 java.lang.Object 繼承的方法 |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
欄位詳細資訊 |
---|
public static final Color white
public static final Color WHITE
public static final Color lightGray
public static final Color LIGHT_GRAY
public static final Color gray
public static final Color GRAY
public static final Color darkGray
public static final Color DARK_GRAY
public static final Color black
public static final Color BLACK
public static final Color red
public static final Color RED
public static final Color pink
public static final Color PINK
public static final Color orange
public static final Color ORANGE
public static final Color yellow
public static final Color YELLOW
public static final Color green
public static final Color GREEN
public static final Color magenta
public static final Color MAGENTA
public static final Color cyan
public static final Color CYAN
public static final Color blue
public static final Color BLUE
建構子詳細資訊 |
---|
public Color(int r, int g, int b)
r
- 紅色份量g
- 綠色份量b
- 藍色份量
IllegalArgumentException
- 如果 r
、g
或 b
超出 0 到 255(包括)的範圍getRed()
,
getGreen()
,
getBlue()
,
getRGB()
public Color(int r, int g, int b, int a)
r
- 紅色份量g
- 綠色份量b
- 藍色份量a
- alpha 份量
IllegalArgumentException
- 如果 r
、g
、b
或 a
超出 0 到 255(包括)的範圍getRed()
,
getGreen()
,
getBlue()
,
getAlpha()
,
getRGB()
public Color(int rgb)
rgb
- 組合的 RGB 份量ColorModel.getRGBdefault()
,
getRed()
,
getGreen()
,
getBlue()
,
getRGB()
public Color(int rgba, boolean hasalpha)
hasalpha
參數為 false
,則 alpha 值為預設值 255。
rgba
- 組合的 RGBA 份量hasalpha
- 如果 alpha 的位有效,則該參數為 true
;否則為 false
ColorModel.getRGBdefault()
,
getRed()
,
getGreen()
,
getBlue()
,
getAlpha()
,
getRGB()
public Color(float r, float g, float b)
r
- 紅色份量g
- 綠色份量b
- 藍色份量
IllegalArgumentException
- 如果 r
、g
或 b
超出 0.0 到 1.0(包括)的範圍getRed()
,
getGreen()
,
getBlue()
,
getRGB()
public Color(float r, float g, float b, float a)
r
- 紅色份量g
- 綠色份量b
- 藍色份量a
- alpha 份量
IllegalArgumentException
- 如果 r
、g
、b
或 a
超出 0.0 到 1.0(包括)的範圍getRed()
,
getGreen()
,
getBlue()
,
getAlpha()
,
getRGB()
public Color(ColorSpace cspace, float[] components, float alpha)
float
陣列中指定的顏色份量和指定的 alpha 值的指定 ColorSpace
中的顏色。份量的數量由 ColorSpace
的型別確定。例如,RGB 需要 3 個份量,但 CMYK 需要 4 個份量。
cspace
- 用來解釋份量的 ColorSpace
components
- 與 ColorSpace
相容的任意數量的顏色份量alpha
- alpha 值
IllegalArgumentException
- 如果 components
陣列中的任意某個值或 alpha
值超出 0.0 到 1.0 的範圍getComponents(float[])
,
getColorComponents(float[])
方法詳細資訊 |
---|
public int getRed()
getRGB()
public int getGreen()
getRGB()
public int getBlue()
getRGB()
public int getAlpha()
getRGB()
public int getRGB()
ColorModel
中表示顏色的 RGB 值。(24-31 位表示 alpha,16-23 位表示紅色,8-15 位表示綠色,0-7 位表示藍色)。
ColorModel
中表示顏色的 RGB 值。ColorModel.getRGBdefault()
,
getRed()
,
getGreen()
,
getBlue()
public Color brighter()
Color
,它具有比此 Color
更亮的顏色。
此方法對這個 Color
的三個 RGB 份量都使用了一個任意縮放因子,以創建具有更亮顏色的 Color
。brighter
和 darker
是相反的操作,因為捨入誤差,所以連續多次調用這兩個方法所產生的結果可能是不一致的。
Color
,它具有比此 Color
更亮的顏色。darker()
public Color darker()
Color
,它具有比此 Color
更暗的顏色。
此方法對這個 Color
的三個 RGB 份量都使用了一個任意縮放因子,以創建具有更暗顏色的 Color
。brighter
和 darker
是相反的操作,因為捨入誤差,所以連續多次調用這兩個方法所產生的結果可能是不一致的。
Color
,它具有比此 Color
更暗的顏色。brighter()
public int hashCode()
Color
的雜湊碼。
Object
中的 hashCode
Object.equals(java.lang.Object)
,
Hashtable
public boolean equals(Object obj)
Color
相同。
當且僅當此參數不為 null
,並且是一個與此物件具有相同紅色、綠色、藍色和 alpha 值的 Color
物件時,結果才是 true
。
Object
中的 equals
obj
- 用來與此 Color
進行等同性測試的物件
true
;否則返回 false
Object.hashCode()
,
Hashtable
public String toString()
Color
的字元串表示形式。此方法只適用於除錯。返回的字元串的內容和格式在各種實作間可能各不相同。返回的字元串可以為空,但不可以為 null
。
Object
中的 toString
Color
的字元串表示形式。public static Color decode(String nm) throws NumberFormatException
String
轉換成整數,並返回指定的不透明 Color
。此方法處理用來表示八進制和十六進制數字的字元串格式。
nm
- 將某種不透明顏色表示為 24 位整數的 String
Color
物件。
NumberFormatException
- 如果不能將指定的字元串解釋為十進制、八進制或十六進制的整數。Integer.decode(java.lang.String)
public static Color getColor(String nm)
該參數被視為要獲得的系統屬性的名稱。然後,將此屬性的字元串值解釋為一個整數值,該整數隨後被轉換為一個 Color
物件。
如果沒有找到指定的屬性,或者無法將它當作一個整數來分析,則返回 null
。
nm
- 顏色屬性的名稱
Color
System.getProperty(java.lang.String)
,
Integer.getInteger(java.lang.String)
,
Color(int)
public static Color getColor(String nm, Color v)
第一個參數被視為要獲得的系統屬性的名稱。然後,將此屬性的字元串值解釋為一個整數值,該整數隨後被轉換為一個 Color
物件。
如果沒有找到指定的屬性,或者不能將該屬性當作一個整數來分析,則返回由第二個參數指定的 Color
。
nm
- 顏色屬性的名稱v
- 預設的 Color
Color
,或者指定的 Color
System.getProperty(java.lang.String)
,
Integer.getInteger(java.lang.String)
,
Color(int)
public static Color getColor(String nm, int v)
第一個參數被視為要獲得的系統屬性的名稱。然後,將此屬性的字元串值解釋為一個整數值,該整數隨後被轉換為一個 Color
物件。
如果沒有找到指定的屬性,或者不能將該屬性當作一個整數來分析,則使用整數值 v
來替代,並將它轉換為一個 Color
物件。
nm
- 顏色屬性的名稱v
- 預設的整數形式的顏色值
Color
或者指定整數所轉換的 Color
System.getProperty(java.lang.String)
,
Integer.getInteger(java.lang.String)
,
Color(int)
public static int HSBtoRGB(float hue, float saturation, float brightness)
saturation
和 brightness
份量應該是 0 到 1 之間的浮點值(範圍在 0.0-1.0 之間的數字)。hue
份量可以是任意浮點數字。從這個數字中減去該數字的進制,便可以創建 0 和 1 之間的小數部分。然後,將這個數字乘以 360 就可以得到 HSB 顏色網要中的色彩角度。
HSBtoRGB
返回的整數在整數值 0-23 的位中對顏色值進行了編碼,該整數值的格式與
使用的格式相同。可以將這個整數作為一個參數提供給 getRGB
Color
建構子,此建構子僅帶有一個參數。
hue
- 顏色的灰度份量saturation
- 顏色的飽和度brightness
- 顏色的亮度
getRGB()
,
Color(int)
,
ColorModel.getRGBdefault()
public static float[] RGBtoHSB(int r, int g, int b, float[] hsbvals)
如果 hsbvals
參數為 null
,則分派一個新的陣列來返回結果。否則。該方法將返回 hsbvals
陣列,以及存放在陣列中的值。
r
- 該顏色的紅色份量g
- 該顏色的綠色份量b
- 該顏色的藍色份量hsbvals
- 用來返回三個 HSB 值的陣列,或者為 null
getRGB()
,
Color(int)
,
ColorModel.getRGBdefault()
public static Color getHSBColor(float h, float s, float b)
Color
物件。
s
和 b
份量應該是 0 到 1 之間的浮點值(範圍在 0.0-1.0 之間的數字)。h
份量可以是任意浮點數字。從這個數字中減去該數字的進制,便可以創建 0 和 1 之間的小數部分。然後,將這個數字乘以 360 就可以得到 HSB 顏色網要中的色彩角度。
h
- hue 份量s
- 顏色的飽和度b
- 顏色的亮度
Color
物件。public float[] getRGBComponents(float[] compArray)
float
陣列,該陣列包含 Color
的顏色份量和 alpha 份量。如果 compArray
為 null
,則將為返回值創建一個長度為 4 的陣列。否則,compArray
的長度必須是 4 或大於 4,並被上述份量和返回的值填充。
compArray
- 此方法用顏色份量、alpha 份量和返回的值填充的陣列
float
陣列中的 RGBA 份量。public float[] getRGBColorComponents(float[] compArray)
float
陣列,該陣列只包含 Color
的顏色份量。如果 compArray
為 null
,則將為返回值創建一個長度為 3 的陣列。否則,compArray
的長度必須是 3 或大於 4,並被上述份量和返回的值填充。
compArray
- 此方法用顏色份量和返回的值填充的陣列
float
陣列中的 RGB 份量。public float[] getComponents(float[] compArray)
Color
的 ColorSpace
,返回一個 float
陣列,該陣列包含 Color
的顏色份量和 alpha 份量。如果 compArray
為 null
,則將為返回值創建一個陣列,該陣列的長度等於相關 ColorSpace
中的份量數加 1。否則,compArray
的長度至少必須為該長度,並被上述份量和返回的值填充。
compArray
- 此方法用 ColorSpace
中此 Color
的顏色份量和 alpha 份量填充並返回的陣列
float
陣列中的顏色份量和 alpha 份量。public float[] getColorComponents(float[] compArray)
Color
的 ColorSpace
,返回一個 float
陣列,該陣列只包含 Color
的顏色份量。如果 compArray
為 null
,則將為返回值創建一個陣列,該陣列的長度等於相關 ColorSpace
中的份量數。否則,compArray
的長度至少必須為該長度,並被上述份量和返回的值填充。
compArray
- 此方法用 ColorSpace
中此 Color
的顏色份量填充並返回的陣列
float
陣列中的顏色份量。public float[] getComponents(ColorSpace cspace, float[] compArray)
cspace
參數指定的 ColorSpace
,返回一個 float
陣列,該陣列只包含 Color
的 alpha 份量。如果 compArray
為 null
,則將為返回值創建一個陣列,該陣列的長度等於 cspace
中的份量數加 1。否則,compArray
的長度至少必須為該長度,並被上述份量和返回的值填充。
cspace
- 一個指定的 ColorSpace
compArray
- 此方法用指定 ColorSpace
中此 Color
的顏色份量和 alpha 份量填充並返回的陣列
float
陣列中的顏色份量和 alpha 份量。public float[] getColorComponents(ColorSpace cspace, float[] compArray)
cspace
參數指定的 ColorSpace
,返回一個 float
陣列,該陣列只包含 Color
的顏色份量。如果 compArray
為 null
,則將為返回值創建一個陣列,該陣列的長度等於 cspace
中的份量數。否則,compArray
的長度至少必須為該長度,並被上述份量和返回的值填充。
cspace
- 一個指定的 ColorSpace
compArray
- 此方法用指定 ColorSpace
中此 Color
的顏色份量填充的陣列
float
陣列中的顏色份量。public ColorSpace getColorSpace()
Color
的 ColorSpace
。
Color
物件的 ColorSpace
。public PaintContext createContext(ColorModel cm, Rectangle r, Rectangle2D r2d, AffineTransform xform, RenderingHints hints)
PaintContext
。這使得任何一個需要以一個實作了 Paint
介面的物件為參數的方法,都可以用 Color
物件做該參數。不管 r
、r2d
、xform
或 hints
是否為 null
,返回的都是相同的 PaintContext
。
Paint
中的 createContext
cm
- 指定的 ColorModel
r
- 指定的 Rectangle
r2d
- 指定的 Rectangle2D
xform
- 指定的 AffineTransform
hints
- 指定的 RenderingHints
PaintContext
Paint
,
PaintContext
,
Graphics2D.setPaint(java.awt.Paint)
public int getTransparency()
Color
的透明網要。當實作 Paint
介面時需要用到此方法。
Transparency
中的 getTransparency
Color
物件的透明網要。Paint
,
Transparency
,
createContext(java.awt.image.ColorModel, java.awt.Rectangle, java.awt.geom.Rectangle2D, java.awt.geom.AffineTransform, java.awt.RenderingHints)
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一個類別 下一個類別 | 框架 無框架 | |||||||||
摘要: 巢狀 | 欄位 | 建構子 | 方法 | 詳細資訊: 欄位 | 建構子 | 方法 |
版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。