Frame By Plane 是专为 Blender 5.2 LTS 开发的图像序列动画、蜡笔、分层 PSD 与 Procreate 作品、2.5D 多平面场景、合成及非破坏性特效插件。

它的工作方式类似于 Blender 原生的 图像转平面，但增加了对时间控制、图层、蒙版、摄像机深度、渲染和逐帧动画工作流程的生产级控制。

从 Blender 扩展平台下载 · 下载最新 GitHub 版本 · 阅读 GitHub Wiki

• 修复了 Blender 5.2 上所有 27 个原生蜡笔特效后端的持久所有权问题。
• 防止了未受管理的重复着色器特效和蜡笔修改器。
• 恢复了可靠的添加、移除、重新排序、重置和重复修复操作。
• 为蜡笔特效堆栈添加了全部展开和全部折叠控制。
• 修复了 Blender 5.2 颜色、向量和旋转插槽值的合成器安全修复快照。
• 通过了原生 Blender 5.2.0 后台测试和 300 次重绘的交互式 UI 压力测试。

查看完整的 7.1.18 发布说明。

• 将静态图像、编号图像序列、文件夹和视频作为可控平面导入。
• 使用循环、往复和单次播放模式，配合时间线和帧偏移控制。
• 通过书签、预览范围和洋葱皮控制，在视口中擦洗和编辑蜡笔时间轴。

• 导入分层 PSD 和 Procreate 项目，同时保留透明度和图层结构。
• 在摄像机深度中排列作品，用于视差、多平面动画和动态漫画工作流。
• 管理图层可见性、文件夹、混合模式、裁剪、保留和透明度感知剪切。

• 创建与图像层关联的绘制平面，或使用独立的蜡笔画布。
• 从一个紧凑堆栈中应用原生 Blender 蜡笔修改器和着色器特效。
• 构建形状、颜色、亮度、通道、渐变、噪波、导入和蜡笔蒙版。
• 使用非破坏性扭曲、模糊、颜色、光照、风格化和合成特效。

• 构建 Blender 原生合成器图层包，同时保留艺术家创建的节点和链接。
• 使用安全修复、诊断和回滚感知项目健康工具。
• 在 Blender 内部控制面向摄像机的平面、投影仪、渲染输出和图像序列交付。

• Blender 5.2.x LTS
• Windows x64 或 ARM64、macOS Intel 或 Apple Silicon、Linux x64

1. 打开最新 GitHub 版本页面。
2. 下载与您的计算机匹配的 ZIP 文件。
3. 在 Blender 中，打开 编辑 → 偏好设置 → 获取扩展。
4. 点击右上角菜单，选择 从磁盘安装。
5. 选择下载的 ZIP 文件（无需解压）。

有关干净更新或架构详情，请阅读安装指南。

1. 在 Blender 3D 视口侧边栏中打开 Frame By Plane 选项卡。
2. 选择单个图像、序列、文件夹、PSD、Procreate 文件或视频。
3. 设置时间和播放，然后创建图层或多平面项目。
4. 使用 图层、特效、蜡笔、摄像机 和 渲染 来完善场景。
5. 如果项目需要检查，请在提交问题前打开 项目健康 并复制诊断报告。

• 功能指南
• 安装与更新
• Blender 5.2 故障排除
• 发布流程
• GitHub Wiki
• 错误报告与功能请求

错误报告应包含 Blender 版本、操作系统、重现步骤以及可用的 Frame By Plane 诊断报告。Frame By Plane 不会发送遥测或项目数据。

frame_by_plane/       Blender扩展源代码、测试、资源和捆绑wheel
.github/              Issue模板和验证工作流
docs/                 安装、功能、故障排除和发布文档
tools/                仓库验证和平台构建脚本
release-notes/        可直接使用的GitHub发布说明

为每个声明的平台构建优化包：

blender --command extension build \
      --source-dir ./frame_by_plane \
      --output-dir ./dist \
      --split-platforms

运行原生 Blender 5.2 回归测试套件：

python frame_by_plane/tests/run_blender_lts.py \
      --blender /path/to/blender \
      --all

Windows 用户可运行 tools/build_release.ps1；macOS 和 Linux 用户可运行 tools/build_release.sh。

在提交拉取请求之前，请阅读贡献指南。

Frame By Plane 在 GNU通用公共许可证v3.0或更高版本 下发布。捆绑的第三方组件保留其原始许可证；详见第三方声明文件。