Color

颜色

new YS.Color(red, green, blue, alpha)

颜色, 使用红色、绿色、蓝色和透明度值指定, 范围从 0~1
Name Type Default Description
red Number 1.0 optional 红色成分
green Number 1.0 optional 绿色成分
blue Number 1.0 optional 蓝色成分
alpha Number 1.0 optional 透明度

Members

staticconstantYS.Color.BLACK : Color

黑色

staticconstantYS.Color.BLUE : Color

蓝色

staticconstantYS.Color.GREEN : Color

绿色

staticconstantYS.Color.RED : Color

红色

staticconstantYS.Color.TRANSPARENT : Color

纯透明

staticconstantYS.Color.WHITE : Color

白色

staticconstantYS.Color.YSBLUE : Color

亮蓝色

a : Number

透明度.
Default Value: 1.0

b : Number

蓝色成分.
Default Value: 1.0

g : Number

绿色成分.
Default Value: 1.0

r : Number

红色成分.
Default Value: 1.0

Methods

staticYS.Color.checkValue(value)Boolean

检测对象是否为颜色
Name Type Description
value Color 待检测对象
Returns:
true/false

staticYS.Color.fromFloatArray(array)Color

rgba数组转为Color 范围从 0.0~1.0
Name Type Description
array Array.<Number> 颜色值数组,顺序支持三值RGB、四值RGBA和单个值的灰度
Returns:
返回合法的颜色对象

staticYS.Color.fromIntArray(array)Color

rgba数组转为Color 范围从 0~255
Name Type Description
array Array.<Number> 颜色值数组,顺序支持三值RGB、四值RGBA和单个值的灰度
Returns:
返回合法的颜色对象
Example:
console.log(YS.Color.fromIntArray([100, 200, 200, 100]));
console.log(YS.Color.fromIntArray([100, 200, 200]));

staticYS.Color.fromRandom(options, result)Color

Creates a random color using the provided options. For reproducible random colors, you should call CesiumMath#setRandomNumberSeed once at the beginning of your application.
Name Type Description
options Object optional Object with the following properties:
Name Type Default Description
red Number optional If specified, the red component to use instead of a randomized value.
minimumRed Number 0.0 optional The maximum red value to generate if none was specified.
maximumRed Number 1.0 optional The minimum red value to generate if none was specified.
green Number optional If specified, the green component to use instead of a randomized value.
minimumGreen Number 0.0 optional The maximum green value to generate if none was specified.
maximumGreen Number 1.0 optional The minimum green value to generate if none was specified.
blue Number optional If specified, the blue component to use instead of a randomized value.
minimumBlue Number 0.0 optional The maximum blue value to generate if none was specified.
maximumBlue Number 1.0 optional The minimum blue value to generate if none was specified.
alpha Number optional If specified, the alpha component to use instead of a randomized value.
minimumAlpha Number 0.0 optional The maximum alpha value to generate if none was specified.
maximumAlpha Number 1.0 optional The minimum alpha value to generate if none was specified.
result Color optional The object to store the result in, if undefined a new instance will be created.
Returns:
The modified result parameter or a new instance if result was undefined.
Throws:
  • DeveloperError : minimumRed must be less than or equal to maximumRed.
  • DeveloperError : minimumGreen must be less than or equal to maximumGreen.
  • DeveloperError : minimumBlue must be less than or equal to maximumBlue.
  • DeveloperError : minimumAlpha must be less than or equal to maximumAlpha.
Example:
//Create a completely random color
var color = Cesium.Color.fromRandom();

//Create a random shade of yellow.
var color = Cesium.Color.fromRandom({
    red : 1.0,
    green : 1.0,
    alpha : 1.0
});

//Create a random bright color.
var color = Cesium.Color.fromRandom({
    minimumRed : 0.75,
    minimumGreen : 0.75,
    minimumBlue : 0.75,
    alpha : 1.0
});

staticYS.Color.fromRGBA(red, green, blue, alpha)Color

rgba转为Color 范围从 0~255
Name Type Default Description
red Number 255.0 optional 红色成分
green Number 255.0 optional 绿色成分
blue Number 255.0 optional 蓝色成分
alpha Number 255.0 optional 透明度
Returns:
返回合法的颜色对象

staticYS.Color.fromRGBA2(rgba)Color

rgba转为Color 范围从 0~1
Name Type Description
rgba RGBA 颜色结构
Returns:
返回合法的颜色对象

staticYS.Color.fromString(value)Color

颜色字符串转为Color e.g:#ffffff->Color
Name Type Description
value String 颜色字符串
Returns:
返回合法的颜色对象,转换失败返回undefined
Examples:
var c = YS.Color.fromString('#fff');
var c = YS.Color.fromString('#aaaa');
var c = YS.Color.fromString('#ff00aa');
var c = YS.Color.fromString('#ff00aaaa');
var c = YS.Color.fromString('rgb(20, 0, 255)');
var c = YS.Color.fromString('rgba(20, 0, 255, 100)');

staticYS.Color.getGradient(start, end, valueFrom, valueTo)Color~getGradientCallback

生成渐变色
Name Type Description
start RGBA 起始色
end RGBA 终止色
valueFrom Number 起始色对应的数字
valueTo Number 终止色对应的数字
Returns:
返回获取渐变色的函数

staticYS.Color.getGradient2(start, end, count)Array.<RGBA>

生成渐变色
Name Type Description
start RGBA 起始色
end RGBA 终止色
count Number 要生成的渐变色颜色总数
Returns:
返回获取渐变色数组

staticYS.Color.getGradient3(array, count)Array.<RGBA>

从一组颜色值中内插生成渐变色
Name Type Description
array Array.<RGBA> 一组色值
count Number 要生成的数量
Returns:
渐变色结果 TODO: 不能整除时,插值数量会有多余,需要调整每段的内插数量

staticYS.Color.toCSSString(color)String

Color转为CSS的颜色函数 e.g:Color->rgba(127,76,51,251)
Name Type Description
color Color 颜色字符串
Returns:
返回CSS的颜色函数字符串
Example:
var c = {r:0.5,g:0.3,b:0.2,a:1.0};
console.log(YS.Color.toCSSString(c));

staticYS.Color.toRgba(color)RGBA

Color转为rgba
Name Type Description
color Color 颜色字符串
Returns:
返回合法的颜色对象,值域[0,255]

staticYS.Color.toShader(rgba)Cesium.WebGLConstants.FLOAT_VEC4

Color转为shader中使用的颜色值
Name Type Description
rgba RGBA | Color 要转换的颜色
Returns:
返回shader颜色变量可以使用的值

staticYS.Color.toString(color)Object

Color转为颜色字符串六位码 e.g:Color->#ffffff
Name Type Description
color Color 颜色字符串
Returns:
返回合法的颜色对象,属性值包括颜色六位码及透明度
Example:
var c = {r:0.5,g:0.3,b:0.2,a:1.0};
console.log(YS.Color.toString(c));

staticYS.Color.toString2(color)String

Color转为颜色字符串八位码 e.g:Color->#ffffff00
Name Type Description
color Color 颜色字符串
Returns:
返回颜色字符串八位码,#号后最后两位为透明度
Example:
var c = {r:0.5,g:0.3,b:0.2,a:1.0};
console.log(YS.Color.toString2(c));

clone()Color

拷贝函数
Returns:
拷贝生成的新对象

Type Definitions

getGradientCallback(value)Color

生成渐变色的执行函数
Name Type Description
value Number 要获取对应渐变色的数值,必须在valueFrom和valueTo之间
Returns:
返回获取的渐变色