Color 颜色

颜色可由以下几种方式来创建:


function Color( r, g, b ) { } var color = new THREE.Color(); var color = new THREE.Color( 0xff0000 ); var color = new THREE.Color( 1, 0, 0 ); var color = new THREE.Color( 'Purple' ); var color = new THREE.Color("rgb(255, 0, 0)"); var color = new THREE.Color("rgb(100%, 0%, 0%)"); var color = new THREE.Color("hsl(0, 100%, 50%)");

Attributes

r : Float

Default value : 1
Description : 红色通道 Red, 0 ≤ r ≤ 1.

g : Float

Default value : 1
Description : 绿色通道 Green, 0 ≤ g ≤ 1.

b : Float

Default value : 1
Description : 蓝色通道 Blue, 0 ≤ b ≤ 1.

isColor : Boolean

Default value : true
Description : 类型是否为Color.

Methods

set( value ) : this
value Hex, String 十六进制颜色值, 或字符串

设置颜色, 可按照上面的构造函数的方式来传参.

setScalar( scalar ) : this
scalar Float 从 0 到 1 之间的值

把 r, g, b 都设为 scalar.

setHex( hex ) : this
hex Integer 十六进制数值

用十六进制数值来设置颜色.

setRGB( r, g, b ) : this
r, g, b Float 从 0 到 1 之间的值

用RGB值来设置颜色.

setHSL( h, s, l ) : this
h, s, l Float 从 0 到 1 之间的值

用HSL值来设置颜色.

setStyle( style ) : this
style String CSS样式字符串

用CSS样式来设置颜色.

copyGammaToLinear( color, gammaFactor ) : this
color Color 颜色
gammaFactor Float. Default:2.0 gamma因子

复制颜色, 把r, g和b转换为1/gamma因子的幂, 将颜色从空间伽马转换为线性空间.

copyLinearToGamma( color, gammaFactor ) : this
color Color 颜色
gammaFactor Float. Default:2.0 gamma因子

复制颜色, 把r, g和b转换为1/gamma因子的幂, 将颜色从线性空间转换为伽马空间.

convertGammaToLinear( gammaFactor ) : this
gammaFactor Float. Default:2.0 gamma因子

把r, g和b转换为1/gamma因子的幂, 将颜色从空间伽马转换为线性空间.

convertLinearToGamma( gammaFactor ) : this
gammaFactor Float. Default:2.0 gamma因子

把r, g和b转换为1/gamma因子的幂, 将颜色从线性空间转换为伽马空间.

copySRGBToLinear( color ) : this
color Color 颜色

复制颜色, 然后将颜色从sRGB空间转换为线性空间.

copyLinearToSRGB( color ) : this
color Color 颜色

复制颜色, 然后将颜色从线性空间转换为sRGB空间.

convertSRGBToLinear( ) : this

将颜色从sRGB空间转换为线性空间.

convertLinearToSRGB( ) : this

将颜色从线性空间转换为sRGB空间.

getHex( ) : Integer

返回此颜色的十六进制值.

getHexString( ) : String

返回此颜色的十六进制值, 以字符串形式.

getHSL( target ) : Object
target Object 把h, s和l值添加到对象

将颜色的r, g, b值转换为HSL格式并返回以下形式的对象:{ h: 0, s: 0, l: 0 }

offsetHSL( h, s, l ) : this

将h, s和l添加到此颜色上. 在内部, 这会将颜色的r, g和b值转换为HSL, 添加h, s和l, 然后将颜色转换回RGB.

add( color ), sub( color ), multiply( color ) : this
color Color 颜色

为颜色增加, 减去, 乘上一个RGB值color.

addColors( color1, color2 ) : this
color1 Color 颜色
color2 Color 颜色

设置颜色为color1和color2的RGB值之和.

addScalar( s ), multiplyScalar( s ) : this
s Float 数值

给自身颜色加上RGB数组.

lerp( color, alpha ) : this
color Color 颜色
alpha Float Alpha通道

this.r += ( color.r - this.r ) * alpha;
this.g += ( color.g - this.g ) * alpha;
this.b += ( color.b - this.b ) * alpha;
线性插值.

equals( color ) : Boolean
color Color 颜色

将color的RGB值与自身比较, 判断是否相同.

fromArray( array, offset ) : this
array Array: [ r, g, b ] 格式为[ r, g, b ]的数组
offset Integer 偏移量

从数组[ r, g, b ]来设置颜色的元素.

toArray( array, offset ) : Array
array Array 格式为[ r, g, b ]的数组
offset Integer 偏移量

返回格式为[ r, g, b ]的数组

clone( ) : Color

复制自身.

copy( color ) : this
color Color 颜色

把源颜色复制一份.