model.h

#include <modkit/model.h>72 functions · 6 structs · 1 enums · 8 typedefs · 19 macros

Model loading package glTF/GLB files into drawable geometry.

An OPT-IN package (MODKIT_ENABLE_MODEL, default OFF). It is a pure helper over the spine: a loaded model is just a list of (geometry + material + node-transform) draw items, submitted through mk_pass_draw. It owns no pass machinery and adds no rendering technique shading is the scene-lite lit/unlit material by default; when the pbr package is enabled it builds PBR materials without changing the draw path. mk_model_t m = mk_model_load("assets/duck.glb", 0); ... mk_begin_pass(&mk_pass_3d(clear, view, proj)); mk_model_draw(m, world_mtx); // submits every primitive into the pass mk_end_pass(); ... mk_model_destroy(m); When the package is disabled (MODKIT_HAS_MODEL == 0) these symbols still link via a no-op stub: mk_model_load returns MK_MODEL_INVALID. Supported now: glTF/GLB, external buffers + textures, node transforms, extracted primitive meshes, extracted material slots, animation clips, scene-graph animation, skeletal skinning, and morph targets. OBJ/FBX importers are available through the optional assimp add-on.

Functions

`mk_model_aabb`function

mk_aabb mk_model_aabb(mk_model_t model)

Local-space axis-aligned bounds over all primitives (node transforms applied,.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.

Returns The resulting value. model transform NOT applied). Zero AABB if the model is invalid/empty.

`mk_model_animation_count`function

uint32_t mk_model_animation_count(mk_model_t model)

Number of animation clips in the model.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.

Returns The resulting value.

`mk_model_animation_duration`function

float mk_model_animation_duration(mk_model_t model, uint32_t index)

Animation duration in seconds, or 0 when index is out of range.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.
`index`	`uint32_t`	Zero-based index.

Returns The resulting value.

`mk_model_animation_event_add`function

bool mk_model_animation_event_add(mk_model_t model, uint32_t animation, float time_sec, const char *name, int32_t payload)

Add model animation event.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.
`animation`	`uint32_t`	Value for animation.
`time_sec`	`float`	Value for time sec.
`name`	`const char *`	Stable name.
`payload`	`int32_t`	Value for payload.

Returns True when the operation succeeds.

`mk_model_animation_event_count`function

uint32_t mk_model_animation_event_count(mk_model_t model, uint32_t animation)

Perform the model animation event count operation.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.
`animation`	`uint32_t`	Value for animation.

Returns The resulting value.

`mk_model_animation_event_get`function

bool mk_model_animation_event_get(mk_model_t model, uint32_t animation, uint32_t index, mk_model_animation_marker_t *out)

Get state from the model animation event.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.
`animation`	`uint32_t`	Value for animation.
`index`	`uint32_t`	Zero-based index.
`out`	`mk_model_animation_marker_t *`	Value for out.

Returns True when the operation succeeds.

`mk_model_animation_events_clear`function

void mk_model_animation_events_clear(mk_model_t model, uint32_t animation)

Clear the model animation events.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.
`animation`	`uint32_t`	Value for animation.

`mk_model_animation_find`function

int32_t mk_model_animation_find(mk_model_t model, const char *name)

Find an animation by name.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.
`name`	`const char *`	Stable name.

Returns The resulting value.

`mk_model_animation_name`function

const char * mk_model_animation_name(mk_model_t model, uint32_t index)

Animation display name, or NULL when index is out of range.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.
`index`	`uint32_t`	Zero-based index.

Returns A borrowed pointer, or NULL when unavailable.

`mk_model_copy_lights`function

uint32_t mk_model_copy_lights(mk_model_t model, const float transform[16], mk_light_desc *out, uint32_t capacity)

Copy lights for the model.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.
`transform`	`const float`	Value for transform.
`out`	`mk_light_desc *`	Value for out.
`capacity`	`uint32_t`	Value for capacity.

Returns The resulting value.

`mk_model_destroy`function

void mk_model_destroy(mk_model_t model)

Immediately invalidate a model; its GPU-owned contents retire after queued frames complete.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.

`mk_model_draw`function

void mk_model_draw(mk_model_t model, const float transform[16])

Submit every primitive of the model into the active pass.

transform is the model's world matrix (column-major 4x4, NULL => identity); each primitive is

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.
`transform`	`const float`	Value for transform. drawn at transform * node_world. Call between mk_begin_pass/mk_end_pass.

`mk_model_draw_ex`function

void mk_model_draw_ex(mk_model_t model, const float transform[16], uint32_t filter)

Like mk_model_draw but only the primitive categories in filter (a bitmask of MK_MODEL_DRAW_*).

Drawn opaque -> transmissive -> blend so they composite correctly. Use MK_MODEL_DRAW_OPAQUE for a transmission-capture pass (exclude the refractive

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.
`transform`	`const float`	Value for transform.
`filter`	`uint32_t`	Value for filter. prims so glass doesn't refract itself). mk_model_draw == filter MK_MODEL_DRAW_ALL.

`mk_model_draw_transmissive_layer`function

void mk_model_draw_transmissive_layer(mk_model_t model, const float transform[16], const float view_mtx[16], uint32_t layer)

Draw one transmissive primitive, sorted back-to-front for the supplied view matrix.

layer is 0-based, where 0 is the farthest transmissive primitive from the camera. This is intentionally narrow: normal model drawing still goes through mk_model_draw().

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.
`transform`	`const float`	Value for transform.
`view_mtx`	`const float`	Value for view mtx.
`layer`	`uint32_t`	Value for layer.

`mk_model_instance_aabb`function

mk_aabb mk_model_instance_aabb(mk_model_instance_t instance)

Current local-space bounds for the posed instance.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.

Returns The resulting value.

`mk_model_instance_action_clear_mask`function

void mk_model_instance_action_clear_mask(mk_model_instance_t instance, mk_model_action_t action)

Restore full TRS influence for the action.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`action`	`mk_model_action_t`	Value for action.

`mk_model_instance_action_fade_to`function

void mk_model_instance_action_fade_to(mk_model_instance_t instance, mk_model_action_t action, float target_weight, float duration_sec)

Linearly animate the current action weight to target_weight.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`action`	`mk_model_action_t`	Value for action.
`target_weight`	`float`	Value for target weight.
`duration_sec`	`float`	Value for duration sec.

`mk_model_instance_action_is_playing`function

bool mk_model_instance_action_is_playing(mk_model_instance_t instance, mk_model_action_t action)

Test whether the model instance action is playing.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`action`	`mk_model_action_t`	Value for action.

Returns True when the condition holds.

`mk_model_instance_action_is_valid`function

bool mk_model_instance_action_is_valid(mk_model_instance_t instance, mk_model_action_t action)

Test whether the model instance action is valid.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`action`	`mk_model_action_t`	Value for action.

Returns True when the condition holds.

`mk_model_instance_action_play`function

mk_model_action_t mk_model_instance_action_play(mk_model_instance_t instance, uint32_t animation, uint32_t flags)

Start an independently controlled animation action at time zero, speed 1, and weight 1.

Use MK_MODEL_PLAY_ADDITIVE to apply its rest-pose delta after

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`animation`	`uint32_t`	Value for animation.
`flags`	`uint32_t`	Value for flags.

Returns The resulting handle or value. normal blending. Returns MK_MODEL_ACTION_INVALID when no slot is available.

`mk_model_instance_action_remove`function

void mk_model_instance_action_remove(mk_model_instance_t instance, mk_model_action_t action)

Remove model instance action.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`action`	`mk_model_action_t`	Value for action.

`mk_model_instance_action_set_mask`function

bool mk_model_instance_action_set_mask(mk_model_instance_t instance, mk_model_action_t action, mk_model_mask_t mask)

Copy a reusable mask onto an action.

Returns false for invalid handles or a

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`action`	`mk_model_action_t`	Value for action.
`mask`	`mk_model_mask_t`	Value for mask.

Returns True when the operation succeeds. mask created for another model.

`mk_model_instance_action_set_playing`function

void mk_model_instance_action_set_playing(mk_model_instance_t instance, mk_model_action_t action, bool playing)

Set playing on the model instance action.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`action`	`mk_model_action_t`	Value for action.
`playing`	`bool`	Value for playing.

`mk_model_instance_action_set_speed`function

void mk_model_instance_action_set_speed(mk_model_instance_t instance, mk_model_action_t action, float speed)

Set speed on the model instance action.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`action`	`mk_model_action_t`	Value for action.
`speed`	`float`	Value for speed.

`mk_model_instance_action_set_time`function

void mk_model_instance_action_set_time(mk_model_instance_t instance, mk_model_action_t action, float time_sec)

Set time on the model instance action.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`action`	`mk_model_action_t`	Value for action.
`time_sec`	`float`	Value for time sec.

`mk_model_instance_action_set_weight`function

void mk_model_instance_action_set_weight(mk_model_instance_t instance, mk_model_action_t action, float weight)

Set weight on the model instance action.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`action`	`mk_model_action_t`	Value for action.
`weight`	`float`	Value for weight.

`mk_model_instance_action_speed`function

float mk_model_instance_action_speed(mk_model_instance_t instance, mk_model_action_t action)

Perform the model instance action speed operation.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`action`	`mk_model_action_t`	Value for action.

Returns The resulting value.

`mk_model_instance_action_time`function

float mk_model_instance_action_time(mk_model_instance_t instance, mk_model_action_t action)

Perform the model instance action time operation.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`action`	`mk_model_action_t`	Value for action.

Returns The resulting value.

`mk_model_instance_action_weight`function

float mk_model_instance_action_weight(mk_model_instance_t instance, mk_model_action_t action)

Perform the model instance action weight operation.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`action`	`mk_model_action_t`	Value for action.

Returns The resulting value.

`mk_model_instance_clear_animation_events`function

void mk_model_instance_clear_animation_events(mk_model_instance_t instance)

Clear the animation events for the model instance.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.

`mk_model_instance_consume_root_motion`function

mk_model_root_motion_t mk_model_instance_consume_root_motion(mk_model_instance_t instance)

Return and reset motion accumulated since the previous consume.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.

Returns The resulting handle or value.

`mk_model_instance_copy_lights`function

uint32_t mk_model_instance_copy_lights(mk_model_instance_t instance, const float transform[16], mk_light_desc *out, uint32_t capacity)

Copy lights for the model instance.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`transform`	`const float`	Value for transform.
`out`	`mk_light_desc *`	Value for out.
`capacity`	`uint32_t`	Value for capacity.

Returns The resulting value.

`mk_model_instance_create`function

mk_model_instance_t mk_model_instance_create(mk_model_t model)

Create an independent posed instance of a loaded model.

Instances own playback

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.

Returns The resulting handle or value. state and any dynamic vertex buffers needed for skinning/morphing.

`mk_model_instance_crossfade`function

mk_model_action_t mk_model_instance_crossfade(mk_model_instance_t instance, uint32_t animation, float duration_sec, uint32_t flags)

Crossfade all normal actions to a new looping or one-shot normal action.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`animation`	`uint32_t`	Value for animation.
`duration_sec`	`float`	Value for duration sec.
`flags`	`uint32_t`	Value for flags.

Returns The resulting handle or value. Additive actions are left untouched. Faded-out sources are removed.

`mk_model_instance_destroy`function

void mk_model_instance_destroy(mk_model_instance_t instance)

Destroy an instance.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.

`mk_model_instance_draw`function

void mk_model_instance_draw(mk_model_instance_t instance, const float transform[16])

Draw the current instance pose.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`transform`	`const float`	Value for transform.

`mk_model_instance_draw_ex`function

void mk_model_instance_draw_ex(mk_model_instance_t instance, const float transform[16], uint32_t filter)

Draw ex for the model instance.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`transform`	`const float`	Value for transform.
`filter`	`uint32_t`	Value for filter.

`mk_model_instance_draw_transmissive_layer`function

void mk_model_instance_draw_transmissive_layer(mk_model_instance_t instance, const float transform[16], const float view_mtx[16], uint32_t layer)

Draw transmissive layer for the model instance.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`transform`	`const float`	Value for transform.
`view_mtx`	`const float`	Value for view mtx.
`layer`	`uint32_t`	Value for layer.

`mk_model_instance_is_valid`function

bool mk_model_instance_is_valid(mk_model_instance_t instance)

Test whether the model instance is valid.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.

Returns True when the condition holds.

`mk_model_instance_light_count`function

uint32_t mk_model_instance_light_count(mk_model_instance_t instance)

Perform the model instance light count operation.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.

Returns The resulting value.

`mk_model_instance_pin`function

bool mk_model_instance_pin(mk_model_instance_t instance)

Perform the model instance pin operation.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.

Returns True when the operation succeeds.

`mk_model_instance_play`function

bool mk_model_instance_play(mk_model_instance_t instance, uint32_t animation, uint32_t flags)

Start playing an animation clip.

Time resets to zero. flags is MK_MODEL_PLAY_*.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`animation`	`uint32_t`	Value for animation.
`flags`	`uint32_t`	Value for flags.

Returns True when the operation succeeds. Returns false for invalid instance/model/animation.

`mk_model_instance_poll_animation_event`function

bool mk_model_instance_poll_animation_event(mk_model_instance_t instance, mk_model_animation_event_t *out)

Poll one queued marker event.

Events are ordered by crossing time within an

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`out`	`mk_model_animation_event_t *`	Value for out.

Returns True when the operation succeeds. update. Seeking does not enqueue events.

`mk_model_instance_primary_action`function

mk_model_action_t mk_model_instance_primary_action(mk_model_instance_t instance)

Most recently started normal action, or MK_MODEL_ACTION_INVALID.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.

Returns The resulting handle or value.

`mk_model_instance_set_root_motion`function

bool mk_model_instance_set_root_motion(mk_model_instance_t instance, uint32_t node, uint32_t flags)

Enable extraction from an explicit node.

flags is MK_MODEL_ROOT_MOTION_*. Selected components are removed from the rendered pose. Passing zero flags

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`node`	`uint32_t`	Value for node.
`flags`	`uint32_t`	Value for flags.

Returns True when the operation succeeds. disables extraction.

`mk_model_instance_set_speed`function

void mk_model_instance_set_speed(mk_model_instance_t instance, float speed)

Set the instance-wide playback speed multiplier.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`speed`	`float`	Value for speed.

`mk_model_instance_set_time`function

void mk_model_instance_set_time(mk_model_instance_t instance, float time_sec)

Set current animation time in seconds.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`time_sec`	`float`	Value for time sec.

`mk_model_instance_stop`function

void mk_model_instance_stop(mk_model_instance_t instance)

Stop playback, keeping the current pose.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.

`mk_model_instance_time`function

float mk_model_instance_time(mk_model_instance_t instance)

Current animation time in seconds.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.

Returns The resulting value.

`mk_model_instance_transmissive_count`function

uint32_t mk_model_instance_transmissive_count(mk_model_instance_t instance)

Animated instance transmissive helpers, matching the model-level helpers.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.

Returns The resulting value.

`mk_model_instance_unpin`function

void mk_model_instance_unpin(mk_model_instance_t instance)

Perform the model instance unpin operation.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.

`mk_model_instance_update`function

void mk_model_instance_update(mk_model_instance_t instance, float dt_sec)

Advance playback and update the instance pose/dynamic geometry.

Parameter	Type	Description
`instance`	`mk_model_instance_t`	Value for instance.
`dt_sec`	`float`	Value for dt sec.

`mk_model_is_valid`function

bool mk_model_is_valid(mk_model_t model)

Test whether the model is valid.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.

Returns True when the condition holds.

`mk_model_light_count`function

uint32_t mk_model_light_count(mk_model_t model)

Perform the model light count operation.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.

Returns The resulting value.

`mk_model_load`function

mk_model_t mk_model_load(const char *path, uint32_t flags)

Load a model from a file path.

Returns MK_MODEL_INVALID on failure (logged).

Parameter	Type	Description
`path`	`const char *`	Value for path.
`flags`	`uint32_t`	Value for flags.

Returns The resulting handle or value. External buffers/images referenced by the file are resolved relative to it.

`mk_model_mask_create`function

mk_model_mask_t mk_model_mask_create(mk_model_t model, float default_weight)

Create model mask.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.
`default_weight`	`float`	Value for default weight.

Returns The resulting handle or value.

`mk_model_mask_destroy`function

void mk_model_mask_destroy(mk_model_mask_t mask)

Destroy the model mask.

Parameter	Type	Description
`mask`	`mk_model_mask_t`	Value for mask.

`mk_model_mask_set_node`function

bool mk_model_mask_set_node(mk_model_mask_t mask, uint32_t node, float weight, bool include_descendants)

Set one node's 0..1 weight.

When include_descendants is true, applies to the

Parameter	Type	Description
`mask`	`mk_model_mask_t`	Value for mask.
`node`	`uint32_t`	Value for node.
`weight`	`float`	Value for weight.
`include_descendants`	`bool`	Value for include descendants.

Returns True when the operation succeeds. complete node subtree.

`mk_model_material_count`function

uint32_t mk_model_material_count(mk_model_t model)

Number of distinct material slots extracted from the file.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.

Returns The resulting value.

`mk_model_mesh_count`function

uint32_t mk_model_mesh_count(mk_model_t model)

Number of drawable primitives (one per mesh primitive, after node flatten).

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.

Returns The resulting value.

`mk_model_node_count`function

uint32_t mk_model_node_count(mk_model_t model)

Number of scene/skeleton nodes in the model.

Node indices are stable for the

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.

Returns The resulting value. lifetime of the model and are used by masks and root motion.

`mk_model_node_find`function

int32_t mk_model_node_find(mk_model_t model, const char *name)

Find the first node with an exact name match.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.
`name`	`const char *`	Stable name.

Returns The resulting value.

`mk_model_node_name`function

const char * mk_model_node_name(mk_model_t model, uint32_t node)

Node display name, or NULL when the index is out of range.

Unnamed nodes

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.
`node`	`uint32_t`	Value for node.

Returns A borrowed pointer, or NULL when unavailable. return an empty string.

`mk_model_node_parent`function

int32_t mk_model_node_parent(mk_model_t model, uint32_t node)

Parent node index, or -1 for a root or invalid node.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.
`node`	`uint32_t`	Value for node.

Returns The resulting value.

`mk_model_pin`function

bool mk_model_pin(mk_model_t model)

Perform the model pin operation.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.

Returns True when the operation succeeds.

`mk_model_set_variant`function

bool mk_model_set_variant(mk_model_t model, int32_t index)

Select a KHR_materials_variants entry.

Pass -1 to restore the glTF default material

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.
`index`	`int32_t`	Zero-based index.

Returns True when the operation succeeds. bindings. Returns false when the model is invalid or the index is out of range.

`mk_model_system_shutdown`function

void mk_model_system_shutdown(void)

Perform the model system shutdown operation.

`mk_model_transmissive_count`function

uint32_t mk_model_transmissive_count(mk_model_t model)

Count transmissive primitives in the loaded model.

Useful for layered transmission passes where each glass primitive is composited into the capture

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.

Returns The resulting value. one at a time.

`mk_model_unpin`function

void mk_model_unpin(mk_model_t model)

Perform the model unpin operation.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.

`mk_model_variant_count`function

uint32_t mk_model_variant_count(mk_model_t model)

Number of KHR_materials_variants entries.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.

Returns The resulting value.

`mk_model_variant_index`function

int32_t mk_model_variant_index(mk_model_t model)

Current selected variant index, or -1 for the glTF default material bindings.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.

Returns The resulting value.

`mk_model_variant_name`function

const char * mk_model_variant_name(mk_model_t model, uint32_t index)

Variant display name, or NULL when index is out of range.

Parameter	Type	Description
`model`	`mk_model_t`	Value for model.
`index`	`uint32_t`	Zero-based index.

Returns A borrowed pointer, or NULL when unavailable.

Structs

`mk_model`struct

Data for model.

Field	Type	Description
`id`	`uint32_t`	The ID.

`mk_model_action`struct

Instance-owned animation action handle.

Pass the owning instance to every action function; handles are generational and become invalid when removed.

Field	Type	Description
`instance_id`	`uint32_t`	The instance ID.
`id`	`uint32_t`	The ID.

`mk_model_animation_event`struct

Event emitted by a playing action after mk_model_instance_update.

Field	Type	Description
`action`	`mk_model_action_t`	The action.
`animation`	`uint32_t`	The animation.
`time_sec`	`float`	The time sec.
`name`	`char`	The name.
`payload`	`int32_t`	The payload.

`mk_model_animation_marker`struct

Runtime marker attached to a source animation clip.

Field	Type	Description
`time_sec`	`float`	The time sec.
`name`	`char`	The name.
`payload`	`int32_t`	The payload.

`mk_model_instance`struct

Data for model instance.

Field	Type	Description
`id`	`uint32_t`	The ID.

`mk_model_root_motion`struct

Data for model root motion.

Field	Type	Description
`translation`	`mk_vec3`	The translation.
`yaw`	`float`	The yaw.

Enums

`mk_model_flags`enum

Load flags (bitfield).

Value	Description
`MK_MODEL_NONE`	Selects none.
`MK_MODEL_UNLIT`	use unlit materials instead of Blinn-Phong lit
`MK_MODEL_FLIP_UV`	flip texture V (for assets authored for D3D-style UVs)

Typedefs

`mk_model_action_t`typedef

typedef struct mk_model_action mk_model_action_t

Instance-owned animation action handle.

Pass the owning instance to every action function; handles are generational and become invalid when removed.

`mk_model_animation_event_t`typedef

typedef struct mk_model_animation_event mk_model_animation_event_t

Event emitted by a playing action after mk_model_instance_update.

`mk_model_animation_marker_t`typedef

typedef struct mk_model_animation_marker mk_model_animation_marker_t

Runtime marker attached to a source animation clip.

`mk_model_flags_t`typedef

typedef enum mk_model_flags mk_model_flags_t

Load flags (bitfield).

`mk_model_instance_t`typedef

typedef struct mk_model_instance mk_model_instance_t

Data for model instance.

`mk_model_mask_t`typedef

typedef struct mk_model_mask* mk_model_mask_t

Reusable, model-bound weighted node mask.

Assigning a mask to an action copies its weights, so the mask may be changed or destroyed afterward.

`mk_model_root_motion_t`typedef

typedef struct mk_model_root_motion mk_model_root_motion_t

Data for model root motion.

`mk_model_t`typedef

typedef struct mk_model mk_model_t

Data for model.

Macros

`MK_MODEL_ACTION_INVALID`define

MK_MODEL_ACTION_INVALID

Invalid sentinel for model action.

`MK_MODEL_ANIMATION_EVENT_NAME_MAX`define

MK_MODEL_ANIMATION_EVENT_NAME_MAX

Maximum supported model animation event name max.

`MK_MODEL_DRAW_ALL`define

MK_MODEL_DRAW_ALL

Constant for model draw all.

`MK_MODEL_DRAW_BLEND`define

MK_MODEL_DRAW_BLEND

alphaMode = BLEND

`MK_MODEL_DRAW_FORCE_IMMEDIATE`define

MK_MODEL_DRAW_FORCE_IMMEDIATE

bypass pass-level AUTO_BATCH

`MK_MODEL_DRAW_OPAQUE`define

MK_MODEL_DRAW_OPAQUE

Primitive categories for mk_model_draw_ex (a primitive is exactly one).

opaque, non-transmissive

`MK_MODEL_DRAW_TRANSMISSIVE`define

MK_MODEL_DRAW_TRANSMISSIVE

KHR_materials_transmission.

`MK_MODEL_INSTANCE_INVALID`define

MK_MODEL_INSTANCE_INVALID

Invalid sentinel for model instance.

`MK_MODEL_INVALID`define

MK_MODEL_INVALID

Invalid sentinel for model.

`MK_MODEL_MASK_INVALID`define

MK_MODEL_MASK_INVALID

Invalid sentinel for model mask.

`MK_MODEL_MAX_ACTIONS`define

MK_MODEL_MAX_ACTIONS

Maximum number of simultaneously retained actions on one model instance.

`MK_MODEL_PLAY_ADDITIVE`define

MK_MODEL_PLAY_ADDITIVE

Constant for model play additive.

`MK_MODEL_PLAY_LOOP`define

MK_MODEL_PLAY_LOOP

Constant for model play loop.

`MK_MODEL_ROOT_MOTION_ALL`define

MK_MODEL_ROOT_MOTION_ALL

Constant for model root motion all.

`MK_MODEL_ROOT_MOTION_TRANSLATION`define

MK_MODEL_ROOT_MOTION_TRANSLATION

Constant for model root motion translation.

`MK_MODEL_ROOT_MOTION_X`define

MK_MODEL_ROOT_MOTION_X

Constant for model root motion x.

`MK_MODEL_ROOT_MOTION_Y`define

MK_MODEL_ROOT_MOTION_Y

Constant for model root motion y.

`MK_MODEL_ROOT_MOTION_YAW`define

MK_MODEL_ROOT_MOTION_YAW

Constant for model root motion yaw.

`MK_MODEL_ROOT_MOTION_Z`define

MK_MODEL_ROOT_MOTION_Z

Constant for model root motion z.

model.h

Functions

mk_model_aabbfunction

mk_model_animation_countfunction

mk_model_animation_durationfunction

mk_model_animation_event_addfunction

mk_model_animation_event_countfunction

mk_model_animation_event_getfunction

mk_model_animation_events_clearfunction

mk_model_animation_findfunction

mk_model_animation_namefunction

mk_model_copy_lightsfunction

mk_model_destroyfunction

mk_model_drawfunction

mk_model_draw_exfunction

mk_model_draw_transmissive_layerfunction

mk_model_instance_aabbfunction

mk_model_instance_action_clear_maskfunction

mk_model_instance_action_fade_tofunction

mk_model_instance_action_is_playingfunction

mk_model_instance_action_is_validfunction

mk_model_instance_action_playfunction

mk_model_instance_action_removefunction

mk_model_instance_action_set_maskfunction

mk_model_instance_action_set_playingfunction

mk_model_instance_action_set_speedfunction

mk_model_instance_action_set_timefunction

mk_model_instance_action_set_weightfunction

mk_model_instance_action_speedfunction

mk_model_instance_action_timefunction

mk_model_instance_action_weightfunction

mk_model_instance_clear_animation_eventsfunction

mk_model_instance_consume_root_motionfunction

mk_model_instance_copy_lightsfunction

mk_model_instance_createfunction

mk_model_instance_crossfadefunction

mk_model_instance_destroyfunction

mk_model_instance_drawfunction

mk_model_instance_draw_exfunction

mk_model_instance_draw_transmissive_layerfunction

mk_model_instance_is_validfunction

mk_model_instance_light_countfunction

mk_model_instance_pinfunction

mk_model_instance_playfunction

mk_model_instance_poll_animation_eventfunction

mk_model_instance_primary_actionfunction

mk_model_instance_set_root_motionfunction

mk_model_instance_set_speedfunction

mk_model_instance_set_timefunction

mk_model_instance_stopfunction

mk_model_instance_timefunction

mk_model_instance_transmissive_countfunction

mk_model_instance_unpinfunction

mk_model_instance_updatefunction

mk_model_is_validfunction

mk_model_light_countfunction

mk_model_loadfunction

mk_model_mask_createfunction

mk_model_mask_destroyfunction

mk_model_mask_set_nodefunction

mk_model_material_countfunction

mk_model_mesh_countfunction

mk_model_node_countfunction

mk_model_node_findfunction

mk_model_node_namefunction

mk_model_node_parentfunction

mk_model_pinfunction

mk_model_set_variantfunction

mk_model_system_shutdownfunction

mk_model_transmissive_countfunction

mk_model_unpinfunction

mk_model_variant_countfunction

mk_model_variant_indexfunction

mk_model_variant_namefunction

Structs

mk_modelstruct

mk_model_actionstruct

mk_model_animation_eventstruct

mk_model_animation_markerstruct

mk_model_instancestruct

`mk_model_aabb`function

`mk_model_animation_count`function

`mk_model_animation_duration`function

`mk_model_animation_event_add`function

`mk_model_animation_event_count`function

`mk_model_animation_event_get`function

`mk_model_animation_events_clear`function

`mk_model_animation_find`function

`mk_model_animation_name`function

`mk_model_copy_lights`function

`mk_model_destroy`function

`mk_model_draw`function

`mk_model_draw_ex`function

`mk_model_draw_transmissive_layer`function

`mk_model_instance_aabb`function

`mk_model_instance_action_clear_mask`function

`mk_model_instance_action_fade_to`function

`mk_model_instance_action_is_playing`function

`mk_model_instance_action_is_valid`function

`mk_model_instance_action_play`function

`mk_model_instance_action_remove`function

`mk_model_instance_action_set_mask`function

`mk_model_instance_action_set_playing`function

`mk_model_instance_action_set_speed`function

`mk_model_instance_action_set_time`function

`mk_model_instance_action_set_weight`function

`mk_model_instance_action_speed`function

`mk_model_instance_action_time`function

`mk_model_instance_action_weight`function

`mk_model_instance_clear_animation_events`function

`mk_model_instance_consume_root_motion`function

`mk_model_instance_copy_lights`function

`mk_model_instance_create`function

`mk_model_instance_crossfade`function

`mk_model_instance_destroy`function

`mk_model_instance_draw`function

`mk_model_instance_draw_ex`function

`mk_model_instance_draw_transmissive_layer`function

`mk_model_instance_is_valid`function

`mk_model_instance_light_count`function

`mk_model_instance_pin`function

`mk_model_instance_play`function

`mk_model_instance_poll_animation_event`function

`mk_model_instance_primary_action`function

`mk_model_instance_set_root_motion`function

`mk_model_instance_set_speed`function

`mk_model_instance_set_time`function

`mk_model_instance_stop`function

`mk_model_instance_time`function

`mk_model_instance_transmissive_count`function

`mk_model_instance_unpin`function

`mk_model_instance_update`function

`mk_model_is_valid`function

`mk_model_light_count`function

`mk_model_load`function

`mk_model_mask_create`function

`mk_model_mask_destroy`function

`mk_model_mask_set_node`function

`mk_model_material_count`function

`mk_model_mesh_count`function

`mk_model_node_count`function

`mk_model_node_find`function

`mk_model_node_name`function

`mk_model_node_parent`function

`mk_model_pin`function

`mk_model_set_variant`function

`mk_model_system_shutdown`function

`mk_model_transmissive_count`function

`mk_model_unpin`function

`mk_model_variant_count`function

`mk_model_variant_index`function

`mk_model_variant_name`function

`mk_model`struct

`mk_model_action`struct

`mk_model_animation_event`struct

`mk_model_animation_marker`struct

`mk_model_instance`struct

`mk_model_root_motion`struct

`mk_model_flags`enum

`mk_model_action_t`typedef