OpenToonz项目Windows平台编译指南

OpenToonz项目Windows平台编译指南

opentoonz OpenToonz - An open-source full-featured 2D animation creation software 项目地址: https://gitcode.com/gh_mirrors/op/opentoonz

前言

OpenToonz是一款功能强大的2D动画制作软件，作为开源项目，开发者可以自行编译定制版本。本文将详细介绍在Windows平台上编译OpenToonz的完整流程，帮助开发者快速搭建编译环境并成功构建项目。

环境准备

开发工具

1. Visual Studio 2019
   推荐使用Community版本，安装时需要确保勾选"MSVC v142 - VS 2019 C++ x64/x86生成工具"组件。虽然项目最初是为VS2019设计，但工程文件也兼容VS2022。

2. CMake
   用于生成Visual Studio项目文件，建议安装最新稳定版本。

3. Qt框架
   OpenToonz需要Qt 5.x版本支持，推荐使用5.15.2版本。对于数位板用户，建议使用定制版Qt以支持WinTab API。

第三方库

1. Boost库
   需要1.55.0及以上版本，测试验证最高支持1.73.0版本。下载后需解压到项目指定目录。

2. OpenCV
   需要4.1.0及以上版本，安装后需设置环境变量指向其build目录。

源码获取与配置

源码克隆

使用版本控制工具获取项目源码，注意以下几点：

1. 大文件(LFS)管理：项目中的库文件使用Git LFS管理，克隆后需执行git lfs pull获取完整文件。

2. 编码问题处理：为防止Visual Studio处理UTF-8编码文件时出现问题，建议配置Git使用安全换行符转换：

   git config core.safecrlf true
   

CMake配置

1. 设置源码路径为toonz/sources目录
2. 设置构建路径为toonz/build目录
3. 配置时需指定Qt安装路径，特别是使用非默认安装位置时
4. 可忽略CMake配置过程中的红色警告信息

构建准备

头文件配置

需要重命名几个关键头文件：

1. LibJPEG相关：jconfig.vc → jconfig.h
2. TIFF相关：tif_config.vc.h → tif_config.h等
3. PNG相关：pnglibconf.h.prebuilt → pnglibconf.h

注意这些文件分布在不同的第三方库目录中。

项目构建

1. 打开生成的OpenToonz.sln解决方案文件
2. 选择Debug或Release配置
3. 执行构建，输出结果位于构建目录的对应配置文件夹中

可选功能配置

Canon DSLR相机支持

1. 需要申请Canon开发者计划获取SDK
2. 将SDK中的头文件和库文件放置到指定目录
3. 在CMake中启用WITH_CANON选项
4. 运行时需将Canon SDK的DLL文件复制到程序目录

程序运行配置

依赖部署

1. 使用Qt的windeployqt工具自动部署所需Qt库文件
2. 手动复制必要的第三方DLL文件：
   • GLUT的glut64.dll
   • GLEW的glew32.dll
   • MyPaint相关DLL
   • libjpeg-turbo的turbojpeg.dll
   • OpenCV的opencv_world***.dll

环境配置

1. Stuff文件夹：包含程序运行所需的资源文件
2. 注册表设置：需要创建指定键值指向Stuff文件夹路径
3. SRV文件夹：提供MOV等格式支持，需特殊配置

调试配置

在解决方案中将OpenToonz项目设为启动项目即可进行调试。

高级配置：MOV支持

OpenToonz使用QuickTime SDK提供MOV格式支持，由于SDK仅提供32位版本，需要特殊处理：

1. 安装32位Qt版本
2. 获取QuickTime SDK并放置到指定目录
3. 构建32位版本的t32bitsrv及相关组件
4. 部署32位Qt运行库

翻译文件生成

Qt翻译文件(.qm)需要通过.ts文件生成，在Visual Studio中需要单独构建translation相关项目。

结语

通过以上步骤，开发者可以在Windows平台上成功构建OpenToonz项目。整个过程涉及多个工具链和第三方库的配置，建议按照顺序逐步操作。对于特定功能如数位板支持或视频格式支持，可根据需要选择相应的配置选项。

opentoonz OpenToonz - An open-source full-featured 2D animation creation software 项目地址: https://gitcode.com/gh_mirrors/op/opentoonz