Struct Loader 

pub struct Loader { /* private fields */ }

One background worker with a bounded request queue and a private AudioCache.

Submission never waits for queue space, but may allocate/free memory and uses std channels. All methods, polling and destruction belong off the audio thread. Dropping the loader closes its queue and waits for accepted requests to finish; their handles remain usable. A dropped handle does not cancel its decode/cache admission. No async runtime or mixer feature is required.

Implementations

impl Loader

pub fn new(config: LoaderConfig) -> Result<Self>

Spawn the worker. Thread creation failures return Io.

pub fn load_bytes( &self, name: impl Into<String>, bytes: Vec<u8>, ) -> Result<LoadHandle>

Queue owned encoded bytes under a name. Reusing a cached name returns its original sound. Input size is checked even on cache hits; bytes are not copied.

pub fn load_file(&self, path: impl AsRef<Path>) -> Result<LoadHandle>

Queue a file by its absolute path. Resolving a relative path uses the current directory now; file I/O and size/decode errors arrive through the handle.

Trait Implementations

impl Drop for Loader

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.