godot/thirdparty/README.md

7.5 KiB
Raw Blame History

Third party libraries

b2d_convexdecomp

certs

  • Upstream: ?

TODO.

fonts

Noto Sans UI Regular

Whats the difference between the UI and non-UI versions?

The UI fonts were initially prepared for use in Androids UI. They have tighter vertical metrics, and some glyphs that would be clipped are redrawn to fit within the constrained space. They can be used anywhere that has limited vertical space. There are no UI verions of scripts that do not need such adjustment, and the non-UI versions should be preferred for use in body text. https://github.com/googlei18n/noto-fonts/blob/master/FAQ.md#whats-the-difference-between-the-ui-and-non-ui-versions

Adobe Source Code Pro Regular

  • Upstream: ?

DroidSans*.ttf

  • Upstream: ?

freetype

Files extracted from upstream source:

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

glew

Files extracted from upstream source:

  • src/glew.c
  • include/GL/ as GL/
  • LICENSE.txt

jpeg-compressor

Files extracted from upstream source:

  • jpgd.{c,h}

libmpcdec

Files extracted from upstream source:

  • all .c and .h files in libmpcdec/
  • include/mpc as mpc/
  • COPYING from libmpcdec/

libogg

Files extracted from upstream source:

  • src/*.c
  • 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

libvorbis

Files extracted from upstream source:

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

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.

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. TODO: Properly sync with version 1.2.4 and document changes.

misc

Collection of single-file libraries used in Godot components.

core

modules

scene

openssl

Files extracted from the upstream source:

  • Our openssl/: contains the headers installed in /usr/include/openssl; gather them in the source tarball with make links and cp -f include/openssl/*.h ../openssl/openssl/
  • Our crypto/: copy of upstream crypto/, with some cleanup (see below).
  • Our ssl/: copy of upstream ssl/, with some cleanup (see below).
  • Cleanup:
    find \( -name "Makefile" -o -name "*.S" -o -name "*.bat" -o -name "*.bc" \
      -o -name "*.com" -o -name "*.cnf" -o -name "*.ec" -o -name "*.fre" \
      -o -name "*.gcc" -o -name "*.in" -o -name "*.lnx" -o -name "*.m4" \
      -o -name "*.pl" -o -name "*.pod" -o -name "*.s" -o -name "*.sh" \
      -o -name "*.sol" -o -name "*test*" \) -delete
    cd openssl; for file in *.h; do find ../{crypto,ssl} -name "$file" -delete; done
    
    For the rest check the git status and decide.
  • e_os.h
  • Apply the Godot-specific patches in the patches/ folder.

opus

Files extracted from upstream source:

  • all .c and .h files in src/ (both opus and opusfile), except opus_demo.c
  • all .h files in include/ (both opus and opusfile) as opus/
  • celt/ and silk/ subfolders
  • COPYING

pvrtccompressor

Files extracted from upstream source:

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

rg-etc1

Files extracted from upstream source:

  • rg_etc1.{cpp,h}

rtaudio

Files extracted from upstream source:

  • RtAudio.{cpp,h}

speex

squish

Files extracted from upstream source:

  • all .cpp, .h and .inl files

8311a78... squish: Move to a module and split thirdparty lib

theora

Files extracted from upstream source:

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

zlib

Files extracted from upstream source:

  • all .c and .h files