企业官网建设流程全解析

如何免费构建 OpenToonz：开源 2D 动画软件完整入门指南

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

OpenToonz 是一款开源的全功能 2D 动画创作软件，把逐帧绘制、矢量上色、时间轴、特效合成和渲染农场装进同一个程序里。本文带你从零克隆仓库、完成构建、跑起来，并讲清楚仓库里每个目录的用途和几个最实用的个性化配置点。所有路径都以仓库根目录为基准。

OpenToonz 是什么，适合谁

OpenToonz 的核心代码放在toonz/sources/目录，按模块拆分：toonz/是主程序界面，stdfx/是两百多个特效实现，toonzfarm/是多机渲染农场，toonzqt/是界面组件。它适合两类人：想免费学传统手绘动画流程的独立动画师，以及需要完整 2D 动画工作流但不想购买商业软件的小团队。

安装前准备：按系统确认依赖

三个平台共同的依赖是 Git、CMake（3.10 以上）和 Qt 5.x（推荐 5.15）。各系统的差异如下。

Windows 环境要求

• Visual Studio 2019，安装时勾选全部 Visual C++ 组件
• Qt 5.15 的 64 位版本
• Boost 1.55 及以上、OpenCV 4.1 及以上
• 仓库里的.lib/.dll文件用 Git LFS（大文件存储）管理，克隆后要执行git lfs pull才能真正拿到二进制文件；建议再执行一次git config core.safecrlf true，避免日文注释因换行符问题导致编译报错

Linux 依赖清单

• 编译器 GCC 或 Clang、CMake 3.10+、Qt 5.15+（含 svg、script、tools、multimedia 等模块）
• Boost、LibPNG、LibTIFF、SuperLU、LZO2、FreeType、LibMyPaint 1.3+、Jpeg-Turbo、OpenCV 3.2+
• Debian/Ubuntu 用户可以用一条apt-get install命令装齐，完整命令见 doc/how_to_build_linux.md

macOS 环境要求

• Xcode、Homebrew、git
• 用brew install一次性安装 glew、lz4、libjpeg、libpng、lzo、libusb、git-lfs、libmypaint、qt@5、boost、jpeg-turbo、opencv，详见 doc/how_to_build_macosx.md

克隆仓库并跑起来

克隆代码

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

克隆完成后，Windows 用户补跑git lfs pull。

Linux 上的构建步骤

以 Linux 为例，完整流程四步：

cd thirdparty/tiff-4.0.3 && ./configure --with-pic --disable-jbig && make 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

第一行构建仓库自带的修改版 libtiff，第二行把stuff/目录复制到 OpenToonz 读取用户素材的位置，后两行完成编译并启动。想安装到系统目录，直接sudo make install，默认装到/opt/opentoonz。Windows 和 macOS 用 CMake 生成对应工程后编译，流程见 doc/how_to_build_win.md。

仓库地图：五个关键目录

插件示例plugins/目录和进阶内容放在最后一起讲。

个性化配置：四个最常用改法

修改界面主题配色

主题样式表在stuff/config/qss/下，内置 Default、Dark、Darker、Light、Blue、Clay、Neutral、Default-Green 八套，每套一个.qss文件（如Default/Default.qss）和配套图标。改颜色就直接编辑对应.qss里的背景与前景值，重启程序生效。

切换快捷键方案

stuff/profiles/layouts/shortcuts/里有五套现成映射：defopentoonz.ini是默认方案，另外四套分别对应 Adobe、Animate、Harmony、Retas 的操作习惯。想自定义，复制一份默认 ini 改右侧按键即可，比如把A_DecreaseBrushHardness=Ctrl+[改成你顺手的组合。

添加自定义分辨率预设

stuff/config/reslist.txt存放新建项目可选的分辨率列表，已有 UHD 4K、HD 1080、PAL/NTSC、DCI 2K/4K 等条目，每行格式是「名称, 宽x高, 宽高比」。在文件末尾追加一行，新建项目时就能选到。

扩展内置素材库

stuff/library/是素材大本营：矢量笔刷在vector brushes/，MyPaint 笔刷在mypaint brushes/（含 aotz、classic、experimental 等系列），纹理、粒子、着色器各有独立子目录。两个实用的模板资源：

场记板模板位于clapperboards/，可放进时间轴快速标记镜头信息。


相机校准棋盘格位于camera calibration/，扫描手绘稿做透视校正时，用它和原稿同框拍摄作为标定参考。自己的笔刷和纹理也建议放进这里，项目迁移时不会丢素材。

新手容易卡住的三个地方

启动后缺少默认素材和主题

现象：程序能启动，但笔刷、主题、布局都不对劲。原因：Linux 上 OpenToonz 从~/.config/OpenToonz/读用户素材，而刚克隆的仓库里这个目录并不存在。怎么办：把仓库的stuff/整个复制过去，即构建步骤里的第二行命令。

Windows 克隆后构建缺二进制文件

现象：thirdparty/下有目录但打开文件内容不对，链接失败。原因：.lib、.dll走 Git LFS 通道，普通 clone 只下载了指针文本。怎么办：安装 git-lfs 客户端后执行git lfs pull。

CMake 提示找不到 SuperLU 或 Qt

现象：cmake阶段报依赖缺失。原因：依赖装在非标准路径，CMake 自动探测不到。怎么办：显式指路，例如cmake ../sources/ -DSUPERLU_INCLUDE_DIR=/usr/include/SuperLU；Qt 路径则设置QT_DIR或QT_PATH。

进阶方向

• 插件开发：参考plugins/blur/或plugins/geom/，每个插件就是一个CMakeLists.txt加源文件的小工程；plugins/utils/里的affine.hpp、rect.hpp等工具头文件可以直接复用。
• 读特效源码：toonz/sources/stdfx/是特效主战场，配合stuff/config/current.txt（记录每个特效的界面显示名与参数翻译）当索引用，读起来快很多。
• 社区贡献：先看 CONTRIBUTING.md；提交 PR 前按 doc/how_to_test_prs.md 下载 CI 自动构建的产物自测，仓库的 CI 会同时构建 Ubuntu（gcc/clang）、macOS 和 Windows 三个平台。

完成上面的构建后，你可以先建一个小场景练手：导入几张图、排进时间轴、加一个模糊特效导出，跑通全流程再谈深度定制。

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