Struct 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: UVec2, padding: u32) -> 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, texture: &Image, atlas_texture: &mut Image, ) -> Result<usize, DynamicTextureAtlasBuilderError>

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

• atlas_layout - The atlas layout to add the texture to.
• texture - The source texture to add to the atlas.
• atlas_texture - The destination atlas texture to copy the source texture to.