Transition development to Orbiter 2024 x64, change build system to CMake

.gitattributes

@@ -9,4 +9,4 @@
 # Let's try this for scenario files too
 *.scn	eol=crlf
 # Do not propagate build script into branches unless requested
-appveyor.yml merge=ours
+.github/workflows/build.yml merge=ours

.github/workflows/build.yml

@@ -0,0 +1,66 @@
+# This starter workflow is for a CMake project running on a single platform. There is a different starter workflow if you need cross-platform coverage.
+# See: https://github.com/actions/starter-workflows/blob/main/ci/cmake-multi-platform.yml
+name: CMake on a single platform
+
+on:
+  push:
+    branches: [ "CMake" ]
+
+env:
+  GH_TOKEN: ${{github.token}}
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: RelWithDebInfo
+  BUILD_NAME: NASSP-V9.0-Orbiter2024-${{github.run_number}}
+
+jobs:
+  build:
+
+    # The CMake configure and build commands are platform agnostic and should work equally well on Windows or Mac.
+    # You can convert this to a matrix build if you need cross-platform coverage.
+    # See: https://docs.github.com/en/free-pro-team@latest/actions/learn-github-actions/managing-complex-workflows#using-a-build-matrix
+    runs-on: windows-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Check dependency cache for Orbiter 2024 x64
+      uses: actions/cache@v4
+      id: cache
+      with:
+        path: ${{github.workspace}}/Orbiter2024-x64.zip
+        key: O2024-x64-zip
+
+    - name: Download Orbiter 2024 x64 if not cached
+      if: steps.cache.outputs.cache-hit != 'true'
+      run: Invoke-WebRequest -Uri https://github.com/orbitersim/orbiter/releases/download/2024/Orbiter-x64.zip -OutFile ${{github.workspace}}/Orbiter2024-x64.zip
+
+    - name: Extract Orbiter
+      run: Expand-Archive -Force ${{github.workspace}}/Orbiter2024-x64.zip ${{github.workspace}}/Orbiter2024
+
+    - name: Configure CMake
+      # Configure CMake in a 'build' subdirectory. `CMAKE_BUILD_TYPE` is only required if you are using a single-configuration generator such as make.
+      # See https://cmake.org/cmake/help/latest/variable/CMAKE_BUILD_TYPE.html?highlight=cmake_build_type
+      run: cmake -DORBITER_INSTALL_DIR:STRING="${{github.workspace}}/Orbiter2024" -DFINAL_INSTALL_DIR:STRING="${{github.workspace}}/install" -B ${{github.workspace}}/build -G "Visual Studio 17 2022" -A x64 ${{github.workspace}}/Orbitersdk/samples/ProjectApollo/
+
+    - name: Build
+      # Build your program with the given configuration
+      run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}} -j 4
+
+    - name: Install
+      run: cmake --install ${{github.workspace}}/build
+
+    - name: Write version file
+      run: |
+        $version = "${{ env.BUILD_NAME }}"
+        @"
+        $version
+        "@ | Out-File -Encoding UTF8 "${{ github.workspace }}/install/NASSP_VERSION.txt"
+
+    - name: Zip output directory
+      run: Compress-Archive -Path ${{github.workspace}}/install/* -DestinationPath ${{github.workspace}}/${{env.BUILD_NAME}}-x64.zip -Force
+
+    - name: Create GitHub release and tag
+      run: gh release create ${{env.BUILD_NAME}} ${{github.workspace}}/${{env.BUILD_NAME}}-x64.zip --target CMake
+
+    - name: Create QSG asset
+      run: gh release upload ${{env.BUILD_NAME}} '${{github.workspace}}/Doc/Project Apollo - NASSP/NASSP Quick Start Guide.pdf'

.gitignore

@@ -143,3 +143,31 @@ XRSound/
 /.ninja_deps
 # Ignore Matlab log analyzers
 /*.m
+/Orbitersdk/samples/ProjectApollo/CMakeSettings.json
+/Extern
+/GravityModels
+/packages/ldoc
+/pl
+/CMakeDoxyfile.in
+/CMakeDoxygenDefaults.cmake
+/lfs.dll
+/lfs.exp
+/lfs.ilk
+/lfs.lib
+/lfs.pdb
+/lua.dll
+/lua.exp
+/lua.ilk
+/lua.lib
+/lua.pdb
+/SketchpadOutput2.dds
+/zlibd.dll
+/zlibd.exp
+/zlibd.ilk
+/zlibd.lib
+/zlibd.pdb
+/zlib.dll
+/zlib.exp
+/zlib.ilk
+/zlib.lib
+/zlib.pdb

CONTRIBUTING.md

@@ -8,10 +8,9 @@ This guide is a work in progress and will be updated in the future.
 ## Building
 To build the project you will need a working installation of Orbiter developed by Martin Schweiger.
 These are all the requirements for a working development environment
-* [Orbiter Beta](http://orbit.medphys.ucl.ac.uk/betainstall.html)
-* [D3D9 Client for orbiter](https://www.orbiter-forum.com/showthread.php?t=18431)
-* NASSP Orbiter2016 (or derivative) branch checked out inside the Orbiter installation
-* Visual Studio (2017, 2019, or 2022)
+* [Orbiter 2024 x64](https://github.com/orbitersim/orbiter/releases/tag/2024)
+* NASSP Orbiter2024 (or derivative) branch checked out inside the Orbiter installation
+* Visual Studio 2019 or 2022 (2022 is preferred)
 
 ## Submitting changes
 To get your work included in the project we ask you to make a pull request with a brief summary of the changes you did followed by details of your implementation.