---
name: "hsv2rgb"
mode: "api"
versionRequirements:
  - { name: "@ray-js/panel-sdk", version: "1.0.0" }
title: "颜色"
summary: "介绍 HSV、RGB、HEX、Kelvin 等颜色模式互转及亮度色温相关工具函数，适用于照明类面板开发。"
questions:
  - "hsv2rgb函数的参数h、s、v的取值范围分别是什么？与旧版hsvToRgb有什么区别？"
  - "rgb2hsv从旧版rgbToHsv迁移时返回值格式有什么变化？s和v的范围如何不同？"
  - "brightKelvin2rgb函数如何根据亮度和色温值生成RGB颜色？kelvinMin和kelvinMax参数的作用？"
  - "kelvin2rgb和rgb2kelvin函数如何实现Kelvin色温值与RGB颜色的互转？"
  - "hex2hsv函数如何将十六进制颜色值转换为HSV模式？hex2hsv('#FF00FF')的结果是什么？"
  - "hex2rgbString函数的alpha参数如何控制输出rgb还是rgba格式？"
  - "rgb2hex函数如何将RGB值转换为十六进制颜色字符串？rgb2hex(255,0,0)返回什么？"
  - "从@ray-js/ray-panel-utils的ColorUtils迁移到@ray-js/panel-sdk需要注意哪些参数和返回值变化？"
  - "hsv2rgbString函数如何将HSV颜色值直接转换为rgba字符串？"
  - "颜色转换工具在照明类面板开发中如何处理彩光和白光模式的颜色数据？"
---

## hsv2rgb

> [VERSION] @ray-js/panel-sdk >= 1.0.0

### 描述

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

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `h` | `number` | 是 | 色相值（0-360） |
| `s` | `number` | 是 | 饱和度（0-100） |
| `v` | `number` | 是 | 明度（0-100） |
| `a` | `number` | 否 | 可选的 alpha 透明度值（0-1） |

### 返回值

类型: `number[]`

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

### 示例代码

#### 基础用法

```ts
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]  蓝色
```


---
name: "rgb2hsv"
mode: "api"
versionRequirements:
  - { name: "@ray-js/panel-sdk", version: "1.0.0" }
title: "颜色"
summary: "介绍 HSV、RGB、HEX、Kelvin 等颜色模式互转及亮度色温相关工具函数，适用于照明类面板开发。"
questions:
  - "hsv2rgb函数的参数h、s、v的取值范围分别是什么？与旧版hsvToRgb有什么区别？"
  - "rgb2hsv从旧版rgbToHsv迁移时返回值格式有什么变化？s和v的范围如何不同？"
  - "brightKelvin2rgb函数如何根据亮度和色温值生成RGB颜色？kelvinMin和kelvinMax参数的作用？"
  - "kelvin2rgb和rgb2kelvin函数如何实现Kelvin色温值与RGB颜色的互转？"
  - "hex2hsv函数如何将十六进制颜色值转换为HSV模式？hex2hsv('#FF00FF')的结果是什么？"
  - "hex2rgbString函数的alpha参数如何控制输出rgb还是rgba格式？"
  - "rgb2hex函数如何将RGB值转换为十六进制颜色字符串？rgb2hex(255,0,0)返回什么？"
  - "从@ray-js/ray-panel-utils的ColorUtils迁移到@ray-js/panel-sdk需要注意哪些参数和返回值变化？"
  - "hsv2rgbString函数如何将HSV颜色值直接转换为rgba字符串？"
  - "颜色转换工具在照明类面板开发中如何处理彩光和白光模式的颜色数据？"
---
## rgb2hsv

> [VERSION] @ray-js/panel-sdk >= 1.0.0

### 描述

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

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `r` | `number` | 是 | 红色通道值（0-255） |
| `g` | `number` | 是 | 绿色通道值（0-255） |
| `b` | `number` | 是 | 蓝色通道值（0-255） |

### 返回值

类型: `number[]`

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

### 示例代码

#### 基础用法

```ts
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]    灰色
```


---
name: "hex2hsv"
mode: "api"
versionRequirements:
  - { name: "@ray-js/panel-sdk", version: "1.0.0" }
title: "颜色"
summary: "介绍 HSV、RGB、HEX、Kelvin 等颜色模式互转及亮度色温相关工具函数，适用于照明类面板开发。"
questions:
  - "hsv2rgb函数的参数h、s、v的取值范围分别是什么？与旧版hsvToRgb有什么区别？"
  - "rgb2hsv从旧版rgbToHsv迁移时返回值格式有什么变化？s和v的范围如何不同？"
  - "brightKelvin2rgb函数如何根据亮度和色温值生成RGB颜色？kelvinMin和kelvinMax参数的作用？"
  - "kelvin2rgb和rgb2kelvin函数如何实现Kelvin色温值与RGB颜色的互转？"
  - "hex2hsv函数如何将十六进制颜色值转换为HSV模式？hex2hsv('#FF00FF')的结果是什么？"
  - "hex2rgbString函数的alpha参数如何控制输出rgb还是rgba格式？"
  - "rgb2hex函数如何将RGB值转换为十六进制颜色字符串？rgb2hex(255,0,0)返回什么？"
  - "从@ray-js/ray-panel-utils的ColorUtils迁移到@ray-js/panel-sdk需要注意哪些参数和返回值变化？"
  - "hsv2rgbString函数如何将HSV颜色值直接转换为rgba字符串？"
  - "颜色转换工具在照明类面板开发中如何处理彩光和白光模式的颜色数据？"
---
## hex2hsv

> [VERSION] @ray-js/panel-sdk >= 1.0.0

### 描述

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

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `hex` | `string` | 是 | 十六进制颜色字符串，如 '#FF0000' 或 'FF0000' |

### 返回值

类型: `number[]`

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

### 示例代码

#### 基础用法

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

const { hex2hsv } = utils;

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


---
name: "hex2rgbString"
mode: "api"
versionRequirements:
  - { name: "@ray-js/panel-sdk", version: "1.0.0" }
title: "颜色"
summary: "介绍 HSV、RGB、HEX、Kelvin 等颜色模式互转及亮度色温相关工具函数，适用于照明类面板开发。"
questions:
  - "hsv2rgb函数的参数h、s、v的取值范围分别是什么？与旧版hsvToRgb有什么区别？"
  - "rgb2hsv从旧版rgbToHsv迁移时返回值格式有什么变化？s和v的范围如何不同？"
  - "brightKelvin2rgb函数如何根据亮度和色温值生成RGB颜色？kelvinMin和kelvinMax参数的作用？"
  - "kelvin2rgb和rgb2kelvin函数如何实现Kelvin色温值与RGB颜色的互转？"
  - "hex2hsv函数如何将十六进制颜色值转换为HSV模式？hex2hsv('#FF00FF')的结果是什么？"
  - "hex2rgbString函数的alpha参数如何控制输出rgb还是rgba格式？"
  - "rgb2hex函数如何将RGB值转换为十六进制颜色字符串？rgb2hex(255,0,0)返回什么？"
  - "从@ray-js/ray-panel-utils的ColorUtils迁移到@ray-js/panel-sdk需要注意哪些参数和返回值变化？"
  - "hsv2rgbString函数如何将HSV颜色值直接转换为rgba字符串？"
  - "颜色转换工具在照明类面板开发中如何处理彩光和白光模式的颜色数据？"
---
## hex2rgbString

> [VERSION] @ray-js/panel-sdk >= 1.0.0

### 描述

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

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `hex` | `string` | 是 | 十六进制颜色字符串，如 '#FF0000' 或 'FF0000' |
| `a` | `number` | 否 | 可选的 alpha 透明度值（0-1） |

### 返回值

无


### 示例代码

#### 基础用法

```ts
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)'
```


---
name: "hsv2rgbString"
mode: "api"
versionRequirements:
  - { name: "@ray-js/panel-sdk", version: "1.0.0" }
title: "颜色"
summary: "介绍 HSV、RGB、HEX、Kelvin 等颜色模式互转及亮度色温相关工具函数，适用于照明类面板开发。"
questions:
  - "hsv2rgb函数的参数h、s、v的取值范围分别是什么？与旧版hsvToRgb有什么区别？"
  - "rgb2hsv从旧版rgbToHsv迁移时返回值格式有什么变化？s和v的范围如何不同？"
  - "brightKelvin2rgb函数如何根据亮度和色温值生成RGB颜色？kelvinMin和kelvinMax参数的作用？"
  - "kelvin2rgb和rgb2kelvin函数如何实现Kelvin色温值与RGB颜色的互转？"
  - "hex2hsv函数如何将十六进制颜色值转换为HSV模式？hex2hsv('#FF00FF')的结果是什么？"
  - "hex2rgbString函数的alpha参数如何控制输出rgb还是rgba格式？"
  - "rgb2hex函数如何将RGB值转换为十六进制颜色字符串？rgb2hex(255,0,0)返回什么？"
  - "从@ray-js/ray-panel-utils的ColorUtils迁移到@ray-js/panel-sdk需要注意哪些参数和返回值变化？"
  - "hsv2rgbString函数如何将HSV颜色值直接转换为rgba字符串？"
  - "颜色转换工具在照明类面板开发中如何处理彩光和白光模式的颜色数据？"
---
## hsv2rgbString

> [VERSION] @ray-js/panel-sdk >= 1.0.0

### 描述

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

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `h` | `number` | 是 | 色相值（0-360） |
| `s` | `number` | 是 | 饱和度（0-100） |
| `v` | `number` | 是 | 明度（0-100） |
| `a` | `number` | 否 | 可选的 alpha 透明度值（0-1） |

### 返回值

无


### 示例代码

#### 基础用法

```ts
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)'
```


---
name: "brightKelvin2rgb"
mode: "api"
versionRequirements:
  - { name: "@ray-js/panel-sdk", version: "1.0.0" }
title: "颜色"
summary: "介绍 HSV、RGB、HEX、Kelvin 等颜色模式互转及亮度色温相关工具函数，适用于照明类面板开发。"
questions:
  - "hsv2rgb函数的参数h、s、v的取值范围分别是什么？与旧版hsvToRgb有什么区别？"
  - "rgb2hsv从旧版rgbToHsv迁移时返回值格式有什么变化？s和v的范围如何不同？"
  - "brightKelvin2rgb函数如何根据亮度和色温值生成RGB颜色？kelvinMin和kelvinMax参数的作用？"
  - "kelvin2rgb和rgb2kelvin函数如何实现Kelvin色温值与RGB颜色的互转？"
  - "hex2hsv函数如何将十六进制颜色值转换为HSV模式？hex2hsv('#FF00FF')的结果是什么？"
  - "hex2rgbString函数的alpha参数如何控制输出rgb还是rgba格式？"
  - "rgb2hex函数如何将RGB值转换为十六进制颜色字符串？rgb2hex(255,0,0)返回什么？"
  - "从@ray-js/ray-panel-utils的ColorUtils迁移到@ray-js/panel-sdk需要注意哪些参数和返回值变化？"
  - "hsv2rgbString函数如何将HSV颜色值直接转换为rgba字符串？"
  - "颜色转换工具在照明类面板开发中如何处理彩光和白光模式的颜色数据？"
---
## brightKelvin2rgb

> [VERSION] @ray-js/panel-sdk >= 1.0.0

> 💡 常用于照明设备面板，将设备上报的亮度和色温 DP 值转换为可显示的颜色。

### 描述

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

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `bright` | `any` | 否 | 亮度值，范围 1-1000 |
| `temperature` | `any` | 否 | 色温值，范围 0-1000 |
| `kelvinRange` | `KelvinRange` | 否 | 可选色温范围配置，kelvinMin 默认 2200，kelvinMax 默认 6500 |

### 返回值

无


### 引用对象

##### `type` KelvinRange

brightKelvin2rgb 的色温范围配置

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `kelvinMin` | `number` | 最低色温（开尔文），默认 2200 |
| `kelvinMax` | `number` | 最高色温（开尔文），默认 6500 |


### 示例代码

#### 基础用法

```ts
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 });
```


---
name: "rgb2RgbString"
mode: "api"
versionRequirements:
  - { name: "@ray-js/panel-sdk", version: "1.0.0" }
title: "颜色"
summary: "介绍 HSV、RGB、HEX、Kelvin 等颜色模式互转及亮度色温相关工具函数，适用于照明类面板开发。"
questions:
  - "hsv2rgb函数的参数h、s、v的取值范围分别是什么？与旧版hsvToRgb有什么区别？"
  - "rgb2hsv从旧版rgbToHsv迁移时返回值格式有什么变化？s和v的范围如何不同？"
  - "brightKelvin2rgb函数如何根据亮度和色温值生成RGB颜色？kelvinMin和kelvinMax参数的作用？"
  - "kelvin2rgb和rgb2kelvin函数如何实现Kelvin色温值与RGB颜色的互转？"
  - "hex2hsv函数如何将十六进制颜色值转换为HSV模式？hex2hsv('#FF00FF')的结果是什么？"
  - "hex2rgbString函数的alpha参数如何控制输出rgb还是rgba格式？"
  - "rgb2hex函数如何将RGB值转换为十六进制颜色字符串？rgb2hex(255,0,0)返回什么？"
  - "从@ray-js/ray-panel-utils的ColorUtils迁移到@ray-js/panel-sdk需要注意哪些参数和返回值变化？"
  - "hsv2rgbString函数如何将HSV颜色值直接转换为rgba字符串？"
  - "颜色转换工具在照明类面板开发中如何处理彩光和白光模式的颜色数据？"
---
## rgb2RgbString

> [VERSION] @ray-js/panel-sdk >= 1.0.0

> 💡 当传入 4 元素数组时自动使用 rgba 格式；当传入 3 元素数组并提供 a 参数时也使用 rgba 格式。

### 描述

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

### 参数

`Params`

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

### 返回值

无


### 示例代码

#### 基础用法

```ts
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)'
```


---
name: "kelvin2rgb"
mode: "api"
versionRequirements:
  - { name: "@ray-js/panel-sdk", version: "1.0.0" }
title: "颜色"
summary: "介绍 HSV、RGB、HEX、Kelvin 等颜色模式互转及亮度色温相关工具函数，适用于照明类面板开发。"
questions:
  - "hsv2rgb函数的参数h、s、v的取值范围分别是什么？与旧版hsvToRgb有什么区别？"
  - "rgb2hsv从旧版rgbToHsv迁移时返回值格式有什么变化？s和v的范围如何不同？"
  - "brightKelvin2rgb函数如何根据亮度和色温值生成RGB颜色？kelvinMin和kelvinMax参数的作用？"
  - "kelvin2rgb和rgb2kelvin函数如何实现Kelvin色温值与RGB颜色的互转？"
  - "hex2hsv函数如何将十六进制颜色值转换为HSV模式？hex2hsv('#FF00FF')的结果是什么？"
  - "hex2rgbString函数的alpha参数如何控制输出rgb还是rgba格式？"
  - "rgb2hex函数如何将RGB值转换为十六进制颜色字符串？rgb2hex(255,0,0)返回什么？"
  - "从@ray-js/ray-panel-utils的ColorUtils迁移到@ray-js/panel-sdk需要注意哪些参数和返回值变化？"
  - "hsv2rgbString函数如何将HSV颜色值直接转换为rgba字符串？"
  - "颜色转换工具在照明类面板开发中如何处理彩光和白光模式的颜色数据？"
---
## kelvin2rgb

> [VERSION] @ray-js/panel-sdk >= 1.0.0

> 💡 基于黑体辐射的曲线拟合算法，适用于照片处理等非高精度场景。精度在 1000K 到 40000K 之间最佳。

### 描述

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

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `kelvin` | `number` | 是 | 开尔文色温值（建议范围 1000K - 40000K） |

### 返回值

类型: `number[]`

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

### 示例代码

#### 基础用法

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

const { kelvin2rgb } = utils;

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


---
name: "rgb2kelvin"
mode: "api"
versionRequirements:
  - { name: "@ray-js/panel-sdk", version: "1.0.0" }
title: "颜色"
summary: "介绍 HSV、RGB、HEX、Kelvin 等颜色模式互转及亮度色温相关工具函数，适用于照明类面板开发。"
questions:
  - "hsv2rgb函数的参数h、s、v的取值范围分别是什么？与旧版hsvToRgb有什么区别？"
  - "rgb2hsv从旧版rgbToHsv迁移时返回值格式有什么变化？s和v的范围如何不同？"
  - "brightKelvin2rgb函数如何根据亮度和色温值生成RGB颜色？kelvinMin和kelvinMax参数的作用？"
  - "kelvin2rgb和rgb2kelvin函数如何实现Kelvin色温值与RGB颜色的互转？"
  - "hex2hsv函数如何将十六进制颜色值转换为HSV模式？hex2hsv('#FF00FF')的结果是什么？"
  - "hex2rgbString函数的alpha参数如何控制输出rgb还是rgba格式？"
  - "rgb2hex函数如何将RGB值转换为十六进制颜色字符串？rgb2hex(255,0,0)返回什么？"
  - "从@ray-js/ray-panel-utils的ColorUtils迁移到@ray-js/panel-sdk需要注意哪些参数和返回值变化？"
  - "hsv2rgbString函数如何将HSV颜色值直接转换为rgba字符串？"
  - "颜色转换工具在照明类面板开发中如何处理彩光和白光模式的颜色数据？"
---
## rgb2kelvin

> [VERSION] @ray-js/panel-sdk >= 1.0.0

> 💡 通过二分查找法将 RGB 颜色映射回近似的开尔文色温。

### 描述

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

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `rgb` | `number[]` | 是 | RGB 颜色值数组 [r, g, b] |

### 返回值

无


### 示例代码

#### 基础用法

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

const { rgb2kelvin } = utils;

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


---
name: "rgb2hsb"
mode: "api"
versionRequirements:
  - { name: "@ray-js/panel-sdk", version: "1.0.0" }
title: "颜色"
summary: "介绍 HSV、RGB、HEX、Kelvin 等颜色模式互转及亮度色温相关工具函数，适用于照明类面板开发。"
questions:
  - "hsv2rgb函数的参数h、s、v的取值范围分别是什么？与旧版hsvToRgb有什么区别？"
  - "rgb2hsv从旧版rgbToHsv迁移时返回值格式有什么变化？s和v的范围如何不同？"
  - "brightKelvin2rgb函数如何根据亮度和色温值生成RGB颜色？kelvinMin和kelvinMax参数的作用？"
  - "kelvin2rgb和rgb2kelvin函数如何实现Kelvin色温值与RGB颜色的互转？"
  - "hex2hsv函数如何将十六进制颜色值转换为HSV模式？hex2hsv('#FF00FF')的结果是什么？"
  - "hex2rgbString函数的alpha参数如何控制输出rgb还是rgba格式？"
  - "rgb2hex函数如何将RGB值转换为十六进制颜色字符串？rgb2hex(255,0,0)返回什么？"
  - "从@ray-js/ray-panel-utils的ColorUtils迁移到@ray-js/panel-sdk需要注意哪些参数和返回值变化？"
  - "hsv2rgbString函数如何将HSV颜色值直接转换为rgba字符串？"
  - "颜色转换工具在照明类面板开发中如何处理彩光和白光模式的颜色数据？"
---
## rgb2hsb

> [VERSION] @ray-js/panel-sdk >= 1.0.0

> 💡 HSB 与 HSV 是同一颜色模型的不同名称，功能完全相同。

### 描述

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

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `r` | `number` | 是 | 红色通道值（0-255） |
| `g` | `number` | 是 | 绿色通道值（0-255） |
| `b` | `number` | 是 | 蓝色通道值（0-255） |

### 返回值

类型: `number[]`

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

### 示例代码

#### 基础用法

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

const { rgb2hsb } = utils;

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


---
name: "rgb2hex"
mode: "api"
versionRequirements:
  - { name: "@ray-js/panel-sdk", version: "1.0.0" }
title: "颜色"
summary: "介绍 HSV、RGB、HEX、Kelvin 等颜色模式互转及亮度色温相关工具函数，适用于照明类面板开发。"
questions:
  - "hsv2rgb函数的参数h、s、v的取值范围分别是什么？与旧版hsvToRgb有什么区别？"
  - "rgb2hsv从旧版rgbToHsv迁移时返回值格式有什么变化？s和v的范围如何不同？"
  - "brightKelvin2rgb函数如何根据亮度和色温值生成RGB颜色？kelvinMin和kelvinMax参数的作用？"
  - "kelvin2rgb和rgb2kelvin函数如何实现Kelvin色温值与RGB颜色的互转？"
  - "hex2hsv函数如何将十六进制颜色值转换为HSV模式？hex2hsv('#FF00FF')的结果是什么？"
  - "hex2rgbString函数的alpha参数如何控制输出rgb还是rgba格式？"
  - "rgb2hex函数如何将RGB值转换为十六进制颜色字符串？rgb2hex(255,0,0)返回什么？"
  - "从@ray-js/ray-panel-utils的ColorUtils迁移到@ray-js/panel-sdk需要注意哪些参数和返回值变化？"
  - "hsv2rgbString函数如何将HSV颜色值直接转换为rgba字符串？"
  - "颜色转换工具在照明类面板开发中如何处理彩光和白光模式的颜色数据？"
---
## rgb2hex

> [VERSION] @ray-js/panel-sdk >= 1.0.0

### 描述

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

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `r` | `number` | 是 | 红色通道值（0-255） |
| `g` | `number` | 是 | 绿色通道值（0-255） |
| `b` | `number` | 是 | 蓝色通道值（0-255） |

### 返回值

无


### 示例代码

#### 基础用法

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

const { rgb2hex } = utils;

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