texture_system.h

Go to the documentation of this file.

 
#pragma once
 
#include <assets/kasset_types.h>
#include <core_render_types.h>
 
#include "kresources/kresource_types.h"
 
struct texture_system_state;
 
typedef struct texture_system_config {
    u16 max_texture_count;
} texture_system_config;
 
#define DEFAULT_TEXTURE_NAME "Texture.Default"
 
#define DEFAULT_BASE_COLOUR_TEXTURE_NAME "Texture.DefaultBase"
 
#define DEFAULT_SPECULAR_TEXTURE_NAME "Texture.DefaultSpecular"
 
#define DEFAULT_NORMAL_TEXTURE_NAME "Texture.DefaultNormal"
 
#define DEFAULT_MRA_TEXTURE_NAME "Texture.DefaultMRA"
 
#define DEFAULT_CUBE_TEXTURE_NAME "Texture.DefaultCube"
 
#define DEFAULT_WATER_NORMAL_TEXTURE_NAME "Texture.DefaultWaterNormal"
 
#define DEFAULT_WATER_DUDV_TEXTURE_NAME "Texture.DefaultWaterDUDV"
 
b8 texture_system_initialize(u64* memory_requirement, void* state, void* config);
 
void texture_system_shutdown(void* state);
 
typedef void (*PFN_texture_loaded_callback)(ktexture texture, void* listener);
 
KAPI ktexture texture_acquire(kname image_asset_name, void* listener, PFN_texture_loaded_callback callback);
 
KAPI ktexture texture_acquire_sync(kname image_asset_name);
 
KAPI void texture_release(ktexture texture);
 
KAPI ktexture texture_acquire_from_package(kname image_asset_name, kname package_name, void* listener, PFN_texture_loaded_callback callback);
 
KAPI ktexture texture_acquire_from_package_sync(kname image_asset_name, kname package_name);
 
KAPI ktexture texture_cubemap_acquire(kname image_asset_name_prefix, void* listener, PFN_texture_loaded_callback callback);
 
KAPI ktexture texture_cubemap_acquire_sync(kname image_asset_name_prefix);
 
KAPI ktexture texture_cubemap_acquire_from_package(kname image_asset_name_prefix, kname package_name, void* listener, PFN_texture_loaded_callback callback);
 
KAPI ktexture texture_cubemap_acquire_from_package_sync(kname image_asset_name_prefix, kname package_name);
 
// Easier idea? synchronous. auto_release=true, default options
KAPI ktexture texture_acquire_from_image(const kasset_image* image, kname name);
 
KAPI ktexture texture_acquire_from_pixel_data(kpixel_format format, u32 pixel_array_size, void* pixels, u32 width, u32 height, kname name);
 
KAPI ktexture texture_cubemap_acquire_from_pixel_data(kpixel_format format, u32 pixel_array_size, void* pixels, u32 width, u32 height, kname name);
 
/* KAPI ktexture texture_cubemap_acquire_from_images(const struct kasset_image* images[6]); */
 
typedef struct ktexture_load_options {
    b8 is_writeable;
    b8 is_depth;
    b8 is_stencil;
    b8 multiframe_buffering;
    // Unload from GPU when reference count reaches 0.
    b8 auto_release;
    kpixel_format format;
    ktexture_type type;
    u32 width;
    u32 height;
    // Set to 0 to calculate mip levels based on size.
    u8 mip_levels;
    union {
        u32 depth;
        u32 layer_count;
    };
    kname name;
    // The name of the image asset to load for the texture. Optional. Only used for single-layer textures and cubemaps. Ignored for layered textures.
    kname image_asset_name;
    // The name of the image asset to load for the texture. Optional. Only used for single-layer textures and cubemaps. Ignored for layered textures.
    kname package_name;
    // Names of layer image assets, only used for array/layered textures. Element count must be layer_count.
    kname* layer_image_asset_names;
    // Names of packages containing layer image assets, only used for array/layered textures. Element count must be layer_count. Use null/0 to load from application package.
    kname* layer_package_names;
 
    // Block of pixel data, which can be multiple layers as defined by layer_count. The pixel data for all layers should be contiguous. Layout interpreted based on format.
    void* pixel_data;
    // The size of the pixel_data array in bytes (NOT pixel count!)
    u32 pixel_array_size;
} ktexture_load_options;
 
KAPI ktexture texture_acquire_with_options(ktexture_load_options options, void* listener, PFN_texture_loaded_callback callback);
KAPI ktexture texture_acquire_with_options_sync(ktexture_load_options options);
 
KAPI b8 texture_resize(ktexture t, u32 width, u32 height, b8 regenerate_internal_data);
 
KAPI b8 texture_write_data(ktexture t, u32 offset, u32 size, void* data);
 
KAPI u32 texture_width_get(ktexture t);
KAPI u32 texture_height_get(ktexture t);
KAPI b8 texture_dimensions_get(ktexture t, u32* out_width, u32* out_height);
 
KAPI khandle texture_renderer_handle_get(ktexture t);
 
KAPI ktexture_flag_bits texture_flags_get(ktexture t);
 
KAPI b8 texture_is_loaded(ktexture t);