three.js Color
表示一个颜色。
对 Color 实例进行遍历将按相应的顺序生成它的分量 (r, g, b)。
代码示例
颜色可以用以下任意一种方式初始化。
//empty constructor - will default white const color1 = new THREE.Color();
//Hexadecimal color (recommended) const color2 = new THREE.Color( 0xff0000 );
//RGB string const color3 = new THREE.Color("rgb(255, 0, 0)"); const color4 = new THREE.Color("rgb(100%, 0%, 0%)");
//X11 color name - all 140 color names are supported.
//Note the lack of CamelCase in the name const color5 = new THREE.Color( 'skyblue' );
//HSL string const color6 = new THREE.Color("hsl(0, 100%, 50%)");
//Separate RGB values between 0 and 1 const color7 = new THREE.Color( 1, 0, 0 );构造器（Constructor）
Color( r : Color_Hex_or_String, g : Float, b : Float )
r - (可选参数) 如果参数g和b被定义，则r表示颜色中的红色分量。 如果未被定义，r可以是一个十六进制 hexadecimal triplet 颜色值或CSS样式的字符串或一个Color实例。
g - (可选参数) 如果被定义，表示颜色中的绿色分量。
b - (可选参数) 如果被定义，表示颜色中的蓝色分量。
注意使用十六进制 hexadecimal triplet 定义一个颜色在three.js中是标准的方法，而且其余 文档也将会使用这个方法。
当所有参数被定义时，r是红色分量，g是绿色分量，b是蓝色分量。
当只有 r 被定义时：
- 它可用一个十六进制 hexadecimal triplet 值表示颜色（推荐）。
- 它可以是一个另一个颜色实例。
- 它可以是另外一个CSS样式。例如：
- 'rgb(250, 0,0)'
- 'rgb(100%,0%,0%)'
- 'hsl(0, 100%, 50%)'
- '#ff0000'
- '#f00'
- 'red'
属性（Properties）
.isColor : Boolean
只读标志，用于检查给定对象是否为 Color 类型。
.r : Float
红色通道的值在0到1之间。默认值为1。
.g : Float
绿色通道的值在0到1之间。默认值为1。
.b : Float
蓝色通道的值在0到1之间。默认值为1。
方法（Methods）
.add ( color : Color ) : this
将给定颜色的RGB值添加到此颜色的RGB值。
.addColors ( color1 : Color, color2 : Color ) : this
将此颜色的RGB值设置为 color1 和 color2 的RGB值之和。
.addScalar ( s : Number ) : this
给现有的RGB值都加上 s 。
.clone () : Color
返回一个与当前颜色的 r, g 和 b 相同的颜色。
.copy ( color : Color ) : this
从 color 中拷贝 r, g 和 b 值到当前的颜色。
.convertLinearToSRGB () : this
将此颜色从线性空间转换成sRGB空间。
.convertSRGBToLinear () : this
将此颜色从sRGB空间转换成线性空间。
.copyLinearToSRGB ( color : Color] ) : this
color — 需要拷贝的颜色。
将传入的 color : Color 拷贝给当前颜色，然后将当前颜色从线性空间转换到sRGB空间。
.copySRGBToLinear ( color : Color ) : this
color — 需要拷贝的颜色。
将传入的 color : Color 拷贝给当前颜色，然后将当前颜色从sRGB空间转换到线性空间。
.equals ( color : Color ) : Boolean
将 color : Color 的RGB值与该对象的RGB值进行比较。如果它们都是相同的，返回true，否则返回false。
.fromArray ( array : Array, offset : Integer ) : this
array - 格式为 [ r, g, b ] 的数组 Array。
offset - 数组中可选偏移量
从格式为[ r, g, b ]的数组数据中来创建Color对象。
.fromBufferAttribute ( attribute : BufferAttribute, index : Integer ) : this
attribute - 数据源
index - 索引值
根据参数 attribute 设置该颜色。
.getHex ( colorSpace : string = SRGBColorSpace ) : Integer
返回此颜色的十六进制值。
.getHexString ( colorSpace : string = SRGBColorSpace ) : String
将此颜色的十六进制值作为字符串返回 (例如, 'FFFFFF')。
.getHSL ( target : Object, colorSpace : string = LinearSRGBColorSpace ) : Object
target — 结果将复制到这个对象中。向对象添加h、s和l键(如果不存在)。
将此颜色的 r, g 和 b 值转换为 HSL格式，然后返回一个格式如下的对象：
{ h: 0, s: 0, l: 0 }
.getStyle ( colorSpace : string = SRGBColorSpace ) : String
以CSS样式字符串的形式返回该颜色的值。例如:“rgb(255,0,0)”。
.lerp ( color : Color, alpha : Float ) : this
color - 用于收敛的颜色。
alpha - 介于0到1的数字。
将该颜色的RGB值线性插值到传入参数的RGB值。alpha参数可以被认为是两种颜色之间的比例值，其中0是当前颜色和1.0是第一个参数的颜色。
.lerpColors ( color1 : Color, color2 : Color, alpha : Float ) : this
color1 - 开始的颜色。
color2 - 结束收敛的颜色。
alpha - 介于0到1的数字。
将该颜色设置为线性插值颜色 color1 和 color2 - 在此 alpha 是连接两种颜色的直线百分比距离 alpha = 0 时为 color1， alpha = 1 时为 color2。
.lerpHSL ( color : Color, alpha : Float ) : this
color - 用于收敛的颜色。
alpha - 介于0到1的数字。
将该颜色的HSL值线性插值到传递参数的HSL值。它不同于上诉的lerp。通过不直接从一种颜色插入到另一种颜色， 而是通过插值这两种颜色之间的所有色相(H)、亮度(L)、饱和度(S)。alpha参数可以被认为是两种颜色之间的比例值， 其中0是当前颜色和1.0是第一个参数的颜色。
.multiply ( color : Color ) : this
将此颜色的RGB值乘以给定的 color 的RGB值。
.multiplyScalar ( s : Number ) : this
将此颜色的RGB值乘以给定的s的值。
.offsetHSL ( h : Float, s : Float, l : Float ) : this
将给定的 h, s, 和 l值加到当前颜色值。 内部的机制为：先将该颜色的 r, g 和 b 值转换为HSL，然后与传入的h, s, 和 l 相加，最后再将结果转成RGB值。
.set ( value : Color_Hex_or_String ) : this
value - 用于设置该颜色的值。
有关 value 的详细信息，请参阅上面的构造函数。 根据输入类型，将会委托给 .copy, .setStyle, 或者 .setHex 函数处理。
.setHex ( hex : Integer, colorSpace : string = SRGBColorSpace ) : this
hex — hexadecimal triplet 格式。
采用十六进制值设置此颜色。
.setHSL ( h : Float, s : Float, l : Float, colorSpace : string = LinearSRGBColorSpace ) : this
h — 色相值处于0到1之间。hue value between 0.0 and 1.0
s — 饱和度值处于0到1之间。
l — 亮度值处于0到1之间。
采用HLS值设置此颜色。
.setRGB ( r : Float, g : Float, b : Float, colorSpace : string = LinearSRGBColorSpace ) : this
r — 红色通道的值在0到1之间。
g — 绿色通道的值在0到1之间。
b — 蓝色通道的值在0到1之间。
采用RGB值设置此颜色。
.setScalar ( scalar : Float ) : this
scalar — 处于0到1之间的值
将颜色的RGB值都设为该 scalar 的值。
.setStyle ( style : String, colorSpace : string = SRGBColorSpace ) : this
style — 颜色css样式的字符串
采用ccs样式的字符串设置此颜色。例如, "rgb(250, 0,0)", "rgb(100%, 0%, 0%)", "hsl(0, 100%, 50%)", "#ff0000", "#f00", 或者 "red" ( 或者任何 X11 color name - 所有140种颜色名称都支持 ).
半透明颜色例如 "rgba(255, 0, 0, 0.5)" and "hsla(0, 100%, 50%, 0.5)" 也能支持, 但是alpha通道的值将会被丢弃。
注意，对于X11颜色名称，多个单词(如暗橙色)变成字符串“darkorange”。
.setColorName ( style : String, colorSpace : string = SRGBColorSpace ) : this
style — 颜色名字的英文单词 ( 具体请查阅 X11 color names )
通过颜色名字设置该颜色。如果你不使用其他 CSS 颜色样式形式，那么这种方式会略快于 .setStyle 方法。
为了方便使用，颜色名称都可以通过 Color.NAMES 访问，例如：
Color.NAMES.aliceblue // returns 0xF0F8FF
.sub ( color : Color ) : this
从该颜色的RGB分量中减去传入颜色的RGB分量。如果分量结果是负，则该分量为零。
.toArray ( array : Array, offset : Integer ) : Array
array - 存储颜色的可选数组
offset - 数组的可选偏移量
返回一个格式为[ r, g, b ] 数组。
更多建议：