bevy_tile_atlas 0.4.0

A TextureAtlas builder for ordered tilesets
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

//! bevy_tile_atlas is a `TextureAtlas` builder for ordered tilesets.
//!
//! In other words, this crate is used to generate a `TileAtlas` that respects the order of insertion,
//! allowing its sub-textures to exist at known indices. This is helpful for texture animations, where
//! the frames are designated by a range of indices to loop through. It can also be helpful for retrieving
//! a sub-texture without needing access to its handle (i.e., "get texture at index at index 7" instead of
//! storing/passing around a `Handle<Image>`).
//!
//! ## Example
//! ```
//! # use bevy::prelude::*;
//! # use bevy_tile_atlas::TileAtlasBuilder;
//!
//! /// Creates a tile-based, ordered `TextureAtlas`
//! ///
//! /// Assumes that the given handles are all loaded and in their desired order
//! fn build_tileset(handles: Vec<Handle<Image>>, textures: &mut Assets<Image>) -> TextureAtlas {
//!     let mut builder = TileAtlasBuilder::default();
//!
//!     for handle in handles {
//!         let texture = textures.get(&handle).unwrap();
//!         builder.add_texture(handle, texture);
//!     }
//!
//!     builder.finish(textures).unwrap()
//! }
//! ```

mod store;
mod tile_atlas;

pub use store::TextureStore;
pub use tile_atlas::{TileAtlasBuilder, TileAtlasBuilderError};