视频氛围灯带
================

:link_to_translation:`en:[English]`

简介
----------

视频氛围灯带采集画面并提取色块，把环境或屏幕上的颜色映射到灯珠，用于展示射灯、娱乐灯带或电视背后的补光。输入可以是摄像头实时画面，也可以是存储卡中的图片。摄像头取景时需要标定与畸变校正；输出侧将归一化后的颜色映射到灯珠的颜色、亮度与点亮数量。

相对语音律动灯带，本方案依赖图像处理，算力需求更高。ESP32-P4 带 ISP，摄像头取色更稳；若从 HDMI 取色，可使用 ESP32-P4 的 HDMI 转 CSI 路径，帧率可到约 30 fps。

.. only:: html

   .. mermaid::

      flowchart LR
          Src["摄像头或图片"]
          Color["切分与取色"]
          Led["灯珠颜色与亮度"]
          Src --> Color
          Color --> Led

应用场景
----------

- **商业展示**：展厅、橱窗、品牌体验店，按展品或环境颜色改变射灯
- **商业娱乐**：酒吧、KTV、游戏场所中与画面联动的灯带
- **屏幕补光**：电视或电脑屏幕背面的氛围灯，把画面颜色延伸到周围

功能特性
----------

- 摄像头采集环境画面，或读取存储卡中的图片
- 画面切分、色块提取与颜色归一化，再映射到灯珠
- 摄像头取景时可做标定与畸变校正
- 多种灯效模式与参数设置
- ESP32-P4 可通过 HDMI 转 CSI 提高取色帧率

硬件与软件
----------------

常用 ESP32-S3、ESP32-S31、ESP32-P4。在 ESP32-S3 上，480P 输入大约 10 至 15 fps；输出是归一化色块，720P 与 480P 映射到灯珠上的观感接近。ESP32-P4 的处理速度约为 ESP32-S3 的两倍。图像处理见 :doc:`../basic-components/effects/esp-image-effects`。

参考资料
----------

- :doc:`../basic-components/effects/esp-image-effects`
- :doc:`../basic-components/video-codec/esp-new-jpeg`
