@lampdotdev/lamp 0.0.0-stage → 0.36.2-nightly.16

package/Resources/GameKit/libraries/sokol_shape.h

@@ -0,0 +1,1531 @@
+#if defined(SOKOL_IMPL) && !defined(SOKOL_SHAPE_IMPL)
+#define SOKOL_SHAPE_IMPL
+#endif
+#ifndef SOKOL_SHAPE_INCLUDED
+/*
+    sokol_shape.h -- create simple primitive shapes for sokol_gfx.h
+
+    Project URL: https://github.com/floooh/sokol
+
+    Do this:
+        #define SOKOL_IMPL or
+        #define SOKOL_SHAPE_IMPL
+    before you include this file in *one* C or C++ file to create the
+    implementation.
+
+    Include the following headers before including sokol_shape.h:
+
+        sokol_gfx.h
+
+    ...optionally provide the following macros to override defaults:
+
+    SOKOL_ASSERT(c)     - your own assert macro (default: assert(c))
+    SOKOL_SHAPE_API_DECL- public function declaration prefix (default: extern)
+    SOKOL_API_DECL      - same as SOKOL_SHAPE_API_DECL
+    SOKOL_API_IMPL      - public function implementation prefix (default: -)
+
+    If sokol_shape.h is compiled as a DLL, define the following before
+    including the declaration or implementation:
+
+    SOKOL_DLL
+
+    On Windows, SOKOL_DLL will define SOKOL_SHAPE_API_DECL as __declspec(dllexport)
+    or __declspec(dllimport) as needed.
+
+    FEATURE OVERVIEW
+    ================
+    sokol_shape.h creates vertices and indices for simple shapes and
+    builds structs which can be plugged into sokol-gfx resource
+    creation functions:
+
+    The following shape types are supported:
+
+        - plane
+        - cube
+        - sphere (with poles, not geodesic)
+        - cylinder
+        - torus (donut)
+
+    Generated vertex components have the following format (all components
+    except position are optional):
+
+    - position: SG_VERTEXFORMAT_FLOAT3
+    - normal: SG_VERTEXFORMAT_BYTE4N
+    - texcoord: SG_VERTEXFORMAT_USHORT2N
+    - color: SG_VERTEXFORMAT_UBYTE4N
+
+    Indices are generally 16-bits wide (SG_INDEXTYPE_UINT16) and the indices
+    are written as triangle-lists (SG_PRIMITIVETYPE_TRIANGLES).
+
+    EXAMPLES:
+    =========
+
+    Create multiple shapes into the same vertex- and index-buffer and
+    render with separate draw calls:
+
+    https://github.com/floooh/sokol-samples/blob/master/sapp/shapes-sapp.c
+
+    Same as the above, but pre-transform shapes and merge them into a single
+    shape that's rendered with a single draw call.
+
+    https://github.com/floooh/sokol-samples/blob/master/sapp/shapes-transform-sapp.c
+
+    STEP-BY-STEP:
+    =============
+
+    Setup an sshape_state_t struct with pointers to memory buffers where
+    generated vertices and indices will be written to:
+
+    ```c
+    uint8_t vertices[512 * SSHAPE_MAX_VERTEX_SIZE];
+    uint16_t indices[4096];
+
+    sshape_state_t state = {
+        .vertices = { .buffer = SSHAPE_RANGE(vertices) },
+        .indices = { .buffer = SSHAPE_RANGE(indices) }
+    };
+    ```
+    This generates all vertex components. Optionally you can disable
+    vertex components to be generates:
+
+    ```c
+    sshape_state_t state = {
+        .disable {
+            .normals = false,
+            .texcoords = false,
+            .colors = false,
+        },
+        .vertices = { .buffer = SSHAPE_RANGE(vertices) },
+        .indices = { .buffer = SSHAPE_RANGE(indices) }
+    };
+    ```
+
+    Compute the per-vertex size in bytes via (note that the arguments
+    have inverted meaning from `sshape_state_t.disabled`, here you define
+    what components are enabled:
+
+    ```c
+    size_t vertex_size = sshape_vertex_size(&(sshape_optional_components_t){
+        .normals = true,
+        .texcoords = true,
+        .colors = true,
+    });
+    ```
+    This returns a value between SSHAPE_MIN_VERTEX_SIZE (12) and
+    SSHAPE_MAX_VERTEX_SIZE (24).
+
+    To find out how big the vertex and index memory buffers must be (in case you want
+    to allocate dynamically) call the following functions. For `vertex_size`
+    pass in the result of the `sshape_vertex_size` function:
+    ```c
+    sshape_sizes_t sshape_plane_sizes(uint32_t tiles, size_t vertex_size);
+    sshape_sizes_t sshape_box_sizes(uint32_t tiles, size_t vertex_size);
+    sshape_sizes_t sshape_sphere_sizes(uint32_t slices, uint32_t stacks, size_t vertex_size);
+    sshape_sizes_t sshape_cylinder_sizes(uint32_t slices, uint32_t stacks, size_t vertex_size);
+    sshape_sizes_t sshape_torus_sizes(uint32_t sides, uint32_t rings, size_t vertex_size);
+    ```
+
+    The returned sshape_sizes_t struct contains vertex- and index-counts
+    as well as the equivalent buffer sizes in bytes. For instance:
+
+    ```c
+    const vtx_size = sshape_vertex_size(&(sshape_optional_components){0});
+    sshape_sizes_t sizes = sshape_sphere_sizes(36, 12, vtx_size);
+    uint32_t num_vertices = sizes.vertices.num;
+    uint32_t num_indices = sizes.indices.num;
+    uint32_t vertex_buffer_size = sizes.vertices.size;
+    uint32_t index_buffer_size = sizes.indices.size;
+    ```
+
+    With the sshape_state_t struct that was setup earlier, call any
+    of the shape-builder functions:
+
+    ```c
+    void sshape_build_plane(sshape_state_t* state, const sshape_plane_t* params);
+    void sshape_build_box(sshape_state_t* state, const sshape_box_t* params);
+    void sshape_build_sphere(sshape_state_t* state, const sshape_sphere_t* params);
+    void sshape_build_cylinder(sshape_state_t* state, const sshape_cylinder_t* params);
+    void sshape_build_torus(sshape_state_t* state, const sshape_torus_t* params);
+    ```
+
+    Note that the `state` arg is a non-const pointer, this indicates
+    that the `sshape_state_t` struct will be mutated.
+
+    The second argument is a struct which holds creation parameters.
+
+    For instance to build a sphere with radius 2, 36 "cake slices" and 12 stacks:
+
+    ```c
+    sshape_state_t state = ...;
+    sshape_build_sphere(&state, &(sshape_sphere_t){
+        .radius = 2.0f,
+        .slices = 36,
+        .stacks = 12,
+    });
+    ```
+
+    If the provided buffers are big enough to hold all generated vertices and
+    indices, the "valid" field in the result will be true:
+
+    ```c
+    assert(state.valid);
+    ```
+
+    The shape creation parameters have "useful defaults", refer to the
+    actual C struct declarations below to look up those defaults.
+
+    You can also provide additional creation parameters, like a common vertex
+    color, a debug-helper to randomize colors, tell the shape builder function
+    to merge the new shape with the previous shape into the same draw-element-range,
+    or a 4x4 transform matrix to move, rotate and scale the generated vertices:
+
+    ```c
+    sshape_state_t state = ...;
+    sshape_build_sphere(&state, &(sshape_sphere_t){
+        .radius = 2.0f,
+        .slices = 36,
+        .stacks = 12,
+        // merge with previous shape into a single element-range
+        .merge = true,
+        // set vertex color to red+opaque
+        .color = sshape_color_4f(1.0f, 0.0f, 0.0f, 1.0f),
+        // set position to y = 2.0
+        .transform = {
+            .m = {
+                { 1.0f, 0.0f, 0.0f, 0.0f },
+                { 0.0f, 1.0f, 0.0f, 0.0f },
+                { 0.0f, 0.0f, 1.0f, 0.0f },
+                { 0.0f, 2.0f, 0.0f, 1.0f },
+            }
+        }
+    });
+    assert(state.valid);
+    ```
+
+    The following helper functions can be used to build a packed
+    color value or to convert from external matrix types:
+
+    ```c
+    uint32_t sshape_color_4f(float r, float g, float b, float a);
+    uint32_t sshape_color_3f(float r, float g, float b);
+    uint32_t sshape_color_4b(uint8_t r, uint8_t g, uint8_t b, uint8_t a);
+    uint32_t sshape_color_3b(uint8_t r, uint8_t g, uint8_t b);
+    sshape_mat4_t sshape_mat4(const float m[16]);
+    sshape_mat4_t sshape_mat4_transpose(const float m[16]);
+    ```
+
+    After the shape builder function has been called, the following functions
+    are used to extract the build result for plugging into sokol_gfx.h:
+
+    ```c
+    sshape_element_range_t sshape_element_range(const sshape_state_t* state);
+    sg_buffer_desc sshape_vertex_buffer_desc(const sshape_state_t* state);
+    sg_buffer_desc sshape_index_buffer_desc(const sshape_state_t* state);
+    sg_vertex_buffer_layout_state sshape_vertex_buffer_layout_state(const sshape_state_t* state);
+    sg_vertex_attr_state sshape_position_vertex_attr_state(const sshape_state_t* state);
+    sg_vertex_attr_state sshape_normal_vertex_attr_state(consts sshape_state_t* state);
+    sg_vertex_attr_state sshape_texcoord_vertex_attr_state(const sshape_state_t* state);
+    sg_vertex_attr_state sshape_color_vertex_attr_state(const sshape_state_t* state);
+    ```
+
+    The sshape_element_range_t struct contains the base-index and number of
+    indices which can be plugged into the sg_draw() call:
+
+    ```c
+    sshape_element_range_t elms = sshape_element_range(&state);
+    ...
+    sg_draw(elms.base_element, elms.num_elements, 1);
+    ```
+
+    To create sokol-gfx vertex- and index-buffers from the generated
+    shape data:
+
+    ```c
+    // create sokol-gfx vertex buffer
+    sg_buffer_desc vbuf_desc = sshape_vertex_buffer_desc(&state);
+    sg_buffer vbuf = sg_make_buffer(&vbuf_desc);
+
+    // create sokol-gfx index buffer
+    sg_buffer_desc ibuf_desc = sshape_index_buffer_desc(&state);
+    sg_buffer ibuf = sg_make_buffer(&ibuf_desc);
+    ```
+
+    The remaining functions are used to populate the vertex-layout item
+    in sg_pipeline_desc:
+
+    ```c
+    sg_pipeline pip = sg_make_pipeline(&(sg_pipeline_desc){
+        .layout = {
+            .buffers[0] = sshape_vertex_buffer_layout_state(&state),
+            .attrs = {
+                [0] = sshape_position_vertex_attr_state(&state),
+                [1] = sshape_normal_vertex_attr_state(&state),
+                [2] = sshape_texcoord_vertex_attr_state(&state),
+                [3] = sshape_color_vertex_attr_state(&state)
+            }
+        },
+        ...
+    });
+    ```
+    Note that you don't have to use all generated vertex attributes in the
+    pipeline's vertex layout, the sg_vertex_buffer_layout_state struct returned
+    by sshape_vertex_buffer_layout_state() contains the correct vertex stride
+    to skip vertex components.
+
+    WRITING MULTIPLE SHAPES INTO THE SAME BUFFER
+    ============================================
+    You can merge multiple shapes into the same vertex- and
+    index-buffers and either render them as a single shape, or
+    in separate draw calls.
+
+    To build a single shape made of two cubes which can be rendered
+    in a single draw-call:
+
+    ```
+    uint8_t vertices[128 * SSHAPE_MAX_VERTEX_SIZE];
+    uint16_t indices[16];
+
+    sshape_state_t state = {
+        .vertices.buffer = SSHAPE_RANGE(vertices),
+        .indices.buffer  = SSHAPE_RANGE(indices)
+    };
+
+    // first cube at pos x=-2.0 (with default size of 1x1x1)
+    sshape_build_cube(&state, &(sshape_box_t){
+        .transform = {
+            .m = {
+                { 1.0f, 0.0f, 0.0f, 0.0f },
+                { 0.0f, 1.0f, 0.0f, 0.0f },
+                { 0.0f, 0.0f, 1.0f, 0.0f },
+                {-2.0f, 0.0f, 0.0f, 1.0f },
+            }
+        }
+    });
+    // ...and append another cube at pos pos=+1.0
+    // NOTE the .merge = true, this tells the shape builder
+    // function to not advance the current shape start offset
+    sshape_build_cube(&state, &(sshape_box_t){
+        .merge = true,
+        .transform = {
+            .m = {
+                { 1.0f, 0.0f, 0.0f, 0.0f },
+                { 0.0f, 1.0f, 0.0f, 0.0f },
+                { 0.0f, 0.0f, 1.0f, 0.0f },
+                {-2.0f, 0.0f, 0.0f, 1.0f },
+            }
+        }
+    });
+    assert(state.valid);
+
+    // skipping buffer- and pipeline-creation...
+
+    sshape_element_range_t elms = sshape_element_range(&state);
+    sg_draw(elms.base_element, elms.num_elements, 1);
+    ```
+
+    To render the two cubes in separate draw-calls, the element-ranges used
+    in the sg_draw() calls must be captured right after calling the
+    builder-functions:
+
+    ```c
+    uint8_t vertices[128 * SSHAPE_MAX_VERTEX_SIZE];
+    uint16_t indices[16];
+    sshape_state_t state = {
+        .vertices.buffer = SSHAPE_RANGE(vertices),
+        .indices.buffer = SSHAPE_RANGE(indices)
+    };
+
+    // build a red cube...
+    sshape_build_cube(&state, &(sshape_box_t){
+        .color = sshape_color_3b(255, 0, 0)
+    });
+    sshape_element_range_t red_cube = sshape_element_range(&state);
+
+    // append a green cube to the same vertex-/index-buffer:
+    sshape_build_cube(&state, &sshape_box_t){
+        .color = sshape_color_3b(0, 255, 0);
+    });
+    sshape_element_range_t green_cube = sshape_element_range(&state);
+
+    // skipping buffer- and pipeline-creation...
+
+    sg_draw(red_cube.base_element, red_cube.num_elements, 1);
+    sg_draw(green_cube.base_element, green_cube.num_elements, 1);
+    ```
+
+    ...that's about all :)
+
+    LICENSE
+    =======
+    zlib/libpng license
+
+    Copyright (c) 2020 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_SHAPE_INCLUDED
+#include <stddef.h>     // size_t, offsetof
+#include <stdint.h>
+#include <stdbool.h>
+
+#if !defined(SOKOL_GFX_INCLUDED)
+#error "Please include sokol_gfx.h before sokol_shape.h"
+#endif
+
+#if defined(SOKOL_API_DECL) && !defined(SOKOL_SHAPE_API_DECL)
+#define SOKOL_SHAPE_API_DECL SOKOL_API_DECL
+#endif
+#ifndef SOKOL_SHAPE_API_DECL
+#if defined(_WIN32) && defined(SOKOL_DLL) && defined(SOKOL_SHAPE_IMPL)
+#define SOKOL_SHAPE_API_DECL __declspec(dllexport)
+#elif defined(_WIN32) && defined(SOKOL_DLL)
+#define SOKOL_SHAPE_API_DECL __declspec(dllimport)
+#else
+#define SOKOL_SHAPE_API_DECL extern
+#endif
+#endif
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*
+    sshape_range_t is a pointer-size-pair struct used to pass memory
+    blobs into sokol-shape. When initialized from a value type
+    (array or struct), use the SSHAPE_RANGE() macro to build
+    an sshape_range struct.
+*/
+typedef struct sshape_range_t {
+    const void* ptr;
+    size_t size;
+} sshape_range_t;
+
+// disabling this for every includer isn't great, but the warning is 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' */
+#endif
+#if defined(__cplusplus)
+#define SSHAPE_RANGE(x) sshape_range_t{ &x, sizeof(x) }
+#else
+#define SSHAPE_RANGE(x) (sshape_range_t){ &x, sizeof(x) }
+#endif
+
+enum {
+    // the minumum vertex size in bytes (when no optional components are used)
+    SSHAPE_MIN_VERTEX_SIZE = 12,
+    // the maximum vertex size in bytes (when all optional components are used)
+    SSHAPE_MAX_VERTEX_SIZE = 24,
+};
+
+// a 4x4 matrix wrapper struct
+typedef struct sshape_mat4_t { float m[4][4]; } sshape_mat4_t;
+
+// a struct for configuring optional vertex components
+typedef struct sshape_optional_components_t {
+    bool normals;
+    bool texcoords;
+    bool colors;
+} sshape_optional_components_t;
+
+// a range of draw-elements (sg_draw(int base_element, int num_element, ...))
+typedef struct sshape_element_range_t {
+    int base_element;
+    int num_elements;
+} sshape_element_range_t;
+
+// number of elements and byte size of build actions
+typedef struct sshape_sizes_item_t {
+    uint32_t num;       // number of elements
+    uint32_t size;      // the same as size in bytes
+} sshape_sizes_item_t;
+
+typedef struct sshape_sizes_t {
+    sshape_sizes_item_t vertices;
+    sshape_sizes_item_t indices;
+} sshape_sizes_t;
+
+// in/out struct to keep track of mesh-build state
+typedef struct sshape_buffer_state_t {
+    sshape_range_t buffer;  // pointer/size pair of output buffer
+    size_t data_size;       // size in bytes of valid data in buffer
+    size_t shape_offset;    // data offset of the most recent shape
+} sshape_buffer_state_t;
+
+typedef struct sshape_state_t {
+    bool valid;
+    sshape_optional_components_t disable;
+    sshape_buffer_state_t vertices; // memory buffer for vertex data
+    sshape_buffer_state_t indices;   // memory buffer for index data
+} sshape_state_t;
+
+// creation parameters for the different shape types
+typedef struct sshape_plane_t {
+    float width, depth;             // default: 1.0
+    uint16_t tiles;                 // default: 1
+    uint32_t color;                 // default: white
+    bool random_colors;             // default: false
+    bool merge;                     // if true merge with previous shape (default: false)
+    sshape_mat4_t transform;        // default: identity matrix
+} sshape_plane_t;
+
+typedef struct sshape_box_t {
+    float width, height, depth;     // default: 1.0
+    uint16_t tiles;                 // default: 1
+    uint32_t color;                 // default: white
+    bool random_colors;             // default: false
+    bool merge;                     // if true merge with previous shape (default: false)
+    sshape_mat4_t transform;        // default: identity matrix
+} sshape_box_t;
+
+typedef struct sshape_sphere_t {
+    float radius;                   // default: 0.5
+    uint16_t slices;                // default: 5
+    uint16_t stacks;                // default: 4
+    uint32_t color;                 // default: white
+    bool random_colors;             // default: false
+    bool merge;                     // if true merge with previous shape (default: false)
+    sshape_mat4_t transform;        // default: identity matrix
+} sshape_sphere_t;
+
+typedef struct sshape_cylinder_t {
+    float radius;                   // default: 0.5
+    float height;                   // default: 1.0
+    uint16_t slices;                // default: 5
+    uint16_t stacks;                // default: 1
+    uint32_t color;                 // default: white
+    bool random_colors;             // default: false
+    bool merge;                     // if true merge with previous shape (default: false)
+    sshape_mat4_t transform;        // default: identity matrix
+} sshape_cylinder_t;
+
+typedef struct sshape_torus_t {
+    float radius;                   // default: 0.5f
+    float ring_radius;              // default: 0.2f
+    uint16_t sides;                 // default: 5
+    uint16_t rings;                 // default: 5
+    uint32_t color;                 // default: white
+    bool random_colors;             // default: false
+    bool merge;                     // if true merge with previous shape (default: false)
+    sshape_mat4_t transform;        // default: identity matrix
+} sshape_torus_t;
+
+// shape builder functions
+SOKOL_SHAPE_API_DECL void sshape_build_plane(sshape_state_t* state, const sshape_plane_t* params);
+SOKOL_SHAPE_API_DECL void sshape_build_box(sshape_state_t* state, const sshape_box_t* params);
+SOKOL_SHAPE_API_DECL void sshape_build_sphere(sshape_state_t* state, const sshape_sphere_t* params);
+SOKOL_SHAPE_API_DECL void sshape_build_cylinder(sshape_state_t* state, const sshape_cylinder_t* params);
+SOKOL_SHAPE_API_DECL void sshape_build_torus(sshape_state_t* state, const sshape_torus_t* params);
+
+// compute size of vertex given optional components
+SOKOL_SHAPE_API_DECL size_t sshape_vertex_size(const sshape_optional_components_t* components);
+
+// query required vertex- and index-buffer sizes in bytes
+SOKOL_SHAPE_API_DECL sshape_sizes_t sshape_plane_sizes(uint32_t tiles, size_t vertex_size);
+SOKOL_SHAPE_API_DECL sshape_sizes_t sshape_box_sizes(uint32_t tiles, size_t vertex_size);
+SOKOL_SHAPE_API_DECL sshape_sizes_t sshape_sphere_sizes(uint32_t slices, uint32_t stacks, size_t vertex_size);
+SOKOL_SHAPE_API_DECL sshape_sizes_t sshape_cylinder_sizes(uint32_t slices, uint32_t stacks, size_t vertex_size);
+SOKOL_SHAPE_API_DECL sshape_sizes_t sshape_torus_sizes(uint32_t sides, uint32_t rings, size_t vertex_size);
+
+// extract sokol-gfx desc structs and primitive ranges from build state
+SOKOL_SHAPE_API_DECL sshape_element_range_t sshape_element_range(const sshape_state_t* state);
+SOKOL_SHAPE_API_DECL sg_buffer_desc sshape_vertex_buffer_desc(const sshape_state_t* state);
+SOKOL_SHAPE_API_DECL sg_buffer_desc sshape_index_buffer_desc(const sshape_state_t* state);
+SOKOL_SHAPE_API_DECL sg_vertex_buffer_layout_state sshape_vertex_buffer_layout_state(const sshape_state_t* state);
+SOKOL_SHAPE_API_DECL sg_vertex_attr_state sshape_position_vertex_attr_state(const sshape_state_t* state);
+SOKOL_SHAPE_API_DECL sg_vertex_attr_state sshape_normal_vertex_attr_state(const sshape_state_t* state);
+SOKOL_SHAPE_API_DECL sg_vertex_attr_state sshape_texcoord_vertex_attr_state(const sshape_state_t* state);
+SOKOL_SHAPE_API_DECL sg_vertex_attr_state sshape_color_vertex_attr_state(const sshape_state_t* state);
+
+// helper functions to build packed color value from floats or bytes
+SOKOL_SHAPE_API_DECL uint32_t sshape_color_4f(float r, float g, float b, float a);
+SOKOL_SHAPE_API_DECL uint32_t sshape_color_3f(float r, float g, float b);
+SOKOL_SHAPE_API_DECL uint32_t sshape_color_4b(uint8_t r, uint8_t g, uint8_t b, uint8_t a);
+SOKOL_SHAPE_API_DECL uint32_t sshape_color_3b(uint8_t r, uint8_t g, uint8_t b);
+
+// adapter function for filling matrix struct from generic float[16] array
+SOKOL_SHAPE_API_DECL sshape_mat4_t sshape_mat4(const float m[16]);
+SOKOL_SHAPE_API_DECL sshape_mat4_t sshape_mat4_transpose(const float m[16]);
+
+#ifdef __cplusplus
+} // extern "C"
+
+// FIXME: C++ helper functions
+
+#endif
+#endif // SOKOL_SHAPE_INCLUDED
+
+/*-- IMPLEMENTATION ----------------------------------------------------------*/
+#ifdef SOKOL_SHAPE_IMPL
+#define SOKOL_SHAPE_IMPL_INCLUDED (1)
+
+#include <string.h> // memcpy
+#include <math.h>   // sinf, cosf
+
+#ifdef __clang__
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wmissing-field-initializers"
+#endif
+
+#ifndef SOKOL_API_IMPL
+    #define SOKOL_API_IMPL
+#endif
+#ifndef SOKOL_ASSERT
+    #include <assert.h>
+    #define SOKOL_ASSERT(c) assert(c)
+#endif
+
+#define _sshape_def(val, def) (((val) == 0) ? (def) : (val))
+#define _sshape_def_flt(val, def) (((val) == 0.0f) ? (def) : (val))
+#define _sshape_white (0xFFFFFFFF)
+
+typedef struct { float x, y, z, w; } _sshape_vec4_t;
+typedef struct { float x, y; } _sshape_vec2_t;
+
+static inline float _sshape_clamp(float v) {
+    if (v < 0.0f) return 0.0f;
+    else if (v > 1.0f) return 1.0f;
+    else return v;
+}
+
+static inline uint32_t _sshape_pack_ub4_ubyte4n(uint8_t x, uint8_t y, uint8_t z, uint8_t w) {
+    return (uint32_t)(((uint32_t)w<<24)|((uint32_t)z<<16)|((uint32_t)y<<8)|x);
+}
+
+static inline uint32_t _sshape_pack_f4_ubyte4n(float x, float y, float z, float w) {
+    uint8_t x8 = (uint8_t) (x * 255.0f);
+    uint8_t y8 = (uint8_t) (y * 255.0f);
+    uint8_t z8 = (uint8_t) (z * 255.0f);
+    uint8_t w8 = (uint8_t) (w * 255.0f);
+    return _sshape_pack_ub4_ubyte4n(x8, y8, z8, w8);
+}
+
+static inline uint32_t _sshape_pack_f4_byte4n(float x, float y, float z, float w) {
+    int8_t x8 = (int8_t) (x * 127.0f);
+    int8_t y8 = (int8_t) (y * 127.0f);
+    int8_t z8 = (int8_t) (z * 127.0f);
+    int8_t w8 = (int8_t) (w * 127.0f);
+    return _sshape_pack_ub4_ubyte4n((uint8_t)x8, (uint8_t)y8, (uint8_t)z8, (uint8_t)w8);
+}
+
+static inline uint16_t _sshape_pack_f_ushortn(float x) {
+    return (uint16_t) (x * 65535.0f);
+}
+
+static inline _sshape_vec4_t _sshape_vec4(float x, float y, float z, float w) {
+    _sshape_vec4_t v = { x, y, z, w };
+    return v;
+}
+
+static inline _sshape_vec4_t _sshape_vec4_norm(_sshape_vec4_t v) {
+    float l = sqrtf(v.x*v.x + v.y*v.y + v.z*v.z + v.w*v.w);
+    if (l != 0.0f) {
+        return _sshape_vec4(v.x/l, v.y/l, v.z/l, v.w/l);
+    }
+    else {
+        return _sshape_vec4(0.0f, 1.0f, 0.0f, 0.0f);
+    }
+}
+
+static inline _sshape_vec2_t _sshape_vec2(float x, float y) {
+    _sshape_vec2_t v = { x, y };
+    return v;
+}
+
+static bool _sshape_mat4_isnull(const sshape_mat4_t* m) {
+    for (int y = 0; y < 4; y++) {
+        for (int x = 0; x < 4; x++) {
+            if (0.0f != m->m[y][x]) {
+                return false;
+            }
+        }
+    }
+    return true;
+}
+
+static sshape_mat4_t _sshape_mat4_identity(void) {
+    sshape_mat4_t m = {
+        {
+            { 1.0f, 0.0f, 0.0f, 0.0f },
+            { 0.0f, 1.0f, 0.0f, 0.0f },
+            { 0.0f, 0.0f, 1.0f, 0.0f },
+            { 0.0f, 0.0f, 0.0f, 1.0f }
+        }
+    };
+    return m;
+}
+
+static _sshape_vec4_t _sshape_mat4_mul(const sshape_mat4_t* m, _sshape_vec4_t v) {
+    _sshape_vec4_t res = {
+        m->m[0][0]*v.x + m->m[1][0]*v.y + m->m[2][0]*v.z + m->m[3][0]*v.w,
+        m->m[0][1]*v.x + m->m[1][1]*v.y + m->m[2][1]*v.z + m->m[3][1]*v.w,
+        m->m[0][2]*v.x + m->m[1][2]*v.y + m->m[2][2]*v.z + m->m[3][2]*v.w,
+        m->m[0][3]*v.x + m->m[1][3]*v.y + m->m[2][3]*v.z + m->m[3][3]*v.w
+    };
+    return res;
+}
+
+static uint32_t _sshape_plane_num_vertices(uint32_t tiles) {
+    return (tiles + 1) * (tiles + 1);
+}
+
+static uint32_t _sshape_plane_num_indices(uint32_t tiles) {
+    return tiles * tiles * 2 * 3;
+}
+
+static uint32_t _sshape_box_num_vertices(uint32_t tiles) {
+    return (tiles + 1) * (tiles + 1) * 6;
+}
+
+static uint32_t _sshape_box_num_indices(uint32_t tiles) {
+    return tiles * tiles * 2 * 6 * 3;
+}
+
+static uint32_t _sshape_sphere_num_vertices(uint32_t slices, uint32_t stacks) {
+    return (slices + 1) * (stacks + 1);
+}
+
+static uint32_t _sshape_sphere_num_indices(uint32_t slices, uint32_t stacks) {
+    return ((2 * slices * stacks) - (2 * slices)) * 3;
+}
+
+static uint32_t _sshape_cylinder_num_vertices(uint32_t slices, uint32_t stacks) {
+    return (slices + 1) * (stacks + 5);
+}
+
+static uint32_t _sshape_cylinder_num_indices(uint32_t slices, uint32_t stacks) {
+    return ((2 * slices * stacks) + (2 * slices)) * 3;
+}
+
+static uint32_t _sshape_torus_num_vertices(uint32_t sides, uint32_t rings) {
+    return (sides + 1) * (rings + 1);
+}
+
+static uint32_t _sshape_torus_num_indices(uint32_t sides, uint32_t rings) {
+    return sides * rings * 2 * 3;
+}
+
+static bool _sshape_validate_buffer_state(const sshape_buffer_state_t* state, uint32_t build_size) {
+    if (0 == state->buffer.ptr) {
+        return false;
+    }
+    if (0 == state->buffer.size) {
+        return false;
+    }
+    if ((state->data_size + build_size) > state->buffer.size) {
+        return false;
+    }
+    if (state->shape_offset > state->data_size) {
+        return false;
+    }
+    return true;
+}
+
+static uint32_t _sshape_vertex_size(bool has_normals, bool has_texcoords, bool has_colors) {
+    uint32_t s = 3 * (uint32_t)sizeof(float);
+    if (has_normals) {
+        s += (uint32_t)sizeof(uint32_t);
+    }
+    if (has_texcoords) {
+        s += 2 * (uint32_t)sizeof(uint16_t);
+    }
+    if (has_colors) {
+        s += (uint32_t)sizeof(uint32_t);
+    }
+    return s;
+}
+
+static int _sshape_vertex_position_offset(const sshape_state_t* state) {
+    (void)state;
+    return 0;
+}
+
+static int _sshape_vertex_normal_offset(const sshape_state_t* state) {
+    SOKOL_ASSERT(!state->disable.normals); (void)state;
+    return (int)(3 * sizeof(float));
+}
+
+static int _sshape_vertex_texcoord_offset(const sshape_state_t* state) {
+    SOKOL_ASSERT(!state->disable.texcoords);
+    int offset = 3 * sizeof(float);
+    if (!state->disable.normals) {
+        offset += (int)sizeof(uint32_t);
+    }
+    return offset;
+}
+
+static int _sshape_vertex_color_offset(const sshape_state_t* state) {
+    SOKOL_ASSERT(!state->disable.colors);
+    int offset = 3 * sizeof(float);
+    if (!state->disable.normals) {
+        offset += (int)sizeof(uint32_t);
+    }
+    if (!state->disable.texcoords) {
+        offset += (int)(2 * sizeof(uint16_t));
+    }
+    return offset;
+}
+
+static uint32_t _sshape_vertex_size_from_state(const sshape_state_t* state) {
+    const bool has_normals = !state->disable.normals;
+    const bool has_texcoords = !state->disable.texcoords;
+    const bool has_colors = !state->disable.colors;
+    return _sshape_vertex_size(has_normals, has_texcoords, has_colors);
+}
+
+static bool _sshape_validate_state(const sshape_state_t* state, uint32_t num_vertices, uint32_t num_indices) {
+    const uint32_t vertex_size = (uint32_t)_sshape_vertex_size_from_state(state);
+    if (!_sshape_validate_buffer_state(&state->vertices, num_vertices * vertex_size)) {
+        return false;
+    }
+    if (!_sshape_validate_buffer_state(&state->indices, num_indices * sizeof(uint16_t))) {
+        return false;
+    }
+    return true;
+}
+
+static void _sshape_advance_offset(sshape_buffer_state_t* state) {
+    state->shape_offset = state->data_size;
+}
+
+static uint16_t _sshape_base_index(const sshape_state_t* state) {
+    const size_t vertex_size = _sshape_vertex_size_from_state(state);
+    const size_t base_index = state->vertices.data_size / vertex_size;
+    SOKOL_ASSERT(base_index <= 0xFFFF);
+    return (uint16_t)base_index;
+}
+
+static sshape_plane_t _sshape_plane_defaults(const sshape_plane_t* params) {
+    sshape_plane_t res = *params;
+    res.width = _sshape_def_flt(res.width, 1.0f);
+    res.depth = _sshape_def_flt(res.depth, 1.0f);
+    res.tiles = _sshape_def(res.tiles, 1);
+    res.color = _sshape_def(res.color, _sshape_white);
+    res.transform = _sshape_mat4_isnull(&res.transform) ? _sshape_mat4_identity() : res.transform;
+    return res;
+}
+
+static sshape_box_t _sshape_box_defaults(const sshape_box_t* params) {
+    sshape_box_t res = *params;
+    res.width = _sshape_def_flt(res.width, 1.0f);
+    res.height = _sshape_def_flt(res.height, 1.0f);
+    res.depth = _sshape_def_flt(res.depth, 1.0f);
+    res.tiles = _sshape_def(res.tiles, 1);
+    res.color = _sshape_def(res.color, _sshape_white);
+    res.transform = _sshape_mat4_isnull(&res.transform) ? _sshape_mat4_identity() : res.transform;
+    return res;
+}
+
+static sshape_sphere_t _sshape_sphere_defaults(const sshape_sphere_t* params) {
+    sshape_sphere_t res = *params;
+    res.radius = _sshape_def_flt(res.radius, 0.5f);
+    res.slices = _sshape_def(res.slices, 5);
+    res.stacks = _sshape_def(res.stacks, 4);
+    res.color = _sshape_def(res.color, _sshape_white);
+    res.transform = _sshape_mat4_isnull(&res.transform) ? _sshape_mat4_identity() : res.transform;
+    return res;
+}
+
+static sshape_cylinder_t _sshape_cylinder_defaults(const sshape_cylinder_t* params) {
+    sshape_cylinder_t res = *params;
+    res.radius = _sshape_def_flt(res.radius, 0.5f);
+    res.height = _sshape_def_flt(res.height, 1.0f);
+    res.slices = _sshape_def(res.slices, 5);
+    res.stacks = _sshape_def(res.stacks, 1);
+    res.color = _sshape_def(res.color, _sshape_white);
+    res.transform = _sshape_mat4_isnull(&res.transform) ? _sshape_mat4_identity() : res.transform;
+    return res;
+}
+
+static sshape_torus_t _sshape_torus_defaults(const sshape_torus_t* params) {
+    sshape_torus_t res = *params;
+    res.radius = _sshape_def_flt(res.radius, 0.5f);
+    res.ring_radius = _sshape_def_flt(res.ring_radius, 0.2f);
+    res.sides = _sshape_def(res.sides, 5);
+    res.rings = _sshape_def(res.rings, 5);
+    res.color = _sshape_def(res.color, _sshape_white);
+    res.transform = _sshape_mat4_isnull(&res.transform) ? _sshape_mat4_identity() : res.transform;
+    return res;
+}
+
+static void _sshape_add_vertex(sshape_state_t* state, _sshape_vec4_t pos, _sshape_vec4_t norm, _sshape_vec2_t uv, uint32_t color) {
+    size_t offset = state->vertices.data_size;
+    const size_t vertex_size = _sshape_vertex_size_from_state(state);
+    SOKOL_ASSERT((offset + vertex_size) <= state->vertices.buffer.size);
+    state->vertices.data_size += vertex_size;
+    uint8_t* dst_ptr = (uint8_t*)state->vertices.buffer.ptr + offset;
+    *(float*)dst_ptr = pos.x; dst_ptr += sizeof(float);
+    *(float*)dst_ptr = pos.y; dst_ptr += sizeof(float);
+    *(float*)dst_ptr = pos.z; dst_ptr += sizeof(float);
+    if (!state->disable.normals) {
+        *(uint32_t*)dst_ptr = _sshape_pack_f4_byte4n(norm.x, norm.y, norm.z, norm.w); dst_ptr += sizeof(uint32_t);
+    }
+    if (!state->disable.texcoords) {
+        *(uint16_t*)dst_ptr = _sshape_pack_f_ushortn(uv.x); dst_ptr += sizeof(uint16_t);
+        *(uint16_t*)dst_ptr = _sshape_pack_f_ushortn(uv.y); dst_ptr += sizeof(uint16_t);
+    }
+    if (!state->disable.colors) {
+        *(uint32_t*)dst_ptr = color; dst_ptr += sizeof(uint32_t);
+    }
+}
+
+static void _sshape_add_triangle(sshape_state_t* state, uint16_t i0, uint16_t i1, uint16_t i2) {
+    size_t offset = state->indices.data_size;
+    SOKOL_ASSERT((offset + 3*sizeof(uint16_t)) <= state->indices.buffer.size);
+    state->indices.data_size += 3*sizeof(uint16_t);
+    uint16_t* i_ptr = (uint16_t*) ((uint8_t*)state->indices.buffer.ptr + offset);
+    i_ptr[0] = i0;
+    i_ptr[1] = i1;
+    i_ptr[2] = i2;
+}
+
+static uint32_t _sshape_rand_color(uint32_t* xorshift_state) {
+    // xorshift32
+    uint32_t x = *xorshift_state;
+    x ^= x<<13;
+    x ^= x>>17;
+    x ^= x<<5;
+    *xorshift_state = x;
+
+    // rand => bright color with alpha 1.0
+    x |= 0xFF000000;
+    return x;
+
+}
+
+/*=== PUBLIC API FUNCTIONS ===================================================*/
+SOKOL_API_IMPL uint32_t sshape_color_4f(float r, float g, float b, float a) {
+    return _sshape_pack_f4_ubyte4n(_sshape_clamp(r), _sshape_clamp(g), _sshape_clamp(b), _sshape_clamp(a));
+}
+
+SOKOL_API_IMPL uint32_t sshape_color_3f(float r, float g, float b) {
+    return _sshape_pack_f4_ubyte4n(_sshape_clamp(r), _sshape_clamp(g), _sshape_clamp(b), 1.0f);
+}
+
+SOKOL_API_IMPL uint32_t sshape_color_4b(uint8_t r, uint8_t g, uint8_t b, uint8_t a) {
+    return _sshape_pack_ub4_ubyte4n(r, g, b, a);
+}
+
+SOKOL_API_IMPL uint32_t sshape_color_3b(uint8_t r, uint8_t g, uint8_t b) {
+    return _sshape_pack_ub4_ubyte4n(r, g, b, 255);
+}
+
+SOKOL_API_IMPL sshape_mat4_t sshape_mat4(const float m[16]) {
+    sshape_mat4_t res;
+    memcpy(&res.m[0][0], &m[0], 64);
+    return res;
+}
+
+SOKOL_API_IMPL sshape_mat4_t sshape_mat4_transpose(const float m[16]) {
+    sshape_mat4_t res;
+    for (int c = 0; c < 4; c++) {
+        for (int r = 0; r < 4; r++) {
+            res.m[r][c] = m[c*4 + r];
+        }
+    }
+    return res;
+}
+
+SOKOL_API_IMPL size_t sshape_vertex_size(const sshape_optional_components_t* comps) {
+    SOKOL_ASSERT(comps);
+    return _sshape_vertex_size(comps->normals, comps->texcoords, comps->colors);
+}
+
+SOKOL_API_IMPL sshape_sizes_t sshape_plane_sizes(uint32_t tiles, size_t vertex_size) {
+    SOKOL_ASSERT(tiles >= 1);
+    SOKOL_ASSERT((vertex_size >= SSHAPE_MIN_VERTEX_SIZE) && (vertex_size <= SSHAPE_MAX_VERTEX_SIZE));
+    sshape_sizes_t res = { {0} };
+    res.vertices.num = _sshape_plane_num_vertices(tiles);
+    res.indices.num = _sshape_plane_num_indices(tiles);
+    res.vertices.size = res.vertices.num * (uint32_t)vertex_size;
+    res.indices.size = res.indices.num * sizeof(uint16_t);
+    return res;
+}
+
+SOKOL_API_IMPL sshape_sizes_t sshape_box_sizes(uint32_t tiles, size_t vertex_size) {
+    SOKOL_ASSERT(tiles >= 1);
+    SOKOL_ASSERT((vertex_size >= SSHAPE_MIN_VERTEX_SIZE) && (vertex_size <= SSHAPE_MAX_VERTEX_SIZE));
+    sshape_sizes_t res = { {0} };
+    res.vertices.num = _sshape_box_num_vertices(tiles);
+    res.indices.num = _sshape_box_num_indices(tiles);
+    res.vertices.size = res.vertices.num * (uint32_t)vertex_size;
+    res.indices.size = res.indices.num * sizeof(uint16_t);
+    return res;
+}
+
+SOKOL_API_IMPL sshape_sizes_t sshape_sphere_sizes(uint32_t slices, uint32_t stacks, size_t vertex_size) {
+    SOKOL_ASSERT((slices >= 3) && (stacks >= 2));
+    SOKOL_ASSERT((vertex_size >= SSHAPE_MIN_VERTEX_SIZE) && (vertex_size <= SSHAPE_MAX_VERTEX_SIZE));
+    sshape_sizes_t res = { {0} };
+    res.vertices.num = _sshape_sphere_num_vertices(slices, stacks);
+    res.indices.num = _sshape_sphere_num_indices(slices, stacks);
+    res.vertices.size = res.vertices.num * (uint32_t)vertex_size;
+    res.indices.size = res.indices.num * sizeof(uint16_t);
+    return res;
+}
+
+SOKOL_API_IMPL sshape_sizes_t sshape_cylinder_sizes(uint32_t slices, uint32_t stacks, size_t vertex_size) {
+    SOKOL_ASSERT((slices >= 3) && (stacks >= 1));
+    SOKOL_ASSERT((vertex_size >= SSHAPE_MIN_VERTEX_SIZE) && (vertex_size <= SSHAPE_MAX_VERTEX_SIZE));
+    sshape_sizes_t res = { {0} };
+    res.vertices.num = _sshape_cylinder_num_vertices(slices, stacks);
+    res.indices.num = _sshape_cylinder_num_indices(slices, stacks);
+    res.vertices.size = res.vertices.num * (uint32_t)vertex_size;
+    res.indices.size = res.indices.num * sizeof(uint16_t);
+    return res;
+}
+
+SOKOL_API_IMPL sshape_sizes_t sshape_torus_sizes(uint32_t sides, uint32_t rings, size_t vertex_size) {
+    SOKOL_ASSERT((sides >= 3) && (rings >= 3));
+    SOKOL_ASSERT((vertex_size >= SSHAPE_MIN_VERTEX_SIZE) && (vertex_size <= SSHAPE_MAX_VERTEX_SIZE));
+    sshape_sizes_t res = { {0} };
+    res.vertices.num = _sshape_torus_num_vertices(sides, rings);
+    res.indices.num = _sshape_torus_num_indices(sides, rings);
+    res.vertices.size = res.vertices.num * (uint32_t)vertex_size;
+    res.indices.size = res.indices.num * sizeof(uint16_t);
+    return res;
+}
+
+/*
+    Geometry layout for plane (4 tiles):
+    +--+--+--+--+
+    |\ |\ |\ |\ |
+    | \| \| \| \|
+    +--+--+--+--+    25 vertices (tiles + 1) * (tiles + 1)
+    |\ |\ |\ |\ |    32 triangles (tiles + 1) * (tiles + 1) * 2
+    | \| \| \| \|
+    +--+--+--+--+
+    |\ |\ |\ |\ |
+    | \| \| \| \|
+    +--+--+--+--+
+    |\ |\ |\ |\ |
+    | \| \| \| \|
+    +--+--+--+--+
+*/
+SOKOL_API_IMPL void sshape_build_plane(sshape_state_t* state, const sshape_plane_t* in_params) {
+    SOKOL_ASSERT(state && in_params);
+    const sshape_plane_t params = _sshape_plane_defaults(in_params);
+    const uint32_t num_vertices = _sshape_plane_num_vertices(params.tiles);
+    const uint32_t num_indices = _sshape_plane_num_indices(params.tiles);
+    if (!_sshape_validate_state(state, num_vertices, num_indices)) {
+        state->valid = false;
+        return;
+    }
+    state->valid = true;
+    const uint16_t start_index = _sshape_base_index(state);
+    if (!params.merge) {
+        _sshape_advance_offset(&state->vertices);
+        _sshape_advance_offset(&state->indices);
+    }
+
+    // write vertices
+    uint32_t rand_seed = 0x12345678;
+    const float x0 = -params.width * 0.5f;
+    const float z0 =  params.depth * 0.5f;
+    const float dx =  params.width / params.tiles;
+    const float dz = -params.depth / params.tiles;
+    const float duv = 1.0f / params.tiles;
+    _sshape_vec4_t tnorm = _sshape_vec4_norm(_sshape_mat4_mul(&params.transform, _sshape_vec4(0.0f, 1.0f, 0.0f, 0.0f)));
+    for (uint32_t ix = 0; ix <= params.tiles; ix++) {
+        for (uint32_t iz = 0; iz <= params.tiles; iz++) {
+            const _sshape_vec4_t pos = _sshape_vec4(x0 + dx*ix, 0.0f, z0 + dz*iz, 1.0f);
+            const _sshape_vec4_t tpos = _sshape_mat4_mul(&params.transform, pos);
+            const _sshape_vec2_t uv = _sshape_vec2(duv*ix, duv*iz);
+            const uint32_t color = params.random_colors ? _sshape_rand_color(&rand_seed) : params.color;
+            _sshape_add_vertex(state, tpos, tnorm, uv, color);
+        }
+    }
+
+    // write indices
+    for (uint16_t j = 0; j < params.tiles; j++) {
+        for (uint16_t i = 0; i < params.tiles; i++) {
+            const uint16_t i0 = start_index + (j * (params.tiles + 1)) + i;
+            const uint16_t i1 = i0 + 1;
+            const uint16_t i2 = i0 + params.tiles + 1;
+            const uint16_t i3 = i2 + 1;
+            _sshape_add_triangle(state, i0, i1, i3);
+            _sshape_add_triangle(state, i0, i3, i2);
+        }
+    }
+}
+
+SOKOL_API_IMPL void sshape_build_box(sshape_state_t* state, const sshape_box_t* in_params) {
+    SOKOL_ASSERT(state && in_params);
+    const sshape_box_t params = _sshape_box_defaults(in_params);
+    const uint32_t num_vertices = _sshape_box_num_vertices(params.tiles);
+    const uint32_t num_indices = _sshape_box_num_indices(params.tiles);
+    if (!_sshape_validate_state(state, num_vertices, num_indices)) {
+        state->valid = false;
+        return;
+    }
+    state->valid = true;
+    const uint16_t start_index = _sshape_base_index(state);
+    if (!params.merge) {
+        _sshape_advance_offset(&state->vertices);
+        _sshape_advance_offset(&state->indices);
+    }
+
+    // build vertices
+    uint32_t rand_seed = 0x12345678;
+    const float x0 = -params.width * 0.5f;
+    const float x1 =  params.width * 0.5f;
+    const float y0 = -params.height * 0.5f;
+    const float y1 =  params.height * 0.5f;
+    const float z0 = -params.depth * 0.5f;
+    const float z1 =  params.depth * 0.5f;
+    const float dx = params.width / params.tiles;
+    const float dy = params.height / params.tiles;
+    const float dz = params.depth / params.tiles;
+    const float duv = 1.0f / params.tiles;
+
+    // bottom/top vertices
+    for (uint32_t top_bottom = 0; top_bottom < 2; top_bottom++) {
+        _sshape_vec4_t pos = _sshape_vec4(0.0f, (0==top_bottom) ? y0:y1, 0.0f, 1.0f);
+        const _sshape_vec4_t norm = _sshape_vec4(0.0f, (0==top_bottom) ? -1.0f:1.0f, 0.0f, 0.0f);
+        const _sshape_vec4_t tnorm = _sshape_vec4_norm(_sshape_mat4_mul(&params.transform, norm));
+        for (uint32_t ix = 0; ix <= params.tiles; ix++) {
+            pos.x = (0==top_bottom) ? (x0 + dx * ix) : (x1 - dx * ix);
+            for (uint32_t iz = 0; iz <= params.tiles; iz++) {
+                pos.z = z0 + dz * iz;
+                const _sshape_vec4_t tpos = _sshape_mat4_mul(&params.transform, pos);
+                const _sshape_vec2_t uv = _sshape_vec2(ix * duv, iz * duv);
+                const uint32_t color = params.random_colors ? _sshape_rand_color(&rand_seed) : params.color;
+                _sshape_add_vertex(state, tpos, tnorm, uv, color);
+            }
+        }
+    }
+
+    // left/right vertices
+    for (uint32_t left_right = 0; left_right < 2; left_right++) {
+        _sshape_vec4_t pos = _sshape_vec4((0==left_right) ? x0:x1, 0.0f, 0.0f, 1.0f);
+        const _sshape_vec4_t norm = _sshape_vec4((0==left_right) ? -1.0f:1.0f, 0.0f, 0.0f, 0.0f);
+        const _sshape_vec4_t tnorm = _sshape_vec4_norm(_sshape_mat4_mul(&params.transform, norm));
+        for (uint32_t iy = 0; iy <= params.tiles; iy++) {
+            pos.y = (0==left_right) ? (y1 - dy * iy) : (y0 + dy * iy);
+            for (uint32_t iz = 0; iz <= params.tiles; iz++) {
+                pos.z = z0 + dz * iz;
+                const _sshape_vec4_t tpos = _sshape_mat4_mul(&params.transform, pos);
+                const _sshape_vec2_t uv = _sshape_vec2(iy * duv, iz * duv);
+                const uint32_t color = params.random_colors ? _sshape_rand_color(&rand_seed) : params.color;
+                _sshape_add_vertex(state, tpos, tnorm, uv, color);
+            }
+        }
+    }
+
+    // front/back vertices
+    for (uint32_t front_back = 0; front_back < 2; front_back++) {
+        _sshape_vec4_t pos = _sshape_vec4(0.0f, 0.0f, (0==front_back) ? z0:z1, 1.0f);
+        const _sshape_vec4_t norm = _sshape_vec4(0.0f, 0.0f, (0==front_back) ? -1.0f:1.0f, 0.0f);
+        const _sshape_vec4_t tnorm = _sshape_vec4_norm(_sshape_mat4_mul(&params.transform, norm));
+        for (uint32_t ix = 0; ix <= params.tiles; ix++) {
+            pos.x = (0==front_back) ? (x1 - dx * ix) : (x0 + dx * ix);
+            for (uint32_t iy = 0; iy <= params.tiles; iy++) {
+                pos.y = y0 + dy * iy;
+                const _sshape_vec4_t tpos = _sshape_mat4_mul(&params.transform, pos);
+                const _sshape_vec2_t uv = _sshape_vec2(ix * duv, iy * duv);
+                const uint32_t color = params.random_colors ? _sshape_rand_color(&rand_seed) : params.color;
+                _sshape_add_vertex(state, tpos, tnorm, uv, color);
+            }
+        }
+    }
+
+    // build indices
+    const uint16_t verts_per_face = (params.tiles + 1) * (params.tiles + 1);
+    for (uint16_t face = 0; face < 6; face++) {
+        uint16_t face_start_index = start_index + face * verts_per_face;
+        for (uint16_t j = 0; j < params.tiles; j++) {
+            for (uint16_t i = 0; i < params.tiles; i++) {
+                const uint16_t i0 = face_start_index + (j * (params.tiles + 1)) + i;
+                const uint16_t i1 = i0 + 1;
+                const uint16_t i2 = i0 + params.tiles + 1;
+                const uint16_t i3 = i2 + 1;
+                _sshape_add_triangle(state, i0, i1, i3);
+                _sshape_add_triangle(state, i0, i3, i2);
+            }
+        }
+    }
+}
+
+/*
+    Geometry layout for spheres is as follows (for 5 slices, 4 stacks):
+
+    +  +  +  +  +  +        north pole
+    |\ |\ |\ |\ |\
+    | \| \| \| \| \
+    +--+--+--+--+--+        30 vertices (slices + 1) * (stacks + 1)
+    |\ |\ |\ |\ |\ |        30 triangles (2 * slices * stacks) - (2 * slices)
+    | \| \| \| \| \|        2 orphaned vertices
+    +--+--+--+--+--+
+    |\ |\ |\ |\ |\ |
+    | \| \| \| \| \|
+    +--+--+--+--+--+
+     \ |\ |\ |\ |\ |
+      \| \| \| \| \|
+    +  +  +  +  +  +        south pole
+*/
+SOKOL_API_IMPL void sshape_build_sphere(sshape_state_t* state, const sshape_sphere_t* in_params) {
+    SOKOL_ASSERT(state && in_params);
+    const sshape_sphere_t params = _sshape_sphere_defaults(in_params);
+    const uint32_t num_vertices = _sshape_sphere_num_vertices(params.slices, params.stacks);
+    const uint32_t num_indices = _sshape_sphere_num_indices(params.slices, params.stacks);
+    if (!_sshape_validate_state(state, num_vertices, num_indices)) {
+        state->valid = false;
+        return;
+    }
+    state->valid = true;
+    const uint16_t start_index = _sshape_base_index(state);
+    if (!params.merge) {
+        _sshape_advance_offset(&state->vertices);
+        _sshape_advance_offset(&state->indices);
+    }
+
+    uint32_t rand_seed = 0x12345678;
+    const float pi = 3.14159265358979323846f;
+    const float two_pi = 2.0f * pi;
+    const float du = 1.0f / params.slices;
+    const float dv = 1.0f / params.stacks;
+
+    // generate vertices
+    for (uint32_t stack = 0; stack <= params.stacks; stack++) {
+        const float stack_angle = (pi * stack) / params.stacks;
+        const float sin_stack = sinf(stack_angle);
+        const float cos_stack = cosf(stack_angle);
+        for (uint32_t slice = 0; slice <= params.slices; slice++) {
+            const float slice_angle = (two_pi * slice) / params.slices;
+            const float sin_slice = sinf(slice_angle);
+            const float cos_slice = cosf(slice_angle);
+            const _sshape_vec4_t norm = _sshape_vec4(-sin_slice * sin_stack, cos_stack, cos_slice * sin_stack, 0.0f);
+            const _sshape_vec4_t pos = _sshape_vec4(norm.x * params.radius, norm.y * params.radius, norm.z * params.radius, 1.0f);
+            const _sshape_vec4_t tnorm = _sshape_vec4_norm(_sshape_mat4_mul(&params.transform, norm));
+            const _sshape_vec4_t tpos = _sshape_mat4_mul(&params.transform, pos);
+            const _sshape_vec2_t uv = _sshape_vec2(1.0f - slice * du, 1.0f - stack * dv);
+            const uint32_t color = params.random_colors ? _sshape_rand_color(&rand_seed) : params.color;
+            _sshape_add_vertex(state, tpos, tnorm, uv, color);
+        }
+    }
+
+    // generate indices
+    {
+        // north-pole triangles
+        const uint16_t row_a = start_index;
+        const uint16_t row_b = row_a + params.slices + 1;
+        for (uint16_t slice = 0; slice < params.slices; slice++) {
+            _sshape_add_triangle(state, row_a + slice, row_b + slice, row_b + slice + 1);
+        }
+    }
+    // stack triangles
+    for (uint16_t stack = 1; stack < params.stacks - 1; stack++) {
+        const uint16_t row_a = start_index + stack * (params.slices + 1);
+        const uint16_t row_b = row_a + params.slices + 1;
+        for (uint16_t slice = 0; slice < params.slices; slice++) {
+            _sshape_add_triangle(state, row_a + slice, row_b + slice + 1, row_a + slice + 1);
+            _sshape_add_triangle(state, row_a + slice, row_b + slice, row_b + slice + 1);
+        }
+    }
+    {
+        // south-pole triangles
+        const uint16_t row_a = start_index + (params.stacks - 1) * (params.slices + 1);
+        const uint16_t row_b = row_a + params.slices + 1;
+        for (uint16_t slice = 0; slice < params.slices; slice++) {
+            _sshape_add_triangle(state, row_a + slice, row_b + slice + 1, row_a + slice + 1);
+        }
+    }
+}
+
+/*
+    Geometry for cylinders is as follows (2 stacks, 5 slices):
+
+    +  +  +  +  +  +
+    |\ |\ |\ |\ |\
+    | \| \| \| \| \
+    +--+--+--+--+--+
+    +--+--+--+--+--+    42 vertices (2 wasted) (slices + 1) * (stacks + 5)
+    |\ |\ |\ |\ |\ |    30 triangles (2 * slices * stacks) + (2 * slices)
+    | \| \| \| \| \|
+    +--+--+--+--+--+
+    |\ |\ |\ |\ |\ |
+    | \| \| \| \| \|
+    +--+--+--+--+--+
+    +--+--+--+--+--+
+     \ |\ |\ |\ |\ |
+      \| \| \| \| \|
+    +  +  +  +  +  +
+*/
+static void _sshape_build_cylinder_cap_pole(sshape_state_t* state, const sshape_cylinder_t* params, float pos_y, float norm_y, float du, float v, uint32_t* rand_seed) {
+    const _sshape_vec4_t tnorm = _sshape_vec4_norm(_sshape_mat4_mul(&params->transform, _sshape_vec4(0.0f, norm_y, 0.0f, 0.0f)));
+    const _sshape_vec4_t tpos = _sshape_mat4_mul(&params->transform, _sshape_vec4(0.0f, pos_y, 0.0f, 1.0f));
+    for (uint32_t slice = 0; slice <= params->slices; slice++) {
+        const _sshape_vec2_t uv = _sshape_vec2(slice * du, 1.0f - v);
+        const uint32_t color = params->random_colors ? _sshape_rand_color(rand_seed) : params->color;
+        _sshape_add_vertex(state, tpos, tnorm, uv, color);
+    }
+}
+
+static void _sshape_build_cylinder_cap_ring(sshape_state_t* state, const sshape_cylinder_t* params, float pos_y, float norm_y, float du, float v, uint32_t* rand_seed) {
+    const float two_pi = 2.0f * 3.14159265358979323846f;
+    const _sshape_vec4_t tnorm = _sshape_vec4_norm(_sshape_mat4_mul(&params->transform, _sshape_vec4(0.0f, norm_y, 0.0f, 0.0f)));
+    for (uint32_t slice = 0; slice <= params->slices; slice++) {
+        const float slice_angle = (two_pi * slice) / params->slices;
+        const float sin_slice = sinf(slice_angle);
+        const float cos_slice = cosf(slice_angle);
+        const _sshape_vec4_t pos = _sshape_vec4(sin_slice * params->radius, pos_y, cos_slice * params->radius, 1.0f);
+        const _sshape_vec4_t tpos = _sshape_mat4_mul(&params->transform, pos);
+        const _sshape_vec2_t uv = _sshape_vec2(slice * du, 1.0f - v);
+        const uint32_t color = params->random_colors ? _sshape_rand_color(rand_seed) : params->color;
+        _sshape_add_vertex(state, tpos, tnorm, uv, color);
+    }
+}
+
+SOKOL_API_IMPL void sshape_build_cylinder(sshape_state_t* state, const sshape_cylinder_t* in_params) {
+    SOKOL_ASSERT(state && in_params);
+    const sshape_cylinder_t params = _sshape_cylinder_defaults(in_params);
+    const uint32_t num_vertices = _sshape_cylinder_num_vertices(params.slices, params.stacks);
+    const uint32_t num_indices = _sshape_cylinder_num_indices(params.slices, params.stacks);
+    if (!_sshape_validate_state(state, num_vertices, num_indices)) {
+        state->valid = false;
+        return;
+    }
+    state->valid = true;
+    const uint16_t start_index = _sshape_base_index(state);
+    if (!params.merge) {
+        _sshape_advance_offset(&state->vertices);
+        _sshape_advance_offset(&state->indices);
+    }
+
+    uint32_t rand_seed = 0x12345678;
+    const float two_pi = 2.0f * 3.14159265358979323846f;
+    const float du = 1.0f / params.slices;
+    const float dv = 1.0f / (params.stacks + 2);
+    const float y0 = params.height * 0.5f;
+    const float y1 = -params.height * 0.5f;
+    const float dy = params.height / params.stacks;
+
+    // generate vertices
+    _sshape_build_cylinder_cap_pole(state, &params, y0, 1.0f, du, 0.0f, &rand_seed);
+    _sshape_build_cylinder_cap_ring(state, &params, y0, 1.0f, du, dv, &rand_seed);
+    for (uint32_t stack = 0; stack <= params.stacks; stack++) {
+        const float y = y0 - dy * stack;
+        const float v = dv * stack + dv;
+        for (uint32_t slice = 0; slice <= params.slices; slice++) {
+            const float slice_angle = (two_pi * slice) / params.slices;
+            const float sin_slice = sinf(slice_angle);
+            const float cos_slice = cosf(slice_angle);
+            const _sshape_vec4_t pos = _sshape_vec4(sin_slice * params.radius, y, cos_slice * params.radius, 1.0f);
+            const _sshape_vec4_t tpos = _sshape_mat4_mul(&params.transform, pos);
+            const _sshape_vec4_t norm = _sshape_vec4(sin_slice, 0.0f, cos_slice, 0.0f);
+            const _sshape_vec4_t tnorm = _sshape_vec4_norm(_sshape_mat4_mul(&params.transform, norm));
+            const _sshape_vec2_t uv = _sshape_vec2(slice * du, 1.0f - v);
+            const uint32_t color = params.random_colors ? _sshape_rand_color(&rand_seed) : params.color;
+            _sshape_add_vertex(state, tpos, tnorm, uv, color);
+        }
+    }
+    _sshape_build_cylinder_cap_ring(state, &params, y1, -1.0f, du, 1.0f - dv, &rand_seed);
+    _sshape_build_cylinder_cap_pole(state, &params, y1, -1.0f, du, 1.0f, &rand_seed);
+
+    // generate indices
+    {
+        // top-cap indices
+        const uint16_t row_a = start_index;
+        const uint16_t row_b = row_a + params.slices + 1;
+        for (uint16_t slice = 0; slice < params.slices; slice++) {
+            _sshape_add_triangle(state, row_a + slice, row_b + slice + 1, row_b + slice);
+        }
+    }
+    // shaft triangles
+    for (uint16_t stack = 0; stack < params.stacks; stack++) {
+        const uint16_t row_a = start_index + (stack + 2) * (params.slices + 1);
+        const uint16_t row_b = row_a + params.slices + 1;
+        for (uint16_t slice = 0; slice < params.slices; slice++) {
+            _sshape_add_triangle(state, row_a + slice, row_a + slice + 1, row_b + slice + 1);
+            _sshape_add_triangle(state, row_a + slice, row_b + slice + 1, row_b + slice);
+        }
+    }
+    {
+        // bottom-cap indices
+        const uint16_t row_a = start_index + (params.stacks + 3) * (params.slices + 1);
+        const uint16_t row_b = row_a + params.slices + 1;
+        for (uint16_t slice = 0; slice < params.slices; slice++) {
+            _sshape_add_triangle(state, row_a + slice, row_a + slice + 1, row_b + slice + 1);
+        }
+    }
+}
+
+/*
+    Geometry layout for torus (sides = 4, rings = 5):
+
+    +--+--+--+--+--+
+    |\ |\ |\ |\ |\ |
+    | \| \| \| \| \|
+    +--+--+--+--+--+    30 vertices (sides + 1) * (rings + 1)
+    |\ |\ |\ |\ |\ |    40 triangles (2 * sides * rings)
+    | \| \| \| \| \|
+    +--+--+--+--+--+
+    |\ |\ |\ |\ |\ |
+    | \| \| \| \| \|
+    +--+--+--+--+--+
+    |\ |\ |\ |\ |\ |
+    | \| \| \| \| \|
+    +--+--+--+--+--+
+*/
+SOKOL_API_IMPL void sshape_build_torus(sshape_state_t* state, const sshape_torus_t* in_params) {
+    SOKOL_ASSERT(state && in_params);
+    const sshape_torus_t params = _sshape_torus_defaults(in_params);
+    const uint32_t num_vertices = _sshape_torus_num_vertices(params.sides, params.rings);
+    const uint32_t num_indices = _sshape_torus_num_indices(params.sides, params.rings);
+    if (!_sshape_validate_state(state, num_vertices, num_indices)) {
+        state->valid = false;
+        return;
+    }
+    state->valid = true;
+    const uint16_t start_index = _sshape_base_index(state);
+    if (!params.merge) {
+        _sshape_advance_offset(&state->vertices);
+        _sshape_advance_offset(&state->indices);
+    }
+
+    uint32_t rand_seed = 0x12345678;
+    const float two_pi = 2.0f * 3.14159265358979323846f;
+    const float dv = 1.0f / params.sides;
+    const float du = 1.0f / params.rings;
+
+    // generate vertices
+    for (uint32_t side = 0; side <= params.sides; side++) {
+        const float phi = (side * two_pi) / params.sides;
+        const float sin_phi = sinf(phi);
+        const float cos_phi = cosf(phi);
+        for (uint32_t ring = 0; ring <= params.rings; ring++) {
+            const float theta = (ring * two_pi) / params.rings;
+            const float sin_theta = sinf(theta);
+            const float cos_theta = cosf(theta);
+
+            // torus surface position
+            const float spx = sin_theta * (params.radius - (params.ring_radius * cos_phi));
+            const float spy = sin_phi * params.ring_radius;
+            const float spz = cos_theta * (params.radius - (params.ring_radius * cos_phi));
+
+            // torus position with ring-radius zero (for normal computation)
+            const float ipx = sin_theta * params.radius;
+            const float ipy = 0.0f;
+            const float ipz = cos_theta * params.radius;
+
+            const _sshape_vec4_t pos = _sshape_vec4(spx, spy, spz, 1.0f);
+            const _sshape_vec4_t norm = _sshape_vec4(spx - ipx, spy - ipy, spz - ipz, 0.0f);
+            const _sshape_vec4_t tpos = _sshape_mat4_mul(&params.transform, pos);
+            const _sshape_vec4_t tnorm = _sshape_vec4_norm(_sshape_mat4_mul(&params.transform, norm));
+            const _sshape_vec2_t uv = _sshape_vec2(ring * du, 1.0f - side * dv);
+            const uint32_t color = params.random_colors ? _sshape_rand_color(&rand_seed) : params.color;
+            _sshape_add_vertex(state, tpos, tnorm, uv, color);
+        }
+    }
+
+    // generate indices
+    for (uint16_t side = 0; side < params.sides; side++) {
+        const uint16_t row_a = start_index + side * (params.rings + 1);
+        const uint16_t row_b = row_a + params.rings + 1;
+        for (uint16_t ring = 0; ring < params.rings; ring++) {
+            _sshape_add_triangle(state, row_a + ring, row_a + ring + 1, row_b + ring + 1);
+            _sshape_add_triangle(state, row_a + ring, row_b + ring + 1, row_b + ring);
+        }
+    }
+}
+
+SOKOL_API_IMPL sg_buffer_desc sshape_vertex_buffer_desc(const sshape_state_t* state) {
+    SOKOL_ASSERT(state && state->valid);
+    sg_buffer_desc desc = { 0 };
+    if (state->valid) {
+        desc.usage.vertex_buffer = true;
+        desc.data.ptr = state->vertices.buffer.ptr;
+        desc.data.size = state->vertices.data_size;
+    }
+    return desc;
+}
+
+SOKOL_API_IMPL sg_buffer_desc sshape_index_buffer_desc(const sshape_state_t* state) {
+    SOKOL_ASSERT(state && state->valid);
+    sg_buffer_desc desc = { 0 };
+    if (state->valid) {
+        desc.usage.index_buffer = true;
+        desc.data.ptr = state->indices.buffer.ptr;
+        desc.data.size = state->indices.data_size;
+    }
+    return desc;
+}
+
+SOKOL_API_IMPL sshape_element_range_t sshape_element_range(const sshape_state_t* state) {
+    SOKOL_ASSERT(state);
+    sshape_element_range_t range = { 0 };
+    if (state->valid) {
+        SOKOL_ASSERT(state->indices.shape_offset < state->indices.data_size);
+        SOKOL_ASSERT(0 == (state->indices.shape_offset & (sizeof(uint16_t) - 1)));
+        SOKOL_ASSERT(0 == (state->indices.data_size & (sizeof(uint16_t) - 1)));
+        range.base_element = (int) (state->indices.shape_offset / sizeof(uint16_t));
+        range.num_elements = (int) ((state->indices.data_size - state->indices.shape_offset) / sizeof(uint16_t));
+    }
+    return range;
+}
+
+SOKOL_API_IMPL sg_vertex_buffer_layout_state sshape_vertex_buffer_layout_state(const sshape_state_t* state) {
+    SOKOL_ASSERT(state && state->valid);
+    sg_vertex_buffer_layout_state layout_state = { 0 };
+    layout_state.stride = (int)_sshape_vertex_size_from_state(state);
+    return layout_state;
+}
+
+SOKOL_API_IMPL sg_vertex_attr_state sshape_position_vertex_attr_state(const sshape_state_t* state) {
+    SOKOL_ASSERT(state && state->valid);
+    sg_vertex_attr_state attr_state = { 0 };
+    attr_state.offset = _sshape_vertex_position_offset(state);
+    attr_state.format = SG_VERTEXFORMAT_FLOAT3;
+    return attr_state;
+}
+
+SOKOL_API_IMPL sg_vertex_attr_state sshape_normal_vertex_attr_state(const sshape_state_t* state) {
+    SOKOL_ASSERT(state && state->valid);
+    sg_vertex_attr_state attr_state = { 0 };
+    if (!state->disable.normals) {
+        attr_state.offset = _sshape_vertex_normal_offset(state);
+        attr_state.format = SG_VERTEXFORMAT_BYTE4N;
+    }
+    return attr_state;
+}
+
+SOKOL_API_IMPL sg_vertex_attr_state sshape_texcoord_vertex_attr_state(const sshape_state_t* state) {
+    SOKOL_ASSERT(state && state->valid);
+    sg_vertex_attr_state attr_state = { 0 };
+    if (!state->disable.texcoords) {
+        attr_state.offset = _sshape_vertex_texcoord_offset(state);
+        attr_state.format = SG_VERTEXFORMAT_USHORT2N;
+    }
+    return attr_state;
+}
+
+SOKOL_API_IMPL sg_vertex_attr_state sshape_color_vertex_attr_state(const sshape_state_t* state) {
+    SOKOL_ASSERT(state && state->valid);
+    sg_vertex_attr_state attr_state = { 0 };
+    if (!state->disable.colors) {
+        attr_state.offset = _sshape_vertex_color_offset(state);
+        attr_state.format = SG_VERTEXFORMAT_UBYTE4N;
+    }
+    return attr_state;
+}
+
+#ifdef __clang__
+#pragma clang diagnostic pop
+#endif
+#endif // SOKOL_SHAPE_IMPL