Struct bevy_sprite::DynamicTextureAtlasBuilder

pub struct DynamicTextureAtlasBuilder { /* private fields */ }

Helper utility to update TextureAtlasLayout on the fly.

Helpful in cases when texture is created procedurally, e.g: in a font glyph TextureAtlasLayout, only add the Image texture for letters to be rendered.

Implementations

impl DynamicTextureAtlasBuilder

pub fn new(size: Vec2, padding: i32) -> Self

Create a new DynamicTextureAtlasBuilder

Arguments

• size - total size for the atlas
• padding - gap added between textures in the atlas, both in x axis and y axis

pub fn add_texture( &mut self, atlas_layout: &mut TextureAtlasLayout, textures: &mut Assets<Image>, texture: &Image, atlas_texture_handle: &Handle<Image> ) -> Option<usize>

Add a new texture to atlas_layout.

It is the user’s responsibility to pass in the correct TextureAtlasLayout. Also, the asset that atlas_texture_handle points to must have a usage matching RenderAssetUsages::MAIN_WORLD.

Arguments

• altas_layout - The atlas to add the texture to
• textures - The texture assets container
• texture - The new texture to add to the atlas
• atlas_texture_handle - The atlas texture to edit