ECSExtLib

The ECS extension library wraps the following libraries:

• Bindings for the SQLite embedded database library.
• Bindings for the SDL3 cross platform game/application library.
• Bindings for the SDL3_ttf cross platform font library.

OS support is covered for the Windows and Linux platforms. For now only X86_64 variants are supported.

The bindings expect the .dll/.so file to be present on the system.

Example of use is found in the misc folder.

Building & Running tests

Build instructions here are for a current ArchLinux version, but should be possible to adapt to other Linux distributions.

Windows MSYS2 (CLANG64) also can follow these instructions and is known to work well, but is much slower than on Linux.

Note that your Windows systems anti-virus software might indentify the resulting .exe file as a threath and in that case this check automatic must exemt these files

# Build and install patched version of ECS
pacman -S git make clang sdl2-compat
git clone https://github.com/tenko/ECS.git
cd ECS
make toolchain=clang all # takes some time to finish
# install to ~/.local/[bin|lib|share] or other setup of choice
make toolchain=clang prefix=~/.local install
make clean
# add to PATH variable (adapt to your shell and setup)
echo 'export PATH=~/.local/bin/:~/.local/lib/ecs/tools/:$PATH' >> ~/.bashrc
echo 'export ECSBASE=~/.local/lib/ecs/' >> ~/.bashrc
cd ..
# Optional install also ECSStdLib to run testsqlite
# Build and test ECSExtLib
pacman -S sdl3 sdl3_ttf sqlite3
git clone https://github.com/tenko/ECSExtLib.git
cd ECSExtLib
make # build extsdl3.lib, extsdl3ttf.lib and extsqlite.lib
make PREFIX=~/.local install # install to ~/.local/lib
make testsqlite # run sqlite test (use testsqlite.exe on Windows)
make testsdl3 # run sdl3 test (use testsdl3.exe on Windows)
make testsdl3ttf # run sdl3ttf test (use testsdl3ttf.exe on Windows)

TODO

This is an initial version which will be expanded as functionality needed.

License

The files src/linuxlib.hpp & src/winlib.hpp are covered by the ECS Runtime Support Exception.

Otherwise files are covered by the MIT license, Copyright (c) 2025, Runar Tenfjord