hsv2rgb(h: number, s: number, v: number, a?: number)

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

将 HSV 颜色值转换为 RGB 颜色模式

参数

参数类型必填说明
hnumber是色相值（0-360）
snumber是饱和度（0-100）
vnumber是明度（0-100）
anumber否可选的 alpha 透明度值（0-1）

返回值

类型：number[]
RGB 数组 [r, g, b]，每个通道值范围 0-255

示例代码

基础用法

import { utils } from '@ray-js/panel-sdk';

const { hsv2rgb } = utils;

hsv2rgb(0, 100, 100);   // [255, 0, 0]  红色
hsv2rgb(120, 100, 100);  // [0, 255, 0]  绿色
hsv2rgb(240, 100, 100);  // [0, 0, 255]  蓝色

rgb2hsv(r: number, g: number, b: number)

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

将 RGB 颜色值转换为 HSV 颜色模式

参数

参数类型必填说明
rnumber是红色通道值（0-255）
gnumber是绿色通道值（0-255）
bnumber是蓝色通道值（0-255）

返回值

类型：number[]
HSV 数组 [h, s, v]，其中 h 为色相（0-360），s 为饱和度（0-100），v 为明度（0-100）

示例代码

基础用法

import { utils } from '@ray-js/panel-sdk';

const { rgb2hsv } = utils;

rgb2hsv(255, 0, 0);   // [0, 100, 100]  红色
rgb2hsv(0, 255, 0);   // [120, 100, 100] 绿色
rgb2hsv(128, 128, 128); // [0, 0, 50]    灰色

hex2hsv(hex: string)

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

将十六进制颜色值转换为 HSV 颜色模式

参数

参数类型必填说明
hexstring是十六进制颜色字符串，如 '#FF0000' 或 'FF0000'

返回值

类型：number[]
HSV 数组 [h, s, v]，其中 h 为色相（0-360），s 为饱和度（0-100），v 为明度（0-100）

示例代码

基础用法

import { utils } from '@ray-js/panel-sdk';

const { hex2hsv } = utils;

hex2hsv('#FF0000'); // [0, 100, 100]
hex2hsv('#00FF00'); // [120, 100, 100]

hex2rgbString(hex: string, a?: number)

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

将十六进制颜色值转换为 CSS RGB/RGBA 颜色字符串

参数

参数类型必填说明
hexstring是十六进制颜色字符串，如 '#FF0000' 或 'FF0000'
anumber否可选的 alpha 透明度值（0-1）

返回值

类型：string
CSS 颜色字符串，如 'rgb(255, 0, 0)' 或 'rgba(255, 0, 0, 0.5)'

示例代码

基础用法

import { utils } from '@ray-js/panel-sdk';

const { hex2rgbString } = utils;

hex2rgbString('#FF0000');       // 'rgb(255, 0, 0)'
hex2rgbString('#FF0000', 0.5); // 'rgba(255, 0, 0, 0.5)'

hsv2rgbString(h: number, s: number, v: number, a?: number)

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

将 HSV 颜色值转换为 CSS RGB/RGBA 颜色字符串

参数

参数类型必填说明
hnumber是色相值（0-360）
snumber是饱和度（0-100）
vnumber是明度（0-100）
anumber否可选的 alpha 透明度值（0-1）

返回值

类型：string
CSS 颜色字符串，如 'rgb(255, 0, 0)' 或 'rgba(255, 0, 0, 0.5)'

示例代码

基础用法

import { utils } from '@ray-js/panel-sdk';

const { hsv2rgbString } = utils;

hsv2rgbString(0, 100, 100);      // 'rgb(255, 0, 0)'
hsv2rgbString(120, 100, 100, 0.8); // 'rgba(0, 255, 0, 0.8)'

brightKelvin2rgb(bright?: any, temperature?: any, kelvinRange?: KelvinRange)

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

将亮度和色温值转换为 RGB 颜色字符串

参数

参数类型必填说明
brightany否亮度值，范围 1-1000
temperatureany否色温值，范围 0-1000
否可选色温范围配置，kelvinMin 默认 2200，kelvinMax 默认 6500

返回值

类型：string
RGB 或 RGBA 颜色字符串，如 'rgb(255, 200, 150)'

示例代码

基础用法

import { utils } from '@ray-js/panel-sdk';

const { brightKelvin2rgb } = utils;

const color = brightKelvin2rgb(1000, 1000); // 最高亮度、最高色温
const warm = brightKelvin2rgb(500, 0);      // 中等亮度、最低色温（暖光）
const custom = brightKelvin2rgb(800, 500, { kelvinMin: 2700, kelvinMax: 6500 });

rgb2RgbString(originRgb: number[], a?: number)

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

将 RGB 数值数组转换为 CSS 颜色字符串

参数

参数类型必填说明
originRgbnumber[]是RGB 或 RGBA 数值数组，如 [255, 0, 0] 或 [255, 0, 0, 0.5]
anumber否可选的 alpha 透明度值（0-1），当数组为 3 元素时有效

返回值

类型：string
CSS 颜色字符串，如 'rgb(255, 0, 0)' 或 'rgba(255, 0, 0, 0.5)'

示例代码

基础用法

import { utils } from '@ray-js/panel-sdk';

const { rgb2RgbString } = utils;

rgb2RgbString([255, 0, 0]);       // 'rgb(255, 0, 0)'
rgb2RgbString([255, 0, 0], 0.5);  // 'rgba(255, 0, 0, 0.5)'
rgb2RgbString([255, 0, 0, 0.8]);  // 'rgba(255, 0, 0, 0.8)'

kelvin2rgb(kelvin: number)

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

将开尔文色温值转换为 RGB 颜色数组

参数

参数类型必填说明
kelvinnumber是开尔文色温值（建议范围 1000K - 40000K）

返回值

类型：number[]
RGB 颜色值数组 [r, g, b]，每个通道值范围 0-255

示例代码

基础用法

import { utils } from '@ray-js/panel-sdk';

const { kelvin2rgb } = utils;

const rgb = kelvin2rgb(6500); // 日光色温，接近 [255, 249.574170569891, 254.30625501058964]
const warm = kelvin2rgb(2700); // 暖白色温

rgb2kelvin(rgb: number[])

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

将 RGB 颜色值转换为开尔文色温值

参数

参数类型必填说明
rgbnumber[]是RGB 颜色值数组 [r, g, b]

返回值

类型：number
对应的开尔文色温值（整数）

示例代码

基础用法

import { utils } from '@ray-js/panel-sdk';

const { rgb2kelvin } = utils;

const kelvin = rgb2kelvin([255, 255, 255]); // 约 6524

rgb2hsb(r: number, g: number, b: number)

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

将 RGB 颜色值转换为 HSB 颜色模式

参数

参数类型必填说明
rnumber是红色通道值（0-255）
gnumber是绿色通道值（0-255）
bnumber是蓝色通道值（0-255）

返回值

类型：number[]
HSB 数组 [h, s, b]，等同于 HSV 模式

示例代码

基础用法

import { utils } from '@ray-js/panel-sdk';

const { rgb2hsb } = utils;

rgb2hsb(255, 0, 0); // [0, 100, 100]

rgb2hex(r: number, g: number, b: number)

版本要求:
@ray-js/panel-sdk≥1.0.0

描述

将 RGB 颜色值转换为十六进制颜色字符串

参数

参数类型必填说明
rnumber是红色通道值（0-255）
gnumber是绿色通道值（0-255）
bnumber是蓝色通道值（0-255）

返回值

类型：string
十六进制颜色字符串，如 '#FF0000'

示例代码

基础用法

import { utils } from '@ray-js/panel-sdk';

const { rgb2hex } = utils;

rgb2hex(255, 0, 0); // '#FF0000'
rgb2hex(0, 255, 0); // '#00FF00'