Added MSL_STATIC_RUNTIME CMake flag.

Allows for linking to the static runtime library on Windows.

Updated the minimum CMake version to 3.15 on Windows to support
set(CMAKE_MSVC_RUNTIME_LIBRARY. Other systems now require 3.10 to silence
warnings that newer versions will drop compatibility for a declared minimum
version < 3.10.

Use CONFIG mode for finding boost. Silences warning that in future versions
FindBoost.cmake will be removed. Updated example in README to set Boost_DIR
instead of other paths for FindBoost.cmake.

Author: akb825

.github/workflows/main.yml

@@ -165,19 +165,19 @@ jobs:
         - arch: Win32
           bits: 32
           lib_type: Static
-          cmake_args: "-DMSL_SHARED=OFF -DBOOST_ROOT=D:/boost"
+          cmake_args: "-DMSL_SHARED=OFF -DBoost_DIR=D:/boost/lib32-msvc-${{ env.msvc_version }}/cmake/Boost-${{ env.boost_version }}"
         - arch: Win32
           bits: 32
           lib_type: Shared
-          cmake_args: "-DMSL_SHARED=ON -DBOOST_ROOT=D:/boost"
+          cmake_args: "-DMSL_SHARED=ON -DBoost_DIR=D:/boost/lib32-msvc-${{ env.msvc_version }}/cmake/Boost-${{ env.boost_version }}"
         - arch: x64
           bits: 64
           lib_type: Static
-          cmake_args: "-DMSL_SHARED=OFF -DBOOST_ROOT=D:/boost"
+          cmake_args: "-DMSL_SHARED=OFF -DBoost_DIR=D:/boost/lib64-msvc-${{ env.msvc_version }}/cmake/Boost-${{ env.boost_version }}"
         - arch: x64
           bits: 64
           lib_type: Shared
-          cmake_args: "-DMSL_SHARED=ON -DBOOST_ROOT=D:/boost"
+          cmake_args: "-DMSL_SHARED=ON -DBoost_DIR=D:/boost/lib64-msvc-${{ env.msvc_version }}/cmake/Boost-${{ env.boost_version }}"
     steps:
     - name: checkout
       uses: actions/checkout@v4

CMakeLists.txt

@@ -1,4 +1,12 @@
-cmake_minimum_required(VERSION 3.5)
+if (WIN32)
+	# Needs 3.15 for CMAKE_MSVC_RUNTIME_LIBRARY.
+	cmake_minimum_required(VERSION 3.15)
+else()
+	cmake_minimum_required(VERSION 3.10)
+endif()
+if (POLICY CMP0144)
+	cmake_policy(SET CMP0144 NEW)
+endif()
 project(MSL)
 
 # Build options
@@ -9,6 +17,7 @@ else()
 	set(MSL_SHARED_DEFAULT OFF)
 endif()
 set(MSL_SHARED ${MSL_SHARED_DEFAULT} CACHE BOOL "Build MSL using shared libraries.")
+set(MSL_STATIC_RUNTIME OFF CACHE BOOL "Use static runtime library on Windows.")
 
 # Options for disabling portions of the build.
 set(MSL_BUILD_TESTS ON CACHE BOOL "Build unit tests.")

Client/test/CMakeLists.txt

@@ -2,7 +2,7 @@ if (NOT GTEST_FOUND OR NOT MSL_BUILD_TESTS)
 	return()
 endif()
 
-find_package(Boost COMPONENTS filesystem REQUIRED)
+find_package(Boost CONFIG COMPONENTS filesystem REQUIRED)
 find_package(Threads)
 
 file(GLOB_RECURSE sources *.cpp *.h)

Compile/CMakeLists.txt

@@ -1,4 +1,4 @@
-find_package(Boost COMPONENTS filesystem wave REQUIRED)
+find_package(Boost CONFIG COMPONENTS filesystem wave REQUIRED)
 find_package(Threads)
 
 set(GLSLANG_DIR ${CMAKE_CURRENT_SOURCE_DIR}/glslang)

Compile/test/CMakeLists.txt

@@ -2,7 +2,7 @@ if (NOT GTEST_FOUND OR NOT MSL_BUILD_TESTS)
 	return()
 endif()
 
-find_package(Boost COMPONENTS filesystem REQUIRED)
+find_package(Boost CONFIG COMPONENTS filesystem REQUIRED)
 find_package(Threads)
 
 file(GLOB_RECURSE sources *.cpp *.h)

README.md

@@ -39,7 +39,7 @@ Multiple shader files may be compiled into a module. Examples for combining modu
 
 The following software is required to build MSL:
 
-* [cmake](https://cmake.org/) 3.5 or later
+* [cmake](https://cmake.org/) 3.10 or later
 * [boost](https://www.boost.org/) (required unless only building client library without tests)
 * [Python](https://www.python.org/) 3 or later (required unless only building client library)
 * [glslang](https://github.com/KhronosGroup/glslang) (required for compiler, provided as submodule)
@@ -51,7 +51,7 @@ The following software is required to build MSL:
 
 > **Note:** Boost must be built with C++11 support. For example, when building and installing through the b2 bootstrap command: `./b2 "-std=c++11" -j4 install`
 
-> **Note:** When Boost is manually installed, the appropriate variables should be set. In the case of Windows, the `BOOST_LIBRARYDIR` and `BOOST_ROOT` variables should be set. (examples: `BOOST_LIBRARYDIR=C:\local\boost_1_64_0\lib64-msvc-14.1` and `BOOST_ROOT=C:\local\boost_1_64_0`) In Windows, the value of `BOOST_LIBRARYDIR` should also be on `PATH` to ensure the DLLs can be loaded.
+> **Note:** When Boost is manually installed, the appropriate variables should be set. In the case of Windows, the `Boost_DIR` variable should be set. (example: `Boost_DIR=C:\local\boost_1_83_0\lib64-msvc-14.1\cmake\Boost-1.83.0`) In Windows, the path to the libraries (e.g. `C:\local\boost_1_83_0\lib64-msvc-14.1`) should be set on `PATH` to ensure the DLLs can be loaded.
 
 The glslang, SPIRV-Cross, and SPIRV-Tools submodules can be grabbed by running `git submodule update --init --recursive`.
 
@@ -87,6 +87,7 @@ The following options may be used when running cmake:
 * `-DCMAKE_BUILD_TYPE=Debug|Release`: Building in `Debug` or `Release`. This should always be specified.
 * `-DCMAKE_INSTALL_PREFIX=path`: Sets the path to install to when running make install.
 * `-DMSL_SHARED=ON|OFF`: Set to `ON` to build with shared libraries, `OFF` to build with static libraries. Default is `OFF`.
+* `-MSL_STATIC_RUNTIME=ON|OFF`: Set to `ON` to use the static runtime library on Windows. When `OFF`, it will respect the existing value of `CMAKE_MSVC_RUNTIME_LIBRARY`, or use dynamic runtime if otherwise unset. It is not recommended to set this to `ON` when `MSL_SHARED` is also `ON`. Default is `OFF`.
 
 ## Enabled Builds
 

cmake/config.cmake

@@ -1,4 +1,4 @@
-# Copyright 2018-2022 Aaron Barany
+# Copyright 2018-2024 Aaron Barany
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -19,6 +19,13 @@ set(CMAKE_CXX_STANDARD 17)
 set(CMAKE_POSITION_INDEPENDENT_CODE ON)
 
 if (MSVC)
+	if (MSL_STATIC_RUNTIME)
+		set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
+		if (MSL_SHARED)
+			message(WARNING
+				"It is not recommended to have MSL_SHARED and MSL_STATIC_RUNTIME both set to ON.")
+		endif()
+	endif()
 	add_compile_options(/W3 /WX /wd4200 /MP /bigobj)
 	add_definitions(-D_CRT_SECURE_NO_WARNINGS -D_SCL_SECURE_NO_WARNINGS
 		-D_CRT_NONSTDC_NO_WARNINGS -DBOOST_ALL_NO_LIB)

tools/mslb-extract/CMakeLists.txt

@@ -1,4 +1,4 @@
-find_package(Boost COMPONENTS program_options filesystem)
+find_package(Boost CONFIG COMPONENTS program_options filesystem)
 
 file(GLOB_RECURSE sources *.cpp *.h)
 add_executable(mslb-extract ${sources})

tools/mslc/CMakeLists.txt

@@ -1,4 +1,4 @@
-find_package(Boost COMPONENTS program_options)
+find_package(Boost CONFIG COMPONENTS program_options)
 
 file(GLOB_RECURSE sources *.cpp *.h)
 add_executable(mslc ${sources})