Phomo

A Photo mosaic generation library.

Usage

To build a photo mosaic, you'll need a master image as well as a bunch of so called tile images. The tile images will be arranged to best reconstruct the master image. The master image is initialized with the [Master] struct.

The tile images can be loaded using some helper functions:

• [read_images_from_dir]
• [read_images_from_dir_cropped]
• [read_images_from_dir_resized]

The photo mosaic can be constructed using the [Mosaic] struct.

Examples

I'll be using this 256x256 image as master image:

And for the tile images, we'll be using a susbset of the UTKfaces dataset.

Basic mosaic

Build a 16x16 photo mosaic.

use phomo::{Master, Mosaic, read_images_from_dir_cropped, SolverConfig};

let master_file = "tests/data/master/master.png";
let grid_size = (16, 16);
let master = Master::from_file(master_file, grid_size).unwrap();

let tile_dir = "tests/data/mosaic/faces/";
let tiles = read_images_from_dir_cropped(tile_dir, master.cell_size.0, master.cell_size.1).unwrap();

let mosaic = Mosaic::new(master, tiles, grid_size).unwrap();
let distance_matrix = mosaic.distance_matrix();

let mosaic_img = mosaic.build(distance_matrix, SolverConfig::default());

With repeated tiles

Build a 16x16 photo mosaic, with tiles able to repeat up to twice.

use phomo::{Master, Mosaic, read_images_from_dir_cropped, SolverConfig};

let master_file = "tests/data/master/master.png";
let grid_size = (16, 16);
let master = Master::from_file(master_file, grid_size).unwrap();

let tile_dir = "tests/data/mosaic/faces/";
let tiles = read_images_from_dir_cropped(tile_dir, master.cell_size.0, master.cell_size.1).unwrap();

let mosaic = Mosaic::new(master, tiles, grid_size).unwrap();
let distance_matrix = mosaic.distance_matrix();

let mosaic_img = mosaic.build(distance_matrix, SolverConfig { max_tile_occurrences: 2 } );

Palette transfer - Tiles to master

Build a 16x16 photo mosaic, with palette transfer of the master image to the tile images. The color of the tiles will be adjusted to match the color distribution of the master image.

use phomo::{Master, Mosaic, read_images_from_dir_cropped, ColorMatch, SolverConfig};

let master_file = "tests/data/master/master.png";
let grid_size = (16, 16);
let master = Master::from_file(master_file, grid_size).unwrap();

let tile_dir = "tests/data/mosaic/faces/";
let mut tiles = read_images_from_dir_cropped(tile_dir, master.cell_size.0, master.cell_size.1).unwrap();

tiles = tiles.match_palette(&master.img);

let mosaic = Mosaic::new(master, tiles, grid_size).unwrap();
let distance_matrix = mosaic.distance_matrix();

let mosaic_img = mosaic.build(distance_matrix, SolverConfig::default());

Palette transfer - Master to tiles

Build a 16x16 photo mosaic, with palette transfer of the tile images onto the master image. The color of the master image will be adjusted to match the color distribution of the tile images.

use image;
use phomo::{Master, Mosaic, read_images_from_dir_cropped, ColorMatch, SolverConfig};

let master_file = "tests/data/master/master.png";
let grid_size = (16, 16);

let master_img = image::open(master_file).unwrap().to_rgb8();
let cell_size = (master_img.width() / grid_size.0, master_img.height() / grid_size.1);

let tile_dir = "tests/data/mosaic/faces/";
let tiles = read_images_from_dir_cropped(tile_dir, cell_size.0, cell_size.1).unwrap();

let master = Master::from_image(master_img.match_palette(&tiles), grid_size).unwrap();

let mosaic = Mosaic::new(master, tiles, grid_size).unwrap();
let distance_matrix = mosaic.distance_matrix();

let mosaic_img = mosaic.build(distance_matrix, SolverConfig::default());

Color Normalization

Build a 16x16 photo mosaic, with color distribution normalization. The colors of both the master image and tiles images will be adjusted to cover the full color space.

use image;
use phomo::{Master, Mosaic, read_images_from_dir_cropped, ColorMatch, SolverConfig};

let master_file = "tests/data/master/master.png";
let grid_size = (16, 16);
let master_img = image::open(master_file).unwrap().to_rgb8();

let master = Master::from_image(master_img.equalize(), grid_size).unwrap();

let tile_dir = "tests/data/mosaic/faces/";
let mut tiles = read_images_from_dir_cropped(tile_dir, master.cell_size.0, master.cell_size.1).unwrap();
tiles = tiles.equalize();

let master = Master::from_image(master_img.match_palette(&tiles), grid_size).unwrap();

let mosaic = Mosaic::new(master, tiles, grid_size).unwrap();
let distance_matrix = mosaic.distance_matrix();

let mosaic_img = mosaic.build(distance_matrix, SolverConfig::default());