mirror/godot
2
0
Fork 0
mirror of https://github.com/godotengine/godot.git synced 2024-12-21 10:25:24 +08:00
Code Issues Packages Projects Releases Wiki Activity
50d33aac6c
godot/thirdparty/README.md

28 KiB
Vendored
Raw Blame History

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
  • LICENSE

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

brotli

Files extracted from upstream source:

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

certs

clipper2

Files extracted from upstream source:

  • CPP/Clipper2Lib folder
  • LICENSE

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

directx_headers

Files extracted from upstream source:

  • include/directx/*.h
  • LICENSE

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

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

Two files (ProcessRGB.{cpp,hpp}) have been modified to provide ETC2_R and ETC2_RG compression, the changes are based on the existing code.

Two files (ProcessRgtc.{cpp,hpp}) have been added to provide RGTC compression implementation, based on library's ProcessDxtc.{cpp,hpp}.

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 (except glslang/HLSL and glslang/ExtensionHeaders), OGLCompilersDLL, SPIRV
    • 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, *.m4 and 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 .c, .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/icudt73l.dat to the {GODOT_SOURCE}/thirdparty/icu4c/icudt73l.dat

jpeg-compressor

Files extracted from upstream source:

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

libktx

Files extracted from upstream source:

  • LICENSE.md
  • include/*
  • lib/dfdutils/{LICENSES/Apache-2.0.txt,KHR,*.c,*.h,*.inl}
  • lib/{basis_sgd.h,basis_transcode.cpp,checkheader.c,filestream.*,formatsize.h,gl_format.h,hashlist.c,ktxint.h,memstream.*,swap.c,texture*,uthash.h,vk_format.h,vkformat_enum.h}
  • utils/unused.h
  • other_include/KHR/*

Some Godot-specific changes are applied via godot.patch.

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, except 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.

mbedtls

File extracted from upstream release tarball:

  • All .h from include/mbedtls/ to thirdparty/mbedtls/include/mbedtls/ except config_psa.h and psa_util.h
  • All .c and .h from library/ to thirdparty/mbedtls/library/ except those starting with psa_*
  • The LICENSE file
  • Applied the patch windows-arm64-hardclock.diff to fix Windows ARM64 build Applied the patch windows-entropy-bcrypt.diff to fix Windows Store support
  • 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:

  • Copy miniupnpc/src and miniupnpc/include to thirdparty/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.

Another patch is included to fix CVE-2023-45853.

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.42 (52c08847921a324c804cabf2814549f50bce1265, 2022)
  • 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/sljit/
  • AUTHORS and LICENCE

A sljit patch from upstream was backported to fix macOS < 11.0 compilation in 10.40, it can be found in the patches folder.

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-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.{c,h}
  • 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.

squish

Files extracted from upstream source:

  • All .cpp, .h and .inl files

Important: Some files have Godot-made changes. They are marked with // -- GODOT start -- and // -- GODOT end -- comments and a patch is provided in the squish/ folder.

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.

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

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

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

Files extracted from upstream source:

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

vulkan

The vendored version should be kept in sync with volk, see above.

Files extracted from upstream source:

  • include/
  • LICENSE.md

vk_enum_string_helper.h is taken from the matching Vulkan-ValidationLayers SDK release: https://github.com/KhronosGroup/Vulkan-ValidationLayers/blob/main/layers/vulkan/generated/vk_enum_string_helper.h

vk_mem_alloc.h is taken from https://github.com/GPUOpen-LibrariesAndSDKs/VulkanMemoryAllocator Version: git (e88fff957b94f4b541ccac67a4290f07e52aa610), as advised by upstream: https://github.com/GPUOpen-LibrariesAndSDKs/VulkanMemoryAllocator/issues/318 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.

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, minus infback.c
  • LICENSE

zstd

Files extracted from upstream source:

  • lib/{common/,compress/,decompress/,zstd.h,zstd_errors.h}
  • LICENSE