企业官网建设流程全解析

OpenToonz 开源 2D 动画软件完整指南：从源码构建到主题定制

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

OpenToonz 是一款开源的 2D 动画创作软件，由 DWANGO 发布，源自吉卜力工作室长期使用的 Toonz Studio，支持逐帧绘制、上色、特效合成与定格动画拍摄。如果你既想用它做动画，又打算修改或扩展它本身，本文会带你完成 OpenToonz 的源码构建、基础配置，并给出主题与插件的扩展入口。

项目概览：OpenToonz 是什么、适合谁

它面向独立动画创作者和小型工作室，也适合想把 2D 动画流程纳入自己工作流的开发者。核心能力集中在三点：

• 逐帧绘制与上色：内置矢量画笔预设（stuff/library/vector brushes/）和 MyPaint 笔刷包（stuff/library/mypaint brushes/），覆盖手绘风格需求。
• 特效与粒子合成：toonz/sources/stdfx/下实现了几十个图像特效，粒子特效预设位于stuff/fxs/presets/STD_particlesFx/，开箱即可套用。
• 定格动画支持：提供相机校准板（stuff/library/camera calibration/）和场记板素材（stuff/library/clapperboards/），配合toonz/sources/stopmotion/的拍摄模块工作。

安装与运行：Linux 下三步从源码跑起来

官方安装包覆盖 Windows、macOS、Linux，但如果你想二次开发，就需要从源码构建。下面以 Linux 为例，最短路径三步完成；Windows 用户请改看 Windows 构建文档，macOS 与 BSD 也有对应文档在doc/目录下。

第一步：安装编译依赖

前置条件是 Git、GCC 或 Clang、CMake 3.10+、Qt 5.15+、Boost 1.55+、libmypaint、OpenCV 3.2+ 等库。不同发行版用各自包管理器安装即可：

装完后终端能正常执行qmake --version和cmake --version，且都不报命令不存在，即达标。

第二步：克隆并编译

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

克隆后把资源目录复制到用户配置路径，再编译 libtiff 与主程序（toonz/目录下执行）：

cmake ../sources && make -j$(nproc)

编译较耗时，耐心等待。完成后build目录下生成bin/OpenToonz可执行文件和lib/opentoonz动态库，看到这两个产物即构建成功。

第三步：初始化配置并启动

mkdir -p $HOME/.config/OpenToonz cp -r opentoonz/stuff $HOME/.config/OpenToonz/

然后执行LD_LIBRARY_PATH=./lib/opentoonz ./bin/OpenToonz（在build目录下）。主窗口弹出、界面显示默认主题，说明首次跑通。

核心功能速览：三个最常用的模块怎么用

时间轴与逐帧绘制

打开软件后主界面右侧是 Xsheet（动画表），每列对应一层、每行对应一帧。用画笔工具在 Viewer（取景器）中绘制，切帧后重绘即可推进动画；矢量画笔预设可直接从资源面板拖入使用，stuff/library/custom styles/里还有大量造型笔刷。

特效与调色

在 Schematic（示意图）面板中添加 FX（特效）节点，即可对图层做模糊、混合、透视扭曲等处理，实现在toonz/sources/stdfx/。粒子特效不需要手写参数，从stuff/fxs/presets/STD_particlesFx/的预设导入，在节点属性里改密度和速度即可。

定格动画拍摄

用相机校准板拍一张画面，导入后由相机校准功能解算透视，后续翻拍稿就能自动对位。镜头信息用场记板模板记录，素材见下：

定制与扩展：主题、布局与插件入口

更换界面主题

成品主题位于stuff/config/qss/，现有 Default、Dark、Darker、Blue、Clay、Light、Neutral、Default-Green 共 8 套，在偏好设置中选择对应 QSS 即可生效。想自己配色，主题源文件是用 LESS 写的，编译规则详见 主题开发文档——修改stuff/config/qss/Default/less/themes/下的颜色变量后重新编译，对应.qss会更新。

保存工作区布局

面板的摆放可以存为布局文件，放在stuff/profiles/layouts/，仓库里已有 170 多个现成布局可按需导入，适合分镜、绘制、合成等不同角色各用一套。

开发自己的插件

插件骨架在plugins/目录：plugins/blur/是模糊效果的完整示例，plugins/geom/演示几何变换，plugins/multiplugin/展示一个模块暴露多个效果的写法，公共工具头文件在plugins/utils/。照 blur 的结构写、在 CMake 中挂上目标，就能得到自己的图像特效插件。

常见坑与排错：构建阶段 5 个高频报错

CMake 提示找不到 SuperLU→ 某些发行版头文件不在默认搜索路径 → 重新配置时加参数cmake ../sources/ -DSUPERLU_INCLUDE_DIR=/usr/include/SuperLU。

Windows 克隆后缺少 lib、dll 文件→ 这些大文件走 Git LFS，普通 clone 只留下指针 → 在仓库目录执行git lfs pull补全二进制文件。

CMake 报 "Specify QT_PATH properly"→ Qt 装在非默认目录，CMake 找不到 → 配置时把QT_DIR指到 Qt 安装路径下msvc2019_64文件夹，再重新 Configure。

libmypaint 装不上→ 较老发行版源里没有该包 → 按 Linux 构建文档 从源码编译 v1.3.0，装完执行ldconfig刷新缓存。

程序能启动但界面缺图标、缺笔刷→ 忘记复制stuff目录 → 把它完整拷到~/.config/OpenToonz/（Linux）或C:\OpenToonz stuff（Windows），重启程序。

收尾：文档、社区与贡献入口

OpenToonz 用一套toonz/sources核心加stuff/资源的结构把动画全流程装进一个开源仓库，改任何部分前，建议先跑通上面的构建流程。进一步材料都在这里：新功能开发规范见 开发清单；不会开发但想参与，可以先测试社区的 Pull Request（合并前构建）并反馈结果，步骤和截图见 PR 测试指南；界面翻译在toonz/sources/translations/目录，多语言文本直接可改。

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