An opinionated Bevy plugin to load Image Assets quickly and easily. Ideal for Game Jams.
This plugin is meant to be a convenience tool to load all image assets for your game at startup, ideal for small projects and prototypes.
To use it, add it to your Cargo.toml file like this:
trve_bevy_image = { git = "https://github.com/mnmaita/trve_bevy_image" }
Remember you can also target tags, commits and branches with this method:
trve_bevy_image = { git = "https://github.com/mnmaita/trve_bevy_image", tag = "v0.3.0" }
trve_bevy_image = { git = "https://github.com/mnmaita/trve_bevy_image", branch = "test" }
trve_bevy_image = { git = "https://github.com/mnmaita/trve_bevy_image", rev = "03ee540ad7afba7822a73139169c635093127fba" }
By default, it will load all assets from an "img" directory under your "assets" folder. You can override this directory by using the ImageAssetFolder
Resource:
let mut app = App::new();
// Your plugins go here.
app.add_plugins(TrveImagePlugin);
// You insert this Resource and use the `new` function
// which accepts any parameter that can be turned into an `AssetPath`.
app.insert_resource(ImageAssetFolder::new("images"));
This will load all assets from assets/images
by using AssetServer
's load_folder
method.
Certain platforms, like web, can't use load_folder
to load assets so this library provides an override via the ImageAssetList
Resource. This allows you to load a list of assets from your assets
folder.
app.insert_resource(ImageAssetList::new(
[
"textures/player.png",
"textures/enemy.png",
"textures/background.png",
]
.into(),
));
If you insert this Resource, ImageAssetFolder
will be ignored and the plugin will only load assets based on the provided list.
trve_bevy_image | bevy |
---|---|
0.3 | 0.14 |
0.2 | 0.13 |
0.1 | 0.12 |