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

发布时间:2026/9/20 17:40:08
如何免费构建 OpenToonz:开源 2D 动画软件完整入门指南 如何免费构建 OpenToonz开源 2D 动画软件完整入门指南【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonzOpenToonz 是一款开源的全功能 2D 动画创作软件把逐帧绘制、矢量上色、时间轴、特效合成和渲染农场装进同一个程序里。本文带你从零克隆仓库、完成构建、跑起来并讲清楚仓库里每个目录的用途和几个最实用的个性化配置点。所有路径都以仓库根目录为基准。OpenToonz 是什么适合谁OpenToonz 的核心代码放在toonz/sources/目录按模块拆分toonz/是主程序界面stdfx/是两百多个特效实现toonzfarm/是多机渲染农场toonzqt/是界面组件。它适合两类人想免费学传统手绘动画流程的独立动画师以及需要完整 2D 动画工作流但不想购买商业软件的小团队。安装前准备按系统确认依赖三个平台共同的依赖是 Git、CMake3.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.2Debian/Ubuntu 用户可以用一条apt-get install命令装齐完整命令见 doc/how_to_build_linux.mdmacOS 环境要求Xcode、Homebrew、git用brew install一次性安装 glew、lz4、libjpeg、libpng、lzo、libusb、git-lfs、libmypaint、qt5、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。仓库地图五个关键目录目录用途toonz/sources/主程序源码含界面、特效、渲染农场等模块stuff/config/默认用户配置主题样式表、分辨率预设、权限与版本控制设置stuff/profiles/工作区布局170 多个 xml、工具栏配置和快捷键映射stuff/library/内置素材库笔刷、纹理、粒子、场记板、相机校准图thirdparty/第三方依赖的源码与预编译库zlib、libpng、libtiff、lzo、superlu、openblas 等插件示例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_DecreaseBrushHardnessCtrl[改成你顺手的组合。添加自定义分辨率预设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/可放进时间轴快速标记镜头信息。![OpenToonz 相机校准棋盘格素材](https://raw.gitcode.com/GitHub_Trending/op/opentoonz/raw/448d5a19cfab9201c00f21e45a35857a4bb25af2/stuff/library/camera calibration/checkerboard.tif?utm_sourcegitcode_repo_files)相机校准棋盘格位于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/SuperLUQt 路径则设置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 会同时构建 Ubuntugcc/clang、macOS 和 Windows 三个平台。完成上面的构建后你可以先建一个小场景练手导入几张图、排进时间轴、加一个模糊特效导出跑通全流程再谈深度定制。【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonz创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考