クラスColor
- すべての実装されたインタフェース:
Paint,Transparency,Serializable
- 直系の既知のサブクラス:
ColorUIResource,SystemColor
Colorクラスは、デフォルトのsRGBカラー・スペース内の色、またはColorSpaceで識別される任意のカラー・スペース内の色をカプセル化するために使用されます。 どの色にも、1.0の暗黙のアルファ値、またはコンストラクタで提供される明示的なアルファ値があります。 アルファ値は色の透過性を定義し、0.0 - 1.0または0 - 255の範囲のfloat値で表すことができます。 1.0あるいは255というアルファ値はその色が完全に不透明であることを意味し、0あるいは0.0というアルファ値はその色が完全に透明であることを意味します。 明示的なアルファでColorを構築する場合、あるいはColorの色成分またはアルファ成分を取得する場合、色成分とアルファ成分があらかじめ乗算されている可能性はありません。
Java 2D (tm) APIのデフォルトのカラー・スペースは、標準のRGBカラー・スペースとして推奨されているsRGBです。 sRGBの詳細は、http://www.w3.org/pub/WWW/Graphics/Color/sRGB.htmlを参照してください。
- 関連項目:
-
フィールドのサマリー
フィールド修飾子と型フィールド説明static final Color黒を表します。static final Color黒を表します。static final Color青を表します。static final Color青を表します。static final Colorシアンを表します。static final Colorシアンを表します。static final Colorダーク・グレーを表します。static final Colorダーク・グレーを表します。static final Colorグレーを表します。static final Colorグレーを表します。static final Color緑を表します。static final Color緑を表します。static final Colorライト・グレーを表します。static final Colorライト・グレーを表します。static final Colorマゼンタを表します。static final Colorマゼンタを表します。static final Colorオレンジを表します。static final Colorオレンジを表します。static final Colorピンクを表します。static final Colorピンクを表します。static final Color赤を表します。static final Color赤を表します。static final Color白を表します。static final Color白を表します。static final Color黄を表します。static final Color黄を表します。インタフェースjava.awt.Transparencyで宣言されているフィールド
BITMASK, OPAQUE, TRANSLUCENT -
コンストラクタのサマリー
コンストラクタコンストラクタ説明Color(float r, float g, float b) 範囲(0.0 - 1.0)の指定された赤、緑、青の値を使って、不透明なsRGBカラーを生成します。Color(float r, float g, float b, float a) 範囲(0.0 - 1.0)の指定された赤、緑、青、およびアルファ値を使ってsRGBカラーを生成します。Color(int rgb) ビット16-23の赤色成分、ビット8-15の緑色成分、およびビット0-7の青色成分から合成された、指定されたRGB値を使って、不透明なsRGBカラーを生成します。Color(int rgba, boolean hasalpha) ビット24 - 31のアルファ成分、ビット16 - 23の赤色成分、ビット8 - 15の緑色成分、およびビット0 - 7の青色成分で構成される、指定されたRGBA値を持つ、sRGBカラーを生成します。Color(int r, int g, int b) 範囲(0 - 255)の指定された赤、緑、青の値を使って、不透明なsRGBカラーを生成します。Color(int r, int g, int b, int a) 範囲(0 - 255)の指定された赤、緑、青、およびアルファ値を使ってsRGBカラーを生成します。Color(ColorSpace cspace, float[] components, float alpha) float配列で指定された色成分と指定されたアルファを使用して、指定されたColorSpace内に色を作成します。 -
メソッドのサマリー
修飾子と型メソッド説明brighter()このColorをより明るくした新しいColorを作成します。createContext(ColorModel cm, Rectangle r, Rectangle2D r2d, AffineTransform xform, RenderingHints hints) 塗りつぶした色のフィールド・パターンを生成するために使用されるPaintContextを作成して返します。darker()このColorをより暗くした新しいColorを作成します。static ColorStringを整数に変換し、指定された不透明なColorを返します。boolean別のオブジェクトがこのColorに等しいかどうかを判定します。intgetAlpha()0 - 255の範囲にあるアルファ成分を返します。intgetBlue()デフォルトのsRGB領域の0 - 255の範囲にある青色成分を返します。static Colorシステム・プロパティの色を検索します。static Colorシステム・プロパティの色を検索します。static Colorシステム・プロパティの色を検索します。float[]getColorComponents(float[] compArray) ColorのColorSpace内にある、Colorの色成分のみを含むfloat配列を返します。float[]getColorComponents(ColorSpace cspace, float[] compArray) cspaceパラメータによって指定されたColorSpace内にある、Colorの色成分のみを含むfloat配列を返します。このColorのColorSpaceを返します。float[]getComponents(float[] compArray) ColorのColorSpace内にある、Colorの色成分およびアルファ成分を含むfloat配列を返します。float[]getComponents(ColorSpace cspace, float[] compArray) cspaceパラメータによって指定されたColorSpace内にある、Colorの色成分およびアルファ成分を含むfloat配列を返します。intgetGreen()デフォルトのsRGB領域の0 - 255の範囲にある緑色成分を返します。static ColorgetHSBColor(float h, float s, float b) HSBカラー・モデルに指定された値に基づいて、Colorオブジェクトを作成します。intgetRed()デフォルトのsRGB領域の0 - 255の範囲にある赤色成分を返します。intgetRGB()デフォルトのsRGBColorModel内の色を表すRGB値を返します。float[]getRGBColorComponents(float[] compArray) デフォルトのsRGBカラー・スペース内にある、Colorの色成分のみを含むfloat配列を返します。float[]getRGBComponents(float[] compArray) デフォルトのsRGBカラー・スペースで表された、Colorの色成分およびアルファ成分を含むfloat配列を返します。intこのColorの透明度モードを返します。inthashCode()このColorのハッシュ・コードを計算します。static intHSBtoRGB(float hue, float saturation, float brightness) HSBモデルによって指定される色の成分を、対応するデフォルトのRGBモデルの値のセットに変換します。static float[]RGBtoHSB(int r, int g, int b, float[] hsbvals) デフォルトのRGBモデルによって指定された色の成分を、HSBモデルの3つの成分である色相、彩度、明度の値の対応するセットに変換します。toString()このColorの文字列表現を返します。
-
フィールド詳細
-
white
public static final Color white白を表します。 デフォルトのsRGB領域です。 -
WHITE
-
lightGray
public static final Color lightGrayライト・グレーを表します。 デフォルトのsRGB領域です。 -
LIGHT_GRAY
-
gray
public static final Color grayグレーを表します。 デフォルトのsRGB領域です。 -
GRAY
-
darkGray
public static final Color darkGrayダーク・グレーを表します。 デフォルトのsRGB領域です。 -
DARK_GRAY
-
black
public static final Color black黒を表します。 デフォルトのsRGB領域です。 -
BLACK
-
red
public static final Color red赤を表します。 デフォルトのsRGB領域です。 -
RED
-
pink
public static final Color pinkピンクを表します。 デフォルトのsRGB領域です。 -
PINK
-
orange
public static final Color orangeオレンジを表します。 デフォルトのsRGB領域です。 -
ORANGE
-
yellow
public static final Color yellow黄を表します。 デフォルトのsRGB領域です。 -
YELLOW
-
green
public static final Color green緑を表します。 デフォルトのsRGB領域です。 -
GREEN
-
magenta
public static final Color magentaマゼンタを表します。 デフォルトのsRGB領域です。 -
MAGENTA
-
cyan
public static final Color cyanシアンを表します。 デフォルトのsRGB領域です。 -
CYAN
-
blue
public static final Color blue青を表します。 デフォルトのsRGB領域です。 -
BLUE
-
-
コンストラクタの詳細
-
Color
public Color(int r, int g, int b) 範囲(0 - 255)の指定された赤、緑、青の値を使って、不透明なsRGBカラーを生成します。 実際の表示に使用される色は、出力デバイスで使用可能な色の中でもっとも近いものとなります。 アルファはデフォルトで255に設定されます。- パラメータ:
r- 赤色成分g- 緑色成分b- 青色成分- スロー:
IllegalArgumentException-r、g、またはbが0から255までの範囲(両端を含む)外にある場合- 関連項目:
-
Color
@ConstructorProperties({"red","green","blue","alpha"}) public Color(int r, int g, int b, int a) 範囲(0 - 255)の指定された赤、緑、青、およびアルファ値を使ってsRGBカラーを生成します。- パラメータ:
r- 赤色成分g- 緑色成分b- 青色成分a- アルファ成分- スロー:
IllegalArgumentException-r、g、b、またはaが0から255までの範囲(両端を含む)外にある場合- 関連項目:
-
Color
public Color(int rgb) ビット16-23の赤色成分、ビット8-15の緑色成分、およびビット0-7の青色成分から合成された、指定されたRGB値を使って、不透明なsRGBカラーを生成します。 実際の描画に使用される色は、特定の出力デバイスで使用可能な色の中でもっとも近い色になります。 アルファはデフォルトで255に設定されます。- パラメータ:
rgb- 合成されたRGB成分- 関連項目:
-
Color
public Color(int rgba, boolean hasalpha) ビット24 - 31のアルファ成分、ビット16 - 23の赤色成分、ビット8 - 15の緑色成分、およびビット0 - 7の青色成分で構成される、指定されたRGBA値を持つ、sRGBカラーを生成します。hasalpha引数がfalseの場合、アルファはデフォルトで255に設定されます。- パラメータ:
rgba- 合成されたRGBA成分hasalpha- アルファ・ビットが有効な場合はtrue、そうでない場合はfalse- 関連項目:
-
Color
public Color(float r, float g, float b) 範囲(0.0 - 1.0)の指定された赤、緑、青の値を使って、不透明なsRGBカラーを生成します。 アルファはデフォルトで1.0に設定されます。 実際の描画に使用される色は、特定の出力デバイスで使用可能な色の中でもっとも近い色になります。- パラメータ:
r- 赤色成分g- 緑色成分b- 青色成分- スロー:
IllegalArgumentException-r、g、またはbが0.0から1.0までの範囲(両端を含む)外にある場合- 関連項目:
-
Color
public Color(float r, float g, float b, float a) 範囲(0.0 - 1.0)の指定された赤、緑、青、およびアルファ値を使ってsRGBカラーを生成します。 実際の描画に使用される色は、特定の出力デバイスで使用可能な色の中でもっとも近い色になります。- パラメータ:
r- 赤色成分g- 緑色成分b- 青色成分a- アルファ成分- スロー:
IllegalArgumentException-r、g、b、またはaが0.0から1.0までの範囲(両端を含む)外にある場合- 関連項目:
-
Color
public Color(ColorSpace cspace, float[] components, float alpha) float配列で指定された色成分と指定されたアルファを使用して、指定されたColorSpace内に色を作成します。 成分の数はColorSpaceの型によって決まります。 たとえばRGBでは3つの成分、CMYKでは4つの成分が必要です。- パラメータ:
cspace- 成分を解釈するのに使用されるColorSpacecomponents-ColorSpaceに適合する任意の数の色成分alpha- アルファ値- スロー:
IllegalArgumentException-components配列またはalphaの値のどれかが0.0から1.0の範囲を超えている場合- 関連項目:
-
-
メソッドの詳細
-
getRed
public int getRed()デフォルトのsRGB領域の0 - 255の範囲にある赤色成分を返します。- 戻り値:
- 赤色成分
- 関連項目:
-
getGreen
public int getGreen()デフォルトのsRGB領域の0 - 255の範囲にある緑色成分を返します。- 戻り値:
- 緑色成分
- 関連項目:
-
getBlue
public int getBlue()デフォルトのsRGB領域の0 - 255の範囲にある青色成分を返します。- 戻り値:
- 青色成分
- 関連項目:
-
getAlpha
public int getAlpha()0 - 255の範囲にあるアルファ成分を返します。- 戻り値:
- アルファ成分
- 関連項目:
-
getRGB
public int getRGB()デフォルトのsRGBColorModel内の色を表すRGB値を返します。 (ビットのうち24 - 31はアルファ、16 - 23は赤、8 - 15は緑、0 - 7は青)。- 戻り値:
- デフォルトのsRGB
ColorModelの色のRGB値 - 導入されたバージョン:
- 1.0
- 関連項目:
-
brighter
public Color brighter()このColorをより明るくした新しいColorを作成します。このメソッドは、この
Colorの3つのRGB成分のそれぞれに任意のスケーリング係数を適用することにより、このColorをより明るくした色を生成します。alpha値は保持されます。brighterとdarkerは逆の操作ですが、これらの2つのメソッドを連続して呼び出した場合、丸め誤差のために結果が一致しないことがあります。- 戻り値:
alpha値は同じで、このColorをより明るくした、新しいColorオブジェクト- 導入されたバージョン:
- 1.0
- 関連項目:
-
darker
public Color darker()このColorをより暗くした新しいColorを作成します。このメソッドは、この
Colorの3つのRGB成分のそれぞれに任意のスケーリング係数を適用することにより、このColorをより暗くした色を生成します。alpha値は保持されます。brighterとdarkerは逆の操作ですが、これらの2つのメソッドを連続して呼び出した場合、丸め誤差のために結果が一致しないことがあります。- 戻り値:
alpha値は同じで、このColorをより暗くした、新しいColorオブジェクト- 導入されたバージョン:
- 1.0
- 関連項目:
-
hashCode
-
equals
-
toString
-
decode
public static Color decode(String nm) throws NumberFormatException Stringを整数に変換し、指定された不透明なColorを返します。 このメソッドは、8進数および16進数を表すのに使用される文字列形式を処理します。- パラメータ:
nm- 24ビット整数として不透明色を表すString- 戻り値:
- 新しい
Colorオブジェクト。 - スロー:
NumberFormatException- 指定された文字列を10進、8進、および16進の整数値に変換できない場合- 導入されたバージョン:
- 1.1
- 関連項目:
-
getColor
-
getColor
システム・プロパティの色を検索します。最初の引数は取得されるシステム・プロパティの名前として扱われます。 その後、このプロパティの文字列値が整数として解釈され、この整数が次に
Colorオブジェクトに変換されます。指定されたプロパティが見つからない場合、または整数値として構文解析できなかった場合、代わりに2番目の引数によって指定された
Colorが返されます。- パラメータ:
nm- カラー・プロパティの名前v- デフォルトのColor- 戻り値:
- システム・プロパティから変換された
Color、または指定されたColor - 導入されたバージョン:
- 1.0
- 関連項目:
-
getColor
システム・プロパティの色を検索します。最初の引数は取得されるシステム・プロパティの名前として扱われます。 その後、このプロパティの文字列値が整数として解釈され、この整数が次に
Colorオブジェクトに変換されます。指定されたプロパティが見つからない場合、または整数値として構文解析できなかった場合、代わりに整数値
vが使用され、Colorオブジェクトに変換されます。- パラメータ:
nm- カラー・プロパティの名前v- デフォルトのカラー値(整数値)- 戻り値:
- システム・プロパティから変換された
Color、または指定された整数から変換されたColor - 導入されたバージョン:
- 1.0
- 関連項目:
-
HSBtoRGB
public static int HSBtoRGB(float hue, float saturation, float brightness) HSBモデルによって指定される色の成分を、対応するデフォルトのRGBモデルの値のセットに変換します。saturation成分とbrightness成分は、0と1の間の浮動小数点値(0.0から1.0までの範囲の数値)にするようにしてください。hue成分は、任意の浮動小数点数値にできます。 この数の下限が減算され、0から1の間の小数部が作成されます。 この小数点数に360が乗算され、HSBカラー・モデルの色相角度が生成されます。HSBtoRGBによって返される整数値は、整数値のビット0 - 23の色の値をgetRGBメソッドによって使用されるのと同じ形式でエンコードします。 この整数は1つの整数の引数をとるColorコンストラクタに引数として渡されます。- パラメータ:
hue- 色の色相成分saturation- 色の彩度brightness- 色の明度- 戻り値:
- 指定された色相、彩度、明度を持つ色のRGB値
- 導入されたバージョン:
- 1.0
- 関連項目:
-
RGBtoHSB
public static float[] RGBtoHSB(int r, int g, int b, float[] hsbvals) デフォルトのRGBモデルによって指定された色の成分を、HSBモデルの3つの成分である色相、彩度、明度の値の対応するセットに変換します。hsbvals引数がnullの場合、その結果を返す新しい配列が割り当てられます。 そうでない場合、このメソッドは、配列hsbvalsに値を格納し、その配列を返します。- パラメータ:
r- 色の赤色成分g- 色の緑色成分b- 色の青色成分hsbvals- 3つのHSB値を返すのに使用される配列、またはnull- 戻り値:
- 指定された赤色、緑色、および青色の成分を持つ色の、色相、彩度、明度をこの順序で格納する3つの要素の配列
- 導入されたバージョン:
- 1.0
- 関連項目:
-
getHSBColor
public static Color getHSBColor(float h, float s, float b) HSBカラー・モデルに指定された値に基づいて、Colorオブジェクトを作成します。s成分とb成分は、0と1の間の浮動小数点値(0.0から1.0までの範囲の数値)にするようにしてください。h成分は、任意の浮動小数点数値にできます。 この数の下限が減算され、0から1の間の小数部が作成されます。 この小数点数に360が乗算され、HSBカラー・モデルの色相角度が生成されます。- パラメータ:
h- 色相成分s- 色の彩度b- 色の明度- 戻り値:
- 指定された色相、彩度、明度を持つ
Colorオブジェクト - 導入されたバージョン:
- 1.0
-
getRGBComponents
public float[] getRGBComponents(float[] compArray) デフォルトのsRGBカラー・スペースで表された、Colorの色成分およびアルファ成分を含むfloat配列を返します。compArrayがnullである場合は、戻り値として長さ4の配列が作成されます。 それ以外の場合、compArrayは4以上の長さを持つ必要があり、そこに各成分が入力されて返されます。- パラメータ:
compArray- このメソッドが色成分とアルファ成分を入力して返す配列- 戻り値:
float配列内のRGBA成分
-
getRGBColorComponents
public float[] getRGBColorComponents(float[] compArray) デフォルトのsRGBカラー・スペース内にある、Colorの色成分のみを含むfloat配列を返します。compArrayがnullである場合は、戻り値として長さ3の配列が作成されます。 それ以外の場合、compArrayは3以上の長さを持つ必要があり、そこに各成分が入力されて返されます。- パラメータ:
compArray- このメソッドが色成分を入力して返す配列- 戻り値:
float配列内のRGB成分
-
getComponents
public float[] getComponents(float[] compArray) ColorのColorSpace内にある、Colorの色成分およびアルファ成分を含むfloat配列を返します。compArrayがnullの場合、関連するColorSpace内の成分数に1を加えた数を長さとして持つ配列が戻り値として生成されます。 それ以外の場合、compArrayは少なくともこの長さを持つ必要があり、そこに各成分が入力されて返されます。- パラメータ:
compArray- このメソッドがColorSpaceのこのColorの色成分とアルファ成分を入力して返す配列- 戻り値:
float配列内の色成分およびアルファ成分。
-
getColorComponents
public float[] getColorComponents(float[] compArray) ColorのColorSpace内にある、Colorの色成分のみを含むfloat配列を返します。compArrayがnullの場合、関連するColorSpace内の成分数と等しい数を長さとして持つ配列が戻り値として生成されます。 それ以外の場合、compArrayは少なくともこの長さを持つ必要があり、そこに各成分が入力されて返されます。- パラメータ:
compArray- このメソッドがColorSpaceのこのColorの色成分を入力して返す配列- 戻り値:
float配列内の色成分。
-
getComponents
public float[] getComponents(ColorSpace cspace, float[] compArray) cspaceパラメータによって指定されたColorSpace内にある、Colorの色成分およびアルファ成分を含むfloat配列を返します。compArrayがnullの場合、cspace内の成分数に1を加えた数を長さとして持つ配列が戻り値として生成されます。 それ以外の場合、compArrayは少なくともこの長さを持つ必要があり、そこに各成分が入力されて返されます。- パラメータ:
cspace- 指定されたColorSpacecompArray- このメソッドが、指定されたColorSpaceのこのColorの色成分とアルファ成分を入力して返す配列- 戻り値:
float配列内の色成分およびアルファ成分。
-
getColorComponents
public float[] getColorComponents(ColorSpace cspace, float[] compArray) cspaceパラメータによって指定されたColorSpace内にある、Colorの色成分のみを含むfloat配列を返します。compArrayがnullの場合、cspace内の成分数と等しい数を長さとして持つ配列が戻り値として生成されます。 それ以外の場合、compArrayは少なくともこの長さを持つ必要があり、そこに各成分が入力されて返されます。- パラメータ:
cspace- 指定されたColorSpacecompArray- このメソッドが、指定されたColorSpaceのこのColorの色成分を入力する配列- 戻り値:
float配列内の色成分。
-
getColorSpace
-
createContext
public PaintContext createContext(ColorModel cm, Rectangle r, Rectangle2D r2d, AffineTransform xform, RenderingHints hints) 塗りつぶした色のフィールド・パターンを生成するために使用されるPaintContextを作成して返します。 nullパラメータの処理については、Paintインタフェース内のメソッドのspecificationを参照してください。- 定義:
createContext、インタフェースPaint- パラメータ:
cm- 呼出し元がピクセル・データを受信するためのもっとも便利な形式を表す推奨されるColorModel、または推奨値がない場合はnull。r- 描画されるグラフィックス・プリミティブのデバイス空間でのバウンディング・ボックス。r2d- 描画されるグラフィックス・プリミティブのユーザー空間でのバウンディング・ボックス。xform- ユーザー空間からデバイス空間へのAffineTransform。hints- コンテキスト・オブジェクトが描画の選択肢の中から選択するために使用できるヒントのセット。- 戻り値:
- カラー・パターンを生成するための
PaintContext。 - 関連項目:
-
getTransparency
public int getTransparency()このColorの透明度モードを返します。Paintインタフェースを実装するのに必要です。- 定義:
getTransparency、インタフェースTransparency- 戻り値:
- この
Colorオブジェクトの透明度モード - 関連項目:
-