OpenToonz 开源 2D 动画软件：从源码构建到界面定制的完整指南
OpenToonz 开源 2D 动画软件从源码构建到界面定制的完整指南【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonzOpenToonz 是由日本 DWANGO 公司发布的开源 2D 动画创作软件其前身是吉卜力工作室长期定制使用的 Toonz Studio。它面向独立动画师和小型工作室提供免费的逐帧绘制、特效合成与整部动画制作流程支持 Windows、macOS 和 Linux。它能为动画制作做什么传统手绘动画流程支持逐帧扫描、透视校正用棋盘格校准相机和透明赛璐璐上色扫描稿数字化后直接进场景合成。特效与合成FX 即 effects特效系统源码里 toonz/sources/stdfx/ 一个目录就有 200 多个特效实现模糊、运动模糊、粒子等都能挂到图层上实时预览。跨平台一致运行Windows、macOS、Linux 的构建结果由 CI 持续验证你构建出的版本在功能上与官方发布版基本一致。源码构建与首次启动以 Linux 为例普通用户其实可以直接去官网下载安装包。但如果你想自己编译比如想改源码按下面 4 步走Windows 和 macOS 用户把文档换成 doc/how_to_build_win.md、doc/how_to_build_macosx.md 即可。获取代码。本机装好 Git执行git clone https://gitcode.com/GitHub_Trending/op/opentoonz前置条件网络稳定仓库含 thirdparty 依赖体积较大。常见失败Git 未安装或代理没配好导致克隆中断重试加-j 8并行下载可提速。装依赖。参考 doc/how_to_build_linux.md 里的列表Git、CMake 3.10、Qt 5.15、Boost 1.55、LibPNG、SuperLU、Lzo2、FreeType、LibMyPaint 1.3、Jpeg-Turbo、OpenCV 3.2。Debian/Ubuntu 一条sudo apt-get install ...命令即可装齐文档中已给全。最常见失败原因是漏装libmypaint-dev和libsuperlu-devCMake 配置阶段会报找不到库。初始化运行配置。OpenToonz 启动时需要一个stuff目录存放素材和配置。把仓库里的stuff/整个复制到~/.config/OpenToonz/下文档中给出了现成命令。漏了这一步程序启动后会提示缺少资源或直接起不来。编译并运行。进入toonz/下新建build目录依次执行cmake ../sources和make -j$(nproc)构建时间较长需要耐心然后用LD_LIBRARY_PATH./lib/opentoonz前缀运行./bin/OpenToonz。若 CMake 提示找不到 SuperLU可显式传入-DSUPERLU_INCLUDE_DIR/usr/include/SuperLU。首次启动后你的个人设置会保存在~/.config/OpenToonz/目录里与仓库文件分离升级时不会互相覆盖。项目地图关键目录速览路径管什么什么时候需要碰它toonz/sources/核心源代码按模块分目录如stdfx特效、toonz主程序、toonzlib基础库想改功能、修 bug 或做二次开发时stuff/config/用户侧配置界面主题、分辨率预设、权限换主题、调界面行为时stuff/library/内置素材库矢量笔刷、MyPaint 笔刷、纹理、粒子、场记板模板往项目里加素材或找画笔时thirdparty/第三方依赖源码zlib、libpng、libtiff 等依赖版本不满足、需要本地编译时doc/各平台构建指南、主题开发、PR 测试流程文档构建报错或想参与贡献时三个高频入口换界面主题主题文件在 stuff/config/qss/ 下已有 Default、Dark、Darker、Blue、Light、Clay、Neutral 等 8 套.qss样式在程序界面中选择即可想自己写主题按 doc/how_to_stylesheet.md 用 LESS 语法开发。加自定义分辨率编辑 stuff/config/reslist.txt按名称, 宽x高, 宽高比一行一条追加例如新增 2K 16:9 预设。改快捷键和工作区布局、菜单、工具栏、快捷键分别存在 stuff/profiles/layouts/ 的rooms/、menubar.xml、toolbars/、shortcuts/里按动画场景存一套布局切换时直接加载。两个真实使用场景场景一扫描稿透视校正后上色前提你有扫描仪和一张棋盘格校准图仓库里现成提供 stuff/library/camera calibration/checkerboard.tif扫出来就是标准参考。操作把棋盘格图和扫描的手绘稿以相同设置扫入在透视/相机校正功能里让程序识别棋盘格生成相机参数再把手绘稿导入该相机通道程序会自动把歪斜的画稿拍正并去底。预期结果手绘稿变成正对镜头的透明图像可以直接叠在参考图上做逐帧上色后续帧次沿用同一相机参数即可。场景二开场加场记板前提新建一个场景时间轴面板可用。仓库提供了场记板模板 stuff/library/clapperboards/images/board1.png 和预设文件preset_sample.clapperboard。操作把场记板图导入场景第一帧套用 clapperboard 预设参数在板上填入镜头号、场次、日期再画一条拍板合拢的动画。预期结果成片开头出现带完整镜头信息的场记板后期合成和对音轨都有统一的时间基准。新手容易踩的坑为什么程序启动后提示缺素材或者界面光秃秃你多半没把stuff/目录复制到~/.config/OpenToonz/Linux或对应平台配置位置。这个目录是素材和默认配置的来源构建文档里明确要求这一步复制完重启程序即可。改了stuff/config/里的文件升级后配置会被覆盖吗不会。stuff/是你的用户数据目录和源码仓库分离升级软件或更新代码仓库都不影响它。反过来去改toonz/sources/下的源码配置是错误的做法——那是代码升级仓库时你的改动会冲突甚至丢失界面和素材行为都应在stuff/config/下调整。往reslist.txt或permissions.xml里加绝对路径换台机器素材就找不到了对。素材和路径引用尽量用相对路径自定义素材统一放在stuff/library/下随项目走而不是指向某台机器的 D 盘或 home 目录。往深了走三条进阶路线读懂特效实现从 toonz/sources/stdfx/ 入手每个 FX 一个目录参数定义和渲染逻辑都在一起挑一个常用的比如模糊跟读源码。参与社区 PR 测试不会写代码也能帮上忙。按 doc/how_to_test_prs.md 的说明等 CI 出现全部检查通过如下图中 AppVeyor 与各平台构建全部打勾后下载构建产物单独解压运行测出问题反馈到 PR 评论区。遵循贡献规范提交代码前先过一遍 doc/development_checklist.md核心原则是改动不得干扰现有用法行为有冲突时优先做成用户可选项主题开发则看 doc/how_to_stylesheet.md。【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考