企业官网建设流程全解析

OpenToonz 2D 动画软件从入门到进阶：免费开源动画制作完整指南

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

OpenToonz 是一款免费的开源 2D 动画创作软件，由日本 Dwango 基于吉卜力工作室长期使用的 Toonz Studio 开发而来，内置逐帧绘制、线稿清理、特效合成等完整功能。本文按「装好 → 跑起来 → 改配置 → 出作品 → 不踩坑」的任务线带你走完一遍。

一、先搞清这个仓库里有什么

拿到源码后，别急着编译，先花两分钟认识目录，后面每一步都能对上号：

二、30 分钟把软件跑起来

1. 把源码拿下来（难度：⭐）

git clone https://gitcode.com/GitHub_Trending/op/opentoonz

仓库里有大量第三方库源码，体积不小，克隆时保持网络稳定。

2. 按系统装依赖（难度：⭐⭐）

不同平台依赖差别较大，官方文档写得很细，直接对着做：

• Linux 看 how_to_build_linux.md，用apt或dnf一条命令装齐 Qt5、Boost、OpenCV 等
• Windows 看 how_to_build_win.md，需要 VS2019 + Qt 5.15 + CMake
• macOS 看 how_to_build_macosx.md

常见的坑是：Qt 版本不对。OpenToonz 只认 Qt 5.x（5.15 以上），装了 Qt6 会编译失败。如果卡住了，多半是这一步。

3. 复制配置目录再编译（难度：⭐⭐）

Linux 下有个容易漏掉的步骤——先把stuff目录拷到用户配置目录，软件才知道去哪找默认配置：

mkdir -p ~/.config/OpenToonz cp -r opentoonz/stuff ~/.config/OpenToonz/

再进toonz目录建build文件夹，跑cmake ../sources和make -j$(nproc)。编译时间较长，耐心等。完成后运行./bin/OpenToonz即可看到启动界面。

Windows/macOS 的产物路径见各自文档，原理相同。

三、改界面主题只需动一个文件

OpenToonz 的界面样式是 QSS 文件（Qt 的样式表，类似 CSS 控制配色）。所有主题集中在 stuff/config/qss/，每个子目录是一种主题：

想换配色，打开对应目录里的.qss文件改颜色值即可；想彻底自定义，照Default目录的结构新建一套。主题文件是用户可改的，不会和源码耦合。

四、让配置跟着你的手走

下面这几个文件决定了你每次打开软件看到什么，都在 stuff/config/ 下：

1. 画刷手感（难度：⭐）

brush.txt 用 XML 列出每个画刷的粗细、硬度、抖动参数。画起来发飘或太硬，调这里对应<brush>节点的数值。

2. 色彩命名（难度：⭐）

colornames.txt 定义调色板里颜色块的名称（如红、绿、蓝或自定义名）。改名后界面色块显示就会跟着变，方便团队统一叫法。

3. 分辨率预设（难度：⭐）

reslist.txt 列出项目可选的画面尺寸（UHD 4K、HD 1080、PAL、NTSC 等）。新建项目时的分辨率下拉菜单就来自这里，加一行即可新增自定义尺寸。

4. 权限设置（难度：⭐⭐）

permissions.xml 管理协作时的账号。多人用 SVN 同步场景时，<users>节点里要配好成员账号，否则会出现部分功能不可用的情况。

5. 保存自己的工作区布局（难度：⭐）

做完一套顺手的界面排布后，把布局存到 stuff/profiles/layouts/，下次换机或换项目直接套用，不用重新摆面板。

五、两个常见制作场景怎么起步

场景 1：扫描手绘稿做透视校正（难度：⭐⭐⭐）

传统手绘流程中，扫描稿常有透视变形。OpenToonz 自带相机校准功能，用仓库里这张棋盘格测试图即可验证校正效果：


配合 stuff/library/vector brushes/ 里的矢量笔刷预设，线稿就能平滑地进入逐帧时间轴。

场景 2：用场记板快速标注分镜（难度：⭐⭐）

做分镜时不用手画场记板，直接调用 stuff/library/clapperboards/ 里的模板：

六、五个最常踩的坑，对照着改

错误做法 / 正确做法

1. 手动改toonz/sources/里的源码配置 → 应该改stuff/config/下的用户配置文件，升级时才不会丢设置。
2. 权限没配就协作，发现功能灰掉 → 检查 permissions.xml 的<users>节点，把成员加进去。
3. 素材路径写绝对路径，换机后全丢 → 用相对路径，自定义素材统一放 stuff/library/。
4. 装错 Qt 版本导致编译失败 → 确认是 Qt 5.15+，不是 Qt6。
5. 测试新特性直接在生产场景上试 → 先用可丢弃的空白场景，或备份OpenToonz stuff文件夹。

七、想再深入一点

跑通之后，可以往这三个方向走：

• 读 plugins/ 下的模糊、几何插件源码，照着写自己的自定义插件；
• 翻 toonz/sources/stdfx/ 看内置特效怎么实现；
• 不写代码也想帮忙？按 how_to_test_prs.md 的流程测试社区的 PR 就能贡献力量。

到这里，从克隆仓库到出作品的整条路你已经走了一遍。剩下的，就是把你的第一个动画做出来。

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