godotengine/godot
1
0
Fork 0
mirror of https://github.com/godotengine/godot.git synced 2025-11-04 12:00:25 +00:00
Code Releases Wiki Activity
Files
c77cbf096b15d3828768c78a0a1b573c748f9219
godot/thirdparty
History
Matias N. Goldberg c77cbf096b Improvements from TheForge (see description) 
The work was performed by collaboration of TheForge and Google. I am
merely splitting it up into smaller PRs and cleaning it up.

This is the most "risky" PR so far because the previous ones have been
miscellaneous stuff aimed at either [improve
debugging](https://github.com/godotengine/godot/pull/90993) (e.g. device
lost), [improve Android
experience](https://github.com/godotengine/godot/pull/96439) (add Swappy
for better Frame Pacing + Pre-Transformed Swapchains for slightly better
performance), or harmless [ASTC
improvements](https://github.com/godotengine/godot/pull/96045) (better
performance by simply toggling a feature when available).

However this PR contains larger modifications aimed at improving
performance or reducing memory fragmentation. With greater
modifications, come greater risks of bugs or breakage.

Changes introduced by this PR:

TBDR GPUs (e.g. most of Android + iOS + M1 Apple) support rendering to
Render Targets that are not backed by actual GPU memory (everything
stays in cache). This works as long as load action isn't `LOAD`, and
store action must be `DONT_CARE`. This saves VRAM (it also makes
painfully obvious when a mistake introduces a performance regression).
Of particular usefulness is when doing MSAA and keeping the raw MSAA
content is not necessary.

Some GPUs get faster when the sampler settings are hard-coded into the
GLSL shaders (instead of being dynamically bound at runtime). This
required changes to the GLSL shaders, PSO creation routines, Descriptor
creation routines, and Descriptor binding routines.

 - `bool immutable_samplers_enabled = true`

Setting it to false enforces the old behavior. Useful for debugging bugs
and regressions.

Immutable samplers requires that the samplers stay... immutable, hence
this boolean is useful if the promise gets broken. We might want to turn
this into a `GLOBAL_DEF` setting.

Instead of creating dozen/hundreds/thousands of `VkDescriptorSet` every
frame that need to be freed individually when they are no longer needed,
they all get freed at once by resetting the whole pool. Once the whole
pool is no longer in use by the GPU, it gets reset and its memory
recycled. Descriptor sets that are created to be kept around for longer
or forever (i.e. not created and freed within the same frame) **must
not** use linear pools. There may be more than one pool per frame. How
many pools per frame Godot ends up with depends on its capacity, and
that is controlled by
`rendering/rendering_device/vulkan/max_descriptors_per_pool`.

- **Possible improvement for later:** It should be possible for Godot
to adapt to how many descriptors per pool are needed on a per-key basis
(i.e. grow their capacity like `std::vector` does) after rendering a few
frames; which would be better than the current solution of having a
single global value for all pools (`max_descriptors_per_pool`) that the
user needs to tweak.

 - `bool linear_descriptor_pools_enabled = true`

Setting it to false enforces the old behavior. Useful for debugging bugs
and regressions.
Setting it to false is required when workarounding driver bugs (e.g.
Adreno 730).

A ridiculous optimization. Ridiculous because the original code
should've done this in the first place. Previously Godot was doing the
following:

  1. Create a command buffer **pool**. One per frame.
  2. Create multiple command buffers from the pool in point 1.
3. Call `vkBeginCommandBuffer` on the cmd buffer in point 2. This
resets the cmd buffer because Godot requests the
`VK_COMMAND_POOL_CREATE_RESET_COMMAND_BUFFER_BIT` flag.
  4. Add commands to the cmd buffers from point 2.
  5. Submit those commands.
6. On frame N + 2, recycle the buffer pool and cmd buffers from pt 1 &
2, and repeat from step 3.

The problem here is that step 3 resets each command buffer individually.
Initially Godot used to have 1 cmd buffer per pool, thus the impact is
very low.

But not anymore (specially with Adreno workarounds to force splitting
compute dispatches into a new cmd buffer, more on this later). However
Godot keeps around a very low amount of command buffers per frame.

The recommended method is to reset the whole pool, to reset all cmd
buffers at once. Hence the new steps would be:

  1. Create a command buffer **pool**. One per frame.
  2. Create multiple command buffers from the pool in point 1.
3. Call `vkBeginCommandBuffer` on the cmd buffer in point 2, which is
already reset/empty (see step 6).
  4. Add commands to the cmd buffers from point 2.
  5. Submit those commands.
6. On frame N + 2, recycle the buffer pool and cmd buffers from pt 1 &
2, call `vkResetCommandPool` and repeat from step 3.

**Possible issues:** @dariosamo added `transfer_worker` which creates a
command buffer pool:

```cpp
transfer_worker->command_pool =
driver->command_pool_create(transfer_queue_family,
RDD::COMMAND_BUFFER_TYPE_PRIMARY);
```

As expected, validation was complaining that command buffers were being
reused without being reset (that's good, we now know Validation Layers
will warn us of wrong use).
I fixed it by adding:

```cpp
void RenderingDevice::_wait_for_transfer_worker(TransferWorker
*p_transfer_worker) {
	driver->fence_wait(p_transfer_worker->command_fence);
	driver->command_pool_reset(p_transfer_worker->command_pool); //
! New line !
```

**Secondary cmd buffers are subject to the same issue but I didn't alter
them. I talked this with Dario and he is aware of this.**
Secondary cmd buffers are currently disabled due to other issues (it's
disabled on master).

 - `bool RenderingDeviceCommons::command_pool_reset_enabled`

Setting it to false enforces the old behavior. Useful for debugging bugs
and regressions.

There's no other reason for this boolean. Possibly once it becomes well
tested, the boolean could be removed entirely.

Adds `command_bind_render_uniform_sets` and
`add_draw_list_bind_uniform_sets` (+ compute variants).

It performs the same as `add_draw_list_bind_uniform_set` (notice
singular vs plural), but on multiple consecutive uniform sets, thus
reducing graph and draw call overhead.

 - `bool descriptor_set_batching = true;`

Setting it to false enforces the old behavior. Useful for debugging bugs
and regressions.

There's no other reason for this boolean. Possibly once it becomes well
tested, the boolean could be removed entirely.

Godot currently does the following:

 1. Fill the entire cmd buffer with commands.
 2. `submit()`
    - Wait with a semaphore for the swapchain.
- Trigger a semaphore to indicate when we're done (so the swapchain
can submit).
 3. `present()`

The optimization opportunity here is that 95% of Godot's rendering is
done offscreen.
Then a fullscreen pass copies everything to the swapchain. Godot doesn't
practically render directly to the swapchain.

The problem with this is that the GPU has to wait for the swapchain to
be released **to start anything**, when we could start *much earlier*.
Only the final blit pass must wait for the swapchain.

TheForge changed it to the following (more complicated, I'm simplifying
the idea):

 1. Fill the entire cmd buffer with commands.
 2. In `screen_prepare_for_drawing` do `submit()`
    - There are no semaphore waits for the swapchain.
    - Trigger a semaphore to indicate when we're done.
3. Fill a new cmd buffer that only does the final blit to the
swapchain.
 4. `submit()`
    - Wait with a semaphore for the submit() from step 2.
- Wait with a semaphore for the swapchain (so the swapchain can
submit).
- Trigger a semaphore to indicate when we're done (so the swapchain
can submit).
 5. `present()`

Dario discovered this problem independently while working on a different
platform.

**However TheForge's solution had to be rewritten from scratch:** The
complexity to achieve the solution was high and quite difficult to
maintain with the way Godot works now (after Übershaders PR).
But on the other hand, re-implementing the solution became much simpler
because Dario already had to do something similar: To fix an Adreno 730
driver bug, he had to implement splitting command buffers. **This is
exactly what we need!**. Thus it was re-written using this existing
functionality for a new purpose.

To achieve this, I added a new argument, `bool p_split_cmd_buffer`, to
`RenderingDeviceGraph::add_draw_list_begin`, which is only set to true
by `RenderingDevice::draw_list_begin_for_screen`.

The graph will split the draw list into its own command buffer.

 - `bool split_swapchain_into_its_own_cmd_buffer = true;`

Setting it to false enforces the old behavior. This might be necessary
for consoles which follow an alternate solution to the same problem.
If not, then we should consider removing it.

PR #90993 added `shader_destroy_modules()` but it was not actually in
use.

This PR adds several places where `shader_destroy_modules()` is called
after initialization to free up memory of SPIR-V structures that are no
longer needed.
2024-12-09 11:49:28 -03:00
..
amd-fsr
…
amd-fsr2
Acyclic Command Graph for RenderingDevice.
2024-01-08 14:54:56 -03:00
angle
[macOS/Windows] Add optional ANGLE backed OpenGL renderer support. Add EGL_ANDROID_blob_cache caching.
2023-09-21 14:21:00 +03:00
astcenc
astcenc: Update to 4.8.0
2024-05-14 12:51:49 +02:00
basis_universal
BasisU: Update to 1.50.0 and add HDR support
2024-10-12 18:02:44 +02:00
betsy
Add Betsy to speed up BC6 compression
2024-08-18 11:14:05 +02:00
brotli
brotli: Sync with upstream 1.1.0
2023-09-30 12:52:40 +02:00
certs
certs: Sync with Mozilla bundle as of Oct 19, 2024
2024-11-05 20:42:42 +01:00
clipper2
clipper2: Update to 1.4.0
2024-11-26 17:23:06 +01:00
cvtt
Cleanup various repository documentation files
2023-10-10 13:58:13 +02:00
d3d12ma
Split RenderingDevice into API-agnostic and RenderingDeviceDriver parts
2023-12-20 19:18:08 +01:00
directx_headers
[Windows] Make D3D12 loading dynamic to support pre Windows 10 versions.
2024-02-19 15:08:04 +02:00
doctest
doctest: Update to 2.4.11
2023-05-11 14:24:23 +02:00
embree
embree: Fix include order causing unwanted dllexport symbols
2024-07-12 17:57:02 +08:00
enet
[ENet] Better handle disconnected peers in DTLS server
2024-08-02 16:07:37 +02:00
etcpak
[etcpak] Sync with upstream
2024-02-05 18:53:35 +01:00
fonts
Change default Arabic font to Vazirmatn.
2024-12-05 16:26:52 +02:00
freetype
FreeType: Update to version 2.13.2
2023-08-29 10:42:26 +02:00
glad
EGL: Use EGL_EXT_platform_base whenever possible
2024-06-04 08:43:34 +02:00
glslang
fix building glslang on platforms without <filesystem>
2024-06-06 01:54:54 +02:00
graphite
graphite: Update to latest Git, switch to MIT license
2022-12-13 10:06:00 +01:00
harfbuzz
Update HarfBuzz to 10.0.1
2024-10-01 08:20:45 +03:00
icu4c
Update ICU to 76.1
2024-10-24 22:47:59 +03:00
jpeg-compressor
Implement Running Godot as Movie Writer
2022-06-21 11:28:47 +02:00
libbacktrace
[Windows] Enable crash reporter on MinGW builds, use libbacktrace to generate stack trace from DWARF symbols.
2024-04-22 16:19:37 +03:00
libktx
libktx: Update to 4.3.2
2024-04-05 12:18:00 +02:00
libogg
…
libpng
libpng: Update to 1.6.43
2024-03-09 15:10:17 +01:00
libtheora
Update libtheora to GIT (2020.10)
2022-10-18 21:15:13 -03:00
libvorbis
…
libwebp
Add support for compiling with VS clang-cl toolset
2024-08-28 13:30:44 -05:00
linuxbsd_headers
Make Godot compile on FreeBSD
2024-12-05 12:33:55 -04:00
manifold
Print better manifold errors and avoid crash on non manifold csg input.
2024-12-03 20:19:47 -08:00
mbedtls
Delete unused files of thirparty libs (zlib, mbedtls)
2024-11-07 18:54:57 +02:00
meshoptimizer
Update meshoptimizer to 0.22
2024-10-26 07:26:07 -07:00
mingw-std-threads
Avoid conflict between mingw-std-threads and Clang's own
2023-11-22 14:56:38 +01:00
minimp3
Revert "minimp3: Add a .cpp file to simplify building the single-header implementation"
2023-06-19 13:34:56 +02:00
miniupnpc
Fix broken includes when compiling with builtin_miniupnpc=false
2024-11-27 15:37:54 +00:00
minizip
zlib/minizip: Update to version 1.3.1
2024-01-24 11:32:38 +01:00
misc
Use qoa.c and custom compress procedure
2024-12-05 13:20:09 -03:00
msdfgen
Update ICU and msdfgen.
2024-03-13 09:12:50 +02:00
noise
FastNoiseLite: Sync with 1.1.0, clean up SCsub
2024-02-19 01:03:38 +01:00
nvapi
Disable NVIDIA's threaded optimization on Windows
2023-06-13 11:47:40 +02:00
openxr
Patch the OpenXR headers to get EGL from GLAD if we're using it
2024-11-04 10:43:07 -06:00
pcre2
pcre2: Remove unused sjlit files after last update
2024-03-15 09:38:45 +01:00
recastnavigation
recast: Update to upstream version 1.6.0
2023-05-22 14:47:42 +02:00
rvo2
Revert "Update RVO2 to git 2022.09"
2023-06-29 12:50:49 +02:00
spirv-cross
Add Metal support for macOS (arm64) and iOS
2024-08-20 12:11:06 +02:00
spirv-reflect
Report shader arrays sized after spec constants as zero-sized
2024-07-31 20:07:53 +02:00
swappy-frame-pacing
Add Swappy & Pre-Transformed Swapchain
2024-10-28 18:55:37 -03:00
thorvg
thorvg: Update to 0.15.5
2024-12-04 17:24:43 +01:00
tinyexr
tinyexr: Update to 1.0.8
2024-02-23 12:17:27 +01:00
ufbx
ufbx: Update to upstream 0.15.0
2024-12-04 02:19:04 +01:00
vhacd
Add missing stdint.h includes for GCC 13+
2023-06-07 11:36:55 +02:00
volk
vulkan: Update all components to Vulkan SDK 1.3.183.0
2024-06-03 10:25:46 +02:00
vulkan
Improvements from TheForge (see description)
2024-12-09 11:49:28 -03:00
wayland
wayland: Update to 1.22.0
2024-02-06 10:23:42 +01:00
wayland-protocols
Implement DisplayServer.beep.
2024-12-03 12:43:26 +02:00
wslay
wslay: Sync with upstream 0e7d106ff
2023-05-22 14:42:26 +02:00
xatlas
xatlas: Sync with upstream 16ace528a
2022-05-17 23:03:23 +02:00
zlib
Delete unused files of thirparty libs (zlib, mbedtls)
2024-11-07 18:54:57 +02:00
zstd
zstd: Update to upstream version 1.5.6
2024-04-05 11:22:55 +02:00
README.md
Merge pull request #99959 from fire/vsk-csg-error-and-ctd
2024-12-05 14:12:25 -06:00

README.md

Third party libraries

Please keep categories (## level) listed alphabetically and matching their respective folder names. Use two empty lines to separate categories for readability.

amd-fsr

Files extracted from upstream source:

  • ffx_a.h and ffx_fsr1.h from ffx-fsr
  • license.txt

amd-fsr2

Files extracted from upstream source:

  • ffx_*.cpp and ffx_*.h from src/ffx-fsr2-api
  • shaders folder from src/ffx-fsr2-api with ffx_*.hlsl files excluded
  • LICENSE.txt

Apply patches to add the new options required by Godot and general compilation fixes.

angle

Files extracted from upstream source:

  • include/*
  • LICENSE

astcenc

Files extracted from upstream source:

  • astcenc_* and astcenc.h files from Source
  • LICENSE.txt

basis_universal

Files extracted from upstream source:

  • encoder/ and transcoder/ folders, with the following files removed from encoder: jpgd.{cpp,h}, 3rdparty/{qoi.h,tinydds.h,tinyexr.cpp,tinyexr.h}
  • LICENSE

Applied upstream PR https://github.com/BinomialLLC/basis_universal/pull/344 to fix build with our own copy of zstd (patch in patches).

betsy

Files extracted from upstream source:

  • bc6h.glsl, bc1.glsl, bc4.glsl, CrossPlatformSettings_piece_all.glsl and UavCrossPlatform_piece_all.glsl.
  • LICENSE.md

brotli

Files extracted from upstream source:

  • common/, dec/ and include/ folders from c/, minus the dictionary.bin* files
  • LICENSE

certs

  • Upstream: Mozilla, via https://github.com/bagder/ca-bundle
  • Version: git (4d3fe6683f651d96be1bbef316b201e9b33b274d, 2024), generated from mozilla-release changeset b8ea2342548b8571e58f9176d9555ccdb5ec199f
  • License: MPL 2.0

Files extracted from upstream source:

  • ca-bundle.crt renamed to ca-certificates.crt

clipper2

Files extracted from upstream source:

  • CPP/Clipper2Lib/ folder (in root)
  • LICENSE

Apply the patches in the patches/ folder when syncing on newer upstream commits.

cvtt

Files extracted from upstream source:

  • All .cpp and .h files except the folders MakeTables and etc2packer
  • LICENSE.txt

Changes related to BC6H packing and unpacking made upstream in 2e4b6b2747 have been removed as they caused massive quality regressions. Apply the patches in the patches/ folder when syncing on newer upstream commits.

d3d12ma

Files extracted from upstream source:

  • src/D3D12MemAlloc.cpp, src/D3D12MemAlloc.natvis
  • include/D3D12MemAlloc.h
  • LICENSE.txt, NOTICES.txt

Important: Some files have Godot-made changes for use with MinGW. They are marked with /* GODOT start */ and /* GODOT end */ comments.

directx_headers

Files extracted from upstream source:

  • include/directx/*.h
  • include/dxguids/*.h
  • LICENSE

Important: Some files have Godot-made changes for use with MinGW. They are marked with /* GODOT start */ and /* GODOT end */ comments.

doctest

Files extracted from upstream source:

  • doctest/doctest.h as doctest.h
  • LICENSE.txt

embree

Files extracted from upstream:

  • All .cpp files listed in modules/raycast/godot_update_embree.py
  • All header files in the directories listed in modules/raycast/godot_update_embree.py
  • All config files listed in modules/raycast/godot_update_embree.py
  • LICENSE.txt

The modules/raycast/godot_update_embree.py script can be used to pull the relevant files from the latest Embree release and apply some automatic changes.

Some changes have been made in order to remove exceptions and fix minor build errors. They are marked with // -- GODOT start -- and // -- GODOT end -- comments. Apply the patches in the patches/ folder when syncing on newer upstream commits.

enet

Files extracted from upstream source:

  • All .c files in the main directory (except unix.c and win32.c)
  • The include/enet/ folder as enet/ (except unix.h and win32.h)
  • LICENSE file

Important: enet.h, host.c, protocol.c have been slightly modified to be usable by Godot's socket implementation and allow IPv6 and DTLS. Apply the patches in the patches/ folder when syncing on newer upstream commits.

Three files (godot.cpp, enet/godot.h, enet/godot_ext.h) have been added to provide ENet socket implementation using Godot classes.

It is still possible to build against a system wide ENet but doing so will limit its functionality to IPv4 only.

etcpak

Files extracted from upstream source:

  • Only the files relevant for compression (i.e. Process*.cpp and their deps): 
    Dither.{cpp,hpp} ForceInline.hpp Math.hpp ProcessCommon.hpp ProcessRGB.{cpp,hpp}
ProcessDxtc.{cpp,hpp} Tables.{cpp,hpp} Vector.hpp
  • AUTHORS.txt and LICENSE.txt

fonts

All fonts are converted from the unhinted .ttf sources using the https://github.com/google/woff2 tool.

Use UI font variant if available, because it has tight vertical metrics and good for UI.

freetype

  • Upstream: https://www.freetype.org
  • Version: 2.13.2 (920c5502cc3ddda88f6c7d85ee834ac611bb11cc, 2023)
  • License: FreeType License (BSD-like)

Files extracted from upstream source:

  • src/ folder, minus the dlg and tools subfolders
    • These files can be removed: .dat, .diff, .mk, .rc, README*
    • In src/gzip/, keep only ftgzip.c
  • include/ folder, minus the dlg subfolder
  • LICENSE.TXT and docs/FTL.TXT

glad

Files extracted from upstream source:

  • LICENSE

Files generated from upstream web instance:

  • EGL/eglplatform.h
  • KHR/khrplatform.h
  • egl.c
  • glad/egl.h
  • gl.c
  • glad/gl.h
  • glx.c
  • glad/glx.h

See the permalinks in glad/gl.h and glad/glx.h to regenrate the files with a new version of the web instance.

Some changes have been made in order to allow loading OpenGL and OpenGLES APIs at the same time. See the patches in the patches directory.

glslang

Version should be kept in sync with the one of the used Vulkan SDK (see vulkan section).

Files extracted from upstream source:

  • glslang/ folder (except the glslang/HLSL and glslang/ExtensionHeaders subfolders), SPIRV/ folder
    • Remove C interface code: CInterface/ folders, files matching "*_c[_\.]*"
  • Run cmake . && make and copy generated include/glslang/build_info.h to glslang/build_info.h
  • LICENSE.txt
  • Unnecessary files like CMakeLists.txt or updateGrammar removed

graphite

Files extracted from upstream source:

  • The include folder
  • The src folder (minus CMakeLists.txt and files.mk)
  • COPYING

harfbuzz

Files extracted from upstream source:

  • AUTHORS, COPYING, THANKS
  • From the src folder, recursively:
    • All the .cc, .h, .hh files
    • Except main.cc, harfbuzz*.cc, failing-alloc.c, test*.cc, hb-wasm*.*

icu4c

Files extracted from upstream source:

  • The common folder
  • scriptset.*, ucln_in.*, uspoof.cpp" and uspoof_impl.cpp from the i18n folder
  • uspoof.h from the i18n/unicode folder
  • LICENSE

Files generated from upstream source:

  1. Download and extract both icu4c-{version}-src.tgz and icu4c-{version}-data.zip (replace data subfolder from the main source archive)
  2. Build ICU with default options: ./runConfigureICU {PLATFORM} && make
  3. Reconfigure ICU with custom data config: ICU_DATA_FILTER_FILE={GODOT_SOURCE}/thirdparty/icu4c/godot_data.json ./runConfigureICU {PLATFORM} --with-data-packaging=common
  4. Delete data/out folder and rebuild data: cd data && rm -rf ./out && make
  5. Copy source/data/out/icudt76l.dat to the {GODOT_SOURCE}/thirdparty/icu4c/icudt76l.dat

jpeg-compressor

Files extracted from upstream source:

  • jpgd*.{c,h}
  • jpge*.{c,h}

libbacktrace

Files extracted from upstream source:

  • *.{c,h} files for Windows platform
  • LICENSE

libktx

Files extracted from upstream source:

  • LICENSE.md
  • include/
  • lib/dfdutils/LICENSE.adoc as LICENSE.dfdutils.adoc (in root)
  • lib/dfdutils/LICENSES/Apache-2.0.txt as Apache-2.0.txt (in root)
  • lib/dfdutils/{KHR/,dfd.h,colourspaces.c,createdfd.c,interpretdfd.c,printdfd.c,queries.c,dfd2vk.inl,vk2dfd.*}
  • lib/{basis_sgd.h,formatsize.h,gl_format.h,ktxint.h,uthash.h,vk_format.h,vkformat_enum.h,checkheader.c,swap.c,hashlist.c,vkformat_check.c,vkformat_typesize.c,basis_transcode.cpp,miniz_wrapper.cpp,filestream.*,memstream.*,texture*}
  • other_include/KHR/
  • utils/unused.h

Some Godot-specific changes are applied via patches included in the patches folder.

libogg

  • Upstream: https://www.xiph.org/ogg
  • Version: 1.3.5 (e1774cd77f471443541596e09078e78fdc342e4f, 2021)
  • License: BSD-3-Clause

Files extracted from upstream source:

  • src/*.{c,h}
  • include/ogg/*.h in ogg/ (run configure to generate config_types.h)
  • COPYING

libpng

Files extracted from upstream source:

  • All .c and .h files of the main directory, apart from example.c and pngtest.c
  • arm/, intel/ and powerpc/ folders
  • scripts/pnglibconf.h.prebuilt as pnglibconf.h
  • LICENSE

libtheora

  • Upstream: https://www.theora.org
  • Version: git (7180717276af1ebc7da15c83162d6c5d6203aabf, 2020)
  • License: BSD-3-Clause

Files extracted from upstream source:

  • All .c and .h files in lib/, except arm/ and c64x/ folders
  • All .h files in include/theora/ as theora/
  • COPYING and LICENSE

libvorbis

Files extracted from upstream source:

  • lib/* except from: lookups.pl, Makefile.*
  • include/vorbis/*.h as vorbis/
  • COPYING

libwebp

Files extracted from upstream source:

  • src/ and sharpyuv/ except from .am, .rc and .in files
  • AUTHORS, COPYING, PATENTS

Patch godot-node-debug-fix.patch workarounds shadowing of Godot's Node class in the MSVC debugger.

manifold

File extracted from upstream source:

  • src/
  • AUTHORS, LICENSE

mbedtls

File extracted from upstream release tarball:

  • All .h from include/mbedtls/ to thirdparty/mbedtls/include/mbedtls/ and all .h from include/psa/ to thirdparty/mbedtls/include/psa/
  • All .c and .h from library/ to thirdparty/mbedtls/library/
  • From library/ to thirdparty/mbedtls/library/:
    • All .c and .h files
    • Except bignum_mod.c, block_cipher.c, ecp_curves_new.c, lmots.c, lms.c
  • The LICENSE file (edited to keep only the Apache 2.0 variant)
  • Applied the patch msvc-redeclaration-bug.diff to fix a compilation error with some MSVC versions
  • Added 2 files godot_core_mbedtls_platform.c and godot_core_mbedtls_config.h providing configuration for light bundling with core
  • Added the file godot_module_mbedtls_config.h to customize the build configuration when bundling the full library

meshoptimizer

Files extracted from upstream repository:

  • All files in src/
  • LICENSE.md

A patch is included to modify the simplifier to report only distance error metrics instead of a combination of distance and attribute errors.

mingw-std-threads

Files extracted from upstream repository:

  • LICENSE
  • mingw.condition_variable.h
  • mingw.invoke.h
  • mingw.mutex.h
  • mingw.shared_mutex.h
  • mingw.thread.h

Once copied, apply godot.patch (needed because Godot is built without exceptions and to avoid std:: replacements leak in Clang builds).

minimp3

Files extracted from upstream repository:

  • minimp3.h
  • minimp3_ex.h
  • LICENSE

Some changes have been made in order to fix Windows on ARM build errors, and to solve some MSVC warnings. See the patches in the patches directory.

miniupnpc

Files extracted from upstream source:

  • miniupnpc/src/ as src/
  • miniupnpc/include/ as include/miniupnpc/
  • Remove the following test or sample files: listdevices.c,minihttptestserver.c,miniupnpcmodule.c,upnpc.c,upnperrors.*,test*
  • LICENSE

The only modified file is src/miniupnpcstrings.h, which was created for Godot (it is usually autogenerated by cmake). Bump the version number for miniupnpc in that file when upgrading.

minizip

Files extracted from the upstream source:

  • From contrib/minizip: {crypt.h,ioapi.{c,h},unzip.{c,h},zip.{c,h}} MiniZip64_info.txt

Important: Some files have Godot-made changes for use in core/io. They are marked with /* GODOT start */ and /* GODOT end */ comments and a patch is provided in the patches folder.

misc

Collection of single-file libraries used in Godot components.

msdfgen

Files extracted from the upstream source:

  • msdfgen.h
  • Files in core/ folder
  • LICENSE.txt

noise

Files extracted from the upstream source:

  • FastNoiseLite.h
  • LICENSE

Some custom changes were made to fix compiler warnings, and can be re-applied with the provided patch.

nvapi

openxr

Files extracted from upstream source:

  • include/
  • src/common/
  • src/loader/
  • src/*.{c,h}
  • src/external/jsoncpp/include/
  • src/external/jsoncpp/src/lib_json/
  • src/external/jsoncpp/{AUTHORS,LICENSE}
  • LICENSE and COPYING.adoc

Exclude:

  • src/external/android-jni-wrappers and src/external/jnipp (not used yet)
  • Obsolete src/xr_generated_dispatch_table.{c,h}
  • All CMake stuff: cmake/, CMakeLists.txt and *.cmake
  • All Gradle stuff: *gradle*, AndroidManifest.xml
  • All following files (and their .license files): *.{def,expsym,in,json,map,pom,rc,txt}
  • All dotfiles

pcre2

  • Upstream: http://www.pcre.org
  • Version: 10.43 (3864abdb713f78831dd12d898ab31bbb0fa630b6, 2024)
  • License: BSD-3-Clause

Files extracted from upstream source:

  • Files listed in the file NON-AUTOTOOLS-BUILD steps 1-4
  • All .h files in src/ apart from pcre2posix.h
  • src/pcre2_jit_match.c
  • src/pcre2_jit_misc.c
  • src/pcre2_ucptables.c
  • src/sljit/
  • AUTHORS and LICENCE

recastnavigation

Files extracted from upstream source:

  • Recast/ folder without CMakeLists.txt
  • License.txt

rvo2

For 2D in rvo2_2d folder

For 3D in rvo2_3d folder

Files extracted from upstream source:

  • All .cpp and .h files in the src/ folder except for Export.h and RVO.h
  • LICENSE

Important: Nearly all files have Godot-made changes and renames to make the 2D and 3D rvo libraries compatible with each other and solve conflicts and also enrich the feature set originally proposed by these libraries and better integrate them with Godot.

spirv-cross

Files extracted from upstream source:

  • All .cpp, .hpp and .h files, minus main.cpp, spirv_cross_c.*, spirv_hlsl.*, spirv_cpp.*
  • include/ folder
  • LICENSE and LICENSES/ folder, minus CC-BY-4.0.txt

Versions of this SDK do not have to match the vulkan section, as this SDK is required to generate Metal source from Vulkan SPIR-V.

spirv-reflect

Version should be kept in sync with the one of the used Vulkan SDK (see vulkan section).

Files extracted from upstream source:

  • spirv_reflect.h, spirv_reflect.c
  • include/ folder
  • LICENSE

Some downstream changes have been made and are identified by // -- GODOT begin -- and // -- GODOT end -- comments. They can be reapplied using the patches included in the patches folder, in order.

tinyexr

Files extracted from upstream source:

  • tinyexr.{cc,h}

The tinyexr.cc file was modified to include zlib.h which we provide, instead of miniz.h as an external dependency.

thorvg

Files extracted from upstream source:

See thorvg/update-thorvg.sh for extraction instructions. Set the version number and run the script.

ufbx

Files extracted from upstream source:

  • ufbx.{c,h}
  • LICENSE

vhacd

Files extracted from upstream source:

  • From src/VHACD_Lib/: inc, public and src
  • LICENSE

Some downstream changes have been made and are identified by // -- GODOT start -- and // -- GODOT end -- comments. They can be reapplied using the patches included in the vhacd folder.

volk

Version should be kept in sync with the one of the used Vulkan SDK (see vulkan section).

Files extracted from upstream source:

  • volk.h, volk.c
  • LICENSE.md

vulkan

Unless there is a specific reason to package a more recent version, please stick to tagged SDK releases. All Vulkan libraries and headers should be kept in sync so:

  • Update Vulkan SDK components to the matching tag (see "vulkan")
  • Update volk (see "volk")
  • Update glslang (see "glslang")
  • Update spirv-reflect (see "spirv-reflect")

Files extracted from upstream source:

  • include/
  • LICENSE.md

vk_enum_string_helper.h is taken from the matching Vulkan-Utility-Libraries SDK release: https://github.com/KhronosGroup/Vulkan-Utility-Libraries/blob/main/include/vulkan/vk_enum_string_helper.h

vk_mem_alloc.h is taken from https://github.com/GPUOpen-LibrariesAndSDKs/VulkanMemoryAllocator Version: 3.1.0 (009ecd192c1289c7529bff248a16cfe896254816, 2024) vk_mem_alloc.cpp is a Godot file and should be preserved on updates.

Patches in the patches directory should be re-applied after updates.

wayland

Files extracted from upstream source:

  • protocol/wayland.xml
  • COPYING

wayland-protocols

Files extracted from upstream source:

  • stable/viewporter/README
  • stable/viewporter/viewporter.xml
  • stable/xdg-shell/README
  • stable/xdg-shell/xdg-shell.xml
  • staging/fractional-scale/README
  • staging/fractional-scale/fractional-scale-v1.xml
  • staging/xdg-activation/README
  • staging/xdg-activation/xdg-activation-v1.xml
  • staging/xdg-system-bell/xdg-system-bell-v1.xml
  • unstable/idle-inhibit/README
  • unstable/idle-inhibit/idle-inhibit-unstable-v1.xml
  • unstable/pointer-constraints/README
  • unstable/pointer-constraints/pointer-constraints-unstable-v1.xml
  • unstable/pointer-gestures/README
  • unstable/pointer-gestures/pointer-gestures-unstable-v1.xml
  • unstable/primary-selection/README
  • unstable/primary-selection/primary-selection-unstable-v1.xml
  • unstable/relative-pointer/README
  • unstable/relative-pointer/relative-pointer-unstable-v1.xml
  • unstable/tablet/README
  • unstable/tablet/tablet-unstable-v2.xml
  • unstable/text-input/README
  • unstable/text-input/text-input-unstable-v3.xml
  • unstable/xdg-decoration/README
  • unstable/xdg-decoration/xdg-decoration-unstable-v1.xml
  • unstable/xdg-foreign/README
  • unstable/xdg-foreign/xdg-foreign-unstable-v1.xml
  • COPYING

wslay

File extracted from upstream release tarball:

  • Run cmake . to generate config.h and wslayver.h Contents might need tweaking for Godot, review diff
  • All .c and .h files from lib/
  • All .h in lib/includes/wslay/ as wslay/
  • wslay/wslay.h has a small Godot addition to fix MSVC build See patches/msvcfix.diff
  • COPYING

xatlas

Files extracted from upstream source:

  • source/xatlas/xatlas.{cpp,h}
  • LICENSE

zlib

Files extracted from upstream source:

  • All .c and .h files, except gz*.c and infback.c
  • LICENSE

zstd

Files extracted from upstream source:

  • lib/{common/,compress/,decompress/,zstd.h,zstd_errors.h}
  • LICENSE
View Git Blame Copy Permalink