godot/thirdparty
Rémi Verschelde c7b53c03ae
SCons: Add explicit dependencies on thirdparty code in cloned env
Since we clone the environments to build thirdparty code, we don't get an
explicit dependency on the build objects produced by that environment.

So when we update thirdparty code, Godot code using it is not necessarily
rebuilt (I think it is for changed headers, but not for changed .c/.cpp files),
which can lead to an invalid compilation output (linking old Godot .o files
with a newer, potentially ABI breaking version of thirdparty code).

This was only seen as really problematic with bullet updates (leading to
crashes when rebuilding Godot after a bullet update without cleaning .o files),
but it's safer to fix it everywhere, even if it's a LOT of hacky boilerplate.
2020-12-18 10:29:34 +01:00
..
assimp Revert "assimp: Sync with upstream 0201fc5" 2020-03-09 10:42:18 +01:00
basis_universal Windows: Appease capricious MSVC versions with moody headers 2020-04-26 22:27:04 +02:00
bullet Update to bullet master (2.90) 2020-04-27 11:37:47 +02:00
certs certs: Sync with latest ca-certificates-2018.2.26-2.fc29 2018-12-20 13:04:39 +01:00
cvtt Git: Explicitly list binary files as such to avoid EOL change 2019-05-25 10:43:48 +02:00
doctest doctest: Update to 2.4.1 2020-11-20 13:50:07 +02:00
enet ENetGodot: Apply clang-format and style guide 2020-07-21 11:48:14 +02:00
etc2comp etc2comp: Fix max iterations for RGBA channels 2020-04-01 11:23:42 +02:00
fonts [Complex Text Layouts] Refactor Font class, default themes and controls to use Text Server interface. 2020-11-26 14:25:48 +02:00
freetype Update freetype to 2.10.4 2020-10-22 01:47:48 +09:00
glslang vulkan: Sync loader, headers and glslang to sdk-1.2.154.0 2020-10-15 12:29:42 +02:00
graphite [Complex Text Layouts] Add third-party TextServer dependencies (ICU, HarfBuzz, Graphite). 2020-11-26 13:55:27 +02:00
harfbuzz [Complex Text Layouts] Add third-party TextServer dependencies (ICU, HarfBuzz, Graphite). 2020-11-26 13:55:27 +02:00
icu4c [Complex Text Layouts] Add third-party TextServer dependencies (ICU, HarfBuzz, Graphite). 2020-11-26 13:55:27 +02:00
jpeg-compressor Checking for half_image_size[ x & y ] to be non-negative. 2020-11-10 21:23:08 +05:30
libogg Reorganized core/ directory, it was too fatty already 2020-11-07 20:17:12 -03:00
libpng libpng: Update to upstream 1.6.37 2019-04-26 10:37:22 +02:00
libsimplewebm Sync libsimplewebm with fe57fd3 (but not the libwebm sub-lib) 2019-02-21 20:43:41 +00:00
libtheora theora: Add upstream patch to fix UB warning 2019-01-23 12:02:36 +01:00
libvorbis Update libvorbis to 1.3.6 2018-05-24 13:52:05 -03:00
libvpx Disable all use of avx instructions 2019-02-24 23:03:48 +01:00
libwebp Update libwebp to 1.1.0 2020-01-17 03:49:31 +09:00
mbedtls Update mbedTLS to version 2.16.8 (+ patch). 2020-09-07 15:47:38 +02:00
meshoptimizer Rework Mesh handling on scene importing. 2020-12-13 21:29:51 -03:00
minimp3 add mp3 import and playback support 2020-12-03 17:51:43 +01:00
miniupnpc miniupnpc: Sync with upstream master (4436632) 2020-03-06 16:29:50 -06:00
minizip Update minizip to 1.2.11 2018-05-16 01:58:34 +09:00
misc Fix some easing equations' undefined behaviours. 2020-12-08 18:21:16 +01:00
nanosvg nanosvg: Sync with upstream 3e403ec 2020-11-20 12:01:29 +01:00
oidn oidn: Fix build for VS 2017 2020-06-06 21:27:32 +02:00
opus Revert "Update opus to 1.3.1 and opusfile to 0.11" 2019-11-18 09:56:48 +01:00
pcre2 pcre2: Update to upstream version 10.34 2020-04-30 15:09:03 +02:00
pvrtccompressor Make core/ includes absolute, remove subfolders from include path 2018-09-12 09:52:22 +02:00
recastnavigation Recast: Update to upstream commit 57610fa (2019) 2020-04-30 15:16:13 +02:00
rvo2 SCons: Add explicit dependencies on thirdparty code in cloned env 2020-12-18 10:29:34 +01:00
spirv-reflect Replaced GLSLang reflection by SPIRV-Reflect, eventually allowing to move GLSLang out. 2020-02-11 11:53:29 +01:00
squish Fix GLES2 Red Green Texture Decompression 2018-11-27 20:45:28 +01:00
tinyexr tinyexr: Sync with upstream 1.0.0 2020-09-09 22:07:24 +02:00
vhacd Fix scale calculation in VHACD Volume::Voxelize(). 2020-05-06 13:14:33 +01:00
vulkan vulkan: Backport build fix for MinGW-w64 8.0.0 2020-10-29 12:47:35 +01:00
wslay Update to wslay 1.1.1 . 2020-07-02 16:00:56 +02:00
xatlas xatlas: Sync with upstream 5571fc7 2020-12-02 00:17:45 -08:00
zlib zlib: Update to upstream version 1.2.11 2017-01-16 17:58:34 +01:00
zstd zstd: Update to upstream version 1.4.5 2020-09-18 21:47:12 +02:00
README.md Rework Mesh handling on scene importing. 2020-12-13 21:29:51 -03:00

Third party libraries

Please keep categories (## level) listed alphabetically and matching their respective folder names. Use two empty lines to separate categories for readability. Subcategories (### level) where needed are separated by a single empty line.

assimp

Files extracted from upstream source:

  • Run cmake . in root folder to generate files
  • code/{CApi,Common,FBX,Material,PostProcessing}/
  • contrib/utf8cpp/source/
  • include/
  • revision.h
  • CREDITS and LICENSE files
  • rm -f code/Common/ZipArchiveIOSystem.cpp include/assimp/ZipArchiveIOSystem.h include/assimp/irrXMLWrapper.h

basis_universal

Files extracted from upstream source:

  • .cpp and .h files in root folder except for basisu_tool.cpp (contains main and can cause link error)
  • .cpp, .h and .inc files in transcoder/, keeping folder structure
  • LICENSE

bullet

Important: Synced with a pre-release version of bullet 2.90 from the master branch.

Files extracted from upstream source:

  • src/* apart from CMakeLists.txt and premake4.lua files
  • LICENSE.txt

certs

File extracted from a recent Fedora install: /etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem (It can't be extracted directly from the package, as it's generated on the user's system.)

cvtt

Files extracted from upstream source:

  • all .cpp, .h, and .txt files in ConvectionKernels/

doctest

Extracted from .zip provided. Extracted license and header only.

enet

  • Upstream: http://enet.bespin.org
  • Version: 1.3.15 (224f31101fc60939c02f6bbe8e8fc810a7db306b, 2020)
  • License: MIT

Files extracted from upstream source:

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

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

Two files (godot.cpp and enet/godot.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.

etc2comp

Files extracted from upstream source:

  • all .cpp and .h files in EtcLib/
  • README.md, LICENSE, AUTHORS

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

fonts

Noto Sans

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

Hack Regular

DroidSans*.ttf

Tamsyn

Extracted "0..9,A..F" characters for hex code printing.

freetype

Files extracted from upstream source:

  • the src/ folder, stripped of the Jamfile files and the tools subfolder
  • the include/ folder
  • docs/{FTL.TXT,LICENSE.TXT}

glslang

Version should be kept in sync with the one of the used Vulkan SDK (see vulkan section). Check Vulkan-ValidationLayers at the matching SDK tag for the known good glslang commit: https://github.com/KhronosGroup/Vulkan-ValidationLayers/blob/master/scripts/known_good.json

Files extracted from upstream source:

  • glslang (except glslang/HLSL), OGLCompilersDLL, SPIRV
  • StandAlone/{DirStackFileIncluder.h,ResourceLimits.{cpp,h}}
  • Run cmake . && make and copy generated include/glslang/build_info.h to glslang/build_info.h
  • LICENSE.txt
  • Unnecessary files like CMakeLists.txt and updateGrammar removed.

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

Graphite engine

Files extracted from upstream source:

  • the include folder
  • the src folder
  • COPYING, ChangeLog

HarfBuzz

Files extracted from upstream source:

  • the src folder
  • AUTHORS, COPYING, NEWS, THANKS

International Components for Unicode

Files extracted from upstream source:

  • the common folder
  • APIChangeReport.md, LICENSE

Files generated from upstream source:

jpeg-compressor

Files extracted from upstream source:

  • jpgd*.{c,h}

libogg

  • Upstream: https://www.xiph.org/ogg
  • Version: git (c8fca6b4a02d695b1ceea39b330d4406001c03ed, 2019)
  • License: BSD-3-Clause

Files extracted from upstream source:

  • src/*.{c,h}
  • include/ogg/*.h in ogg/
  • COPYING

libpng

Files extracted from upstream source:

  • all .c and .h files of the main directory, except from example.c and pngtest.c
  • the arm/ folder
  • scripts/pnglibconf.h.prebuilt as pnglibconf.h
  • LICENSE

libsimplewebm

This contains libwebm, but the version in use is updated from the one used by libsimplewebm, and may have unmarked alterations from that.

Files extracted from upstream source:

  • all the .cpp, .hpp files in the main folder except example.cpp
  • LICENSE

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

libtheora

Files extracted from upstream source:

  • all .c, .h in lib/
  • all .h files in include/theora/ as theora/
  • COPYING and LICENSE

Upstream patches included in the patches directory have been applied on top of the 1.1.1 source (not included in any stable release yet).

libvorbis

Files extracted from upstream source:

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

libvpx

Files extracted from upstream source:

TODO.

Important: File libvpx/vpx_dsp/x86/vpx_subpixel_8t_intrin_avx2.c has Godot-made change marked with // -- GODOT -- comments.

The files libvpx/third_party/android/cpu-features.{c,h} were copied from the Android NDK r18.

libwebp

Files extracted from upstream source:

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

Important: The files utils/bit_reader_utils.{c,h} have Godot-made changes to ensure they build for Javascript/HTML5. Those changes are marked with // -- GODOT -- comments.

mbedtls

File extracted from upstream release tarball:

  • All *.h from include/mbedtls/ to thirdparty/mbedtls/include/mbedtls/
  • All *.c from library/ to thirdparty/mbedtls/library/
  • LICENSE and apache-2.0.txt files
  • Applied the patch in thirdparty/mbedtls/patches/1453.diff (PR 1453). Soon to be merged upstream. Check it out at next update.
  • Applied the patch in thirdparty/mbedtls/patches/padlock.diff. This disables VIA padlock support which defines a symbol unsupported which clashes with a pre-defined symbol.
  • Added 2 files godot_core_mbedtls_platform.{c,h} providing configuration for light bundling with core.

meshoptimizer

File extracted from upstream release tarball:

  • Files in src/ go to thirdparty/meshoptimizer

miniupnpc

Files extracted from upstream source:

  • All *.c and *.h files from miniupnpc to thirdparty/miniupnpc/miniupnpc
  • Remove test*, minihttptestserver.c and wingenminiupnpcstrings.c

The patch windows_fix.diff is applied to minissdpc.c to fix an upstream issue. The only modified file is miniupnpcstrings.h, which was created for Godot (it is usually autogenerated by cmake).

minizip

Files extracted from the upstream source:

  • contrib/minizip/{crypt.h,ioapi.{c,h},zip.{c,h},unzip.{c,h}}

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 minizip/ folder.

misc

Collection of single-file libraries used in Godot components.

core

modules

platform

scene

nanosvg

Files extracted from the upstream source:

  • All .h files in src/
  • LICENSE.txt

oidn

Files extracted from upstream source:

common/* (except tasking.* and CMakeLists.txt) core/* include/OpenImageDenoise/* (except version.h.in) LICENSE.txt mkl-dnn/include/* mkl-dnn/src/* (except CMakeLists.txt) weights/rtlightmap_hdr.tza scripts/resource_to_cpp.py

Modified files: Modifications are marked with // -- GODOT start -- and // -- GODOT end --. Patch files are provided in oidn/patches/.

core/autoencoder.cpp core/autoencoder.h core/common.h core/device.cpp core/device.h core/transfer_function.cpp

scripts/resource_to_cpp.py (used in modules/denoise/resource_to_cpp.py)

opus

Files extracted from upstream source:

  • all .c and .h files in src/ (both opus and opusfile)
  • all .h files in include/ (both opus and opusfile) as opus/
  • remove unused opus_demo.c,
  • remove http.c, wincerts.c and winerrno.h (part of unused libopusurl)
  • celt/ and silk/ subfolders
  • COPYING

pcre2

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

pvrtccompressor

Files extracted from upstream source:

  • all .cpp and .h files apart from main.cpp
  • LICENSE.TXT

recastnavigation

Files extracted from upstream source:

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

rvo2

Files extracted from upstream source:

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

Important: Some files have Godot-made changes; so to enrich the features originally proposed by this library and better integrate this library with Godot. Please check the file to know what's new.

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}

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.

vulkan

Unless there is a specific reason to package a more recent version, please stick to Vulkan SDK releases (prefixed by sdk-) for all components.

NOTE: Use scripts/update_deps.py --ref <version> in the Loader git repository to retrieve the Vulkan-Headers repository matching the loader version.

Files extracted from upstream source:

  • Vulkan-Headers/include/ as include/
  • All .c and .h files in loader/ and loader/generated/, put in a common loader/ folder
  • LICENSE.txt

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

vk_mem_alloc.h is taken from https://github.com/GPUOpen-LibrariesAndSDKs/VulkanMemoryAllocator Version: 2.3.0 (2019) vk_mem_alloc.cpp and android/vk_mem_alloc.cpp are Godot files and should be preserved on updates.

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

wslay

File extracted from upstream release tarball:

  • All *.c and *.h in lib/ and lib/includes/
  • wslay.h has a small Godot addition to fix MSVC build. See thirdparty/wslay/msvcfix.diff

xatlas

Files extracted from upstream source:

  • xatlas.{cpp,h}
  • LICENSE

zlib

Files extracted from upstream source:

  • all .c and .h files

zstd

Files extracted from upstream source:

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