如何构建 OpenToonz免费 2D 动画软件的完整上手指南【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonzOpenToonz 是一款免费、功能完整的 2D 动画创作软件源自吉卜力工作室实际投入生产的 Toonz Studio 吉卜力版本以 Modified BSD 协议开源。本文带你跑通 Linux 上的源码构建、看见第一个界面并讲清仓库里核心目录、主题配置与内置资源的用法适合想运行它、修改它或扩展它的开发者。先弄懂来历这套软件为什么值得搭一遍它不是玩具项目。这套软件最早由意大利的 Digital Video 开发经吉卜力工作室多年制作定制后由 DWANGO 开源发布。传统 2D 动画的完整流程——原画扫描、清线、合成、特效、输出——都在里面。许可也很干净除thirdparty/与 MyPaint 笔刷包外其余代码可自由用于商业或个人目的随意修改。换句话说想制作 2D 动画它是一个免费的生产工具想研究大型动画软件架构它是一个模块划分清晰的 C Qt 完整工程。5 分钟跑起来Linux 构建路径只想用软件的话从官方渠道下载安装包最快以下步骤面向想从源码构建、改点东西再运行的人。完整细节在 doc/how_to_build_linux.md。拿到代码git clone https://gitcode.com/GitHub_Trending/op/opentoonz一次性装齐系统依赖Debian / Ubuntusudo apt-get install build-essential git cmake pkg-config libboost-all-dev qtbase5-dev libqt5svg5-dev qtscript5-dev qttools5-dev qttools5-dev-tools libqt5opengl5-dev qtmultimedia5-dev libqt5multimedia5-plugins libqt5serialport5-dev libsuperlu-dev liblz4-dev libusb-1.0-0-dev liblzo2-dev libpng-dev libjpeg-dev libglew-dev freeglut3-dev libfreetype6-dev libjson-c-dev qtwayland5 libmypaint-dev libopencv-dev libturbojpeg-dev关键版本要求CMake ≥ 3.10、Qt ≥ 5.15、Boost ≥ 1.55、OpenCV ≥ 3.2。Fedora、Arch、openSUSE 的对应安装命令都在同一份文档里。初始化资源目录必需步骤缺了程序起不来mkdir -p ~/.config/OpenToonz cp -r opentoonz/stuff ~/.config/OpenToonz/构建自带 libtiff再构建主程序cd opentoonz/thirdparty/tiff-4.0.3 ./configure --with-pic --disable-jbig make -j$(nproc) cd ../../../ cd toonz mkdir build cd build cmake ../sources make -j$(nproc)⚠️ 构建耗时不短官方指南的原话是be patient。务必用-j$(nproc)并行编译报错看不懂原因时改用LANGC make VERBOSE1查看完整输出方便定位。运行LD_LIBRARY_PATH./lib/opentoonz ./bin/OpenToonz界面出现就算跑通了。想装进系统就sudo make install默认落在/opt/opentoonz。Windows 用户的流程不同Visual Studio 2019 CMake Qt 5.15。克隆后要执行git lfs pull拉取 Git LFS 管理的 .lib/.dll 文件手动复制并重命名 4 个头文件jconfig.h、tif_config.h、tiffconf.h、pnglibconf.h最后让注册表键HKEY_LOCAL_MACHINE\SOFTWARE\OpenToonz\OpenToonz\TOONZROOT指向 stuff 目录——仓库里带了现成的注册表脚本 ci-scripts/windows/OpenToonzRegistrySetup.bat。中文指南见 doc/how_to_build_win_chs.md。把家底摸一遍最常碰的 4 个目录目录里面是什么什么时候用得上toonz/sources/软件主体的 C 源码数千个文件改功能、修 bugstuff/运行资源配置、笔刷、调色板、布局换界面主题、加素材、调工作台thirdparty/捆绑的第三方库源码与二进制构建报依赖错误时先查这里plugins/特效插件示例blur、geom、multiplugin想写自己的特效插件toonz/sources/是源码主战场内部按模块切分toonz/是主程序toonzqt/是 Qt 界面层stdfx/是特效引擎image/与common/是底层图像处理和公共工具。想改按钮、菜单去 toonzqt 找想改算法去 stdfx 或 image 找。stuff/是软件出厂自带的一切config/默认配置、library/笔刷与纹理、studiopalette/调色板、profiles/工作布局。Linux 上首次启动加载的就是拷贝到~/.config/OpenToonz/的这份内容Windows 上则通过注册表定位。thirdparty/把依赖备齐了libjpeg-turbo、libpng、tiff-4.0.3、glew、boost、openblas、superlu、kiss_fft、zlib 等。构建时报缺依赖先确认这个目录完整。plugins/是最好的教材plugins/blur/ 是单通道模糊plugins/geom/ 是几何变换plugins/multiplugin/ 是多输入通道插件每个都有 CMakeLists.txt 和少量 .cpp。写自己的特效从这三个起步。不写代码也能搭把手项目对每个 Pull Request 自动在 Windows、Ubuntugcc/clang、macOS 上编译你可以在合并前下载编译产物帮忙测试流程见 doc/how_to_test_prs.md。下图是验证通过时的样子5 个平台检查全绿藏在配置里的玩法主题、笔刷包与工作台stuff/ 里的资源不是死文件下面几处最值得动。界面主题改一个变量换一套配色stuff/config/qss/ 下有 Default、Dark、Darker、Light、Blue、Clay 等现成主题软件按各自的.qss文件切换外观。更有意思的是上游主题用 LESS 编写、编译成 QSS整套配色由少量基础变量驱动——只改bg-color面板底色、边框等所有派生颜色会自动跟着变。LESS 编译器怎么装、新主题怎么建doc/how_to_stylesheet.md 有完整步骤。 先在软件设置里切换主题感受效果确定要做自己的再动文件。笔刷包与素材库数字笔体验的地基stuff/library/mypaint brushes/ 收录 aotz、classic、deevad、experimental 等 9 套 MyPaint 笔刷包都是.myb笔刷文件加 PNG 预览放进软件即可选用。同级的还有 41 个矢量笔刷vector brushes/.pli格式、131 张纹理图、26 个着色器文件.vert/.frag和粒子素材序列particles/日常绘画与特效基本够覆盖。工作布局与特效预设一键换工作台布局stuff/profiles/layouts/ 下 197 个布局文件.xml/.ini决定面板、工具栏和功能区的摆法。团队要统一工作台交的就是这份。特效预设stuff/fxs/presets/ 自带一组粒子特效预设STD_particlesFx/*.fx选中即可套用。拍板stuff/library/clapperboards/ 提供现成的拍板模板图与预设文件拍板素材用于标记镜头编号、拍摄轮次等镜头信息翻车现场速查构建出问题先查这六处CMake 提示找不到 SuperLU现象cmake ../sources阶段失败提示 SuperLU 未找到原因系统的 SuperLU 装在非标准路径CMake 没自动探测到解决显式指路再跑cmake ../sources/ -DSUPERLU_INCLUDE_DIR/usr/include/SuperLULinux 构建完程序起不来现象编译无报错运行时程序闪退或界面残缺原因stuff 资源目录没初始化解决执行cp -r opentoonz/stuff ~/.config/OpenToonz/后再启动构建指南明确标注此步骤必需Windows 编译报 jconfig.h 等头文件缺失现象大量编译错误找不到 jconfig.h、tif_config.h原因这些文件在仓库里以别名存放需要自行复制并重命名解决按 doc/how_to_build_win_chs.md 的配置外部头文件一节重命名 4 个文件jconfig.vc → jconfig.h、tif_config.vc.h → tif_config.h、tiffconf.vc.h → tiffconf.h、pnglibconf.h.prebuilt → pnglibconf.hWindows 克隆后 .lib/.dll 是空壳现象thirdparty 下库文件异常CMake 或链接失败原因大文件由 Git LFS 管理普通克隆只拿到指针解决克隆后执行git lfs pull拉取真实文件构建失败提示缺少依赖现象编译器报某个头文件或库不存在原因系统依赖没装全解决对照 doc/how_to_build_linux.md 补跑本发行版的安装命令并确认 thirdparty/ 目录完整再定位不到问题就用LANGC make VERBOSE1看完整编译输出能运行但 mov 等媒体格式不支持现象程序正常个别媒体格式无法导入导出原因缺srv文件夹依赖 QuickTime SDK 的 32 位服务组件解决从已安装的 OpenToonz 目录把srv文件夹复制到程序目录官方说明没有它也能用只是少一部分媒体格式支持 动手改 stuff/ 前先备份。config/下的 batches.xml、permissions.xml 等文件影响批处理任务与权限设置修改后需重启软件生效。收尾OpenToonz 的源码不黑箱模块划分清楚依赖自带连主题和布局都留给你改。最快的入门动作就一个——打开 doc/ 里对应你系统的构建指南照着命令跑一遍先让它跑起来再逐个模块看进去。【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何构建 OpenToonz：免费 2D 动画软件的完整上手指南
如何构建 OpenToonz免费 2D 动画软件的完整上手指南【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonzOpenToonz 是一款免费、功能完整的 2D 动画创作软件源自吉卜力工作室实际投入生产的 Toonz Studio 吉卜力版本以 Modified BSD 协议开源。本文带你跑通 Linux 上的源码构建、看见第一个界面并讲清仓库里核心目录、主题配置与内置资源的用法适合想运行它、修改它或扩展它的开发者。先弄懂来历这套软件为什么值得搭一遍它不是玩具项目。这套软件最早由意大利的 Digital Video 开发经吉卜力工作室多年制作定制后由 DWANGO 开源发布。传统 2D 动画的完整流程——原画扫描、清线、合成、特效、输出——都在里面。许可也很干净除thirdparty/与 MyPaint 笔刷包外其余代码可自由用于商业或个人目的随意修改。换句话说想制作 2D 动画它是一个免费的生产工具想研究大型动画软件架构它是一个模块划分清晰的 C Qt 完整工程。5 分钟跑起来Linux 构建路径只想用软件的话从官方渠道下载安装包最快以下步骤面向想从源码构建、改点东西再运行的人。完整细节在 doc/how_to_build_linux.md。拿到代码git clone https://gitcode.com/GitHub_Trending/op/opentoonz一次性装齐系统依赖Debian / Ubuntusudo apt-get install build-essential git cmake pkg-config libboost-all-dev qtbase5-dev libqt5svg5-dev qtscript5-dev qttools5-dev qttools5-dev-tools libqt5opengl5-dev qtmultimedia5-dev libqt5multimedia5-plugins libqt5serialport5-dev libsuperlu-dev liblz4-dev libusb-1.0-0-dev liblzo2-dev libpng-dev libjpeg-dev libglew-dev freeglut3-dev libfreetype6-dev libjson-c-dev qtwayland5 libmypaint-dev libopencv-dev libturbojpeg-dev关键版本要求CMake ≥ 3.10、Qt ≥ 5.15、Boost ≥ 1.55、OpenCV ≥ 3.2。Fedora、Arch、openSUSE 的对应安装命令都在同一份文档里。初始化资源目录必需步骤缺了程序起不来mkdir -p ~/.config/OpenToonz cp -r opentoonz/stuff ~/.config/OpenToonz/构建自带 libtiff再构建主程序cd opentoonz/thirdparty/tiff-4.0.3 ./configure --with-pic --disable-jbig make -j$(nproc) cd ../../../ cd toonz mkdir build cd build cmake ../sources make -j$(nproc)⚠️ 构建耗时不短官方指南的原话是be patient。务必用-j$(nproc)并行编译报错看不懂原因时改用LANGC make VERBOSE1查看完整输出方便定位。运行LD_LIBRARY_PATH./lib/opentoonz ./bin/OpenToonz界面出现就算跑通了。想装进系统就sudo make install默认落在/opt/opentoonz。Windows 用户的流程不同Visual Studio 2019 CMake Qt 5.15。克隆后要执行git lfs pull拉取 Git LFS 管理的 .lib/.dll 文件手动复制并重命名 4 个头文件jconfig.h、tif_config.h、tiffconf.h、pnglibconf.h最后让注册表键HKEY_LOCAL_MACHINE\SOFTWARE\OpenToonz\OpenToonz\TOONZROOT指向 stuff 目录——仓库里带了现成的注册表脚本 ci-scripts/windows/OpenToonzRegistrySetup.bat。中文指南见 doc/how_to_build_win_chs.md。把家底摸一遍最常碰的 4 个目录目录里面是什么什么时候用得上toonz/sources/软件主体的 C 源码数千个文件改功能、修 bugstuff/运行资源配置、笔刷、调色板、布局换界面主题、加素材、调工作台thirdparty/捆绑的第三方库源码与二进制构建报依赖错误时先查这里plugins/特效插件示例blur、geom、multiplugin想写自己的特效插件toonz/sources/是源码主战场内部按模块切分toonz/是主程序toonzqt/是 Qt 界面层stdfx/是特效引擎image/与common/是底层图像处理和公共工具。想改按钮、菜单去 toonzqt 找想改算法去 stdfx 或 image 找。stuff/是软件出厂自带的一切config/默认配置、library/笔刷与纹理、studiopalette/调色板、profiles/工作布局。Linux 上首次启动加载的就是拷贝到~/.config/OpenToonz/的这份内容Windows 上则通过注册表定位。thirdparty/把依赖备齐了libjpeg-turbo、libpng、tiff-4.0.3、glew、boost、openblas、superlu、kiss_fft、zlib 等。构建时报缺依赖先确认这个目录完整。plugins/是最好的教材plugins/blur/ 是单通道模糊plugins/geom/ 是几何变换plugins/multiplugin/ 是多输入通道插件每个都有 CMakeLists.txt 和少量 .cpp。写自己的特效从这三个起步。不写代码也能搭把手项目对每个 Pull Request 自动在 Windows、Ubuntugcc/clang、macOS 上编译你可以在合并前下载编译产物帮忙测试流程见 doc/how_to_test_prs.md。下图是验证通过时的样子5 个平台检查全绿藏在配置里的玩法主题、笔刷包与工作台stuff/ 里的资源不是死文件下面几处最值得动。界面主题改一个变量换一套配色stuff/config/qss/ 下有 Default、Dark、Darker、Light、Blue、Clay 等现成主题软件按各自的.qss文件切换外观。更有意思的是上游主题用 LESS 编写、编译成 QSS整套配色由少量基础变量驱动——只改bg-color面板底色、边框等所有派生颜色会自动跟着变。LESS 编译器怎么装、新主题怎么建doc/how_to_stylesheet.md 有完整步骤。 先在软件设置里切换主题感受效果确定要做自己的再动文件。笔刷包与素材库数字笔体验的地基stuff/library/mypaint brushes/ 收录 aotz、classic、deevad、experimental 等 9 套 MyPaint 笔刷包都是.myb笔刷文件加 PNG 预览放进软件即可选用。同级的还有 41 个矢量笔刷vector brushes/.pli格式、131 张纹理图、26 个着色器文件.vert/.frag和粒子素材序列particles/日常绘画与特效基本够覆盖。工作布局与特效预设一键换工作台布局stuff/profiles/layouts/ 下 197 个布局文件.xml/.ini决定面板、工具栏和功能区的摆法。团队要统一工作台交的就是这份。特效预设stuff/fxs/presets/ 自带一组粒子特效预设STD_particlesFx/*.fx选中即可套用。拍板stuff/library/clapperboards/ 提供现成的拍板模板图与预设文件拍板素材用于标记镜头编号、拍摄轮次等镜头信息翻车现场速查构建出问题先查这六处CMake 提示找不到 SuperLU现象cmake ../sources阶段失败提示 SuperLU 未找到原因系统的 SuperLU 装在非标准路径CMake 没自动探测到解决显式指路再跑cmake ../sources/ -DSUPERLU_INCLUDE_DIR/usr/include/SuperLULinux 构建完程序起不来现象编译无报错运行时程序闪退或界面残缺原因stuff 资源目录没初始化解决执行cp -r opentoonz/stuff ~/.config/OpenToonz/后再启动构建指南明确标注此步骤必需Windows 编译报 jconfig.h 等头文件缺失现象大量编译错误找不到 jconfig.h、tif_config.h原因这些文件在仓库里以别名存放需要自行复制并重命名解决按 doc/how_to_build_win_chs.md 的配置外部头文件一节重命名 4 个文件jconfig.vc → jconfig.h、tif_config.vc.h → tif_config.h、tiffconf.vc.h → tiffconf.h、pnglibconf.h.prebuilt → pnglibconf.hWindows 克隆后 .lib/.dll 是空壳现象thirdparty 下库文件异常CMake 或链接失败原因大文件由 Git LFS 管理普通克隆只拿到指针解决克隆后执行git lfs pull拉取真实文件构建失败提示缺少依赖现象编译器报某个头文件或库不存在原因系统依赖没装全解决对照 doc/how_to_build_linux.md 补跑本发行版的安装命令并确认 thirdparty/ 目录完整再定位不到问题就用LANGC make VERBOSE1看完整编译输出能运行但 mov 等媒体格式不支持现象程序正常个别媒体格式无法导入导出原因缺srv文件夹依赖 QuickTime SDK 的 32 位服务组件解决从已安装的 OpenToonz 目录把srv文件夹复制到程序目录官方说明没有它也能用只是少一部分媒体格式支持 动手改 stuff/ 前先备份。config/下的 batches.xml、permissions.xml 等文件影响批处理任务与权限设置修改后需重启软件生效。收尾OpenToonz 的源码不黑箱模块划分清楚依赖自带连主题和布局都留给你改。最快的入门动作就一个——打开 doc/ 里对应你系统的构建指南照着命令跑一遍先让它跑起来再逐个模块看进去。【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonz创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考