Bevy Heterogenous Texture Atlas Loader

Bevy Heterogenous Texture Atlas Loader allows you to load heterogenous texture atlases according to a RON file manifest.

It works, but the implementation could be improved a lot. Any suggestions would be very welcome.

Suports Bevy 0.6 #

Basic usage

1. Add the TextureAtlasManifestLoaderPlugin to your Bevy App.

2. Load the texture atlas manifest using the asset server: rust let manifest: Handle<TextureAtlasManifest> = asset_server.load("manifest.ron"); The plugin listens for AssetServer events. Once the manifest file is loaded it will automatically begin loading the corresponding image file.

3. Once the image file is loaded, it constructs the TextureAtlas and then emits a TextureAtlasManifestLoadedEvent event. A strong handle to the new atlas can be retrieved from that event's atlas field.

#

Detailed Example

• Given a sprite sheet with irregular sized and positioned sprites.

  

1. First create a manifest.ron manifest file in your assets folder

   ( "example.png", Sprites ([ ( x: 18, y: 19, w: 46, h: 48 ), ( x: 93, y: 108, w: 32, h: 31 ), ( x: 176, y: 34, w: 20, h: 34 ), ]) ) Alternatively, you can give each sprite a unique name that can be used to look up their TextureAtlas index.

   ( "example.png", NamedSprites ([ ( name: "yellow", x: 18, y: 19, w: 46, h: 48 ), ( name: "face", x: 93, y: 108, w: 32, h: 31 ), ( name: "patches", x: 176, y: 34, w: 20, h: 34 ), ]) )

   • You can call the manifest anything you like, not only manifest.ron.
   • The file path is relative to the root assets folder, not to the manifest file.
   • The sprite indices in the output TextureAtlas are ordered implicitly according to the order of the input list sprite rects.
   • Use name: "" to skip naming a sprite in a NamedSprites list

2. Add this crate's dependency to your project's Cargo.toml [dependencies] section

   bevy_heterogeneous_texture_atlas_loader = "0.1.2"

3. Write the app

   ```rust use bevy::prelude::; use bevy_heterogeneous_texture_atlas_loader::;

   fn setup( mut commands: Commands, assetserver: Res, ) { commands.spawnbundle(OrthographicCameraBundle::new2d()); let manifest: Handle = assetserver.load("manifest.ron"); commands.insert_resource(manifest); }

   fn onatlasloaded( mut commands: Commands, mut events: EventReader, atlases: Res>, ) { for event in events.iter() { let atlas = atlases.get(&event.atlas).unwrap(); commands .spawnbundle(SpriteBundle { texture: atlas.texture.clone(), ..Default::default() }); for i in 0..3 { let target = -200. * Vec3::X + (100. * i as f32 - 100.) * Vec3::Y; commands .spawnbundle(SpriteSheetBundle { sprite: TextureAtlasSprite::new(i), textureatlas: event.atlas.clone(), transform: Transform::fromtranslation(target), ..Default::default() }); } } }

   fn main() { App::new() .addplugins(DefaultPlugins) .addplugin(TextureAtlasManifestLoaderPlugin) .addstartupsystem(setup) .addsystem(onatlas_loaded) .run(); } ```

4. Result

   

#

Other Questions

"Manifest not found"?

You need to keep a strong handle to the TextureAtlasManifest, otherwise the asset will be dropped before the TextureAtlas is created.