基于Qt的Live2D模型显示以及控制

基本说明

Live2D官方提供有控制Live2D模型的SDK,而且还提供了一个基于OpenGL的C++项目Example,我们可以基于该项目改成Qt的项目，做一个桌面端的Live2D桌宠程序。

官方例子

经过改造效果如下图所示。

在这里插入图片描述

官方项目配置

下载官方提供的SDK例程,，选择Cubism SDK for Native。

官方网站

在这里插入图片描述

下载解压后应该是下面的样子。
- 其中Core文件夹放的是核心库Live2DCubismCore的动态链接库，提供有各个平台，我们只需要用windows的链接库就可以了。
- Framework提供基本的框架用于模型的读取和配置，我们可以使用源码也可以用它编译成的链接库。
- Samples文件夹存放就是Example,里面有对应的脚本，可以生成VS项目。
生成VS项目
- 进入Samples/OpenGL/Demo/proj.win.cmake/scripts目录下，根据你们安装的vs版本，选择对应的脚本进行项目生成。
- 在生成项目之前还需要配置一下第三方模块，不然无法生成。因为用到Opengl.所以需要glew和glfw模块。虽然官方有提供脚本一键配置，不过文件下载不了，我们需要手动下载配置。去github下载glfw和glew源码。
  - glew · GitHub
  - glfw · GitHub
  然后来到Samples/OpenGL/thirdParty目录下，解压刚才下载的两个文件，得到两个文件夹，文件夹名字记得修改为glew和glfw。配置完成如下所示。
- 配置完第三方模块后，使用项目脚本生成vs项目，打开脚本后，有一些选项可以配置，根据提示和自己需求配置即可。
- 如果之前的步骤没有错会在Samples/OpenGL/Demo/proj.win.cmake/目录生成build文件夹.我们打开里面的Demo.sln文件，即可在vs中运行项目。
  
  点击运行项目，即可运行官方示例。
  
  在vs中我们看到除了Demo项目，还有glew，glfw,framework项目，它们是用来生成链接库的，我们把他们设为启动项目然后生成一遍，得到对应链接库，之后我们要用的。glew会生成glew32.lib，libglew32.lib。glfw会生成glfw3.lib。framework会生成Framework.lib。
- 至此我们就完成了第一步，跑起来官方的例程，之后想怎么改就怎么改。

准备移植Qt的文件

需要的链接库
- 我们以Release,x64为环境，之前的链接库也按照这个模式生成。
- 首先需要我们自己生成的链接库glew32.lib，libglew32.lib，glfw3.lib，Framework.lib。还有官方提供的Core链接库Live2DCubismCore_MD.lib/Live2DCubismCore_MT.lib。根据我们之前配置项目时的设置，选择MD或者MT即可。链接库在下载的SDK目录Core/lib/windows下，我们根据自己使用的vs版本选择对应的库，v143是Vs2022，v142是Vs2019，v141是Vs2017。
- 最后还需要主动链接一些系统库，这些需要的库我们可以在VS中查看Demo项目在属性页中的链接器看到。
  
  pragma comment(lib, "kernel32.lib")
  
  pragma comment(lib, "user32.lib")
  
  pragma comment(lib, "gdi32.lib")
  
  pragma comment(lib, "OpenGL32.lib")
  
  pragma comment(lib, "glu32.lib")
需要的源代码
- 我们需要在官方给出的控制代码中一些修改一些文件，改成适合Qt程序的。所需源码如下所示。
- 还有上面的链接库glfw,glew,Framework,Live2DCubismCore_MD.lib/Live2DCubismCore_MT.lib对应的头文件(*.h/*.hpp)，以及stb_image.h文件。这些文件都可以在下载的SDK中找到。

移植Qt

Qt中有封装的OpenGL类（QOpenGLWidget）,我们要做的就是把模型渲染在我们自己的OpenGL窗口上。

准备以上文件后我们用Qt Creator新建一个带界面UI文件的Qt程序，编译器使用MSVC对应的版本，名字叫Live2DDemo，然后把以上链接库，源文件，头文件添加到项目中。
添加完成后Qt工程如下所示

我们需要在mainwindow.h中手动链接一下这些库。

pragma comment(lib, "kernel32.lib")

pragma comment(lib, "user32.lib")

pragma comment(lib, "gdi32.lib")

pragma comment(lib, "OpenGL32.lib")

pragma comment(lib, "glu32.lib")

pro文件配置中加一个预定义宏,表示在WINDOWS平台

DEFINES += CSM_TARGET_WIN_GL

Framework的头文件直接把SDK中的Framework/src/目录下的所有文件直接复制过来就行，不用删除其中的cpp文件。GL和GLFW的文件夹名字不能改，因为它们源码就是以“GL/*.h"的方式包含的。如果更改了，需要去源码那里改一下头文件的包含。

项目的工程目录,inc目录存放头文件，libs存放链接库，live2d存放需要修改的代码。

配置根据各自的情况配置就行，其实就是配置一些头文件和链接库。
如果上面的配置都没有错，编译应该是可以通过的。如果有报错，根据报错提示修改即可。报错一般就是以下情况。
- 头文件找不到。在工程文件Pro中加上缺少的即可，注意一下目录层级。
- 链接库找不到。看看是不是x64，release，MSVC的编译环境，链接库是不是x64，release环境下生成的，链接库路径有没有写对。

修改源码

上面的配置都没有问题后，我们就可以开始修改，把Live2D模型渲染到Qt的QOpenGLWidget窗口上。

新建一个类MyOpenGL然后继承QOpenGLWidget,然后重写下面几个protected函数。

void initializeGL()

void resizeGL(int w, int h)

void paintGL()

下面几个头文件要放在cpp文件包含。

在这里插入图片描述

然后在mainwindow.ui界面拖拽一个QOpenGLWiget控件，提升为我们自定义的类MyOpenGL。如果一切都没有错，运行后就是下面的样子。

在这里插入图片描述

修改LAppDelegate类。
- 在LAppDelegate.hpp中包含myopengl.h头文件，然后在public下新增两个函数声明。
- 注释原来的GLFWwindow*_window，改成MyOpenGL*_window。然后修改GetWindow函数。
- Initialize()函数修改如下
- LAppDelegate.cpp
  - 在Initialize函数中做如下修改。
- Release函数修改如下
- void LAppDelegate::Run() 函数的所有内容注释掉，我们要把功能拆分到新增的resize()和update()函数中。两个函数如下
修改width和height的获取方式

原来的代码中获取渲染窗口的宽和高是通过glfwGetWindowSize() 函数，但我们修改为了自己的OpenGL窗口，因此所有用到这个函数的地方都要修改。我们可以先编译一下看看哪里报错，然后跳到对应地方修改就可以了。需要修改的地方比较多就不一一截出来了，修改都是类似的。
修改我们自己的MyOPenGL类
添加Resource
- 下载的SDK中有官方提供的一些live2D模型，我们把整个Resources文件夹放到exe程序的上一级目录。因为在Qt Creator中运行程序，运行目录默认是exe程序的上一级目录。
- 如果上面的步骤都没有错，运行出来的效果如下。如果程序闪退就是Resources文件夹放的位置不对，导致找不到文件而闪退。
加上鼠标事件和定时更新功能

鼠标事件用于和模型进行互动，可以触发一些特定动作

到这里就基本和官方的效果差不多了，至于更多自定义修改，比如去掉背景和一些部件，模型的自定义显示，模型的切换等等，把那些控制代码看看，根据的需求修改即可。下载QtLive2dDesktop-master基于Qt的Live2d桌面模型程序，showlive2dByQt资源-CSDN文库