asset_system.h

Go to the documentation of this file.

 
#pragma once
 
#include <assets/kasset_types.h>
#include <strings/kname.h>
 
typedef struct asset_system_config {
    // The maximum number of assets which may be loaded at once.
    u32 max_asset_count;
 
    kname default_package_name;
} asset_system_config;
 
struct asset_system_state;
 
KAPI b8 asset_system_deserialize_config(const char* config_str, asset_system_config* out_config);
 
KAPI b8 asset_system_initialize(u64* memory_requirement, struct asset_system_state* state, const asset_system_config* config);
 
KAPI void asset_system_shutdown(struct asset_system_state* state);
 
#if KOHI_HOT_RELOAD
KAPI u32 _asset_system_watch_for_reload(struct asset_system_state* state, kasset_type type, kname asset_name, kname package_name);
KAPI void _asset_system_stop_watch(struct asset_system_state* state, u32 watch_id);
 
#   define asset_system_watch_for_reload(state, type, asset_name, package_name) _asset_system_watch_for_reload(state, type, asset_name, package_name)
#   define asset_system_stop_watch(state, watch_id) _asset_system_stop_watch(state, watch_id)
 
#else
#   define asset_system_watch_for_reload(state, type, asset_name, package_name)
#   define asset_system_stop_watch(state, watch_id)
#endif
 
// ////////////////////////////////////
// BINARY ASSETS
// ////////////////////////////////////
 
typedef void (*PFN_kasset_binary_loaded_callback)(void* listener, kasset_binary* asset);
// async load from game package.
KAPI kasset_binary* asset_system_request_binary(struct asset_system_state* state, const char* name, void* listener, PFN_kasset_binary_loaded_callback callback);
// sync load from game package.
KAPI kasset_binary* asset_system_request_binary_sync(struct asset_system_state* state, const char* name);
// async load from specific package.
KAPI kasset_binary* asset_system_request_binary_from_package(struct asset_system_state* state, const char* package_name, const char* name, void* listener, PFN_kasset_binary_loaded_callback callback);
// sync load from specific package.
KAPI kasset_binary* asset_system_request_binary_from_package_sync(struct asset_system_state* state, const char* package_name, const char* name);
 
KAPI void asset_system_release_binary(struct asset_system_state* state, kasset_binary* asset);
 
// ////////////////////////////////////
// TEXT ASSETS
// ////////////////////////////////////
 
// sync load from game package.
KAPI kasset_text* asset_system_request_text_sync(struct asset_system_state* state, const char* name);
// sync load from specific package.
KAPI kasset_text* asset_system_request_text_from_package_sync(struct asset_system_state* state, const char* package_name, const char* name);
 
KAPI void asset_system_release_text(struct asset_system_state* state, kasset_text* asset);
 
KAPI b8 asset_system_write_text(struct asset_system_state* state, kname package_name, kname asset_name, const char* content);
 
// ////////////////////////////////////
// IMAGE ASSETS
// ////////////////////////////////////
 
typedef void (*PFN_kasset_image_loaded_callback)(void* listener, kasset_image* asset);
// async load from game package.
KAPI kasset_image* asset_system_request_image(struct asset_system_state* state, const char* name, void* listener, PFN_kasset_image_loaded_callback callback);
// sync load from game package.
KAPI kasset_image* asset_system_request_image_sync(struct asset_system_state* state, const char* name);
// async load from specific package.
KAPI kasset_image* asset_system_request_image_from_package(struct asset_system_state* state, const char* package_name, const char* name, void* listener, PFN_kasset_image_loaded_callback callback);
// sync load from specific package.
KAPI kasset_image* asset_system_request_image_from_package_sync(struct asset_system_state* state, const char* package_name, const char* name);
 
KAPI void asset_system_release_image(struct asset_system_state* state, kasset_image* asset);
 
// ////////////////////////////////////
// BITMAP FONT ASSETS
// ////////////////////////////////////
 
// sync load from game package.
KAPI kasset_bitmap_font* asset_system_request_bitmap_font_sync(struct asset_system_state* state, const char* name);
// sync load from specific package.
KAPI kasset_bitmap_font* asset_system_request_bitmap_font_from_package_sync(struct asset_system_state* state, const char* package_name, const char* name);
 
KAPI void asset_system_release_bitmap_font(struct asset_system_state* state, kasset_bitmap_font* asset);
 
// ////////////////////////////////////
// SYSTEM FONT ASSETS
// ////////////////////////////////////
 
// sync load from game package.
KAPI kasset_system_font* asset_system_request_system_font_sync(struct asset_system_state* state, const char* name);
 
// sync load from specific package.
KAPI kasset_system_font* asset_system_request_system_font_from_package_sync(struct asset_system_state* state, const char* package_name, const char* name);
 
KAPI void asset_system_release_system_font(struct asset_system_state* state, kasset_system_font* asset);
 
// ////////////////////////////////////
// MODEL ASSETS
// ////////////////////////////////////
 
typedef void (*PFN_kasset_model_loaded_callback)(void* listener, kasset_model* asset);
 
// async load from game package.
KAPI kasset_model* asset_system_request_model(struct asset_system_state* state, const char* name, void* listener, PFN_kasset_model_loaded_callback callback);
// sync load from game package.
KAPI kasset_model* asset_system_request_model_sync(struct asset_system_state* state, const char* name);
// async load from specific package.
KAPI kasset_model* asset_system_request_model_from_package(struct asset_system_state* state, const char* package_name, const char* name, void* listener, PFN_kasset_model_loaded_callback callback);
// sync load from specific package.
KAPI kasset_model* asset_system_request_model_from_package_sync(struct asset_system_state* state, const char* package_name, const char* name);
 
KAPI void asset_system_release_model(struct asset_system_state* state, kasset_model* asset);
 
// ////////////////////////////////////
// HEIGHTMAP TERRAIN ASSETS
// ////////////////////////////////////
 
typedef void (*PFN_kasset_heightmap_terrain_loaded_callback)(void* listener, kasset_heightmap_terrain* asset);
 
// async load from game package.
KAPI kasset_heightmap_terrain* asset_system_request_heightmap_terrain(struct asset_system_state* state, const char* name, void* listener, PFN_kasset_heightmap_terrain_loaded_callback callback);
// sync load from game package.
KAPI kasset_heightmap_terrain* asset_system_request_heightmap_terrain_sync(struct asset_system_state* state, const char* name);
// async load from specific package.
KAPI kasset_heightmap_terrain* asset_system_request_heightmap_terrain_from_package(struct asset_system_state* state, const char* package_name, const char* name, void* listener, PFN_kasset_heightmap_terrain_loaded_callback callback);
// sync load from specific package.
KAPI kasset_heightmap_terrain* asset_system_request_heightmap_terrain_from_package_sync(struct asset_system_state* state, const char* package_name, const char* name);
 
KAPI void asset_system_release_heightmap_terrain(struct asset_system_state* state, kasset_heightmap_terrain* asset);
 
// ////////////////////////////////////
// MATERIAL ASSETS
// ////////////////////////////////////
 
typedef void (*PFN_kasset_material_loaded_callback)(void* listener, kasset_material* asset);
 
// async load from game package.
KAPI kasset_material* asset_system_request_material(struct asset_system_state* state, const char* name, void* listener, PFN_kasset_material_loaded_callback callback);
// sync load from game package.
KAPI kasset_material* asset_system_request_material_sync(struct asset_system_state* state, const char* name);
// async load from specific package.
KAPI kasset_material* asset_system_request_material_from_package(struct asset_system_state* state, const char* package_name, const char* name, void* listener, PFN_kasset_material_loaded_callback callback);
// sync load from specific package.
KAPI kasset_material* asset_system_request_material_from_package_sync(struct asset_system_state* state, const char* package_name, const char* name);
 
KAPI void asset_system_release_material(struct asset_system_state* state, kasset_material* asset);
 
// ////////////////////////////////////
// AUDIO ASSETS
// ////////////////////////////////////
 
typedef void (*PFN_kasset_audio_loaded_callback)(void* listener, kasset_audio* asset);
 
// async load from game package.
KAPI kasset_audio* asset_system_request_audio(struct asset_system_state* state, const char* name, void* listener, PFN_kasset_audio_loaded_callback callback);
// sync load from game package.
KAPI kasset_audio* asset_system_terrain_request_audio_sync(struct asset_system_state* state, const char* name);
// async load from specific package.
KAPI kasset_audio* asset_system_request_audio_from_package(struct asset_system_state* state, const char* package_name, const char* name, void* listener, PFN_kasset_audio_loaded_callback callback);
// sync load from specific package.
KAPI kasset_audio* asset_system_request_audio_from_package_sync(struct asset_system_state* state, const char* package_name, const char* name);
 
KAPI void asset_system_release_audio(struct asset_system_state* state, kasset_audio* asset);
 
// ////////////////////////////////////
// SHADER ASSETS
// ////////////////////////////////////
 
// sync load from game package.
KAPI kasset_shader* asset_system_terrain_request_shader_sync(struct asset_system_state* state, const char* name);
 
// sync load from specific package.
KAPI kasset_shader* asset_system_request_shader_from_package_sync(struct asset_system_state* state, const char* package_name, const char* name);
 
KAPI void asset_system_release_shader(struct asset_system_state* state, kasset_shader* asset);
 
KAPI b8 asset_system_shader_watch(struct asset_system_state* state, kasset_shader* shader, const char* package_name, const char* name, u32* out_watch_id);