# CAVE AE 脚本工具包使用说明

本工具包包含两个 After Effects JSXBIN 脚本：

- `CAVE空间生成器 - V6.2.jsxbin`
- `CAVE自定义屏幕搭建器 - V01.1.jsxbin`

公开 ZIP 包只包含上述两个脚本和说明文档，不包含源码、授权码、授权后台、AEP 工程、备份目录或其他开发文件。

## 1. 选择哪个脚本

### CAVE空间生成器 V6.2

适合从零创建标准空间工程：

- 二折、三折、四折、五折 CAVE。
- 直角 L 屏、弧角 L 屏、T 字形屏幕。
- 内拐或外拐圆柱弧面屏。
- 裸眼 3D 投射工程、切割合成、分区输出和 3D 预览。
- 需要导入 C4D JSON 相机或 AEC 文件辅助对齐的项目。

### CAVE自定义屏幕搭建器 V01.1

适合自由屏幕布局和后续维护：

- 单块屏幕逐个创建、读取、复制、删除和重建。
- 三折、四折、五折、L 型、U 型模板。
- 5 连屏、3x2 矩阵、弧形五连屏、内拐圆柱屏、外拐圆柱屏。
- 保存和载入 JSON 布局。
- 手动调整总输出顺序和屏幕角色。

## 2. 安装与运行

1. 解压 `CAVE-AE脚本工具包_双脚本版.zip`。
2. 在 AE 中选择“文件 > 脚本 > 运行脚本文件”。
3. 选择需要运行的 `.jsxbin` 文件。
4. 如果希望脚本固定出现在 AE 菜单中，可把 `.jsxbin` 放入 AE 脚本目录。
5. 首次使用先点击脚本顶部“激活”，输入在线授权码或离线激活码。

## 3. 推荐工作流

1. 项目是标准 CAVE、L 屏、圆柱空间或裸眼 3D 投射时，先用 `CAVE空间生成器 - V6.2.jsxbin` 建立基础工程。
2. 项目需要自由增删屏幕、批量矩阵、圆柱分段、排序或 JSON 备份时，使用 `CAVE自定义屏幕搭建器 - V01.1.jsxbin`。
3. 创建后检查两个关键合成：总输出合成用于看展开画面，3D 预览合成用于看空间位置。
4. 修改尺寸、投射方式或屏幕顺序后，重新执行对应脚本中的更新或重建功能。

## 4. 注意事项

- `.jsxbin` 是客户运行文件，请不要改名到无法识别版本的状态。
- 未激活时通常只能打开面板和查看说明，创建、更新、重建等功能需要授权。
- 圆柱和弧角分段越多，AE 工程越重；新手建议从较低分段开始测试。
- 总输出排列不正确时，先检查布局模式和屏幕顺序，再重建总输出。
- 如需购买或处理授权，请访问：[https://yuanman.nat100.top/](https://yuanman.nat100.top/)