texture.h

#include <modkit/texture.h>36 functions · 3 structs · 4 enums · 7 typedefs · 1 macros

Texture loading and management.

GPU texture loading and management with stb_image. Supports: PNG, JPG/JPEG, BMP, TGA, GIF, PSD, HDR, PIC For low-level GPU interop, include modkit.h and use the escape hatch accessor mk_texture_get_bgfx_handle() (via modkit.h).

Functions

`mk_texture_calc_info`function

mk_texture_info_t mk_texture_calc_info(uint16_t width, uint16_t height, uint16_t depth, bool cube, bool has_mips, uint16_t num_layers, mk_texture_format_t format)

Calculate storage size / mip count / bits-per-pixel for a texture shape without creating it.

Useful to size a staging buffer before mk_texture_update_*.

Parameter	Type	Description
`width`	`uint16_t`	Value for width.
`height`	`uint16_t`	Value for height.
`depth`	`uint16_t`	Value for depth.
`cube`	`bool`	Value for cube.
`has_mips`	`bool`	Value for has mips.
`num_layers`	`uint16_t`	Value for num layers.
`format`	`mk_texture_format_t`	Value for format.

Returns The resulting handle or value.

`mk_texture_create`function

mk_texture_t mk_texture_create(uint16_t width, uint16_t height, const void *pixels, uint32_t flags)

Create texture from raw RGBA pixels.

Parameter	Type	Description
`width`	`uint16_t`	Texture width
`height`	`uint16_t`	Texture height
`pixels`	`const void *`	RGBA pixel data (4 bytes per pixel)
`flags`	`uint32_t`	Texture flags (MK_TEXTURE_*)

Returns Texture or MK_TEXTURE_INVALID on failure

`mk_texture_create_2d_rt`function

mk_texture_t mk_texture_create_2d_rt(uint16_t width, uint16_t height, mk_texture_format_t format, uint8_t num_mips, uint64_t sampler_flags)

Create an empty 2D render-target texture, optionally with a mip chain.

Target each mip by building a framebuffer via mk_framebuf_create_from_attachments() with layer=0, mip=k. Used for the GPU-generated BRDF LUT (num_mips=1) and the prefiltered equirect specular map (one mip per roughness level).

Parameter	Type	Description
`width`	`uint16_t`	Texture width
`height`	`uint16_t`	Texture height
`format`	`mk_texture_format_t`	Texture format (e.g. MK_TEXTURE_FORMAT_RGBA16F)
`num_mips`	`uint8_t`	Mip count (1 = no mips)
`sampler_flags`	`uint64_t`	Sampler flags (MK_SAMPLER_*); the render-target flag is added internally

Returns Texture or MK_TEXTURE_INVALID on failure

`mk_texture_create_3d`function

mk_texture_t mk_texture_create_3d(uint16_t width, uint16_t height, uint16_t depth, mk_texture_format_t format, uint64_t sampler_flags, const void *data, uint32_t data_size, bool has_mips)

Create a 3D (volume) texture.

NULL data (data_size 0) creates a mutable empty texture updatable later via mk_texture_update_3d (e.g. a runtime color LUT).

Parameter	Type	Description
`width`	`uint16_t`	Volume dimensions
`height`	`uint16_t`	Volume dimensions
`depth`	`uint16_t`	Volume dimensions
`format`	`mk_texture_format_t`	Texture format (MK_TEXTURE_FORMAT_*)
`sampler_flags`	`uint64_t`	Sampler flags (MK_SAMPLER_*)
`data`	`const void *`	Pixel data for the whole volume, or NULL for mutable empty
`data_size`	`uint32_t`	Size of data in bytes (0 with NULL data)
`has_mips`	`bool`	Allocate a mip chain

Returns Texture or MK_TEXTURE_INVALID on failure

`mk_texture_create_cube`function

mk_texture_t mk_texture_create_cube(uint16_t face_size, mk_texture_format_t format, uint64_t sampler_flags, const void *data, uint32_t data_size, bool has_mips)

Create a (non-render-target) cubemap.

NULL data creates a mutable empty cube updatable later via mk_texture_update_cube. When data is provided it must hold all six faces in order +X,-X,+Y,-Y,+Z,-Z, each face's mip chain packed in order. For a renderable cubemap (IBL prefilter targets) use mk_texture_create_cube_rt.

Parameter	Type	Description
`face_size`	`uint16_t`	Edge length of each cube face (mip 0)
`format`	`mk_texture_format_t`	Texture format (MK_TEXTURE_FORMAT_*)
`sampler_flags`	`uint64_t`	Sampler flags (MK_SAMPLER_*)
`data`	`const void *`	Packed 6-face data, or NULL for mutable empty
`data_size`	`uint32_t`	Size of data in bytes (0 with NULL data)
`has_mips`	`bool`	Allocate a mip chain

Returns Cubemap texture or MK_TEXTURE_INVALID on failure

`mk_texture_create_cube_rt`function

mk_texture_t mk_texture_create_cube_rt(uint16_t face_size, mk_texture_format_t format, uint8_t num_mips, uint64_t sampler_flags)

Create an empty render-target cubemap with an optional mip chain.

Each face+mip can be targeted individually by building a framebuffer via mk_framebuf_create_from_attachments(). Used for GPU IBL prefiltering (panorama->cube, GGX prefilter).

Parameter	Type	Description
`face_size`	`uint16_t`	Edge length of each cube face (mip 0)
`format`	`mk_texture_format_t`	Texture format (e.g. MK_TEXTURE_FORMAT_RGBA16F)
`num_mips`	`uint8_t`	Mip count (1 = no mips)
`sampler_flags`	`uint64_t`	Sampler flags (MK_SAMPLER_*); render-target and blit-destination flags are added internally

Returns Cubemap texture or MK_TEXTURE_INVALID on failure

`mk_texture_create_hdr_mips`function

mk_texture_t mk_texture_create_hdr_mips(int width, int height, const float *pixels, uint64_t sampler_flags)

Upload linear float RGBA pixels to a MIPPED RGBA16F 2D texture (CPU-built mip chain).

For IBL filtered-importance-sampling: the GGX prefilter reads pre-blurred mips so glossy reflections stay low-variance/smooth instead of grainy. The HDR file loader cannot mip float data; build the env once and pass its pixels here.

Parameter	Type	Description
`width`	`int`	Texture width
`height`	`int`	Texture height
`pixels`	`const float *`	Tightly packed RGBA float pixels (4 components/texel, linear)
`sampler_flags`	`uint64_t`	Sampler flags (MK_SAMPLER_*)

Returns Mipped texture or MK_TEXTURE_INVALID on failure

`mk_texture_create_r8`function

mk_texture_t mk_texture_create_r8(uint16_t width, uint16_t height, const void *pixels, uint32_t flags)

Create single-channel (R8) texture.

Useful for font atlases, masks, etc.

Parameter	Type	Description
`width`	`uint16_t`	Texture width
`height`	`uint16_t`	Texture height
`pixels`	`const void *`	R8 pixel data (1 byte per pixel), or NULL for empty texture
`flags`	`uint32_t`	Texture flags (MK_TEXTURE_*)

Returns Texture or MK_TEXTURE_INVALID on failure

`mk_texture_create_raw`function

mk_texture_t mk_texture_create_raw(uint16_t width, uint16_t height, mk_texture_format_t format, uint64_t sampler_flags, const void *data, uint32_t data_size)

Create texture with explicit format and sampler flags.

Used for specialized textures like HDR panoramas, BRDF LUTs, etc.

Parameter	Type	Description
`width`	`uint16_t`	Texture width
`height`	`uint16_t`	Texture height
`format`	`mk_texture_format_t`	Texture format (MK_TEXTURE_FORMAT_*)
`sampler_flags`	`uint64_t`	Sampler flags (MK_SAMPLER_*)
`data`	`const void *`	Raw pixel data
`data_size`	`uint32_t`	Size of data in bytes

Returns Texture or MK_TEXTURE_INVALID on failure

`mk_texture_create_readback`function

mk_texture_t mk_texture_create_readback(uint16_t width, uint16_t height, mk_texture_format_t format)

Create an empty texture suitable as a GPU->CPU read-back / blit destination (created with blit-dst + read-back flags).

Blit a render target into it with mk_encoder_blit(), then retrieve the pixels with mk_texture_read(). Requires BGFX_CAPS_TEXTURE_READ_BACK (see mk_has_feature). Returns MK_TEXTURE_INVALID on failure.

Parameter	Type	Description
`width`	`uint16_t`	Texture width
`height`	`uint16_t`	Texture height
`format`	`mk_texture_format_t`	Texture format (match the source you will blit, e.g. RGBA8)

Returns Texture or MK_TEXTURE_INVALID

`mk_texture_create_storage`function

mk_texture_t mk_texture_create_storage(uint16_t width, uint16_t height, mk_texture_format_t format, uint64_t sampler_flags)

Create a compute-writable storage image (empty 2D texture).

Bind it to a compute dispatch via mk_dispatch (image binding) / mk_encoder_set_image with MK_ACCESS_WRITE or _READWRITE; the texture is also sampleable, so a later draw pass can read what the compute shader wrote. Use a compute-writable format (e.g. MK_TEXTURE_FORMAT_RGBA8).

Parameter	Type	Description
`width`	`uint16_t`	Texture width
`height`	`uint16_t`	Texture height
`format`	`mk_texture_format_t`	Texture format (e.g. MK_TEXTURE_FORMAT_RGBA8)
`sampler_flags`	`uint64_t`	Sampler flags (MK_SAMPLER_*); the compute-write flag is added internally

Returns Texture or MK_TEXTURE_INVALID on failure

`mk_texture_cube_rt_supported`function

bool mk_texture_cube_rt_supported(mk_texture_format_t format)

Query whether a format can be used as a render-target cubemap (and as a 2D render target).

Use to gate GPU IBL prefiltering before creating resources.

Parameter	Type	Description
`format`	`mk_texture_format_t`	Texture format to test

Returns true if the backend supports rendering into a cubemap of this format

`mk_texture_destroy`function

void mk_texture_destroy(mk_texture_t texture)

Release the public owner reference.

The handle becomes publicly invalid immediately; resources that already retained it keep it alive until release.

Parameter	Type	Description
`texture`	`mk_texture_t`	Value for texture.

`mk_texture_format_mip_autogen`function

bool mk_texture_format_mip_autogen(mk_texture_format_t format)

Query whether render-target resolves can auto-generate mipmaps for this format.

Required for framebuffers created with mk_framebuf_create_from_attachments_autogen_mips.

Parameter	Type	Description
`format`	`mk_texture_format_t`	Texture format to test

Returns true if the backend can auto-generate mipmaps for this format

`mk_texture_free_hdr_rgba_f`function

void mk_texture_free_hdr_rgba_f(float *pixels)

Free pixels returned by mk_texture_load_hdr_rgba_f.

Parameter	Type	Description
`pixels`	`float *`	Value for pixels.

`mk_texture_get_depth`function

uint16_t mk_texture_get_depth(mk_texture_t texture)

Get texture depth (1 for 2D/cube textures; the depth for 3D textures).

Parameter	Type	Description
`texture`	`mk_texture_t`	Value for texture.

Returns The resulting value.

`mk_texture_get_direct_access_ptr`function

void * mk_texture_get_direct_access_ptr(mk_texture_t texture)

Direct CPU-visible pointer to the texture's memory, if the backend supports it (e.g.

unified-memory GPUs). Returns NULL when direct access is unavailable. The pointer is stable until the texture is destroyed.

Parameter	Type	Description
`texture`	`mk_texture_t`	Value for texture.

Returns A borrowed pointer, or NULL when unavailable.

`mk_texture_get_height`function

uint16_t mk_texture_get_height(mk_texture_t texture)

Get texture height.

Parameter	Type	Description
`texture`	`mk_texture_t`	Value for texture.

Returns The resulting value.

`mk_texture_get_size`function

void mk_texture_get_size(mk_texture_t texture, uint16_t *width, uint16_t *height)

Get texture dimensions.

Parameter	Type	Description
`texture`	`mk_texture_t`	Value for texture.
`width`	`uint16_t *`	Value for width.
`height`	`uint16_t *`	Value for height.

`mk_texture_get_width`function

uint16_t mk_texture_get_width(mk_texture_t texture)

Get texture width.

Parameter	Type	Description
`texture`	`mk_texture_t`	Value for texture.

Returns The resulting value.

`mk_texture_is_creatable`function

bool mk_texture_is_creatable(uint16_t depth, bool cube, uint16_t num_layers, mk_texture_format_t format, uint64_t texture_flags)

Whether a texture with the given properties can be created on this backend.

texture_flags is the full bgfx texture flag bitset (BGFX_TEXTURE_ and BGFX_SAMPLER_ flags), not just sampler bits.

Parameter	Type	Description
`depth`	`uint16_t`	Value for depth.
`cube`	`bool`	Value for cube.
`num_layers`	`uint16_t`	Value for num layers.
`format`	`mk_texture_format_t`	Value for format.
`texture_flags`	`uint64_t`	Value for texture flags.

Returns True when the condition holds.

`mk_texture_is_valid`function

bool mk_texture_is_valid(mk_texture_t texture)

Check if a texture is publicly valid and not pending destruction.

Parameter	Type	Description
`texture`	`mk_texture_t`	Value for texture.

Returns True when the condition holds.

`mk_texture_load`function

mk_texture_t mk_texture_load(const char *path, uint32_t flags)

Load texture from file.

Supports PNG, JPG, BMP, TGA, GIF, PSD, HDR, PIC. Floating-point HDR (.hdr): pass MK_TEXTURE_HDR to decode as float into an RGBA16F texture (linear; sRGB is ignored). HDR files are also auto-detected, so a .hdr without the flag still loads as float (never silently tonemapped to 8-bit). MK_TEXTURE_MIPS is ignored on HDR loads (warns) — build a prefilter mip chain via render targets. For RGBA32F or fine control, use mk_texture_load_ex with mk_texture_load_desc.hdr / .hdr_format.

Parameter	Type	Description
`path`	`const char *`	Path to image file
`flags`	`uint32_t`	Texture flags (MK_TEXTURE_*)

Returns Texture or MK_TEXTURE_INVALID on failure

`mk_texture_load_cube`function

mk_texture_t mk_texture_load_cube(const char *const faces[6], uint32_t flags)

Load a cubemap from six image files (one per face).

Face order: +X, -X, +Y, -Y, +Z, -Z (right, left, top, bottom, front, back). All faces must be square and the same size. A full mip chain is generated per face. Sample in shaders with SAMPLERCUBE; bind like any texture.

Parameter	Type	Description
`faces`	`const char *const`	Six file paths in +X -X +Y -Y +Z -Z order
`flags`	`uint32_t`	Texture flags (MK_TEXTURE_*)

Returns Texture or MK_TEXTURE_INVALID on failure

const char* faces[6] = {
    "sky/right.jpg", "sky/left.jpg",
    "sky/top.jpg",   "sky/bottom.jpg",
    "sky/front.jpg", "sky/back.jpg",
};
mk_texture_t sky = mk_texture_load_cube(faces, MK_TEXTURE_CLAMP);

`mk_texture_load_ex`function

mk_texture_t mk_texture_load_ex(const mk_texture_load_desc *desc)

Load a texture from a full configuration descriptor (the power path).

Use this when you need per-load control over mips, filtering and anisotropy beyond what the flag shorthand expresses. mk_texture_load()/_mem() are sugar over this.

Parameter	Type	Description
`desc`	`const mk_texture_load_desc *`	Load configuration (path OR bytes+bytes_size)

Returns Texture or MK_TEXTURE_INVALID on failure

mk_texture_t t = mk_texture_load_ex(&(mk_texture_load_desc){
    .path = "wall.png", .srgb = true,
    .mips = MK_MIPS_ON, .filter = MK_FILTER_ANISOTROPIC, .aniso = 8,
});

`mk_texture_load_hdr_rgba_f`function

float * mk_texture_load_hdr_rgba_f(const char *path, bool flip_v, int *out_w, int *out_h)

Decode an .hdr file to tightly packed RGBA float pixels in CPU RAM (4 floats per texel, linear).

The IBL package uses this to build the GPU equirect and to project SH-9 from the same pixels. Free the result with mk_texture_free_hdr_rgba_f.

Parameter	Type	Description
`path`	`const char *`	Path to a .hdr (radiance) file
`flip_v`	`bool`	Reverse row order (stb decodes top-down)
`out_w`	`int *`	Receives width (may be NULL)
`out_h`	`int *`	Receives height (may be NULL)

Returns malloc'd RGBA float pixels, or NULL on failure

`mk_texture_load_mem`function

mk_texture_t mk_texture_load_mem(const void *data, uint32_t size, uint32_t flags)

Load texture from memory.

Parameter	Type	Description
`data`	`const void *`	Pointer to image data (encoded PNG/JPG/etc)
`size`	`uint32_t`	Size of image data in bytes
`flags`	`uint32_t`	Texture flags (MK_TEXTURE_*)

Returns Texture or MK_TEXTURE_INVALID on failure

`mk_texture_pin`function

bool mk_texture_pin(mk_texture_t texture)

Retain a texture for an existing resource dependency or resolved draw.

Parameter	Type	Description
`texture`	`mk_texture_t`	Value for texture.

Returns True when the operation succeeds.

`mk_texture_read`function

uint32_t mk_texture_read(mk_texture_t texture, void *dest)

Read a texture back from the GPU into CPU memory (async).

The texture must have been created read-back capable (created blit-readable; e.g. a render target, or a texture made with the read-back flag). dest must be large enough for the full mip-0 image (width * height * bytes-per-pixel of the texture's format). The copy is NOT ready immediately: it completes on a future frame. The return value is the frame number at which dest will contain valid data — keep calling mk_frame_end(); query mk_frame_number() for the submitted frame number and only read dest once that counter reaches the returned frame.

Parameter	Type	Description
`texture`	`mk_texture_t`	Value for texture.
`dest`	`void *`	Value for dest.

Returns The frame number when the data will be available, or 0 on error (invalid texture / not read-back capable on this renderer).

`mk_texture_set_name`function

void mk_texture_set_name(mk_texture_t texture, const char *name)

Set debug name for texture.

Parameter	Type	Description
`texture`	`mk_texture_t`	Texture handle
`name`	`const char *`	Debug name string

`mk_texture_system_init`function

void mk_texture_system_init(void)

Initialize the texture system.

`mk_texture_system_shutdown`function

void mk_texture_system_shutdown(void)

Perform the texture system shutdown operation.

`mk_texture_unpin`function

void mk_texture_unpin(mk_texture_t texture)

Perform the texture unpin operation.

Parameter	Type	Description
`texture`	`mk_texture_t`	Value for texture.

`mk_texture_update`function

void mk_texture_update(mk_texture_t texture, uint16_t x, uint16_t y, uint16_t width, uint16_t height, const void *pixels, uint16_t pitch)

Update a region of a texture.

Parameter	Type	Description
`texture`	`mk_texture_t`	Texture to update
`x`	`uint16_t`	X offset in texture
`y`	`uint16_t`	Y offset in texture
`width`	`uint16_t`	Width of region to update
`height`	`uint16_t`	Height of region to update
`pixels`	`const void *`	Pixel data (format must match texture format)
`pitch`	`uint16_t`	Row pitch in bytes (0 = tightly packed)

`mk_texture_update_3d`function

void mk_texture_update_3d(mk_texture_t texture, uint8_t mip, uint16_t x, uint16_t y, uint16_t z, uint16_t width, uint16_t height, uint16_t depth, const void *data, uint32_t data_size)

Update a sub-volume of a 3D texture (mip level mip, origin x/y/z).

data_size must cover width*height*depth*bytes-per-texel.

Parameter	Type	Description
`texture`	`mk_texture_t`	Value for texture.
`mip`	`uint8_t`	Value for mip.
`x`	`uint16_t`	Value for x.
`y`	`uint16_t`	Value for y.
`z`	`uint16_t`	Value for z.
`width`	`uint16_t`	Value for width.
`height`	`uint16_t`	Value for height.
`depth`	`uint16_t`	Value for depth.
`data`	`const void *`	Data buffer.
`data_size`	`uint32_t`	Data size in bytes.

`mk_texture_update_cube`function

void mk_texture_update_cube(mk_texture_t texture, uint16_t layer, uint8_t face, uint8_t mip, uint16_t x, uint16_t y, uint16_t width, uint16_t height, const void *data, uint32_t data_size, uint16_t pitch)

Update a region of one cubemap face.

face is 0..5 (+X,-X,+Y,-Y,+Z,-Z); layer is the array layer (0 for a non-array cubemap). pitch 0 => tightly packed.

Parameter	Type	Description
`texture`	`mk_texture_t`	Value for texture.
`layer`	`uint16_t`	Value for layer.
`face`	`uint8_t`	Value for face.
`mip`	`uint8_t`	Value for mip.
`x`	`uint16_t`	Value for x.
`y`	`uint16_t`	Value for y.
`width`	`uint16_t`	Value for width.
`height`	`uint16_t`	Value for height.
`data`	`const void *`	Data buffer.
`data_size`	`uint32_t`	Data size in bytes.
`pitch`	`uint16_t`	Value for pitch.

Structs

`mk_texture`struct

Data for texture.

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

`mk_texture_info`struct

Computed storage info for a texture of the given shape (does NOT allocate).

Mirrors bgfx_texture_info_t.

Field	Type	Description
`format`	`mk_texture_format_t`	The format.
`storage_size`	`uint32_t`	total bytes required to store the texture
`width`	`uint16_t`	The width.
`height`	`uint16_t`	The height.
`depth`	`uint16_t`	The depth.
`num_layers`	`uint16_t`	The num layers.
`num_mips`	`uint8_t`	The num mips.
`bits_per_pixel`	`uint8_t`	The bits per pixel.
`cube`	`bool`	The cube.

`mk_texture_load_desc`struct

Full texture-load configuration (power path; mk_texture_load(path,flags) is sugar over this).

Zero-init = sane defaults: no mips, linear filter, repeat.

Field	Type	Description
`path`	`const char *`	file path; OR set bytes+bytes_size for a memory load
`bytes`	`const void *`	encoded image bytes (PNG/JPG/...) for memory load
`bytes_size`	`size_t`	The bytes size.
`mips`	`mk_mip_mode_t`	default MK_MIPS_NONE (opt-in)
`mip_gen`	`mk_mipgen_t`	hint, only meaningful with MK_MIPS_ON
`filter`	`mk_filter_mode_t`	default MK_FILTER_LINEAR
`aniso`	`uint8_t`	max anisotropy for ANISOTROPIC (0 = driver default)
`srgb`	`bool`	ignored on the HDR path (HDR data is already linear)
`flip_v`	`bool`	The flip v.
`clamp_u`	`bool`	The clamp u.
`clamp_v`	`bool`	The clamp v.
`hdr`	`bool`	decode as float; auto-set when the source is detected HDR
`hdr_format`	`mk_texture_format_t`	HDR only: 0 = default (RGBA16F), or RGBA16F / RGBA32F.

Enums

`mk_filter_mode`enum

Values for filter mode.

Value	Description
`MK_FILTER_LINEAR`	bilinear (+ trilinear when mipped)
`MK_FILTER_POINT`	nearest (pixel art)
`MK_FILTER_ANISOTROPIC`	linear + anisotropic

`mk_mip_mode`enum

Values for mip mode.

Value	Description
`MK_MIPS_NONE`	Create no mip chain.
`MK_MIPS_ON`	Create or load a mip chain.

`mk_mipgen`enum

Values for mipgen.

Value	Description
`MK_MIPGEN_CPU`	Generate missing mips on the CPU.
`MK_MIPGEN_GPU`	Generate missing mips on the GPU when supported.

`mk_texture_flags`enum

Values for texture flags.

Value	Description
`MK_TEXTURE_NONE`	Selects none.
`MK_TEXTURE_CLAMP_U`	Clamp U coordinate.
`MK_TEXTURE_CLAMP_V`	Clamp V coordinate.
`MK_TEXTURE_CLAMP`	Selects clamp.
`MK_TEXTURE_POINT`	Point/nearest filtering.
`MK_TEXTURE_SRGB`	sRGB color space
`MK_TEXTURE_FLIP_V`	Flip texture vertically on load.
`MK_TEXTURE_MIPS`	Generate a mip chain (OPT-IN; off by default).
`MK_TEXTURE_MIPS_GPU`	Hint (only with MK_TEXTURE_MIPS): GPU-generate, not CPU.
`MK_TEXTURE_HDR`	Decode as float (e.g.

Typedefs

`mk_filter_mode_t`typedef

typedef enum mk_filter_mode mk_filter_mode_t

Values for filter mode.

`mk_mip_mode_t`typedef

typedef enum mk_mip_mode mk_mip_mode_t

Values for mip mode.

`mk_mipgen_t`typedef

typedef enum mk_mipgen mk_mipgen_t

Values for mipgen.

`mk_texture_flags_t`typedef

typedef enum mk_texture_flags mk_texture_flags_t

Values for texture flags.

`mk_texture_info_t`typedef

typedef struct mk_texture_info mk_texture_info_t

Computed storage info for a texture of the given shape (does NOT allocate).

Mirrors bgfx_texture_info_t.

`mk_texture_load_desc`typedef

typedef struct mk_texture_load_desc mk_texture_load_desc

Full texture-load configuration (power path; mk_texture_load(path,flags) is sugar over this).

Zero-init = sane defaults: no mips, linear filter, repeat.

`mk_texture_t`typedef

typedef struct mk_texture mk_texture_t

Data for texture.

Macros

`MK_TEXTURE_INVALID`define

MK_TEXTURE_INVALID

Invalid sentinel for texture.

texture.h

Functions

mk_texture_calc_infofunction

mk_texture_createfunction

mk_texture_create_2d_rtfunction

mk_texture_create_3dfunction

mk_texture_create_cubefunction

mk_texture_create_cube_rtfunction

mk_texture_create_hdr_mipsfunction

mk_texture_create_r8function

mk_texture_create_rawfunction

mk_texture_create_readbackfunction

mk_texture_create_storagefunction

mk_texture_cube_rt_supportedfunction

mk_texture_destroyfunction

mk_texture_format_mip_autogenfunction

mk_texture_free_hdr_rgba_ffunction

mk_texture_get_depthfunction

mk_texture_get_direct_access_ptrfunction

mk_texture_get_heightfunction

mk_texture_get_sizefunction

mk_texture_get_widthfunction

mk_texture_is_creatablefunction

mk_texture_is_validfunction

mk_texture_loadfunction

mk_texture_load_cubefunction

mk_texture_load_exfunction

mk_texture_load_hdr_rgba_ffunction

mk_texture_load_memfunction

mk_texture_pinfunction

mk_texture_readfunction

mk_texture_set_namefunction

mk_texture_system_initfunction

mk_texture_system_shutdownfunction

mk_texture_unpinfunction

mk_texture_updatefunction

mk_texture_update_3dfunction

mk_texture_update_cubefunction

Structs

mk_texturestruct

mk_texture_infostruct

mk_texture_load_descstruct

Enums

mk_filter_modeenum

mk_mip_modeenum

mk_mipgenenum

mk_texture_flagsenum

Typedefs

mk_filter_mode_ttypedef

mk_mip_mode_ttypedef

mk_mipgen_ttypedef

mk_texture_flags_ttypedef

mk_texture_info_ttypedef

mk_texture_load_desctypedef

mk_texture_ttypedef

Macros

MK_TEXTURE_INVALIDdefine

`mk_texture_calc_info`function

`mk_texture_create`function

`mk_texture_create_2d_rt`function

`mk_texture_create_3d`function

`mk_texture_create_cube`function

`mk_texture_create_cube_rt`function

`mk_texture_create_hdr_mips`function

`mk_texture_create_r8`function

`mk_texture_create_raw`function

`mk_texture_create_readback`function

`mk_texture_create_storage`function

`mk_texture_cube_rt_supported`function

`mk_texture_destroy`function

`mk_texture_format_mip_autogen`function

`mk_texture_free_hdr_rgba_f`function

`mk_texture_get_depth`function

`mk_texture_get_direct_access_ptr`function

`mk_texture_get_height`function

`mk_texture_get_size`function

`mk_texture_get_width`function

`mk_texture_is_creatable`function

`mk_texture_is_valid`function

`mk_texture_load`function

`mk_texture_load_cube`function

`mk_texture_load_ex`function

`mk_texture_load_hdr_rgba_f`function

`mk_texture_load_mem`function

`mk_texture_pin`function

`mk_texture_read`function

`mk_texture_set_name`function

`mk_texture_system_init`function

`mk_texture_system_shutdown`function

`mk_texture_unpin`function

`mk_texture_update`function

`mk_texture_update_3d`function

`mk_texture_update_cube`function

`mk_texture`struct

`mk_texture_info`struct

`mk_texture_load_desc`struct

`mk_filter_mode`enum

`mk_mip_mode`enum

`mk_mipgen`enum

`mk_texture_flags`enum

`mk_filter_mode_t`typedef

`mk_mip_mode_t`typedef

`mk_mipgen_t`typedef

`mk_texture_flags_t`typedef

`mk_texture_info_t`typedef

`mk_texture_load_desc`typedef

`mk_texture_t`typedef

`MK_TEXTURE_INVALID`define