# color.table 库模块帮助文档

## color 成员列表 <a id="color" href="#color">&#x23;</a>

### color.table() <a id="color.table" href="#color.table">&#x23;</a>
创建颜色表，用于color.view。  
返回常用标准色组成的数组，  
每个数组成员都是包含以下字段的表对象（色卡）：  
rgb: RGB 格式颜色  
argb: ARGB 格式颜色（0xAARRGGBB 格式，32 位无符号整数）  
name, 中文颜色名称  
ename: 英文颜色名称  
fullname: 完整颜色名称  
html: HTML 格式颜色值（"#RRGGBB" 格式字符串）  
contrastColor 对比颜色（用于在背景为 argb 字段的色卡上显示标题）

## color.table 成员列表 <a id="color.table" href="#color.table">&#x23;</a>

### color.table.analogousColor(clr,gdi) <a id="color.table.analogousColor" href="#color.table.analogousColor">&#x23;</a>
创建类似色表,  
类似色是在色相环上邻近的颜色,会给人带来和谐、舒服的视觉效果,  
参数@1使用ARGB格式颜色值指定主色,如果颜色为gdi的rgb格式请将参数@2指定为true

### color.table.complementaryColor(clr,gdi) <a id="color.table.complementaryColor" href="#color.table.complementaryColor">&#x23;</a>
创建补色表,  
突出对比效果,  
参数 @1 使用 ARGB 格式颜色值指定主色,如果颜色为 GDI 的 RGB 格式请将参数@2指定为t rue

### color.table.find() <a id="color.table.find" href="#color.table.find">&#x23;</a>
参数 @1 指定一个 ARGB 格式颜色数值。  
在色表中查找并返回色卡信息（表对象）。  
返回表对象包含以下字段：rgb: RGB 格式颜色  
argb: ARGB 格式颜色（0xAARRGGBB 格式，32 位无符号整数）  
name, 中文颜色名称  
ename: 英文颜色名称  
fullname: 完整颜色名称  
html: HTML 格式颜色值（"#RRGGBB" 格式字符串）  
contrastColor 对比颜色（用于在背景为 argb 字段的色卡上显示标题）

### color.table.init() <a id="color.table.init" href="#color.table.init">&#x23;</a>
将色彩数组转换为 color.table 标准格式

### color.table.insert(clrTable,clrInfo,index) <a id="color.table.insert" href="#color.table.insert">&#x23;</a>
在参数 @1 指定的色表中添加色卡,  
clrInfo 必须是一个数组,索引1放成员名,索引2放英文名,索引3放RGB格式颜色数值  
可选用参数@3指定插入位置,默认添加到尾部

### color.table.lightColor(clr,gdi) <a id="color.table.lightColor" href="#color.table.lightColor">&#x23;</a>
创建亮度色表,  
色相不变,亮度从0%到1%的变化色表,  
参数@1使用ARGB格式颜色值指定主色,如果颜色为gdi的rgb格式请将参数@2指定为true

### color.table.monochromaticColor(clr,gdi) <a id="color.table.monochromaticColor" href="#color.table.monochromaticColor">&#x23;</a>
创建单色调方案,  
单色调是色相不变,但亮度发生变化的配色方案,  
参数@1使用ARGB格式颜色值指定主色,如果颜色为gdi的rgb格式请将参数@2指定为true

### color.table.splitComplementaryColor(clr,gdi) <a id="color.table.splitComplementaryColor" href="#color.table.splitComplementaryColor">&#x23;</a>
创建分散补色表,  
对比色,但比补色降低了对比强度  
即有较好的对比效果,也不会显得太突兀,  
参数@1使用ARGB格式颜色值指定主色,如果颜色为gdi的rgb格式请将参数@2指定为true

### color.table.squareColor(clr,gdi) <a id="color.table.squareColor" href="#color.table.squareColor">&#x23;</a>
创建矩形色表,  
在色相环上平均分布,并组成两对互补色,  
色彩丰富,要注意选定主色,处理好色彩间的平衡  
参数@1使用ARGB格式颜色值指定主色,如果颜色为gdi的rgb格式请将参数@2指定为true

### color.table.tetradicColor(clr,gdi) <a id="color.table.tetradicColor" href="#color.table.tetradicColor">&#x23;</a>
创建四色表,  
由两对在色相环上的互补色组成,色彩丰富,  
但要注意选定主色,处理好色彩间的平衡  
参数@1使用ARGB格式颜色值指定主色,如果颜色为gdi的rgb格式请将参数@2指定为true

### color.table.triadicColor(clr,gdi) <a id="color.table.triadicColor" href="#color.table.triadicColor">&#x23;</a>
创建三色表,  
三色在色相环上平均分布,应当用一个做主色,处理好色彩间的平衡  
参数@1使用ARGB格式颜色值指定主色,如果颜色为gdi的rgb格式请将参数@2指定为true
