Assets¶

Engine::AssetManager is a global resource that owns decoded sprites, sounds, music, and fonts. Components store ids and paths, not loaded objects; the manager turns ids into resources.

Getting the manager¶

A plugin normally creates it (SpritePlugin and AudioPlugin both guard with HasResource):

auto& assets = registry.GetResource<Engine::AssetManager>();

If nothing has created it yet:

auto& assets = registry.AddResource<Engine::AssetManager>();

Bundled assets¶

The AssetBundler compiles the project's assets/ folder into a generated header, so the executable ships with its assets and startup avoids disk I/O.

#include "BundledAssets.hpp"

auto& assets = registry.GetResource<Engine::AssetManager>();
BundledAssets::RegisterAssets(assets);

Ids are the relative file names under assets/ (player.png, laser.wav).

Loading from disk¶

Useful for tools, mods, or very large optional packs:

assets.LoadSprite("player", "assets/player.png");
assets.LoadSound("explosion", "assets/boom.wav");
assets.LoadMusic("bgm", "assets/music.mp3", true); // true = loop

auto sprite = assets.GetSprite("player");   // throws ErrorAsset if missing
auto sound  = assets.GetSound("explosion");
auto music  = assets.GetMusic("bgm");

Unload explicitly when you are done with a large asset:

assets.UnloadSprite("player");
assets.UnloadSound("explosion");
assets.UnloadMusic("bgm");

Paths¶

Asset paths in components are project-relative. The editor and the built game resolve them against the project folder, so the same .scene works in both. Do not store absolute paths in a component; they break on another machine and inside bundles.

Assets/ProjectPaths.hpp provides ResolveAssetPath, ResolveProjectPath, and ToProjectRelativePath for the cases where you need to convert.

What lives where¶

Asset	Loaded by	Referenced from
Sprites	`LoadSprite` / bundler	`SpriteComponent.assetPath`
Sounds	`LoadSound` / bundler	`AudioSource.assetId`
Music	`LoadMusic` / bundler	`AudioSource.assetId`
Fonts	`LoadFontFromMemory`	`Text.font`