OpenGL 샘플 빌드

업데이트： 2021/12/09

이 페이지에서는 Live2D Cubism SDK for Native와 함께 제공되는 OpenGL 샘플 프로젝트를 Windows 환경의 Visual Studio에서 컴파일하기까지의 절차를 설명합니다.

※기사의 내용은 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 내
「[루트] 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 또는 Project

NMake는 명령 프롬프트에서 빌드하고 실행 파일을 생성합니다. nmake_로 시작하는 배치 파일을 사용하십시오.
Visual Studio에서 코드 편집 등을 할 때는 proj_로 시작하는 배치 파일을 사용하십시오.

・Visual Studio 버전

도입하고 있는 Visual Studio 버전을 선택합니다.

이 예에서는 Visual Studio 2015 솔루션 파일이 포함된 프로젝트를 선택하기 위해 「proj_msvc2015.bat」를 실행합니다.

실행하면 아래 이미지와 같이 선택사항이 표시되므로 해당 번호를 반각 숫자로 입력해 주십시오.

・아키텍처 선택

x86(Win32) 또는 x64(Win64)를 선택합니다.
사용하는 환경에 따라 적절히 선택하십시오.

・Cubism Core의 모듈 선택

사용할 Cubism Core의 런타임 라이브러리를 선택합니다.
MD, MT 등 각각의 의미에 대해서는 Microsoft 공식 문서를 참조하십시오.

・프로젝트 내용 선택

생성할 프로젝트의 내용을 선택합니다.
Full Demo를 선택한 경우: Cubism SDK for Native의 모든 기능을 이용한 샘플 프로젝트가 생성됩니다.
Minimum Demo를 선택한 경우: 단일 모션을 반복하는 모델을 표시하는 최소 구성 프로젝트가 생성됩니다. 이 프로젝트는 다음 기능을 사용합니다.

• Cubism 모델 불러오기, 표시
• 하나의 모션을 반복 재생하는 기능
• 마우스 드래그에 의한 시선 추적
• 물리 연산
• 호흡
• 포즈

입력이 정상적으로 이루어지면 CMake에 의한 생성이 시작됩니다.
※생성 개시 후에 오류가 날 경우는 CMake의 버전, 지정하고 있는 Visual Studio의 버전을 확인해 주세요.

빌드

CMake에 의한 생성이 끝나면 생성한 파일 중에서 솔루션 파일을 엽니다.
이번 예에서는
・proj_msvc2015.bat

를 실행하고 옵션에서
・x64 (Win64)
・use the multithread-specific and DLL-specific version of the run-time library (MD)
・Full Demo

를 선택하여 출력된
「[루트]/Samples/OpenGL/Demo/proj.win.cmake/build/proj_msvc2015_x64_md」의 「Demo.sln」을 Visual Studio에서 열고 빌드를 실행합니다.

실행

빌드가 성공적으로 완료되면 디버깅으로 실행해 봅시다.

큰 화면과 명령 프롬프트에 의한 로그 출력이 나오면 성공입니다.
※최소의 샘플에서는 배경이나 모델 전환을 실행하는 톱니바퀴 아이콘 등의 UI는 표시되지 않습니다.

창 크기를 조정하려면 「/Sample/OpenGL/Demo/proj.win.cmake/src/LAppDelegate.cpp」의
LAppDelegate::Initialize()에서 사용되는 glfwCreateWindow()의 첫 번째 인수와 두 번째 인수의 값을 변경합니다.

_window = glfwCreateWindow(RenderTargetWidth, RenderTargetHeight, "SAMPLE", NULL, NULL);

※RenderTargetWidth, RenderTargetHeight는 「/Sample/OpenGL/Demo/proj.win.cmake/src/LAppDefine.cpp」에 실제 값이 정의되어 있습니다.

실행 파일이 출력되는 곳

이번 CMake에서 만든 프로젝트에서는 일반 프로젝트와 달리,
파일의 출력처는 프로젝트 폴더와 같은 계층이 됩니다.

구체적으로는 프로젝트 폴더가 「[루트]/Samples/OpenGL/Demo/proj.win.cmake/build/proj_msvc2015_x64_md」일 때,
실행 파일은 프로젝트 폴더와 같은 위치에 출력됩니다.

빌드 시 「[루트]/Samples/OpenGL/Demo/proj.win.cmake/build/proj_msvc2015_x64_md/Release」 등이 생성되지만, 여기에는 파일이 출력되지 않으므로 주의해 주십시오.