reorganization

This commit is contained in:
Trilarion
2017-12-09 22:31:37 +01:00
parent 329f08cb4a
commit 041f951803
183 changed files with 19 additions and 24 deletions

28
games/library/_toc.md Normal file
View File

@ -0,0 +1,28 @@
# Popular required libraries
[comment]: # (start of autogenerated content, do not edit)
- **[Allegro](allegro.md)** (C, zlib, mature)
- **[Boost (C++ Libraries)](boost.md)** (C++, [BSL-1.0](https://github.com/boostorg/boost/blob/master/LICENSE_1_0.txt), mature)
- **[Crypto++](crypto.md)** (C++, Boost-1.0)
- **[Doxygen](doxygen.md)** (C++, GPL-2.0, mature)
- **[FreeType](freetype.md)** (C, GPL, mature)
- **[HarfBuzz](harfbuzz.md)** (C++, MIT, mature)
- **[LZMA SDK](lzma.md)** (C, LGPL-2.0, mature)
- **[Libxml2](libxml2.md)** (C, MIT, mature)
- **[Lua](lua.md)** (C, MIT, mature)
- **[Open AL](openal.md)** (Proprietary since v1.1, LGPL before)
- **[Open AL Soft](openalsoft.md)** (C, LGPL-2.0)
- **[OpenSSL](openssl.md)** (C, [Dual licensed under special licenses](https://github.com/openssl/openssl/blob/master/LICENSE), mature)
- **[Pthreads-win32](pthreads_win32.md)** (C, LGPL-2.1, mature)
- **[Ragel](ragel.md)** (C++, MIT, mature)
- **[SWIG](swig.md)** (C++, [Special](https://raw.githubusercontent.com/swig/swig/master/LICENSE), mature)
- **[Simple DirectMedia Layer](sdl_2.md)** (C, zlib, mature)
- **[Simple and Fast Multimedia Library](sfml.md)** (C++, zlib (core), mature)
- **[XZ Utils](xz.md)** (C, Different, see file Copying, liblzma is public domain, mature)
- **[libpng](libpng.md)** (C, [libpng](https://sourceforge.net/p/libpng/code/ci/master/tree/LICENSE), mature)
- **[pkg-config](pkgconfig.md)** (C, GPL-2.0, mature)
- **[wxWidgets](wxwidgets.md)** (C++, Objective C, Special, mature)
- **[yaml-cpp](yaml_cpp.md)** (C++, MIT)
- **[zlib](zlib.md)** (C, zlib, mature)
[comment]: # (end of autogenerated content)

16
games/library/allegro.md Normal file
View File

@ -0,0 +1,16 @@
# Allegro
_Cross-platform library mainly aimed at video game and multimedia programming._
- Home: http://liballeg.org/
- Wikipedia: https://en.wikipedia.org/wiki/Allegro_(software)
- Download: http://liballeg.org/download.html
- State: mature
- Code: primary repository (type if not git), other repositories (type if not git)
- Language(s): C
- License: zlib
## Building
Uses CMake

21
games/library/boost.md Normal file
View File

@ -0,0 +1,21 @@
# Boost (C++ Libraries)
_Boost provides free peer-reviewed portable C++ source libraries._
- Home: http://www.boost.org/
- Wikipedia: <https://en.wikipedia.org/wiki/Boost_(C%2B%2B_libraries)>
- Download: http://www.boost.org/users/download/
- State: mature
- Code: https://github.com/boostorg/boost
- Language(s): C++
- License: [BSL-1.0](https://github.com/boostorg/boost/blob/master/LICENSE_1_0.txt)
## Building
Uses its own Build process
2017-11 (1.65.1)
- Much is header only, but some parts require building
- Follow [Getting started on Windows](http://www.boost.org/doc/libs/1_65_1/more/getting_started/windows.html) or [Getting starten on Unix variants](http://www.boost.org/doc/libs/1_65_1/more/getting_started/unix-variants.html)
- Building on Windows with MSVC 2017 requires a workaround (see [issue #13197](https://svn.boost.org/trac10/ticket/13197))
- With MSVC 2015 run "bootstrap vc14" followed by "b2 toolset=msvc-14.0 stage"

12
games/library/crypto.md Normal file
View File

@ -0,0 +1,12 @@
# Crypto++
_C++ class library of cryptographic schemes._
- Home: https://cryptopp.com/
- Wikipedia: https://en.wikipedia.org/wiki/Crypto%2B%2B
- Download: https://cryptopp.com/#download
- Code: https://github.com/weidai11/cryptopp
- Language(s): C++
- License: Boost-1.0
## Building

17
games/library/doxygen.md Normal file
View File

@ -0,0 +1,17 @@
# Doxygen
_Tool for generating documentation from annotated C++ sources._
- Home: http://www.stack.nl/~dimitri/doxygen/
- Wikipedia: https://en.wikipedia.org/wiki/Doxygen
- Download: http://www.stack.nl/~dimitri/doxygen/download.html
- State: mature
- Keywords: tool, source documentation generator
- Code: https://github.com/doxygen/doxygen
- Language(s): C++
- License: GPL-2.0
## Building
Uses CMake

15
games/library/freetype.md Normal file
View File

@ -0,0 +1,15 @@
# FreeType
_Capable of producing high-quality output (glyph images) of most vector and bitmap font formats._
- Home: https://www.freetype.org/
- Wikipedia: https://en.wikipedia.org/wiki/FreeType
- Download: https://www.freetype.org/download.html
- State: mature
- Code: http://git.savannah.gnu.org/cgit/freetype/
- Language(s): C
- License: GPL
## Building
Uses CMake

16
games/library/harfbuzz.md Normal file
View File

@ -0,0 +1,16 @@
# HarfBuzz
_OpenType text shaping engine._
- Home: https://www.freedesktop.org/wiki/Software/HarfBuzz/
- Wikipedia: https://en.wikipedia.org/wiki/HarfBuzz
- Download: see home
- State: mature
- Code: https://github.com/harfbuzz/harfbuzz
- Language(s): C++
- License: MIT
## Building
Uses CMake

18
games/library/libpng.md Normal file
View File

@ -0,0 +1,18 @@
# libpng
_libpng is the official PNG reference library._
- Home: http://libpng.org/pub/png/libpng.html
- Wikipedia: https://en.wikipedia.org/wiki/Libpng
- Download: see home
- State: mature
- Keywords: official
- Code: https://sourceforge.net/p/libpng/code/ci/master/tree/
- Language(s): C
- License: [libpng](https://sourceforge.net/p/libpng/code/ci/master/tree/LICENSE)
## Building
2017-12
- On Windows CMake fails with "No CMAKE_ASM_COMPILER could be found." on "project(.. ASM)" with MSVC 2015 as generator

14
games/library/libxml2.md Normal file
View File

@ -0,0 +1,14 @@
# Libxml2
_Libxml2 is the XML C parser and toolkit developed for the Gnome project (but usable outside of the Gnome platform)._
- Home: http://www.xmlsoft.org/
- Wikipedia: https://en.wikipedia.org/wiki/Libxml2
- Download: http://www.xmlsoft.org/downloads.html
- State: mature
- Code: https://git.gnome.org//browse/libxml2/
- Language(s): C
- License: MIT
## Building

22
games/library/lua.md Normal file
View File

@ -0,0 +1,22 @@
# Lua
_Powerful, efficient, lightweight, embeddable scripting language._
- Home: http://www.lua.org/
- Wikipedia: <https://en.wikipedia.org/wiki/Lua_(programming_language)>
- Download: http://www.lua.org/download.html
- State: mature
- Code: see download https://github.com/lua/lua (mirror)
- Language(s): C
- License: MIT
It's a whole programming language but often used within games projects for scripting purposes (like Python).
See also [LuaDist](https://github.com/LuaDist).
Who develops Lua if the actual repository is not publicly available?
See also [toLua](http://webserver2.tecgraf.puc-rio.br/~celes/tolua/tolua-3.2.html).
## Building

19
games/library/lzma.md Normal file
View File

@ -0,0 +1,19 @@
# LZMA SDK
_The LZMA SDK provides the documentation, samples, header files, libraries, and tools you need to develop applications that use LZMA compression._
- Home: http://7-zip.org/
- Wikipedia: https://en.wikipedia.org/wiki/Lempel%E2%80%93Ziv%E2%80%93Markov_chain_algorithm
- Download: http://7-zip.org/download.html http://7-zip.org/sdk.html
- State: mature
- Code: see download
- Language(s): C
- License: LGPL-2.0
Windows only.
For Linux see [p7zip](https://sourceforge.net/projects/p7zip/), a command line tool (see also [here](https://www.linux.com/learn/handling-rar-and-7-zip-archives-linux)).
## Building
The binary LZMA SDK is licensed as PD.

11
games/library/openal.md Normal file
View File

@ -0,0 +1,11 @@
# Open AL
_Cross-platform audio application programming interface (API)._
- Home: http://www.openal.org/
- Wikipedia: https://en.wikipedia.org/wiki/OpenAL
- Code: http://www.openal.org/downloads/
- License: Proprietary since v1.1, LGPL before
## Building

View File

@ -0,0 +1,14 @@
# Open AL Soft
_Software implementation of the OpenAL 3D audio API._
- Home: http://kcat.strangesoft.net/openal.html
- Wikipedia: https://en.wikipedia.org/wiki/OpenAL#Implementations
- Code: http://repo.or.cz/openal-soft.git
- Language(s): C
- License: LGPL-2.0
## Building
Uses CMake

14
games/library/openssl.md Normal file
View File

@ -0,0 +1,14 @@
# OpenSSL
_Toolkit for the Transport Layer Security (TLS) and Secure Sockets Layer (SSL) protocols._
- Home: https://www.openssl.org/
- Wikipedia: https://en.wikipedia.org/wiki/OpenSSL
- Download: https://www.openssl.org/source/
- State: mature
- Code: https://www.openssl.org/source/gitrepo.html https://github.com/openssl/openssl (mirror)
- Language(s): C
- License: [Dual licensed under special licenses](https://github.com/openssl/openssl/blob/master/LICENSE)
## Building

View File

@ -0,0 +1,14 @@
# pkg-config
_Tool used when compiling applications and libraries._
- Home: https://www.freedesktop.org/wiki/Software/pkg-config/
- Wikipedia: https://en.wikipedia.org/wiki/Pkg-config
- Download: https://pkg-config.freedesktop.org/releases/
- State: mature
- Keywords: tool
- Code: git://anongit.freedesktop.org/pkg-config
- Language(s): C
- License: GPL-2.0
## Building

View File

@ -0,0 +1,16 @@
# Pthreads-win32
_Implements a large subset of the POSIX standard threads related API._
- Home: https://sourceware.org/pthreads-win32/
- Wikipedia: https://en.wikipedia.org/wiki/POSIX_Threads#POSIX_Threads_for_Windows
- Download: see home
- State: mature
- Code: cvs (see home) https://github.com/GerHobbelt/pthread-win32
- Language(s): C
- License: LGPL-2.1
## Building
Manually created project files for MSVC.

16
games/library/ragel.md Normal file
View File

@ -0,0 +1,16 @@
# Ragel
_Compiles executable finite state machines from regular languages._
- Home: http://www.colm.net/open-source/ragel/
- Wikipedia: https://en.wikipedia.org/wiki/Ragel
- Download: see home
- State: mature
- Code: git://git.colm.net/ragel.git
- Language(s): C++
- License: MIT
Required by [HarfBuzz](harfbuzz.md).
## Building

27
games/library/sdl_2.md Normal file
View File

@ -0,0 +1,27 @@
# Simple DirectMedia Layer
_Simple DirectMedia Layer is a cross-platform development library designed to provide low level access._
- Home: https://www.libsdl.org/index.php
- Wikipedia: https://en.wikipedia.org/wiki/Simple_DirectMedia_Layer
- Download: https://www.libsdl.org/download-2.0.php
- State: mature
- Keywords: multimedia hardware abstraction layer, 3D graphics
- Code: http://hg.libsdl.org/SDL (mercurial)
- Language(s): C
- License: zlib
- Bindings: [C#, Lua, Python, ..](https://www.libsdl.org/languages.php)
## Building
Uses CMake
2017-11 (2.0.7)
- SDL 2.0.7 with MSVC 2015 via CMake 3.9 works
## Projects
- [SDL_ttf 2.0](https://www.libsdl.org/projects/SDL_ttf/)
- [SDL_net 2.0](https://www.libsdl.org/projects/SDL_net/)
- [SDL_image 2.0](https://www.libsdl.org/projects/SDL_image/)
- [SDL_mixer 2.0](https://www.libsdl.org/projects/SDL_mixer/)

23
games/library/sfml.md Normal file
View File

@ -0,0 +1,23 @@
# Simple and Fast Multimedia Library
_SFML provides a simple interface to the various components of your PC._
- Home: https://www.sfml-dev.org/
- Wikipedia: https://en.wikipedia.org/wiki/Simple_and_Fast_Multimedia_Library
- Download: https://www.sfml-dev.org/download.php
- State: mature
- Code: https://github.com/SFML/SFML
- Language(s): C++
- License: zlib (core)
## Building
Uses CMake
Does not contain tests.
Includes precompiled libraries for various compilers in source folder _extlibs_.
2017-12
- Windows, CMake, MSVC 2015 builds

15
games/library/swig.md Normal file
View File

@ -0,0 +1,15 @@
# SWIG
_Software development tool that connects programs written in C and C++ with a variety of high-level programming languages._
- Home: http://swig.org/
- Wikipedia: https://en.wikipedia.org/wiki/SWIG
- Download: http://www.swig.org/download.html
- State: mature
- Keywords: language binding, interface generator
- Code: https://github.com/swig/swig
- Language(s): C++
- License: [Special](https://raw.githubusercontent.com/swig/swig/master/LICENSE)
## Building

View File

@ -0,0 +1,14 @@
# wxWidgets
_C++ library that lets developers create applications for Windows, Mac OS X, Linux and other platforms._
- Home: http://wxwidgets.org/
- Wikipedia: https://en.wikipedia.org/wiki/WxWidgets
- Download: http://wxwidgets.org/downloads/
- State: mature
- Keywords: gui toolkit
- Code: https://github.com/wxWidgets/wxWidgets
- Language(s): C++, Objective C
- License: Special
## Building

20
games/library/xz.md Normal file
View File

@ -0,0 +1,20 @@
# XZ Utils
_General-purpose data compression software with a high compression ratio._
- Home: https://tukaani.org/xz/
- Wikipedia: https://en.wikipedia.org/wiki/XZ_Utils
- Download: see home
- State: mature
- Code: https://git.tukaani.org/?p=xz.git
- Language(s): C
- License: Different, see file Copying, liblzma is public domain
Python support [lzma](https://docs.python.org/3/library/lzma.html)
Supersedes [LZMA Utils](https://tukaani.org/lzma/)
## Building
See building instructions in source folder windows.

12
games/library/yaml_cpp.md Normal file
View File

@ -0,0 +1,12 @@
# yaml-cpp
_YAML parser and emitter in C++ matching the YAML 1.2 spec._
- Home: https://github.com/jbeder/yaml-cpp
- Code:https://github.com/jbeder/yaml-cpp
- Language(s): C++
- License: MIT
## Building
Uses CMake (shows deprecation warnings)

15
games/library/zlib.md Normal file
View File

@ -0,0 +1,15 @@
# zlib
_zlib is a software library used for data compression._
- Home: http://zlib.net/
- Wikipedia: https://en.wikipedia.org/wiki/Zlib
- State: mature
- Code: https://github.com/madler/zlib
- Language(s): C
- License: zlib
## Building
Uses CMake