OpenToonz 日语版 README 深度解读：源自吉卜力工作室的二维动画制作软件 —— 项目概览、安装与构建指南

OpenToonz 日语版 README 深度解读：源自吉卜力工作室的二维动画制作软件 —— 项目概览、安装与构建指南

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

OpenToonz 是一款开源的二维（2D）动画制作软件，其前身是意大利 Digital Video 公司开发、并经株式会社吉卜力工作室（Studio Ghibli）多年生产实践定制打磨的Toonz。本文以仓库内的 日语版 README 为骨架，系统梳理该项目的官方来源、历史沿革、安装方式、构建方法、翻译流程与许可证体系，并辅以仓库源码（CMakeLists.txt、t32bitsrv 等）进行原理级验证。读完本文，你将掌握 OpenToonz 的项目全貌，能够在 Windows / macOS / Linux / BSD 上从源码构建它，并理解其 32 位 QuickTime 桥接服务与多语言翻译体系的底层实现。

官方来源唯一性：安全下载的第一准则

日语版 README 开篇即以「⚠️ 重要」强调了唯一合法的获取渠道：

请仅从官方配布来源下载：OpenToonz 的官方网站只有 opentoonz.github.io 与本 GitHub 仓库。为了安全，请不要从其他域名下载 OpenToonz，官方不存在其他镜像站点或合作下载站点。

这一点在 英文版 README 与 简体中文版 README 中均有完全一致的声明。对于这类被广泛流传的开源软件，用户从非官方渠道下载二进制包存在被植入恶意代码的风险，因此官方刻意强调「唯一官网 + 唯一仓库」的原则。如果你在搜索引擎或第三方站点看到其他声称提供 OpenToonz 下载的页面，应默认视为不可信来源。

这是什么？—— 吉卜力定制 Toonz 的开源化

日语版 README 对项目本质的描述非常精炼：

这是一款 2D 动画制作软件。其基础是意大利 Digital Video 公司开发、经过株式会社吉卜力工作室定制、并被长期用于吉卜力作品制作的软件Toonz。

结合英文版 README 可以补全完整谱系：OpenToonz 由 DWANGO 公开发布，其基础为Toonz Studio Ghibli Version（Toonz 吉卜力工作室版本），最初由意大利 Digital Video, Inc. 开发，并在多年的实际生产中由吉卜力工作室持续定制。也就是说，OpenToonz 并非从零写就的新软件，而是一套经过吉卜力长篇动画制作检验的生产级工具链的开源化产物。

从仓库结构可以直观印证这一点：toonz/sources目录下是一整套完整的、面向动画生产的模块化代码库，包括核心引擎 tnzcore、基础库 tnzbase、扩展库 tnzext、动画工程库 toonzlib、标准特效库 stdfx、颜色特效 colorfx、图像处理 image、主程序 toonz、Farm 渲染集群 toonzfarm、命令行工具 tcomposer 与 tconverter 等十余个相互依赖的子项目（见 CMakeLists.txt 的 add_subdirectory 列表）。此外，stuff/目录存放了笔刷、粒子、着色器、布局、预设等完整的运行时资源，thirdparty/则收纳了构建所需的第三方库。

运行环境与安装

系统要求

日语版 README 指出运行条件请参见官方网站 opentoonz.github.io。由于官方页面会随版本更新，具体的最低系统要求、显卡与驱动约束应以官网发布页为准。

安装方式

• 最新稳定版：从官网下载最新稳定版的安装程序并安装。
• 历史版本与不稳定夜间构建（nightly builds）：可从本 GitHub 仓库的 Releases 页面获取。

对日常使用而言，官方安装程序是首选路径；而 Releases 中的夜间构建则适合希望提前体验新功能、或需要回退到旧版本的开发者与测试者。

构建方法总览

日语版 README 为不同平台提供了对应的构建文档，全部位于仓库的 doc 目录下：

此外，README 还特别提到：即使不懂开发，也可以通过合并前 PR 测试流程参与协作 —— 在 PR 合并前帮助项目维护者验证改动，这是零门槛的贡献方式。

Windows 构建要点（源码级验证）

以日文版 Windows 构建文档 how_to_build_win_ja.md 为例，其核心链路是：Visual Studio 2019（2015 及以后）+ Qt 5.15 + CMake。整个流程可以归纳为五个阶段：

1. 工具链准备：安装 Visual Studio Community 2019（勾选「C++ 桌面开发」工作负载）与 CMake。
2. 获取源码：git clone本仓库。文档特别提醒：Visual Studio 无法正确识别无 BOM 的 UTF-8 源码，若文件使用 LF 换行且行尾注释包含日语，可能出现「换行被忽略、下一行也被当作注释」的解析问题，因此建议设置git config core.safecrlf true让 Git 负责换行转换。
3. 安装依赖库：大型库不随仓库分发，需要单独安装：
   • lib/dll文件由 Git LFS 管理，clone 后需执行git lfs pull；
   • Qt 5.15（64 位版）提供跨平台 GUI 框架；
   • OpenCV v4.1.0 及以上，通过 CMake 或环境变量将OpenCV_DIR指向其build目录；
   • Boost 1.73.0，解压后复制到$opentoonz/thirdparty/boost。
4. CMake 生成工程：源码目录填$opentoonz/toonz/sources，构建目录填$opentoonz/toonz/build，选择「Visual Studio 16 2019 Win64」，点击 Configure 与 Generate。若 Qt 安装路径非默认，会提示Specify QT_PATH properly，此时在 CMake 中指定QT_PATH为 Qt5 安装路径即可。这一步与顶层 CMakeLists.txt 的实现一致——在 MSVC 环境下，若QT_PATH未定义或不存在，CMake 会回落到C:/Qt/5.15.2/msvc2019_64作为默认值，找不到则直接FATAL_ERROR。
5. 构建与运行：打开生成的OpenToonz.sln以 Release 配置构建，产物输出到toonz/build/Release。

运行前的配置还包括：将stuff目录复制到合适位置、在注册表HKEY_LOCAL_MACHINE\SOFTWARE\OpenToonz\OpenToonz\TOONZROOT中写入 stuff 路径、用windeployqt.exe部署 Qt 运行库、复制glut64.dll、glew32.dll与 libmypaint、OpenCV、libjpeg-turbo 等 DLL。其中srv目录若缺失，软件仍可运行，但 mov 等格式将无法支持。

可选的 CMake 构建选项

顶层 CMakeLists.txt 定义了若干WITH_*开关，它们与构建文档中的说明相互印证：

• WITH_CANON（默认 OFF）：启用佳能数码相机（DSLR）支持，需要额外获取 Canon EOS Digital SDK（EDSDK），CMake 置 ON 后链接 EDSDK.lib，运行时需将 EDSDK 的 DLL 放到OpenToonz.exe同目录。
• WITH_TRANSLATION（默认 ON）：同时生成翻译项目。
• WITH_WINTAB（Windows 专属，默认 OFF）：配合 shun-iwasawa/qt5 发布的定制版 Qt 5.15.2 使用。背景是 Qt 5.12 起默认采用 Windows Ink API，与早期 WinTab API 的平板行为存在差异并引发了问题，该定制版将官方计划在 Qt 6.0 引入的 WinTab 切换功能移植回了 5.15.2。
• WITH_SYSTEM_LZO/WITH_SYSTEM_SUPERLU：在 MSVC/Apple 环境默认使用thirdparty内置库，在类 Unix 环境默认优先使用系统库。

理解srv目录：t32bitsrv 的 32/64 位桥接设计

Windows 构建文档专门用一节讲解了srv目录的由来：OpenToonz 通过 QuickTime SDK 支持 mov 等格式，而 QuickTime SDK 只有 32 位版本。因此项目将 QuickTime SDK 封装进t32bitsrv.exe这个 32 位可执行文件，64 位 OpenToonz 再通过进程间通信（IPC）经由t32bitsrv.exe间接调用 QuickTime 的能力。

源码层面可以清晰看到这套设计：t32bitsrv/main.cpp 在非 64 位平台上启动一个基于 QtQLocalServer的本地服务，注册了mov_io、_3gp_io的解析器（macOS 下还会注册font_io），分别监听srvName与srvName_main两个通道；t32movmsg.cpp 中mov_io::addParsers进一步注册了IsQTInstalledParser、DefaultMovPropsParser、OpenMovSettingsPopupParser等命令解析器。同时 t32bitsrv/CMakeLists.txt 显示该目标链接了Qt5::Core、Qt5::Network、tnzcore与image，并在 Windows 下引入QT73SDK/CIncludes。

构建srv需要：安装 Qt 5.x 32 位版、获取 QuickTime 7.3 SDK 并复制到thirdparty/quicktime/QT73SDK、用 CMake 生成 32 位工程（toonz/build32，目标选择「Visual Studio 16 2019 Win32」、QT_PATH指向 32 位 Qt）。之后将 32 位 Release 中的t32bitsrv.exe、image.dll、tnzbase.dll、tnzcore.dll、tnzext.dll、toonzlib.dll，配合windeployqt部署的 32 位 Qt 运行库及glut32.dll一并放入 64 位的srv目录。需要说明的是，t32bitsrv仅在 32 位平台目标下参与编译（见 CMakeLists.txt 的add_subdirectory(t32bitsrv)条件）。

翻译文件的生成

日语版 README 末尾补充了本地化流程：Qt 的翻译体系是「源码 →.ts→ 翻译 →.qm」三步。Visual Studio 解决方案中以translation_开头的项目用于生成.ts与.qm，且这些项目默认不随整体解决方案构建，需要单独执行「仅构建translation_???」。

CMake 层面对此有完整的自动化支持：当WITH_TRANSLATION为 ON 时，顶层 CMakeLists 会为日语、意大利语、法语、西班牙语、中文、德语、俄语、韩语、捷克语、葡萄牙语（巴西）等语言注册translate_update_*目标（调用lupdate更新.ts），并在各模块构建后通过lrelease将.ts编译为.qm输出到stuff/config/loc/<语言名>/目录（见 CMakeLists.txt 的翻译函数）。仓库的 translations 目录按语言分子目录存放.ts文件，update.sh 展示了手动更新流程：对colorfx、common、tnztools、toonz、toonzlib、toonzqt、image各模块分别执行lupdate。

许可证体系

日语版 README 对许可的说明简洁但边界清晰：

• thirdparty目录以外的文件：遵循修正 BSD 许可证，基于该许可证，无论是商用还是非商用，都可以自由使用软件或修改源代码。
• thirdparty目录内的文件：需遵循各子目录 README 或源代码中注明的各自许可证。

英文版 README 进一步补充：stuff/library/mypaint brushes目录内的资源需参见 stuff/library/mypaint brushes/Licenses.txt。仓库中 stuff/doc/LICENSE 下还整理了 libjpeg-turbo、OpenCV、Qt、Boost、tinyexr、libtiff、kissfft、SuperLU、OpenBLAS 等第三方组件的完整许可证文本，体现了项目对开源合规的严谨态度。

致谢与项目归属

README 末尾的 Special Thanks 注明：本开源程序源自 Digital Video, S.p.A.（意大利罗马）最初开发的软件 Toonz。这是对整个项目血脉的官方确认——从商业软件 Toonz，到吉卜力工作室定制版，再到 DWANGO 开源发布的 OpenToonz，数十年动画制作经验以开源形式沉淀在了本仓库之中。

总结

通过本文，我们完成了对 OpenToonz 日语版 README 的完整解读与源码级验证：明确了官方来源唯一性原则，梳理了 Toonz → 吉卜力定制版 → OpenToonz 的传承脉络，掌握了官网安装与 Releases 回退两种获取方式，理解了以 CMake + Qt 5.15 为核心的跨平台构建流程（尤其是 Windows 下QT_PATH、WITH_WINTAB、WITH_CANON等选项的语义），并深入剖析了t32bitsrv如何以本地 IPC 桥接 32 位 QuickTime 能力、以及lupdate/lrelease驱动的多语言翻译流水线。无论你是想安装使用、从源码构建，还是计划参与 PR 测试与本地化贡献，这份指南都已为你铺好了起点。

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