resource
The resource
crate contains macros for statically including assets in release mode, but dynamically loading them in debug mode.
This is primarily intended for games, allowing you to both avoid file IO in release builds and dynamically reload assets in debug mode.
You can change the default behaviour, in debug or release mode, by using the force-static
and force-dynamic
features.
Usage
[]
= "~0.3.0"
use ;
let text = resource_str!;
println!;
let bytes = resource!;
println!;
let = resource_str!;
println!;
let decoded_images = resource!;
Internals
The resource_str!
and resource!
macros return Cow
values - Cow<'static, str>
and Cow<'static, [u8]>
respectively.
If you're not familiar with the Cow
type, what this means is that under the hood, they can be either a reference to some const
data (in release mode) or some actual owned data on the heap (in debug mode).
You shouldn't have to care about this though because the above Cow
types can deref to &str
and &[u8]
respectively. Just pass them by reference and treat them as strings/slices.