Enable IPO and runtime optimization flags

lzray-universe · lzray-universe · commit 46e20375078e · 2026-03-22T11:56:46.000+08:00
Introduce LUNAR_ENABLE_IPO and LUNAR_ENABLE_FAST_MATH CMake options and detect/enable IPO (LTO) when supported. Add lunar_enable_runtime_optimizations() helper to apply platform- and config-specific compile flags (e.g. /Gw, /Ob2, -O3, -ffast-math or /fp:fast) and apply it to core, executable, dll and test targets. Update CI and Release workflows to use a configurable matrix build_type (Release/RelWithDebInfo), pass matrix build type into cmake/ctest, enable IPO in native Release builds and add a RelWithDebInfo job, and explicitly control fast-math flags. Add a CMakeSettings.json file with MSVC Ninja configurations for local developer use.
diff --git a/.github/workflows/CI.yml b/.github/workflows/CI.yml
@@ -13,26 +13,37 @@ jobs:
         include:
           - os: ubuntu-latest
             name: linux-x64
+            build_type: Release
             cmake_args: ""
 
           - os: ubuntu-24.04-arm
             name: linux-arm64
+            build_type: Release
             cmake_args: ""
 
           - os: windows-latest
             name: windows-x64
+            build_type: Release
             cmake_args: "-A x64"
 
           - os: windows-11-arm
             name: windows-arm64
+            build_type: Release
             cmake_args: "-A ARM64"
 
           - os: macos-15-intel
             name: macos-x64
+            build_type: Release
             cmake_args: ""
 
           - os: macos-latest
             name: macos-arm64
+            build_type: Release
+            cmake_args: ""
+
+          - os: ubuntu-latest
+            name: linux-x64-relwithdebinfo
+            build_type: RelWithDebInfo
             cmake_args: ""
 
     runs-on: ${{ matrix.os }}
@@ -43,13 +54,15 @@ jobs:
       - name: Configure
         run: >
           cmake -S . -B build
-          -DCMAKE_BUILD_TYPE=Release
+          -DCMAKE_BUILD_TYPE=${{ matrix.build_type }}
           -DLUNAR_ENABLE_SERIES_FALLBACK=ON
           -DLUNAR_BUILD_TESTS=ON
+          -DLUNAR_ENABLE_IPO=ON
+          -DLUNAR_ENABLE_FAST_MATH=OFF
           ${{ matrix.cmake_args }}
 
       - name: Build
-        run: cmake --build build --config Release --parallel
+        run: cmake --build build --config ${{ matrix.build_type }} --parallel
 
       - name: Test
-        run: ctest --test-dir build -C Release --output-on-failure
+        run: ctest --test-dir build -C ${{ matrix.build_type }} --output-on-failure
diff --git a/.github/workflows/Release.yml b/.github/workflows/Release.yml
@@ -59,7 +59,13 @@ jobs:
     
       - name: Configure (native)
         if: matrix.kind == 'native'
-        run: cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DLUNAR_ENABLE_SERIES_FALLBACK=ON ${{ matrix.cmake_args }}
+        run: >
+          cmake -S . -B build
+          -DCMAKE_BUILD_TYPE=Release
+          -DLUNAR_ENABLE_SERIES_FALLBACK=ON
+          -DLUNAR_ENABLE_IPO=ON
+          -DLUNAR_ENABLE_FAST_MATH=OFF
+          ${{ matrix.cmake_args }}
 
       - name: Build (native)
         if: matrix.kind == 'native'
@@ -83,6 +89,8 @@ jobs:
           emcmake cmake -S . -B build \
             -DCMAKE_BUILD_TYPE=Release \
             -DLUNAR_ENABLE_SERIES_FALLBACK=ON \
+            -DLUNAR_ENABLE_IPO=OFF \
+            -DLUNAR_ENABLE_FAST_MATH=OFF \
             -DLUNAR_BUILD_TESTS=OFF
 
       - name: Build (emscripten)
@@ -119,6 +127,8 @@ jobs:
           cmake -S . -B build \
             -DCMAKE_BUILD_TYPE=Release \
             -DLUNAR_ENABLE_SERIES_FALLBACK=ON \
+            -DLUNAR_ENABLE_IPO=ON \
+            -DLUNAR_ENABLE_FAST_MATH=OFF \
             -DCMAKE_C_COMPILER="$PWD/zigcc" \
             -DCMAKE_CXX_COMPILER="$PWD/zigcxx" \
             -DCMAKE_C_FLAGS="-Wno-error=date-time -Wno-date-time" \
diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -3,6 +3,7 @@ cmake_minimum_required(VERSION 3.20)
 project(lunar LANGUAGES C CXX)
 
 include(CTest)
+include(CheckIPOSupported)
 
 set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
@@ -11,6 +12,44 @@ set(CMAKE_CXX_EXTENSIONS OFF)
 option(LUNAR_ENABLE_DIMENSION_TYPES "Enable compile-time tagged physical vectors" ON)
 option(LUNAR_ENABLE_SERIES_FALLBACK "Enable VSOP87A/ELPMPP02 fallback when BSP is unavailable" ON)
 option(LUNAR_BUILD_TESTS "Build GoogleTest-based test targets" ${BUILD_TESTING})
+option(LUNAR_ENABLE_IPO "Enable link-time/interprocedural optimization for release-like builds" ON)
+option(LUNAR_ENABLE_FAST_MATH "Enable faster but less strict floating-point optimizations" OFF)
+
+if(LUNAR_ENABLE_IPO AND NOT EMSCRIPTEN)
+    check_ipo_supported(RESULT LUNAR_IPO_SUPPORTED OUTPUT LUNAR_IPO_OUTPUT LANGUAGES C CXX)
+    if(LUNAR_IPO_SUPPORTED)
+        set(CMAKE_INTERPROCEDURAL_OPTIMIZATION_RELEASE ON)
+        set(CMAKE_INTERPROCEDURAL_OPTIMIZATION_RELWITHDEBINFO ON)
+    else()
+        message(STATUS "IPO/LTO disabled: ${LUNAR_IPO_OUTPUT}")
+    endif()
+endif()
+
+function(lunar_enable_runtime_optimizations target_name)
+    if(MSVC)
+        target_compile_options(${target_name} PRIVATE
+            $<$<CONFIG:Release>:/Gw>
+            $<$<CONFIG:RelWithDebInfo>:/Gw>
+            $<$<CONFIG:RelWithDebInfo>:/Ob2>
+        )
+    elseif(NOT EMSCRIPTEN)
+        target_compile_options(${target_name} PRIVATE
+            $<$<CONFIG:RelWithDebInfo>:-O3>
+        )
+    endif()
+
+    if(LUNAR_ENABLE_FAST_MATH AND NOT EMSCRIPTEN)
+        if(MSVC)
+            target_compile_options(${target_name} PRIVATE
+                $<$<OR:$<CONFIG:Release>,$<CONFIG:RelWithDebInfo>>:/fp:fast>
+            )
+        else()
+            target_compile_options(${target_name} PRIVATE
+                $<$<OR:$<CONFIG:Release>,$<CONFIG:RelWithDebInfo>>:-ffast-math>
+            )
+        endif()
+    endif()
+endfunction()
 
 if(EMSCRIPTEN)
     set(LUNAR_EMSCRIPTEN_COMPILE_OPTIONS
@@ -109,6 +148,7 @@ endif()
 add_library(lunar_core STATIC
     ${LUNAR_CORE_SOURCES}
 )
+lunar_enable_runtime_optimizations(lunar_core)
 
 set_target_properties(lunar_core PROPERTIES
     POSITION_INDEPENDENT_CODE ON
@@ -134,6 +174,7 @@ endif()
 add_executable(lunar
     src/main.cpp
 )
+lunar_enable_runtime_optimizations(lunar)
 target_link_libraries(lunar PRIVATE lunar_core)
 target_include_directories(lunar PRIVATE
     ${CMAKE_CURRENT_SOURCE_DIR}/include
@@ -157,6 +198,7 @@ endif()
 add_library(lunar_dll ${LUNAR_DLL_LIBRARY_TYPE}
     src/c_api.cpp
 )
+lunar_enable_runtime_optimizations(lunar_dll)
 target_link_libraries(lunar_dll PRIVATE lunar_core)
 target_include_directories(lunar_dll PRIVATE
         ${CMAKE_CURRENT_SOURCE_DIR}/include
diff --git a/CMakeSettings.json b/CMakeSettings.json
@@ -0,0 +1,26 @@
+﻿{
+  "configurations": [
+    {
+      "name": "x64-Debug",
+      "generator": "Ninja",
+      "configurationType": "Debug",
+      "inheritEnvironments": [ "msvc_x64_x64" ],
+      "buildRoot": "${projectDir}\\out\\build\\${name}",
+      "installRoot": "${projectDir}\\out\\install\\${name}",
+      "cmakeCommandArgs": "",
+      "buildCommandArgs": "",
+      "ctestCommandArgs": ""
+    },
+    {
+      "name": "x64-Release",
+      "generator": "Ninja",
+      "configurationType": "Release",
+      "inheritEnvironments": [ "msvc_x64_x64" ],
+      "buildRoot": "${projectDir}\\out\\build\\${name}",
+      "installRoot": "${projectDir}\\out\\install\\${name}",
+      "cmakeCommandArgs": "",
+      "buildCommandArgs": "",
+      "ctestCommandArgs": ""
+    }
+  ]
+}
diff --git a/tests/CMakeLists.txt b/tests/CMakeLists.txt
@@ -22,6 +22,7 @@ add_executable(lunar_tests
     test_eclipse.cpp
     test_almanac_i18n.cpp
 )
+lunar_enable_runtime_optimizations(lunar_tests)
 
 target_link_libraries(lunar_tests PRIVATE
     lunar_core

Original file line number	Diff line number	Diff line change
`@@ -22,6 +22,7 @@ add_executable(lunar_tests`
`22`	`22`	`test_eclipse.cpp`
`23`	`23`	`test_almanac_i18n.cpp`
`24`	`24`	`)`
	`25`	`+lunar_enable_runtime_optimizations(lunar_tests)`
`25`	`26`
`26`	`27`	`target_link_libraries(lunar_tests PRIVATE`
`27`	`28`	`lunar_core`