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

OpenToonz 日语版 README 深度解读源自吉卜力工作室的二维动画制作软件 —— 项目概览、安装与构建指南【免费下载链接】opentoonzOpenToonz - An open-source full-featured 2D animation creation software项目地址: https://gitcode.com/GitHub_Trending/op/opentoonzOpenToonz 是一款开源的二维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 VersionToonz 吉卜力工作室版本最初由意大利 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 目录下目标平台文档仓库根目录相对路径语言Windowshow_to_build_win_ja.md日语macOShow_to_build_macosx_ja.md日语Linuxhow_to_build_linux.md英语BSDhow_to_build_bsd.md英语样式表stylesheethow_to_stylesheet.md英语此外README 还特别提到即使不懂开发也可以通过合并前 PR 测试流程参与协作 —— 在 PR 合并前帮助项目维护者验证改动这是零门槛的贡献方式。Windows 构建要点源码级验证以日文版 Windows 构建文档 how_to_build_win_ja.md 为例其核心链路是Visual Studio 20192015 及以后 Qt 5.15 CMake。整个流程可以归纳为五个阶段工具链准备安装 Visual Studio Community 2019勾选「C 桌面开发」工作负载与 CMake。获取源码git clone本仓库。文档特别提醒Visual Studio 无法正确识别无 BOM 的 UTF-8 源码若文件使用 LF 换行且行尾注释包含日语可能出现「换行被忽略、下一行也被当作注释」的解析问题因此建议设置git config core.safecrlf true让 Git 负责换行转换。安装依赖库大型库不随仓库分发需要单独安装lib/dll文件由 Git LFS 管理clone 后需执行git lfs pullQt 5.1564 位版提供跨平台 GUI 框架OpenCV v4.1.0 及以上通过 CMake 或环境变量将OpenCV_DIR指向其build目录Boost 1.73.0解压后复制到$opentoonz/thirdparty/boost。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。构建与运行打开生成的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 SDKEDSDKCMake 置 ON 后链接 EDSDK.lib运行时需将 EDSDK 的 DLL 放到OpenToonz.exe同目录。WITH_TRANSLATION默认 ON同时生成翻译项目。WITH_WINTABWindows 专属默认 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考