Shared-libraries-(buildfiles).md

   1 Xonotic on Linux uses system libraries. For Windows and macOS external dlls and dylibs are needed. Those reside in xonotic/misc/buildfiles
   2
   3 Because at the time of writing there is no automatism to build or update the games dependencies for those 2 platforms and the current dlls/dylibs are VERY outdated and thus also contain vulnerabilities, this page should document on where to obtain or how to build them, retaining API compatibility to darkplaces and also older OS platform versions like Windows XP.
   4
   5 # libcurl
   6 libcurl is used for downloading *.pk3 files from servers
   7
   8 ## Windows
   9 Darkplaces loads libcurl-4.dll or libcurl-3.dll
  10
  11 Build instructions:
  12 * clone https://gitlab.com/incognico/build-libcurl-windows
  13 * run build.bat in a VS2019 Development Shell
  14 * rename the built dlls (x64 & x86) to libcurl-4.dll
  15
  16 ## macOS
  17 Darkplaces loads libcurl.4.dylib or libcurl.3.dylib or libcurl.2.dylib
  18
  19 # libjpeg-turbo
  20 libjpeg-turbo is needed to display jpeg images
  21
  22 ## Windows
  23 Darkplaces loads libjpeg.dll
  24
  25 Obtainment instructions:
  26 * download libjpeg-turbo-VERSION-vc.exe & libjpeg-turbo-VERSION-vc64.exe from https://sourceforge.net/projects/libjpeg-turbo/files/
  27 * extract the *.exe files and use bin/jpeg62.dll
  28 * rename the dlls (x64 & x86) to libjpeg.dll
  29
  30 ## macOS
  31 Darkplaces loads libjpeg.62.dylib
  32
  33 # libpng
  34
  35 # libgmp
  36
  37 # libfreetype
  38
  39 # libogg
  40
  41 # libvorbis
  42
  43 # libvorbisfile
  44
  45 # libvorbisenc
  46
  47 # libtheora
  48
  49 # libstdc++-6