#if defined(SOKOL_IMPL) && !defined(SOKOL_APP_IMPL)
#define SOKOL_APP_IMPL
#endif
#ifndef SOKOL_APP_INCLUDED

/*
    V language IMPORTANT NOTE: all the V patches in this code, are marked with:
    // __v_ start
    // __v_ end
*/

/*
    sokol_app.h -- cross-platform application wrapper

    Project URL: https://github.com/floooh/sokol

    Do this:
        #define SOKOL_IMPL or
        #define SOKOL_APP_IMPL
    before you include this file in *one* C or C++ file to create the
    implementation.

    In the same place define one of the following to select the 3D-API
    which should be initialized by sokol_app.h (this must also match
    the backend selected for sokol_gfx.h if both are used in the same
    project):

        #define SOKOL_GLCORE
        #define SOKOL_GLES3
        #define SOKOL_D3D11
        #define SOKOL_METAL
        #define SOKOL_WGPU
        #define SOKOL_VULKAN
        #define SOKOL_NOAPI

    Optionally provide the following defines with your own implementations:

        SOKOL_ASSERT(c)             - your own assert macro (default: assert(c))
        SOKOL_UNREACHABLE()         - a guard macro for unreachable code
   (default: assert(false)) SOKOL_WIN32_FORCE_MAIN      - define this on Win32
   to add a main() entry point SOKOL_WIN32_FORCE_WINMAIN   - define this on
   Win32 to add a WinMain() entry point (enabled by default unless
                                      SOKOL_WIN32_FORCE_MAIN or SOKOL_NO_ENTRY
   is defined) SOKOL_NO_ENTRY              - define this if sokol_app.h
   shouldn't "hijack" the main() function SOKOL_APP_API_DECL          - public
   function declaration prefix (default: extern) SOKOL_API_DECL              -
   same as SOKOL_APP_API_DECL SOKOL_API_IMPL              - public function
   implementation prefix (default: -)

    Optionally define the following to force debug checks and validations
    even in release mode:

        SOKOL_DEBUG         - by default this is defined if NDEBUG is not
   defined

    If sokol_app.h is compiled as a DLL, define the following before
    including the declaration or implementation:

        SOKOL_DLL

    On Windows, SOKOL_DLL will define SOKOL_APP_API_DECL as
   __declspec(dllexport) or __declspec(dllimport) as needed.

    if SOKOL_WIN32_FORCE_MAIN and SOKOL_WIN32_FORCE_WINMAIN are both defined,
    it is up to the developer to define the desired subsystem.

    On Linux, SOKOL_GLCORE can use either GLX or EGL.
    GLX is default, set SOKOL_FORCE_EGL to override.

    For example code, see
   https://github.com/floooh/sokol-samples/tree/master/sapp

    Portions of the Windows and Linux GL initialization, event-, icon- etc...
   code have been taken from GLFW (http://www.glfw.org/).

    iOS onscreen keyboard support 'inspired' by libgdx.

    Link with the following system libraries:

    - on macOS:
        - all backends: Foundation, Cocoa, QuartzCore
        - with SOKOL_METAL: Metal, MetalKit
        - with SOKOL_GLCORE: OpenGL
        - with SOKOL_WGPU: a WebGPU implementation library (tested with
   webgpu_dawn)
    - on iOS:
        - all backends: Foundation, UIKit
        - with SOKOL_METAL: Metal, MetalKit
        - with SOKOL_GLES3: OpenGLES, GLKit
    - on Linux:
        - all backends: X11, Xi, Xcursor, dl, pthread, m
        - with SOKOL_GLCORE: GL
        - with SOKOL_GLES3: GLESv2
        - with SOKOL_WGPU: a WebGPU implementation library (tested with
   webgpu_dawn)
        - with SOKOL_VULKAN: vulkan
        - with EGL: EGL
    - on Android: GLESv3, EGL, log, android
    - on Windows:
        - with MSVC or Clang: library dependencies are defined via `#pragma
   comment`
        - with SOKOL_WGPU: a WebGPU implementation library (tested with
   webgpu_dawn)
        - with SOKOL_VULKAN:
            - install the Vulkan SDK
            - set a header search path to $VULKAN_SDK/Include
            - set a library search path to $VULKAN_SDK/Lib
            - link with vulkan-1.lib
        - with MINGW/MSYS2 gcc:
            - compile with '-mwin32' so that _WIN32 is defined
            - link with the following libs: -lkernel32 -luser32 -lshell32
            - additionally with the GL backend: -lgdi32
            - additionally with the D3D11 backend: -ld3d11 -ldxgi

    On Linux, you also need to use the -pthread compiler and linker option,
   otherwise weird things will happen, see here for details:
   https://github.com/floooh/sokol/issues/376

    For Linux+Vulkan install the following packages (or equivalents):
        - libvulkan-dev
        - vulkan-validationlayers
        - vulkan-tools

    On macOS and iOS, the implementation must be compiled as Objective-C.

    On Emscripten:
        - for WebGL2: add the linker option `-s USE_WEBGL2=1`
        - for WebGPU: compile and link with `--use-port=emdawnwebgpu`
          (for more exotic situations read:
   https://dawn.googlesource.com/dawn/+/refs/heads/main/src/emdawnwebgpu/pkg/README.md)

    FEATURE OVERVIEW
    ================
    sokol_app.h provides a minimalistic cross-platform API which
    implements the 'application-wrapper' parts of a 3D application:

    - a common application entry function
    - creates a window and 3D-API context/device with a swapchain
      surface, depth-stencil-buffer surface and optionally MSAA surface
    - makes the rendered frame visible
    - provides keyboard-, mouse- and low-level touch-events
    - platforms: MacOS, iOS, HTML5, Win32, Linux/RaspberryPi, Android
    - 3D-APIs: Metal, D3D11, GL4.1, GL4.3, GLES3, WebGL2, WebGPU, NOAPI

    FEATURE/PLATFORM MATRIX
    =======================
                        | Windows | macOS | Linux |  iOS  | Android |  HTML5
    --------------------+---------+-------+-------+-------+---------+--------
    gl 4.x              | YES     | YES   | YES   | ---   | ---     |  ---
    gles3/webgl2        | ---     | ---   | YES(2)| YES   | YES     |  YES
    metal               | ---     | YES   | ---   | YES   | ---     |  ---
    d3d11               | YES     | ---   | ---   | ---   | ---     |  ---
    webgpu              | YES(4)  | YES(4)| YES(4)| NO    | NO      |  YES
    noapi               | YES     | TODO  | TODO  | ---   | TODO    |  ---
    KEY_DOWN            | YES     | YES   | YES   | SOME  | TODO    |  YES
    KEY_UP              | YES     | YES   | YES   | SOME  | TODO    |  YES
    CHAR                | YES     | YES   | YES   | YES   | TODO    |  YES
    MOUSE_DOWN          | YES     | YES   | YES   | ---   | ---     |  YES
    MOUSE_UP            | YES     | YES   | YES   | ---   | ---     |  YES
    MOUSE_SCROLL        | YES     | YES   | YES   | ---   | ---     |  YES
    MOUSE_MOVE          | YES     | YES   | YES   | ---   | ---     |  YES
    MOUSE_ENTER         | YES     | YES   | YES   | ---   | ---     |  YES
    MOUSE_LEAVE         | YES     | YES   | YES   | ---   | ---     |  YES
    TOUCHES_BEGAN       | ---     | ---   | ---   | YES   | YES     |  YES
    TOUCHES_MOVED       | ---     | ---   | ---   | YES   | YES     |  YES
    TOUCHES_ENDED       | ---     | ---   | ---   | YES   | YES     |  YES
    TOUCHES_CANCELLED   | ---     | ---   | ---   | YES   | YES     |  YES
    RESIZED             | YES     | YES   | YES   | YES   | YES     |  YES
    ICONIFIED           | YES     | YES   | YES   | ---   | ---     |  ---
    RESTORED            | YES     | YES   | YES   | ---   | ---     |  ---
    FOCUSED             | YES     | YES   | YES   | ---   | ---     |  YES
    UNFOCUSED           | YES     | YES   | YES   | ---   | ---     |  YES
    SUSPENDED           | ---     | ---   | ---   | YES   | YES     |  TODO
    RESUMED             | ---     | ---   | ---   | YES   | YES     |  TODO
    QUIT_REQUESTED      | YES     | YES   | YES   | ---   | ---     |  YES
    IME                 | TODO    | TODO? | TODO  | ???   | TODO    |  ???
    key repeat flag     | YES     | YES   | YES   | ---   | ---     |  YES
    windowed            | YES     | YES   | YES   | ---   | ---     |  YES
    fullscreen          | YES     | YES   | YES   | YES   | YES     |  YES(3)
    mouse hide          | YES     | YES   | YES   | ---   | ---     |  YES
    mouse lock          | YES     | YES   | YES   | ---   | ---     |  YES
    set cursor type     | YES     | YES   | YES   | ---   | ---     |  YES
    screen keyboard     | ---     | ---   | ---   | YES   | TODO    |  YES
    swap interval       | YES     | YES   | YES   | YES   | TODO    |  YES
    high-dpi            | YES     | YES   | TODO  | YES   | YES     |  YES
    clipboard           | YES     | YES   | YES   | ---   | ---     |  YES
    MSAA                | YES     | YES   | YES   | YES   | YES     |  YES
    drag'n'drop         | YES     | YES   | YES   | ---   | ---     |  YES
    window icon         | YES     | YES(1)| YES   | ---   | ---     |  YES

    (1) macOS has no regular window icons, instead the dock icon is changed
    (2) supported with EGL only (not GLX)
    (3) fullscreen in the browser not supported on iphones
    (4) WebGPU on native desktop platforms should be considered experimental
        and mainly useful for debugging and benchmarking

    STEP BY STEP
    ============
    --- Add a sokol_main() function to your code which returns a sapp_desc
   structure with initialization parameters and callback function pointers. This
        function is called very early, usually at the start of the
        platform's entry function (e.g. main or WinMain). You should do as
        little as possible here, since the rest of your code might be called
        from another thread (this depends on the platform):

            sapp_desc sokol_main(int argc, char* argv[]) {
                return (sapp_desc) {
                    .width = 640,
                    .height = 480,
                    .init_cb = my_init_func,
                    .frame_cb = my_frame_func,
                    .cleanup_cb = my_cleanup_func,
                    .event_cb = my_event_func,
                    ...
                };
            }

        To get any logging output in case of errors you need to provide a log
        callback. The easiest way is via sokol_log.h:

            #include "sokol_log.h"

            sapp_desc sokol_main(int argc, char* argv[]) {
                return (sapp_desc) {
                    ...
                    .logger.func = slog_func,
                };
            }

        There are many more setup parameters, but these are the most important.
        For a complete list search for the sapp_desc structure declaration
        below.

        DO NOT call any sokol-app function from inside sokol_main(), since
        sokol-app will not be initialized at this point.

        The .width and .height parameters are the preferred size of the 3D
        rendering canvas. The actual size may differ from this depending on
        platform and other circumstances. Also the canvas size may change at
        any time (for instance when the user resizes the application window,
        or rotates the mobile device). You can just keep .width and .height
        zero-initialized to open a default-sized window (what "default-size"
        exactly means is platform-specific, but usually it's a size that covers
        most of, but not all, of the display).

        All provided function callbacks will be called from the same thread,
        but this may be different from the thread where sokol_main() was called.

        .init_cb (void (*)(void))
            This function is called once after the application window,
            3D rendering context and swap chain have been created. The
            function takes no arguments and has no return value.
        .frame_cb (void (*)(void))
            This is the per-frame callback, which is usually called 60
            times per second. This is where your application would update
            most of its state and perform all rendering.
        .cleanup_cb (void (*)(void))
            The cleanup callback is called once right before the application
            quits.
        .event_cb (void (*)(const sapp_event* event))
            The event callback is mainly for input handling, but is also
            used to communicate other types of events to the application. Keep
   the event_cb struct member zero-initialized if your application doesn't
   require event handling.

        As you can see, those 'standard callbacks' don't have a user_data
        argument, so any data that needs to be preserved between callbacks
        must live in global variables. If keeping state in global variables
        is not an option, there's an alternative set of callbacks with
        an additional user_data pointer argument:

        .user_data (void*)
            The user-data argument for the callbacks below
        .init_userdata_cb (void (*)(void* user_data))
        .frame_userdata_cb (void (*)(void* user_data))
        .cleanup_userdata_cb (void (*)(void* user_data))
        .event_userdata_cb (void(*)(const sapp_event* event, void* user_data))

        The function sapp_userdata() can be used to query the user_data
        pointer provided in the sapp_desc struct.

        You can also call sapp_query_desc() to get a copy of the
        original sapp_desc structure.

        NOTE that there's also an alternative compile mode where sokol_app.h
        doesn't "hijack" the main() function. Search below for SOKOL_NO_ENTRY.

    --- Implement the initialization callback function (init_cb), this is called
        once after the rendering surface, 3D API and swap chain have been
        initialized by sokol_app. All sokol-app functions can be called
        from inside the initialization callback, the most useful functions
        at this point are:

        int sapp_width(void)
        int sapp_height(void)
            Returns the current width and height of the default framebuffer in
   pixels, this may change from one frame to the next, and it may be different
            from the initial size provided in the sapp_desc struct.

        float sapp_widthf(void)
        float sapp_heightf(void)
            These are alternatives to sapp_width() and sapp_height() which
   return the default framebuffer size as float values instead of integer. This
            may help to prevent casting back and forth between int and float
            in more strongly typed languages than C and C++.

        double sapp_frame_duration(void)
            Returns the frame duration in seconds averaged over a number of
            frames to smooth out any jittering spikes.

        int sapp_color_format(void)
        int sapp_depth_format(void)
            The color and depth-stencil pixelformats of the default framebuffer,
            as integer values which are compatible with sokol-gfx's
            sg_pixel_format enum (so that they can be plugged directly in places
            where sg_pixel_format is expected). Possible values are:

                23 == SG_PIXELFORMAT_RGBA8
                28 == SG_PIXELFORMAT_BGRA8
                42 == SG_PIXELFORMAT_DEPTH
                43 == SG_PIXELFORMAT_DEPTH_STENCIL

        int sapp_sample_count(void)
            Return the MSAA sample count of the default framebuffer.

        const void* sapp_metal_get_device(void)
        const void* sapp_metal_get_current_drawable(void)
        const void* sapp_metal_get_depth_stencil_texture(void)
        const void* sapp_metal_get_msaa_color_texture(void)
            If the Metal backend has been selected, these functions return
   pointers to various Metal API objects required for rendering, otherwise they
   return a null pointer. These void pointers are actually Objective-C ids
   converted with a (ARC) __bridge cast so that the ids can be tunneled through
   C code. Also note that the returned pointers may change from one frame to the
   next, only the Metal device object is guaranteed to stay the same.

        const void* sapp_macos_get_window(void)
            On macOS, get the NSWindow object pointer, otherwise a null pointer.
            Before being used as Objective-C object, the void* must be converted
            back with a (ARC) __bridge cast.

        const void* sapp_ios_get_window(void)
            On iOS, get the UIWindow object pointer, otherwise a null pointer.
            Before being used as Objective-C object, the void* must be converted
            back with a (ARC) __bridge cast.

        const void* sapp_d3d11_get_device(void)
        const void* sapp_d3d11_get_device_context(void)
        const void* sapp_d3d11_get_render_view(void)
        const void* sapp_d3d11_get_resolve_view(void);
        const void* sapp_d3d11_get_depth_stencil_view(void)
            Similar to the sapp_metal_* functions, the sapp_d3d11_* functions
            return pointers to D3D11 API objects required for rendering,
            only if the D3D11 backend has been selected. Otherwise they
            return a null pointer. Note that the returned pointers to the
            render-target-view and depth-stencil-view may change from one
            frame to the next!

        const void* sapp_win32_get_hwnd(void)
            On Windows, get the window's HWND, otherwise a null pointer. The
            HWND has been cast to a void pointer in order to be tunneled
            through code which doesn't include Windows.h.

        const void* sapp_x11_get_window(void)
            On Linux, get the X11 Window, otherwise a null pointer. The
            Window has been cast to a void pointer in order to be tunneled
            through code which doesn't include X11/Xlib.h.

        const void* sapp_x11_get_display(void)
            On Linux, get the X11 Display, otherwise a null pointer. The
            Display has been cast to a void pointer in order to be tunneled
            through code which doesn't include X11/Xlib.h.

        const void* sapp_wgpu_get_device(void)
        const void* sapp_wgpu_get_render_view(void)
        const void* sapp_wgpu_get_resolve_view(void)
        const void* sapp_wgpu_get_depth_stencil_view(void)
            These are the WebGPU-specific functions to get the WebGPU
            objects and values required for rendering. If sokol_app.h
            is not compiled with SOKOL_WGPU, these functions return null.

        uint32_t sapp_gl_get_framebuffer(void)
            This returns the 'default framebuffer' of the GL context.
            Typically this will be zero.

        int sapp_gl_get_major_version(void)
        int sapp_gl_get_minor_version(void)
        bool sapp_gl_is_gles(void)
            Returns the major and minor version of the GL context and
            whether the GL context is a GLES context

        const void* sapp_android_get_native_activity(void);
            On Android, get the native activity ANativeActivity pointer,
   otherwise a null pointer.

    --- Implement the frame-callback function, this function will be called
        on the same thread as the init callback, but might be on a different
        thread than the sokol_main() function. Note that the size of
        the rendering framebuffer might have changed since the frame callback
        was called last. Call the functions sapp_width() and sapp_height()
        each frame to get the current size.

    --- Optionally implement the event-callback to handle input events.
        sokol-app provides the following type of input events:
            - a 'virtual key' was pressed down or released
            - a single text character was entered (provided as UTF-32 encoded
              UNICODE code point)
            - a mouse button was pressed down or released (left, right, middle)
            - mouse-wheel or 2D scrolling events
            - the mouse was moved
            - the mouse has entered or left the application window boundaries
            - low-level, portable multi-touch events (began, moved, ended,
   cancelled)
            - the application window was resized, iconified or restored
            - the application was suspended or restored (on mobile platforms)
            - the user or application code has asked to quit the application
            - a string was pasted to the system clipboard
            - one or more files have been dropped onto the application window

        To explicitly 'consume' an event and prevent that the event is
        forwarded for further handling to the operating system, call
        sapp_consume_event() from inside the event handler (NOTE that
        this behaviour is currently only implemented for some HTML5
        events, support for other platforms and event types will
        be added as needed, please open a GitHub ticket and/or provide
        a PR if needed).

        NOTE: Do *not* call any 3D API rendering functions in the event
        callback function, since the 3D API context may not be active when the
        event callback is called (it may work on some platforms and 3D APIs,
        but not others, and the exact behaviour may change between
        sokol-app versions).

    --- Implement the cleanup-callback function, this is called once
        after the user quits the application (see the section
        "APPLICATION QUIT" for detailed information on quitting
        behaviour, and how to intercept a pending quit - for instance to show a
        "Really Quit?" dialog box). Note that the cleanup-callback isn't
        guaranteed to be called on the web and mobile platforms.

    MOUSE CURSOR TYPE AND VISIBILITY
    ================================
    You can show and hide the mouse cursor with

        void sapp_show_mouse(bool show)

    And to get the current shown status:

        bool sapp_mouse_shown(void)

    NOTE that hiding the mouse cursor is different and independent from
    the MOUSE/POINTER LOCK feature which will also hide the mouse pointer when
    active (MOUSE LOCK is described below).

    To change the mouse cursor to one of several predefined types, call
    the function:

        void sapp_set_mouse_cursor(sapp_mouse_cursor cursor)

    Setting the default mouse cursor SAPP_MOUSECURSOR_DEFAULT will restore
    the standard look.

    To get the currently active mouse cursor type, call:

        sapp_mouse_cursor sapp_get_mouse_cursor(void)

    MOUSE LOCK (AKA POINTER LOCK, AKA MOUSE CAPTURE)
    ================================================
    In normal mouse mode, no mouse movement events are reported when the
    mouse leaves the windows client area or hits the screen border (whether
    it's one or the other depends on the platform), and the mouse move events
    (SAPP_EVENTTYPE_MOUSE_MOVE) contain absolute mouse positions in
    framebuffer pixels in the sapp_event items mouse_x and mouse_y, and
    relative movement in framebuffer pixels in the sapp_event items mouse_dx
    and mouse_dy.

    To get continuous mouse movement (also when the mouse leaves the window
    client area or hits the screen border), activate mouse-lock mode
    by calling:

        sapp_lock_mouse(true)

    When mouse lock is activated, the mouse pointer is hidden, the
    reported absolute mouse position (sapp_event.mouse_x/y) appears
    frozen, and the relative mouse movement in sapp_event.mouse_dx/dy
    no longer has a direct relation to framebuffer pixels but instead
    uses "raw mouse input" (what "raw mouse input" exactly means also
    differs by platform).

    To deactivate mouse lock and return to normal mouse mode, call

        sapp_lock_mouse(false)

    And finally, to check if mouse lock is currently active, call

        if (sapp_mouse_locked()) { ... }

    Note that mouse-lock state may not change immediately after
   sapp_lock_mouse(true/false) is called, instead on some platforms the actual
   state switch may be delayed to the end of the current frame or even to a
   later frame.

    The mouse may also be unlocked automatically without calling
   sapp_lock_mouse(false), most notably when the application window becomes
   inactive.

    On the web platform there are further restrictions to be aware of, caused
    by the limitations of the HTML5 Pointer Lock API:

        - sapp_lock_mouse(true) can be called at any time, but it will
          only take effect in a 'short-lived input event handler of a specific
          type', meaning when one of the following events happens:
            - SAPP_EVENTTYPE_MOUSE_DOWN
            - SAPP_EVENTTYPE_MOUSE_UP
            - SAPP_EVENTTYPE_MOUSE_SCROLL
            - SAPP_EVENTTYPE_KEY_UP
            - SAPP_EVENTTYPE_KEY_DOWN
        - The mouse lock/unlock action on the web platform is asynchronous,
          this means that sapp_mouse_locked() won't immediately return
          the new status after calling sapp_lock_mouse(), instead the
          reported status will only change when the pointer lock has actually
          been activated or deactivated in the browser.
        - On the web, mouse lock can be deactivated by the user at any time
          by pressing the Esc key. When this happens, sokol_app.h behaves
          the same as if sapp_lock_mouse(false) is called.

    For things like camera manipulation it's most straightforward to lock
    and unlock the mouse right from the sokol_app.h event handler, for
    instance the following code enters and leaves mouse lock when the
    left mouse button is pressed and released, and then uses the relative
    movement information to manipulate a camera (taken from the
    cgltf-sapp.c sample in the sokol-samples repository
    at https://github.com/floooh/sokol-samples):

        static void input(const sapp_event* ev) {
            switch (ev->type) {
                case SAPP_EVENTTYPE_MOUSE_DOWN:
                    if (ev->mouse_button == SAPP_MOUSEBUTTON_LEFT) {
                        sapp_lock_mouse(true);
                    }
                    break;

                case SAPP_EVENTTYPE_MOUSE_UP:
                    if (ev->mouse_button == SAPP_MOUSEBUTTON_LEFT) {
                        sapp_lock_mouse(false);
                    }
                    break;

                case SAPP_EVENTTYPE_MOUSE_MOVE:
                    if (sapp_mouse_locked()) {
                        cam_orbit(&state.camera, ev->mouse_dx * 0.25f,
   ev->mouse_dy * 0.25f);
                    }
                    break;

                default:
                    break;
            }
        }

    For a 'first person shooter mouse' the following code inside the sokol-app
   event handler is recommended somewhere in your frame callback:

        if (!sapp_mouse_locked()) {
            sapp_lock_mouse(true);
        }

    CLIPBOARD SUPPORT
    =================
    Applications can send and receive UTF-8 encoded text data from and to the
    system clipboard. By default, clipboard support is disabled and
    must be enabled at startup via the following sapp_desc struct
    members:

        sapp_desc.enable_clipboard  - set to true to enable clipboard support
        sapp_desc.clipboard_size    - size of the internal clipboard buffer in
   bytes

    Enabling the clipboard will dynamically allocate a clipboard buffer
    for UTF-8 encoded text data of the requested size in bytes, the default
    size is 8 KBytes. Strings that don't fit into the clipboard buffer
    (including the terminating zero) will be silently clipped, so it's
    important that you provide a big enough clipboard size for your
    use case.

    To send data to the clipboard, call sapp_set_clipboard_string() with
    a pointer to an UTF-8 encoded, null-terminated C-string.

    NOTE that on the HTML5 platform, sapp_set_clipboard_string() must be
    called from inside a 'short-lived event handler', and there are a few
    other HTML5-specific caveats to workaround. You'll basically have to
    tinker until it works in all browsers :/ (maybe the situation will
    improve when all browsers agree on and implement the new
    HTML5 navigator.clipboard API).

    To get data from the clipboard, check for the
   SAPP_EVENTTYPE_CLIPBOARD_PASTED event in your event handler function, and
   then call sapp_get_clipboard_string() to obtain the pasted UTF-8 encoded
   text.

    NOTE that behaviour of sapp_get_clipboard_string() is slightly different
    depending on platform:

        - on the HTML5 platform, the internal clipboard buffer will only be
   updated right before the SAPP_EVENTTYPE_CLIPBOARD_PASTED event is sent, and
   sapp_get_clipboard_string() will simply return the current content of the
   clipboard buffer
        - on 'native' platforms, the call to sapp_get_clipboard_string() will
          update the internal clipboard buffer with the most recent data
          from the system clipboard

    Portable code should check for the SAPP_EVENTTYPE_CLIPBOARD_PASTED event,
    and then call sapp_get_clipboard_string() right in the event handler.

    The SAPP_EVENTTYPE_CLIPBOARD_PASTED event will be generated by sokol-app
    as follows:

        - on macOS: when the Cmd+V key is pressed down
        - on HTML5: when the browser sends a 'paste' event to the global
   'window' object
        - on all other platforms: when the Ctrl+V key is pressed down

    DRAG AND DROP SUPPORT
    =====================
    PLEASE NOTE: the drag'n'drop feature works differently on WASM/HTML5
    and on the native desktop platforms (Win32, Linux and macOS) because
    of security-related restrictions in the HTML5 drag'n'drop API. The
    WASM/HTML5 specifics are described at the end of this documentation
    section:

    Like clipboard support, drag'n'drop support must be explicitly enabled
    at startup in the sapp_desc struct.

        sapp_desc sokol_main(void) {
            return (sapp_desc) {
                .enable_dragndrop = true,   // default is false
                ...
            };
        }

    You can also adjust the maximum number of files that are accepted
    in a drop operation, and the maximum path length in bytes if needed:

        sapp_desc sokol_main(void) {
            return (sapp_desc) {
                .enable_dragndrop = true,               // default is false
                .max_dropped_files = 8,                 // default is 1
                .max_dropped_file_path_length = 8192,   // in bytes, default is
   2048
                ...
            };
        }

    When drag'n'drop is enabled, the event callback will be invoked with an
    event of type SAPP_EVENTTYPE_FILES_DROPPED whenever the user drops files on
    the application window.

    After the SAPP_EVENTTYPE_FILES_DROPPED is received, you can query the
    number of dropped files, and their absolute paths by calling separate
    functions:

        void on_event(const sapp_event* ev) {
            if (ev->type == SAPP_EVENTTYPE_FILES_DROPPED) {

                // the mouse position where the drop happened
                float x = ev->mouse_x;
                float y = ev->mouse_y;

                // get the number of files and their paths like this:
                const int num_dropped_files = sapp_get_num_dropped_files();
                for (int i = 0; i < num_dropped_files; i++) {
                    const char* path = sapp_get_dropped_file_path(i);
                    ...
                }
            }
        }

    The returned file paths are UTF-8 encoded strings.

    You can call sapp_get_num_dropped_files() and sapp_get_dropped_file_path()
    anywhere, also outside the event handler callback, but be aware that the
    file path strings will be overwritten with the next drop operation.

    In any case, sapp_get_dropped_file_path() will never return a null pointer,
    instead an empty string "" will be returned if the drag'n'drop feature
    hasn't been enabled, the last drop-operation failed, or the file path index
    is out of range.

    Drag'n'drop caveats:

        - if more files are dropped in a single drop-action
          than sapp_desc.max_dropped_files, the additional
          files will be silently ignored
        - if any of the file paths is longer than
          sapp_desc.max_dropped_file_path_length (in number of bytes, after
   UTF-8 encoding) the entire drop operation will be silently ignored (this
          needs some sort of error feedback in the future)
        - no mouse positions are reported while the drag is in
          process, this may change in the future

    Drag'n'drop on HTML5/WASM:

    The HTML5 drag'n'drop API doesn't return file paths, but instead
    black-box 'file objects' which must be used to load the content
    of dropped files. This is the reason why sokol_app.h adds two
    HTML5-specific functions to the drag'n'drop API:

        uint32_t sapp_html5_get_dropped_file_size(int index)
            Returns the size in bytes of a dropped file.

        void sapp_html5_fetch_dropped_file(const sapp_html5_fetch_request*
   request) Asynchronously loads the content of a dropped file into a provided
   memory buffer (which must be big enough to hold the file content)

    To start loading the first dropped file after an
   SAPP_EVENTTYPE_FILES_DROPPED event is received:

        sapp_html5_fetch_dropped_file(&(sapp_html5_fetch_request){
            .dropped_file_index = 0,
            .callback = fetch_cb
            .buffer = {
                .ptr = buf,
                .size = sizeof(buf)
            },
            .user_data = ...
        });

    Make sure that the memory pointed to by 'buf' stays valid until the
    callback function is called!

    As result of the asynchronous loading operation (no matter if succeeded or
    failed) the 'fetch_cb' function will be called:

        void fetch_cb(const sapp_html5_fetch_response* response) {
            // IMPORTANT: check if the loading operation actually succeeded:
            if (response->succeeded) {
                // the size of the loaded file:
                const size_t num_bytes = response->data.size;
                // and the pointer to the data (same as 'buf' in the
   fetch-call): const void* ptr = response->data.ptr; } else {
                // on error check the error code:
                switch (response->error_code) {
                    case SAPP_HTML5_FETCH_ERROR_BUFFER_TOO_SMALL:
                        ...
                        break;
                    case SAPP_HTML5_FETCH_ERROR_OTHER:
                        ...
                        break;
                }
            }
        }

    Check the droptest-sapp example for a real-world example which works
    both on native platforms and the web:

    https://github.com/floooh/sokol-samples/blob/master/sapp/droptest-sapp.c

    HIGH-DPI RENDERING
    ==================
    You can set the sapp_desc.high_dpi flag during initialization to request
    a full-resolution framebuffer on HighDPI displays. The default behaviour
    is sapp_desc.high_dpi=false, this means that the application will
    render to a lower-resolution framebuffer on HighDPI displays and the
    rendered content will be upscaled by the window system composer.

    In a HighDPI scenario, you still request the same window size during
    sokol_main(), but the framebuffer sizes returned by sapp_width()
    and sapp_height() will be scaled up according to the DPI scaling
    ratio.

    Note that on some platforms the DPI scaling factor may change at any
    time (for instance when a window is moved from a high-dpi display
    to a low-dpi display).

    To query the current DPI scaling factor, call the function:

    float sapp_dpi_scale(void);

    For instance on a Retina Mac, returning the following sapp_desc
    struct from sokol_main():

    sapp_desc sokol_main(void) {
        return (sapp_desc) {
            .width = 640,
            .height = 480,
            .high_dpi = true,
            ...
        };
    }

    ...the functions the functions sapp_width(), sapp_height()
    and sapp_dpi_scale() will return the following values:

    sapp_width:     1280
    sapp_height:    960
    sapp_dpi_scale: 2.0

    If the high_dpi flag is false, or you're not running on a Retina display,
    the values would be:

    sapp_width:     640
    sapp_height:    480
    sapp_dpi_scale: 1.0

    If the window is moved from the Retina display to a low-dpi external
   display, the values would change as follows:

    sapp_width:     1280 => 640
    sapp_height:    960  => 480
    sapp_dpi_scale: 2.0  => 1.0

    Currently there is no event associated with a DPI change, but an
    SAPP_EVENTTYPE_RESIZED will be sent as a side effect of the
    framebuffer size changing.

    Per-monitor DPI is currently supported on macOS and Windows.

    APPLICATION QUIT
    ================
    Without special quit handling, a sokol_app.h application will quit
    'gracefully' when the user clicks the window close-button unless a
    platform's application model prevents this (e.g. on web or mobile).
    'Graceful exit' means that the application-provided cleanup callback will
    be called before the application quits.

    On native desktop platforms sokol_app.h provides more control over the
    application-quit-process. It's possible to initiate a 'programmatic quit'
    from the application code, and a quit initiated by the application user can
    be intercepted (for instance to show a custom dialog box).

    This 'programmatic quit protocol' is implemented through 3 functions
    and 1 event:

        - sapp_quit(): This function simply quits the application without
          giving the user a chance to intervene. Usually this might
          be called when the user clicks the 'Ok' button in a 'Really Quit?'
          dialog box
        - sapp_request_quit(): Calling sapp_request_quit() will send the
          event SAPP_EVENTTYPE_QUIT_REQUESTED to the applications event handler
          callback, giving the user code a chance to intervene and cancel the
          pending quit process (for instance to show a 'Really Quit?' dialog
          box). If the event handler callback does nothing, the application
          will be quit as usual. To prevent this, call the function
          sapp_cancel_quit() from inside the event handler.
        - sapp_cancel_quit(): Cancels a pending quit request, either initiated
          by the user clicking the window close button, or programmatically
          by calling sapp_request_quit(). The only place where calling this
          function makes sense is from inside the event handler callback when
          the SAPP_EVENTTYPE_QUIT_REQUESTED event has been received.
        - SAPP_EVENTTYPE_QUIT_REQUESTED: this event is sent when the user
          clicks the window's close button or application code calls the
          sapp_request_quit() function. The event handler callback code can
   handle this event by calling sapp_cancel_quit() to cancel the quit. If the
   event is ignored, the application will quit as usual.

    On the web platform, the quit behaviour differs from native platforms,
    because of web-specific restrictions:

    A `programmatic quit` initiated by calling sapp_quit() or
    sapp_request_quit() will work as described above: the cleanup callback is
    called, platform-specific cleanup is performed (on the web
    this means that JS event handlers are unregistered), and then
    the request-animation-loop will be exited. However that's all. The
    web page itself will continue to exist (e.g. it's not possible to
    programmatically close the browser tab).

    On the web it's also not possible to run custom code when the user
    closes a browser tab, so it's not possible to prevent this with a
    fancy custom dialog box.

    Instead the standard "Leave Site?" dialog box can be activated (or
    deactivated) with the following function:

        sapp_html5_ask_leave_site(bool ask);

    The initial state of the associated internal flag can be provided
    at startup via sapp_desc.html5.ask_leave_site.

    This feature should only be used sparingly in critical situations - for
    instance when the user would loose data - since popping up modal dialog
    boxes is considered quite rude in the web world. Note that there's no way
    to customize the content of this dialog box or run any code as a result
    of the user's decision. Also note that the user must have interacted with
    the site before the dialog box will appear. These are all security measures
    to prevent fishing.

    The Dear ImGui HighDPI sample contains example code of how to
    implement a 'Really Quit?' dialog box with Dear ImGui (native desktop
    platforms only), and for showing the hardwired "Leave Site?" dialog box
    when running on the web platform:

        https://floooh.github.io/sokol-html5/wasm/imgui-highdpi-sapp.html

    FULLSCREEN
    ==========
    If the sapp_desc.fullscreen flag is true, sokol-app will try to create
    a fullscreen window on platforms with a 'proper' window system
    (mobile devices will always use fullscreen). The implementation details
    depend on the target platform, in general sokol-app will use a
    'soft approach' which doesn't interfere too much with the platform's
    window system (for instance borderless fullscreen window instead of
    a 'real' fullscreen mode). Such details might change over time
    as sokol-app is adapted for different needs.

    The most important effect of fullscreen mode to keep in mind is that
    the requested canvas width and height will be ignored for the initial
    window size, calling sapp_width() and sapp_height() will instead return
    the resolution of the fullscreen canvas (however the provided size
    might still be used for the non-fullscreen window, in case the user can
    switch back from fullscreen- to windowed-mode).

    To toggle fullscreen mode programmatically, call sapp_toggle_fullscreen().

    To check if the application window is currently in fullscreen mode,
    call sapp_is_fullscreen().

    On the web, sapp_desc.fullscreen will have no effect, and the application
    will always start in non-fullscreen mode. Call sapp_toggle_fullscreen()
    from within or 'near' an input event to switch to fullscreen
   programatically. Note that on the web, the fullscreen state may change back
   to windowed at any time (either because the browser had rejected switching
   into fullscreen, or the user leaves fullscreen via Esc), this means that the
   result of sapp_is_fullscreen() may change also without calling
   sapp_toggle_fullscreen()!


    WINDOW ICON SUPPORT
    ===================
    Some sokol_app.h backends allow to change the window icon programmatically:

        - on Win32: the small icon in the window's title bar, and the
          bigger icon in the task bar
        - on Linux: highly dependent on the used window manager, but usually
          the window's title bar icon and/or the task bar icon
        - on HTML5: the favicon shown in the page's browser tab
        - on macOS: the application icon shown in the dock, but only
          for currently running applications

    NOTE that it is not possible to set the actual application icon which is
    displayed by the operating system on the desktop or 'home screen'. Those
    icons must be provided 'traditionally' through operating-system-specific
    resources which are associated with the application (sokol_app.h might
    later support setting the window icon from platform specific resource data
    though).

    There are two ways to set the window icon:

        - at application start in the sokol_main() function by initializing
          the sapp_desc.icon nested struct
        - or later by calling the function sapp_set_icon()

    As a convenient shortcut, sokol_app.h comes with a builtin default-icon
    (a rainbow-colored 'S', which at least looks a bit better than the Windows
    default icon for applications), which can be activated like this:

    At startup in sokol_main():

        sapp_desc sokol_main(...) {
            return (sapp_desc){
                ...
                icon.sokol_default = true
            };
        }

    Or later by calling:

        sapp_set_icon(&(sapp_icon_desc){ .sokol_default = true });

    NOTE that a completely zero-initialized sapp_icon_desc struct will not
    update the window icon in any way. This is an 'escape hatch' so that you
    can handle the window icon update yourself (or if you do this already,
    sokol_app.h won't get in your way, in this case just leave the
    sapp_desc.icon struct zero-initialized).

    Providing your own icon images works exactly like in GLFW (down to the
    data format):

    You provide one or more 'candidate images' in different sizes, and the
    sokol_app.h platform backends pick the best match for the specific backend
    and icon type.

    For each candidate image, you need to provide:

        - the width in pixels
        - the height in pixels
        - and the actual pixel data in RGBA8 pixel format (e.g. 0xFFCC8844
          on a little-endian CPU means: alpha=0xFF, blue=0xCC, green=0x88,
   red=0x44)

    For instance, if you have 3 candidate images (small, medium, big) of
    sizes 16x16, 32x32 and 64x64 the corresponding sapp_icon_desc struct is
   setup like this:

        // the actual pixel data (RGBA8, origin top-left)
        const uint32_t small[16][16]  = { ... };
        const uint32_t medium[32][32] = { ... };
        const uint32_t big[64][64]    = { ... };

        const sapp_icon_desc icon_desc = {
            .images = {
                { .width = 16, .height = 16, .pixels = SAPP_RANGE(small) },
                { .width = 32, .height = 32, .pixels = SAPP_RANGE(medium) },
                // ...or without the SAPP_RANGE helper macro:
                { .width = 64, .height = 64, .pixels = { .ptr=big,
   .size=sizeof(big) } }
            }
        };

    An sapp_icon_desc struct initialized like this can then either be applied
    at application start in sokol_main:

        sapp_desc sokol_main(...) {
            return (sapp_desc){
                ...
                icon = icon_desc
            };
        }

    ...or later by calling sapp_set_icon():

        sapp_set_icon(&icon_desc);

    Some window icon caveats:

        - once the window icon has been updated, there's no way to go back to
          the platform's default icon, this is because some platforms (Linux
          and HTML5) don't switch the icon visual back to the default even if
          the custom icon is deleted or removed
        - on HTML5, if the sokol_app.h icon doesn't show up in the browser
          tab, check that there's no traditional favicon 'link' element
          is defined in the page's index.html, sokol_app.h will only
          append a new favicon link element, but not delete any manually
          defined favicon in the page

    For an example and test of the window icon feature, check out the
    'icon-sapp' sample on the sokol-samples git repository.

    ONSCREEN KEYBOARD
    =================
    On some platforms which don't provide a physical keyboard, sokol-app
    can display the platform's integrated onscreen keyboard for text
    input. To request that the onscreen keyboard is shown, call

        sapp_show_keyboard(true);

    Likewise, to hide the keyboard call:

        sapp_show_keyboard(false);

    Note that onscreen keyboard functionality is no longer supported
    on the browser platform (the previous hacks and workarounds to make browser
    keyboards work for on web applications that don't use HTML UIs
    never really worked across browsers).

    INPUT EVENT BUBBLING ON THE WEB PLATFORM
    ========================================
    By default, input event bubbling on the web platform is configured in
    a way that makes the most sense for 'full-canvas' apps that cover the
    entire browser client window area:

    - mouse, touch and wheel events do not bubble up, this prevents various
      ugly side events, like:
        - HTML text overlays being selected on double- or triple-click into
          the canvas
        - 'scroll bumping' even when the canvas covers the entire client area
    - key_up/down events for 'character keys' *do* bubble up (otherwise
      the browser will not generate UNICODE character events)
    - all other key events *do not* bubble up by default (this prevents side
   effects like F1 opening help, or F7 starting 'caret browsing')
    - character events do not bubble up (although I haven't noticed any side
   effects otherwise)

    Event bubbling can be enabled for input event categories during
   initialization in the sapp_desc struct:

        sapp_desc sokol_main(int argc, char* argv[]) {
            return (sapp_desc){
                //...
                .html5 = {
                    .bubble_mouse_events = true,
                    .bubble_touch_events = true,
                    .bubble_wheel_events = true,
                    .bubble_key_events = true,
                    .bubble_char_events = true,
                }
            };
        }

    This basically opens the floodgates and lets *all* input events bubble up to
   the browser.

    To prevent individual events from bubbling, call sapp_consume_event() from
   within the sokol_app.h event callback when that specific event is reported.


    SETTING THE CANVAS OBJECT ON THE WEB PLATFORM
    =============================================
    On the web, sokol_app.h and the Emscripten SDK functions need to find
    the WebGL/WebGPU canvas intended for rendering and attaching event
    handlers. This can happen in four ways:

    1. do nothing and just set the id of the canvas object to 'canvas'
   (preferred)
    2. via a CSS Selector string (preferred)
    3. by setting the `Module.canvas` property to the canvas object
    4. by adding the canvas object to the global variable `specialHTMLTargets[]`
       (this is a special variable used by the Emscripten runtime to lookup
       event target objects for which document.querySelector() cannot be used)

    The easiest way is to just name your canvas object 'canvas':

        <canvas id="canvas" ...></canvas>

    This works because the default css selector string used by sokol_app.h
    is '#canvas'.

    If you name your canvas differently, you need to communicate that name to
    sokol_app.h via `sapp_desc.html5.canvas_selector` as a regular css selector
    string that's compatible with `document.querySelector()`. E.g. if your
   canvas object looks like this:

        <canvas id="bla" ...></canvas>

    The `sapp_desc.html5.canvas_selector` string must be set to '#bla':

        .html5.canvas_selector = "#bla"

    If the canvas object cannot be looked up via `document.querySelector()` you
    need to use one of the alternative methods, both involve the special
    Emscripten runtime `Module` object which is usually setup in the index.html
    like this before the WASM blob is loaded and instantiated:

        <script type='text/javascript'>
            var Module = {
                // ...
            };
        </script>

    The first option is to set the `Module.canvas` property to your canvas
   object:

        <script type='text/javascript'>
            var Module = {
                canvas: my_canvas_object,
            };
        </script>

    When sokol_app.h initializes, it will check the global Module object whether
    a `Module.canvas` property exists and is an object. This method will add
    a new entry to the `specialHTMLTargets[]` object

    The other option is to add the canvas under a name chosen by you to the
    special `specialHTMLTargets[]` map, which is used by the Emscripten runtime
    to lookup 'event target objects' which are not visible to
   `document.querySelector()`. Note that `specialHTMLTargets[]` must be updated
   after the Emscripten runtime has started but before the WASM code is running.
   A good place for this is the special `Module.preRun` array in index.html:

        <script type='text/javascript'>
            var Module = {
                preRun: [
                    () => {
                        specialHTMLTargets['my_canvas'] = my_canvas_object;
                    }
                ],
            };
        </script>

    In that case, pass the same string to sokol_app.h which is used as key
    in the specialHTMLTargets[] map:

        .html5.canvas_selector = "my_canvas"

    If sokol_app.h can't find your canvas for some reason check for warning
    messages on the browser console.


    OPTIONAL: DON'T HIJACK main() (#define SOKOL_NO_ENTRY)
    ======================================================
    NOTE: SOKOL_NO_ENTRY and sapp_run() is currently not supported on Android.

    In its default configuration, sokol_app.h "hijacks" the platform's
    standard main() function. This was done because different platforms
    have different entry point conventions which are not compatible with
    C's main() (for instance WinMain on Windows has completely different
    arguments). However, this "main hijacking" posed a problem for
    usage scenarios like integrating sokol_app.h with other languages than
    C or C++, so an alternative SOKOL_NO_ENTRY mode has been added
    in which the user code provides the platform's main function:

    - define SOKOL_NO_ENTRY before including the sokol_app.h implementation
    - do *not* provide a sokol_main() function
    - instead provide the standard main() function of the platform
    - from the main function, call the function ```sapp_run()``` which
      takes a pointer to an ```sapp_desc``` structure.
    - from here on```sapp_run()``` takes over control and calls the provided
      init-, frame-, event- and cleanup-callbacks just like in the default
   model.

    sapp_run() behaves differently across platforms:

        - on some platforms, sapp_run() will return when the application quits
        - on other platforms, sapp_run() will never return, even when the
          application quits (the operating system is free to simply terminate
          the application at any time)
        - on Emscripten specifically, sapp_run() will return immediately while
          the frame callback keeps being called

    This different behaviour of sapp_run() essentially means that there
   shouldn't be any code *after* sapp_run(), because that may either never be
   called, or in case of Emscripten will be called at an unexpected time (at
   application start).

    An application also should not depend on the cleanup-callback being called
    when cross-platform compatibility is required.

    Since sapp_run() returns immediately on Emscripten you shouldn't activate
    the 'EXIT_RUNTIME' linker option (this is disabled by default when compiling
    for the browser target), since the C/C++ exit runtime would be called
   immediately at application start, causing any global objects to be destroyed
   and global variables to be zeroed.

    WINDOWS CONSOLE OUTPUT
    ======================
    On Windows, regular windowed applications don't show any stdout/stderr text
    output, which can be a bit of a hassle for printf() debugging or generally
    logging text to the console. Also, console output by default uses a local
    codepage setting and thus international UTF-8 encoded text is printed
    as garbage.

    To help with these issues, sokol_app.h can be configured at startup
    via the following Windows-specific sapp_desc flags:

        sapp_desc.win32.console_utf8 (default: false)
            When set to true, the output console codepage will be switched
            to UTF-8 (and restored to the original codepage on exit)

        sapp_desc.win32.console_attach (default: false)
            When set to true, stdout and stderr will be attached to the
            console of the parent process (if the parent process actually
            has a console). This means that if the application was started
            in a command line window, stdout and stderr output will be printed
            to the terminal, just like a regular command line program. But if
            the application is started via double-click, it will behave like
            a regular UI application, and stdout/stderr will not be visible.

        sapp_desc.win32.console_create (default: false)
            When set to true, a new console window will be created and
            stdout/stderr will be redirected to that console window. It
            doesn't matter if the application is started from the command
            line or via double-click.

            NOTE: setting both win32.console_attach and win32.console_create
            to true also makes sense and has the effect that output
            will appear in the existing terminal when started from the cmdline,
   and otherwise (when started via double-click) will open a console window.

    MEMORY ALLOCATION OVERRIDE
    ==========================
    You can override the memory allocation functions at initialization time
    like this:

        void* my_alloc(size_t size, void* user_data) {
            return malloc(size);
        }

        void my_free(void* ptr, void* user_data) {
            free(ptr);
        }

        sapp_desc sokol_main(int argc, char* argv[]) {
            return (sapp_desc){
                // ...
                .allocator = {
                    .alloc_fn = my_alloc,
                    .free_fn = my_free,
                    .user_data = ...,
                }
            };
        }

    If no overrides are provided, malloc and free will be used.

    This only affects memory allocation calls done by sokol_app.h
    itself though, not any allocations in OS libraries.


    ERROR REPORTING AND LOGGING
    ===========================
    To get any logging information at all you need to provide a logging callback
   in the setup call the easiest way is to use sokol_log.h:

        #include "sokol_log.h"

        sapp_desc sokol_main(int argc, char* argv[]) {
            return (sapp_desc) {
                ...
                .logger.func = slog_func,
            };
        }

    To override logging with your own callback, first write a logging function
   like this:

        void my_log(const char* tag,                // e.g. 'sapp'
                    uint32_t log_level,             // 0=panic, 1=error, 2=warn,
   3=info uint32_t log_item_id,           // SAPP_LOGITEM_* const char*
   message_or_null,    // a message string, may be nullptr in release mode
                    uint32_t line_nr,               // line number in
   sokol_app.h const char* filename_or_null,   // source filename, may be
   nullptr in release mode void* user_data)
        {
            ...
        }

    ...and then setup sokol-app like this:

        sapp_desc sokol_main(int argc, char* argv[]) {
            return (sapp_desc) {
                ...
                .logger = {
                    .func = my_log,
                    .user_data = my_user_data,
                }
            };
        }

    The provided logging function must be reentrant (e.g. be callable from
    different threads).

    If you don't want to provide your own custom logger it is highly recommended
   to use the standard logger in sokol_log.h instead, otherwise you won't see
   any warnings or errors.

    TEMP NOTE DUMP
    ==============
    - sapp_desc needs a bool whether to initialize depth-stencil surface
    - the Android implementation calls cleanup_cb() and destroys the egl context
   in onDestroy at the latest but should do it earlier, in onStop, as an app is
   "killable" after onStop on Android Honeycomb and later (it can't be done at
   the moment as the app may be started again after onStop and the sokol
   lifecycle does not yet handle context teardown/bringup)


    LICENSE
    =======
    zlib/libpng license

    Copyright (c) 2018 Andre Weissflog

    This software is provided 'as-is', without any express or implied warranty.
    In no event will the authors be held liable for any damages arising from the
    use of this software.

    Permission is granted to anyone to use this software for any purpose,
    including commercial applications, and to alter it and redistribute it
    freely, subject to the following restrictions:

        1. The origin of this software must not be misrepresented; you must not
        claim that you wrote the original software. If you use this software in
   a product, an acknowledgment in the product documentation would be
        appreciated but is not required.

        2. Altered source versions must be plainly marked as such, and must not
        be misrepresented as being the original software.

        3. This notice may not be removed or altered from any source
        distribution.
*/
#define SOKOL_APP_INCLUDED (1)
#include <stdbool.h>
#include <stddef.h> // size_t
#include <stdint.h>

#if defined(SOKOL_API_DECL) && !defined(SOKOL_APP_API_DECL)
#define SOKOL_APP_API_DECL SOKOL_API_DECL
#endif
#ifndef SOKOL_APP_API_DECL
#if defined(_WIN32) && defined(SOKOL_DLL) && defined(SOKOL_APP_IMPL)
#define SOKOL_APP_API_DECL __declspec(dllexport)
#elif defined(_WIN32) && defined(SOKOL_DLL)
#define SOKOL_APP_API_DECL __declspec(dllimport)
#else
#define SOKOL_APP_API_DECL extern
#endif
#endif

#ifdef __cplusplus
extern "C" {
#endif

/* misc constants */
enum {
  SAPP_MAX_TOUCHPOINTS = 8,
  SAPP_MAX_MOUSEBUTTONS = 3,
  SAPP_MAX_KEYCODES = 512,
  SAPP_MAX_ICONIMAGES = 8,
};

/*
    sapp_event_type

    The type of event that's passed to the event handler callback
    in the sapp_event.type field. These are not just "traditional"
    input events, but also notify the application about state changes
    or other user-invoked actions.
*/
typedef enum sapp_event_type {
  SAPP_EVENTTYPE_INVALID,
  SAPP_EVENTTYPE_KEY_DOWN,
  SAPP_EVENTTYPE_KEY_UP,
  SAPP_EVENTTYPE_CHAR,
  SAPP_EVENTTYPE_MOUSE_DOWN,
  SAPP_EVENTTYPE_MOUSE_UP,
  SAPP_EVENTTYPE_MOUSE_SCROLL,
  SAPP_EVENTTYPE_MOUSE_MOVE,
  SAPP_EVENTTYPE_MOUSE_ENTER,
  SAPP_EVENTTYPE_MOUSE_LEAVE,
  SAPP_EVENTTYPE_TOUCHES_BEGAN,
  SAPP_EVENTTYPE_TOUCHES_MOVED,
  SAPP_EVENTTYPE_TOUCHES_ENDED,
  SAPP_EVENTTYPE_TOUCHES_CANCELLED,
  SAPP_EVENTTYPE_RESIZED,
  SAPP_EVENTTYPE_ICONIFIED,
  SAPP_EVENTTYPE_RESTORED,
  SAPP_EVENTTYPE_FOCUSED,
  SAPP_EVENTTYPE_UNFOCUSED,
  SAPP_EVENTTYPE_SUSPENDED,
  SAPP_EVENTTYPE_RESUMED,
  SAPP_EVENTTYPE_QUIT_REQUESTED,
  SAPP_EVENTTYPE_CLIPBOARD_PASTED,
  SAPP_EVENTTYPE_FILES_DROPPED,
  _SAPP_EVENTTYPE_NUM,
  _SAPP_EVENTTYPE_FORCE_U32 = 0x7FFFFFFF
} sapp_event_type;

/*
    sapp_keycode

    The 'virtual keycode' of a KEY_DOWN or KEY_UP event in the
    struct field sapp_event.key_code.

    Note that the keycode values are identical with GLFW.
*/
typedef enum sapp_keycode {
  SAPP_KEYCODE_INVALID = 0,
  SAPP_KEYCODE_SPACE = 32,
  SAPP_KEYCODE_APOSTROPHE = 39, /* ' */
  SAPP_KEYCODE_COMMA = 44,      /* , */
  SAPP_KEYCODE_MINUS = 45,      /* - */
  SAPP_KEYCODE_PERIOD = 46,     /* . */
  SAPP_KEYCODE_SLASH = 47,      /* / */
  SAPP_KEYCODE_0 = 48,
  SAPP_KEYCODE_1 = 49,
  SAPP_KEYCODE_2 = 50,
  SAPP_KEYCODE_3 = 51,
  SAPP_KEYCODE_4 = 52,
  SAPP_KEYCODE_5 = 53,
  SAPP_KEYCODE_6 = 54,
  SAPP_KEYCODE_7 = 55,
  SAPP_KEYCODE_8 = 56,
  SAPP_KEYCODE_9 = 57,
  SAPP_KEYCODE_SEMICOLON = 59, /* ; */
  SAPP_KEYCODE_EQUAL = 61,     /* = */
  SAPP_KEYCODE_A = 65,
  SAPP_KEYCODE_B = 66,
  SAPP_KEYCODE_C = 67,
  SAPP_KEYCODE_D = 68,
  SAPP_KEYCODE_E = 69,
  SAPP_KEYCODE_F = 70,
  SAPP_KEYCODE_G = 71,
  SAPP_KEYCODE_H = 72,
  SAPP_KEYCODE_I = 73,
  SAPP_KEYCODE_J = 74,
  SAPP_KEYCODE_K = 75,
  SAPP_KEYCODE_L = 76,
  SAPP_KEYCODE_M = 77,
  SAPP_KEYCODE_N = 78,
  SAPP_KEYCODE_O = 79,
  SAPP_KEYCODE_P = 80,
  SAPP_KEYCODE_Q = 81,
  SAPP_KEYCODE_R = 82,
  SAPP_KEYCODE_S = 83,
  SAPP_KEYCODE_T = 84,
  SAPP_KEYCODE_U = 85,
  SAPP_KEYCODE_V = 86,
  SAPP_KEYCODE_W = 87,
  SAPP_KEYCODE_X = 88,
  SAPP_KEYCODE_Y = 89,
  SAPP_KEYCODE_Z = 90,
  SAPP_KEYCODE_LEFT_BRACKET = 91,  /* [ */
  SAPP_KEYCODE_BACKSLASH = 92,     /* \ */
  SAPP_KEYCODE_RIGHT_BRACKET = 93, /* ] */
  SAPP_KEYCODE_GRAVE_ACCENT = 96,  /* ` */
  SAPP_KEYCODE_WORLD_1 = 161,      /* non-US #1 */
  SAPP_KEYCODE_WORLD_2 = 162,      /* non-US #2 */
  SAPP_KEYCODE_ESCAPE = 256,
  SAPP_KEYCODE_ENTER = 257,
  SAPP_KEYCODE_TAB = 258,
  SAPP_KEYCODE_BACKSPACE = 259,
  SAPP_KEYCODE_INSERT = 260,
  SAPP_KEYCODE_DELETE = 261,
  SAPP_KEYCODE_RIGHT = 262,
  SAPP_KEYCODE_LEFT = 263,
  SAPP_KEYCODE_DOWN = 264,
  SAPP_KEYCODE_UP = 265,
  SAPP_KEYCODE_PAGE_UP = 266,
  SAPP_KEYCODE_PAGE_DOWN = 267,
  SAPP_KEYCODE_HOME = 268,
  SAPP_KEYCODE_END = 269,
  SAPP_KEYCODE_CAPS_LOCK = 280,
  SAPP_KEYCODE_SCROLL_LOCK = 281,
  SAPP_KEYCODE_NUM_LOCK = 282,
  SAPP_KEYCODE_PRINT_SCREEN = 283,
  SAPP_KEYCODE_PAUSE = 284,
  SAPP_KEYCODE_F1 = 290,
  SAPP_KEYCODE_F2 = 291,
  SAPP_KEYCODE_F3 = 292,
  SAPP_KEYCODE_F4 = 293,
  SAPP_KEYCODE_F5 = 294,
  SAPP_KEYCODE_F6 = 295,
  SAPP_KEYCODE_F7 = 296,
  SAPP_KEYCODE_F8 = 297,
  SAPP_KEYCODE_F9 = 298,
  SAPP_KEYCODE_F10 = 299,
  SAPP_KEYCODE_F11 = 300,
  SAPP_KEYCODE_F12 = 301,
  SAPP_KEYCODE_F13 = 302,
  SAPP_KEYCODE_F14 = 303,
  SAPP_KEYCODE_F15 = 304,
  SAPP_KEYCODE_F16 = 305,
  SAPP_KEYCODE_F17 = 306,
  SAPP_KEYCODE_F18 = 307,
  SAPP_KEYCODE_F19 = 308,
  SAPP_KEYCODE_F20 = 309,
  SAPP_KEYCODE_F21 = 310,
  SAPP_KEYCODE_F22 = 311,
  SAPP_KEYCODE_F23 = 312,
  SAPP_KEYCODE_F24 = 313,
  SAPP_KEYCODE_F25 = 314,
  SAPP_KEYCODE_KP_0 = 320,
  SAPP_KEYCODE_KP_1 = 321,
  SAPP_KEYCODE_KP_2 = 322,
  SAPP_KEYCODE_KP_3 = 323,
  SAPP_KEYCODE_KP_4 = 324,
  SAPP_KEYCODE_KP_5 = 325,
  SAPP_KEYCODE_KP_6 = 326,
  SAPP_KEYCODE_KP_7 = 327,
  SAPP_KEYCODE_KP_8 = 328,
  SAPP_KEYCODE_KP_9 = 329,
  SAPP_KEYCODE_KP_DECIMAL = 330,
  SAPP_KEYCODE_KP_DIVIDE = 331,
  SAPP_KEYCODE_KP_MULTIPLY = 332,
  SAPP_KEYCODE_KP_SUBTRACT = 333,
  SAPP_KEYCODE_KP_ADD = 334,
  SAPP_KEYCODE_KP_ENTER = 335,
  SAPP_KEYCODE_KP_EQUAL = 336,
  SAPP_KEYCODE_LEFT_SHIFT = 340,
  SAPP_KEYCODE_LEFT_CONTROL = 341,
  SAPP_KEYCODE_LEFT_ALT = 342,
  SAPP_KEYCODE_LEFT_SUPER = 343,
  SAPP_KEYCODE_RIGHT_SHIFT = 344,
  SAPP_KEYCODE_RIGHT_CONTROL = 345,
  SAPP_KEYCODE_RIGHT_ALT = 346,
  SAPP_KEYCODE_RIGHT_SUPER = 347,
  SAPP_KEYCODE_MENU = 348,
} sapp_keycode;

/*
    Android specific 'tool type' enum for touch events. This lets the
    application check what type of input device was used for
    touch events.

    NOTE: the values must remain in sync with the corresponding
    Android SDK type, so don't change those.

    See
   https://developer.android.com/reference/android/view/MotionEvent#TOOL_TYPE_UNKNOWN
*/
typedef enum sapp_android_tooltype {
  SAPP_ANDROIDTOOLTYPE_UNKNOWN = 0, // TOOL_TYPE_UNKNOWN
  SAPP_ANDROIDTOOLTYPE_FINGER = 1,  // TOOL_TYPE_FINGER
  SAPP_ANDROIDTOOLTYPE_STYLUS = 2,  // TOOL_TYPE_STYLUS
  SAPP_ANDROIDTOOLTYPE_MOUSE = 3,   // TOOL_TYPE_MOUSE
} sapp_android_tooltype;

/*
    sapp_touchpoint

    Describes a single touchpoint in a multitouch event (TOUCHES_BEGAN,
    TOUCHES_MOVED, TOUCHES_ENDED).

    Touch points are stored in the nested array sapp_event.touches[],
    and the number of touches is stored in sapp_event.num_touches.
*/
typedef struct sapp_touchpoint {
  uintptr_t identifier;
  float pos_x;
  float pos_y;
  sapp_android_tooltype android_tooltype; // only valid on Android
  bool changed;
} sapp_touchpoint;

/*
    sapp_mousebutton

    The currently pressed mouse button in the events MOUSE_DOWN
    and MOUSE_UP, stored in the struct field sapp_event.mouse_button.
*/
typedef enum sapp_mousebutton {
  SAPP_MOUSEBUTTON_LEFT = 0x0,
  SAPP_MOUSEBUTTON_RIGHT = 0x1,
  SAPP_MOUSEBUTTON_MIDDLE = 0x2,
  SAPP_MOUSEBUTTON_INVALID = 0x100,
} sapp_mousebutton;

/*
    These are currently pressed modifier keys (and mouse buttons) which are
    passed in the event struct field sapp_event.modifiers.
*/
enum {
  SAPP_MODIFIER_SHIFT = 0x1, // left or right shift key
  SAPP_MODIFIER_CTRL = 0x2,  // left or right control key
  SAPP_MODIFIER_ALT = 0x4,   // left or right alt key
  SAPP_MODIFIER_SUPER = 0x8, // left or right 'super' key
  SAPP_MODIFIER_LMB = 0x100, // left mouse button
  SAPP_MODIFIER_RMB = 0x200, // right mouse button
  SAPP_MODIFIER_MMB = 0x400, // middle mouse button
};

/*
    sapp_event

    This is an all-in-one event struct passed to the event handler
    user callback function. Note that it depends on the event
    type what struct fields actually contain useful values, so you
    should first check the event type before reading other struct
    fields.
*/
typedef struct sapp_event {
  uint64_t frame_count;  // current frame counter, always valid, useful for
                         // checking if two events were issued in the same frame
  sapp_event_type type;  // the event type, always valid
  sapp_keycode key_code; // the virtual key code, only valid in KEY_UP, KEY_DOWN
  uint32_t char_code;    // the UTF-32 character code, only valid in CHAR events
  bool key_repeat;       // true if this is a key-repeat event, valid in KEY_UP,
                         // KEY_DOWN and CHAR
  uint32_t modifiers;    // current modifier keys, valid in all key-, char- and
                         // mouse-events
  sapp_mousebutton mouse_button; // mouse button that was pressed or released,
                                 // valid in MOUSE_DOWN, MOUSE_UP
  float mouse_x;  // current horizontal mouse position in pixels, always valid
                  // except during mouse lock
  float mouse_y;  // current vertical mouse position in pixels, always valid
                  // except during mouse lock
  float mouse_dx; // relative horizontal mouse movement since last frame, always
                  // valid
  float mouse_dy; // relative vertical mouse movement since last frame, always
                  // valid
  float scroll_x; // horizontal mouse wheel scroll distance, valid in
                  // MOUSE_SCROLL events
  float scroll_y; // vertical mouse wheel scroll distance, valid in MOUSE_SCROLL
                  // events
  int num_touches; // number of valid items in the touches[] array
  sapp_touchpoint touches[SAPP_MAX_TOUCHPOINTS]; // current touch points, valid
                                                 // in TOUCHES_BEGIN,
                                                 // TOUCHES_MOVED, TOUCHES_ENDED
  int window_width; // current window- and framebuffer sizes in pixels, always
                    // valid
  int window_height;
  int framebuffer_width;  // = window_width * dpi_scale
  int framebuffer_height; // = window_height * dpi_scale
} sapp_event;

/*
    sg_range

    A general pointer/size-pair struct and constructor macros for passing binary
   blobs into sokol_app.h.
*/
typedef struct sapp_range {
  const void *ptr;
  size_t size;
} sapp_range;
// disabling this for every includer isn't great, but the warnings are also
// quite pointless
#if defined(_MSC_VER)
#pragma warning(                                                               \
    disable : 4221) /* /W4 only: nonstandard extension used: 'x': cannot be    \
                       initialized using address of automatic variable 'y' */
#pragma warning(disable : 4204) /* VS2015: nonstandard extension used:         \
                                   non-constant aggregate initializer */
#endif
#if defined(__cplusplus)
#define SAPP_RANGE(x)                                                          \
  sapp_range { &x, sizeof(x) }
#else
#define SAPP_RANGE(x)                                                          \
  (sapp_range) { &x, sizeof(x) }
#endif

/*
    sapp_image_desc

    This is used to describe image data to sokol_app.h (window icons and cursor
   images).

    The pixel format is RGBA8.

    cursor_hotspot_x and _y are used only for cursors, to define which pixel
    of the image should be aligned with the mouse position.
*/
typedef struct sapp_image_desc {
  int width;
  int height;
  int cursor_hotspot_x;
  int cursor_hotspot_y;
  sapp_range pixels;
} sapp_image_desc;

/*
    sapp_icon_desc

    An icon description structure for use in sapp_desc.icon and
    sapp_set_icon().

    When setting a custom image, the application can provide a number of
    candidates differing in size, and sokol_app.h will pick the image(s)
    closest to the size expected by the platform's window system.

    To set sokol-app's default icon, set .sokol_default to true.

    Otherwise provide candidate images of different sizes in the
    images[] array.

    If both the sokol_default flag is set to true, any image candidates
    will be ignored and the sokol_app.h default icon will be set.
*/
typedef struct sapp_icon_desc {
  bool sokol_default;
  sapp_image_desc images[SAPP_MAX_ICONIMAGES];
} sapp_icon_desc;

/*
    sapp_allocator

    Used in sapp_desc to provide custom memory-alloc and -free functions
    to sokol_app.h. If memory management should be overridden, both the
    alloc_fn and free_fn function must be provided (e.g. it's not valid to
    override one function but not the other).
*/
typedef struct sapp_allocator {
  void *(*alloc_fn)(size_t size, void *user_data);
  void (*free_fn)(void *ptr, void *user_data);
  void *user_data;
} sapp_allocator;

/*
    sapp_log_item

    Log items are defined via X-Macros and expanded to an enum
    'sapp_log_item', and in debug mode to corresponding
    human readable error messages.
*/
#define _SAPP_LOG_ITEMS                                                        \
  _SAPP_LOGITEM_XMACRO(OK, "Ok")                                               \
  _SAPP_LOGITEM_XMACRO(MALLOC_FAILED, "memory allocation failed")              \
  _SAPP_LOGITEM_XMACRO(                                                        \
      MACOS_INVALID_NSOPENGL_PROFILE,                                          \
      "macos: invalid NSOpenGLProfile (valid choices are 1.0 and 4.1)")        \
  _SAPP_LOGITEM_XMACRO(WIN32_LOAD_OPENGL32_DLL_FAILED,                         \
                       "failed loading opengl32.dll")                          \
  _SAPP_LOGITEM_XMACRO(WIN32_CREATE_HELPER_WINDOW_FAILED,                      \
                       "failed to create helper window")                       \
  _SAPP_LOGITEM_XMACRO(WIN32_HELPER_WINDOW_GETDC_FAILED,                       \
                       "failed to get helper window DC")                       \
  _SAPP_LOGITEM_XMACRO(WIN32_DUMMY_CONTEXT_SET_PIXELFORMAT_FAILED,             \
                       "failed to set pixel format for dummy GL context")      \
  _SAPP_LOGITEM_XMACRO(WIN32_CREATE_DUMMY_CONTEXT_FAILED,                      \
                       "failed to create dummy GL context")                    \
  _SAPP_LOGITEM_XMACRO(WIN32_DUMMY_CONTEXT_MAKE_CURRENT_FAILED,                \
                       "failed to make dummy GL context current")              \
  _SAPP_LOGITEM_XMACRO(WIN32_GET_PIXELFORMAT_ATTRIB_FAILED,                    \
                       "failed to get WGL pixel format attribute")             \
  _SAPP_LOGITEM_XMACRO(WIN32_WGL_FIND_PIXELFORMAT_FAILED,                      \
                       "failed to find matching WGL pixel format")             \
  _SAPP_LOGITEM_XMACRO(WIN32_WGL_DESCRIBE_PIXELFORMAT_FAILED,                  \
                       "failed to get pixel format descriptor")                \
  _SAPP_LOGITEM_XMACRO(WIN32_WGL_SET_PIXELFORMAT_FAILED,                       \
                       "failed to set selected pixel format")                  \
  _SAPP_LOGITEM_XMACRO(WIN32_WGL_ARB_CREATE_CONTEXT_REQUIRED,                  \
                       "ARB_create_context required")                          \
  _SAPP_LOGITEM_XMACRO(WIN32_WGL_ARB_CREATE_CONTEXT_PROFILE_REQUIRED,          \
                       "ARB_create_context_profile required")                  \
  _SAPP_LOGITEM_XMACRO(WIN32_WGL_OPENGL_VERSION_NOT_SUPPORTED,                 \
                       "requested OpenGL version not supported by GL driver "  \
                       "(ERROR_INVALID_VERSION_ARB)")                          \
  _SAPP_LOGITEM_XMACRO(WIN32_WGL_OPENGL_PROFILE_NOT_SUPPORTED,                 \
                       "requested OpenGL profile not support by GL driver "    \
                       "(ERROR_INVALID_PROFILE_ARB)")                          \
  _SAPP_LOGITEM_XMACRO(WIN32_WGL_INCOMPATIBLE_DEVICE_CONTEXT,                  \
                       "CreateContextAttribsARB failed with "                  \
                       "ERROR_INCOMPATIBLE_DEVICE_CONTEXTS_ARB")               \
  _SAPP_LOGITEM_XMACRO(WIN32_WGL_CREATE_CONTEXT_ATTRIBS_FAILED_OTHER,          \
                       "CreateContextAttribsARB failed for other reason")      \
  _SAPP_LOGITEM_XMACRO(                                                        \
      WIN32_D3D11_CREATE_DEVICE_AND_SWAPCHAIN_WITH_DEBUG_FAILED,               \
      "D3D11CreateDeviceAndSwapChain() with D3D11_CREATE_DEVICE_DEBUG "        \
      "failed, retrying without debug flag.")                                  \
  _SAPP_LOGITEM_XMACRO(WIN32_D3D11_GET_IDXGIFACTORY_FAILED,                    \
                       "could not obtain IDXGIFactory object")                 \
  _SAPP_LOGITEM_XMACRO(WIN32_D3D11_GET_IDXGIADAPTER_FAILED,                    \
                       "could not obtain IDXGIAdapter object")                 \
  _SAPP_LOGITEM_XMACRO(WIN32_D3D11_QUERY_INTERFACE_IDXGIDEVICE1_FAILED,        \
                       "could not obtain IDXGIDevice1 interface")              \
  _SAPP_LOGITEM_XMACRO(WIN32_REGISTER_RAW_INPUT_DEVICES_FAILED_MOUSE_LOCK,     \
                       "RegisterRawInputDevices() failed (on mouse lock)")     \
  _SAPP_LOGITEM_XMACRO(WIN32_REGISTER_RAW_INPUT_DEVICES_FAILED_MOUSE_UNLOCK,   \
                       "RegisterRawInputDevices() failed (on mouse unlock)")   \
  _SAPP_LOGITEM_XMACRO(WIN32_GET_RAW_INPUT_DATA_FAILED,                        \
                       "GetRawInputData() failed")                             \
  _SAPP_LOGITEM_XMACRO(WIN32_DESTROYICON_FOR_CURSOR_FAILED,                    \
                       "DestroyIcon() for a cursor image failed")              \
  _SAPP_LOGITEM_XMACRO(LINUX_GLX_LOAD_LIBGL_FAILED, "failed to load libGL")    \
  _SAPP_LOGITEM_XMACRO(LINUX_GLX_LOAD_ENTRY_POINTS_FAILED,                     \
                       "failed to load GLX entry points")                      \
  _SAPP_LOGITEM_XMACRO(LINUX_GLX_EXTENSION_NOT_FOUND,                          \
                       "GLX extension not found")                              \
  _SAPP_LOGITEM_XMACRO(LINUX_GLX_QUERY_VERSION_FAILED,                         \
                       "failed to query GLX version")                          \
  _SAPP_LOGITEM_XMACRO(LINUX_GLX_VERSION_TOO_LOW,                              \
                       "GLX version too low (need at least 1.3)")              \
  _SAPP_LOGITEM_XMACRO(LINUX_GLX_NO_GLXFBCONFIGS,                              \
                       "glXGetFBConfigs() returned no configs")                \
  _SAPP_LOGITEM_XMACRO(LINUX_GLX_NO_SUITABLE_GLXFBCONFIG,                      \
                       "failed to find a suitable GLXFBConfig")                \
  _SAPP_LOGITEM_XMACRO(LINUX_GLX_GET_VISUAL_FROM_FBCONFIG_FAILED,              \
                       "glXGetVisualFromFBConfig failed")                      \
  _SAPP_LOGITEM_XMACRO(LINUX_GLX_REQUIRED_EXTENSIONS_MISSING,                  \
                       "GLX extensions ARB_create_context and "                \
                       "ARB_create_context_profile missing")                   \
  _SAPP_LOGITEM_XMACRO(                                                        \
      LINUX_GLX_CREATE_CONTEXT_FAILED,                                         \
      "Failed to create GL context via glXCreateContextAttribsARB")            \
  _SAPP_LOGITEM_XMACRO(LINUX_GLX_CREATE_WINDOW_FAILED,                         \
                       "glXCreateWindow() failed")                             \
  _SAPP_LOGITEM_XMACRO(LINUX_X11_CREATE_WINDOW_FAILED,                         \
                       "XCreateWindow() failed")                               \
  _SAPP_LOGITEM_XMACRO(LINUX_EGL_BIND_OPENGL_API_FAILED,                       \
                       "eglBindAPI(EGL_OPENGL_API) failed")                    \
  _SAPP_LOGITEM_XMACRO(LINUX_EGL_BIND_OPENGL_ES_API_FAILED,                    \
                       "eglBindAPI(EGL_OPENGL_ES_API) failed")                 \
  _SAPP_LOGITEM_XMACRO(LINUX_EGL_GET_DISPLAY_FAILED, "eglGetDisplay() failed") \
  _SAPP_LOGITEM_XMACRO(LINUX_EGL_INITIALIZE_FAILED, "eglInitialize() failed")  \
  _SAPP_LOGITEM_XMACRO(LINUX_EGL_NO_CONFIGS,                                   \
                       "eglChooseConfig() returned no configs")                \
  _SAPP_LOGITEM_XMACRO(LINUX_EGL_NO_NATIVE_VISUAL,                             \
                       "eglGetConfigAttrib() for EGL_NATIVE_VISUAL_ID failed") \
  _SAPP_LOGITEM_XMACRO(LINUX_EGL_GET_VISUAL_INFO_FAILED,                       \
                       "XGetVisualInfo() failed")                              \
  _SAPP_LOGITEM_XMACRO(LINUX_EGL_CREATE_WINDOW_SURFACE_FAILED,                 \
                       "eglCreateWindowSurface() failed")                      \
  _SAPP_LOGITEM_XMACRO(LINUX_EGL_CREATE_CONTEXT_FAILED,                        \
                       "eglCreateContext() failed")                            \
  _SAPP_LOGITEM_XMACRO(LINUX_EGL_MAKE_CURRENT_FAILED,                          \
                       "eglMakeCurrent() failed")                              \
  _SAPP_LOGITEM_XMACRO(LINUX_X11_OPEN_DISPLAY_FAILED, "XOpenDisplay() failed") \
  _SAPP_LOGITEM_XMACRO(                                                        \
      LINUX_X11_QUERY_SYSTEM_DPI_FAILED,                                       \
      "failed to query system dpi value, assuming default 96.0")               \
  _SAPP_LOGITEM_XMACRO(LINUX_X11_DROPPED_FILE_URI_WRONG_SCHEME,                \
                       "dropped file URL doesn't start with 'file://'")        \
  _SAPP_LOGITEM_XMACRO(LINUX_X11_FAILED_TO_BECOME_OWNER_OF_CLIPBOARD,          \
                       "X11: Failed to become owner of clipboard selection")   \
  _SAPP_LOGITEM_XMACRO(LINUX_WAYLAND_CONNECT_DISPLAY_FAILED,                   \
                       "Failed to connect to Wayland display")                 \
  _SAPP_LOGITEM_XMACRO(                                                        \
      LINUX_WAYLAND_NO_REQUIRED_PROTOCOLS,                                     \
      "Wayland compositor doesn't support required protocols")                 \
  _SAPP_LOGITEM_XMACRO(LINUX_WAYLAND_CREATE_XKB_CONTEXT_FAILED,                \
                       "Failed to create XKB context")                         \
  _SAPP_LOGITEM_XMACRO(LINUX_WAYLAND_CREATE_WINDOW_FAILED,                     \
                       "Failed to create wl_egl_window")                       \
  _SAPP_LOGITEM_XMACRO(                                                        \
      ANDROID_UNSUPPORTED_INPUT_EVENT_INPUT_CB,                                \
      "unsupported input event encountered in _sapp_android_input_cb()")       \
  _SAPP_LOGITEM_XMACRO(                                                        \
      ANDROID_UNSUPPORTED_INPUT_EVENT_MAIN_CB,                                 \
      "unsupported input event encountered in _sapp_android_main_cb()")        \
  _SAPP_LOGITEM_XMACRO(ANDROID_READ_MSG_FAILED,                                \
                       "failed to read message in _sapp_android_main_cb()")    \
  _SAPP_LOGITEM_XMACRO(ANDROID_WRITE_MSG_FAILED,                               \
                       "failed to write message in _sapp_android_msg")         \
  _SAPP_LOGITEM_XMACRO(ANDROID_MSG_CREATE, "MSG_CREATE")                       \
  _SAPP_LOGITEM_XMACRO(ANDROID_MSG_RESUME, "MSG_RESUME")                       \
  _SAPP_LOGITEM_XMACRO(ANDROID_MSG_PAUSE, "MSG_PAUSE")                         \
  _SAPP_LOGITEM_XMACRO(ANDROID_MSG_FOCUS, "MSG_FOCUS")                         \
  _SAPP_LOGITEM_XMACRO(ANDROID_MSG_NO_FOCUS, "MSG_NO_FOCUS")                   \
  _SAPP_LOGITEM_XMACRO(ANDROID_MSG_SET_NATIVE_WINDOW, "MSG_SET_NATIVE_WINDOW") \
  _SAPP_LOGITEM_XMACRO(ANDROID_MSG_SET_INPUT_QUEUE, "MSG_SET_INPUT_QUEUE")     \
  _SAPP_LOGITEM_XMACRO(ANDROID_MSG_DESTROY, "MSG_DESTROY")                     \
  _SAPP_LOGITEM_XMACRO(ANDROID_UNKNOWN_MSG, "unknown msg type received")       \
  _SAPP_LOGITEM_XMACRO(ANDROID_LOOP_THREAD_STARTED, "loop thread started")     \
  _SAPP_LOGITEM_XMACRO(ANDROID_LOOP_THREAD_DONE, "loop thread done")           \
  _SAPP_LOGITEM_XMACRO(ANDROID_NATIVE_ACTIVITY_ONSTART,                        \
                       "NativeActivity onStart()")                             \
  _SAPP_LOGITEM_XMACRO(ANDROID_NATIVE_ACTIVITY_ONRESUME,                       \
                       "NativeActivity onResume")                              \
  _SAPP_LOGITEM_XMACRO(ANDROID_NATIVE_ACTIVITY_ONSAVEINSTANCESTATE,            \
                       "NativeActivity onSaveInstanceState")                   \
  _SAPP_LOGITEM_XMACRO(ANDROID_NATIVE_ACTIVITY_ONWINDOWFOCUSCHANGED,           \
                       "NativeActivity onWindowFocusChanged")                  \
  _SAPP_LOGITEM_XMACRO(ANDROID_NATIVE_ACTIVITY_ONPAUSE,                        \
                       "NativeActivity onPause")                               \
  _SAPP_LOGITEM_XMACRO(ANDROID_NATIVE_ACTIVITY_ONSTOP,                         \
                       "NativeActivity onStop()")                              \
  _SAPP_LOGITEM_XMACRO(ANDROID_NATIVE_ACTIVITY_ONNATIVEWINDOWCREATED,          \
                       "NativeActivity onNativeWindowCreated")                 \
  _SAPP_LOGITEM_XMACRO(ANDROID_NATIVE_ACTIVITY_ONNATIVEWINDOWDESTROYED,        \
                       "NativeActivity onNativeWindowDestroyed")               \
  _SAPP_LOGITEM_XMACRO(ANDROID_NATIVE_ACTIVITY_ONINPUTQUEUECREATED,            \
                       "NativeActivity onInputQueueCreated")                   \
  _SAPP_LOGITEM_XMACRO(ANDROID_NATIVE_ACTIVITY_ONINPUTQUEUEDESTROYED,          \
                       "NativeActivity onInputQueueDestroyed")                 \
  _SAPP_LOGITEM_XMACRO(ANDROID_NATIVE_ACTIVITY_ONCONFIGURATIONCHANGED,         \
                       "NativeActivity onConfigurationChanged")                \
  _SAPP_LOGITEM_XMACRO(ANDROID_NATIVE_ACTIVITY_ONLOWMEMORY,                    \
                       "NativeActivity onLowMemory")                           \
  _SAPP_LOGITEM_XMACRO(ANDROID_NATIVE_ACTIVITY_ONDESTROY,                      \
                       "NativeActivity onDestroy")                             \
  _SAPP_LOGITEM_XMACRO(ANDROID_NATIVE_ACTIVITY_DONE, "NativeActivity done")    \
  _SAPP_LOGITEM_XMACRO(ANDROID_NATIVE_ACTIVITY_ONCREATE,                       \
                       "NativeActivity onCreate")                              \
  _SAPP_LOGITEM_XMACRO(ANDROID_CREATE_THREAD_PIPE_FAILED,                      \
                       "failed to create thread pipe")                         \
  _SAPP_LOGITEM_XMACRO(ANDROID_NATIVE_ACTIVITY_CREATE_SUCCESS,                 \
                       "NativeActivity successfully created")                  \
  _SAPP_LOGITEM_XMACRO(WGPU_DEVICE_LOST, "wgpu: device lost")                  \
  _SAPP_LOGITEM_XMACRO(WGPU_DEVICE_LOG, "wgpu: device log")                    \
  _SAPP_LOGITEM_XMACRO(WGPU_DEVICE_UNCAPTURED_ERROR, "wgpu: uncaptured error") \
  _SAPP_LOGITEM_XMACRO(WGPU_SWAPCHAIN_CREATE_SURFACE_FAILED,                   \
                       "wgpu: failed to create surface for swapchain")         \
  _SAPP_LOGITEM_XMACRO(WGPU_SWAPCHAIN_SURFACE_GET_CAPABILITIES_FAILED,         \
                       "wgpu: wgpuSurfaceGetCapabilities failed")              \
  _SAPP_LOGITEM_XMACRO(                                                        \
      WGPU_SWAPCHAIN_CREATE_DEPTH_STENCIL_TEXTURE_FAILED,                      \
      "wgpu: failed to create depth-stencil texture for swapchain")            \
  _SAPP_LOGITEM_XMACRO(WGPU_SWAPCHAIN_CREATE_DEPTH_STENCIL_VIEW_FAILED,        \
                       "wgpu: failed to create view object for swapchain "     \
                       "depth-stencil texture")                                \
  _SAPP_LOGITEM_XMACRO(WGPU_SWAPCHAIN_CREATE_MSAA_TEXTURE_FAILED,              \
                       "wgpu: failed to create msaa texture for swapchain")    \
  _SAPP_LOGITEM_XMACRO(                                                        \
      WGPU_SWAPCHAIN_CREATE_MSAA_VIEW_FAILED,                                  \
      "wgpu: failed to create view object for swapchain msaa texture")         \
  _SAPP_LOGITEM_XMACRO(WGPU_SWAPCHAIN_GETCURRENTTEXTURE_FAILED,                \
                       "wgpu: wgpuSurfaceGetCurrentTexture() failed")          \
  _SAPP_LOGITEM_XMACRO(WGPU_REQUEST_DEVICE_STATUS_ERROR,                       \
                       "wgpu: requesting device failed with status 'error'")   \
  _SAPP_LOGITEM_XMACRO(WGPU_REQUEST_DEVICE_STATUS_UNKNOWN,                     \
                       "wgpu: requesting device failed with status 'unknown'") \
  _SAPP_LOGITEM_XMACRO(WGPU_REQUEST_ADAPTER_STATUS_UNAVAILABLE,                \
                       "wgpu: requesting adapter failed with 'unavailable'")   \
  _SAPP_LOGITEM_XMACRO(WGPU_REQUEST_ADAPTER_STATUS_ERROR,                      \
                       "wgpu: requesting adapter failed with status 'error'")  \
  _SAPP_LOGITEM_XMACRO(                                                        \
      WGPU_REQUEST_ADAPTER_STATUS_UNKNOWN,                                     \
      "wgpu: requesting adapter failed with status 'unknown'")                 \
  _SAPP_LOGITEM_XMACRO(WGPU_CREATE_INSTANCE_FAILED,                            \
                       "wgpu: failed to create instance")                      \
  _SAPP_LOGITEM_XMACRO(VULKAN_REQUIRED_INSTANCE_EXTENSION_FUNCTION_MISSING,    \
                       "vulkan: could not lookup a required instance "         \
                       "extension function pointer")                           \
  _SAPP_LOGITEM_XMACRO(VULKAN_ALLOC_DEVICE_MEMORY_NO_SUITABLE_MEMORY_TYPE,     \
                       "vulkan: could not find suitable memory type")          \
  _SAPP_LOGITEM_XMACRO(VULKAN_ALLOCATE_MEMORY_FAILED,                          \
                       "vulkan: vkAllocateMemory() failed!")                   \
  _SAPP_LOGITEM_XMACRO(VULKAN_CREATE_INSTANCE_FAILED,                          \
                       "vulkan: vkCreateInstance failed")                      \
  _SAPP_LOGITEM_XMACRO(VULKAN_ENUMERATE_PHYSICAL_DEVICES_FAILED,               \
                       "vulkan: vkEnumeratePhysicalDevices failed")            \
  _SAPP_LOGITEM_XMACRO(VULKAN_NO_PHYSICAL_DEVICES_FOUND,                       \
                       "vulkan: vkEnumeratePhysicalDevices return no devices") \
  _SAPP_LOGITEM_XMACRO(VULKAN_NO_SUITABLE_PHYSICAL_DEVICE_FOUND,               \
                       "vulkan: no suitable physical device found")            \
  _SAPP_LOGITEM_XMACRO(                                                        \
      VULKAN_CREATE_DEVICE_FAILED_EXTENSION_NOT_PRESENT,                       \
      "vulkan: vkCreateDevice failed (extension not present)")                 \
  _SAPP_LOGITEM_XMACRO(VULKAN_CREATE_DEVICE_FAILED_FEATURE_NOT_PRESENT,        \
                       "vulkan: vkCreateDevice failed (feature not present)")  \
  _SAPP_LOGITEM_XMACRO(                                                        \
      VULKAN_CREATE_DEVICE_FAILED_INITIALIZATION_FAILED,                       \
      "vulkan: vkCreateDevice failed (initialization failed)")                 \
  _SAPP_LOGITEM_XMACRO(VULKAN_CREATE_DEVICE_FAILED_OTHER,                      \
                       "vulkan: vkCreateDevice failed (other)")                \
  _SAPP_LOGITEM_XMACRO(VULKAN_CREATE_SURFACE_FAILED,                           \
                       "vulkan: vkCreate*SurfaceKHR failed")                   \
  _SAPP_LOGITEM_XMACRO(VULKAN_CREATE_SWAPCHAIN_FAILED,                         \
                       "vulkan: vkCreateSwapchainKHR failed")                  \
  _SAPP_LOGITEM_XMACRO(VULKAN_SWAPCHAIN_CREATE_IMAGE_VIEW_FAILED,              \
                       "vulkan: vkCreateImageView for swapchain image failed") \
  _SAPP_LOGITEM_XMACRO(VULKAN_SWAPCHAIN_CREATE_IMAGE_FAILED,                   \
                       "vulkan: vkCreateImage for depth-stencil image failed") \
  _SAPP_LOGITEM_XMACRO(                                                        \
      VULKAN_SWAPCHAIN_ALLOC_IMAGE_DEVICE_MEMORY_FAILED,                       \
      "vulkan: failed to allocate device memory for depth-stencil image")      \
  _SAPP_LOGITEM_XMACRO(                                                        \
      VULKAN_SWAPCHAIN_BIND_IMAGE_MEMORY_FAILED,                               \
      "vulkan: vkBindImageMemory() for depth-stencil image failed")            \
  _SAPP_LOGITEM_XMACRO(VULKAN_ACQUIRE_NEXT_IMAGE_FAILED,                       \
                       "vulkan: vkAcquireNextImageKHR failed")                 \
  _SAPP_LOGITEM_XMACRO(VULKAN_QUEUE_PRESENT_FAILED,                            \
                       "vulkan: vkQueuePresentKHR failed")                     \
  _SAPP_LOGITEM_XMACRO(                                                        \
      IMAGE_DATA_SIZE_MISMATCH,                                                \
      "image data size mismatch (must be width*height*4 bytes)")               \
  _SAPP_LOGITEM_XMACRO(                                                        \
      DROPPED_FILE_PATH_TOO_LONG,                                              \
      "dropped file path too long (sapp_desc.max_dropped_filed_path_length)")  \
  _SAPP_LOGITEM_XMACRO(CLIPBOARD_STRING_TOO_BIG,                               \
                       "clipboard string didn't fit into clipboard buffer")

#define _SAPP_LOGITEM_XMACRO(item, msg) SAPP_LOGITEM_##item,
typedef enum sapp_log_item { _SAPP_LOG_ITEMS } sapp_log_item;
#undef _SAPP_LOGITEM_XMACRO

/*
    sapp_pixel_format

    Defines the pixel format for swapchain surfaces.

    NOTE: when using sokol_gfx.h do not assume that the underlying
    values are compatible with sg_pixel_format!

*/
typedef enum sapp_pixel_format {
  _SAPP_PIXELFORMAT_DEFAULT,
  SAPP_PIXELFORMAT_NONE,
  SAPP_PIXELFORMAT_RGBA8,
  SAPP_PIXELFORMAT_SRGB8A8,
  SAPP_PIXELFORMAT_BGRA8,
  SAPP_PIXELFORMAT_SBGRA8,
  SAPP_PIXELFORMAT_DEPTH,
  SAPP_PIXELFORMAT_DEPTH_STENCIL,
  _SA_PPPIXELFORMAT_FORCE_U32 = 0x7FFFFFFF
} sapp_pixel_format;

/*
    sapp_environment

    Used to provide runtime environment information to the
    outside world (like default pixel formats and the backend
    3D API device pointer) via a call to sapp_get_environment().

    NOTE: when using sokol_gfx.h, don't assume that sapp_environment
    is binary compatible with sg_environment! Always use a translation
    function like sglue_environment() to populate sg_environment
    from sapp_environment!
*/
typedef struct sapp_environment_defaults {
  sapp_pixel_format color_format;
  sapp_pixel_format depth_format;
  int sample_count;
} sapp_environment_defaults;

typedef struct sapp_metal_environment {
  const void *device;
} sapp_metal_environment;

typedef struct sapp_d3d11_environment {
  const void *device;
  const void *device_context;
} sapp_d3d11_environment;

typedef struct sapp_wgpu_environment {
  const void *device;
} sapp_wgpu_environment;

typedef struct sapp_vulkan_environment {
  const void *instance;
  const void *physical_device;
  const void *device;
  const void *queue;
  uint32_t queue_family_index;
} sapp_vulkan_environment;

typedef struct sapp_environment {
  sapp_environment_defaults defaults;
  sapp_metal_environment metal;
  sapp_d3d11_environment d3d11;
  sapp_wgpu_environment wgpu;
  sapp_vulkan_environment vulkan;
} sapp_environment;

/*
    sapp_swapchain

    Provides swapchain information for the current frame to the outside
    world via a call to sapp_get_swapchain().

    NOTE: sapp_get_swapchain() must be called exactly once per frame since
    on some backends it will also acquire the next swapchain image.

    NOTE: when using sokol_gfx.h, don't assume that the sapp_swapchain struct
    has the same memory layout as sg_swapchain! Use the sokol_log.h helper
    function sglue_swapchain() to translate sapp_swapchain into a
    sg_swapchain instead.
*/
typedef struct sapp_metal_swapchain {
  const void *current_drawable;      // CAMetalDrawable (NOT MTLDrawable!!!)
  const void *depth_stencil_texture; // MTLTexture
  const void *msaa_color_texture;    // MTLTexture
} sapp_metal_swapchain;

typedef struct sapp_d3d11_swapchain {
  const void *render_view;        // ID3D11RenderTargetView
  const void *resolve_view;       // ID3D11RenderTargetView
  const void *depth_stencil_view; // ID3D11DepthStencilView
} sapp_d3d11_swapchain;

typedef struct sapp_wgpu_swapchain {
  const void *render_view;        // WGPUTextureView
  const void *resolve_view;       // WGPUTextureView
  const void *depth_stencil_view; // WGPUTextureView
} sapp_wgpu_swapchain;

typedef struct sapp_vulkan_swapchain {
  const void *render_image;               // vkImage
  const void *render_view;                // vkImageView
  const void *resolve_image;              // vkImage;
  const void *resolve_view;               // vkImageView
  const void *depth_stencil_image;        // vkImage
  const void *depth_stencil_view;         // vkImageView
  const void *render_finished_semaphore;  // vkSemaphore
  const void *present_complete_semaphore; // vkSemaphore
} sapp_vulkan_swapchain;

typedef struct sapp_gl_swapchain {
  uint32_t framebuffer; // GL framebuffer object
} sapp_gl_swapchain;

typedef struct sapp_swapchain {
  int width;
  int height;
  int sample_count;
  sapp_pixel_format color_format;
  sapp_pixel_format depth_format;
  sapp_metal_swapchain metal;
  sapp_d3d11_swapchain d3d11;
  sapp_wgpu_swapchain wgpu;
  sapp_vulkan_swapchain vulkan;
  sapp_gl_swapchain gl;
} sapp_swapchain;

/*
    sapp_logger

    Used in sapp_desc to provide a logging function. Please be aware that
    without logging function, sokol-app will be completely silent, e.g. it will
    not report errors or warnings. For maximum error verbosity, compile in
    debug mode (e.g. NDEBUG *not* defined) and install a logger (for instance
    the standard logging function from sokol_log.h).
*/
typedef struct sapp_logger {
  void (*func)(const char *tag,      // always "sapp"
               uint32_t log_level,   // 0=panic, 1=error, 2=warning, 3=info
               uint32_t log_item_id, // SAPP_LOGITEM_*
               const char *message_or_null,  // a message string, may be nullptr
                                             // in release mode
               uint32_t line_nr,             // line number in sokol_app.h
               const char *filename_or_null, // source filename, may be nullptr
                                             // in release mode
               void *user_data);
  void *user_data;
} sapp_logger;

/*
    sokol-app initialization options, used as return value of sokol_main()
    or sapp_run() argument.
*/
typedef struct sapp_gl_desc {
  int major_version; // override GL/GLES major and minor version (defaults:
                     // GL4.1 (macOS) or GL4.3, GLES3.1 (Android) or GLES3.0
  int minor_version;
} sapp_gl_desc;

typedef struct sapp_win32_desc {
  bool console_utf8;   // if true, set the output console codepage to UTF-8
  bool console_create; // if true, attach stdout/stderr to a new console window
  bool console_attach; // if true, attach stdout/stderr to parent process
} sapp_win32_desc;

typedef struct sapp_html5_desc {
  const char *canvas_selector; // css selector of the HTML5 canvas element,
                               // default is "#canvas"
  bool
      canvas_resize; // if true, the HTML5 canvas size is set to
                     // sapp_desc.width/height, otherwise canvas size is tracked
  bool preserve_drawing_buffer; // HTML5 only: whether to preserve default
                                // framebuffer content between frames
  bool premultiplied_alpha;     // HTML5 only: whether the rendered pixels use
                                // premultiplied alpha convention
  bool ask_leave_site; // initial state of the internal html5_ask_leave_site
                       // flag (see sapp_html5_ask_leave_site())
  bool update_document_title; // if true, update the HTML document.title with
                              // sapp_desc.window_title
  bool bubble_mouse_events;   // if true, mouse events will bubble up to the web
                              // page
  bool bubble_touch_events;   // same for touch events
  bool bubble_wheel_events;   // same for wheel events
  bool bubble_key_events; // if true, bubble up *all* key events to browser, not
                          // just key events that represent characters
  bool bubble_char_events; // if true, bubble up character events to browser
  bool
      use_emsc_set_main_loop; // if true, use emscripten_set_main_loop() instead
                              // of emscripten_request_animation_frame_loop()
  bool emsc_set_main_loop_simulate_infinite_loop; // this will be passed as the
                                                  // simulate_infinite_loop arg
                                                  // to
                                                  // emscripten_set_main_loop()
} sapp_html5_desc;

typedef struct sapp_ios_desc {
  bool keyboard_resizes_canvas; // if true, showing the iOS keyboard shrinks the
                                // canvas
} sapp_ios_desc;

typedef struct sapp_desc {
  void (*init_cb)(
      void); // these are the user-provided callbacks without user data
  void (*frame_cb)(void);
  void (*cleanup_cb)(void);
  void (*event_cb)(const sapp_event *);

  void *user_data; // these are the user-provided callbacks with user data
  void (*init_userdata_cb)(void *);
  void (*frame_userdata_cb)(void *);
  void (*cleanup_userdata_cb)(void *);
  void (*event_userdata_cb)(const sapp_event *, void *);

  int width;         // the preferred width of the window / canvas
  int height;        // the preferred height of the window / canvas
  int sample_count;  // MSAA sample count
  int swap_interval; // the preferred swap interval (ignored on some platforms)
  bool high_dpi;   // whether the rendering canvas is full-resolution on HighDPI
                   // displays
  bool fullscreen; // whether the window should be created in fullscreen mode
  bool alpha; // whether the framebuffer should have an alpha channel (ignored
              // on some platforms)
  const char *window_title; // the window title as UTF-8 encoded string
  bool enable_clipboard;    // enable clipboard access, default is false
  int clipboard_size;       // max size of clipboard content in bytes
  bool enable_dragndrop; // enable file dropping (drag'n'drop), default is false
  int max_dropped_files; // max number of dropped files to process (default: 1)
  int max_dropped_file_path_length; // max length in bytes of a dropped UTF-8
                                    // file path (default: 2048)
  sapp_icon_desc icon;              // the initial window icon to set
  sapp_allocator
      allocator; // optional memory allocation overrides (default: malloc/free)
  sapp_logger logger; // logging callback override (default: NO LOGGING!)

  // backend-specific options
  sapp_gl_desc gl;
  sapp_win32_desc win32;
  sapp_html5_desc html5;
  sapp_ios_desc ios;

  // __v_ start
  bool __v_native_render; // V patch to allow for native rendering
  int min_width;
  int min_height;
  bool borderless_window; // V patch to remove native window decorations
  // __v_ end
} sapp_desc;

/* HTML5 specific: request and response structs for
   asynchronously loading dropped-file content.
*/
typedef enum sapp_html5_fetch_error {
  SAPP_HTML5_FETCH_ERROR_NO_ERROR,
  SAPP_HTML5_FETCH_ERROR_BUFFER_TOO_SMALL,
  SAPP_HTML5_FETCH_ERROR_OTHER,
} sapp_html5_fetch_error;

typedef struct sapp_html5_fetch_response {
  bool succeeded; // true if the loading operation has succeeded
  sapp_html5_fetch_error error_code;
  int file_index;    // index of the dropped file
                     // (0..sapp_get_num_dropped_filed()-1)
  sapp_range data;   // pointer and size of the fetched data (data.ptr ==
                     // buffer.ptr, data.size <= buffer.size)
  sapp_range buffer; // the user-provided buffer ptr/size pair (buffer.ptr ==
                     // data.ptr, buffer.size >= data.size)
  void *user_data;   // user-provided user data pointer
} sapp_html5_fetch_response;

typedef struct sapp_html5_fetch_request {
  int dropped_file_index; // 0..sapp_get_num_dropped_files()-1
  void (*callback)(const sapp_html5_fetch_response
                       *); // response callback function pointer (required)
  sapp_range buffer;       // ptr/size of a memory buffer to load the data into
  void *user_data;         // optional userdata pointer
} sapp_html5_fetch_request;

/*
    sapp_mouse_cursor

    Predefined cursor image definitions, set with
   sapp_set_mouse_cursor(sapp_mouse_cursor cursor)
*/
typedef enum sapp_mouse_cursor {
  SAPP_MOUSECURSOR_DEFAULT = 0, // equivalent with system default cursor
  SAPP_MOUSECURSOR_ARROW,
  SAPP_MOUSECURSOR_IBEAM,
  SAPP_MOUSECURSOR_CROSSHAIR,
  SAPP_MOUSECURSOR_POINTING_HAND,
  SAPP_MOUSECURSOR_RESIZE_EW,
  SAPP_MOUSECURSOR_RESIZE_NS,
  SAPP_MOUSECURSOR_RESIZE_NWSE,
  SAPP_MOUSECURSOR_RESIZE_NESW,
  SAPP_MOUSECURSOR_RESIZE_ALL,
  SAPP_MOUSECURSOR_NOT_ALLOWED,
  SAPP_MOUSECURSOR_CUSTOM_0,
  SAPP_MOUSECURSOR_CUSTOM_1,
  SAPP_MOUSECURSOR_CUSTOM_2,
  SAPP_MOUSECURSOR_CUSTOM_3,
  SAPP_MOUSECURSOR_CUSTOM_4,
  SAPP_MOUSECURSOR_CUSTOM_5,
  SAPP_MOUSECURSOR_CUSTOM_6,
  SAPP_MOUSECURSOR_CUSTOM_7,
  SAPP_MOUSECURSOR_CUSTOM_8,
  SAPP_MOUSECURSOR_CUSTOM_9,
  SAPP_MOUSECURSOR_CUSTOM_10,
  SAPP_MOUSECURSOR_CUSTOM_11,
  SAPP_MOUSECURSOR_CUSTOM_12,
  SAPP_MOUSECURSOR_CUSTOM_13,
  SAPP_MOUSECURSOR_CUSTOM_14,
  SAPP_MOUSECURSOR_CUSTOM_15,
  _SAPP_MOUSECURSOR_NUM,
} sapp_mouse_cursor;

/* user-provided functions */
extern sapp_desc sokol_main(int argc, char *argv[]);

/* returns true after sokol-app has been initialized */
SOKOL_APP_API_DECL bool sapp_isvalid(void);
/* returns the current framebuffer width in pixels */
SOKOL_APP_API_DECL int sapp_width(void);
/* same as sapp_width(), but returns float */
SOKOL_APP_API_DECL float sapp_widthf(void);
/* returns the current framebuffer height in pixels */
SOKOL_APP_API_DECL int sapp_height(void);
/* same as sapp_height(), but returns float */
SOKOL_APP_API_DECL float sapp_heightf(void);
/* get default framebuffer color pixel format */
SOKOL_APP_API_DECL sapp_pixel_format sapp_color_format(void);
/* get default framebuffer depth pixel format */
SOKOL_APP_API_DECL sapp_pixel_format sapp_depth_format(void);
/* get default framebuffer sample count */
SOKOL_APP_API_DECL int sapp_sample_count(void);
/* returns true when high_dpi was requested and actually running in a high-dpi
 * scenario */
SOKOL_APP_API_DECL bool sapp_high_dpi(void);
/* returns the dpi scaling factor (window pixels to framebuffer pixels) */
SOKOL_APP_API_DECL float sapp_dpi_scale(void);
/* show or hide the mobile device onscreen keyboard */
SOKOL_APP_API_DECL void sapp_show_keyboard(bool show);
/* return true if the mobile device onscreen keyboard is currently shown */
SOKOL_APP_API_DECL bool sapp_keyboard_shown(void);
/* query fullscreen mode */
SOKOL_APP_API_DECL bool sapp_is_fullscreen(void);
/* toggle fullscreen mode */
SOKOL_APP_API_DECL void sapp_toggle_fullscreen(void);
/* show or hide the mouse cursor */
SOKOL_APP_API_DECL void sapp_show_mouse(bool show);
/* show or hide the mouse cursor */
SOKOL_APP_API_DECL bool sapp_mouse_shown(void);
/* enable/disable mouse-pointer-lock mode */
SOKOL_APP_API_DECL void sapp_lock_mouse(bool lock);
/* return true if in mouse-pointer-lock mode (this may toggle a few frames
 * later) */
SOKOL_APP_API_DECL bool sapp_mouse_locked(void);
/* set mouse cursor type */
SOKOL_APP_API_DECL void sapp_set_mouse_cursor(sapp_mouse_cursor cursor);
/* get current mouse cursor type */
SOKOL_APP_API_DECL sapp_mouse_cursor sapp_get_mouse_cursor(void);
/* associate a custom mouse cursor image to a sapp_mouse_cursor enum entry */
SOKOL_APP_API_DECL sapp_mouse_cursor sapp_bind_mouse_cursor_image(
    sapp_mouse_cursor cursor, const sapp_image_desc *desc);
/* restore the sapp_mouse_cursor enum entry to it's default system appearance */
SOKOL_APP_API_DECL void
sapp_unbind_mouse_cursor_image(sapp_mouse_cursor cursor);
/* return the userdata pointer optionally provided in sapp_desc */
SOKOL_APP_API_DECL void *sapp_userdata(void);
/* return a copy of the sapp_desc structure */
SOKOL_APP_API_DECL sapp_desc sapp_query_desc(void);
/* initiate a "soft quit" (sends SAPP_EVENTTYPE_QUIT_REQUESTED) */
SOKOL_APP_API_DECL void sapp_request_quit(void);
/* cancel a pending quit (when SAPP_EVENTTYPE_QUIT_REQUESTED has been received)
 */
SOKOL_APP_API_DECL void sapp_cancel_quit(void);
/* initiate a "hard quit" (quit application without sending
 * SAPP_EVENTTYPE_QUIT_REQUESTED) */
SOKOL_APP_API_DECL void sapp_quit(void);
/* call from inside event callback to consume the current event (don't forward
 * to platform) */
SOKOL_APP_API_DECL void sapp_consume_event(void);
/* get the current frame counter (for comparison with sapp_event.frame_count) */
SOKOL_APP_API_DECL uint64_t sapp_frame_count(void);
/* get an averaged/smoothed frame duration in seconds */
SOKOL_APP_API_DECL double sapp_frame_duration(void);
/* write string into clipboard */
SOKOL_APP_API_DECL void sapp_set_clipboard_string(const char *str);
/* read string from clipboard (usually during SAPP_EVENTTYPE_CLIPBOARD_PASTED)
 */
SOKOL_APP_API_DECL const char *sapp_get_clipboard_string(void);
/* set the window title (only on desktop platforms) */
SOKOL_APP_API_DECL void sapp_set_window_title(const char *str);
/* set the window icon (only on Windows and Linux) */
SOKOL_APP_API_DECL void sapp_set_icon(const sapp_icon_desc *icon_desc);
/* gets the total number of dropped files (after an SAPP_EVENTTYPE_FILES_DROPPED
 * event) */
SOKOL_APP_API_DECL int sapp_get_num_dropped_files(void);
/* gets the dropped file paths */
SOKOL_APP_API_DECL const char *sapp_get_dropped_file_path(int index);

/* special run-function for SOKOL_NO_ENTRY (in standard mode this is an empty
 * stub) */
SOKOL_APP_API_DECL void sapp_run(const sapp_desc *desc);

/* get runtime environment information */
sapp_environment sapp_get_environment(void);
/* get current frame's swapchain information (call once per frame!) */
sapp_swapchain sapp_get_swapchain(void);

/* EGL: get EGLDisplay object */
SOKOL_APP_API_DECL const void *sapp_egl_get_display(void);
/* EGL: get EGLContext object */
SOKOL_APP_API_DECL const void *sapp_egl_get_context(void);

/* HTML5: enable or disable the hardwired "Leave Site?" dialog box */
SOKOL_APP_API_DECL void sapp_html5_ask_leave_site(bool ask);
/* HTML5: get byte size of a dropped file */
SOKOL_APP_API_DECL uint32_t sapp_html5_get_dropped_file_size(int index);
/* HTML5: asynchronously load the content of a dropped file */
SOKOL_APP_API_DECL void
sapp_html5_fetch_dropped_file(const sapp_html5_fetch_request *request);

/* macOS: get bridged pointer to macOS NSWindow */
SOKOL_APP_API_DECL const void *sapp_macos_get_window(void);
/* iOS: get bridged pointer to iOS UIWindow */
SOKOL_APP_API_DECL const void *sapp_ios_get_window(void);

/* D3D11: get pointer to IDXGISwapChain object */
SOKOL_APP_API_DECL const void *sapp_d3d11_get_swap_chain(void);

/* Win32: get the HWND window handle */
SOKOL_APP_API_DECL const void *sapp_win32_get_hwnd(void);

/* GL: get major version */
SOKOL_APP_API_DECL int sapp_gl_get_major_version(void);
/* GL: get minor version */
SOKOL_APP_API_DECL int sapp_gl_get_minor_version(void);
/* GL: return true if the context is GLES */
SOKOL_APP_API_DECL bool sapp_gl_is_gles(void);
/* GL: get default framebuffer */
SOKOL_APP_API_DECL uint32_t sapp_gl_get_framebuffer(void);

/* X11: get Window */
SOKOL_APP_API_DECL const void *sapp_x11_get_window(void);
/* X11: get Display */
SOKOL_APP_API_DECL const void *sapp_x11_get_display(void);

/* Android: get native activity handle */
SOKOL_APP_API_DECL const void *sapp_android_get_native_activity(void);

#ifdef __cplusplus
} /* extern "C" */

/* reference-based equivalents for C++ */
inline void sapp_run(const sapp_desc &desc) { return sapp_run(&desc); }

#endif

#endif // SOKOL_APP_INCLUDED

// ██ ███    ███ ██████  ██      ███████ ███    ███ ███████ ███    ██ ████████
// █████  ████████ ██  ██████  ███    ██ ██ ████  ████ ██   ██ ██      ██ ████
// ████ ██      ████   ██    ██    ██   ██    ██    ██ ██    ██ ████   ██ ██ ██
// ████ ██ ██████  ██      █████   ██ ████ ██ █████   ██ ██  ██    ██    ███████
// ██    ██ ██    ██ ██ ██  ██ ██ ██  ██  ██ ██      ██      ██      ██  ██  ██
// ██      ██  ██ ██    ██    ██   ██    ██    ██ ██    ██ ██  ██ ██ ██ ██ ██ ██
// ███████ ███████ ██      ██ ███████ ██   ████    ██    ██   ██    ██    ██
// ██████  ██   ████
//
// >>implementation
#ifdef SOKOL_APP_IMPL
#ifndef SOKOL_APP_IMPL_INCLUDED
#define SOKOL_APP_IMPL_INCLUDED

#if defined(SOKOL_MALLOC) || defined(SOKOL_CALLOC) || defined(SOKOL_FREE)
#error                                                                         \
    "SOKOL_MALLOC/CALLOC/FREE macros are no longer supported, please use sapp_desc.allocator to override memory allocation functions"
#endif

#include <math.h>   // roundf
#include <stddef.h> // size_t
#include <stdlib.h> // malloc, free
#include <string.h> // memset, strncmp

// helper macros
#define _sapp_def(val, def) (((val) == 0) ? (def) : (val))
#define _sapp_absf(a) (((a) < 0.0f) ? -(a) : (a))

#ifdef __cplusplus
#define _SAPP_STRUCT(TYPE, NAME) TYPE NAME = {}
#else
#define _SAPP_STRUCT(TYPE, NAME) TYPE NAME = {0}
#endif

#define _SAPP_MAX_TITLE_LENGTH (128)
#define _SAPP_FALLBACK_DEFAULT_WINDOW_WIDTH (640)
#define _SAPP_FALLBACK_DEFAULT_WINDOW_HEIGHT (480)

// check if the config defines are alright
#if defined(__APPLE__)
// see
// https://clang.llvm.org/docs/LanguageExtensions.html#automatic-reference-counting
#if !defined(__cplusplus)
#if __has_feature(objc_arc) && !__has_feature(objc_arc_fields)
#error                                                                         \
    "sokol_app.h requires __has_feature(objc_arc_field) if ARC is enabled (use a more recent compiler version)"
#endif
#endif
#define _SAPP_APPLE (1)
#include <TargetConditionals.h>
#if defined(TARGET_OS_IPHONE) && !TARGET_OS_IPHONE
// MacOS
#define _SAPP_MACOS (1)
#if !defined(SOKOL_METAL) && !defined(SOKOL_GLCORE) && !defined(SOKOL_WGPU)
#error ("sokol_app.h: unknown 3D API selected for MacOS, must be SOKOL_METAL, SOKOL_GLCORE or SOKOL_WGPU")
#endif
#else
// iOS or iOS Simulator
#define _SAPP_IOS (1)
#if !defined(SOKOL_METAL) && !defined(SOKOL_GLES3)
#error ("sokol_app.h: unknown 3D API selected for iOS, must be SOKOL_METAL or SOKOL_GLES3")
#endif
#if TARGET_OS_TV
#define _SAPP_TVOS (1)
#endif
#endif
#elif defined(__EMSCRIPTEN__)
// Emscripten
#define _SAPP_EMSCRIPTEN (1)
#if !defined(SOKOL_GLES3) && !defined(SOKOL_WGPU)
#error ("sokol_app.h: unknown 3D API selected for emscripten, must be SOKOL_GLES3 or SOKOL_WGPU")
#endif
#elif defined(_WIN32)
// Windows (D3D11 or GL)
#define _SAPP_WIN32 (1)
#if !defined(SOKOL_D3D11) && !defined(SOKOL_GLCORE) && !defined(SOKOL_WGPU) && \
    !defined(SOKOL_VULKAN) && !defined(SOKOL_NOAPI)
#error ("sokol_app.h: unknown 3D API selected for Win32, must be SOKOL_D3D11, SOKOL_GLCORE, SOKOL_WGPU, SOKOL_VULKAN or SOKOL_NOAPI")
#endif
#if defined(SOKOL_VULKAN)
#define VK_USE_PLATFORM_WIN32_KHR
#include <vulkan/vulkan.h>
#endif
#elif defined(__ANDROID__)
// Android
#define _SAPP_ANDROID (1)
#if !defined(SOKOL_GLES3)
#error ("sokol_app.h: unknown 3D API selected for Android, must be SOKOL_GLES3")
#endif
#if defined(SOKOL_NO_ENTRY)
#error ("sokol_app.h: SOKOL_NO_ENTRY is not supported on Android")
#endif
#elif defined(__linux__) || defined(__unix__)
// Linux
#define _SAPP_LINUX (1)

// Define POSIX features early for clock_gettime and other POSIX functions
#ifndef _POSIX_C_SOURCE
#define _POSIX_C_SOURCE 199309L
#endif

// Wayland/X11 platform selection
// Default to X11 on Linux unless SOKOL_WAYLAND or SOKOL_X11 is explicitly defined
// Note: This must come AFTER sokol_app.h checks for SOKOL_GLCORE etc.
#if defined(__linux__) && !defined(SOKOL_WAYLAND) && !defined(SOKOL_X11)
#define SOKOL_X11 (1)
#endif
#if !defined(SOKOL_DISABLE_WAYLAND)
#if defined(SOKOL_WAYLAND) || (!defined(SOKOL_X11) && defined(__linux__))
#define _SAPP_WAYLAND (1)
#endif
#endif
#if !defined(_SAPP_WAYLAND)
#define _SAPP_X11 (1)
#endif

#if !defined(SOKOL_GLCORE) && !defined(SOKOL_GLES3) && !defined(SOKOL_WGPU) && \
    !defined(SOKOL_VULKAN)
#error ("sokol_app.h: unknown 3D API selected for Linux, must be SOKOL_GLCORE, SOKOL_GLES3, SOKOL_WGPU or SOKOL_VULKAN")
#endif
#if defined(SOKOL_GLCORE)
#if defined(SOKOL_FORCE_EGL) || defined(_SAPP_WAYLAND)
#define _SAPP_EGL (1)
#else
#define _SAPP_GLX (1)
#endif
#define GL_GLEXT_PROTOTYPES
#include <GL/gl.h>
#elif defined(SOKOL_GLES3)
#define _SAPP_EGL (1)
#include <GLES3/gl3.h>
#include <GLES3/gl3ext.h>
#elif defined(SOKOL_VULKAN)
#if defined(_SAPP_WAYLAND)
#define VK_USE_PLATFORM_WAYLAND_KHR
#else
#define VK_USE_PLATFORM_XLIB_KHR
#endif
#include <vulkan/vulkan.h>
#endif
#else
#error "sokol_app.h: Unknown platform"
#endif

#if defined(SOKOL_GLCORE) || defined(SOKOL_GLES3)
#define _SAPP_ANY_GL (1)
#endif

#ifndef SOKOL_API_IMPL
#define SOKOL_API_IMPL
#endif
#ifndef SOKOL_DEBUG
#ifndef NDEBUG
#define SOKOL_DEBUG
#endif
#endif
#ifndef SOKOL_ASSERT
#include <assert.h>
#define SOKOL_ASSERT(c) assert(c)
#endif
#ifndef SOKOL_UNREACHABLE
#define SOKOL_UNREACHABLE SOKOL_ASSERT(false)
#endif

#ifndef _SOKOL_PRIVATE
#if defined(__GNUC__) || defined(__clang__)
#define _SOKOL_PRIVATE __attribute__((unused)) static
#else
#define _SOKOL_PRIVATE static
#endif
#endif
#ifndef _SOKOL_UNUSED
#define _SOKOL_UNUSED(x) (void)(x)
#endif

#if defined(SOKOL_WGPU)
#include <webgpu/webgpu.h>
#if !defined(__EMSCRIPTEN__)
#define _SAPP_WGPU_HAS_WAIT (1)
#endif
#endif

#if defined(_SAPP_APPLE)
#ifndef GL_SILENCE_DEPRECATION
#define GL_SILENCE_DEPRECATION
#endif
#if defined(SOKOL_METAL)
#import <Metal/Metal.h>
#import <MetalKit/MetalKit.h>
#endif
#if defined(_SAPP_MACOS)
#import <Cocoa/Cocoa.h>
#if defined(_SAPP_ANY_GL)
#include <OpenGL/gl3.h>
#endif
#if defined(SOKOL_WGPU)
#import <QuartzCore/CADisplayLink.h>
#import <QuartzCore/CAMetalLayer.h>
#endif
#elif defined(_SAPP_IOS)
#import <UIKit/UIKit.h>
#if defined(_SAPP_ANY_GL)
#import <GLKit/GLKit.h>
#include <OpenGLES/ES3/gl.h>
#endif
#endif
#include <AvailabilityMacros.h>
#include <mach/mach_time.h>
#elif defined(_SAPP_EMSCRIPTEN)
#if defined(SOKOL_GLES3)
#include <GLES3/gl3.h>
#endif
#include <emscripten/emscripten.h>
#include <emscripten/html5.h>
#elif defined(_SAPP_WIN32)
#ifdef _MSC_VER
#pragma warning(push)
#pragma warning(                                                               \
    disable : 4201) /* nonstandard extension used: nameless struct/union */
#pragma warning(disable : 4204) /* nonstandard extension used: non-constant    \
                                   aggregate initializer */
#pragma warning(disable : 4054) /* 'type cast': from function pointer */
#pragma warning(disable : 4055) /* 'type cast': from data pointer */
#pragma warning(disable                                                        \
                : 4505) /* unreferenced local function has been removed */
#pragma warning(disable : 4115) /* /W4: 'ID3D11ModuleInstance': named type     \
                                   definition in parentheses (in d3d11.h) */
#endif
#ifndef WIN32_LEAN_AND_MEAN
#define WIN32_LEAN_AND_MEAN
#endif
#ifndef NOMINMAX
#define NOMINMAX
#endif
#include <shellapi.h>
#include <windows.h>
#include <windowsx.h>

#if defined(__GNUC__)
#pragma GCC diagnostic push
#pragma GCC diagnostic ignored "-Wunknown-pragmas"
#endif

#if !defined(                                                                  \
    SOKOL_NO_ENTRY) // if SOKOL_NO_ENTRY is defined, it's the application's
                    // responsibility to use the right subsystem

#if defined(SOKOL_WIN32_FORCE_MAIN) && defined(SOKOL_WIN32_FORCE_WINMAIN)
// If both are defined, it's the application's responsibility to use the right
// subsystem
#elif defined(SOKOL_WIN32_FORCE_MAIN)
#pragma comment(linker, "/subsystem:console")
#else
#pragma comment(linker, "/subsystem:windows")
#endif
#endif
#include <stdio.h> /* freopen_s() */
#include <wchar.h> /* wcslen() */

#pragma comment(lib, "kernel32")
#pragma comment(lib, "user32")
#pragma comment(                                                               \
    lib, "shell32") /* CommandLineToArgvW, DragQueryFileW, DragFinished */
#pragma comment(lib, "gdi32")
#if defined(SOKOL_D3D11)
#pragma comment(lib, "dxgi")
#pragma comment(lib, "d3d11")
#endif

#if defined(__GNUC__)
#pragma GCC diagnostic pop
#endif

#if defined(SOKOL_D3D11)
#ifndef D3D11_NO_HELPERS
#define D3D11_NO_HELPERS
#endif
#include <d3d11.h>
#include <dxgi.h>
// DXGI_SWAP_EFFECT_FLIP_DISCARD is only defined in newer Windows SDKs, so don't
// depend on it
#define _SAPP_DXGI_SWAP_EFFECT_FLIP_DISCARD (4)
#endif
#ifndef WM_MOUSEHWHEEL /* see https://github.com/floooh/sokol/issues/138 */
#define WM_MOUSEHWHEEL (0x020E)
#endif
#ifndef WM_DPICHANGED
#define WM_DPICHANGED (0x02E0)
#endif
#elif defined(_SAPP_ANDROID)
#include <EGL/egl.h>
#include <GLES3/gl3.h>
#include <android/looper.h>
#include <android/native_activity.h>
#include <pthread.h>
#include <time.h>
#include <unistd.h>
#elif defined(_SAPP_LINUX)
#define GL_GLEXT_PROTOTYPES
#if defined(_SAPP_X11)
#include <X11/XKBlib.h>
#include <X11/Xatom.h>
#include <X11/Xcursor/Xcursor.h>
#include <X11/Xlib.h>
#include <X11/Xmd.h> /* CARD32 */
#include <X11/Xresource.h>
#include <X11/Xutil.h>
#include <X11/cursorfont.h> /* XC_* font cursors */
#include <X11/extensions/XInput2.h>
#include <X11/keysym.h>
#endif
#if defined(_SAPP_WAYLAND)
#include <linux/input-event-codes.h>
#include <string.h>
#include <sys/mman.h>
#include <sys/timerfd.h>
#include <wayland-client.h>
#include <wayland-cursor.h>
#include <wayland-egl.h>
#include <xkbcommon/xkbcommon-compose.h>
#include <xkbcommon/xkbcommon.h>

// struct forward declarations
struct xdg_wm_base;
struct xdg_surface;
struct xdg_toplevel;
struct zwp_pointer_constraints_v1;
struct zwp_locked_pointer_v1;
struct zwp_relative_pointer_manager_v1;
struct zwp_relative_pointer_v1;
struct wp_cursor_shape_manager_v1;
struct wp_cursor_shape_device_v1;
struct wp_fractional_scale_manager_v1;
struct wp_fractional_scale_v1;
struct zxdg_decoration_manager_v1;
struct zxdg_toplevel_decoration_v1;

// interface forward declarations
extern const struct wl_interface wl_compositor_interface;
extern const struct wl_interface wl_surface_interface;
extern const struct wl_interface wl_seat_interface;
extern const struct wl_interface wl_shm_interface;
extern const struct wl_interface xdg_wm_base_interface;
extern const struct wl_interface xdg_surface_interface;
extern const struct wl_interface xdg_toplevel_interface;
extern const struct wl_interface wl_data_device_manager_interface;
extern const struct wl_interface zwp_pointer_constraints_v1_interface;
extern const struct wl_interface zwp_relative_pointer_manager_v1_interface;
extern const struct wl_interface wp_cursor_shape_manager_v1_interface;
extern const struct wl_interface wp_fractional_scale_manager_v1_interface;
extern const struct wl_interface wp_viewporter_interface;
extern const struct wl_interface zxdg_decoration_manager_v1_interface;
#endif
#if defined(_SAPP_EGL)
#include <EGL/egl.h>
#endif
#if defined(_SAPP_WAYLAND)
#include "cursor-shape-v1-client-protocol.h"
#include "fractional-scale-v1-client-protocol.h"
#include "pointer-constraints-unstable-v1-client-protocol.h"
#include "relative-pointer-unstable-v1-client-protocol.h"
#include "viewporter-client-protocol.h"
#include "xdg-decoration-unstable-v1-client-protocol.h"
#include "xdg-shell-client-protocol.h"
#endif
#include <dlfcn.h>  /* dlopen, dlsym, dlclose */
#include <limits.h> /* LONG_MAX */
#include <poll.h>
#include <pthread.h> /* only used a linker-guard, search for _sapp_linux_run() and see first comment */
#include <time.h>
#include <unistd.h>
#endif

#if defined(_SAPP_APPLE)
// this is ARC compatible
#if defined(__cplusplus)
#define _SAPP_CLEAR_ARC_STRUCT(type, item)                                     \
  {                                                                            \
    item = type();                                                             \
  }
#else
#define _SAPP_CLEAR_ARC_STRUCT(type, item)                                     \
  {                                                                            \
    item = (type){0};                                                          \
  }
#endif
#else
#define _SAPP_CLEAR_ARC_STRUCT(type, item)                                     \
  {                                                                            \
    _sapp_clear(&item, sizeof(item));                                          \
  }
#endif

// ███████ ██████   █████  ███    ███ ███████     ████████ ██ ███    ███ ██ ███
// ██  ██████ ██      ██   ██ ██   ██ ████  ████ ██             ██    ██ ████
// ████ ██ ████   ██ ██ █████   ██████  ███████ ██ ████ ██ █████          ██ ██
// ██ ████ ██ ██ ██ ██  ██ ██   ███ ██      ██   ██ ██   ██ ██  ██  ██ ██ ██ ██
// ██  ██  ██ ██ ██  ██ ██ ██    ██ ██      ██   ██ ██   ██ ██      ██ ███████
// ██    ██ ██      ██ ██ ██   ████  ██████
//
// >>frame timing
#define _SAPP_RING_NUM_SLOTS (256)
typedef struct {
  int head;
  int tail;
  double buf[_SAPP_RING_NUM_SLOTS];
} _sapp_ring_t;

_SOKOL_PRIVATE int _sapp_ring_idx(int i) { return i % _SAPP_RING_NUM_SLOTS; }

_SOKOL_PRIVATE void _sapp_ring_init(_sapp_ring_t *ring) {
  ring->head = 0;
  ring->tail = 0;
}

_SOKOL_PRIVATE bool _sapp_ring_full(_sapp_ring_t *ring) {
  return _sapp_ring_idx(ring->head + 1) == ring->tail;
}

_SOKOL_PRIVATE bool _sapp_ring_empty(_sapp_ring_t *ring) {
  return ring->head == ring->tail;
}

_SOKOL_PRIVATE int _sapp_ring_count(_sapp_ring_t *ring) {
  int count;
  if (ring->head >= ring->tail) {
    count = ring->head - ring->tail;
  } else {
    count = (ring->head + _SAPP_RING_NUM_SLOTS) - ring->tail;
  }
  SOKOL_ASSERT((count >= 0) && (count < _SAPP_RING_NUM_SLOTS));
  return count;
}

_SOKOL_PRIVATE void _sapp_ring_enqueue(_sapp_ring_t *ring, double val) {
  SOKOL_ASSERT(!_sapp_ring_full(ring));
  ring->buf[ring->head] = val;
  ring->head = _sapp_ring_idx(ring->head + 1);
}

_SOKOL_PRIVATE double _sapp_ring_dequeue(_sapp_ring_t *ring) {
  SOKOL_ASSERT(!_sapp_ring_empty(ring));
  double val = ring->buf[ring->tail];
  ring->tail = _sapp_ring_idx(ring->tail + 1);
  return val;
}

/*
    NOTE:

    Q: Why not use CAMetalDrawable.presentedTime on macOS and iOS?
    A: The value appears to be highly unstable during the first few
    seconds, sometimes several frames are dropped in sequence, or
    switch between 120 and 60 Hz for a few frames. Simply measuring
    and averaging the frame time yielded a more stable frame duration.
    Maybe switching to CVDisplayLink would yield better results.
    Until then just measure the time.
*/
typedef struct {
#if defined(_SAPP_APPLE)
  struct {
    mach_timebase_info_data_t timebase;
    uint64_t start;
  } mach;
#elif defined(_SAPP_EMSCRIPTEN)
  // empty
#elif defined(_SAPP_WIN32)
  struct {
    LARGE_INTEGER freq;
    LARGE_INTEGER start;
  } win;
#else // Linux, Android, ...
#ifdef CLOCK_MONOTONIC
#define _SAPP_CLOCK_MONOTONIC CLOCK_MONOTONIC
#else
// on some embedded platforms, CLOCK_MONOTONIC isn't defined
#define _SAPP_CLOCK_MONOTONIC (1)
#endif
  struct {
    uint64_t start;
  } posix;
#endif
} _sapp_timestamp_t;

_SOKOL_PRIVATE int64_t _sapp_int64_muldiv(int64_t value, int64_t numer,
                                          int64_t denom) {
  int64_t q = value / denom;
  int64_t r = value % denom;
  return q * numer + r * numer / denom;
}

_SOKOL_PRIVATE void _sapp_timestamp_init(_sapp_timestamp_t *ts) {
#if defined(_SAPP_APPLE)
  mach_timebase_info(&ts->mach.timebase);
  ts->mach.start = mach_absolute_time();
#elif defined(_SAPP_EMSCRIPTEN)
  (void)ts;
#elif defined(_SAPP_WIN32)
  QueryPerformanceFrequency(&ts->win.freq);
  QueryPerformanceCounter(&ts->win.start);
#else
// Ensure clock_gettime is declared
#if !defined(CLOCK_MONOTONIC)
#define CLOCK_MONOTONIC 1
#endif
#if !defined(_SAPP_CLOCK_MONOTONIC)
#define _SAPP_CLOCK_MONOTONIC CLOCK_MONOTONIC
#endif
  extern int clock_gettime(int, struct timespec *);
  struct timespec tspec;
  clock_gettime(_SAPP_CLOCK_MONOTONIC, &tspec);
  ts->posix.start =
      (uint64_t)tspec.tv_sec * 1000000000 + (uint64_t)tspec.tv_nsec;
#endif
}

_SOKOL_PRIVATE double _sapp_timestamp_now(_sapp_timestamp_t *ts) {
#if defined(_SAPP_APPLE)
  const uint64_t traw = mach_absolute_time() - ts->mach.start;
  const uint64_t now = (uint64_t)_sapp_int64_muldiv(
      (int64_t)traw, (int64_t)ts->mach.timebase.numer,
      (int64_t)ts->mach.timebase.denom);
  return (double)now / 1000000000.0;
#elif defined(_SAPP_EMSCRIPTEN)
  (void)ts;
  SOKOL_ASSERT(false);
  return 0.0;
#elif defined(_SAPP_WIN32)
  LARGE_INTEGER qpc;
  QueryPerformanceCounter(&qpc);
  const uint64_t now = (uint64_t)_sapp_int64_muldiv(
      qpc.QuadPart - ts->win.start.QuadPart, 1000000000, ts->win.freq.QuadPart);
  return (double)now / 1000000000.0;
#else
  extern int clock_gettime(int, struct timespec *);
  struct timespec tspec;
  clock_gettime(_SAPP_CLOCK_MONOTONIC, &tspec);
  const uint64_t now =
      (uint64_t)tspec.tv_sec * 1000000000 + (uint64_t)tspec.tv_nsec;
  const uint64_t elapsed = now - ts->posix.start;
  return (double)elapsed / 1000000000.0;
#endif
}

typedef struct {
  double last;
  double accum;
  double avg;
  int spike_count;
  int num;
  _sapp_timestamp_t timestamp;
  _sapp_ring_t ring;
} _sapp_timing_t;

_SOKOL_PRIVATE void _sapp_timing_reset(_sapp_timing_t *t) {
  t->last = 0.0;
  t->accum = 0.0;
  t->spike_count = 0;
  t->num = 0;
  _sapp_ring_init(&t->ring);
}

_SOKOL_PRIVATE void _sapp_timing_init(_sapp_timing_t *t) {
  t->avg = 1.0 / 60.0; // dummy value until first actual value is available
  _sapp_timing_reset(t);
  _sapp_timestamp_init(&t->timestamp);
}

_SOKOL_PRIVATE void _sapp_timing_put(_sapp_timing_t *t, double dur) {
  // arbitrary upper limit to ignore outliers (e.g. during window resizing, or
  // debugging)
  double min_dur = 0.0;
  double max_dur = 0.1;
  // if we have enough samples for a useful average, use a much tighter 'valid
  // window'
  if (_sapp_ring_full(&t->ring)) {
    min_dur = t->avg * 0.8;
    max_dur = t->avg * 1.2;
  }
  if ((dur < min_dur) || (dur > max_dur)) {
    t->spike_count++;
    // if there have been many spikes in a row, the display refresh rate
    // might have changed, so a timing reset is needed
    if (t->spike_count > 20) {
      _sapp_timing_reset(t);
    }
    return;
  }
  if (_sapp_ring_full(&t->ring)) {
    double old_val = _sapp_ring_dequeue(&t->ring);
    t->accum -= old_val;
    t->num -= 1;
  }
  _sapp_ring_enqueue(&t->ring, dur);
  t->accum += dur;
  t->num += 1;
  SOKOL_ASSERT(t->num > 0);
  t->avg = t->accum / t->num;
  t->spike_count = 0;
}

_SOKOL_PRIVATE void _sapp_timing_discontinuity(_sapp_timing_t *t) {
  t->last = 0.0;
}

_SOKOL_PRIVATE void _sapp_timing_measure(_sapp_timing_t *t) {
  const double now = _sapp_timestamp_now(&t->timestamp);
  if (t->last > 0.0) {
    double dur = now - t->last;
    _sapp_timing_put(t, dur);
  }
  t->last = now;
}

_SOKOL_PRIVATE void _sapp_timing_external(_sapp_timing_t *t, double now) {
  if (t->last > 0.0) {
    double dur = now - t->last;
    _sapp_timing_put(t, dur);
  }
  t->last = now;
}

_SOKOL_PRIVATE double _sapp_timing_get_avg(_sapp_timing_t *t) { return t->avg; }

// ███████ ████████ ██████  ██    ██  ██████ ████████ ███████
// ██         ██    ██   ██ ██    ██ ██         ██    ██
// ███████    ██    ██████  ██    ██ ██         ██    ███████
//      ██    ██    ██   ██ ██    ██ ██         ██         ██
// ███████    ██    ██   ██  ██████   ██████    ██    ███████
//
// >> structs
#if defined(SOKOL_WGPU)
typedef struct {
  WGPUInstance instance;
  WGPUAdapter adapter;
  WGPUDevice device;
  WGPUSurface surface;
  WGPUTextureFormat render_format;
  WGPUTexture msaa_tex;
  WGPUTextureView msaa_view;
  WGPUTexture depth_stencil_tex;
  WGPUTextureView depth_stencil_view;
  WGPUTextureView swapchain_view;
  bool init_done;
} _sapp_wgpu_t;
#endif

#if defined(SOKOL_VULKAN)
#define _SAPP_VK_MAX_SWAPCHAIN_IMAGES (8)

typedef struct {
  VkImage img;
  VkDeviceMemory mem;
  VkImageView view;
} _sapp_vk_swapchain_surface_t;

typedef struct {
  VkInstance instance;
  VkSurfaceKHR surface;
  VkSurfaceFormatKHR surface_format;
  VkPhysicalDevice physical_device;
  uint32_t queue_family_index;
  VkDevice device;
  VkQueue queue;
  VkSwapchainKHR swapchain;
  uint32_t num_swapchain_images;
  uint32_t cur_swapchain_image_index;
  VkImage swapchain_images[_SAPP_VK_MAX_SWAPCHAIN_IMAGES];
  VkImageView swapchain_views[_SAPP_VK_MAX_SWAPCHAIN_IMAGES];
  _sapp_vk_swapchain_surface_t msaa;
  _sapp_vk_swapchain_surface_t depth;
  uint32_t sync_slot;
  struct {
    VkSemaphore render_finished_sem;
    VkSemaphore present_complete_sem;
  } sync[_SAPP_VK_MAX_SWAPCHAIN_IMAGES];
  struct {
    PFN_vkSetDebugUtilsObjectNameEXT set_debug_utils_object_name_ext;
  } ext;
} _sapp_vk_t;
#endif

#if defined(_SAPP_MACOS)
@interface _sapp_macos_app_delegate : NSObject <NSApplicationDelegate>
@end
@interface _sapp_macos_window : NSWindow
@end
@interface _sapp_macos_window_delegate : NSObject <NSWindowDelegate>
@end
#if defined(SOKOL_METAL)
@interface _sapp_macos_view : MTKView
@end
#elif defined(SOKOL_GLCORE)
@interface _sapp_macos_view : NSOpenGLView
- (void)timerFired:(id)sender;
@end
#elif defined(SOKOL_WGPU)
@interface _sapp_macos_view : NSView
- (void)displayLinkFired:(id)sender;
@end
#endif // SOKOL_GLCORE

// __v_ start
@interface MyView2 : NSView
@end

static NSView* g_view = nil;
// __v_ end

typedef struct {
  uint32_t flags_changed_store;
  uint8_t mouse_buttons;
  NSWindow *window;
  NSTrackingArea *tracking_area;
  id keyup_monitor;
  _sapp_macos_app_delegate *app_dlg;
  _sapp_macos_window_delegate *win_dlg;
  _sapp_macos_view *view;
  NSCursor *standard_cursors[_SAPP_MOUSECURSOR_NUM];
  NSCursor *custom_cursors[_SAPP_MOUSECURSOR_NUM];
#if defined(SOKOL_METAL)
  id<MTLDevice> mtl_device;
#endif
#if defined(SOKOL_WGPU)
  struct {
    CAMetalLayer *mtl_layer;
    CADisplayLink *display_link;
  } wgpu;
#endif
} _sapp_macos_t;

#endif // _SAPP_MACOS

#if defined(_SAPP_IOS)

@interface _sapp_app_delegate : NSObject <UIApplicationDelegate>
@end
@interface _sapp_textfield_dlg : NSObject <UITextFieldDelegate>
- (void)keyboardWasShown:(NSNotification *)notif;
- (void)keyboardWillBeHidden:(NSNotification *)notif;
- (void)keyboardDidChangeFrame:(NSNotification *)notif;
@end
#if defined(SOKOL_METAL)
@interface _sapp_ios_view : MTKView
;
@end
#else
@interface _sapp_ios_view : GLKView
@end
#endif

typedef struct {
  UIWindow *window;
  _sapp_ios_view *view;
  UITextField *textfield;
  _sapp_textfield_dlg *textfield_dlg;
#if defined(SOKOL_METAL)
  UIViewController *view_ctrl;
  id<MTLDevice> mtl_device;
#else
  GLKViewController *view_ctrl;
  EAGLContext *eagl_ctx;
#endif
  bool suspended;
} _sapp_ios_t;

#endif // _SAPP_IOS

#if defined(_SAPP_EMSCRIPTEN)

typedef struct {
  bool mouse_lock_requested;
  uint16_t mouse_buttons;
} _sapp_emsc_t;
#endif // _SAPP_EMSCRIPTEN

#if defined(SOKOL_D3D11) && defined(_SAPP_WIN32)
typedef struct {
  ID3D11Device *device;
  ID3D11DeviceContext *device_context;
  ID3D11Texture2D *rt;
  ID3D11RenderTargetView *rtv;
  ID3D11Texture2D *msaa_rt;
  ID3D11RenderTargetView *msaa_rtv;
  ID3D11Texture2D *ds;
  ID3D11DepthStencilView *dsv;
  DXGI_SWAP_CHAIN_DESC swap_chain_desc;
  IDXGISwapChain *swap_chain;
  IDXGIDevice1 *dxgi_device;
  bool use_dxgi_frame_stats;
  UINT sync_refresh_count;
} _sapp_d3d11_t;
#endif

#if defined(_SAPP_WIN32)

#ifndef DPI_ENUMS_DECLARED
typedef enum PROCESS_DPI_AWARENESS {
  PROCESS_DPI_UNAWARE = 0,
  PROCESS_SYSTEM_DPI_AWARE = 1,
  PROCESS_PER_MONITOR_DPI_AWARE = 2
} PROCESS_DPI_AWARENESS;
typedef enum MONITOR_DPI_TYPE {
  MDT_EFFECTIVE_DPI = 0,
  MDT_ANGULAR_DPI = 1,
  MDT_RAW_DPI = 2,
  MDT_DEFAULT = MDT_EFFECTIVE_DPI
} MONITOR_DPI_TYPE;
#endif // DPI_ENUMS_DECLARED

typedef struct {
  bool aware;
  float content_scale;
  float window_scale;
  float mouse_scale;
} _sapp_win32_dpi_t;

typedef struct {
  HWND hwnd;
  HMONITOR hmonitor;
  HDC dc;
  HICON big_icon;
  HICON small_icon;
  HCURSOR standard_cursors[_SAPP_MOUSECURSOR_NUM];
  HCURSOR custom_cursors[_SAPP_MOUSECURSOR_NUM];
  UINT orig_codepage;
  WCHAR surrogate;
  RECT stored_window_rect; // used to restore window pos/size when toggling
                           // fullscreen => windowed
  bool is_win10_or_greater;
  bool in_create_window;
  bool iconified;
  _sapp_win32_dpi_t dpi;
  struct {
    struct {
      LONG pos_x, pos_y;
      bool pos_valid;
    } lock;
    struct {
      LONG pos_x, pos_y;
      bool pos_valid;
    } raw_input;
    bool requested_lock;
    bool tracked;
    uint8_t capture_mask;
  } mouse;
  struct {
    size_t size;
    void *ptr;
  } raw_input_data;
} _sapp_win32_t;

#if defined(SOKOL_GLCORE)
#define WGL_NUMBER_PIXEL_FORMATS_ARB 0x2000
#define WGL_SUPPORT_OPENGL_ARB 0x2010
#define WGL_DRAW_TO_WINDOW_ARB 0x2001
#define WGL_PIXEL_TYPE_ARB 0x2013
#define WGL_TYPE_RGBA_ARB 0x202b
#define WGL_ACCELERATION_ARB 0x2003
#define WGL_NO_ACCELERATION_ARB 0x2025
#define WGL_RED_BITS_ARB 0x2015
#define WGL_GREEN_BITS_ARB 0x2017
#define WGL_BLUE_BITS_ARB 0x2019
#define WGL_ALPHA_BITS_ARB 0x201b
#define WGL_DEPTH_BITS_ARB 0x2022
#define WGL_STENCIL_BITS_ARB 0x2023
#define WGL_DOUBLE_BUFFER_ARB 0x2011
#define WGL_SAMPLES_ARB 0x2042
#define WGL_CONTEXT_DEBUG_BIT_ARB 0x00000001
#define WGL_CONTEXT_FORWARD_COMPATIBLE_BIT_ARB 0x00000002
#define WGL_CONTEXT_PROFILE_MASK_ARB 0x9126
#define WGL_CONTEXT_CORE_PROFILE_BIT_ARB 0x00000001
#define WGL_CONTEXT_MAJOR_VERSION_ARB 0x2091
#define WGL_CONTEXT_MINOR_VERSION_ARB 0x2092
#define WGL_CONTEXT_FLAGS_ARB 0x2094
#define ERROR_INVALID_VERSION_ARB 0x2095
#define ERROR_INVALID_PROFILE_ARB 0x2096
#define ERROR_INCOMPATIBLE_DEVICE_CONTEXTS_ARB 0x2054
typedef BOOL(WINAPI *PFNWGLSWAPINTERVALEXTPROC)(int);
typedef BOOL(WINAPI *PFNWGLGETPIXELFORMATATTRIBIVARBPROC)(HDC, int, int, UINT,
                                                          const int *, int *);
typedef const char *(WINAPI *PFNWGLGETEXTENSIONSSTRINGEXTPROC)(void);
typedef const char *(WINAPI *PFNWGLGETEXTENSIONSSTRINGARBPROC)(HDC);
typedef HGLRC(WINAPI *PFNWGLCREATECONTEXTATTRIBSARBPROC)(HDC, HGLRC,
                                                         const int *);
typedef HGLRC(WINAPI *PFN_wglCreateContext)(HDC);
typedef BOOL(WINAPI *PFN_wglDeleteContext)(HGLRC);
typedef PROC(WINAPI *PFN_wglGetProcAddress)(LPCSTR);
typedef HDC(WINAPI *PFN_wglGetCurrentDC)(void);
typedef BOOL(WINAPI *PFN_wglMakeCurrent)(HDC, HGLRC);

typedef struct {
  HINSTANCE opengl32;
  HGLRC gl_ctx;
  PFN_wglCreateContext CreateContext;
  PFN_wglDeleteContext DeleteContext;
  PFN_wglGetProcAddress GetProcAddress;
  PFN_wglGetCurrentDC GetCurrentDC;
  PFN_wglMakeCurrent MakeCurrent;
  PFNWGLSWAPINTERVALEXTPROC SwapIntervalEXT;
  PFNWGLGETPIXELFORMATATTRIBIVARBPROC GetPixelFormatAttribivARB;
  PFNWGLGETEXTENSIONSSTRINGEXTPROC GetExtensionsStringEXT;
  PFNWGLGETEXTENSIONSSTRINGARBPROC GetExtensionsStringARB;
  PFNWGLCREATECONTEXTATTRIBSARBPROC CreateContextAttribsARB;
  // special case glGetIntegerv
  void(WINAPI *GetIntegerv)(uint32_t pname, int32_t *data);
  bool ext_swap_control;
  bool arb_multisample;
  bool arb_pixel_format;
  bool arb_create_context;
  bool arb_create_context_profile;
  HWND msg_hwnd;
  HDC msg_dc;
} _sapp_wgl_t;
#endif // SOKOL_GLCORE

#endif // _SAPP_WIN32

#if defined(_SAPP_ANDROID)
typedef enum {
  _SOKOL_ANDROID_MSG_CREATE,
  _SOKOL_ANDROID_MSG_RESUME,
  _SOKOL_ANDROID_MSG_PAUSE,
  _SOKOL_ANDROID_MSG_FOCUS,
  _SOKOL_ANDROID_MSG_NO_FOCUS,
  _SOKOL_ANDROID_MSG_SET_NATIVE_WINDOW,
  _SOKOL_ANDROID_MSG_SET_INPUT_QUEUE,
  _SOKOL_ANDROID_MSG_DESTROY,
} _sapp_android_msg_t;

typedef struct {
  pthread_t thread;
  pthread_mutex_t mutex;
  pthread_cond_t cond;
  int read_from_main_fd;
  int write_from_main_fd;
} _sapp_android_pt_t;

typedef struct {
  ANativeWindow *window;
  AInputQueue *input;
} _sapp_android_resources_t;

typedef struct {
  ANativeActivity *activity;
  _sapp_android_pt_t pt;
  _sapp_android_resources_t pending;
  _sapp_android_resources_t current;
  ALooper *looper;
  bool is_thread_started;
  bool is_thread_stopping;
  bool is_thread_stopped;
  bool has_created;
  bool has_resumed;
  bool has_focus;
  EGLConfig config;
  EGLDisplay display;
  EGLContext context;
  EGLSurface surface;
} _sapp_android_t;

#endif // _SAPP_ANDROID

#if defined(_SAPP_LINUX)

#if defined(_SAPP_X11)
#define _SAPP_X11_XDND_VERSION (5)
#define _SAPP_X11_MAX_X11_KEYCODES (256)

#define GLX_VENDOR 1
#define GLX_RGBA_BIT 0x00000001
#define GLX_WINDOW_BIT 0x00000001
#define GLX_DRAWABLE_TYPE 0x8010
#define GLX_RENDER_TYPE 0x8011
#define GLX_DOUBLEBUFFER 5
#define GLX_RED_SIZE 8
#define GLX_GREEN_SIZE 9
#define GLX_BLUE_SIZE 10
#define GLX_ALPHA_SIZE 11
#define GLX_DEPTH_SIZE 12
#define GLX_STENCIL_SIZE 13
#define GLX_SAMPLES 0x186a1
#define GLX_CONTEXT_CORE_PROFILE_BIT_ARB 0x00000001
#define GLX_CONTEXT_PROFILE_MASK_ARB 0x9126
#define GLX_CONTEXT_FORWARD_COMPATIBLE_BIT_ARB 0x00000002
#define GLX_CONTEXT_MAJOR_VERSION_ARB 0x2091
#define GLX_CONTEXT_MINOR_VERSION_ARB 0x2092
#define GLX_CONTEXT_FLAGS_ARB 0x2094

typedef XID GLXWindow;
typedef XID GLXDrawable;
typedef struct __GLXFBConfig *GLXFBConfig;
typedef struct __GLXcontext *GLXContext;
typedef void (*__GLXextproc)(void);

typedef int (*PFNGLXGETFBCONFIGATTRIBPROC)(Display *, GLXFBConfig, int, int *);
typedef const char *(*PFNGLXGETCLIENTSTRINGPROC)(Display *, int);
typedef Bool (*PFNGLXQUERYEXTENSIONPROC)(Display *, int *, int *);
typedef Bool (*PFNGLXQUERYVERSIONPROC)(Display *, int *, int *);
typedef void (*PFNGLXDESTROYCONTEXTPROC)(Display *, GLXContext);
typedef Bool (*PFNGLXMAKECURRENTPROC)(Display *, GLXDrawable, GLXContext);
typedef void (*PFNGLXSWAPBUFFERSPROC)(Display *, GLXDrawable);
typedef const char *(*PFNGLXQUERYEXTENSIONSSTRINGPROC)(Display *, int);
typedef GLXFBConfig *(*PFNGLXGETFBCONFIGSPROC)(Display *, int, int *);
typedef __GLXextproc (*PFNGLXGETPROCADDRESSPROC)(const char *procName);
typedef void (*PFNGLXSWAPINTERVALEXTPROC)(Display *, GLXDrawable, int);
typedef XVisualInfo *(*PFNGLXGETVISUALFROMFBCONFIGPROC)(Display *, GLXFBConfig);
typedef GLXWindow (*PFNGLXCREATEWINDOWPROC)(Display *, GLXFBConfig, Window,
                                            const int *);
typedef void (*PFNGLXDESTROYWINDOWPROC)(Display *, GLXWindow);

typedef int (*PFNGLXSWAPINTERVALMESAPROC)(int);
typedef GLXContext (*PFNGLXCREATECONTEXTATTRIBSARBPROC)(Display *, GLXFBConfig,
                                                        GLXContext, Bool,
                                                        const int *);

typedef struct {
  bool available;
  int major_opcode;
  int event_base;
  int error_base;
  int major;
  int minor;
} _sapp_xi_t;

typedef struct {
  int version;
  Window source;
  Atom format;
  Atom XdndAware;
  Atom XdndEnter;
  Atom XdndPosition;
  Atom XdndStatus;
  Atom XdndActionCopy;
  Atom XdndDrop;
  Atom XdndFinished;
  Atom XdndSelection;
  Atom XdndTypeList;
  Atom text_uri_list;
} _sapp_xdnd_t;

typedef struct {
  uint8_t mouse_buttons;
  Display *display;
  int screen;
  Window root;
  Colormap colormap;
  Window window;
  Cursor hidden_cursor;
  Cursor standard_cursors[_SAPP_MOUSECURSOR_NUM];
  Cursor custom_cursors[_SAPP_MOUSECURSOR_NUM];
  int window_state;
  float dpi;
  unsigned char error_code;
  Atom UTF8_STRING;
  Atom CLIPBOARD;
  Atom TARGETS;
  Atom WM_PROTOCOLS;
  Atom WM_DELETE_WINDOW;
  Atom WM_STATE;
  Atom NET_WM_NAME;
  Atom NET_WM_ICON_NAME;
  Atom NET_WM_ICON;
  Atom NET_WM_STATE;
  Atom NET_WM_STATE_FULLSCREEN;
  _sapp_xi_t xi;
  _sapp_xdnd_t xdnd;
  // XLib manual says keycodes are in the range [8, 255] inclusive.
  // https://tronche.com/gui/x/xlib/input/keyboard-encoding.html
  bool key_repeat[_SAPP_X11_MAX_X11_KEYCODES];
} _sapp_x11_t;
#endif // _SAPP_X11

#if defined(_SAPP_WAYLAND)
typedef struct {
  // Core Wayland objects
  struct wl_display *display;
  struct wl_registry *registry;
  struct wl_compositor *compositor;
  struct wl_surface *surface;
  struct wl_egl_window *egl_window;
  struct wl_shm *shm;

  // XDG shell
  struct xdg_wm_base *xdg_wm_base;
  struct xdg_surface *xdg_surface;
  struct xdg_toplevel *xdg_toplevel;

  // Input
  struct wl_seat *seat;
  struct wl_pointer *pointer;
  struct wl_keyboard *keyboard;
  struct wl_touch *touch;
  uint32_t seat_version;

  // Pointer constraints and relative pointer (for mouse lock)
  struct zwp_pointer_constraints_v1 *pointer_constraints;
  struct zwp_locked_pointer_v1 *locked_pointer;
  struct zwp_relative_pointer_manager_v1 *relative_pointer_manager;
  struct zwp_relative_pointer_v1 *relative_pointer;

  // Keyboard handling (XKB)
  struct xkb_context *xkb_context;
  struct xkb_keymap *xkb_keymap;
  struct xkb_state *xkb_state;
  struct xkb_compose_table *xkb_compose_table;
  struct xkb_compose_state *xkb_compose_state;

  // Cursor support
  struct wp_cursor_shape_manager_v1 *cursor_shape_manager;
  struct wp_cursor_shape_device_v1 *cursor_shape_device;

  // Fractional scale
  struct wp_fractional_scale_manager_v1 *fractional_scale_manager;
  struct wp_fractional_scale_v1 *fractional_scale;
  uint32_t scale_numerator; // e.g., 120 for 1.2x scale

  // Viewporter (for fractional scaling)
  struct wp_viewporter *viewporter;
  struct wp_viewport *viewport;

  // Decorations
  struct zxdg_decoration_manager_v1 *decoration_manager;
  struct zxdg_toplevel_decoration_v1 *toplevel_decoration;

  // Cursor
  struct wl_cursor_theme *cursor_theme;
  struct wl_cursor *cursor_default;
  struct wl_surface *cursor_surface;
  int cursor_size;

  // Clipboard
  struct wl_data_device_manager *data_device_manager;
  struct wl_data_device *data_device;
  struct wl_data_source *data_source;
  struct wl_data_offer *data_offer;
  char *clipboard_string;
  size_t clipboard_size;

  // Window state
  int width;
  int height;
  int fb_width;
  int fb_height;
  float scale;
  bool configured;
  bool closed;
  bool fullscreen;
  bool maximized;
  bool focused;

  // Pointer state
  wl_fixed_t pointer_x;
  wl_fixed_t pointer_y;
  uint32_t pointer_enter_serial;

  // Keyboard state
  uint32_t key_repeat_rate;
  uint32_t key_repeat_delay;
  int key_repeat_timer_fd;
  xkb_keycode_t key_repeat_keycode;
} _sapp_wl_t;
#endif // _SAPP_WAYLAND

#if defined(_SAPP_X11) && defined(_SAPP_GLX)

typedef struct {
  void *libgl;
  int major;
  int minor;
  int event_base;
  int error_base;
  GLXContext ctx;
  GLXWindow window;

  // GLX 1.3 functions
  PFNGLXGETFBCONFIGSPROC GetFBConfigs;
  PFNGLXGETFBCONFIGATTRIBPROC GetFBConfigAttrib;
  PFNGLXGETCLIENTSTRINGPROC GetClientString;
  PFNGLXQUERYEXTENSIONPROC QueryExtension;
  PFNGLXQUERYVERSIONPROC QueryVersion;
  PFNGLXDESTROYCONTEXTPROC DestroyContext;
  PFNGLXMAKECURRENTPROC MakeCurrent;
  PFNGLXSWAPBUFFERSPROC SwapBuffers;
  PFNGLXQUERYEXTENSIONSSTRINGPROC QueryExtensionsString;
  PFNGLXGETVISUALFROMFBCONFIGPROC GetVisualFromFBConfig;
  PFNGLXCREATEWINDOWPROC CreateWindow;
  PFNGLXDESTROYWINDOWPROC DestroyWindow;

  // GLX 1.4 and extension functions
  PFNGLXGETPROCADDRESSPROC GetProcAddress;
  PFNGLXGETPROCADDRESSPROC GetProcAddressARB;
  PFNGLXSWAPINTERVALEXTPROC SwapIntervalEXT;
  PFNGLXSWAPINTERVALMESAPROC SwapIntervalMESA;
  PFNGLXCREATECONTEXTATTRIBSARBPROC CreateContextAttribsARB;

  // special case glGetIntegerv
  void (*GetIntegerv)(uint32_t pname, int32_t *data);

  // extension availability
  bool EXT_swap_control;
  bool MESA_swap_control;
  bool ARB_multisample;
  bool ARB_create_context;
  bool ARB_create_context_profile;
} _sapp_glx_t;
#endif // _SAPP_GLX

#if defined(_SAPP_EGL)
typedef struct {
  EGLDisplay display;
  EGLContext context;
  EGLSurface surface;
} _sapp_egl_t;
#endif // _SAPP_EGL
#endif // _SAPP_LINUX (for struct definitions)

#if defined(_SAPP_ANY_GL)
typedef struct {
  uint32_t framebuffer;
} _sapp_gl_t;
#endif

typedef struct {
  bool enabled;
  int buf_size;
  char *buffer;
} _sapp_clipboard_t;

typedef struct {
  bool enabled;
  int max_files;
  int max_path_length;
  int num_files;
  int buf_size;
  char *buffer;
} _sapp_drop_t;

typedef struct {
  float x, y;
  float dx, dy;
  bool shown;
  bool locked;
  bool pos_valid;
  sapp_mouse_cursor current_cursor;
} _sapp_mouse_t;

typedef struct {
  sapp_desc desc;
  bool valid;
  bool fullscreen;
  bool first_frame;
  bool init_called;
  bool cleanup_called;
  bool quit_requested;
  bool quit_ordered;
  bool event_consumed;
  bool html5_ask_leave_site;
  bool onscreen_keyboard_shown;
  int window_width;
  int window_height;
  int framebuffer_width;
  int framebuffer_height;
  int sample_count;
  int swap_interval;
  float dpi_scale;
  uint64_t frame_count;
  _sapp_timing_t timing;
  sapp_event event;
  _sapp_mouse_t mouse;
  _sapp_clipboard_t clipboard;
  _sapp_drop_t drop;
  sapp_icon_desc default_icon_desc;
  uint32_t *default_icon_pixels;
#if defined(SOKOL_WGPU)
  _sapp_wgpu_t wgpu;
#endif
#if defined(SOKOL_VULKAN)
  _sapp_vk_t vk;
#endif
#if defined(_SAPP_MACOS)
  _sapp_macos_t macos;
#elif defined(_SAPP_IOS)
  _sapp_ios_t ios;
#elif defined(_SAPP_EMSCRIPTEN)
  _sapp_emsc_t emsc;
#elif defined(_SAPP_WIN32)
  _sapp_win32_t win32;
#if defined(SOKOL_D3D11)
  _sapp_d3d11_t d3d11;
#elif defined(SOKOL_GLCORE)
  _sapp_wgl_t wgl;
#endif
#elif defined(_SAPP_ANDROID)
  _sapp_android_t android;
#elif defined(_SAPP_LINUX)
#if defined(_SAPP_X11)
  _sapp_x11_t x11;
#if defined(_SAPP_GLX)
  _sapp_glx_t glx;
#elif defined(_SAPP_EGL)
  _sapp_egl_t egl;
#endif
#elif defined(_SAPP_WAYLAND)
  _sapp_wl_t wl;
  _sapp_egl_t egl;
#endif
#endif
#if defined(_SAPP_ANY_GL)
  _sapp_gl_t gl;
#endif
  char html5_canvas_selector[_SAPP_MAX_TITLE_LENGTH];
  char window_title[_SAPP_MAX_TITLE_LENGTH];         // UTF-8
  wchar_t window_title_wide[_SAPP_MAX_TITLE_LENGTH]; // UTF-32 or UCS-2 */
  sapp_keycode keycodes[SAPP_MAX_KEYCODES];
  // __v_ start
  bool __v_native_render; /* V patch to allow for native rendering */
  // __v_ end
  bool custom_cursor_bound[_SAPP_MOUSECURSOR_NUM]; // true if a custom mouse
                                                   // cursor is bound on that
                                                   // slot
} _sapp_t;
static _sapp_t _sapp;

// ██       ██████   ██████   ██████  ██ ███    ██  ██████
// ██      ██    ██ ██       ██       ██ ████   ██ ██
// ██      ██    ██ ██   ███ ██   ███ ██ ██ ██  ██ ██   ███
// ██      ██    ██ ██    ██ ██    ██ ██ ██  ██ ██ ██    ██
// ███████  ██████   ██████   ██████  ██ ██   ████  ██████
//
// >>logging
#if defined(SOKOL_DEBUG)
#define _SAPP_LOGITEM_XMACRO(item, msg) #item ": " msg,
static const char *_sapp_log_messages[] = {_SAPP_LOG_ITEMS};
#undef _SAPP_LOGITEM_XMACRO
#endif // SOKOL_DEBUG

#define _SAPP_PANIC(code) _sapp_log(SAPP_LOGITEM_##code, 0, 0, __LINE__)
#define _SAPP_ERROR(code) _sapp_log(SAPP_LOGITEM_##code, 1, 0, __LINE__)
#define _SAPP_WARN(code) _sapp_log(SAPP_LOGITEM_##code, 2, 0, __LINE__)
#define _SAPP_INFO(code) _sapp_log(SAPP_LOGITEM_##code, 3, 0, __LINE__)
#define _SAPP_PANIC_MSG(code, msg)                                             \
  _sapp_log(SAPP_LOGITEM_##code, 0, msg, __LINE__)
#define _SAPP_ERROR_MSG(code, msg)                                             \
  _sapp_log(SAPP_LOGITEM_##code, 1, msg, __LINE__)
#define _SAPP_WARN_MSG(code, msg)                                              \
  _sapp_log(SAPP_LOGITEM_##code, 2, msg, __LINE__)
#define _SAPP_INFO_MSG(code, msg)                                              \
  _sapp_log(SAPP_LOGITEM_##code, 3, msg, __LINE__)

static void _sapp_log(sapp_log_item log_item, uint32_t log_level,
                      const char *msg, uint32_t line_nr) {
  if (_sapp.desc.logger.func) {
    const char *filename = 0;
#if defined(SOKOL_DEBUG)
    filename = __FILE__;
    if (0 == msg) {
      msg = _sapp_log_messages[log_item];
    }
#endif
    _sapp.desc.logger.func("sapp", log_level, (uint32_t)log_item, msg, line_nr,
                           filename, _sapp.desc.logger.user_data);
  } else {
    // for log level PANIC it would be 'undefined behaviour' to continue
    if (log_level == 0) {
      abort();
    }
  }
}

// ███    ███ ███████ ███    ███  ██████  ██████  ██    ██
// ████  ████ ██      ████  ████ ██    ██ ██   ██  ██  ██
// ██ ████ ██ █████   ██ ████ ██ ██    ██ ██████    ████
// ██  ██  ██ ██      ██  ██  ██ ██    ██ ██   ██    ██
// ██      ██ ███████ ██      ██  ██████  ██   ██    ██
//
// >>memory
_SOKOL_PRIVATE void _sapp_clear(void *ptr, size_t size) {
  SOKOL_ASSERT(ptr && (size > 0));
  memset(ptr, 0, size);
}

_SOKOL_PRIVATE void *_sapp_malloc(size_t size) {
  SOKOL_ASSERT(size > 0);
  void *ptr;
  if (_sapp.desc.allocator.alloc_fn) {
    ptr = _sapp.desc.allocator.alloc_fn(size, _sapp.desc.allocator.user_data);
  } else {
    ptr = malloc(size);
  }
  if (0 == ptr) {
    _SAPP_PANIC(MALLOC_FAILED);
  }
  return ptr;
}

_SOKOL_PRIVATE void *_sapp_malloc_clear(size_t size) {
  void *ptr = _sapp_malloc(size);
  _sapp_clear(ptr, size);
  return ptr;
}

_SOKOL_PRIVATE void _sapp_free(void *ptr) {
  if (_sapp.desc.allocator.free_fn) {
    _sapp.desc.allocator.free_fn(ptr, _sapp.desc.allocator.user_data);
  } else {
    free(ptr);
  }
}

// ██   ██ ███████ ██      ██████  ███████ ██████  ███████
// ██   ██ ██      ██      ██   ██ ██      ██   ██ ██
// ███████ █████   ██      ██████  █████   ██████  ███████
// ██   ██ ██      ██      ██      ██      ██   ██      ██
// ██   ██ ███████ ███████ ██      ███████ ██   ██ ███████
//
// >>helpers

// round float to int and at least 1
_SOKOL_PRIVATE int _sapp_roundf_gzero(float f) {
  int val = (int)roundf(f);
  if (val <= 0) {
    val = 1;
  }
  return val;
}

_SOKOL_PRIVATE void _sapp_call_init(void) {
  if (_sapp.desc.init_cb) {
    _sapp.desc.init_cb();
  } else if (_sapp.desc.init_userdata_cb) {
    _sapp.desc.init_userdata_cb(_sapp.desc.user_data);
  }
  _sapp.init_called = true;
}

_SOKOL_PRIVATE void _sapp_call_frame(void) {
  // __v_ start
  if (_sapp.__v_native_render) {
    return;
  }
  if (_sapp.init_called && !_sapp.cleanup_called) {
    if (_sapp.desc.frame_cb) {
      _sapp.desc.frame_cb();
    } else if (_sapp.desc.frame_userdata_cb) {
      _sapp.desc.frame_userdata_cb(_sapp.desc.user_data);
    }
  }
}

// __v_ start
_SOKOL_PRIVATE void _sapp_call_frame_native(void) {
  // puts("_sapp_call_frame_native()");
  // printf("init called=%d cleanup_called=%d\n",
  // _sapp.init_called,_sapp.cleanup_called);
  if (_sapp.init_called && !_sapp.cleanup_called) {
    if (_sapp.desc.frame_cb) {
      _sapp.desc.frame_cb();
    } else if (_sapp.desc.frame_userdata_cb) {
      _sapp.desc.frame_userdata_cb(_sapp.desc.user_data);
    }
  }
}
// __v_ end

_SOKOL_PRIVATE void _sapp_call_cleanup(void) {
  if (!_sapp.cleanup_called) {
    if (_sapp.desc.cleanup_cb) {
      _sapp.desc.cleanup_cb();
    } else if (_sapp.desc.cleanup_userdata_cb) {
      _sapp.desc.cleanup_userdata_cb(_sapp.desc.user_data);
    }
    _sapp.cleanup_called = true;
  }
}

_SOKOL_PRIVATE bool _sapp_call_event(const sapp_event *e) {
  if (!_sapp.cleanup_called) {
    if (_sapp.desc.event_cb) {
      _sapp.desc.event_cb(e);
    } else if (_sapp.desc.event_userdata_cb) {
      _sapp.desc.event_userdata_cb(e, _sapp.desc.user_data);
    }
  }
  if (_sapp.event_consumed) {
    _sapp.event_consumed = false;
    return true;
  } else {
    return false;
  }
}

_SOKOL_PRIVATE char *_sapp_dropped_file_path_ptr(int index) {
  SOKOL_ASSERT(_sapp.drop.buffer);
  SOKOL_ASSERT((index >= 0) && (index <= _sapp.drop.max_files));
  int offset = index * _sapp.drop.max_path_length;
  SOKOL_ASSERT(offset < _sapp.drop.buf_size);
  return &_sapp.drop.buffer[offset];
}

/* Copy a string (either zero-terminated or with explicit length)
   into a fixed size buffer with guaranteed zero-termination.

   Return false if the string didn't fit into the buffer and had to be clamped.

   FIXME: Currently UTF-8 strings might become invalid if the string
   is clamped, because the last zero-byte might be written into
   the middle of a multi-byte sequence.
*/
_SOKOL_PRIVATE bool _sapp_strcpy_range(const char *src, size_t src_len,
                                       char *dst, size_t dst_buf_len) {
  SOKOL_ASSERT(src && dst && (dst_buf_len > 0));
  if (0 == src_len) {
    src_len = dst_buf_len;
  }
  char *const end = &(dst[dst_buf_len - 1]);
  char c = 0;
  for (size_t i = 0; i < dst_buf_len; i++) {
    c = *src;
    if (i >= src_len) {
      c = 0;
    }
    if (c != 0) {
      src++;
    }
    *dst++ = c;
  }
  // truncated?
  if (c != 0) {
    *end = 0;
    return false;
  } else {
    return true;
  }
}

_SOKOL_PRIVATE bool _sapp_strcpy(const char *src, char *dst,
                                 size_t dst_buf_len) {
  return _sapp_strcpy_range(src, 0, dst, dst_buf_len);
}

_SOKOL_PRIVATE sapp_desc _sapp_desc_defaults(const sapp_desc *desc) {
  SOKOL_ASSERT((desc->allocator.alloc_fn && desc->allocator.free_fn) ||
               (!desc->allocator.alloc_fn && !desc->allocator.free_fn));
  sapp_desc res = *desc;
  res.sample_count = _sapp_def(res.sample_count, 1);
  res.swap_interval = _sapp_def(res.swap_interval, 1);
  if (0 == res.gl.major_version) {
#if defined(SOKOL_GLCORE)
    res.gl.major_version = 4;
#if defined(_SAPP_APPLE)
    res.gl.minor_version = 1;
#else
    res.gl.minor_version = 1;
#endif
#elif defined(SOKOL_GLES3)
    res.gl.major_version = 3;
#if defined(_SAPP_ANDROID) || defined(_SAPP_LINUX)
    res.gl.minor_version = 1;
#else
    res.gl.minor_version = 0;
#endif
#endif
  }
  res.html5.canvas_selector = _sapp_def(res.html5.canvas_selector, "#canvas");
  res.clipboard_size = _sapp_def(res.clipboard_size, 8192);
  res.max_dropped_files = _sapp_def(res.max_dropped_files, 1);
  res.max_dropped_file_path_length =
      _sapp_def(res.max_dropped_file_path_length, 2048);
  res.window_title = _sapp_def(res.window_title, "sokol");
  return res;
}

_SOKOL_PRIVATE void _sapp_init_state(const sapp_desc *desc) {
  SOKOL_ASSERT(desc);
  SOKOL_ASSERT(desc->width >= 0);
  SOKOL_ASSERT(desc->height >= 0);
  SOKOL_ASSERT(desc->sample_count >= 0);
  SOKOL_ASSERT(desc->swap_interval >= 0);
  SOKOL_ASSERT(desc->clipboard_size >= 0);
  SOKOL_ASSERT(desc->max_dropped_files >= 0);
  SOKOL_ASSERT(desc->max_dropped_file_path_length >= 0);
  _SAPP_CLEAR_ARC_STRUCT(_sapp_t, _sapp);
  _sapp.desc = _sapp_desc_defaults(desc);
  _sapp.first_frame = true;
  // NOTE: _sapp.desc.width/height may be 0! Platform backends need to deal with
  // this
  _sapp.window_width = _sapp.desc.width;
  _sapp.window_height = _sapp.desc.height;
  _sapp.framebuffer_width = _sapp.window_width;
  _sapp.framebuffer_height = _sapp.window_height;
  _sapp.sample_count = _sapp.desc.sample_count;
  _sapp.swap_interval = _sapp.desc.swap_interval;
  _sapp_strcpy(_sapp.desc.html5.canvas_selector, _sapp.html5_canvas_selector,
               sizeof(_sapp.html5_canvas_selector));
  _sapp.desc.html5.canvas_selector = _sapp.html5_canvas_selector;
  _sapp.html5_ask_leave_site = _sapp.desc.html5.ask_leave_site;
  _sapp.clipboard.enabled = _sapp.desc.enable_clipboard;
  if (_sapp.clipboard.enabled) {
    _sapp.clipboard.buf_size = _sapp.desc.clipboard_size;
    _sapp.clipboard.buffer =
        (char *)_sapp_malloc_clear((size_t)_sapp.clipboard.buf_size);
  }
  _sapp.drop.enabled = _sapp.desc.enable_dragndrop;
  if (_sapp.drop.enabled) {
    _sapp.drop.max_files = _sapp.desc.max_dropped_files;
    _sapp.drop.max_path_length = _sapp.desc.max_dropped_file_path_length;
    _sapp.drop.buf_size = _sapp.drop.max_files * _sapp.drop.max_path_length;
    _sapp.drop.buffer = (char *)_sapp_malloc_clear((size_t)_sapp.drop.buf_size);
  }
  _sapp_strcpy(_sapp.desc.window_title, _sapp.window_title,
               sizeof(_sapp.window_title));
  _sapp.desc.window_title = _sapp.window_title;
  _sapp.dpi_scale = 1.0f;
  _sapp.fullscreen = _sapp.desc.fullscreen;
  _sapp.mouse.shown = true;
  _sapp_timing_init(&_sapp.timing);
  // __v_ start
  _sapp.__v_native_render = _sapp.desc.__v_native_render;
  // __v_end
}

_SOKOL_PRIVATE void _sapp_discard_state(void) {
  if (_sapp.clipboard.enabled) {
    SOKOL_ASSERT(_sapp.clipboard.buffer);
    _sapp_free((void *)_sapp.clipboard.buffer);
  }
  if (_sapp.drop.enabled) {
    SOKOL_ASSERT(_sapp.drop.buffer);
    _sapp_free((void *)_sapp.drop.buffer);
  }
  if (_sapp.default_icon_pixels) {
    _sapp_free((void *)_sapp.default_icon_pixels);
  }
  for (int i = 0; i < _SAPP_MOUSECURSOR_NUM; i++) {
    sapp_unbind_mouse_cursor_image((sapp_mouse_cursor)i);
  }
  _SAPP_CLEAR_ARC_STRUCT(_sapp_t, _sapp);
}

_SOKOL_PRIVATE void _sapp_init_event(sapp_event_type type) {
  _sapp_clear(&_sapp.event, sizeof(_sapp.event));
  _sapp.event.type = type;
  _sapp.event.frame_count = _sapp.frame_count;
  _sapp.event.mouse_button = SAPP_MOUSEBUTTON_INVALID;
  _sapp.event.window_width = _sapp.window_width;
  _sapp.event.window_height = _sapp.window_height;
  _sapp.event.framebuffer_width = _sapp.framebuffer_width;
  _sapp.event.framebuffer_height = _sapp.framebuffer_height;
  _sapp.event.mouse_x = _sapp.mouse.x;
  _sapp.event.mouse_y = _sapp.mouse.y;
  _sapp.event.mouse_dx = _sapp.mouse.dx;
  _sapp.event.mouse_dy = _sapp.mouse.dy;
}

_SOKOL_PRIVATE bool _sapp_events_enabled(void) {
  /* only send events when an event callback is set, and the init function was
   * called */
  return (_sapp.desc.event_cb || _sapp.desc.event_userdata_cb) &&
         _sapp.init_called;
}

_SOKOL_PRIVATE sapp_keycode _sapp_translate_key(int scan_code) {
  if ((scan_code >= 0) && (scan_code < SAPP_MAX_KEYCODES)) {
    return _sapp.keycodes[scan_code];
  } else {
    return SAPP_KEYCODE_INVALID;
  }
}

_SOKOL_PRIVATE void _sapp_clear_drop_buffer(void) {
  if (_sapp.drop.enabled) {
    SOKOL_ASSERT(_sapp.drop.buffer);
    _sapp_clear(_sapp.drop.buffer, (size_t)_sapp.drop.buf_size);
  }
}

_SOKOL_PRIVATE void _sapp_frame(void) {
  if (_sapp.first_frame) {
    _sapp.first_frame = false;
    _sapp_call_init();
  }
  _sapp_call_frame();
  _sapp.frame_count++;
}

_SOKOL_PRIVATE bool _sapp_image_validate(const sapp_image_desc *desc) {
  SOKOL_ASSERT(desc->width > 0);
  SOKOL_ASSERT(desc->height > 0);
  SOKOL_ASSERT(desc->pixels.ptr != 0);
  SOKOL_ASSERT(desc->pixels.size > 0);
  const size_t wh_size =
      (size_t)(desc->width * desc->height) * sizeof(uint32_t);
  if (wh_size != desc->pixels.size) {
    _SAPP_ERROR(IMAGE_DATA_SIZE_MISMATCH);
    return false;
  }
  return true;
}

_SOKOL_PRIVATE int _sapp_image_bestmatch(const sapp_image_desc image_descs[],
                                         int num_images, int width,
                                         int height) {
  int least_diff = 0x7FFFFFFF;
  int least_index = 0;
  for (int i = 0; i < num_images; i++) {
    int diff =
        (image_descs[i].width * image_descs[i].height) - (width * height);
    if (diff < 0) {
      diff = -diff;
    }
    if (diff < least_diff) {
      least_diff = diff;
      least_index = i;
    }
  }
  return least_index;
}

_SOKOL_PRIVATE int _sapp_icon_num_images(const sapp_icon_desc *desc) {
  int index = 0;
  for (; index < SAPP_MAX_ICONIMAGES; index++) {
    if (0 == desc->images[index].pixels.ptr) {
      break;
    }
  }
  return index;
}

_SOKOL_PRIVATE bool _sapp_validate_icon_desc(const sapp_icon_desc *desc,
                                             int num_images) {
  SOKOL_ASSERT(num_images <= SAPP_MAX_ICONIMAGES);
  for (int i = 0; i < num_images; i++) {
    const sapp_image_desc *img_desc = &desc->images[i];
    if (!_sapp_image_validate(img_desc)) {
      return false;
    }
  }
  return true;
}

_SOKOL_PRIVATE void _sapp_setup_default_icon(void) {
  SOKOL_ASSERT(0 == _sapp.default_icon_pixels);

  const int num_icons = 3;
  const int icon_sizes[3] = {16, 32, 64}; // must be multiple of 8!

  // allocate a pixel buffer for all icon pixels
  int all_num_pixels = 0;
  for (int i = 0; i < num_icons; i++) {
    all_num_pixels += icon_sizes[i] * icon_sizes[i];
  }
  _sapp.default_icon_pixels =
      (uint32_t *)_sapp_malloc_clear((size_t)all_num_pixels * sizeof(uint32_t));

  // initialize default_icon_desc struct
  uint32_t *dst = _sapp.default_icon_pixels;
  const uint32_t *dst_end = dst + all_num_pixels;
  (void)dst_end; // silence unused warning in release mode
  for (int i = 0; i < num_icons; i++) {
    const int dim = (int)icon_sizes[i];
    const int num_pixels = dim * dim;
    sapp_image_desc *img_desc = &_sapp.default_icon_desc.images[i];
    img_desc->width = dim;
    img_desc->height = dim;
    img_desc->pixels.ptr = dst;
    img_desc->pixels.size = (size_t)num_pixels * sizeof(uint32_t);
    dst += num_pixels;
  }
  SOKOL_ASSERT(dst == dst_end);

  // Amstrad CPC font 'S'
  const uint8_t tile[8] = {
      0x3C, 0x66, 0x60, 0x3C, 0x06, 0x66, 0x3C, 0x00,
  };
  // rainbow colors
  const uint32_t colors[8] = {
      0xFF4370FF, 0xFF26A7FF, 0xFF58EEFF, 0xFF57E1D4,
      0xFF65CC9C, 0xFF6ABB66, 0xFFF5A542, 0xFFC2577E,
  };
  dst = _sapp.default_icon_pixels;
  const uint32_t blank = 0x00FFFFFF;
  const uint32_t shadow = 0xFF000000;
  for (int i = 0; i < num_icons; i++) {
    const int dim = icon_sizes[i];
    SOKOL_ASSERT((dim % 8) == 0);
    const int scale = dim / 8;
    for (int ty = 0, y = 0; ty < 8; ty++) {
      const uint32_t color = colors[ty];
      for (int sy = 0; sy < scale; sy++, y++) {
        uint8_t bits = tile[ty];
        for (int tx = 0, x = 0; tx < 8; tx++, bits <<= 1) {
          uint32_t pixel = (0 == (bits & 0x80)) ? blank : color;
          for (int sx = 0; sx < scale; sx++, x++) {
            SOKOL_ASSERT(dst < dst_end);
            *dst++ = pixel;
          }
        }
      }
    }
  }
  SOKOL_ASSERT(dst == dst_end);

  // right shadow
  dst = _sapp.default_icon_pixels;
  for (int i = 0; i < num_icons; i++) {
    const int dim = icon_sizes[i];
    for (int y = 0; y < dim; y++) {
      uint32_t prev_color = blank;
      for (int x = 0; x < dim; x++) {
        const int dst_index = y * dim + x;
        const uint32_t cur_color = dst[dst_index];
        if ((cur_color == blank) && (prev_color != blank)) {
          dst[dst_index] = shadow;
        }
        prev_color = cur_color;
      }
    }
    dst += dim * dim;
  }
  SOKOL_ASSERT(dst == dst_end);

  // bottom shadow
  dst = _sapp.default_icon_pixels;
  for (int i = 0; i < num_icons; i++) {
    const int dim = icon_sizes[i];
    for (int x = 0; x < dim; x++) {
      uint32_t prev_color = blank;
      for (int y = 0; y < dim; y++) {
        const int dst_index = y * dim + x;
        const uint32_t cur_color = dst[dst_index];
        if ((cur_color == blank) && (prev_color != blank)) {
          dst[dst_index] = shadow;
        }
        prev_color = cur_color;
      }
    }
    dst += dim * dim;
  }
  SOKOL_ASSERT(dst == dst_end);
}

// ██     ██  ██████  ██████  ██    ██
// ██     ██ ██       ██   ██ ██    ██
// ██  █  ██ ██   ███ ██████  ██    ██
// ██ ███ ██ ██    ██ ██      ██    ██
//  ███ ███   ██████  ██       ██████
//
// >>wgpu
#if defined(SOKOL_WGPU)

_SOKOL_PRIVATE WGPUStringView _sapp_wgpu_stringview(const char *str) {
  WGPUStringView res;
  if (str) {
    res.data = str;
    res.length = strlen(str);
  } else {
    res.data = 0;
    res.length = 0;
  }
  return res;
}

_SOKOL_PRIVATE WGPUCallbackMode _sapp_wgpu_callbackmode(void) {
#if defined(_SAPP_WGPU_HAS_WAIT)
  return WGPUCallbackMode_WaitAnyOnly;
#else
  return WGPUCallbackMode_AllowProcessEvents;
#endif
}

_SOKOL_PRIVATE void _sapp_wgpu_await(WGPUFuture future) {
#if defined(_SAPP_WGPU_HAS_WAIT)
  SOKOL_ASSERT(_sapp.wgpu.instance);
  _SAPP_STRUCT(WGPUFutureWaitInfo, wait_info);
  wait_info.future = future;
  WGPUWaitStatus res =
      wgpuInstanceWaitAny(_sapp.wgpu.instance, 1, &wait_info, UINT64_MAX);
  SOKOL_ASSERT(res == WGPUWaitStatus_Success);
  _SOKOL_UNUSED(res);
#else
  // this code path should never be called
  _SOKOL_UNUSED(future);
  SOKOL_ASSERT(false);
#endif
}

_SOKOL_PRIVATE WGPUTextureFormat
_sapp_wgpu_pick_render_format(size_t count, const WGPUTextureFormat *formats) {
  // NOTE: only accept non-SRGB formats until sokol_app.h gets proper SRGB
  // support
  SOKOL_ASSERT((count > 0) && formats);
  for (size_t i = 0; i < count; i++) {
    const WGPUTextureFormat fmt = formats[i];
    switch (fmt) {
    case WGPUTextureFormat_RGBA8Unorm:
    case WGPUTextureFormat_BGRA8Unorm:
      return fmt;
    default:
      break;
    }
  }
  // FIXME: fallback might still return an SRGB format
  return formats[0];
}

_SOKOL_PRIVATE void _sapp_wgpu_create_swapchain(bool called_from_resize) {
  SOKOL_ASSERT(_sapp.wgpu.instance);
  SOKOL_ASSERT(_sapp.wgpu.device);
  SOKOL_ASSERT(0 == _sapp.wgpu.msaa_tex);
  SOKOL_ASSERT(0 == _sapp.wgpu.msaa_view);
  SOKOL_ASSERT(0 == _sapp.wgpu.depth_stencil_tex);
  SOKOL_ASSERT(0 == _sapp.wgpu.depth_stencil_view);

  if (!called_from_resize) {
    SOKOL_ASSERT(0 == _sapp.wgpu.surface);
    _SAPP_STRUCT(WGPUSurfaceDescriptor, surf_desc);
#if defined(_SAPP_EMSCRIPTEN)
    _SAPP_STRUCT(WGPUEmscriptenSurfaceSourceCanvasHTMLSelector,
                 html_canvas_desc);
    html_canvas_desc.chain.sType =
        WGPUSType_EmscriptenSurfaceSourceCanvasHTMLSelector;
    html_canvas_desc.selector =
        _sapp_wgpu_stringview(_sapp.html5_canvas_selector);
    surf_desc.nextInChain = &html_canvas_desc.chain;
#elif defined(_SAPP_MACOS)
    _SAPP_STRUCT(WGPUSurfaceSourceMetalLayer, from_metal_layer);
    from_metal_layer.chain.sType = WGPUSType_SurfaceSourceMetalLayer;
    from_metal_layer.layer = _sapp.macos.view.layer;
    surf_desc.nextInChain = &from_metal_layer.chain;
#elif defined(_SAPP_WIN32)
    _SAPP_STRUCT(WGPUSurfaceSourceWindowsHWND, from_hwnd);
    from_hwnd.chain.sType = WGPUSType_SurfaceSourceWindowsHWND;
    from_hwnd.hinstance = GetModuleHandleW(NULL);
    from_hwnd.hwnd = _sapp.win32.hwnd;
    surf_desc.nextInChain = &from_hwnd.chain;
#elif defined(_SAPP_LINUX)
#if defined(_SAPP_X11)
    _SAPP_STRUCT(WGPUSurfaceSourceXlibWindow, from_xlib);
    from_xlib.chain.sType = WGPUSType_SurfaceSourceXlibWindow;
    from_xlib.display = _sapp.x11.display;
    from_xlib.window = _sapp.x11.window;
    surf_desc.nextInChain = &from_xlib.chain;
#elif defined(_SAPP_WAYLAND)
    _SAPP_STRUCT(WGPUSurfaceSourceWaylandSurface, from_wayland);
    from_wayland.chain.sType = WGPUSType_SurfaceSourceWaylandSurface;
    from_wayland.display = _sapp.wl.display;
    from_wayland.surface = _sapp.wl.surface;
    surf_desc.nextInChain = &from_wayland.chain;
#endif
#else
#error "sokol_app.h: unsupported WebGPU platform"
#endif
    _sapp.wgpu.surface =
        wgpuInstanceCreateSurface(_sapp.wgpu.instance, &surf_desc);
    if (0 == _sapp.wgpu.surface) {
      _SAPP_PANIC(WGPU_SWAPCHAIN_CREATE_SURFACE_FAILED);
    }
    _SAPP_STRUCT(WGPUSurfaceCapabilities, surf_caps);
    WGPUStatus caps_status = wgpuSurfaceGetCapabilities(
        _sapp.wgpu.surface, _sapp.wgpu.adapter, &surf_caps);
    if (caps_status != WGPUStatus_Success) {
      _SAPP_PANIC(WGPU_SWAPCHAIN_SURFACE_GET_CAPABILITIES_FAILED);
    }
    _sapp.wgpu.render_format =
        _sapp_wgpu_pick_render_format(surf_caps.formatCount, surf_caps.formats);
  }

  SOKOL_ASSERT(_sapp.wgpu.surface);
  _SAPP_STRUCT(WGPUSurfaceConfiguration, surf_conf);
  surf_conf.device = _sapp.wgpu.device;
  surf_conf.format = _sapp.wgpu.render_format;
  surf_conf.usage = WGPUTextureUsage_RenderAttachment;
  surf_conf.width = (uint32_t)_sapp.framebuffer_width;
  surf_conf.height = (uint32_t)_sapp.framebuffer_height;
  surf_conf.alphaMode = WGPUCompositeAlphaMode_Opaque;
#if defined(_SAPP_EMSCRIPTEN)
  // FIXME: make this further configurable?
  if (_sapp.desc.html5.premultiplied_alpha) {
    surf_conf.alphaMode = WGPUCompositeAlphaMode_Premultiplied;
  }
#endif
  surf_conf.presentMode = WGPUPresentMode_Fifo;
  wgpuSurfaceConfigure(_sapp.wgpu.surface, &surf_conf);

  _SAPP_STRUCT(WGPUTextureDescriptor, ds_desc);
  ds_desc.usage = WGPUTextureUsage_RenderAttachment;
  ds_desc.dimension = WGPUTextureDimension_2D;
  ds_desc.size.width = (uint32_t)_sapp.framebuffer_width;
  ds_desc.size.height = (uint32_t)_sapp.framebuffer_height;
  ds_desc.size.depthOrArrayLayers = 1;
  ds_desc.format = WGPUTextureFormat_Depth32FloatStencil8;
  ds_desc.mipLevelCount = 1;
  ds_desc.sampleCount = (uint32_t)_sapp.sample_count;
  _sapp.wgpu.depth_stencil_tex =
      wgpuDeviceCreateTexture(_sapp.wgpu.device, &ds_desc);
  if (0 == _sapp.wgpu.depth_stencil_tex) {
    _SAPP_PANIC(WGPU_SWAPCHAIN_CREATE_DEPTH_STENCIL_TEXTURE_FAILED);
  }
  _sapp.wgpu.depth_stencil_view =
      wgpuTextureCreateView(_sapp.wgpu.depth_stencil_tex, 0);
  if (0 == _sapp.wgpu.depth_stencil_view) {
    _SAPP_PANIC(WGPU_SWAPCHAIN_CREATE_DEPTH_STENCIL_VIEW_FAILED);
  }

  if (_sapp.sample_count > 1) {
    _SAPP_STRUCT(WGPUTextureDescriptor, msaa_desc);
    msaa_desc.usage = WGPUTextureUsage_RenderAttachment;
    msaa_desc.dimension = WGPUTextureDimension_2D;
    msaa_desc.size.width = (uint32_t)_sapp.framebuffer_width;
    msaa_desc.size.height = (uint32_t)_sapp.framebuffer_height;
    msaa_desc.size.depthOrArrayLayers = 1;
    msaa_desc.format = _sapp.wgpu.render_format;
    msaa_desc.mipLevelCount = 1;
    msaa_desc.sampleCount = (uint32_t)_sapp.sample_count;
    _sapp.wgpu.msaa_tex =
        wgpuDeviceCreateTexture(_sapp.wgpu.device, &msaa_desc);
    if (0 == _sapp.wgpu.msaa_tex) {
      _SAPP_PANIC(WGPU_SWAPCHAIN_CREATE_MSAA_TEXTURE_FAILED);
    }
    _sapp.wgpu.msaa_view = wgpuTextureCreateView(_sapp.wgpu.msaa_tex, 0);
    if (0 == _sapp.wgpu.msaa_view) {
      _SAPP_PANIC(WGPU_SWAPCHAIN_CREATE_MSAA_VIEW_FAILED);
    }
  }
}

_SOKOL_PRIVATE void _sapp_wgpu_discard_swapchain(bool called_from_resize) {
  if (_sapp.wgpu.msaa_view) {
    wgpuTextureViewRelease(_sapp.wgpu.msaa_view);
    _sapp.wgpu.msaa_view = 0;
  }
  if (_sapp.wgpu.msaa_tex) {
    wgpuTextureRelease(_sapp.wgpu.msaa_tex);
    _sapp.wgpu.msaa_tex = 0;
  }
  if (_sapp.wgpu.depth_stencil_view) {
    wgpuTextureViewRelease(_sapp.wgpu.depth_stencil_view);
    _sapp.wgpu.depth_stencil_view = 0;
  }
  if (_sapp.wgpu.depth_stencil_tex) {
    wgpuTextureRelease(_sapp.wgpu.depth_stencil_tex);
    _sapp.wgpu.depth_stencil_tex = 0;
  }
  if (!called_from_resize) {
    if (_sapp.wgpu.surface) {
      wgpuSurfaceRelease(_sapp.wgpu.surface);
      _sapp.wgpu.surface = 0;
    }
  }
}

_SOKOL_PRIVATE void _sapp_wgpu_swapchain_next(void) {
  SOKOL_ASSERT(0 == _sapp.wgpu.swapchain_view);
  _SAPP_STRUCT(WGPUSurfaceTexture, surf_tex);
  wgpuSurfaceGetCurrentTexture(_sapp.wgpu.surface, &surf_tex);
  switch (surf_tex.status) {
  case WGPUSurfaceGetCurrentTextureStatus_SuccessOptimal:
  case WGPUSurfaceGetCurrentTextureStatus_SuccessSuboptimal:
    // all ok
    break;
  case WGPUSurfaceGetCurrentTextureStatus_Timeout:
  case WGPUSurfaceGetCurrentTextureStatus_Outdated:
  case WGPUSurfaceGetCurrentTextureStatus_Lost:
    if (surf_tex.texture) {
      wgpuTextureRelease(surf_tex.texture);
    }
    _sapp_wgpu_discard_swapchain(false);
    _sapp_wgpu_create_swapchain(false);
    // FIXME: currently this will assert in the caller
    return;
  case WGPUSurfaceGetCurrentTextureStatus_Error:
  default:
    _SAPP_PANIC(WGPU_SWAPCHAIN_GETCURRENTTEXTURE_FAILED);
    break;
  }
  _sapp.wgpu.swapchain_view = wgpuTextureCreateView(surf_tex.texture, 0);
  SOKOL_ASSERT(_sapp.wgpu.swapchain_view);
}

_SOKOL_PRIVATE void _sapp_wgpu_swapchain_size_changed(void) {
  if (_sapp.wgpu.surface) {
    _sapp_wgpu_discard_swapchain(true);
    _sapp_wgpu_create_swapchain(true);
  }
}

_SOKOL_PRIVATE void _sapp_wgpu_device_lost_cb(const WGPUDevice *dev,
                                              WGPUDeviceLostReason reason,
                                              WGPUStringView msg, void *ud1,
                                              void *ud2) {
  _SOKOL_UNUSED(dev);
  _SOKOL_UNUSED(reason);
  _SOKOL_UNUSED(ud1);
  _SOKOL_UNUSED(ud2);
  // NOTE: on wgpuInstanceRelease(), the device lost callback is always called
  // with WGPUDeviceLostReason_CallbackCancelled (even though no device should
  // exist at that point)
  if (reason != WGPUDeviceLostReason_CallbackCancelled) {
    SOKOL_ASSERT(msg.data && (msg.length > 0));
    char buf[1024];
    _sapp_strcpy_range(msg.data, msg.length, buf, sizeof(buf));
    _SAPP_ERROR_MSG(WGPU_DEVICE_LOST, buf);
  }
}

// NOTE: emdawnwebgpu doesn't seem to have a device logging callback
#if !defined(_SAPP_EMSCRIPTEN)
_SOKOL_PRIVATE void _sapp_wgpu_device_logging_cb(WGPULoggingType log_type,
                                                 WGPUStringView msg, void *ud1,
                                                 void *ud2) {
  _SOKOL_UNUSED(log_type);
  _SOKOL_UNUSED(ud1);
  _SOKOL_UNUSED(ud2);
  SOKOL_ASSERT(msg.data && (msg.length > 0));
  char buf[1024];
  _sapp_strcpy_range(msg.data, msg.length, buf, sizeof(buf));
  switch (log_type) {
  case WGPULoggingType_Warning:
    _SAPP_WARN_MSG(WGPU_DEVICE_LOG, buf);
    break;
  case WGPULoggingType_Error:
    _SAPP_ERROR_MSG(WGPU_DEVICE_LOG, buf);
    break;
  default:
    _SAPP_INFO_MSG(WGPU_DEVICE_LOG, buf);
    break;
  }
}
#endif

_SOKOL_PRIVATE void _sapp_wgpu_uncaptured_error_cb(const WGPUDevice *dev,
                                                   WGPUErrorType err_type,
                                                   WGPUStringView msg,
                                                   void *ud1, void *ud2) {
  _SOKOL_UNUSED(dev);
  _SOKOL_UNUSED(ud1);
  _SOKOL_UNUSED(ud2);
  if (err_type != WGPUErrorType_NoError) {
    SOKOL_ASSERT(msg.data && (msg.length > 0));
    char buf[1024];
    _sapp_strcpy_range(msg.data, msg.length, buf, sizeof(buf));
    _SAPP_ERROR_MSG(WGPU_DEVICE_UNCAPTURED_ERROR, buf);
  }
}

_SOKOL_PRIVATE void _sapp_wgpu_request_device_cb(WGPURequestDeviceStatus status,
                                                 WGPUDevice device,
                                                 WGPUStringView msg,
                                                 void *userdata1,
                                                 void *userdata2) {
  _SOKOL_UNUSED(msg);
  _SOKOL_UNUSED(userdata1);
  _SOKOL_UNUSED(userdata2);
  SOKOL_ASSERT(!_sapp.wgpu.init_done);
  if (status != WGPURequestDeviceStatus_Success) {
    if (status == WGPURequestDeviceStatus_Error) {
      _SAPP_PANIC(WGPU_REQUEST_DEVICE_STATUS_ERROR);
    } else {
      _SAPP_PANIC(WGPU_REQUEST_DEVICE_STATUS_UNKNOWN);
    }
  }
  SOKOL_ASSERT(device);
  _sapp.wgpu.device = device;
#if !defined(_SAPP_EMSCRIPTEN)
  _SAPP_STRUCT(WGPULoggingCallbackInfo, cb_info);
  cb_info.callback = _sapp_wgpu_device_logging_cb;
  wgpuDeviceSetLoggingCallback(_sapp.wgpu.device, cb_info);
#endif
  _sapp_wgpu_create_swapchain(false);
  _sapp.wgpu.init_done = true;
}

_SOKOL_PRIVATE void _sapp_wgpu_create_device_and_swapchain(void) {
  SOKOL_ASSERT(_sapp.wgpu.adapter);
  size_t cur_feature_index = 1;
#define _SAPP_WGPU_MAX_REQUESTED_FEATURES (16)
  WGPUFeatureName requiredFeatures[_SAPP_WGPU_MAX_REQUESTED_FEATURES] = {
      WGPUFeatureName_Depth32FloatStencil8,
  };
  // check for optional features we're interested in
  if (wgpuAdapterHasFeature(_sapp.wgpu.adapter,
                            WGPUFeatureName_TextureCompressionBC)) {
    SOKOL_ASSERT(cur_feature_index < _SAPP_WGPU_MAX_REQUESTED_FEATURES);
    requiredFeatures[cur_feature_index++] =
        WGPUFeatureName_TextureCompressionBC;
  }
  if (wgpuAdapterHasFeature(_sapp.wgpu.adapter,
                            WGPUFeatureName_TextureCompressionETC2)) {
    SOKOL_ASSERT(cur_feature_index < _SAPP_WGPU_MAX_REQUESTED_FEATURES);
    requiredFeatures[cur_feature_index++] =
        WGPUFeatureName_TextureCompressionETC2;
  }
  if (wgpuAdapterHasFeature(_sapp.wgpu.adapter,
                            WGPUFeatureName_TextureCompressionASTC)) {
    SOKOL_ASSERT(cur_feature_index < _SAPP_WGPU_MAX_REQUESTED_FEATURES);
    requiredFeatures[cur_feature_index++] =
        WGPUFeatureName_TextureCompressionASTC;
  }
  if (wgpuAdapterHasFeature(_sapp.wgpu.adapter,
                            WGPUFeatureName_Float32Filterable)) {
    SOKOL_ASSERT(cur_feature_index < _SAPP_WGPU_MAX_REQUESTED_FEATURES);
    requiredFeatures[cur_feature_index++] = WGPUFeatureName_Float32Filterable;
  }
  if (wgpuAdapterHasFeature(_sapp.wgpu.adapter,
                            WGPUFeatureName_DualSourceBlending)) {
    SOKOL_ASSERT(cur_feature_index < _SAPP_WGPU_MAX_REQUESTED_FEATURES);
    requiredFeatures[cur_feature_index++] = WGPUFeatureName_DualSourceBlending;
  }
#undef _SAPP_WGPU_MAX_REQUESTED_FEATURES

  WGPULimits adapterLimits = WGPU_LIMITS_INIT;
  wgpuAdapterGetLimits(_sapp.wgpu.adapter, &adapterLimits);

  WGPULimits requiredLimits = WGPU_LIMITS_INIT;
  requiredLimits.maxColorAttachments = adapterLimits.maxColorAttachments;
  requiredLimits.maxSampledTexturesPerShaderStage =
      adapterLimits.maxSampledTexturesPerShaderStage;
  requiredLimits.maxStorageBuffersPerShaderStage =
      adapterLimits.maxStorageBuffersPerShaderStage;
  requiredLimits.maxStorageTexturesPerShaderStage =
      adapterLimits.maxStorageTexturesPerShaderStage;

  _SAPP_STRUCT(WGPURequestDeviceCallbackInfo, cb_info);
  cb_info.mode = _sapp_wgpu_callbackmode();
  cb_info.callback = _sapp_wgpu_request_device_cb;

  _SAPP_STRUCT(WGPUDeviceDescriptor, dev_desc);
  dev_desc.requiredFeatureCount = cur_feature_index;
  dev_desc.requiredFeatures = requiredFeatures;
  dev_desc.requiredLimits = &requiredLimits;
  dev_desc.deviceLostCallbackInfo.mode = WGPUCallbackMode_AllowProcessEvents;
  dev_desc.deviceLostCallbackInfo.callback = _sapp_wgpu_device_lost_cb;
  dev_desc.uncapturedErrorCallbackInfo.callback =
      _sapp_wgpu_uncaptured_error_cb;
  WGPUFuture future =
      wgpuAdapterRequestDevice(_sapp.wgpu.adapter, &dev_desc, cb_info);
#if defined(_SAPP_WGPU_HAS_WAIT)
  _sapp_wgpu_await(future);
#else
  _SOKOL_UNUSED(future);
#endif
}

_SOKOL_PRIVATE void
_sapp_wgpu_request_adapter_cb(WGPURequestAdapterStatus status,
                              WGPUAdapter adapter, WGPUStringView msg,
                              void *userdata1, void *userdata2) {
  _SOKOL_UNUSED(msg);
  _SOKOL_UNUSED(userdata1);
  _SOKOL_UNUSED(userdata2);
  if (status != WGPURequestAdapterStatus_Success) {
    switch (status) {
    case WGPURequestAdapterStatus_Unavailable:
      _SAPP_PANIC(WGPU_REQUEST_ADAPTER_STATUS_UNAVAILABLE);
      break;
    case WGPURequestAdapterStatus_Error:
      _SAPP_PANIC(WGPU_REQUEST_ADAPTER_STATUS_ERROR);
      break;
    default:
      _SAPP_PANIC(WGPU_REQUEST_ADAPTER_STATUS_UNKNOWN);
      break;
    }
  }
  SOKOL_ASSERT(adapter);
  _sapp.wgpu.adapter = adapter;
#if !defined(_SAPP_WGPU_HAS_WAIT)
  // chain device creation
  _sapp_wgpu_create_device_and_swapchain();
#endif
}

_SOKOL_PRIVATE void _sapp_wgpu_create_adapter(void) {
  SOKOL_ASSERT(_sapp.wgpu.instance);
  // FIXME: power preference?
  _SAPP_STRUCT(WGPURequestAdapterCallbackInfo, cb_info);
  cb_info.mode = _sapp_wgpu_callbackmode();
  cb_info.callback = _sapp_wgpu_request_adapter_cb;
  WGPUFuture future =
      wgpuInstanceRequestAdapter(_sapp.wgpu.instance, 0, cb_info);
#if defined(_SAPP_WGPU_HAS_WAIT)
  _sapp_wgpu_await(future);
#else
  _SOKOL_UNUSED(future);
#endif
}

_SOKOL_PRIVATE void _sapp_wgpu_init(void) {
  SOKOL_ASSERT(0 == _sapp.wgpu.instance);
  SOKOL_ASSERT(!_sapp.wgpu.init_done);

  _SAPP_STRUCT(WGPUInstanceDescriptor, desc);
#if defined(_SAPP_WGPU_HAS_WAIT)
  WGPUInstanceFeatureName inst_features[1] = {
      WGPUInstanceFeatureName_TimedWaitAny,
  };
  desc.requiredFeatureCount = 1;
  desc.requiredFeatures = inst_features;
#endif
  _sapp.wgpu.instance = wgpuCreateInstance(&desc);
  if (0 == _sapp.wgpu.instance) {
    _SAPP_PANIC(WGPU_CREATE_INSTANCE_FAILED);
  }
  // NOTE: on Emscripten, device and swapchain creation are chained in the
  // callacks
  _sapp_wgpu_create_adapter();
#if defined(_SAPP_WGPU_HAS_WAIT)
  _sapp_wgpu_create_device_and_swapchain();
  SOKOL_ASSERT(_sapp.wgpu.init_done);
#endif
}

_SOKOL_PRIVATE void _sapp_wgpu_discard(void) {
  _sapp_wgpu_discard_swapchain(false);
  if (_sapp.wgpu.device) {
    wgpuDeviceRelease(_sapp.wgpu.device);
    _sapp.wgpu.device = 0;
  }
  if (_sapp.wgpu.adapter) {
    wgpuAdapterRelease(_sapp.wgpu.adapter);
    _sapp.wgpu.adapter = 0;
  }
  if (_sapp.wgpu.instance) {
    wgpuInstanceRelease(_sapp.wgpu.instance);
    _sapp.wgpu.instance = 0;
  }
}

_SOKOL_PRIVATE void _sapp_wgpu_frame(void) {
  wgpuInstanceProcessEvents(_sapp.wgpu.instance);
  if (_sapp.wgpu.init_done) {
    _sapp_frame();
    if (_sapp.wgpu.swapchain_view) {
      wgpuTextureViewRelease(_sapp.wgpu.swapchain_view);
      _sapp.wgpu.swapchain_view = 0;
    }
#if !defined(_SAPP_EMSCRIPTEN)
    wgpuSurfacePresent(_sapp.wgpu.surface);
#endif
  }
}
#endif // SOKOL_WGPU

// ██    ██ ██    ██ ██      ██   ██  █████  ███    ██
// ██    ██ ██    ██ ██      ██  ██  ██   ██ ████   ██
// ██    ██ ██    ██ ██      █████   ███████ ██ ██  ██
//  ██  ██  ██    ██ ██      ██  ██  ██   ██ ██  ██ ██
//   ████    ██████  ███████ ██   ██ ██   ██ ██   ████
//
// >>vulkan
// >>vk
#if defined(SOKOL_VULKAN)

#if defined(__cplusplus)
#define _SAPP_VK_ZERO_COUNT_AND_ARRAY(num, type, count_name, array_name)       \
  uint32_t count_name = 0;                                                     \
  type array_name[num] = {}
#define _SAPP_VK_MAX_COUNT_AND_ARRAY(num, type, count_name, array_name)        \
  uint32_t count_name = num;                                                   \
  type array_name[num] = {}
#else
#define _SAPP_VK_ZERO_COUNT_AND_ARRAY(num, type, count_name, array_name)       \
  uint32_t count_name = 0;                                                     \
  type array_name[num] = {0}
#define _SAPP_VK_MAX_COUNT_AND_ARRAY(num, type, count_name, array_name)        \
  uint32_t count_name = num;                                                   \
  type array_name[num] = {0}
#endif

_SOKOL_PRIVATE void _sapp_vk_load_instance_ext_funcs(void) {
  SOKOL_ASSERT(_sapp.vk.instance);
#if defined(SOKOL_DEBUG)
  _sapp.vk.ext.set_debug_utils_object_name_ext =
      (PFN_vkSetDebugUtilsObjectNameEXT)vkGetInstanceProcAddr(
          _sapp.vk.instance, "vkSetDebugUtilsObjectNameEXT");
  if (0 == _sapp.vk.ext.set_debug_utils_object_name_ext) {
    _SAPP_PANIC(VULKAN_REQUIRED_INSTANCE_EXTENSION_FUNCTION_MISSING);
  }
#endif
}

_SOKOL_PRIVATE void _sapp_vk_set_object_label(VkObjectType obj_type,
                                              uint64_t obj_handle,
                                              const char *label) {
#if defined(SOKOL_DEBUG)
  SOKOL_ASSERT(_sapp.vk.device);
  SOKOL_ASSERT(_sapp.vk.ext.set_debug_utils_object_name_ext);
  SOKOL_ASSERT(obj_handle);
  if (label) {
    _SAPP_STRUCT(VkDebugUtilsObjectNameInfoEXT, name_info);
    name_info.sType = VK_STRUCTURE_TYPE_DEBUG_UTILS_OBJECT_NAME_INFO_EXT;
    name_info.objectType = obj_type;
    name_info.objectHandle = obj_handle, name_info.pObjectName = label;
    VkResult res = _sapp.vk.ext.set_debug_utils_object_name_ext(_sapp.vk.device,
                                                                &name_info);
    SOKOL_ASSERT(res == VK_SUCCESS);
  }
#else
  _SOKOL_UNUSED(obj_type);
  _SOKOL_UNUSED(obj_handle);
  _SOKOL_UNUSED(label);
#endif
}

_SOKOL_PRIVATE int
_sapp_vk_mem_find_memory_type_index(uint32_t type_filter,
                                    VkMemoryPropertyFlags props) {
  SOKOL_ASSERT(_sapp.vk.physical_device);
  _SAPP_STRUCT(VkPhysicalDeviceMemoryProperties, mem_props);
  vkGetPhysicalDeviceMemoryProperties(_sapp.vk.physical_device, &mem_props);
  for (uint32_t i = 0; i < mem_props.memoryTypeCount; i++) {
    if ((type_filter & (1 << i)) &&
        ((mem_props.memoryTypes[i].propertyFlags & props) == props)) {
      return (int)i;
    }
  }
  return -1;
}

_SOKOL_PRIVATE void _sapp_vk_create_instance(void) {
  SOKOL_ASSERT(0 == _sapp.vk.instance);

  _SAPP_STRUCT(VkApplicationInfo, app_info);
  app_info.sType = VK_STRUCTURE_TYPE_APPLICATION_INFO;
  app_info.pApplicationName = "sokol-app"; // FIXME: override via sapp_desc?
  app_info.applicationVersion = VK_MAKE_VERSION(1, 0, 0);
  app_info.pEngineName = "sokol";
  app_info.engineVersion = VK_MAKE_VERSION(1, 0, 0);
  app_info.apiVersion = VK_API_VERSION_1_3;

  _SAPP_VK_ZERO_COUNT_AND_ARRAY(32, const char *, layer_count, layer_names);
#if defined(SOKOL_DEBUG)
  layer_names[layer_count++] = "VK_LAYER_KHRONOS_validation";
  SOKOL_ASSERT(layer_count <= 32);
#endif

  _SAPP_VK_ZERO_COUNT_AND_ARRAY(32, const char *, ext_count, ext_names);
  ext_names[ext_count++] = VK_KHR_SURFACE_EXTENSION_NAME;
#if defined(SOKOL_DEBUG)
  ext_names[ext_count++] = VK_EXT_DEBUG_UTILS_EXTENSION_NAME;
#endif
#if defined(VK_USE_PLATFORM_XLIB_KHR)
  ext_names[ext_count++] = VK_KHR_XLIB_SURFACE_EXTENSION_NAME;
#elif defined(VK_USE_PLATFORM_WIN32_KHR)
  ext_names[ext_count++] = VK_KHR_WIN32_SURFACE_EXTENSION_NAME;
#endif
  SOKOL_ASSERT(ext_count <= 32);

  _SAPP_STRUCT(VkInstanceCreateInfo, create_info);
  create_info.sType = VK_STRUCTURE_TYPE_INSTANCE_CREATE_INFO;
  create_info.flags = 0;
  create_info.pApplicationInfo = &app_info;
  create_info.enabledLayerCount = layer_count;
  create_info.ppEnabledLayerNames = layer_names;
  create_info.enabledExtensionCount = ext_count;
  create_info.ppEnabledExtensionNames = ext_names;
  VkResult res = vkCreateInstance(&create_info, 0, &_sapp.vk.instance);
  if (res != VK_SUCCESS) {
    _SAPP_PANIC(VULKAN_CREATE_INSTANCE_FAILED);
  }
  SOKOL_ASSERT(_sapp.vk.instance);
}

_SOKOL_PRIVATE void _sapp_vk_destroy_instance(void) {
  SOKOL_ASSERT(_sapp.vk.instance);
  vkDestroyInstance(_sapp.vk.instance, 0);
  _sapp.vk.instance = 0;
}

_SOKOL_PRIVATE uint32_t _sapp_vk_required_device_extensions(
    const char **out_names, uint32_t max_count) {
  SOKOL_ASSERT(out_names && (max_count > 0));
  uint32_t count = 0;
  out_names[count++] = VK_KHR_SWAPCHAIN_EXTENSION_NAME;
  out_names[count++] = VK_EXT_DESCRIPTOR_BUFFER_EXTENSION_NAME;
  SOKOL_ASSERT(count <= max_count);
  _SOKOL_UNUSED(max_count);
  return count;
}

_SOKOL_PRIVATE bool
_sapp_vk_check_device_extensions(VkPhysicalDevice pdev,
                                 const char **required_exts,
                                 uint32_t num_required_exts) {
  SOKOL_ASSERT(pdev && required_exts && num_required_exts > 0);
  uint32_t ext_count = 0;
  VkResult res = vkEnumerateDeviceExtensionProperties(pdev, 0, &ext_count, 0);
  SOKOL_ASSERT(res == VK_SUCCESS);
  _SOKOL_UNUSED(res);
  if (ext_count == 0) {
    return false;
  }
  VkExtensionProperties *ext_props = (VkExtensionProperties *)_sapp_malloc(
      sizeof(VkExtensionProperties) * ext_count);
  SOKOL_ASSERT(ext_props);
  res = vkEnumerateDeviceExtensionProperties(pdev, 0, &ext_count, ext_props);
  bool all_supported = true;
  for (uint32_t req_ext_idx = 0; req_ext_idx < num_required_exts;
       req_ext_idx++) {
    const char *req_ext_name = required_exts[req_ext_idx];
    bool required_ext_supported = false;
    for (uint32_t ext_idx = 0; ext_idx < ext_count; ext_idx++) {
      const VkExtensionProperties *ext_prop = &ext_props[ext_idx];
      if (0 == strcmp(req_ext_name, ext_prop->extensionName)) {
        required_ext_supported = true;
        break;
      }
    }
    if (!required_ext_supported) {
      all_supported = false;
    }
  }
  _sapp_free(ext_props);
  return all_supported;
}

_SOKOL_PRIVATE void _sapp_vk_pick_physical_device(void) {
  SOKOL_ASSERT(_sapp.vk.instance);
  SOKOL_ASSERT(_sapp.vk.surface);
  SOKOL_ASSERT(0 == _sapp.vk.physical_device);
  VkResult res = VK_SUCCESS;

  _SAPP_VK_MAX_COUNT_AND_ARRAY(8, VkPhysicalDevice, physical_device_count,
                               physical_devices);
  res = vkEnumeratePhysicalDevices(_sapp.vk.instance, &physical_device_count,
                                   physical_devices);
  if ((res != VK_SUCCESS) && (res != VK_INCOMPLETE)) {
    _SAPP_PANIC(VULKAN_ENUMERATE_PHYSICAL_DEVICES_FAILED);
  }
  if (physical_device_count == 0) {
    _SAPP_PANIC(VULKAN_NO_PHYSICAL_DEVICES_FOUND);
  }
  _SAPP_VK_ZERO_COUNT_AND_ARRAY(32, const char *, ext_count, ext_names);
  ext_count = _sapp_vk_required_device_extensions(ext_names, 32);

  VkPhysicalDevice picked_pdev = 0;
  for (uint32_t pdev_idx = 0; pdev_idx < physical_device_count; pdev_idx++) {
    const VkPhysicalDevice pdev = physical_devices[pdev_idx];
    _SAPP_STRUCT(VkPhysicalDeviceProperties, dev_props);
    vkGetPhysicalDeviceProperties(pdev, &dev_props);
    if (dev_props.apiVersion < VK_API_VERSION_1_3) {
      continue;
    }
    if (!_sapp_vk_check_device_extensions(pdev, ext_names, ext_count)) {
      continue;
    }
    // FIXME: handle theoretical case where graphics and present aren't
    // supported by the same queue family index
    _SAPP_VK_MAX_COUNT_AND_ARRAY(8, VkQueueFamilyProperties,
                                 queue_family_props_count, queue_family_props);
    vkGetPhysicalDeviceQueueFamilyProperties(pdev, &queue_family_props_count,
                                             queue_family_props);
    bool has_required_queues = false;
    const VkQueueFlags required_flags =
        VK_QUEUE_GRAPHICS_BIT | VK_QUEUE_COMPUTE_BIT | VK_QUEUE_TRANSFER_BIT;
    for (uint32_t qfp_idx = 0; qfp_idx < queue_family_props_count; qfp_idx++) {
      const VkQueueFlags queue_flags = queue_family_props[qfp_idx].queueFlags;
      if ((queue_flags & required_flags) == required_flags) {
        _sapp.vk.queue_family_index = qfp_idx;
        has_required_queues = true;
        break;
      }
    }
    if (!has_required_queues) {
      continue;
    }

    VkBool32 presentation_supported = false;
    res = vkGetPhysicalDeviceSurfaceSupportKHR(
        pdev, _sapp.vk.queue_family_index, _sapp.vk.surface,
        &presentation_supported);
    SOKOL_ASSERT(VK_SUCCESS == res);
    if (!presentation_supported) {
      continue;
    }

    // if we arrive here, found a suitable device
    picked_pdev = pdev;
    break;
  }
  if (0 == picked_pdev) {
    _SAPP_PANIC(VULKAN_NO_SUITABLE_PHYSICAL_DEVICE_FOUND);
  }
  _sapp.vk.physical_device = picked_pdev;
  SOKOL_ASSERT(_sapp.vk.physical_device);
}

_SOKOL_PRIVATE void _sapp_vk_create_device(void) {
  SOKOL_ASSERT(_sapp.vk.physical_device);
  SOKOL_ASSERT(0 == _sapp.vk.device);

  const float queue_priority = 0.0f;
  _SAPP_STRUCT(VkDeviceQueueCreateInfo, queue_create_info);
  queue_create_info.sType = VK_STRUCTURE_TYPE_DEVICE_QUEUE_CREATE_INFO;
  queue_create_info.queueFamilyIndex = _sapp.vk.queue_family_index;
  queue_create_info.queueCount = 1;
  queue_create_info.pQueuePriorities = &queue_priority;

  _SAPP_VK_ZERO_COUNT_AND_ARRAY(32, const char *, ext_count, ext_names);
  ext_count = _sapp_vk_required_device_extensions(ext_names, 32);

  _SAPP_STRUCT(VkPhysicalDeviceFeatures2, supports);
  supports.sType = VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FEATURES_2;
  vkGetPhysicalDeviceFeatures2(_sapp.vk.physical_device, &supports);

  _SAPP_STRUCT(VkPhysicalDeviceDescriptorBufferFeaturesEXT,
               descriptor_buffer_features);
  descriptor_buffer_features.sType =
      VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_DESCRIPTOR_BUFFER_FEATURES_EXT;
  descriptor_buffer_features.descriptorBuffer = VK_TRUE;

  _SAPP_STRUCT(VkPhysicalDeviceExtendedDynamicStateFeaturesEXT, xds_features);
  xds_features.sType =
      VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_EXTENDED_DYNAMIC_STATE_FEATURES_EXT;
  xds_features.pNext = &descriptor_buffer_features;
  xds_features.extendedDynamicState = VK_TRUE;

  _SAPP_STRUCT(VkPhysicalDeviceVulkan12Features, vk12_features);
  vk12_features.sType = VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VULKAN_1_2_FEATURES;
  vk12_features.pNext = &xds_features;
  vk12_features.bufferDeviceAddress = VK_TRUE;

  _SAPP_STRUCT(VkPhysicalDeviceVulkan13Features, vk13_features);
  vk13_features.sType = VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_VULKAN_1_3_FEATURES;
  vk13_features.pNext = &vk12_features;
  vk13_features.dynamicRendering = VK_TRUE;
  vk13_features.synchronization2 = VK_TRUE;

  _SAPP_STRUCT(VkPhysicalDeviceFeatures2, required);
  required.sType = VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FEATURES_2;
  required.pNext = &vk13_features;
  required.features.samplerAnisotropy = VK_TRUE;
  required.features.dualSrcBlend = VK_TRUE;
  if (supports.features.textureCompressionBC) {
    required.features.textureCompressionBC = VK_TRUE;
  }
  if (supports.features.textureCompressionETC2) {
    required.features.textureCompressionETC2 = VK_TRUE;
  }
  if (supports.features.textureCompressionASTC_LDR) {
    required.features.textureCompressionASTC_LDR = VK_TRUE;
  }
  _SAPP_STRUCT(VkDeviceCreateInfo, dev_create_info);
  dev_create_info.sType = VK_STRUCTURE_TYPE_DEVICE_CREATE_INFO;
  dev_create_info.pNext = &required;
  dev_create_info.queueCreateInfoCount = 1;
  dev_create_info.pQueueCreateInfos = &queue_create_info;
  dev_create_info.enabledExtensionCount = ext_count;
  dev_create_info.ppEnabledExtensionNames = ext_names;

  VkResult res = vkCreateDevice(_sapp.vk.physical_device, &dev_create_info, 0,
                                &_sapp.vk.device);
  if (res != VK_SUCCESS) {
    switch (res) {
    case VK_ERROR_EXTENSION_NOT_PRESENT:
      _SAPP_PANIC(VULKAN_CREATE_DEVICE_FAILED_EXTENSION_NOT_PRESENT);
      break;
    case VK_ERROR_FEATURE_NOT_PRESENT:
      _SAPP_PANIC(VULKAN_CREATE_DEVICE_FAILED_FEATURE_NOT_PRESENT);
      break;
    case VK_ERROR_INITIALIZATION_FAILED:
      _SAPP_PANIC(VULKAN_CREATE_DEVICE_FAILED_INITIALIZATION_FAILED);
      break;
    default:
      _SAPP_PANIC(VULKAN_CREATE_DEVICE_FAILED_OTHER);
      break;
    }
  }
  SOKOL_ASSERT(_sapp.vk.device);

  SOKOL_ASSERT(0 == _sapp.vk.queue);
  vkGetDeviceQueue(_sapp.vk.device, _sapp.vk.queue_family_index, 0,
                   &_sapp.vk.queue);
  SOKOL_ASSERT(_sapp.vk.queue);
}

_SOKOL_PRIVATE void _sapp_vk_destroy_device(void) {
  SOKOL_ASSERT(_sapp.vk.device);
  vkDestroyDevice(_sapp.vk.device, 0);
  _sapp.vk.device = 0;
  _sapp.vk.queue = 0;
}

_SOKOL_PRIVATE void _sapp_vk_create_surface(void) {
  SOKOL_ASSERT(_sapp.vk.instance);
  SOKOL_ASSERT(0 == _sapp.vk.surface);
  VkResult res = VK_SUCCESS;

#if defined(_SAPP_LINUX)
#if defined(_SAPP_X11)
  _SAPP_STRUCT(VkXlibSurfaceCreateInfoKHR, xlib_info);
  xlib_info.sType = VK_STRUCTURE_TYPE_XLIB_SURFACE_CREATE_INFO_KHR;
  xlib_info.dpy = _sapp.x11.display;
  xlib_info.window = _sapp.x11.window;
  res = vkCreateXlibSurfaceKHR(_sapp.vk.instance, &xlib_info, 0,
                               &_sapp.vk.surface);
#elif defined(_SAPP_WAYLAND)
  _SAPP_STRUCT(VkWaylandSurfaceCreateInfoKHR, wl_info);
  wl_info.sType = VK_STRUCTURE_TYPE_WAYLAND_SURFACE_CREATE_INFO_KHR;
  wl_info.display = _sapp.wl.display;
  wl_info.surface = _sapp.wl.surface;
  res = vkCreateWaylandSurfaceKHR(_sapp.vk.instance, &wl_info, 0,
                                  &_sapp.vk.surface);
#endif
#elif defined(_SAPP_WIN32)
  _SAPP_STRUCT(VkWin32SurfaceCreateInfoKHR, win32_info);
  win32_info.sType = VK_STRUCTURE_TYPE_WIN32_SURFACE_CREATE_INFO_KHR;
  win32_info.hinstance = GetModuleHandleW(NULL);
  win32_info.hwnd = _sapp.win32.hwnd;
  res = vkCreateWin32SurfaceKHR(_sapp.vk.instance, &win32_info, 0,
                                &_sapp.vk.surface);
#else
#error "sokol_app.h: unsupported Vulkan platform"
#endif
  if (res != VK_SUCCESS) {
    _SAPP_PANIC(VULKAN_CREATE_SURFACE_FAILED);
  }
  SOKOL_ASSERT(_sapp.vk.surface);
}

_SOKOL_PRIVATE void _sapp_vk_destroy_surface(void) {
  SOKOL_ASSERT(_sapp.vk.instance);
  SOKOL_ASSERT(_sapp.vk.surface);
  vkDestroySurfaceKHR(_sapp.vk.instance, _sapp.vk.surface, 0);
  _sapp.vk.surface = 0;
}

_SOKOL_PRIVATE VkSurfaceFormatKHR _sapp_vk_pick_surface_format(void) {
  SOKOL_ASSERT(_sapp.vk.instance);
  SOKOL_ASSERT(_sapp.vk.surface);
  _SAPP_VK_MAX_COUNT_AND_ARRAY(64, VkSurfaceFormatKHR, fmt_count, formats);
  VkResult res = vkGetPhysicalDeviceSurfaceFormatsKHR(
      _sapp.vk.physical_device, _sapp.vk.surface, &fmt_count, formats);
  SOKOL_ASSERT((res == VK_SUCCESS) || (res == VK_INCOMPLETE));
  _SOKOL_UNUSED(res);
  SOKOL_ASSERT(fmt_count > 0);
  // FIXME: only accept non-SRGB formats until sokol_app.h gets proper SRGB
  // support
  for (uint32_t i = 0; i < fmt_count; i++) {
    switch (formats[i].format) {
    case VK_FORMAT_B8G8R8A8_UNORM:
    case VK_FORMAT_R8G8B8A8_UNORM:
      return formats[i];
    default:
      break;
    }
  }
  // FIXME: fallback might still return an SRGB format
  return formats[0];
}

_SOKOL_PRIVATE void _sapp_vk_create_sync_objects(void) {
  SOKOL_ASSERT(_sapp.vk.device);
  _SAPP_STRUCT(VkSemaphoreCreateInfo, create_info);
  create_info.sType = VK_STRUCTURE_TYPE_SEMAPHORE_CREATE_INFO;
  VkResult res;
  _SOKOL_UNUSED(res);
  for (uint32_t i = 0; i < _sapp.vk.num_swapchain_images; i++) {
    SOKOL_ASSERT(0 == _sapp.vk.sync[i].present_complete_sem);
    SOKOL_ASSERT(0 == _sapp.vk.sync[i].render_finished_sem);
    res = vkCreateSemaphore(_sapp.vk.device, &create_info, 0,
                            &_sapp.vk.sync[i].present_complete_sem);
    SOKOL_ASSERT((res == VK_SUCCESS) &&
                 (_sapp.vk.sync[i].present_complete_sem));
    _sapp_vk_set_object_label(VK_OBJECT_TYPE_SEMAPHORE,
                              (uint64_t)_sapp.vk.sync[i].present_complete_sem,
                              "present_complete_sem");
    res = vkCreateSemaphore(_sapp.vk.device, &create_info, 0,
                            &_sapp.vk.sync[i].render_finished_sem);
    SOKOL_ASSERT((res == VK_SUCCESS) && (_sapp.vk.sync[i].render_finished_sem));
    _sapp_vk_set_object_label(VK_OBJECT_TYPE_SEMAPHORE,
                              (uint64_t)_sapp.vk.sync[i].render_finished_sem,
                              "render_finished_sem");
  }
}

_SOKOL_PRIVATE void _sapp_vk_destroy_sync_objects(void) {
  SOKOL_ASSERT(_sapp.vk.device);
  for (uint32_t i = 0; i < _sapp.vk.num_swapchain_images; i++) {
    SOKOL_ASSERT(_sapp.vk.sync[i].present_complete_sem);
    SOKOL_ASSERT(_sapp.vk.sync[i].render_finished_sem);
    vkDestroySemaphore(_sapp.vk.device, _sapp.vk.sync[i].present_complete_sem,
                       0);
    vkDestroySemaphore(_sapp.vk.device, _sapp.vk.sync[i].render_finished_sem,
                       0);
    _sapp.vk.sync[i].present_complete_sem = 0;
    _sapp.vk.sync[i].render_finished_sem = 0;
  }
}

_SOKOL_PRIVATE VkDeviceMemory
_sapp_vk_mem_alloc_image_memory(const VkMemoryRequirements *mem_reqs) {
  SOKOL_ASSERT(_sapp.vk.device);
  SOKOL_ASSERT(mem_reqs);
  int mem_type_index = _sapp_vk_mem_find_memory_type_index(
      mem_reqs->memoryTypeBits, VK_MEMORY_PROPERTY_DEVICE_LOCAL_BIT);
  if (-1 == mem_type_index) {
    _SAPP_ERROR(VULKAN_ALLOC_DEVICE_MEMORY_NO_SUITABLE_MEMORY_TYPE);
    return 0;
  }
  _SAPP_STRUCT(VkMemoryAllocateInfo, alloc_info);
  alloc_info.sType = VK_STRUCTURE_TYPE_MEMORY_ALLOCATE_INFO;
  alloc_info.allocationSize = mem_reqs->size;
  alloc_info.memoryTypeIndex = (uint32_t)mem_type_index;
  VkDeviceMemory vk_dev_mem = 0;
  VkResult res = vkAllocateMemory(_sapp.vk.device, &alloc_info, 0, &vk_dev_mem);
  if (res != VK_SUCCESS) {
    _SAPP_ERROR(VULKAN_ALLOCATE_MEMORY_FAILED);
    return 0;
  }
  SOKOL_ASSERT(vk_dev_mem);
  return vk_dev_mem;
}

_SOKOL_PRIVATE void _sapp_vk_mem_free_image_memory(VkDeviceMemory vk_dev_mem) {
  SOKOL_ASSERT(_sapp.vk.device);
  SOKOL_ASSERT(vk_dev_mem);
  vkFreeMemory(_sapp.vk.device, vk_dev_mem, 0);
}

_SOKOL_PRIVATE void
_sapp_vk_swapchain_destroy_surface(_sapp_vk_swapchain_surface_t *surf) {
  SOKOL_ASSERT(surf);
  SOKOL_ASSERT(surf->img);
  SOKOL_ASSERT(surf->mem);
  SOKOL_ASSERT(surf->view);
  vkDestroyImageView(_sapp.vk.device, surf->view, 0);
  surf->view = 0;
  _sapp_vk_mem_free_image_memory(surf->mem);
  surf->mem = 0;
  vkDestroyImage(_sapp.vk.device, surf->img, 0);
  surf->img = 0;
}

_SOKOL_PRIVATE void _sapp_vk_swapchain_create_surface(
    _sapp_vk_swapchain_surface_t *surf, bool recreate, VkFormat format,
    uint32_t width, uint32_t height, VkSampleCountFlagBits sample_count_flags,
    VkImageUsageFlags usage, VkImageAspectFlags aspect_mask,
    const char *image_debug_label, const char *view_debug_label) {
  SOKOL_ASSERT(_sapp.vk.physical_device);
  SOKOL_ASSERT(_sapp.vk.device);
  SOKOL_ASSERT(surf);
  if (recreate) {
    _sapp_vk_swapchain_destroy_surface(surf);
  }
  SOKOL_ASSERT(0 == surf->img);
  SOKOL_ASSERT(0 == surf->mem);
  SOKOL_ASSERT(0 == surf->view);
  VkResult res;

  _SAPP_STRUCT(VkImageCreateInfo, img_create_info);
  img_create_info.sType = VK_STRUCTURE_TYPE_IMAGE_CREATE_INFO;
  img_create_info.imageType = VK_IMAGE_TYPE_2D;
  img_create_info.format = format;
  img_create_info.extent.width = width;
  img_create_info.extent.height = height;
  img_create_info.extent.depth = 1;
  img_create_info.mipLevels = 1;
  img_create_info.arrayLayers = 1;
  img_create_info.samples = sample_count_flags;
  img_create_info.tiling = VK_IMAGE_TILING_OPTIMAL;
  img_create_info.usage = usage;
  img_create_info.sharingMode = VK_SHARING_MODE_EXCLUSIVE;
  img_create_info.initialLayout = VK_IMAGE_LAYOUT_UNDEFINED;
  res = vkCreateImage(_sapp.vk.device, &img_create_info, 0, &surf->img);
  if (res != VK_SUCCESS) {
    _SAPP_PANIC(VULKAN_SWAPCHAIN_CREATE_IMAGE_FAILED);
  }
  SOKOL_ASSERT(surf->img);
  _sapp_vk_set_object_label(VK_OBJECT_TYPE_IMAGE, (uint64_t)surf->img,
                            image_debug_label);

  _SAPP_STRUCT(VkMemoryRequirements, mem_reqs);
  vkGetImageMemoryRequirements(_sapp.vk.device, surf->img, &mem_reqs);
  surf->mem = _sapp_vk_mem_alloc_image_memory(&mem_reqs);
  if (0 == surf->mem) {
    _SAPP_PANIC(VULKAN_SWAPCHAIN_ALLOC_IMAGE_DEVICE_MEMORY_FAILED);
  }
  res = vkBindImageMemory(_sapp.vk.device, surf->img, surf->mem, 0);
  if (res != VK_SUCCESS) {
    _SAPP_PANIC(VULKAN_SWAPCHAIN_BIND_IMAGE_MEMORY_FAILED);
  }
  SOKOL_ASSERT(surf->mem);

  _SAPP_STRUCT(VkImageViewCreateInfo, view_create_info);
  view_create_info.sType = VK_STRUCTURE_TYPE_IMAGE_VIEW_CREATE_INFO;
  view_create_info.image = surf->img;
  view_create_info.viewType = VK_IMAGE_VIEW_TYPE_2D;
  view_create_info.format = format;
  view_create_info.subresourceRange.aspectMask = aspect_mask;
  view_create_info.subresourceRange.levelCount = 1;
  view_create_info.subresourceRange.layerCount = 1;
  res = vkCreateImageView(_sapp.vk.device, &view_create_info, 0, &surf->view);
  if (res != VK_SUCCESS) {
    _SAPP_PANIC(VULKAN_SWAPCHAIN_CREATE_IMAGE_VIEW_FAILED);
  }
  SOKOL_ASSERT(surf->view);
  _sapp_vk_set_object_label(VK_OBJECT_TYPE_IMAGE_VIEW, (uint64_t)surf->view,
                            view_debug_label);
}

_SOKOL_PRIVATE uint32_t
_sapp_vk_swapchain_min_image_count(const VkSurfaceCapabilitiesKHR *surf_caps) {
  // FIXME: figure out why at least 3 swapchain images are required to appease
  // the validation layer (on the Linux Intel driver, present-mode-fifo has a
  // surf_caps.minImageCount == 3, while on Windows surf_caps.minImageCount ==
  // 2, and using this directly causes validation layer errors about the
  // present-complete semaphore (to reproduce simply change the '= 3' below to
  // '= 2')
  SOKOL_ASSERT(surf_caps);
  const uint32_t required_image_count = 3;
  uint32_t min_image_count = surf_caps->minImageCount;
  if (min_image_count < required_image_count) {
    min_image_count = required_image_count;
  }
  return min_image_count;
}

_SOKOL_PRIVATE void _sapp_vk_create_swapchain_image_view(uint32_t image_index) {
  SOKOL_ASSERT(_sapp.vk.device);
  SOKOL_ASSERT(image_index < _sapp.vk.num_swapchain_images);
  SOKOL_ASSERT(_sapp.vk.swapchain_images[image_index]);
  SOKOL_ASSERT(0 == _sapp.vk.swapchain_views[image_index]);

  _SAPP_STRUCT(VkImageViewCreateInfo, view_create_info);
  view_create_info.sType = VK_STRUCTURE_TYPE_IMAGE_VIEW_CREATE_INFO;
  view_create_info.viewType = VK_IMAGE_VIEW_TYPE_2D;
  view_create_info.format = _sapp.vk.surface_format.format;
  view_create_info.subresourceRange.aspectMask = VK_IMAGE_ASPECT_COLOR_BIT;
  view_create_info.subresourceRange.levelCount = 1;
  view_create_info.subresourceRange.layerCount = 1;
  view_create_info.image = _sapp.vk.swapchain_images[image_index];
  VkResult res = vkCreateImageView(_sapp.vk.device, &view_create_info, 0,
                                   &_sapp.vk.swapchain_views[image_index]);
  if (res != VK_SUCCESS) {
    _SAPP_PANIC(VULKAN_SWAPCHAIN_CREATE_IMAGE_VIEW_FAILED);
  }
  SOKOL_ASSERT(_sapp.vk.swapchain_views[image_index]);
  _sapp_vk_set_object_label(VK_OBJECT_TYPE_IMAGE_VIEW,
                            (uint64_t)_sapp.vk.swapchain_views[image_index],
                            "swapchain_view");
}

_SOKOL_PRIVATE void
_sapp_vk_destroy_swapchain_image_view(uint32_t image_index) {
  SOKOL_ASSERT(_sapp.vk.device);
  SOKOL_ASSERT(image_index < _sapp.vk.num_swapchain_images);
  SOKOL_ASSERT(_sapp.vk.swapchain_views[image_index]);
  vkDestroyImageView(_sapp.vk.device, _sapp.vk.swapchain_views[image_index], 0);
  _sapp.vk.swapchain_views[image_index] = 0;
}

_SOKOL_PRIVATE void _sapp_vk_create_swapchain(bool recreate) {
  SOKOL_ASSERT(_sapp.vk.physical_device);
  SOKOL_ASSERT(_sapp.vk.surface);
  SOKOL_ASSERT(_sapp.vk.device);
  if (!recreate) {
    SOKOL_ASSERT(0 == _sapp.vk.swapchain);
    SOKOL_ASSERT(0 == _sapp.vk.num_swapchain_images);
    SOKOL_ASSERT(0 == _sapp.vk.swapchain_images[0]);
    SOKOL_ASSERT(0 == _sapp.vk.swapchain_views[0]);
  } else {
    SOKOL_ASSERT(_sapp.vk.swapchain);
    SOKOL_ASSERT(_sapp.vk.num_swapchain_images > 0);
    SOKOL_ASSERT(_sapp.vk.swapchain_images[0]);
    SOKOL_ASSERT(_sapp.vk.swapchain_views[0]);
  }

  VkSwapchainKHR old_swapchain = _sapp.vk.swapchain;

  _SAPP_STRUCT(VkSurfaceCapabilitiesKHR, surf_caps);
  VkResult res = vkGetPhysicalDeviceSurfaceCapabilitiesKHR(
      _sapp.vk.physical_device, _sapp.vk.surface, &surf_caps);
  SOKOL_ASSERT(res == VK_SUCCESS);
  const uint32_t fb_width = surf_caps.currentExtent.width;
  const uint32_t fb_height = surf_caps.currentExtent.height;

  _sapp.vk.surface_format = _sapp_vk_pick_surface_format();
  const VkPresentModeKHR present_mode = VK_PRESENT_MODE_FIFO_KHR;

  _SAPP_STRUCT(VkSwapchainCreateInfoKHR, create_info);
  create_info.sType = VK_STRUCTURE_TYPE_SWAPCHAIN_CREATE_INFO_KHR;
  create_info.flags = 0;
  create_info.surface = _sapp.vk.surface;
  create_info.minImageCount = _sapp_vk_swapchain_min_image_count(&surf_caps);
  create_info.imageFormat = _sapp.vk.surface_format.format;
  create_info.imageColorSpace = _sapp.vk.surface_format.colorSpace;
  create_info.imageExtent.width = fb_width;
  create_info.imageExtent.height = fb_height;
  create_info.imageArrayLayers = 1;
  create_info.imageUsage = VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT;
  create_info.imageSharingMode = VK_SHARING_MODE_EXCLUSIVE;
  create_info.preTransform = surf_caps.currentTransform;
  create_info.compositeAlpha = VK_COMPOSITE_ALPHA_OPAQUE_BIT_KHR;
  create_info.presentMode = present_mode;
  create_info.clipped = true;
  create_info.oldSwapchain = old_swapchain;
  res = vkCreateSwapchainKHR(_sapp.vk.device, &create_info, 0,
                             &_sapp.vk.swapchain);
  if (res != VK_SUCCESS) {
    _SAPP_PANIC(VULKAN_CREATE_SWAPCHAIN_FAILED);
  }
  SOKOL_ASSERT(_sapp.vk.swapchain);

  if (old_swapchain) {
    // NOTE: destroying the depth- and msaa-surfaces happens
    // down in the respective _sapp_vk_swapchain_create_surface() calls!
    for (uint32_t i = 0; i < _sapp.vk.num_swapchain_images; i++) {
      _sapp_vk_destroy_swapchain_image_view(i);
    }
    vkDestroySwapchainKHR(_sapp.vk.device, old_swapchain, 0);
  }

  _sapp.vk.num_swapchain_images = _SAPP_VK_MAX_SWAPCHAIN_IMAGES;
  res = vkGetSwapchainImagesKHR(_sapp.vk.device, _sapp.vk.swapchain,
                                &_sapp.vk.num_swapchain_images,
                                _sapp.vk.swapchain_images);
  SOKOL_ASSERT(res == VK_SUCCESS);
  SOKOL_ASSERT(_sapp.vk.num_swapchain_images >= surf_caps.minImageCount);

  for (uint32_t i = 0; i < _sapp.vk.num_swapchain_images; i++) {
    _sapp_vk_create_swapchain_image_view(i);
  }

  // create depth-stencil buffer
  _sapp_vk_swapchain_create_surface(
      &_sapp.vk.depth, recreate, VK_FORMAT_D32_SFLOAT_S8_UINT, fb_width,
      fb_height, (VkSampleCountFlagBits)_sapp.sample_count,
      VK_IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT,
      VK_IMAGE_ASPECT_DEPTH_BIT | VK_IMAGE_ASPECT_STENCIL_BIT,
      "swapchain_depthstencil_image", "swapchain_depthstencil_view");

  // optionally create MSAA surface
  if (_sapp.sample_count > 1) {
    _sapp_vk_swapchain_create_surface(
        &_sapp.vk.msaa, recreate, _sapp.vk.surface_format.format, fb_width,
        fb_height, (VkSampleCountFlagBits)_sapp.sample_count,
        VK_IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT |
            VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT,
        VK_IMAGE_ASPECT_COLOR_BIT, "swapchain_msaa_image",
        "swapchain_msaa_view");
  }

  // this is the only place in the Vulkan code path which updates
  // _sapp.framebuffer_width/height
  _sapp.framebuffer_width = (int)fb_width;
  _sapp.framebuffer_height = (int)fb_height;
}

_SOKOL_PRIVATE void _sapp_vk_destroy_swapchain(void) {
  SOKOL_ASSERT(_sapp.vk.device);
  SOKOL_ASSERT(_sapp.vk.swapchain);
  SOKOL_ASSERT(_sapp.vk.num_swapchain_images > 0);
  if (_sapp.vk.msaa.img) {
    _sapp_vk_swapchain_destroy_surface(&_sapp.vk.msaa);
  }
  _sapp_vk_swapchain_destroy_surface(&_sapp.vk.depth);
  for (uint32_t i = 0; i < _sapp.vk.num_swapchain_images; i++) {
    _sapp_vk_destroy_swapchain_image_view(i);
    _sapp.vk.swapchain_images[i] = 0;
  }
  vkDestroySwapchainKHR(_sapp.vk.device, _sapp.vk.swapchain, 0);
  _sapp.vk.swapchain = 0;
  _sapp.vk.num_swapchain_images = 0;
}

#if defined(_SAPP_LINUX)
#if defined(_SAPP_X11)
_SOKOL_PRIVATE void _sapp_x11_app_event(sapp_event_type type);
#elif defined(_SAPP_WAYLAND)
_SOKOL_PRIVATE void _sapp_wl_app_event(sapp_event_type type);
#endif
[_sapp.macos.window center];
_sapp.valid = true;

// __v_ start
if (!_sapp.__v_native_render) { // __v_
#endif
#if defined(_SAPP_WIN32)
  _SOKOL_PRIVATE void _sapp_win32_app_event(sapp_event_type type);
#endif

  _SOKOL_PRIVATE void _sapp_vk_recreate_swapchain(void) {
    SOKOL_ASSERT(_sapp.vk.device);
    vkDeviceWaitIdle(_sapp.vk.device);
    int fb_width = _sapp.framebuffer_width;
    int fb_height = _sapp.framebuffer_height;
    _sapp_vk_create_swapchain(true);
    if ((fb_width != _sapp.framebuffer_width) ||
        (fb_height != _sapp.framebuffer_height)) {
      if (!_sapp.first_frame) {
#if defined(_SAPP_LINUX)
#if defined(_SAPP_X11)
        _sapp_x11_app_event(SAPP_EVENTTYPE_RESIZED);
#elif defined(_SAPP_WAYLAND)
        _sapp_wl_app_event(SAPP_EVENTTYPE_RESIZED);
#endif
#endif
#if defined(_SAPP_WIN32)
        _sapp_win32_app_event(SAPP_EVENTTYPE_RESIZED);
#endif
      }
    }

    else {
      [_sapp.macos.window center];
    }
  } // __v_
  // __v_ end

  NSApp.activationPolicy = NSApplicationActivationPolicyRegular;
  [NSApp activateIgnoringOtherApps:YES];

  // __v start
  ///////////////////////////////////////////////////////
  // Create a child view for native rendering
  if (_sapp.__v_native_render) {

    CGRect wRect = _sapp.macos.window.frame;
    NSView *contentView = _sapp.macos.window.contentView;
    CGRect cRect = contentView.frame;

    CGRect rect = CGRectMake(wRect.origin.x, wRect.origin.y, cRect.size.width,
                             cRect.size.height);
    NSWindow *overlayWindow =
        [[NSWindow alloc] initWithContentRect:rect
                                    styleMask:NSBorderlessWindowMask
                                      backing:NSBackingStoreBuffered
                                        defer:NO];
    // overlayWindow.backgroundColor = [NSColor whiteColor];

    // overlayWindow.backgroundColor = [[NSColor whiteColor]
    // colorWithAlphaComponent:0];
    [overlayWindow setOpaque:YES];
    [_sapp.macos.window setIgnoresMouseEvents:NO];
    g_view = [[MyView2 alloc] init];
    g_view.autoresizingMask = NSViewWidthSizable | NSViewHeightSizable;
    overlayWindow.contentView = g_view;

    [contentView addSubview:g_view];
    //[    _sapp.macos.window addChildWindow:overlayWindow
    // ordered:NSWindowAbove];
    [_sapp.macos.window center];
  }
  //////////////////////////////////
  // __v_ end

  [_sapp.macos.window makeKeyAndOrderFront:nil];
  _sapp_macos_update_dimensions();
  [NSEvent setMouseCoalescingEnabled:NO];

  // __v_ start
  /*
         NSApplicationPresentationOptions options =
     (NSApplicationPresentationAutoHideMenuBar |
                                                  NSApplicationPresentationAutoHideDock
     | NSApplicationPresentationFullScreen | NSApplicationPresentationHideDock);

      [NSApp setPresentationOptions:options];
     */

  //[NSEvent setMouseCoalescingEnabled:NO];
  // __v_ end
}

_SOKOL_PRIVATE void _sapp_vk_init(void) {
  _sapp_vk_create_instance();
  _sapp_vk_load_instance_ext_funcs();
  _sapp_vk_create_surface();
  _sapp_vk_pick_physical_device();
  _sapp_vk_create_device();
  _sapp_vk_create_swapchain(false);
  _sapp_vk_create_sync_objects();
}

_SOKOL_PRIVATE void _sapp_vk_discard(void) {
  SOKOL_ASSERT(_sapp.vk.device);
  vkDeviceWaitIdle(_sapp.vk.device);
  _sapp_vk_destroy_sync_objects();
  _sapp_vk_destroy_swapchain();
  _sapp_vk_destroy_device();
  _sapp_vk_destroy_surface();
  _sapp_vk_destroy_instance();
}

_SOKOL_PRIVATE void _sapp_vk_swapchain_next(void) {
  SOKOL_ASSERT(_sapp.vk.device);
  SOKOL_ASSERT(_sapp.vk.swapchain);
  VkResult res =
      vkAcquireNextImageKHR(_sapp.vk.device, _sapp.vk.swapchain,
                            UINT64_MAX, // timeout
                            _sapp.vk.sync[_sapp.vk.sync_slot]
                                .present_complete_sem, // semaphore to signal
                            0,                         // fence to signal
                            &_sapp.vk.cur_swapchain_image_index);
  if ((res != VK_NOT_READY) && (res != VK_SUBOPTIMAL_KHR) &&
      (res != VK_SUCCESS) && (res != VK_TIMEOUT)) {
    _SAPP_WARN(VULKAN_ACQUIRE_NEXT_IMAGE_FAILED);
  }
}

_SOKOL_PRIVATE void _sapp_vk_present(void) {
  SOKOL_ASSERT(_sapp.vk.queue);
  _SAPP_STRUCT(VkPresentInfoKHR, present_info);
  present_info.sType = VK_STRUCTURE_TYPE_PRESENT_INFO_KHR;
  present_info.waitSemaphoreCount = 1;
  // NOTE: using the current swapchain image index here instead of `sync_slot`
  // is *NOT* a bug! The render_finished_semaphore *must* be associated with the
  // current swapchain image in case the swapchain implementation doesn't return
  // swapchain images in order
  present_info.pWaitSemaphores =
      &_sapp.vk.sync[_sapp.vk.cur_swapchain_image_index].render_finished_sem;
  present_info.swapchainCount = 1;
  present_info.pSwapchains = &_sapp.vk.swapchain;
  present_info.pImageIndices = &_sapp.vk.cur_swapchain_image_index;
  VkResult res = vkQueuePresentKHR(_sapp.vk.queue, &present_info);
  if ((res == VK_ERROR_OUT_OF_DATE_KHR) || (res == VK_SUBOPTIMAL_KHR)) {
    _sapp_vk_recreate_swapchain();
  } else if (res != VK_SUCCESS) {
    _SAPP_WARN(VULKAN_QUEUE_PRESENT_FAILED);
  }
}

_SOKOL_PRIVATE void _sapp_vk_frame(void) {
  _sapp_frame();
  _sapp_vk_present();
  _sapp.vk.sync_slot = (_sapp.vk.sync_slot + 1) % _sapp.vk.num_swapchain_images;
}

#endif // SOKOL_VULKAN

//  █████  ██████  ██████  ██      ███████
// ██   ██ ██   ██ ██   ██ ██      ██
// ███████ ██████  ██████  ██      █████
// ██   ██ ██      ██      ██      ██
// ██   ██ ██      ██      ███████ ███████
//
// >>apple
#if defined(_SAPP_APPLE)

#if __has_feature(objc_arc)
#define _SAPP_OBJC_RELEASE(obj)                                                \
  {                                                                            \
    obj = nil;                                                                 \
  }
#else
#define _SAPP_OBJC_RELEASE(obj)                                                \
  {                                                                            \
    [obj release];                                                             \
    obj = nil;                                                                 \
  }
#endif

// ███    ███  █████   ██████  ██████  ███████
// ████  ████ ██   ██ ██      ██    ██ ██
// ██ ████ ██ ███████ ██      ██    ██ ███████
// ██  ██  ██ ██   ██ ██      ██    ██      ██
// ██      ██ ██   ██  ██████  ██████  ███████
//
// >>macos
#if defined(_SAPP_MACOS)

NSInteger _sapp_macos_max_fps(void) {
  NSInteger max_fps = 60;
#if (__MAC_OS_X_VERSION_MAX_ALLOWED >= 120000)
  if (@available(macOS 12.0, *)) {
    max_fps = [NSScreen.mainScreen maximumFramesPerSecond];
  }
#endif
  return max_fps;
}

#if defined(SOKOL_METAL)
_SOKOL_PRIVATE void _sapp_macos_mtl_init(void) {
  NSInteger max_fps = _sapp_macos_max_fps();
  // NOTE: when eventually switching to CAMetalLayer, use the specialized
  // CAMetalDisplayLink instead of CADisplayLink!
  _sapp.macos.mtl_device = MTLCreateSystemDefaultDevice();
  _sapp.macos.view = [[_sapp_macos_view alloc] init];
  [_sapp.macos.view updateTrackingAreas];
  _sapp.macos.view.preferredFramesPerSecond = max_fps / _sapp.swap_interval;
  _sapp.macos.view.device = _sapp.macos.mtl_device;
  _sapp.macos.view.colorPixelFormat = MTLPixelFormatBGRA8Unorm;
  _sapp.macos.view.depthStencilPixelFormat =
      MTLPixelFormatDepth32Float_Stencil8;
  _sapp.macos.view.sampleCount = (NSUInteger)_sapp.sample_count;
  _sapp.macos.view.autoResizeDrawable = false;
  _sapp.macos.view.layer.magnificationFilter = kCAFilterNearest;
}

_SOKOL_PRIVATE void _sapp_macos_mtl_discard_state(void) {
  _SAPP_OBJC_RELEASE(_sapp.macos.mtl_device);
}

_SOKOL_PRIVATE bool
_sapp_macos_mtl_update_framebuffer_dimensions(NSRect view_bounds) {
  _sapp.framebuffer_width =
      _sapp_roundf_gzero(view_bounds.size.width * _sapp.dpi_scale);
  _sapp.framebuffer_height =
      _sapp_roundf_gzero(view_bounds.size.height * _sapp.dpi_scale);
  const CGSize cur_fb_size = _sapp.macos.view.drawableSize;
  int cur_fb_width = _sapp_roundf_gzero(cur_fb_size.width);
  int cur_fb_height = _sapp_roundf_gzero(cur_fb_size.height);
  bool dim_changed = (_sapp.framebuffer_width != cur_fb_width) ||
                     (_sapp.framebuffer_height != cur_fb_height);
  if (dim_changed) {
    const CGSize drawable_size = {(CGFloat)_sapp.framebuffer_width,
                                  (CGFloat)_sapp.framebuffer_height};
    _sapp.macos.view.drawableSize = drawable_size;
  }
  return dim_changed;
}
#endif

#if defined(SOKOL_GLCORE)
_SOKOL_PRIVATE void _sapp_macos_gl_init(NSRect window_rect) {
  NSOpenGLPixelFormatAttribute attrs[32];
  int i = 0;
  attrs[i++] = NSOpenGLPFAAccelerated;
  attrs[i++] = NSOpenGLPFADoubleBuffer;
  attrs[i++] = NSOpenGLPFAOpenGLProfile;
  const int glVersion =
      _sapp.desc.gl.major_version * 10 + _sapp.desc.gl.minor_version;
  switch (glVersion) {
  case 10:
    attrs[i++] = NSOpenGLProfileVersionLegacy;
    break;
  case 32:
    attrs[i++] = NSOpenGLProfileVersion3_2Core;
    break;
  case 41:
    attrs[i++] = NSOpenGLProfileVersion4_1Core;
    break;
  default:
    _SAPP_PANIC(MACOS_INVALID_NSOPENGL_PROFILE);
  }
  attrs[i++] = NSOpenGLPFAColorSize;
  attrs[i++] = 24;
  attrs[i++] = NSOpenGLPFAAlphaSize;
  attrs[i++] = 8;
  attrs[i++] = NSOpenGLPFADepthSize;
  attrs[i++] = 24;
  attrs[i++] = NSOpenGLPFAStencilSize;
  attrs[i++] = 8;
  if (_sapp.sample_count > 1) {
    attrs[i++] = NSOpenGLPFAMultisample;
    attrs[i++] = NSOpenGLPFASampleBuffers;
    attrs[i++] = 1;
    attrs[i++] = NSOpenGLPFASamples;
    attrs[i++] = (NSOpenGLPixelFormatAttribute)_sapp.sample_count;
  } else {
    attrs[i++] = NSOpenGLPFASampleBuffers;
    attrs[i++] = 0;
  }
  attrs[i++] = 0;
  NSOpenGLPixelFormat *glpixelformat_obj =
      [[NSOpenGLPixelFormat alloc] initWithAttributes:attrs];
  SOKOL_ASSERT(glpixelformat_obj != nil);

  _sapp.macos.view = [[_sapp_macos_view alloc] initWithFrame:window_rect
                                                 pixelFormat:glpixelformat_obj];
  _SAPP_OBJC_RELEASE(glpixelformat_obj);
  [_sapp.macos.view updateTrackingAreas];
  if (_sapp.desc.high_dpi) {
    [_sapp.macos.view setWantsBestResolutionOpenGLSurface:YES];
  } else {
    [_sapp.macos.view setWantsBestResolutionOpenGLSurface:NO];
  }

  NSTimer *timer_obj = [NSTimer timerWithTimeInterval:0.001
                                               target:_sapp.macos.view
                                             selector:@selector(timerFired:)
                                             userInfo:nil
                                              repeats:YES];
  [[NSRunLoop currentRunLoop] addTimer:timer_obj forMode:NSDefaultRunLoopMode];
  timer_obj = nil;
}

_SOKOL_PRIVATE void _sapp_macos_gl_discard_state(void) {
  // nothing to do here
}

_SOKOL_PRIVATE bool
_sapp_macos_gl_update_framebuffer_dimensions(NSRect view_bounds) {
  const int cur_fb_width =
      _sapp_roundf_gzero(view_bounds.size.width * _sapp.dpi_scale);
  const int cur_fb_height =
      _sapp_roundf_gzero(view_bounds.size.height * _sapp.dpi_scale);
  const bool dim_changed = (_sapp.framebuffer_width != cur_fb_width) ||
                           (_sapp.framebuffer_height != cur_fb_height);
  _sapp.framebuffer_width = cur_fb_width;
  _sapp.framebuffer_height = cur_fb_height;
  return dim_changed;
}
#endif

#if defined(SOKOL_WGPU)
_SOKOL_PRIVATE void _sapp_macos_wgpu_init(void) {
  NSInteger max_fps = _sapp_macos_max_fps();
  _sapp.macos.wgpu.mtl_layer = [CAMetalLayer layer];
  _sapp.macos.wgpu.mtl_layer.magnificationFilter = kCAFilterNearest;
  _sapp.macos.wgpu.mtl_layer.opaque = true;
  // NOTE: might experiment with this, valid values are 2 or 3 (default: 3), I
  // don't see any difference tbh
  // _sapp.macos.wgpu.mtl_layer.maximumDrawableCount = 2;
  _sapp.macos.view = [[_sapp_macos_view alloc] init];
  [_sapp.macos.view updateTrackingAreas];
  _sapp.macos.view.wantsLayer = YES;
  _sapp.macos.view.layer = _sapp.macos.wgpu.mtl_layer;
  _sapp.macos.wgpu.display_link =
      [_sapp.macos.view displayLinkWithTarget:_sapp.macos.view
                                     selector:@selector(displayLinkFired:)];
  float preferred_fps = max_fps / _sapp.swap_interval;
  CAFrameRateRange frame_rate_range = {preferred_fps, preferred_fps,
                                       preferred_fps};
  _sapp.macos.wgpu.display_link.preferredFrameRateRange = frame_rate_range;
  [_sapp.macos.wgpu.display_link addToRunLoop:[NSRunLoop currentRunLoop]
                                      forMode:NSRunLoopCommonModes];
  _sapp_wgpu_init();
}

_SOKOL_PRIVATE void _sapp_macos_wgpu_discard_state(void) {
  _SAPP_OBJC_RELEASE(_sapp.macos.wgpu.display_link);
  _SAPP_OBJC_RELEASE(_sapp.macos.wgpu.mtl_layer);
  _sapp_wgpu_discard();
}

_SOKOL_PRIVATE bool
_sapp_macos_wgpu_update_framebuffer_dimensions(NSRect view_bounds) {
  _sapp.framebuffer_width =
      _sapp_roundf_gzero(view_bounds.size.width * _sapp.dpi_scale);
  _sapp.framebuffer_height =
      _sapp_roundf_gzero(view_bounds.size.height * _sapp.dpi_scale);
  const CGSize cur_fb_size = _sapp.macos.wgpu.mtl_layer.drawableSize;
  int cur_fb_width = _sapp_roundf_gzero(cur_fb_size.width);
  int cur_fb_height = _sapp_roundf_gzero(cur_fb_size.height);
  bool dim_changed = (_sapp.framebuffer_width != cur_fb_width) ||
                     (_sapp.framebuffer_height != cur_fb_height);
  if (dim_changed) {
    const CGSize drawable_size = {(CGFloat)_sapp.framebuffer_width,
                                  (CGFloat)_sapp.framebuffer_height};
    _sapp.macos.wgpu.mtl_layer.drawableSize = drawable_size;
    _sapp_wgpu_swapchain_size_changed();
  }
  return dim_changed;
}
#endif

_SOKOL_PRIVATE void _sapp_macos_init_keytable(void) {
  _sapp.keycodes[0x1D] = SAPP_KEYCODE_0;
  _sapp.keycodes[0x12] = SAPP_KEYCODE_1;
  _sapp.keycodes[0x13] = SAPP_KEYCODE_2;
  _sapp.keycodes[0x14] = SAPP_KEYCODE_3;
  _sapp.keycodes[0x15] = SAPP_KEYCODE_4;
  _sapp.keycodes[0x17] = SAPP_KEYCODE_5;
  _sapp.keycodes[0x16] = SAPP_KEYCODE_6;
  _sapp.keycodes[0x1A] = SAPP_KEYCODE_7;
  _sapp.keycodes[0x1C] = SAPP_KEYCODE_8;
  _sapp.keycodes[0x19] = SAPP_KEYCODE_9;
  _sapp.keycodes[0x00] = SAPP_KEYCODE_A;
  _sapp.keycodes[0x0B] = SAPP_KEYCODE_B;
  _sapp.keycodes[0x08] = SAPP_KEYCODE_C;
  _sapp.keycodes[0x02] = SAPP_KEYCODE_D;
  _sapp.keycodes[0x0E] = SAPP_KEYCODE_E;
  _sapp.keycodes[0x03] = SAPP_KEYCODE_F;
  _sapp.keycodes[0x05] = SAPP_KEYCODE_G;
  _sapp.keycodes[0x04] = SAPP_KEYCODE_H;
  _sapp.keycodes[0x22] = SAPP_KEYCODE_I;
  _sapp.keycodes[0x26] = SAPP_KEYCODE_J;
  _sapp.keycodes[0x28] = SAPP_KEYCODE_K;
  _sapp.keycodes[0x25] = SAPP_KEYCODE_L;
  _sapp.keycodes[0x2E] = SAPP_KEYCODE_M;
  _sapp.keycodes[0x2D] = SAPP_KEYCODE_N;
  _sapp.keycodes[0x1F] = SAPP_KEYCODE_O;
  _sapp.keycodes[0x23] = SAPP_KEYCODE_P;
  _sapp.keycodes[0x0C] = SAPP_KEYCODE_Q;
  _sapp.keycodes[0x0F] = SAPP_KEYCODE_R;
  _sapp.keycodes[0x01] = SAPP_KEYCODE_S;
  _sapp.keycodes[0x11] = SAPP_KEYCODE_T;
  _sapp.keycodes[0x20] = SAPP_KEYCODE_U;
  _sapp.keycodes[0x09] = SAPP_KEYCODE_V;
  _sapp.keycodes[0x0D] = SAPP_KEYCODE_W;
  _sapp.keycodes[0x07] = SAPP_KEYCODE_X;
  _sapp.keycodes[0x10] = SAPP_KEYCODE_Y;
  _sapp.keycodes[0x06] = SAPP_KEYCODE_Z;
  _sapp.keycodes[0x27] = SAPP_KEYCODE_APOSTROPHE;
  _sapp.keycodes[0x2A] = SAPP_KEYCODE_BACKSLASH;
  _sapp.keycodes[0x2B] = SAPP_KEYCODE_COMMA;
  _sapp.keycodes[0x18] = SAPP_KEYCODE_EQUAL;
  _sapp.keycodes[0x32] = SAPP_KEYCODE_GRAVE_ACCENT;
  _sapp.keycodes[0x21] = SAPP_KEYCODE_LEFT_BRACKET;
  _sapp.keycodes[0x1B] = SAPP_KEYCODE_MINUS;
  _sapp.keycodes[0x2F] = SAPP_KEYCODE_PERIOD;
  _sapp.keycodes[0x1E] = SAPP_KEYCODE_RIGHT_BRACKET;
  _sapp.keycodes[0x29] = SAPP_KEYCODE_SEMICOLON;
  _sapp.keycodes[0x2C] = SAPP_KEYCODE_SLASH;
  _sapp.keycodes[0x0A] = SAPP_KEYCODE_WORLD_1;
  _sapp.keycodes[0x33] = SAPP_KEYCODE_BACKSPACE;
  _sapp.keycodes[0x39] = SAPP_KEYCODE_CAPS_LOCK;
  _sapp.keycodes[0x75] = SAPP_KEYCODE_DELETE;
  _sapp.keycodes[0x7D] = SAPP_KEYCODE_DOWN;
  _sapp.keycodes[0x77] = SAPP_KEYCODE_END;
  _sapp.keycodes[0x24] = SAPP_KEYCODE_ENTER;
  _sapp.keycodes[0x35] = SAPP_KEYCODE_ESCAPE;
  _sapp.keycodes[0x7A] = SAPP_KEYCODE_F1;
  _sapp.keycodes[0x78] = SAPP_KEYCODE_F2;
  _sapp.keycodes[0x63] = SAPP_KEYCODE_F3;
  _sapp.keycodes[0x76] = SAPP_KEYCODE_F4;
  _sapp.keycodes[0x60] = SAPP_KEYCODE_F5;
  _sapp.keycodes[0x61] = SAPP_KEYCODE_F6;
  _sapp.keycodes[0x62] = SAPP_KEYCODE_F7;
  _sapp.keycodes[0x64] = SAPP_KEYCODE_F8;
  _sapp.keycodes[0x65] = SAPP_KEYCODE_F9;
  _sapp.keycodes[0x6D] = SAPP_KEYCODE_F10;
  _sapp.keycodes[0x67] = SAPP_KEYCODE_F11;
  _sapp.keycodes[0x6F] = SAPP_KEYCODE_F12;
  _sapp.keycodes[0x69] = SAPP_KEYCODE_F13;
  _sapp.keycodes[0x6B] = SAPP_KEYCODE_F14;
  _sapp.keycodes[0x71] = SAPP_KEYCODE_F15;
  _sapp.keycodes[0x6A] = SAPP_KEYCODE_F16;
  _sapp.keycodes[0x40] = SAPP_KEYCODE_F17;
  _sapp.keycodes[0x4F] = SAPP_KEYCODE_F18;
  _sapp.keycodes[0x50] = SAPP_KEYCODE_F19;
  _sapp.keycodes[0x5A] = SAPP_KEYCODE_F20;
  _sapp.keycodes[0x73] = SAPP_KEYCODE_HOME;
  _sapp.keycodes[0x72] = SAPP_KEYCODE_INSERT;
  _sapp.keycodes[0x7B] = SAPP_KEYCODE_LEFT;
  _sapp.keycodes[0x3A] = SAPP_KEYCODE_LEFT_ALT;
  _sapp.keycodes[0x3B] = SAPP_KEYCODE_LEFT_CONTROL;
  _sapp.keycodes[0x38] = SAPP_KEYCODE_LEFT_SHIFT;
  _sapp.keycodes[0x37] = SAPP_KEYCODE_LEFT_SUPER;
  _sapp.keycodes[0x6E] = SAPP_KEYCODE_MENU;
  _sapp.keycodes[0x47] = SAPP_KEYCODE_NUM_LOCK;
  _sapp.keycodes[0x79] = SAPP_KEYCODE_PAGE_DOWN;
  _sapp.keycodes[0x74] = SAPP_KEYCODE_PAGE_UP;
  _sapp.keycodes[0x7C] = SAPP_KEYCODE_RIGHT;
  _sapp.keycodes[0x3D] = SAPP_KEYCODE_RIGHT_ALT;
  _sapp.keycodes[0x3E] = SAPP_KEYCODE_RIGHT_CONTROL;
  _sapp.keycodes[0x3C] = SAPP_KEYCODE_RIGHT_SHIFT;
  _sapp.keycodes[0x36] = SAPP_KEYCODE_RIGHT_SUPER;
  _sapp.keycodes[0x31] = SAPP_KEYCODE_SPACE;
  _sapp.keycodes[0x30] = SAPP_KEYCODE_TAB;
  _sapp.keycodes[0x7E] = SAPP_KEYCODE_UP;
  _sapp.keycodes[0x52] = SAPP_KEYCODE_KP_0;
  _sapp.keycodes[0x53] = SAPP_KEYCODE_KP_1;
  _sapp.keycodes[0x54] = SAPP_KEYCODE_KP_2;
  _sapp.keycodes[0x55] = SAPP_KEYCODE_KP_3;
  _sapp.keycodes[0x56] = SAPP_KEYCODE_KP_4;
  _sapp.keycodes[0x57] = SAPP_KEYCODE_KP_5;
  _sapp.keycodes[0x58] = SAPP_KEYCODE_KP_6;
  _sapp.keycodes[0x59] = SAPP_KEYCODE_KP_7;
  _sapp.keycodes[0x5B] = SAPP_KEYCODE_KP_8;
  _sapp.keycodes[0x5C] = SAPP_KEYCODE_KP_9;
  _sapp.keycodes[0x45] = SAPP_KEYCODE_KP_ADD;
  _sapp.keycodes[0x41] = SAPP_KEYCODE_KP_DECIMAL;
  _sapp.keycodes[0x4B] = SAPP_KEYCODE_KP_DIVIDE;
  _sapp.keycodes[0x4C] = SAPP_KEYCODE_KP_ENTER;
  _sapp.keycodes[0x51] = SAPP_KEYCODE_KP_EQUAL;
  _sapp.keycodes[0x43] = SAPP_KEYCODE_KP_MULTIPLY;
  _sapp.keycodes[0x4E] = SAPP_KEYCODE_KP_SUBTRACT;
}

_SOKOL_PRIVATE void _sapp_macos_discard_state(void) {
  // NOTE: it's safe to call [release] on a nil object
  if (_sapp.macos.keyup_monitor != nil) {
    [NSEvent removeMonitor:_sapp.macos.keyup_monitor];
    // NOTE: removeMonitor also releases the object
    _sapp.macos.keyup_monitor = nil;
  }
  _SAPP_OBJC_RELEASE(_sapp.macos.tracking_area);
  _SAPP_OBJC_RELEASE(_sapp.macos.app_dlg);
  _SAPP_OBJC_RELEASE(_sapp.macos.win_dlg);
  _SAPP_OBJC_RELEASE(_sapp.macos.view);
#if defined(SOKOL_METAL)
  _sapp_macos_mtl_discard_state();
#elif defined(SOKOL_GLCORE)
  _sapp_macos_gl_discard_state();
#elif defined(SOKOL_WGPU)
  _sapp_macos_wgpu_discard_state();
#endif
  _SAPP_OBJC_RELEASE(_sapp.macos.window);
}

// undocumented methods for creating cursors (see GLFW 3.4 and
// imgui_impl_osx.mm)
@interface NSCursor ()
+ (id)_windowResizeNorthWestSouthEastCursor;
+ (id)_windowResizeNorthEastSouthWestCursor;
+ (id)_windowResizeNorthSouthCursor;
+ (id)_windowResizeEastWestCursor;
@end

_SOKOL_PRIVATE void _sapp_macos_init_cursors(void) {
  for (size_t i = 0; i < _SAPP_MOUSECURSOR_NUM; i++) {
    _sapp.macos.standard_cursors[i] = nil;
    _sapp.macos.custom_cursors[i] = nil;
  }
  _sapp.macos.standard_cursors[SAPP_MOUSECURSOR_ARROW] = [NSCursor arrowCursor];
  _sapp.macos.standard_cursors[SAPP_MOUSECURSOR_IBEAM] = [NSCursor IBeamCursor];
  _sapp.macos.standard_cursors[SAPP_MOUSECURSOR_CROSSHAIR] =
      [NSCursor crosshairCursor];
  _sapp.macos.standard_cursors[SAPP_MOUSECURSOR_POINTING_HAND] =
      [NSCursor pointingHandCursor];
  _sapp.macos.standard_cursors[SAPP_MOUSECURSOR_RESIZE_EW] =
      [NSCursor respondsToSelector:@selector(_windowResizeEastWestCursor)]
          ? [NSCursor _windowResizeEastWestCursor]
          : [NSCursor resizeLeftRightCursor];
  _sapp.macos.standard_cursors[SAPP_MOUSECURSOR_RESIZE_NS] =
      [NSCursor respondsToSelector:@selector(_windowResizeNorthSouthCursor)]
          ? [NSCursor _windowResizeNorthSouthCursor]
          : [NSCursor resizeUpDownCursor];