[VTK] CMake 빌드 및 Visual Studio 환경 구성

VTK 라이브러리

VTK 라이브러리를 사용하기 위해서는 사용자의 환경에 맞춰 직접 CMake로 빌드해야 합니다. 예를 들어, Visual Studio 버전이라든가, 32bit 또는 64bit에 맞는 환경으로 빌드해야 합니다.

이전에도 VTK CMake 빌드와 Visual Studio 프로젝트 환경 설정 방법에 대해 다룬 글이 있는데요. VTK와 Visual Studio 버전이 낮아 좀 더 상위 버전에 맞춰 포스팅을 새로 하게 됐습니다. 이전 글은 아래 링크를 참고하세요.

[VTK] VTK 8.2 및 Visual Studio 2015 환경 구성

[VTK] VTK 8.2 및 Visual Studio 2015 환경 구성

[VTK] Visual Studio 2015 MFC에서 VTK 사용 준비하기

[VTK] Visual Studio 2015 MFC에서 VTK 사용 준비하기

VTK 준비하기

1. CMake 설치하기

VTK를 빌드하기 위해 CMake 프로그램을 설치해야 합니다. 거의 대부분의 오픈 소스는 이 CMake 프로그램을 사용하여 라이브러리를 빌드할 수 있습니다.

[CMake] CMake 설치하기

[CMake] CMake 설치하기

2. VTK 라이브러리 소스 다운로드하기

VTK 홈페이지에 접속하여 최신 버전을 다운로드합니다.

VTK 소스 다운받기

3. Visual Studio 설치하기

사용하려는 버전의 Visual Studio를 준비합니다. 본문에서는 Visual Studio 2019를 설치했습니다.

VTK 라이브러리 CMake 빌드하기

CMake 프로그램을 관리자 권한으로 실행합니다. 그리고 Source code와 build 경로를 지정합니다.

Source와 Build 경로 지정하기

항목	설명
Where is the source code	VTK-X.Y.Z.tar.gz 압축 해제된 폴더의 경로
Where to build the binaries	Binary 파일이 생성될 비어있는 경로

좌측 하단의 Configure 버튼을 클릭합니다. 그리고 아래의 창이 표시되면 사용하려는 Visual Studio의 버전과 Platform(bit 수)을 선택합니다.

CMake 빌드 환경 선택하기

Finish 버튼을 클릭하면 아래와 같이 무언가 진행이 됩니다. PC 사양마다 다르지만, 약 3분 정도 소요됩니다.

Configure 이후

이후 아래와 같은 화면이 표시됩니다. VTK 예전 버전에서는 옵션 선택이 상당히 많았는데요. 9.2.2 기준으로는 옵션이 상당히 줄어들었습니다. 특별한 이유가 없다면 기본값 그대로 진행해도 문제는 없습니다.

저의 경우에는 빌드된 VTK 라이브러리의 Debug/Release 경로를 구분하기 위해 아래와 같이 변경했습니다.

C:/Program Files/VTK/${BUILD_TYPE}

CMake 옵션 선택 화면

옵션 선택이 끝났다면 Generate 버튼을 클릭합니다. 이 작업은 금방 끝나며, Open Project 버튼이 활성화가 됩니다. 이 버튼을 클릭하거나, Visual Studio를 관리자 권한으로 실행한 후 Binary 경로에 있는 VTK.sln 파일을 엽니다.

VTK.sln 열고 빌드하기

Visual Studio에서 VTK.sln 파일이 열리면 INSTALL 프로젝트를 빌드합니다. 이 작업은 다소 시간이 걸립니다. 제 경우 약 15분이 걸렸습니다. Debug 모드의 빌드가 끝나면 Release 모드로 변경하여 마저 빌드합니다.

빌드가 완료되면 CMake에서 지정한 경로에 다음과 같이 Debug/Release 각 폴더에 VTK 라이브러리 파일이 생성되어 있습니다.

라이브러리 파일이 생성된 모습

Visual Studio에서 VTK 라이브러리 환경 설정하기

Visual Studio를 실행하고 C++ 콘솔 앱 프로젝트를 생성합니다. 프로젝트 속성 > 디버깅 > 환경에 dll이 위치한 bin 폴더의 경로를 입력합니다.

C:\Program Files\VTK\Debug\bin

프로젝트 속성의 환경

프로젝트 속성 > C/C++ > 일반 > 추가 포함 디렉터리에 VTK 라이브러리의 include 경로를 입력합니다.

프로젝트의 include 경로

프로젝트 속성 > 링커 > 일반 > 추가 라이브러리 디렉터리에 VTK 라이브러리의 lib 경로를 입력합니다.

프로젝트의 lib 경로

마지막으로 프로젝트 속성 > 링커 > 일반 > 입력 > 추가 종속성에 VTK 라이브러리의 lib 파일 목록을 입력합니다.

프로젝트의 lib 파일 목록

lib 파일 목록을 쉽게 얻는 방법은 아래 링크를 참고하세요.

[MFC] lib, dll 폴더의 파일 목록 쉽게 얻는 방법

[MFC] lib, dll 폴더의 파일 목록 쉽게 얻는 방법

VTK Hello World 실행하기

이제 Visual Studio에 VTK 라이브러리 환경 설정이 모두 끝났습니다. VTK 공식 예제 코드인 Hello World를 실행해 보겠습니다. 전체 코드는 아래와 같습니다.

#pragma once
#include <vtkAutoInit.h>

#define vtkRenderingCore_AUTOINIT 3(vtkRenderingOpenGL2,vtkInteractionStyle, vtkRenderingFreeType)
#define vtkRenderingContext2D_AUTOINIT 1(vtkRenderingContextOpenGL2)

#include <vtkActor.h>
#include <vtkCamera.h>
#include <vtkCylinderSource.h>
#include <vtkNamedColors.h>
#include <vtkNew.h>
#include <vtkPolyDataMapper.h>
#include <vtkProperty.h>
#include <vtkRenderWindow.h>
#include <vtkRenderWindowInteractor.h>
#include <vtkRenderer.h>

#include <array>

int main(int, char* [])
{
    vtkNew<vtkNamedColors> colors;

    // Set the background color.
    std::array<unsigned char, 4> bkg{ {26, 51, 102, 255} };
    colors->SetColor("BkgColor", bkg.data());

    // This creates a polygonal cylinder model with eight circumferential facets
    // (i.e, in practice an octagonal prism).
    vtkNew<vtkCylinderSource> cylinder;
    cylinder->SetResolution(8);

    // The mapper is responsible for pushing the geometry into the graphics
    // library. It may also do color mapping, if scalars or other attributes are
    // defined.
    vtkNew<vtkPolyDataMapper> cylinderMapper;
    cylinderMapper->SetInputConnection(cylinder->GetOutputPort());

    // The actor is a grouping mechanism: besides the geometry (mapper), it
    // also has a property, transformation matrix, and/or texture map.
    // Here we set its color and rotate it around the X and Y axes.
    vtkNew<vtkActor> cylinderActor;
    cylinderActor->SetMapper(cylinderMapper);
    cylinderActor->GetProperty()->SetColor(
        colors->GetColor4d("Tomato").GetData());
    cylinderActor->RotateX(30.0);
    cylinderActor->RotateY(-45.0);

    // The renderer generates the image
    // which is then displayed on the render window.
    // It can be thought of as a scene to which the actor is added
    vtkNew<vtkRenderer> renderer;
    renderer->AddActor(cylinderActor);
    renderer->SetBackground(colors->GetColor3d("BkgColor").GetData());
    // Zoom in a little by accessing the camera and invoking its "Zoom" method.
    renderer->ResetCamera();
    renderer->GetActiveCamera()->Zoom(1.5);

    // The render window is the actual GUI window
    // that appears on the computer screen
    vtkNew<vtkRenderWindow> renderWindow;
    renderWindow->SetSize(300, 300);
    renderWindow->AddRenderer(renderer);
    renderWindow->SetWindowName("Cylinder");

    // The render window interactor captures mouse events
    // and will perform appropriate camera or actor manipulation
    // depending on the nature of the events.
    vtkNew<vtkRenderWindowInteractor> renderWindowInteractor;
    renderWindowInteractor->SetRenderWindow(renderWindow);

    // This starts the event loop and as a side effect causes an initial render.
    renderWindow->Render();
    renderWindowInteractor->Start();

    return EXIT_SUCCESS;
}

실행 결과는 다음과 같습니다.

Hello World 예제 실행 결과

어때요, 잘 따라 하셨나요? 여기까지 문제없이 따라 하셨다면, 이제 VTK 예제 코드를 실행하는데 문제가 없을 것입니다.