F·W·K

3D game framework in C, with Luajit bindings now.

Goals

Features ᕦ(ᐛ)ᕤ

Roadmap ᕕ(ᐛ)ᕗ (in order of arrival; ✱: partial support)

Gallery

Build (as static library)

Type MAKE.bat (Win) or sh MAKE.bat (Linux/OSX) to build everything. Alternatively,

echo Windows (vc+tcc)      && cl  demo.c       fwk.c
echo Windows (mingw64)     && gcc demo.c       fwk.c -o demo -w -lws2_32 -lgdi32 -lwinmm -ldbghelp
echo Linux (gcc+clang+tcc) && cc  demo.c       fwk.c -o demo -w -lm -ldl -lpthread
echo OSX (gcc+clang)       && cc  demo.c -ObjC fwk.c -o demo -w -framework cocoa -framework iokit

Note: TCC is partially supported on Windows+Linux. Beware, no threading.

Build (as dynamic library)

Windows: cl fwk.c /LD /DAPI=EXPORT && cl demo.c fwk.lib /DAPI=IMPORT
OSX: cc -ObjC -dynamiclib -o libfwk.dylib fwk.c -framework cocoa -framework iokit
Test it by typing cd demos/lua && luajit demo_luajit.lua

Amalgamation

Split FWK into separate files by running art/tools/split.bat (or sh art/tools/split.bat in Linux/OSX).
Merge those files back into FWK by running art/tools/join.bat (or sh art/tools/join.bat in Linux/OSX).
Optionally, generate a single-header distribution by executing following script:

echo // This C file is a header that you can #include. Do #define FWK_C  > fwk-single-header.c
echo // early in **one** compilation unit to unroll the implementation. >> fwk-single-header.c
type fwk.h           >> fwk-single-header.c
echo #ifdef FWK_C    >> fwk-single-header.c
echo #pragma once    >> fwk-single-header.c
type fwk.c           >> fwk-single-header.c
echo #endif // FWK_C >> fwk-single-header.c

Extra tips

Dropped files into game window will be imported & saved into art/import folder.
Linux/OSX users can optionally install wine to use the Windows pipeline as an alternate asset pipeline (use --with-wine flag).
Although not recommended, you can remove the cooking stage by invoking --with-jobs=0 or by removing the art/tools folder.
Depending on your IDE, you might need to split all amalgamated files when debugging FWK.

Bindings

Luajit: Luajit bindings are provided in the fwk.lua auto-generated file.
Nelua: Nelua bindings provided by Rabia Alhaffar.

License

This software is released into the public domain.
Also dual-licensed as 0-BSD or MIT (No Attribution) for those countries where public domain is a concern (sigh).
Any contribution to this repository is implicitly subjected to the same release conditions aforementioned.

Credits (Artwork + demos)

FMS_Cat, for nicest VHS/VCR shader around (MIT).
Goblin165cm, for witch 3D model (CC BY 4.0).
Nanofactory, for kgirls01 3D model (CC BY-NC-ND 4.0).
Quaternius, for the lovely 3D robots (CC0).
Rxi, for lovely sprites & cats demo (MIT).
wwwtyro, for nicest rayleigh/mie scattering shader around (CC0).

Credits (Tools)

Aaron Barany, for cuttlefish (APACHE2).
Assimp authors, for assimp (BSD3).
Bernhard Schelling, for tml.h (Zlib) and tsf.h (MIT).
ffmpeg authors, for ffmpeg (LGPL21).
Imagination, for pvrtextoolcli (ITL).
Krzysztof Gabis, for split.py/join.py (MIT).
Lee Salzman, for iqm.cpp (PD).
Mattias Gustavsson, for mid.h (PD).
Michael Schmoock, for lcpp (MIT).
Morgan McGuire, for markdeep (BSD2).
Tomas Pettersson, for sfxr (PD).
Tor Andersson, for assiqe.c (BSD).

Credits (Runtime)

Barerose, for swrap (CC0).
Camilla Löwy, for glfw3 (Zlib).
Dave Rand for ppp (PD).
David Herberth, for glad generated code (PD).
David Reid, for miniaudio (PD).
Dominic Szablewski, for pl_mpeg (MIT).
Dominik Madarász, for json5 parser (PD).
Eduard Suica, for tlse (PD).
Gargaj+cce/Peisik, for Foxotron/PBR shaders (UNLICENSE).
Guillaume Vareille, for tinyfiledialogs (ZLIB).
Haruhiko Okumura for lzss (PD).
Igor Pavlov for LZMA (PD).
Ilya Muravyov for bcm, balz, crush, ulz, lz4x (PD).
Jon Olick, for jo_mp1 and jo_mpeg (PD).
Joonas Pihlajamaa, for JUnzip library (PD).
Lee Salzman, for IQM spec & player (PD).
Lee Salzman, V.Hrytsenko and D.Madarász, for enet (MIT).
Libtomcrypt, for libtomcrypt (Unlicense).
Lua authors, for Lua language (MIT).
Mattias Gustavsson, for thread.h and https.h (PD).
Micha Mettke, for nuklear (PD).
Omar Cornut, vaiorabbit, for tables of unicode ranges (MIT-0).
Rich Geldreich, for miniz (PD).
Ross Williams for lzrw3a (PD).
Samuli Raivio, for bq_websocket (PD).
Sean Barrett, for stb_image, stb_image_write, stb_truetype and stb_vorbis (PD).
Sebastian Steinhauer, for sts_mixer (PD).
Stefan Gustavson, for simplex noise (PD).
Vassvik, for mv_easy_font (Unlicense).
Special thanks to @ands (PD), @barerose (CC0), @datenwolf (WTFPL2), @evanw (CC0), @glampert (PD), @krig (CC0), @sgorsten (Unlicense) and @vurtun (PD) for their math libraries.

Links

Still looking for alternatives? amulet, aroma, astera, blendelf, bullordengine, candle, cave, chickpea, corange, cute, dos-like, ejoy2d, exengine, gunslinger, hate, island, juno, l, lgf, limbus, love, lovr, mini3d, mintaro, mio, opensource, ouzel, pez, pixie, punity, ricotech, rizz, tigr,

cai502 / fwk Goto Github PK

fwk's Introduction