SoftGLRender笔记：编译、运行

目录

• 编译
  • 编译、运行环境
  • 下载
  • 编译、运行
    • 命令行
    • IDE

编译

编译、运行环境

支持的系统：

• Linux
• Windows (Win10 x64 专业版)
• MacOS
• Andriod
• IOS

编译环境：

• CMake 3.23.1
• Visual Studio Community 2022(MSVC 19.4), or Qt Creator 15(llvm-mingw_64 6.9.0), 支持C++ 11
• Vulkan SDK 1.4.309.0
• Python 3.13.3

如果要运行Vulkan渲染，必须安装Vulkan库. 步骤：

1. 从Vulkan官网下载Vulkan SDK；
2. 设置环境变量VULKAN_SDK/VK_ICD_FILENAMES/VK_LAYER_PATH为安装SDK的目录.

下载

通过git命令，下载项目到本地.

git clone https://github.com/keith2018/SoftGLRender.git

编译、运行

可通过命令行编译项目，也可以用IDE（VS 2022/Qt）编译项目.

命令行

编译命令

mkdir build
cmake -B ./build -DCMAKE_BUILD_TYPE=Release
cmake --build ./build --config Release

运行命令

cd bin/Release
./SoftGLRender

IDE

用Qt导入项目后，为方便在IDE中看到Header Files，向根目录CMakeLists.txt添加如下内容：

file(GLOB SOFTGL_HEADER
    ${CMAKE_CURRENT_SOURCE_DIR}/src/Base/*.h
    ${CMAKE_CURRENT_SOURCE_DIR}/src/Render/*.h
    ${CMAKE_CURRENT_SOURCE_DIR}/src/Render/Software/*.h
    ${CMAKE_CURRENT_SOURCE_DIR}/src/Render/OpenGL/*.h
    ${CMAKE_CURRENT_SOURCE_DIR}/src/Render/Vulkan/*.h
    ${CMAKE_CURRENT_SOURCE_DIR}/src/Render/Vulkan/SPIRV/*.h
    ${CMAKE_CURRENT_SOURCE_DIR}/src/Viewer/*.h
    ${CMAKE_CURRENT_SOURCE_DIR}/src/Viewer/Shader/GLSL/*.h
    ${CMAKE_CURRENT_SOURCE_DIR}/src/Viewer/Shader/Software/*.h
)
...

add_executable(${TARGET_NAME}
        "${SOFTGL_SRC}"
        "${IMGUI_SRC}"
        "${THIRD_PARTY_DIR}/glad/src/glad.c"
        "${THIRD_PARTY_DIR}/json11/json11.cpp"
        "${THIRD_PARTY_DIR}/md5/md5.c"

        "${SOFTGL_HEADER}" # 为目标添加头文件
        )

左侧项目视图，就能看到项目头文件：

成功编译、运行项目，可看到如下界面：