SetupForWindows_EN - CCSEPBVR/CS-IS-PBVR GitHub Wiki

Setting up for Windows environment

Installing Visual Studio

When building CS/IS-PBVR in Windows environment, Visual Studio 2022 is used. If you do not have it installed, download it from Microsoft's Website and launch the Visual Studio Installer. Next, select Install Visual Studio 2022 and check the following components:

  • Select "Desktop development with C++" from "Workload".
  • Select the following from the "Individual Components" section:
    • Windows 11 SDK
    • C++ ATL for latest v143 build tools (x86 and x64)
    • C++ CMake Tools for Windows

Local Image Local Image Local Image

After selecting the components, click the "Install" button at the bottom right to start the installation. When the installation is complete, confirm that "x64 Native Tools Prompt for VS 2022" can be launched.

Install FBXSDK (optional)

If you want to visualize .fbx format files in a client program, you need to install FBXSDK library. The steps are shown below.

  • Select Download SDK for Windows from the Website and download fbx2XXXXX_fbxsdk_vs2022_win.exe.
  • Run the fbx2XXXXX_fbxsdk_vs2022_win.exe and follow the installer to complete the installation.

Install Assim (optional)

If you want to visualize .3ds format files in a client program, you need to install the Assimp library. The steps are shown below.

  • Download and extract the source code from the Website.

  • Move to assimp-5.0.0¥ in the "x64 Native Tools Command Prompt for VS 2022" and execute the following command.

    cmake -G "Visual Studio 17 2022"
    MSBuild Assimp.sln /t:clean; rebuild /p:Configuration=Release; Platoform="x64"
    MSBuild Assimp.sln /t:clean; rebuild /p:Configuration=Debug; Platoform="x64"
    
  • After the build is completed, confirm that (assimp-vc143-mt.lib/assimp-vc143-mtd.lib) is generated in assimp-5.0.0\lib(Release/Debug) and set the following environment variables.

    variable value
    Path < BASE_DIR>¥assimp-5.0.0¥bin¥Release
    Path < BASE_DIR>\assimp-5.0.0\bin\Debug

Using OpenXR (Optional)

If you want to display a visualization screen on an HMD from the client program using OpenXR, you need to install the SteamVR, ImGui library and OpenXR-SDK. Below are the installation steps.

SteamVR Installation and OpenXR Runtime Configuration

To run PBVR using OpenXR, utilize the OpenXR runtime provided by Steam’s SteamVR. For instructions on installing SteamVR, refer to the WebSite. Ensure you have completed the setup procedures for your specific HMD.

Below are instructions for configuring the SteamVR OpenXR runtime

  1. Start SteamVR, open the menu from the icon at the top, and select “Settings.”

workload

  1. In the SteamVR settings, select OpenXR. If “Current OpenXR Runtime” is not set to “SteamVR,” click the “Set SteamVR as OpenXR Runtime” button. If a User Account Control prompt appears, grant permission.

workload

  1. Confirm that it is set to “SteamVR.”

workload

Installing ImGui

  • Clone the source code from theWebSite

  • Open “x64 Native Tools Command Prompt for VS 2022,” navigate to the imgui directory, and run the following commands

    cd imgui
    git checkout v1.91.0
    mkdir include
    cd include
    mkdir imgui
    cd imgui
    xcopy "..\..\*.h" .
    xcopy "..\..\*.cpp" .
    xcopy "..\..\backends\imgui_impl_opengl3*" .
    
  • Make sure the directory structure is as follows

    <BASE_DIR>
    └─lib
      └─imgui
        ├─.github
        ├─backends
        ├─docs
        ├─examples
        ├─include
        │  └─imgui
        │    ├─imconfig.h
        │    ├─imgui.cpp
        │    ├─imgui.h
        │    ├─imgui_demo.cpp
        │    ├─imgui_draw.cpp
        │    ├─imgui_impl_opengl3.cpp
        │    ├─imgui_impl_opengl3.h
        │    ├─imgui_impl_opengl3_loader.h
        │    ├─imgui_internal.h
        │    ├─imgui_tables.cpp
        │    ├─imgui_widgets.cpp
        │    ├─imstb_rectpack.h
        │    ├─imstb_textedit.h
        │    └─imstb_truetype.h
        └─misc
    
  • Set the environment variable as follows

    variable value
    KVS_IMGUI_DIR <BASE_DIR>¥lib¥IMGUI

Installing OpenXR-SDK

  • Clone the source code from the WebSite

  • Open “x64 Native Tools Command Prompt for VS 2022,” navigate to the OpenXR-SDK directory, and run the following commands

    git checkout release-1.0.34
    mkdir build
    cd build
    cmake .. -G "Visual Studio 17 2022" -A x64 -D DYNAMIC_LOADER=ON
    MSBuild OPENXR.sln /t:clean;rebuild /p:Configuration=Release;Platoform="x64"
    MSBuild OPENXR.sln /t:clean;rebuild /p:Configuration=Debug;Platoform="x64"
    cd ..
    mkdir bin
    mkdir lib
    xcopy  "build\src\loader\Release\openxr_loader.dll" bin
    xcopy  "build\src\loader\Release\openxr_loader.lib" lib
    
  • Set the environment variable as follows

    variable value
    KVS_OPENXR_DIR <BASE_DIR>¥lib¥OpenXR

Installing Qt & QtCreator

Download and run the installer for the open source version of Qt from the Qt official Website. Select the directory where you want to install Qt, check Custom Install, and check the following components on the component selection screen.

  • Qt 6.2.4 > MSVC 2019 64-bit
  • Qt 6.2.4 > Qt Debug Information Files
  • Developer and Designer Tools > Qt Creator
  • Developer and Designer Tools > Qt Creator CDB Debugger Support
  • Developer and Designer Tools > Debugger Tools for Windows
  • Developer and Designer Tools > CMake
  • Developer and Designer Tools > Ninja 1.10.0

Local Image

After selecting the components, proceed with the permission of the license agreement and the setting of shortcut registration to start the installation.
After the installation is complete, set the following user environment variables.

variable value
Path C:¥Qt¥6.2.4¥msvc2019_64¥bin

QtCreator Settings

Open QtCreator and select [Edit] -> Preferences.
Local Image

In the Kits settings, check that the C and C++ compilers are set to Microsoft Visual C++ Compiler 17.X.XXXX (amd64).
Local Image

If it is not 17.X.XXXX, click the combo box and select 17.X.XXXX (amd64).
Then, click the Apply button.
Local Image

⚠️ **GitHub.com Fallback** ⚠️