构建 OpenGL 示例

[最近更新时间:2021/12/09]

本页介绍了在 Windows 环境中在 Visual Studio 中编译 Live2D Cubism SDK for Native 中包含的 OpenGL 示例项目的过程。

* 文章内容使用Cubism 4 SDK for Native R1。
方法和步骤可能因 Cubism SDK 的版本而异。 

 

必要的东西

Live2D Cubism SDK for Native

SDK 本身。从“官方下载页”下载。

Visual Studio

这是本次使用的开发环境。该语言使用 C++。
另外,请使用 Visual Studio 2013或更高版本。

CMake

用于生成项目文件。

GLFW

它是OpenGL的一个辅助库,具有输入和窗口管理功能。
您可以从 Cubism SDK 示例中包含的批处理文件中下载它。

GLEW

OpenGL 扩展库使调用 OpenGL 扩展变得容易。
您可以从 Cubism SDK 示例中包含的批处理文件中下载它。

 

本文中 GLFW 和 GLEW 是从 Cubism SDK 示例中包含的批处理文件中下载的,因此无需提前下载。

此外,对于 CMake、GLFW 和 GLEW 等工具和库,请参阅示例 SDK Zip。
检查“[Root] Samples / OpenGL”中“README.md”中描述的过程和版本。

 

 

安装工作

Visual Studio

安装集成开发环境。
设定它以便可以编译 C++。

 

CMake

安装 CMake。
由于 CMake 工作是从批处理文件中使用的,因此请设定 CMake 路径设定,以便用户可以参考它。

* 图片可能与实际屏幕不同。 

 

GLFW 和 GLEW 的部署

对于 GLFW 和 GLEW 的部署,请查看“Samples / OpenGL”中的“README.md”中描述的过程。
在 Windows 上,执行“Samples/OpenGL/thirdParty”中的“setup.bat”下载 GLFW 和 GLEW。

批量提取完成后,文件夹结构如下。

* 如果您手动下载了 GLFW 和 GLEW,则需要将它们解压到“Samples/OpenGL/thirdParty”文件夹中。

 

运行 CMake

CMake 也可以从 GUI 中使用,但这次我们将使用示例中包含的批处理文件。
在 Windows 上,“Samples / OpenGL / Demo / proj.win.cmake / scripts”中有一个批处理文件。
从多个设定的组合中选择适用于 Windows 的批处理文件。

・NMake 还是项目?

NMake 从命令提示符构建并生成可执行文件。使用以 nmake_ 开头的批处理文件
如果要从 Visual Studio 编辑代码,请使用以 proj_ 开头的批处理文件。

・Visual Studio 版本

选择已安装的 Visual Studio 版本。

 

在本例中,执行“proj_msvc2015.bat”选择包含Visual Stadio 2015解决方案文件的项目。

执行时会显示如下图所示的选项,请输入对应的半角数字。

・架构选择

选择 x86 (Win32) 或 x64 (Win64)。
请根据您的环境酌情选择。

・Cubism Core 模块选择

选择要使用的 Cubism Core 运行时库。
MD、MT等的含义请查看微软官方文档

・项目内容的选择

选择要生成的项目的内容。
如果您选择完整演示:将生成一个使用 Cubism SDK for Native 的所有功能的示例项目。
如果您选择最小演示:生成一个最小项目,显示重复单个动作的模型。该项目中使用了以下功能:

  • 加载和显示Cubism模型
  • 能够循环播放一个动作
  • 拖动鼠标跟随视线
  • 物理模拟
  • 呼吸
  • 暂停

如果输入成功,CMake 将开始生成。
* 如果开始生成后出现错误,请检查 CMake 的版本和指定的 Visual Studio 版本。

 

建造

CMake 生成完成后,从生成的文件中打开解决方案文件。
在这个例子中
・Proj_msvc2015.bat

而在选择
・X64 (Win64)
・使用运行时库 (MD) 的多线程特定和 DLL 特定版本
・完整演示

被选中并输出
在 Visual Studio 中打开“[Root]/Samples/OpenGL/Demo/proj.win.cmake/build/proj_msvc2015_x64_md”中的“Demo.sln”并运行构建。

 

执行

如果构建成功,让我们在调试中运行它。

如果能在大屏和命令提示符下看到记录输出,就成功了!
* 在最小示例中,不显示背景和切换模型的齿轮图标等 UI。

 

要调整窗口大小,请转到“/Sample/OpenGL/Demo/proj.win.cmake/src/LAppDelegate.cpp”
改变LAppDelegate::Initialize()中使用的glfwCreateWindow()的第一个和第二个参数的值。

 

* RenderTargetWidth和RenderTargetHeight的实际值在“/Sample/OpenGL/Demo/proj.win.cmake/src/LAppDefine.cpp”中定义。

 

可执行文件的输出目的地

这次从CMake创建的项目与普通项目不同,
文件的输出目标将与项目文件夹在同一层次结构中。

具体来说,当项目文件夹为“[root] /Samples/OpenGL/Demo/proj.win.cmake/build/proj_msvc2015_x64_md”时
可执行文件输出到与项目文件夹相同的位置。

[Root] /Samples/OpenGL/Demo/proj.win.cmake/build/proj_msvc2015_x64_md/Release"是在构建时生成的,但是请注意这里没有输出文件。

© 2010 - 2022 Live2D Inc.