三步跑通 OpenToonz：从源码构建到主题定制与场记板工作流

三步跑通 OpenToonz：从源码构建到主题定制与场记板工作流

【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonz

OpenToonz 是一款开源的 2D 动画创作软件，覆盖逐帧绘制、矢量绘制、特效合成（把多层画面叠成最终画面）、场记板等完整工作流。下面按三个阶段带你从"跑起来"走到"用顺手"。

跑起来：一条线从代码到启动

1. 拉代码 ⭐

在终端执行git clone https://gitcode.com/GitHub_Trending/op/opentoonz，仓库约 2GB，保持网络稳定。拉下来后toonz/sources/是核心源码，thirdparty/里已捆绑 Lz4、zlib、libtiff 等依赖，多数无需自己找。

2. 装构建依赖 ⭐⭐

各系统的依赖清单分别在 Linux 构建指南、Windows 构建指南、macOS 构建指南。Linux 的核心项：CMake 3.10+、Qt 5.15+、Boost、SuperLU、OpenCV、libmypaint，用发行版包管理器一条命令装齐，文档里给了 Ubuntu、Fedora、Arch 的现成命令。

3. 编译并首次启动 ⭐⭐⭐

进入toonz/目录，先按文档编译thirdparty/tiff-4.0.3（构建需要修改过的 libtiff），再在build/子目录执行 cmake 指向../sources，然后make -j全量构建，耗时较长。构建完成后做两件事：把stuff/目录复制到~/.config/OpenToonz/（这是运行时配置目录，主题、笔刷、场记板预设都从它加载），再把LD_LIBRARY_PATH指向 build 下的lib/opentoonz，运行./bin/OpenToonz即可。若 CMake 没找到 SuperLU 等库，用变量显式指定头文件目录，例如-DSUPERLU_INCLUDE_DIR=/usr/include/SuperLU。

❌ 别直接在仓库里改stuff/→ ✅ 改~/.config/OpenToonz/下的副本，重新克隆也不会丢你的定制。

改起来：三处最高频的定制

以下改动都作用在~/.config/OpenToonz/下的 stuff 副本，不动仓库本身。

换界面主题：只挑一个 qss 文件

偏好面板里能切换主题，每个主题对应stuff/config/qss/<主题名>/<主题名>.qss，仓库自带 Dark、Light、Blue、Clay、Default 等 8 套。想自定义配色，在 qss 下加同结构的文件夹放你的 .qss 即可被选中。注意 .qss 里图片路径用相对url(...)引用，挪动文件夹后图标会丢。

定制输出规格：reslist.txt 一行一个分辨率

stuff/config/reslist.txt逐行列出分辨率预设（HD 1080、PAL 16/9、Academy Full Frame 等），新建项目时直接可选；stuff/config/safearea.ini定义安全区。有特殊交付规格就按"名称, 宽x高, 宽高比"格式加一行。

❌ 把 reslist.txt 当成素材路径列表往里塞文件夹 → ✅ 它只管分辨率模板；素材目录应放在stuff/library/下，避免项目迁移后丢失。

改默认笔刷：brush.txt 加一行

stuff/config/brush.txt决定默认笔刷菜单内容，每行"笔刷名 + 参数"；自己的矢量笔刷可放入stuff/library/vector brushes/（.pli 文件），会自动出现在素材库。

用起来：两个真实生产场景

给镜头挂上场记板

stuff/library/clapperboards/preset_sample.clapperboard是现成的场记板（自动标注场景号、镜头号的片头板）预设，定义了场景路径、用户名等字段的位置，背景图在stuff/library/clapperboards/images/board1.png。载入时间线后调整文本字段即可使用，不用自己画。

给拍摄的手绘稿做透视校正

动画赛璐珞（画了角色的透明胶片）拍摄后必然变形。把仓库里的stuff/library/camera calibration/checkerboard.tif随稿件一起拍进画面，在相机设置中用它标定，OpenToonz 就能把倾斜画面摆正。


团队共用构建环境时，记得在stuff/config/permissions.xml里配好多用户农场的账号权限。

下一步：跑通之后去哪看

• 插件开发：读 plugins/ 下两个最小示例，blur 演示像素级特效，geom 演示几何变换，plugins/utils/里是可直接复用的参数与仿射变换头文件
• 特效源码：特效面板里的 FX 都实现在 toonz/sources/stdfx/，挑一个读透就能照着写自己的
• 社区贡献：提交 PR 前先按 PR 测试流程 在你的平台上验证构建

【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonz