企业官网建设流程全解析

OpenToonz 快速上手指南：安装、构建与避坑

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

OpenToonz 是什么，能帮你做什么

完整的 2D 动画工具链：绘制、清线、特效、合成全在同一款软件里，适合独立创作者做逐帧短片。工作室级管线：源自吉卜力使用的 Toonz，工作流与专业动画制作流程一致。跨平台开源：Windows、macOS、Linux 都能构建运行同一套功能，源码可改可查。

一句话总结：OpenToonz 让你免费装上一套能干实际活、还能看源码的 2D 动画软件。

环境准备与首次运行

1. 克隆源码（操作难度：⭐）

前置条件：Git 已安装并加入系统 PATH。

先克隆完整源码，再拉取 Git LFS 管理的二进制文件（构建时需要）：

git clone https://gitcode.com/GitHub_Trending/op/opentoonz cd opentoonz && git lfs pull

验证信号：当前目录出现opentoonz/，里面有doc/、toonz/sources/、thirdparty/等子目录。

2. 安装依赖（操作难度：⭐⭐）

前置条件：系统包管理器可用（apt/dnf、Homebrew 或 Windows 安装包合集）。

依赖包括 Qt 5.15、Boost、OpenCV、libmypaint 等，各平台完整清单在对应文档里，按文档一条命令装齐即可：

• Linux（Debian/Ubuntu）：按 doc/how_to_build_linux.md 安装完整清单，例如：

sudo apt-get install cmake qtbase5-dev libboost-all-dev libopencv-dev libmypaint-dev

• macOS：装好 Xcode 和 Homebrew 后，按 doc/how_to_build_macosx.md 安装：

brew install cmake qt@5 boost opencv libmypaint

• Windows：按 doc/how_to_build_win.md 安装 Visual Studio 2019（含 C++ 组件）、CMake、Qt 5.15（64 位），无需命令行。

验证信号：cmake --version显示 3.10 或更高。

3. 构建并启动（操作难度：⭐⭐⭐）

前置条件：依赖已装好；Linux 需要能跑cmake和make的终端。

Linux 上先把stuff/复制到用户配置目录（运行必需），再进入toonz/编译：

mkdir -p ~/.config/OpenToonz && cp -r stuff ~/.config/OpenToonz/ cd toonz && mkdir build && cd build cmake ../sources && make -j$(nproc)

构建耗时较长，请耐心等待。完成后设置库路径并启动：

LD_LIBRARY_PATH=./lib/opentoonz ./bin/OpenToonz

• Windows：用 CMake 生成工程后，在 Visual Studio 中打开toonz/build/OpenToonz.sln编译，产物在Release/目录。
• macOS：cmake+make完成后，运行build/toonz/里的OpenToonz.app。

验证信号：主窗口打开，中央画布与底部时间轴可见——OpenToonz 跑起来了。

核心模块地图

最常用的两个是 stuff/config/ 与 stuff/library/：前者决定启动后的外观与资源清单，后者是现成"素材超市"，笔刷、纹理、分镜板一应俱全。

跟走一个真实工作流：从分镜到第一组动画

前提是 OpenToonz 已成功启动，全程约 20 分钟。

1. 新建场景——在哪里：启动后从主菜单新建工程。做完后的效果：画布、层面板、时间轴就位。
2. 导入场记板——在哪里：直接用仓库内置的场记板模板做分镜底板：

做完后的效果：在场记板上填镜头号、场景信息，分镜记录从此统一格式。 3.逐帧绘制——在哪里：stuff/library/vector brushes/ 有 41 个 .pli 矢量笔刷预设，在笔刷面板任选一个，沿时间轴逐层绘制。💡 提示：手绘感更强的光栅笔刷在 stuff/library/mypaint brushes/。 4.播放与导出——在哪里：时间轴按播放；满意后从文件菜单导出。⚠️ 注意：实验建议用新建的、可随时丢弃的场景，避免覆盖已有作品。

走完后，你得到的是一段能回放、能导出的第一组逐帧动画。

高频问题速查

• Q：Linux 构建时 CMake 找不到 SuperLU？→ A：按 doc/how_to_build_linux.md 显式指定目录，如加-DSUPERLU_INCLUDE_DIR=/usr/include/SuperLU。
• Q：Linux 启动失败、界面资源缺失？→ A：多半漏了把stuff/复制到~/.config/OpenToonz/，这步是运行前提。
• Q：CMake 找不到 Qt（macOS/Windows）？→ A：用-DQT_PATH=...指向已装 Qt 的库目录，详见两份构建文档。
• Q：想贡献代码从哪入手？→ A：先读 doc/development_checklist.md；也可以按 doc/how_to_test_prs.md 测试 PR，每个 PR 都经多平台 CI 验证：

接下来可以做什么

• 社区贡献：提交 PR 前先读开发清单，弄清规范与测试要求。
• 插件开发：从 plugins/blur/ 的最小示例读起，plugins/utils/ 的参数接口可直接复用。
• 测试 PR：按 doc/how_to_test_prs.md 下载 CI 构建产物，体验未发布的新功能。

打开终端，从第一条克隆命令开始。

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