@bloomengine/engine 0.3.1 → 0.3.3

package/native/third_party/JoltPhysics/Build/README.md

@@ -0,0 +1,250 @@
+# Building and Using Jolt Physics
+
+## Build Types
+
+Each platform supports multiple build targets
+
+- Debug - Debug version of the library, turns on asserts
+- Release - Release version of the library, no asserts but includes profiling support and can draw the world and simulation properties
+- ReleaseASAN - As Release but turns on Address Sanitizer (clang only) to find bugs
+- ReleaseUBSAN - As Release but turns on Undefined Behavior Sanitizer (clang only) to find bugs
+- ReleaseTSAN - As Release but turns on the Thread Sanitizer (clang only) to find bugs
+- ReleaseCoverage - As Release but turns on Coverage reporting (clang only) to find which areas of the code are not executed
+- Distribution - Shippable version of the library, turns off all debugging support
+
+## Includes
+
+The Jolt headers don't include Jolt/Jolt.h. Always include Jolt/Jolt.h before including any other Jolt header.
+You can use Jolt/Jolt.h in your precompiled header to speed up compilation.
+
+## Defines
+
+There are a number of user configurable defines that turn on/off certain features:
+<details>
+	<summary>General Options (click to see more)</summary>
+	<ul>
+		<li>JPH_SHARED_LIBRARY - Use the Jolt library as a shared library. Use JPH_BUILD_SHARED_LIBRARY to build Jolt as a shared library.</li>
+		<li>JPH_PROFILE_ENABLED - Turns on the internal profiler.</li>
+		<li>JPH_EXTERNAL_PROFILE - Turns on the internal profiler but forwards the information to a user defined external system (see Profiler.h). Use JPH_USE_EXTERNAL_PROFILE option to enable this from CMake config.</li>
+		<li>JPH_DEBUG_RENDERER - Adds support to draw lines and triangles, used to be able to debug draw the state of the world.</li>
+		<li>JPH_DISABLE_TEMP_ALLOCATOR - Disables the temporary memory allocator, used mainly to allow ASAN to do its job.</li>
+		<li>JPH_DISABLE_CUSTOM_ALLOCATOR - Disables the ability to override the memory allocator.</li>
+		<li>JPH_FLOATING_POINT_EXCEPTIONS_ENABLED - Turns on division by zero and invalid floating point exception support in order to detect bugs (Windows only).</li>
+		<li>JPH_CROSS_PLATFORM_DETERMINISTIC - Turns on behavior to attempt cross platform determinism. If this is set, JPH_USE_FMADD is ignored.</li>
+		<li>JPH_DET_LOG - Turn on a lot of extra logging to help debug determinism issues when JPH_CROSS_PLATFORM_DETERMINISTIC is turned on.</li>
+		<li>JPH_ENABLE_ASSERTS - Compiles the library so that it rises an assert in case of failures. The library ignores these failures otherwise.</li>
+		<li>JPH_DOUBLE_PRECISION - Compiles the library so that all positions are stored in doubles instead of floats. This makes larger worlds possible.</li>
+		<li>JPH_OBJECT_LAYER_BITS - Defines the size of ObjectLayer, must be 16 or 32 bits.</li>
+		<li>JPH_OBJECT_STREAM - Includes the code to serialize physics data in the ObjectStream format (mostly used by the examples).</li>
+		<li>JPH_NO_FORCE_INLINE - Don't use force inlining but fall back to a regular 'inline'.</li>
+		<li>JPH_USE_STD_VECTOR - Use std::vector instead of Jolt's own Array class.</li>
+		<li>CPP_RTTI_ENABLED - Enable C++ RTTI for the library. Disabled by default.</li>
+	</ul>
+</details>
+
+<details>
+	<summary>CPU Instruction Sets (click to see more)</summary>
+	<ul>
+		<li>JPH_USE_SSE4_1 - Enable SSE4.1 CPU instructions (default: on, x86/x64 only)</li>
+		<li>JPH_USE_SSE4_2 - Enable SSE4.2 CPU instructions (default: on, x86/x64 only)</li>
+		<li>JPH_USE_F16C - Enable half float CPU instructions (default: on, x86/x64 only)</li>
+		<li>JPH_USE_LZCNT - Enable the lzcnt CPU instruction (default: on, x86/x64 only)</li>
+		<li>JPH_USE_TZCNT - Enable the tzcnt CPU instruction (default: on, x86/x64 only)</li>
+		<li>JPH_USE_AVX - Enable AVX CPU instructions (default: on, x86/x64 only)</li>
+		<li>JPH_USE_AVX2 - Enable AVX2 CPU instructions (default: on, x86/x64 only)</li>
+		<li>JPH_USE_AVX512 - Enable AVX512F+AVX512VL CPU instructions (default: off, x86/x64 only)</li>
+		<li>JPH_USE_FMADD - Enable fused multiply add CPU instructions (default: on, x86/x64 only)</li>
+	</ul>
+</details>
+
+## Logging & Asserting
+
+To override the default trace and assert mechanism install your own custom handlers in Trace and AssertFailed (see IssueReporting.h).
+
+## Custom Memory Allocator
+
+To implement your custom memory allocator override Allocate, Free, Reallocate, AlignedAllocate and AlignedFree (see Memory.h).
+
+## Building
+
+<details>
+	<summary>Windows 10+</summary>
+	<ul style="list-style: none"><li>
+		<details>
+			<summary>MSVC CL (default compiler)</summary>
+			<ul>
+				<li>Download Visual Studio 2022 (Community or other edition)</li>
+				<li>Download CMake 3.20+ (https://cmake.org/download/)</li>
+				<li>Run cmake_vs2022_cl.bat</li>
+				<li>Open the resulting project file VS2022_CL\JoltPhysics.sln</li>
+				<li>Compile and run either 'Samples' or 'UnitTests'</li>
+			</ul>
+		</details>
+		<details>
+			<summary>MSVC CL - 32 bit</summary>
+			<ul>
+				<li>Download Visual Studio 2022 (Community or other edition)</li>
+				<li>Download CMake 3.20+ (https://cmake.org/download/)</li>
+				<li>Run cmake_vs2022_cl_32bit.bat</li>
+				<li>Open the resulting project file VS2022_CL_32BIT\JoltPhysics.sln</li>
+				<li>Compile and run either 'Samples' or 'UnitTests'</li>
+			</ul>
+		</details>
+		<details>
+			<summary>MSVC Clang compiler</summary>
+			<ul>
+				<li>Download Visual Studio 2022 (Community or other edition)</li>
+				<li>Make sure to install "C++ Clang Compiler for Windows 11.0.0+" and "C++ Clang-cl for v142+ build tools (x64/x86)" using the Visual Studio Installer</li>
+				<li>Download CMake 3.20+ (https://cmake.org/download/)</li>
+				<li>Run cmake_vs2022_clang.bat</li>
+				<li>Open the resulting project file VS2022_Clang\JoltPhysics.sln</li>
+				<li>Compile and run either 'Samples' or 'UnitTests'</li>
+			</ul>
+		</details>
+		<details>
+			<summary>MSVC Universal Windows Platform</summary>
+			<ul>
+				<li>Download Visual Studio 2022+ (Community or other edition)</li>
+				<li>Make sure to install "Universal Windows Platform development" using the Visual Studio Installer</li>
+				<li>Download CMake 3.20+ (https://cmake.org/download/)</li>
+				<li>Run cmake_vs2022_uwp.bat</li>
+				<li>Open the resulting project file VS2022_UWP\JoltPhysics.sln</li>
+				<li>Compile and run 'UnitTests'</li>
+			</ul>
+		</details>
+		<details>
+			<summary>MinGW</summary>
+			<ul>
+				<li>Follow download instructions for MSYS2 (https://www.msys2.org/)</li>
+				<li>From the MSYS2 MSYS app run: pacman -S --needed mingw-w64-x86_64-toolchain mingw-w64-x86_64-cmake</li>
+				<li>From the MSYS2 MINGW x64 app, in the Build folder run: ./cmake_windows_mingw.sh</li>
+				<li>Run: cmake --build MinGW_Debug</li>
+				<li>Run: MinGW_Debug/UnitTests.exe</li>
+			</ul>
+		</details>
+	</li></ul>
+</details>
+
+<details>
+	<summary>Linux (Ubuntu)</summary>
+	<ul>
+		<li>Install clang (apt-get install clang)</li>
+		<li>Install cmake (apt-get install cmake)</li>
+		<li>If you want to build the Samples or JoltViewer, install the <a href="https://vulkan.lunarg.com/doc/view/latest/linux/getting_started_ubuntu.html">Vulkan SDK</a></li>
+		<li>Run: ./cmake_linux_clang_gcc.sh</li>
+		<li>Go to the Linux_Debug folder</li>
+		<li>Run: make -j$(nproc) && ./UnitTests</li>
+		<li>If you built the samples you can run: ./Samples</li>
+	</ul>
+</details>
+
+<details>
+	<summary>Android</summary>
+	<ul>
+		<li>Install Android Studio 2020.3.1+ (https://developer.android.com/studio/)</li>
+		<li>Open the 'Android' folder in Android Studio and wait until gradle finishes</li>
+		<li>Select 'Run' / 'Run...' and 'UnitTests'</li>
+		<li>If the screen turns green after a while the unit tests succeeded, when red they failed (see the android log for details)</li>
+	</ul>
+</details>
+
+<details>
+	<summary>macOS</summary>
+	<ul>
+		<li>Install XCode</li>
+		<li>Download CMake 3.23+ (https://cmake.org/download/)</li>
+		<li>Run: ./cmake_xcode_macos.sh</li>
+		<li>This will open XCode with a newly generated project</li>
+		<li>Build and run the project</li>
+		<li>Note that you can also follow the steps in the 'Linux' section if you wish to build without XCode.</li>
+	</ul>
+</details>
+
+<details>
+	<summary>iOS</summary>
+	<ul>
+		<li>Install XCode</li>
+		<li>Download CMake 3.23+ (https://cmake.org/download/)</li>
+		<li>Run: ./cmake_xcode.ios.sh</li>
+		<li>This will open XCode with a newly generated project</li>
+		<li>Build and run the project (note that this will only work in the simulator as the code signing information is not set up)</li>
+	</ul>
+</details>
+
+<details>
+	<summary>Emscripten (tested only on Linux)</summary>
+	<ul>
+		<li>Install Emscripten (https://emscripten.org/docs/getting_started/downloads.html)</li>
+		<li>Install nodejs (apt-get install nodejs)</li>
+		<li>Download CMake 3.23+ (https://cmake.org/download/)</li>
+		<li>Run: ./cmake_linux_emscripten.sh</li>
+		<li>Go to the WASM_Debug folder</li>
+		<li>Run: make -j$(nproc) && node UnitTests.js</li>
+	</ul>
+</details>
+
+## Other Build Tools
+
+* A vcpkg package is available [here](https://github.com/microsoft/vcpkg/tree/master/ports/joltphysics).
+* A xmake package is available [here](https://github.com/xmake-io/xmake-repo/tree/dev/packages/j/joltphysics).
+* A conan package is available [here](https://conan.io/center/recipes/joltphysics)
+* Jolt has been verified to build with [ninja](https://ninja-build.org/) through CMake.
+
+## Errors
+
+### Link Error: File Format Not Recognized
+
+If you receive the following error when linking:
+
+```
+/usr/bin/ld: libJolt.a: error adding symbols: file format not recognized
+```
+
+Then you have not enabled interprocedural optimizations (link time optimizations) for your own application. See the INTERPROCEDURAL_OPTIMIZATION option in CMakeLists.txt.
+
+### Link Error: Unresolved External Symbol
+
+If you receive a link error that looks like:
+
+```
+error LNK2001: unresolved external symbol "public: virtual void __cdecl JPH::ConvexShape::GetSubmergedVolume(...) const"
+```
+
+you have a mismatch in defines between your own code and the Jolt library. In this case the mismatch is in the define `JPH_DEBUG_RENDERER` which is most likely defined in `Jolt.lib` and not in your own project. In `Debug` and `Release` builds, Jolt by default has `JPH_DEBUG_RENDERER` defined, in `Distribution` it is not defined. The cmake options `DEBUG_RENDERER_IN_DEBUG_AND_RELEASE` and `DEBUG_RENDERER_IN_DISTRIBUTION` override this behavior.
+
+The `RegisterTypes` function (which you have to call to initialize the library) checks the other important defines and will trace and abort if there are more mismatches.
+
+### Link Error: Undefined Symbol
+
+If you receive a link error that looks like:
+
+```
+error: undefined symbol: typeinfo for JPH::DebugRenderer
+```
+
+you have a mismatch between RTTI settings (MSVC: `/GR`/`/GR-`, clang: `-frtti`/`-fno-rtti`). Jolt by default compiles without RTTI and if your project compiles with RTTI you can get this error. Either turn RTTI off for your project or turn it on for Jolt using the CPP_RTTI_ENABLED cmake option.
+
+### DirectX Error
+
+The samples use DirectX for the graphics implementation, when attempting to run the samples you may get a DirectX error pop-up which may say "The GPU device instance has been suspended", in your debugger you may see the message "Using the Redistributable D3D12 SDKLayers dll also requires that the latest SDKLayers for Windows 10 is installed.". 
+
+Fix this by enabling "Graphics Tools" which is an optional Windows settings. To enable it you have to press the windows key, search for "Manage Optional Features", and then click "Add a Feature", and install "Graphics Tools".
+
+### Illegal Instruction Error
+
+If your CPU doesn't support all of the instructions you'll get an `Illegal instruction` exception.
+
+On Linux to see what instructions your CPU supports run `lscpu` and then look at the flags section, on Windows you can use a program like [`coreinfo`](https://learn.microsoft.com/en-us/sysinternals/downloads/coreinfo). Once you know what instructions your cpu supports you can configure the project through cmake and for example disable all special instructions:
+
+```
+./cmake_linux_clang_gcc.sh Release clang++ -DUSE_SSE4_1=OFF -DUSE_SSE4_2=OFF -DUSE_AVX=OFF -DUSE_AVX2=OFF -DUSE_AVX512=OFF -DUSE_LZCNT=OFF -DUSE_TZCNT=OFF -DUSE_F16C=OFF -DUSE_FMADD=OFF
+```
+
+Note that this example is for Linux but the cmake settings work on Windows too.
+
+## Doxygen on Windows
+
+Documentation can be generated through doxygen:
+
+- Install Doxygen (https://www.doxygen.nl/download.html)
+- Run: run_doxygen.bat

package/native/third_party/JoltPhysics/Build/cmake_linux_clang_gcc.sh

@@ -0,0 +1,28 @@
+#!/bin/sh
+
+if [ -z $1 ]
+then
+	BUILD_TYPE=Debug
+else
+	BUILD_TYPE=$1
+	shift
+fi
+
+if [ -z $1 ]
+then
+	COMPILER=clang++
+else
+	COMPILER=$1
+	shift
+fi
+
+BUILD_DIR=Linux_$BUILD_TYPE
+
+echo Usage: ./cmake_linux_clang_gcc.sh [Configuration] [Compiler]
+echo "Possible configurations: Debug (default), Release, Distribution, ReleaseUBSAN, ReleaseASAN, ReleaseTSAN, ReleaseCoverage"
+echo "Possible compilers: clang++, clang++-XX, g++, g++-XX where XX is the version"
+echo Generating Makefile for build type \"$BUILD_TYPE\" and compiler \"$COMPILER\" in folder \"$BUILD_DIR\"
+
+cmake -S . -B $BUILD_DIR -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=$BUILD_TYPE -DCMAKE_CXX_COMPILER=$COMPILER "${@}"
+
+echo Compile by running \"make -j $(nproc) \&\& ./UnitTests\" in folder \"$BUILD_DIR\"

package/native/third_party/JoltPhysics/Build/cmake_linux_emscripten.sh

@@ -0,0 +1,19 @@
+#!/bin/sh
+
+if [ -z $1 ]
+then
+	BUILD_TYPE=Debug
+else
+	BUILD_TYPE=$1
+	shift
+fi
+
+BUILD_DIR=WASM_$BUILD_TYPE
+
+echo Usage: ./cmake_linux_emscripten.sh [Configuration]
+echo "Possible configurations: Debug (default), Release, Distribution"
+echo Generating Makefile for build type \"$BUILD_TYPE\" in folder \"$BUILD_DIR\"
+
+cmake -S . -B $BUILD_DIR -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=$BUILD_TYPE -DCMAKE_TOOLCHAIN_FILE=${EMSDK}/upstream/emscripten/cmake/Modules/Platform/Emscripten.cmake "${@}"
+
+echo Compile by running \"make -j $(nproc) \&\& node UnitTests.js\" in folder \"$BUILD_DIR\"

package/native/third_party/JoltPhysics/Build/cmake_linux_mingw.sh

@@ -0,0 +1,19 @@
+#!/bin/sh
+
+if [ -z $1 ]
+then
+	BUILD_TYPE=Release
+else
+	BUILD_TYPE=$1
+	shift
+fi
+
+BUILD_DIR=MinGW_$BUILD_TYPE
+
+echo Usage: ./cmake_linux_mingw.sh [Configuration]
+echo "Possible configurations: Debug, Release (default), Distribution"
+echo Generating Makefile for build type \"$BUILD_TYPE\" in folder \"$BUILD_DIR\"
+
+cmake -S . -B $BUILD_DIR -DCMAKE_TOOLCHAIN_FILE=mingw-w64-x86_64.cmake -DCMAKE_BUILD_TYPE=$BUILD_TYPE "${@}"
+
+echo Compile by running \"cmake --build $BUILD_DIR -j $(nproc)\"

package/native/third_party/JoltPhysics/Build/cmake_vs2022_cl.bat

@@ -0,0 +1,3 @@
+@echo off
+cmake -S . -B VS2022_CL -G "Visual Studio 17 2022" -A x64 %*
+echo Open VS2022_CL\JoltPhysics.sln to build the project.

package/native/third_party/JoltPhysics/Build/cmake_vs2022_cl_32bit.bat

@@ -0,0 +1,3 @@
+@echo off
+cmake -S . -B VS2022_CL_32BIT -G "Visual Studio 17 2022" -A Win32 -DUSE_SSE4_1=OFF -DUSE_SSE4_2=OFF -DUSE_AVX=OFF -DUSE_AVX2=OFF -DUSE_AVX512=OFF -DUSE_LZCNT=OFF -DUSE_TZCNT=OFF -DUSE_F16C=OFF -DUSE_FMADD=OFF %*
+echo Open VS2022_CL_32BIT\JoltPhysics.sln to build the project.

package/native/third_party/JoltPhysics/Build/cmake_vs2022_cl_arm.bat

@@ -0,0 +1,3 @@
+@echo off
+cmake -S . -B VS2022_CL_ARM -G "Visual Studio 17 2022" -A ARM64 %*
+echo Open VS2022_CL_ARM\JoltPhysics.sln to build the project.

package/native/third_party/JoltPhysics/Build/cmake_vs2022_cl_arm_32bit.bat

@@ -0,0 +1,4 @@
+@echo off
+cmake -S . -B VS2022_CL_ARM_32BIT -G "Visual Studio 17 2022" -A ARM -DCMAKE_SYSTEM_VERSION="10.0.22621.0" -DCMAKE_CXX_COMPILER_WORKS=1 %*
+echo Note that Windows 11 SDK (10.0.22621.0) is the last SDK to support 32-bit ARM, make sure you have it installed.
+echo Open VS2022_CL_ARM_32BIT\JoltPhysics.sln to build the project.

package/native/third_party/JoltPhysics/Build/cmake_vs2022_cl_cross_platform_deterministic.bat

@@ -0,0 +1,3 @@
+@echo off
+cmake -S . -B VS2022_CL_CPD -G "Visual Studio 17 2022" -A x64 -DCROSS_PLATFORM_DETERMINISTIC=ON %*
+echo Open VS2022_CL_CPD\JoltPhysics.sln to build the project.

package/native/third_party/JoltPhysics/Build/cmake_vs2022_cl_double.bat

@@ -0,0 +1,3 @@
+@echo off
+cmake -S . -B VS2022_CL_Double -G "Visual Studio 17 2022" -A x64 -DDOUBLE_PRECISION=ON %*
+echo Open VS2022_CL_Double\JoltPhysics.sln to build the project.

package/native/third_party/JoltPhysics/Build/cmake_vs2022_cl_no_object_stream.bat

@@ -0,0 +1,3 @@
+@echo off
+cmake -S . -B VS2022_CL_NO_OBJ_STR -G "Visual Studio 17 2022" -A x64 -DENABLE_OBJECT_STREAM=OFF %*
+echo Open VS2022_CL_NO_OBJ_STR\JoltPhysics.sln to build the project.

package/native/third_party/JoltPhysics/Build/cmake_vs2022_clang.bat

@@ -0,0 +1,10 @@
+@echo off
+cmake -S . -B VS2022_Clang -G "Visual Studio 17 2022" -A x64 -T ClangCL %*
+echo:
+echo !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+echo Make sure to install:
+echo - C++ Clang Compiler for Windows 12.0.0+
+echo - C++ Clang-cl for v143+ build tools (x64/x86)
+echo Using the Visual Studio Installer
+echo !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+echo Open VS2022_Clang/JoltPhysics.sln to build the project.

package/native/third_party/JoltPhysics/Build/cmake_vs2022_clang_cross_platform_deterministic.bat

@@ -0,0 +1,10 @@
+@echo off
+cmake -S . -B VS2022_Clang_CPD -G "Visual Studio 17 2022" -A x64 -T ClangCL -DCROSS_PLATFORM_DETERMINISTIC=ON %*
+echo:
+echo !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+echo Make sure to install:
+echo - C++ Clang Compiler for Windows 12.0.0+
+echo - C++ Clang-cl for v143+ build tools (x64/x86)
+echo Using the Visual Studio Installer
+echo !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+echo Open VS2022_Clang_CPD/JoltPhysics.sln to build the project.

package/native/third_party/JoltPhysics/Build/cmake_vs2022_clang_double.bat

@@ -0,0 +1,10 @@
+@echo off
+cmake -S . -B VS2022_Clang_Double -G "Visual Studio 17 2022" -A x64 -T ClangCL -DDOUBLE_PRECISION=YES %*
+echo:
+echo !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+echo Make sure to install:
+echo - C++ Clang Compiler for Windows 12.0.0+
+echo - C++ Clang-cl for v143+ build tools (x64/x86)
+echo Using the Visual Studio Installer
+echo !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+echo Open VS2022_Clang_Double/JoltPhysics.sln to build the project.

package/native/third_party/JoltPhysics/Build/cmake_vs2022_uwp.bat

@@ -0,0 +1,5 @@
+@echo off
+cmake -S . -B VS2022_UWP -G "Visual Studio 17 2022" -DCMAKE_SYSTEM_NAME=WindowsStore -DCMAKE_SYSTEM_VERSION=10.0 %*
+echo If cmake failed then be sure to check the "Universal Windows Platform development" checkbox in the Visual Studio Installer
+echo Open VS2022_UWP\JoltPhysics.sln to build the project.
+echo Note that none of the sample applications are available for the Universal Windows Platform (use cmake_vs2022_cl.bat instead).

package/native/third_party/JoltPhysics/Build/cmake_vs2022_uwp_arm.bat

@@ -0,0 +1,5 @@
+@echo off
+cmake -S . -B VS2022_UWP_ARM -G "Visual Studio 17 2022" -A ARM64 -DCMAKE_SYSTEM_NAME=WindowsStore -DCMAKE_SYSTEM_VERSION=10.0 %*
+echo If cmake failed then be sure to check the "Universal Windows Platform development" checkbox in the Visual Studio Installer
+echo Open VS2022_UWP_ARM\JoltPhysics.sln to build the project.
+echo Note that none of the sample applications are available for the Universal Windows Platform (use cmake_vs2022_cl_arm.bat instead).

package/native/third_party/JoltPhysics/Build/cmake_vs2026_cl.bat

@@ -0,0 +1,3 @@
+@echo off
+cmake -S . -B VS2026_CL -G "Visual Studio 18 2026" -A x64 %*
+echo Open VS2026_CL\JoltPhysics.slnx to build the project.

package/native/third_party/JoltPhysics/Build/cmake_vs2026_cl_cross_platform_deterministic.bat

@@ -0,0 +1,3 @@
+@echo off
+cmake -S . -B VS2026_CL_CPD -G "Visual Studio 18 2026" -A x64 -DCROSS_PLATFORM_DETERMINISTIC=ON %*
+echo Open VS2026_CL_CPD\JoltPhysics.sln to build the project.

package/native/third_party/JoltPhysics/Build/cmake_vs2026_cl_double.bat

@@ -0,0 +1,3 @@
+@echo off
+cmake -S . -B VS2026_CL_Double -G "Visual Studio 18 2026" -A x64 -DDOUBLE_PRECISION=ON %*
+echo Open VS2026_CL_Double\JoltPhysics.slnx to build the project.

package/native/third_party/JoltPhysics/Build/cmake_vs2026_clang.bat

@@ -0,0 +1,10 @@
+@echo off
+cmake -S . -B VS2026_Clang -G "Visual Studio 18 2026" -A x64 -T ClangCL %*
+echo:
+echo !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+echo Make sure to install:
+echo - C++ Clang Compiler for Windows 20+
+echo - MSBuild support for LLVM (clang-cl) toolset
+echo Using the Visual Studio Installer
+echo !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+echo Open VS2026_Clang/JoltPhysics.sln to build the project.

package/native/third_party/JoltPhysics/Build/cmake_vs2026_clang_cross_platform_deterministic.bat

@@ -0,0 +1,10 @@
+@echo off
+cmake -S . -B VS2026_Clang_CPD -G "Visual Studio 18 2026" -A x64 -T ClangCL -DCROSS_PLATFORM_DETERMINISTIC=ON %*
+echo:
+echo !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+echo Make sure to install:
+echo - C++ Clang Compiler for Windows 20+
+echo - MSBuild support for LLVM (clang-cl) toolset
+echo Using the Visual Studio Installer
+echo !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+echo Open VS2026_Clang_CPD/JoltPhysics.sln to build the project.

package/native/third_party/JoltPhysics/Build/cmake_vs2026_clang_double.bat

@@ -0,0 +1,10 @@
+@echo off
+cmake -S . -B VS2026_Clang_Double -G "Visual Studio 18 2026" -A x64 -T ClangCL -DDOUBLE_PRECISION=YES %*
+echo:
+echo !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+echo Make sure to install:
+echo - C++ Clang Compiler for Windows 20+
+echo - MSBuild support for LLVM (clang-cl) toolset
+echo Using the Visual Studio Installer
+echo !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+echo Open VS2026_Clang_Double/JoltPhysics.sln to build the project.

package/native/third_party/JoltPhysics/Build/cmake_windows_mingw.sh

@@ -0,0 +1,19 @@
+#!/bin/sh
+
+if [ -z $1 ]
+then
+	BUILD_TYPE=Debug
+else
+	BUILD_TYPE=$1
+	shift
+fi
+
+BUILD_DIR=MinGW_$BUILD_TYPE
+
+echo Usage: ./cmake_windows_mingw.sh [Configuration]
+echo "Possible configurations: Debug (default), Release, Distribution"
+echo Generating Makefile for build type \"$BUILD_TYPE\" in folder \"$BUILD_DIR\"
+
+cmake -S . -B $BUILD_DIR -G "MinGW Makefiles" -DCMAKE_BUILD_TYPE=$BUILD_TYPE "${@}"
+
+echo Compile by running \"cmake --build $BUILD_DIR -j $(nproc)\"

package/native/third_party/JoltPhysics/Build/cmake_xcode_ios.sh

@@ -0,0 +1,4 @@
+#!/bin/sh
+
+cmake -S . -B XCode_iOS -DTARGET_HELLO_WORLD=OFF -DTARGET_PERFORMANCE_TEST=OFF -DCMAKE_SYSTEM_NAME=iOS -GXcode
+open XCode_iOS/JoltPhysics.xcodeproj

package/native/third_party/JoltPhysics/Build/cmake_xcode_macos.sh

@@ -0,0 +1,4 @@
+#!/bin/sh
+
+cmake -S . -B XCode_MacOS -GXcode -D"CMAKE_OSX_ARCHITECTURES=x86_64;arm64"
+open XCode_MacOS/JoltPhysics.xcodeproj

package/native/third_party/JoltPhysics/Build/iOS/JoltViewerInfo.plist

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>English</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleGetInfoString</key>
+	<string></string>
+	<key>CFBundleIconFile</key>
+	<string>icon.icns</string>
+	<key>CFBundleIdentifier</key>
+	<string>com.joltphysics.joltviewer</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleLongVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleName</key>
+	<string>JoltViewer</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleVersion</key>
+	<string>1.0</string>
+	<key>CSResourcesFileMapped</key>
+	<true/>
+	<key>NSHumanReadableCopyright</key>
+	<string></string>
+</dict>
+</plist>

package/native/third_party/JoltPhysics/Build/iOS/SamplesInfo.plist

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>English</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleGetInfoString</key>
+	<string></string>
+	<key>CFBundleIconFile</key>
+	<string>icon.icns</string>
+	<key>CFBundleIdentifier</key>
+	<string>com.joltphysics.samples</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleLongVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleName</key>
+	<string>Samples</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleVersion</key>
+	<string>1.0</string>
+	<key>CSResourcesFileMapped</key>
+	<true/>
+	<key>NSHumanReadableCopyright</key>
+	<string></string>
+</dict>
+</plist>

package/native/third_party/JoltPhysics/Build/iOS/UnitTestsInfo.plist

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>English</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleGetInfoString</key>
+	<string></string>
+	<key>CFBundleIconFile</key>
+	<string></string>
+	<key>CFBundleIdentifier</key>
+	<string>com.joltphysics.unittests</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleLongVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleName</key>
+	<string>UnitTests</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleVersion</key>
+	<string>1.0</string>
+	<key>CSResourcesFileMapped</key>
+	<true/>
+	<key>NSHumanReadableCopyright</key>
+	<string></string>
+</dict>
+</plist>

package/native/third_party/JoltPhysics/Build/macos_install_vulkan_sdk.sh

@@ -0,0 +1,13 @@
+set -e
+if [ -z $1 ] 
+then
+	echo "Need to specify installation diretory"
+	exit
+fi
+
+VULKAN_TEMP=/tmp/vulkan_sdk_install
+mkdir ${VULKAN_TEMP}
+curl -L -o ${VULKAN_TEMP}/vulkan_sdk.dmg https://sdk.lunarg.com/sdk/download/latest/mac/vulkan_sdk.dmg?Human=true
+unzip ${VULKAN_TEMP}/vulkan_sdk.dmg -d ${VULKAN_TEMP}
+${VULKAN_TEMP}/vulkansdk-macOS*.app/Contents/MacOS/vulkansdk-macOS* --root $1 --accept-licenses --default-answer --confirm-command install
+rm -rf ${VULKAN_TEMP}

package/native/third_party/JoltPhysics/Build/ubuntu24_install_vulkan_sdk.sh

@@ -0,0 +1,4 @@
+wget -qO- https://packages.lunarg.com/lunarg-signing-key-pub.asc | sudo tee /etc/apt/trusted.gpg.d/lunarg.asc
+sudo wget -qO /etc/apt/sources.list.d/lunarg-vulkan-noble.list http://packages.lunarg.com/vulkan/lunarg-vulkan-noble.list
+sudo apt update
+sudo apt install vulkan-sdk