2023.9

new: added --transparent, --mute and --delay=MS flags
new: added built-in debug panel with lots of internals exposed (camera, keyboard, mouse, gamepads, shaders, fxs, etc)
new: added camera damping settings
new: added compute shaders api (zpl-zak)
new: added support to specify 1:N outputs in cook (in addition to 1:1 outputs)
new: added vfs_load() >> file_load() fallback when no tools are present
new: added AUDIO_32KHZ flag (zpl-zak)
new: added VIDEO_LOOP, app_spawn(), ui_dims(), ui_get_dims() (zpl-zak)
new: added WINDOW_TRANSPARENT, --transparent flags, window_transparent(), window_maximize()
new: added analytical light step with limited Phong shading for Directional+Point lights (zpl-zak)
new: added art browser into debug panel
new: added compute shader demos (99-geom, 99-compute) (zpl-zak)
new: ddraw_camera()
new: extracted embedded shaders as transpilable files (zpl-zak)
new: fullscreen_quad_rgb_flipped(), fullscreen_quad_ycbcr_flipped() (zpl-zak)
new: hash_str(), hash_bin()
new: initial filtering on debug panel (ctrl-f)
new: integrated animlist format support into ass2iqe (zpl-zak)
new: made transparent apps to hide some ui panels by default: profiler, shaders, fxs.
new: made transparent apps to not display the cook progress bar
new: made transparent apps to shutdown whenever last ui_window() is closed
new: make compilation faster by caching precompiled fwk sources (win)
new: map/set_isempty(), atof2/3/4(), ftoa2/3/4(), swapf2/3/4(), clamp2/3/4()
new: mesh_bounds()
new: mesh_render_prim() (zpl-zak)
new: netsync code refactor (zpl-zak)
new: new light API, scene api additions to push lights (zpl-zak)
new: new shader reflection API
new: new shader reflection parameters get applied automatically when shader is compiled
new: rim lighting in anims demo (zpl-zak)
new: RPCs being reported by network_sync events (zpl-zak)
new: shader reflection parameters (bool,int,vec2/3/4,color3/4), set/min/max/tooltips
new: shader_apply_param(), shader_apply_params(), ui_shaders(), ui_fxs()
new: skybox_sh_add_light() (zpl-zak)
new: tty_detach()
new: ui_enabled(), ui_keyboard(), ui_mouse(), ui_gamepad(), ui_gamepads(), ui_camera()...
new: window_resize() (ems) (zpl-zak)
chg: generate bindings in engine/ folder
chg: instantiate web server only if content is not being served (html5)
chg: reduced overall repository weight
chg: MSG_INIT part of negotiation process now (zpl-zak)
chg: allow file_list() to retrieve most hidden files
chg: changed file browser to use ctrl+wheel when zooming in/out
chg: changed netsync event format (zpl-zak)
chg: deprecate vis command (MAKE.bat)
chg: expose animations api (zpl-zak)
chg: expose pathfind api (zpl-zak)
chg: flags for enet reliability and ordering control (zpl-zak)
chg: increased MAX_CACHED_FILES to 32
chg: made faster make.bat initalization in subsequent runs (win)
chg: made RGB3() to return alpha(255)
chg: made animations parser to loop idle anims by default
chg: made thinner style on UI labels
chg: print opengl version on boot
chg: recompile ass2iqe (win,lin,osx)
chg: relocate lua/python demos folder
chg: replicate previous project tree layout
chg: silenced mingw64 warnings in 3rd_enet.h
chg: switched to a faster mount logic during boot time
chg: switched to b612 font (sharper, increases num font faces, reduces repo size)
chg: updated docs
chg: upgrade 3rd_icon_md.h + teal + tlse + gamecontrollerdb to latest
lab: wip node editor demo (demos/99-nodes.c)
lab: wip NETWORK_BUF_CLEAR_ON_JOIN (zpl-zak)
lab: wip behavior tree demo (demos/99-bt.c)
fix: flipped shadertoys when used as texture (fwk_render)
fix: added pthreads support (html5) (zpl-zak)
fix: added RPC signature for void(char*) (zpl-zak)
fix: allowed coi requests in localhost served contents (html5) (zpl-zak)
fix: avoided crash in animations() when plain text animfile is provided
fix: fixed crash when no cooked fonts were available (ui_notify)
fix: fixed download() api on tcc+win32
fix: fixed enet/swrap sockets on tcc+win32 (zpl-zak)
fix: fixed issue when mounting empty zipfiles (likely to happen in computers with many cpu cores) (thanks zpl-zak!)
fix: fixed unsafe format strings in xml_int() and xml_float()
fix: fixed dll linkage in mingw+FWK_IMPLEMENTATION builds (MAKE.bat)
fix: fixed incorrect fbx files being loaded as @animlist files
fix: fixed void(*rpc)() call in netsyce code (zpl-zak)
fix: improve ui readablity (ie, decrease transparency) on overlapped windows
fix: issue in cookbook where groups would not match a single extension
fix: made letterbox fx to work on any aspect ratio
fix: optimized out heap allocations in netsync code (zpl-zak)
fix: peer ranks are recycled now (zpl-zak)
fix: postfxs on transparent windows
fix: restored executable permissions (osx,lin)
fix: reverted leak (3rd_https)
fix: supported SH coeffs when using mie scattering skybox (zpl-zak)
brk: added extra shader() argument to specify #defines in shaders (zpl-zak)
brk: camera_move() > camera_moveby()
brk: changed ui_enable() signature; renamed clamp2/3/4->clamp2f/3f/4f
brk: deprecate --camera-smooth
brk: deprecate input_demo()
brk: deprecate ui_const_string()
brk: deprecated viewport_color() in favor of window_color()
brk: file_stamp_epoch > file_stamp, file_stamp > file_stamp10
brk: input_frames() > input_string()
brk: profile_enable() > profiler_enable()
brk: renamed WITH_ > ENABLE_ directives
brk: split blur fx out in two different h/v passes
brk: ui_bits8/16() -> ui_bitmask8/16()
brk: ui_const_bool() > ui_label2_bool(), ui_const_float() > ui_label2_float()

2023.9/demos/00-loop.c

@@ -0,0 +1,9 @@
+#include "fwk.h" // Minimal C sample
+
+int main() {
+    window_create(75.0, 0); // 75% size, no extra flags
+
+    while( window_swap() && !input(KEY_ESC) ) { // game loop
+        puts("hello FWK from C!");
+    }
+}

2023.9/demos/00-script.c

@@ -0,0 +1,31 @@
+#include "fwk.h"
+
+#define SCRIPT(...) #__VA_ARGS__
+
+#if 0 // teal
+    script_run("local tl=require(\"tl\")\ntl.loader()");
+    script_run("addsub = require(\"s2\"); print (addsub.add(10, 20))");
+s2.tl:
+    local function add(a: number, b: number): number
+       return a + b
+    end
+    local s = add(1,2)
+    print(s)
+#endif
+
+int main() {
+    script_init();
+
+    script_run(SCRIPT(
+        window_create(75.0,0);
+        while window_swap() do
+            ddraw_grid(10);
+            if ui_panel("Hello from Lua!", 0) then
+                ui_panel_end();
+            end;
+        end;
+    ));
+
+    // script test (lua)
+    script_run( "-- Bye.lua\nio.write(\"script test: Bye world!, from \", _VERSION, \"\\n\")" );
+}

2023.9/demos/01-demo2d.c

@@ -0,0 +1,159 @@
+// 2d demo: window, audio, camera, font, tiled, render, fx, spritesheet, input, ui. @todo: spine
+// - rlyeh, public domain.
+//
+// Compile with:
+//    `make     demos\01-demo2d.c` (windows)
+// `sh MAKE.bat demos/01-demo2d.c` (linux, osx)
+
+#include "fwk.h"
+
+void demo_kids(vec3 offs) {
+    // init
+    static texture_t kids; do_once kids = texture( "spriteSheetExample.png", TEXTURE_LINEAR );
+    static vec3 pos[2] = {{490,362},{442,362}}, vel[2] = {0};
+    static int row[2] = {0,3}, frame[2] = {0};
+    static int inputs[2][4] = {{KEY_W,KEY_A,KEY_S,KEY_D},{KEY_UP,KEY_LEFT,KEY_DOWN,KEY_RIGHT}};
+
+    // move
+    for( int i = 0; i < countof(pos); ++i ) {
+        vel[i].x = input(inputs[i][3]) - input(inputs[i][1]);
+        vel[i].y = input(inputs[i][2]) - input(inputs[i][0]);
+        pos[i].x = fmod(pos[i].x + vel[i].x, window_width() + 128);
+        pos[i].y = fmod(pos[i].y + vel[i].y, window_height() + 128);
+        frame[i] += vel[i].x || vel[i].y;
+    }
+
+    // render
+    for( int i = 0; i < countof(pos); ++i ) {
+        int col = frame[i] / 10, num_frame = row[i] * 4 + col % 4; // 4x4 tilesheet
+        float position[3] = {pos[i].x,pos[i].y,pos[i].y}, offset[2]={0,0}, scale[2]={0.5,0.5};
+        float spritesheet[3]={num_frame,4,4};
+        sprite_sheet(kids,
+            spritesheet,        // num_frame in a 4x4 spritesheet
+            position, 0,        // position(x,y,depth:sort-by-Y), angle
+            offset, scale,      // offset(x,y), scale(x,y)
+            false, WHITE, false // is_additive, tint color, resolution-independent
+        );
+    }
+}
+
+void demo_hud() {
+    // draw pixel-art hud, 16x16 ui element, scaled and positioned in resolution-independant way
+    static texture_t inputs; do_once inputs = texture( "prompts_tilemap_34x24_16x16x1.png", TEXTURE_LINEAR );
+    float spritesheet[3] = {17,34,24}, offset[2] = {0, - 2*absf(sin(window_time()*5))}; // sprite cell and animation
+    float scale[2] = {3, 3}, tile_w = 16 * scale[0], tile_h = 16 * scale[1]; // scaling
+    float position[3] = {window_width() - tile_w, window_height() - tile_h, window_height() }; // position in screen-coordinates (x,y,z-index)
+    sprite_sheet(inputs, spritesheet, position, 0/*deg*/, offset, scale, false, WHITE, 1);
+}
+
+int main() {
+    // window (80% sized, MSAA x4 flag)
+    window_create(80.0, WINDOW_MSAA4);
+    window_title(__FILE__);
+
+    // tiled map
+    tiled_t tmx = tiled(vfs_read("castle.tmx"));
+    // tmx.parallax = true;
+
+    // spine model
+    //spine_t *spn = spine("goblins.json", "goblins.atlas", 0);
+
+    // camera 2d
+    camera_t cam = camera();
+    cam.position = vec3(window_width()/2, window_height()/2, 3); // at(CX,CY) zoom(x3)
+    camera_enable(&cam);
+
+    // audio (both clips & streams)
+    audio_t clip1 = audio_clip( "coin.wav" );
+    audio_t clip2 = audio_clip( "pew.sfxr" );
+    audio_t stream1 = audio_stream( "larry.mid" );
+    audio_t stream2 = audio_stream( "waterworld-map.fur" );
+    audio_t BGM = stream1;
+    audio_play(BGM, 0);
+
+    // font config: faces (6 max) and colors (10 max)
+    #define FONT_CJK       FONT_FACE3
+    #define FONT_YELLOW    FONT_COLOR2
+    #define FONT_LIME      FONT_COLOR3
+    font_face(FONT_CJK,      "mplus-1p-medium.ttf", 48.f, FONT_JP|FONT_2048); // CJK|FONT_2048|FONT_OVERSAMPLE_Y);
+    font_color(FONT_YELLOW,  RGB4(255,255,0,255));
+    font_color(FONT_LIME,    RGB4(128,255,0,255));
+
+    // fx: load all post fx files in all subdirs. enable a few filters by default
+    fx_load("fx**.fs");
+    fx_enable(fx_find("fxCRT2.fs"), 1);
+    fx_enable(fx_find("fxGrain.fs"), 1);
+    fx_enable(fx_find("fxContrast.fs"), 1);
+    fx_enable(fx_find("fxVignette.fs"), 1);
+
+    // demo loop
+    while (window_swap() && !input_down(KEY_ESC)) {
+
+        // handle input
+        if( input_down(KEY_F5) ) window_reload();
+        if( input_down(KEY_F11) ) window_fullscreen( !window_has_fullscreen() );
+
+        // camera panning (x,y) & zooming (z)
+        if( !ui_hover() && !ui_active() ) {
+            if( input(MOUSE_L) ) cam.position.x += input_diff(MOUSE_X);
+            if( input(MOUSE_L) ) cam.position.y += input_diff(MOUSE_Y);
+            cam.position.z += input_diff(MOUSE_W) * 0.1;
+        }
+
+        // apply post-fxs from here
+        fx_begin();
+
+            profile("Rendering") {
+                vec3 center = add3(cam.position,vec3(-window_width()/1,-window_height()/2,0));
+                // render tiled map
+                tiled_render(tmx, center);
+                //
+                demo_kids(vec3(0,0,1));
+                demo_hud();
+                // render spine model
+                // spine_animate(spn, !window_has_pause() * window_delta());
+                // spine_render(spn, vec3(cam.position.x, cam.position.y, 1), true );
+                // sprite_flush();
+            }
+
+            // subtitle sample
+            font_print(
+                FONT_BOTTOM FONT_CENTER
+                FONT_CJK FONT_H1
+                FONT_YELLOW "私はガラスを食べられます。" FONT_LIME "それは私を傷つけません。\n"
+            );
+
+        // post-fxs end here
+        fx_end();
+
+        // ui
+        if( ui_panel("Audio", 0)) {
+            static float bgm = 1, sfx = 1, master = 1;
+            if( ui_slider2("BGM", &bgm, va("%.2f", bgm))) audio_volume_stream(bgm);
+            if( ui_slider2("SFX", &sfx, va("%.2f", sfx))) audio_volume_clip(sfx);
+            if( ui_slider2("Master", &master, va("%.2f", master))) audio_volume_master(master);
+            if( ui_label2_toolbar("BGM: Track #1", ICON_MD_VOLUME_UP)) audio_stop(BGM), audio_play(BGM = stream1, AUDIO_SINGLE_INSTANCE);
+            if( ui_label2_toolbar("BGM: Track #2", ICON_MD_VOLUME_UP)) audio_stop(BGM), audio_play(BGM = stream2, AUDIO_SINGLE_INSTANCE);
+            if( ui_label2_toolbar("SFX: Coin", ICON_MD_VOLUME_UP)) audio_play(clip1, 0);
+            if( ui_label2_toolbar("SFX: Pew", ICON_MD_VOLUME_UP)) audio_play(clip2, 0);
+            ui_panel_end();
+        }
+        if( ui_panel("Tiled", 0)) {
+            ui_float("Zoom in", &cam.position.z);
+            tiled_ui(&tmx);
+            ui_panel_end();
+        }
+        /*if( ui_panel("Spine", 0)) {
+            spine_ui(spn);
+            ui_panel_end();
+        }*/
+    }
+}
+
+// this demo supersedes following old sources:
+// https://github.com/r-lyeh/FWK/blob/45e34d7890b2b8fe1f4994f4b76e496280d83cb6/demos/00-audio.c
+// https://github.com/r-lyeh/FWK/blob/45e34d7890b2b8fe1f4994f4b76e496280d83cb6/demos/00-font.c
+// https://github.com/r-lyeh/FWK/blob/45e34d7890b2b8fe1f4994f4b76e496280d83cb6/demos/00-spine.c
+// https://github.com/r-lyeh/FWK/blob/45e34d7890b2b8fe1f4994f4b76e496280d83cb6/demos/00-sprite.c
+// https://github.com/r-lyeh/FWK/blob/45e34d7890b2b8fe1f4994f4b76e496280d83cb6/demos/00-tiled.c
+// https://github.com/r-lyeh/FWK/blob/45e34d7890b2b8fe1f4994f4b76e496280d83cb6/demos/00-tilemap.c

2023.9/demos/01-easing.c

@@ -0,0 +1,57 @@
+#include "fwk.h"
+
+struct {
+    float (*ease)(float);
+    const char *name;
+} easings[] = {
+    {ease_linear, "ease_linear"},
+    {ease_out_sine, "ease_out_sine"},
+    {ease_out_quad, "ease_out_quad"},
+    {ease_out_cubic, "ease_out_cubic"},
+    {ease_out_quart, "ease_out_quart"},
+    {ease_out_quint, "ease_out_quint"},
+    {ease_out_expo, "ease_out_expo"},
+    {ease_out_circ, "ease_out_circ"},
+    {ease_out_back, "ease_out_back"},
+    {ease_out_elastic, "ease_out_elastic"},
+    {ease_out_bounce, "ease_out_bounce"},
+    {ease_in_sine, "ease_in_sine"},
+    {ease_in_quad, "ease_in_quad"},
+    {ease_in_cubic, "ease_in_cubic"},
+    {ease_in_quart, "ease_in_quart"},
+    {ease_in_quint, "ease_in_quint"},
+    {ease_in_expo, "ease_in_expo"},
+    {ease_in_circ, "ease_in_circ"},
+    {ease_in_back, "ease_in_back"},
+    {ease_in_elastic, "ease_in_elastic"},
+    {ease_in_bounce, "ease_in_bounce"},
+    {ease_inout_sine, "ease_inout_sine"},
+    {ease_inout_quad, "ease_inout_quad"},
+    {ease_inout_cubic, "ease_inout_cubic"},
+    {ease_inout_quart, "ease_inout_quart"},
+    {ease_inout_quint, "ease_inout_quint"},
+    {ease_inout_expo, "ease_inout_expo"},
+    {ease_inout_circ, "ease_inout_circ"},
+    {ease_inout_back, "ease_inout_back"},
+    {ease_inout_elastic, "ease_inout_elastic"},
+    {ease_inout_bounce, "ease_inout_bounce"},
+    {ease_inout_perlin, "ease_inout_perlin"},
+};
+
+int main() {
+    window_create(0.75, WINDOW_SQUARE);
+    while(window_swap()) {
+        static double timer = 0; timer = fmod(timer+window_delta(), 2); // loops every 2s
+
+        static int open = 1;
+        if( ui_window("ease", &open) ) {
+            float linear_delta = timer / 2.f; // delta is [0..1]
+            for( int i = 0; i < countof(easings); ++i) {
+                float nonlinear_delta = easings[i].ease(linear_delta);
+                // visualize
+                ui_slider( easings[i].name, &nonlinear_delta );
+            }
+            ui_window_end();
+        }
+    }
+}

2023.9/demos/01-font.c

@@ -0,0 +1,111 @@
+#include "fwk.h"
+
+int main() {
+    window_create(75.0, WINDOW_MSAA8);
+
+    // style: our aliases
+    #define FONT_REGULAR   FONT_FACE1
+    #define FONT_ITALIC    FONT_FACE2
+    #define FONT_BOLD      FONT_FACE3
+    #define FONT_JAPANESE  FONT_FACE4
+    #define FONT_MONOSPACE FONT_FACE5
+
+    #define FONT_GRAY      FONT_COLOR2
+    #define FONT_ORANGE    FONT_COLOR3
+    #define FONT_LIME      FONT_COLOR4
+    #define FONT_GREEN     FONT_COLOR5
+    #define FONT_CYAN      FONT_COLOR6
+
+    #define FONT_LARGEST   FONT_H1
+    #define FONT_LARGE     FONT_H2
+    #define FONT_MEDIUM    FONT_H3
+    #define FONT_NORMAL    FONT_H4
+    #define FONT_SMALL     FONT_H5
+    #define FONT_TINY      FONT_H6
+
+    // style: atlas size, unicode ranges and font faces (up to 6 faces)
+    font_face(FONT_REGULAR,   "B612""-Regular.ttf", 48.f, FONT_EU|FONT_AR|FONT_RU|FONT_2048);
+    font_face(FONT_ITALIC,    "B612""-Italic.ttf", 48.f, FONT_EU|FONT_AR|FONT_RU|FONT_2048);
+    font_face(FONT_BOLD,      "B612""-Bold.ttf", 48.f, FONT_EU|FONT_AR|FONT_RU|FONT_2048);
+    font_face(FONT_JAPANESE,  "mplus-1p-medium.ttf", 48.f, FONT_JP|FONT_2048); // CJK|FONT_2048|FONT_OVERSAMPLE_Y);
+    font_face(FONT_MONOSPACE, "B612Mono""-Regular.ttf", 24.f, FONT_EU|FONT_512);
+
+    // style: colors (up to 10 colors)
+    font_color(FONT_GRAY,   RGB4(100,100,100,255));
+    font_color(FONT_ORANGE, RGB4(255,192,0,255));
+    font_color(FONT_LIME,   RGB4(192,255,0,255));
+    font_color(FONT_GREEN,  RGB4(0,255,192,255));
+    font_color(FONT_CYAN,   RGB4(0,192,255,255));
+
+    // prepare color highlighting for following code snippet
+    const char *source =
+        FONT_MONOSPACE FONT_LARGEST
+        "int main(int argc, char **argv) {\n"
+        "   for( int i = 0; i < 10; ++i)\n"
+        "   puts(\"hello world\");\n"
+        "   return 0;\n"
+        "}\n";
+    const void *colors = font_colorize(source, "void,int,char", "if,else,for,do,while,return,switch,case,break,default,");
+
+    // demo loop
+    while( window_swap() && !input(KEY_ESC) ) {
+        ddraw_grid(0);
+
+        // initial spacing
+        font_goto(0, 50);
+
+        // print a code snippet with syntax highlighting
+        font_highlight(source, colors);
+
+        // print a few strings with markup codes
+        font_print(
+            FONT_REGULAR
+            FONT_LARGEST  FONT_GRAY   "The quick "
+            FONT_LARGE    FONT_LIME   "brown "
+            FONT_MEDIUM   FONT_GRAY   "fox "
+            FONT_NORMAL   "jumps over "
+            FONT_SMALL    "the lazy "
+            FONT_TINY     "dog.\n");
+
+        font_print(
+            FONT_REGULAR FONT_LARGE FONT_CYAN
+            "Now is the time for all " FONT_ITALIC "good men " FONT_REGULAR "to come to the aid of " FONT_BOLD "the party.\n");
+
+        font_print(
+            FONT_ITALIC FONT_LARGE FONT_GREEN
+            "Ég get etið gler án þess að meiða mig!\n");
+
+        font_print(
+            FONT_BOLD FONT_LARGE FONT_ORANGE
+            "Эх, чужак! Общий съём цен шляп (юфть)—вдрызг!.\n");
+
+        font_print(
+            FONT_JAPANESE
+            "私はガラスを食べられます。それは私を傷つけません。\n");
+
+        font_print( "This text ");
+        font_print( "should display concatenated, ");
+        font_print( "as there are no linefeeds.\n" );
+
+        // i18n: pangrams.txt file, line browser
+        static int counter = 0;
+        static array(char*) lines; do_once lines = strsplit( vfs_read("pangrams.txt"), "\r\n" );
+        counter += input_down(KEY_RIGHT)-input_down(KEY_LEFT);
+        counter += counter < 0 ? array_count(lines) : 0;
+        font_print( va("<< %s >>\n", lines[counter % array_count(lines)]) );
+
+        // this does not work yet. you cant chain alignments yet...
+        //font_print(FONT_TOP "Top" FONT_MIDDLE "Middle" FONT_BASELINE "Baseline" FONT_BOTTOM "Bottom\n");
+        //font_print(FONT_LEFT "Left" FONT_CENTER "Center" FONT_RIGHT "Right\n");
+
+        // ... alignment must be the first tag in a string for now. this is a temporary hack.
+        font_print(FONT_LEFT     "left");
+        font_print(FONT_CENTER   "center");
+        font_print(FONT_RIGHT    "right");
+
+        font_print(FONT_TOP      FONT_CENTER "top\n");
+        font_print(FONT_MIDDLE   FONT_RIGHT  "middle\n");
+        font_print(FONT_BASELINE FONT_RIGHT  "baseline\n");
+        font_print(FONT_BOTTOM   FONT_CENTER "bottom\n");
+    }
+}