Color (クラス)
public final Color {inherits Texture}
インポート元： CURL.GUI.STANDARD. package 内で定義されています CURL.GRAPHICS.RENDERER3D.

純色を表します。

説明

Color は不変です。


Color はデバイスに影響を受けない均一な色を表します。これは、その色の値が点ごとに異なる Texture のサブクラスです。しかし、Color の色の値はすべての点で同じです。


Color オブジェクトを直接インスタンス化する代わりに、通常は次の方法のいずれかで Color オブジェクトを作成します。
  • クラス プロシージャ Color.from-string#factory を呼び出し、その引数として、サポートされている色の名前を明確に記述する String を指定します。
  • クラス プロシージャ Palette.get-<color> を呼び出します。これは Color.from-string "<color>" を呼び出すことと同じです。Palette の方が速いため、こちらの使用が推奨されます。
  • クラス プロシージャ Color.from-string を呼び出し、その引数として、フォーム "#rrggbb" 又は "#rrggbbaa" の String を指定します。ここでrr、gg、bb および aa はそれぞれ赤、緑、青の色強度、アルファ チャネルの値を指定する 16 進数値のペアです。許可されている文字列のフォーマットに関する詳細は、Color.from-string#factory のドキュメンテーションを参照してください。
  • Color.from-rgb#factory ファクトリーを使用します。


次のテーブルでは、色の名前を明確に記述する、サポートされている String を示します。必要な色を取得するためには、Palette.get-<color> または Color.from-string "<color>" を呼び出します。






Color は FillPattern を必要とする場所で指定します。これは、FillPattern が自動的に Color を FillPattern に変換するためです。そのため上記の形式のどれを使用しても、その型が FillPattern であるグラフィック オプションの均一色を指定できます。


しかし、必要とされる FillPattern を直接指定することを推奨します。Color から FillPattern に変換すると、パフォーマンスに不利な条件を引き起こします。小さい場合はできれば避けるようにしてください。

例

次の例では、Color オブジェクトを Renderer3d および Drawable でいくつか使用しています。
例: Color の Drawable および Renderer3d での使用
{import * from CURL.GRAPHICS.RENDERER3D}

|| This example uses Renderer3dGraphic because Color is
|| used with lower-level interfaces, such as Renderer3d
|| and Drawable, and Renderer3dGraphic is an easy way to
|| access these.  Please see the chapter on 3D rendering in
|| the Developer's Guide for more information.
{Renderer3dGraphic
    width=2cm,
    height=2cm,
    repaint-handler = 
        {proc {rg:Renderer3dGraphic,
               r:Renderer3d,
               area:#RectangleSet
              }:void

            {r.clear
                color = {Color.from-string "#301070"}
            }

            {r.render-rectangle
                0.1cm,
                0.1cm,
                0cm,
                1.8cm,
                1.8cm,
                texture = {Palette.get-teal}
            }
            
            {r.render-rectangle
                0.5cm,
                0.5cm,
                0cm,
                1cm,
                1cm,
                texture =
                    {Color.from-rgb
                        0.8,
                        0.6,
                        0.15
                    }
            }
        }
}

注意事項

詳細については、『Curl 開発者ガイド』の「塗りつぶしパターンおよびテクスチャ」 の章を参照してください。

コンストラクタ
default:0 から 1 までの rgb 値から Color を作成します。
ファクトリ public inline {Color.default
red:Fraction,
green:Fraction,
blue:Fraction,
opacity:Fraction = 1.0
}:Color
from-cmy:0 から 1 までの cmy 値から Color を作成します。
ファクトリ public inline {Color.from-cmy
cyan:Fraction,
magenta:Fraction,
yellow:Fraction,
opacity:Fraction = 1.0
}:Color
from-cmyk:0 から 1 までの cmyk 値から Color を作成します。
ファクトリ public inline {Color.from-cmyk
cyan:Fraction,
magenta:Fraction,
yellow:Fraction,
black:Fraction,
opacity:Fraction = 1.0
}:Color
from-hsv:0 から 1 までの hsv 値から Color を作成します。
ファクトリ public {Color.from-hsv
hue:Angle,
saturation:Fraction,
value:Fraction,
opacity:Fraction = 1.0
}:Color
from-pixel:Pixel から Color を作成します。
ファクトリ public {Color.from-pixel pixel:Pixel}:Color
from-rgb:0 から 1 までの rgb 値から Color を作成します。
ファクトリ public inline {Color.from-rgb
red:Fraction,
green:Fraction,
blue:Fraction,
opacity:Fraction = 1.0
}:Color
from-rgb-float:0 から 1 までの rgb 値から Color を作成します。
ファクトリ public inline {Color.from-rgb-float
red:FloatFraction,
green:FloatFraction,
blue:FloatFraction,
opacity:FloatFraction = 1.0f
}:Color
from-rgb-uint8:0 から 255 までの rgb 値から Color を作成します。
ファクトリ public inline {Color.from-rgb-uint8
red:int,
green:int,
blue:int,
opacity:int = 255
}:Color
from-string:色の名前を表す文字列を Color オブジェクトに変換しようとします。文字列は、定義済みの色の名前、または '#' で始まる 16 進数値の色の値のどちらかである必要があります。
ファクトリ public {Color.from-string color-descriptor:StringInterface}:Color

プロパティ
blue:0 から 1 までの値としての rgb 青コンポーネント。
アクセサ public Color.blue:FloatFraction
cyan:0 から 1 までの値として、cmy シアンブルー コンポーネントを返します。
アクセサ public Color.cyan:FloatFraction
green:0 から 1 までの値としての rgb 緑コンポーネント。
アクセサ public Color.green:FloatFraction
hue:0 から 1 までの値として hsv 色相コンポーネントを返します。
アクセサ public Color.hue:FloatAngle
mag-filter:テクスチャの拡大で使用される FilterMode を返します。フレーム バッファのピクセルがテクスチャ ピクセルのサブエリアにマップする時、つまりテクスチャ マップがスクリーン座標のフレーム バッファより大きい時に、拡大が発生します。
アクセサ public Color.mag-filter:FilterMode
magenta:0 から 1 までの値として cmy マゼンタ色コンポーネントを返します。
アクセサ public Color.magenta:FloatFraction
min-filter:テクスチャの縮小で使用される FilterMode を返します。フレーム バッファのピクセルが多くのテクスチャ ピクセルにマップする時、つまりテクスチャ マップがスクリーン座標のフレーム バッファより小さい時に、縮小が発生します。
アクセサ public Color.min-filter:FilterMode
opacity:0 から 1 までの値としての色の不透明度。
アクセサ public Color.opacity:FloatFraction
red:0 から 1 までの値としての rgb 赤コンポーネント。
アクセサ public Color.red:FloatFraction
saturation:0 から 1 までの値として hsv 彩度コンポーネントを返します。
アクセサ public Color.saturation:FloatFraction
uniform?:Color が均一かどうかを示します。
アクセサ public Color.uniform?:bool
value:0 から 1 までの値として hsv の値コンポーネントを返します。
アクセサ public Color.value:FloatFraction
wrap-s:s 方向 (テクスチャ座標の x 方向) に沿った WrapMode を返します。
アクセサ public Color.wrap-s:WrapMode
wrap-t:t 方向 (テクスチャ座標の y 方向) に沿った WrapMode を返します。
アクセサ public Color.wrap-t:WrapMode
yellow:0 から 1 までの値として cmy 黄色コンポーネントを返します。
アクセサ public Color.yellow:FloatFraction

クラス プロシージャ
from-string-if-exists:色の名前を表す文字列を Color オブジェクトに変換しようとします。文字列は、定義済みの色の名前、または '#' で始まる 16 進数値の色の値のどちらかである必要があります。
public {Color.from-string-if-exists
color-descriptor:StringInterface
}:(value:Color, found?:bool)
hsv-to-rgb:色相、彩度および値 (HSV) の色空間を、赤、緑および青 (RGB) の色空間に変換するユーティリティ。
public {Color.hsv-to-rgb
hue:Angle,
saturation:Fraction,
value:Fraction
}:(red:FloatFraction, green:FloatFraction, blue:FloatFraction)
interpolate:2 つの色の間を補間します。
public {Color.interpolate
a:Color,
blend-factor:Fraction,
b:Color
}:Color
rgb-to-hsv:赤、緑および青 (RGB) の色空間の色を、色相、彩度および値 (HSV) の色空間に変換するユーティリティ。
public {Color.rgb-to-hsv
red:Fraction,
green:Fraction,
blue:Fraction
}:(hue:FloatAngle, saturation:FloatFraction, value:FloatFraction)
rgb-to-hsv-float:赤、緑および青 (RGB) の色空間の色を、色相、彩度および値 (HSV) の色空間に変換するユーティリティ。
public {Color.rgb-to-hsv-float
red:FloatFraction,
green:FloatFraction,
blue:FloatFraction
}:(hue:FloatAngle, saturation:FloatFraction, value:FloatFraction)

メソッド
cmy:cmy と不透明度のセットとして色を返します。
public {Color.cmy
}:(cyan:FloatFraction, magenta:FloatFraction, yellow:FloatFraction, opacity:FloatFraction)
cmyk:cmyk と不透明度のセットとして色を返します。
public {Color.cmyk
}:(cyan:FloatFraction, magenta:FloatFraction, yellow:FloatFraction, black:FloatFraction, opacity:FloatFraction)
hsv:hsv と不透明度のセットとして色を返します。
public {Color.hsv
}:(hue:FloatAngle, saturation:FloatFraction, value:FloatFraction, opacity:FloatFraction)
rgb:rgb と不透明度のセットとして色を返します。
public {Color.rgb
}:(red:FloatFraction, green:FloatFraction, blue:FloatFraction, opacity:FloatFraction)
to-Pixel:テクスチャのピクセルすべての平均値となるピクセルを返します。
public {Color.to-Pixel}:Pixel
to-Pixmap:この Color を表す Pixmap を返します。
public {Color.to-Pixmap width:int = 0, height:int = 0}:Pixmap
メソッド 継承 Object: object-describe, object-describe-for-debugging, object-serialize



コンストラクタ詳細
default (ファクトリ)
public inline {Color.default
red:Fraction,
green:Fraction,
blue:Fraction,
opacity:Fraction = 1.0
}:Color

0 から 1 までの rgb 値から Color を作成します。


from-cmy (ファクトリ)
public inline {Color.from-cmy
cyan:Fraction,
magenta:Fraction,
yellow:Fraction,
opacity:Fraction = 1.0
}:Color

0 から 1 までの cmy 値から Color を作成します。


from-cmyk (ファクトリ)
public inline {Color.from-cmyk
cyan:Fraction,
magenta:Fraction,
yellow:Fraction,
black:Fraction,
opacity:Fraction = 1.0
}:Color

0 から 1 までの cmyk 値から Color を作成します。


from-hsv (ファクトリ)
public {Color.from-hsv
hue:Angle,
saturation:Fraction,
value:Fraction,
opacity:Fraction = 1.0
}:Color

0 から 1 までの hsv 値から Color を作成します。


from-pixel (ファクトリ)
public {Color.from-pixel pixel:Pixel}:Color

Pixel から Color を作成します。


from-rgb (ファクトリ)
public inline {Color.from-rgb
red:Fraction,
green:Fraction,
blue:Fraction,
opacity:Fraction = 1.0
}:Color

0 から 1 までの rgb 値から Color を作成します。


from-rgb-float (ファクトリ)
public inline {Color.from-rgb-float
red:FloatFraction,
green:FloatFraction,
blue:FloatFraction,
opacity:FloatFraction = 1.0f
}:Color

0 から 1 までの rgb 値から Color を作成します。


from-rgb-uint8 (ファクトリ)
public inline {Color.from-rgb-uint8
red:int,
green:int,
blue:int,
opacity:int = 255
}:Color

0 から 255 までの rgb 値から Color を作成します。


from-string (ファクトリ)
public {Color.from-string color-descriptor:StringInterface}:Color

色の名前を表す文字列を Color オブジェクトに変換しようとします。文字列は、定義済みの色の名前、または '#' で始まる 16 進数値の色の値のどちらかである必要があります。

説明

StringInterface として渡せるフォーマットは次のとおりです。

戻り値

Color オブジェクト。文字列が変換できなかった場合、エラーがスローされます。


プロパティ詳細
blue (アクセサ)
アクセサ public Color.blue:FloatFraction

0 から 1 までの値としての rgb 青コンポーネント。


cyan (アクセサ)
アクセサ public Color.cyan:FloatFraction

0 から 1 までの値として、cmy シアンブルー コンポーネントを返します。


green (アクセサ)
アクセサ public Color.green:FloatFraction

0 から 1 までの値としての rgb 緑コンポーネント。


hue (アクセサ)
アクセサ public Color.hue:FloatAngle

0 から 1 までの値として hsv 色相コンポーネントを返します。


mag-filter (アクセサ)
アクセサ public Color.mag-filter:FilterMode

テクスチャの拡大で使用される FilterMode を返します。フレーム バッファのピクセルがテクスチャ ピクセルのサブエリアにマップする時、つまりテクスチャ マップがスクリーン座標のフレーム バッファより大きい時に、拡大が発生します。


magenta (アクセサ)
アクセサ public Color.magenta:FloatFraction

0 から 1 までの値として cmy マゼンタ色コンポーネントを返します。


min-filter (アクセサ)
アクセサ public Color.min-filter:FilterMode

テクスチャの縮小で使用される FilterMode を返します。フレーム バッファのピクセルが多くのテクスチャ ピクセルにマップする時、つまりテクスチャ マップがスクリーン座標のフレーム バッファより小さい時に、縮小が発生します。


opacity (アクセサ)
アクセサ public Color.opacity:FloatFraction

0 から 1 までの値としての色の不透明度。


red (アクセサ)
アクセサ public Color.red:FloatFraction

0 から 1 までの値としての rgb 赤コンポーネント。


saturation (アクセサ)
アクセサ public Color.saturation:FloatFraction

0 から 1 までの値として hsv 彩度コンポーネントを返します。


uniform? (アクセサ)
アクセサ public Color.uniform?:bool

Color が均一かどうかを示します。

戻り値

true。Color は定義により均一になります。

value (アクセサ)
アクセサ public Color.value:FloatFraction

0 から 1 までの値として hsv の値コンポーネントを返します。


wrap-s (アクセサ)
アクセサ public Color.wrap-s:WrapMode

s 方向 (テクスチャ座標の x 方向) に沿った WrapMode を返します。


wrap-t (アクセサ)
アクセサ public Color.wrap-t:WrapMode

t 方向 (テクスチャ座標の y 方向) に沿った WrapMode を返します。


yellow (アクセサ)
アクセサ public Color.yellow:FloatFraction

0 から 1 までの値として cmy 黄色コンポーネントを返します。




クラス プロシージャ詳細
from-string-if-exists (クラスプロシージャ)
public {Color.from-string-if-exists
color-descriptor:StringInterface
}:(value:Color, found?:bool)

色の名前を表す文字列を Color オブジェクトに変換しようとします。文字列は、定義済みの色の名前、または '#' で始まる 16 進数値の色の値のどちらかである必要があります。

説明

使用可能な入力文字列については、Color.from-string#factory の説明を参照してください。

戻り値

found? が false (文字列が変換できなかったことを意味します) でない限り、Color オブジェクトが返されます。

hsv-to-rgb (クラスプロシージャ)
public {Color.hsv-to-rgb
hue:Angle,
saturation:Fraction,
value:Fraction
}:(red:FloatFraction, green:FloatFraction, blue:FloatFraction)

色相、彩度および値 (HSV) の色空間を、赤、緑および青 (RGB) の色空間に変換するユーティリティ。


interpolate (クラスプロシージャ)
public {Color.interpolate
a:Color,
blend-factor:Fraction,
b:Color
}:Color

2 つの色の間を補間します。

説明

RGBA 空間の 2 つの色を線形に混合します。つまり、赤、緑、青、および不透明度チャネルがそれぞれ補間され、返される色を作成します。
blend-factor: 0 から 1 までの線形混合ファクター。0 の時は a が返されます。1 の時は b が返されます。

rgb-to-hsv (クラスプロシージャ)
public {Color.rgb-to-hsv
red:Fraction,
green:Fraction,
blue:Fraction
}:(hue:FloatAngle, saturation:FloatFraction, value:FloatFraction)

赤、緑および青 (RGB) の色空間の色を、色相、彩度および値 (HSV) の色空間に変換するユーティリティ。


rgb-to-hsv-float (クラスプロシージャ)
public {Color.rgb-to-hsv-float
red:FloatFraction,
green:FloatFraction,
blue:FloatFraction
}:(hue:FloatAngle, saturation:FloatFraction, value:FloatFraction)

赤、緑および青 (RGB) の色空間の色を、色相、彩度および値 (HSV) の色空間に変換するユーティリティ。

注意事項

rgb-to-hsv-float と Color.rgb-to-hsv の違いは、rgb-to-hsv-float は Fraction の代わりに FloatFraction として赤、緑および青の値をとるということだけです。


メソッド詳細
cmy (メソッド)
public {Color.cmy
}:(cyan:FloatFraction, magenta:FloatFraction, yellow:FloatFraction, opacity:FloatFraction)

cmy と不透明度のセットとして色を返します。


cmyk (メソッド)
public {Color.cmyk
}:(cyan:FloatFraction, magenta:FloatFraction, yellow:FloatFraction, black:FloatFraction, opacity:FloatFraction)

cmyk と不透明度のセットとして色を返します。


hsv (メソッド)
public {Color.hsv
}:(hue:FloatAngle, saturation:FloatFraction, value:FloatFraction, opacity:FloatFraction)

hsv と不透明度のセットとして色を返します。


rgb (メソッド)
public {Color.rgb
}:(red:FloatFraction, green:FloatFraction, blue:FloatFraction, opacity:FloatFraction)

rgb と不透明度のセットとして色を返します。


to-Pixel (メソッド)
public {Color.to-Pixel}:Pixel

テクスチャのピクセルすべての平均値となるピクセルを返します。

説明

このメソッドは、テクスチャのピクセル値を平均し、その平均値を 1 つのピクセル値として返します。平均は 1 度しか行われないので、以降の to-Pixel への呼び出しは速くなります。

to-Pixmap (メソッド)
public {Color.to-Pixmap width:int = 0, height:int = 0}:Pixmap

この Color を表す Pixmap を返します。

説明

Color は均一な Texture であるため、返される Pixmap の Pixel はすべて同じ値を持ちます。
width, height: 返される Pixmap の Pixel の数での幅と高さ。

戻り値

作成された Pixmap。