ESP Video Render
================================

:link_to_translation:`en:[English]`

ESP Video Render 是面向 ESP 芯片的视频合成与显示组件，把视频与 UI 叠加渲染到统一显示后端，支持 H.264 / MJPEG 解码输入。每个 render 实例管理一个显示后端，可包含多个 stream，每个 stream 承载视频 / overlay 或两者并存；每个 overlay 内可放多个 container 与 widget。组件基于"脏区域跟踪"进行局部刷新，避免不必要的重绘。适合视频播放器、智能显示终端、机器人眼睛、可视对讲、摄像头预览布局等视频优先型嵌入式应用。

主要特性
-------------------------------------

- 视频与 UI 在同一渲染链路中组合，避免拼接多个子系统
- 局部刷新：通过脏区域跟踪减少不必要的重绘与背景填充
- 多 stream 独立控制：每个 stream 可单独设置位置、裁剪、旋转、显示 / 隐藏、层级、更新策略
- 多种输出后端：支持直接 LCD 输出、LVGL 集成、frame buffer 后端
- 叠加 / 控件能力：每个 overlay 支持多个 region；每个 region 内可放多个 container 与 widget，构造复杂 UI 布局
- 内置示例：双眼渲染、视频播放器、摄像头预览等典型用法
- 仿真支持：随仓库提供 Linux 仿真指南，可在主机端调试视觉效果
- 手动合成模式：由应用按需触发合成与刷新，降低空闲时资源占用
