Crate texture_atlasser

Easy texture atlass creation with various options to fit different needs.

Provides a way to create texture atlasses from lists of Paths or DynamicImages.

Examples

Loading different images into atlantes and saving them afterwards:

use std::path::Path;
use texture_atlasser as ta;
fn main() -> Result<(), Box<dyn std::error::Error>>{
    let paths: Vec<&Path> = vec!(
        Path::new("image1.png"), 
        Path::new("image2.png"), 
        Path::new("image3.jpg"),
    );
    let options = ta::AtlasOptions { 
        width: 64,
        height: 64,
        margin: 5,
        max_atlantes: 2,
        try_smaller: None,
        cut_down: true,
    };
    // create the atlas
    let atlas = ta::atlas_paths(&paths, options)?;
    
    // save the atlantes
    for (i, image) in atlas.atlantes.iter().enumerate() {
        image.save(format!("atlas{}.png", i))?;
    }
    // Log the positions of the single textures inside the atlantes into the console
    for rect in atlas.rects.iter() {
        println!("{:?}", rect);
    }
    Ok(())
}

Structs

AtlasLayout

Holds the created atlas textures and Rects describing where each image sits.

AtlasOptions

Options passed to the atlassing function

Rect

Describes an image as part of an atlas

Enums

AtlasError

Functions

atlas_buffers

Atlasses a list of DynamicImages with the supplied AtlasOptions.

atlas_paths

Loads the images in paths and atlasses them with the supplied AtlasOptions.