Assets

Functions for loading, caching, and managing textures, fonts, and audio.

Header: #include <asw/modules/assets.h>Namespace: asw::assets

Textures

load_texture

asw::Texture load_texture(const std::string& filename);
asw::Texture load_texture(const std::string& filename, const std::string& key);

Load a texture from a file. Supported formats: PNG, ICO, CUR, BMP, GIF, JPG, LBM, PCX, PNM, TIF, XCF, XPM, XV, and WEBP. The second overload caches the result under key for later retrieval.

WARNING

Aborts the program if the file is not found.

get_texture

asw::Texture get_texture(const std::string& key);

Get a previously cached texture by key.

unload_texture

void unload_texture(const std::string& key);

Remove a cached texture.

create_texture

asw::Texture create_texture(int w, int h);

Create a blank texture with the given dimensions. Useful for render targets.

Fonts

load_font

asw::Font load_font(const std::string& filename, float size);
asw::Font load_font(const std::string& filename, float size, const std::string& key);

Load a TTF font at the given size. The second overload caches the result under key.

WARNING

Aborts the program if the file is not found.

get_font

asw::Font get_font(const std::string& key);

Get a previously cached font by key.

unload_font

void unload_font(const std::string& key);

Remove a cached font.

Samples

load_sample

asw::Sample load_sample(const std::string& filename);
asw::Sample load_sample(const std::string& filename, const std::string& key);

Load a sound effect from a file. Supported formats: WAV, AIFF, RIFF, OGG, and VOC. The second overload caches the result under key.

WARNING

Aborts the program if the file is not found.

get_sample

asw::Sample get_sample(const std::string& key);

Get a previously cached sample by key.

unload_sample

void unload_sample(const std::string& key);

Remove a cached sample.

Music

load_music

asw::Music load_music(const std::string& filename);
asw::Music load_music(const std::string& filename, const std::string& key);

Load a music file. Supported formats: WAV, AIFF, RIFF, OGG, and VOC. The second overload caches the result under key.

WARNING

Aborts the program if the file is not found.

get_music

asw::Music get_music(const std::string& key);

Get previously cached music by key.

unload_music

void unload_music(const std::string& key);

Remove cached music.

Global

clear_all

void clear_all();

Clear all cached assets (textures, fonts, samples, and music).

Example

// Load without caching
auto texture = asw::assets::load_texture("sprites/player.png");

// Load with caching
asw::assets::load_texture("sprites/player.png", "player");
asw::assets::load_font("fonts/arial.ttf", 24.0f, "main_font");
asw::assets::load_sample("sfx/jump.wav", "jump");
asw::assets::load_music("music/theme.ogg", "bgm");

// Retrieve cached assets anywhere
auto player = asw::assets::get_texture("player");
auto font = asw::assets::get_font("main_font");

// Unload individual assets
asw::assets::unload_texture("player");

// Or clear everything
asw::assets::clear_all();