Skip to main content

FlixelDefaultAssetManager

View source

class

org.flixelgdx.asset.FlixelDefaultAssetManager

public class FlixelDefaultAssetManager implements FlixelAssetManager

Default concrete asset manager for FlixelGDX.

Maintains a single ObjectMap<String, FlixelAsset<?>> cache as the source of truth. The underlying libGDX AssetManager is used only for async I/O; once a raw asset is available, game code works exclusively with the typed FlixelAsset handles returned by FlixelDefaultAssetManager.get(String).

Loaders are registered per file extension. The constructor registers defaults for images (.png, .jpg, .jpeg, .webp), audio (.mp3, .ogg, .wav, .flac), and text (.txt, .xml, .json). Add custom extensions via FlixelDefaultAssetManager.registerLoader(...).

Compressed textures: FlixelGame.create() calls FlixelDefaultAssetManager.enableCompressedTextures() automatically on every backend so .png requests transparently prefer a .ktx2 sibling when one exists.

Recommended usage: Access via Flixel.assets.

Web audio pre-decoding: any FlixelDefaultAssetManager.load(String) call for an audio path automatically triggers background audio decoding on the web platform (ApplicationType.WebGL). By the time the loading state finishes the decoded buffer is cached and FlixelSoundManager.play returns instantly. On desktop and Android this is a no-op.

// Inside of a loading state.
Flixel.assets.load("music/inst.mp3");
Flixel.assets.load("music/voices.mp3");
Flixel.assets.finishLoading();

// Game state, with buffers already decoded.
Flixel.sound.play("music/inst.mp3");
Flixel.sound.play("music/voices.mp3");

Experts: FlixelDefaultAssetManager.getManager() exposes the underlying AssetManager for custom loaders, asset descriptors, or raw APIs not wrapped here.

Constructors​

FlixelDefaultAssetManager()​

public FlixelDefaultAssetManager()

Constructs a new manager with default loaders for images, audio, and text.

Methods​

load(String)​

public void load(String path)

load(String, boolean)​

public void load(String path, boolean persist)

get(String)​

public FlixelAsset<T> get(String path)

peek(String)​

public FlixelAsset<?> peek(String path)

registerLoader(String, Class<?>, FlixelAssetLoader<T>)​

public void registerLoader(String extension, Class<?> rawType, FlixelAssetLoader<T> loader)

unregisterLoader(String)​

public void unregisterLoader(String extension)

register(FlixelAsset<?>)​

public void register(FlixelAsset<?> asset)

allocateSyntheticKey()​

public String allocateSyntheticKey()

getManager()​

public AssetManager getManager()

enableCompressedTextures()​

public void enableCompressedTextures()

isCompressedTexturesEnabled()​

public boolean isCompressedTexturesEnabled()

getCompressedTexturesEnabled()​

public boolean getCompressedTexturesEnabled()

Returns whether KTX2/BasisU compressed texture loading is enabled.

setKtx2LoaderInstaller(FlixelKtx2LoaderInstaller)​

public void setKtx2LoaderInstaller(FlixelKtx2LoaderInstaller installer)

update()​

public boolean update()

update(int)​

public boolean update(int millis)

getProgress()​

public float getProgress()

getLoadedAssetCount()​

public int getLoadedAssetCount()

isLoaded(String)​

public boolean isLoaded(String path)

finishLoading()​

public void finishLoading()

finishLoadingAsset(String)​

public void finishLoadingAsset(String path)

unload(String)​

public void unload(String path)

getDiagnostics()​

public String getDiagnostics()

getGlobalPersist()​

public boolean getGlobalPersist()

setGlobalPersist(boolean)​

public void setGlobalPersist(boolean globalPersist)

getAssetMode()​

public FlixelAssetMode getAssetMode()

setAssetMode(FlixelAssetMode)​

public void setAssetMode(FlixelAssetMode mode)

onAssetReleased(FlixelAsset<?>)​

public void onAssetReleased(FlixelAsset<?> handle)

clearNonPersist()​

public void clearNonPersist()

clear()​

public void clear()

destroy()​

public void destroy()

dispose()​

public void dispose()

resolveAudioPath(String)​

public String resolveAudioPath(String path)

extractAssetPath(String)​

public String extractAssetPath(String path)

resolveTexturePath(String)​

public String resolveTexturePath(String path)