年会舞台效果图与 KV 脚本包

文件
- s027_gemini_edit.py：调用 Google Gemini API 的图片编辑接口。
- s027_stage_grid.py：生成四种舞台方案，大屏留纯绿色。
- s027_stage_single.py：生成单张舞台定稿，大屏留纯绿色。
- s027_kv.py：按 LED 屏幕宽、高和点间距制作 KV 平面文件。
- s027_screen_paste.py：检测绿幕并把 KV 透视贴入舞台预览。
- s027_kv_red.json、s027_kv2_reveal.json：KV 示例设置。
- demo-venue.jpg、demo-logo.png：虚构演示素材，不能当真实客户资料。

生成舞台图
1. 在 Google AI Studio 创建 API Key，设置环境变量：
   export GEMINI_API_KEY="你的 Gemini API Key"
2. 四宫格示例：
   python3 s027_stage_grid.py demo-venue.jpg grid.png "酒店宴会厅" \
     "科技蓝年会，蓝白灯光和白色花艺" \
     "国潮红金年会，祥云立柱和红金花艺" \
     "黑金颁奖，金色流苏和透明演讲台" \
     "简约白色答谢晚宴，白色弧形墙和暖白灯光"
3. 单张示例：
   python3 s027_stage_single.py demo-venue.jpg stage-green.png "酒店宴会厅" \
     "国潮红金年会，祥云立柱和红金花艺" 9 4

生成 KV
1. 安装 uv，并从 Adobe 思源黑体 GitHub 仓库下载简体中文 Heavy 和 Regular 字体。
2. 把字体文件放到设置 JSON 同一目录；或修改 JSON 的 font_heavy、font_regular 路径。
3. 替换 logo、屏幕宽高、点间距、标题、口号、颜色。
4. 运行：uv run --with pillow s027_kv.py s027_kv_red.json kv.png

透视贴屏
- 安装 uv。
- 运行：uv run --with numpy --with opencv-python-headless s027_screen_paste.py stage-green.png kv.png preview.jpg
- 只把平面 KV 文件交给 LED 执行方；透视贴入后的 preview.jpg 是效果图，不能当播放文件。

注意
- 舞台照片会上传到 Google Gemini API。不要上传未经客户许可的照片或他人商标。
- API 按模型和用量计费，价格会变化；创建 Key 前查 Google 官方价格。
- LED 的实际像素、文件格式、色彩模式、安全区和播放参数都要由执行方确认。
- 脚本只针对一块长方形纯绿屏；绿叶、绿色灯光、绿幕反光、曲面屏和多块侧屏都可能导致识别错误。
