更新README.md,补充了示例的说明

This commit is contained in:
2023-11-26 15:27:26 +08:00
parent 26391ab953
commit adc05560bf

View File

@@ -1,23 +1,30 @@
# RGB灯条驱动库
![_453de8b7-7edc-4efc-94c3-809a46000e66](https://img.pawpaw.cn:4430/assets/1699707514504RmN8t1mh.jpeg)
<img src="https://img.pawpaw.cn:4430/assets/1699707514504RmN8t1mh.jpeg" alt="_453de8b7-7edc-4efc-94c3-809a46000e66" style="zoom:50%;" />
## 简介
`lib_rgb` 是一个用于控制RGB灯条的C语言库提供了一系列功能比如颜色渐变、呼吸灯效果和色调循环等。它支持通过RGB和HSV颜色空间来控制灯条的颜色输出。
## 功能
- **响度可视化**通过检测音频样本中的响度实现RGB跟随音量大小跳动
### 组件
- **颜色渐变**通过逐步调整RGB值来模拟呼吸灯效果。
| 功能 | 示例 | 备注 |
| ------------ | ------------------------------------ | ------------------------------------------------------------ |
| **颜色渐变** | `app_rgb_cycle_breathing_example` | 通过逐步调整RGB值来模拟呼吸灯效果。 |
| **色调循环** | `app_hsv_cycle_example` | 在HSV颜色空间中循环改变色调以实现颜色渐变。 |
| **颜色转换** | `app_test_HSV_to_RGB` | 将HSV颜色值转换为RGB颜色值。 |
| **颜色填充** | `app_test_fill_gradient_with_groups` | 将单一颜色填充到整个RGB条中也可以将RGB条分组同时输出不同的颜色或响应。 |
| **幻彩渐变** | `app_hsv_cycle_per_rgb_example` | 每个灯珠独立的HSV渐变以获得颜色流动的效果。 |
- **色调循环**在HSV颜色空间中循环改变色调以实现颜色渐变。
### 高级应用
- **颜色转换**将HSV颜色值转换为RGB颜色值。
- **颜色填充**将单一颜色填充到整个RGB条中也可以将RGB条分组同时输出不同的颜色或响应
- **音量响应**:根据响度值(-xdB~0dB),获取音量等级
| 功能 | 示例 | 备注 |
| -------------------------- | --------------------------------------- | ----------------------------------------------------- |
| **响度可视化** | 待补充 | 通过检测音频样本中的响度实现RGB跟随音量大小跳动 |
| **色调循环&音量响应** | `app_cycleHSV_vol_level_example` | 根据响度值(-xdB~0dB),获取音量等级。 |
| **平滑&音量响应** | `app_vol_level_smooth_example` | 一种过渡效果当响度下降时逐级熄灭RGB而不是突变。 |
| **平滑&色调循环&音量响应** | `app_cycleHSV_vol_level_smooth_example` | 结合了HSV颜色渐变平滑过渡以及音量响应 |
## 使用方法
@@ -104,10 +111,10 @@ output_rgb_array(rgb_array, 3);
## 路线图
- [x] 为绘制RGB的函数添加可合并选项以减少资源占用
- [ ] 添加更多应用光效
- [x] 添加更多应用光效
- [x] RGB渐变
- [x] HSV渐变
- [ ] 每个灯珠独立的HSV渐变
- [x] 每个灯珠独立的HSV渐变
- [x] 音频响度响应
- [ ] 使用fp/s32以增加`HSV_to_RGB`的计算效率
- [ ] 提供音频响度响应的例程与说明