Create stunning mosaic images by intelligently replacing sections of a target image with smaller material images based on perceptual color similarity.
Transform any image into a detailed mosaic composed of thousands of smaller images:
# Install dependencies
cargo build --release
# Basic usage
./target/release/mosaic-rust \
--target photo.jpg \
--material-src ./materials \
--output mosaic.jpg
# High quality settings
./target/release/mosaic-rust \
--target photo.jpg \
--material-src ./materials \
--output mosaic.jpg \
--grid-w 100 --grid-h 75 \
--max-materials 2000 \
--adjacency-penalty-weight 0.25 \
--color-adjustment-strength 0.4 \
--optimization-iterations 2000
Original Image
Generated Mosaic (24,000 tiles)
| Feature | Description |
|---|---|
| Perceptual Color Matching | Uses Lab color space with k-d tree for O(log n) nearest neighbor search |
| Smart Placement | Multi-factor scoring considering color distance, usage limits, and adjacency penalties |
| Parallel Processing | Automatic parallelization with Rayon for multi-core performance |
| Color Adjustment | HSV-based color adjustment for better matching with target regions |
| Optimization Engine | Simulated annealing algorithm for iterative tile placement improvement |
| Real-time Visualization | ASCII grid display and progress tracking with ETA |
| Similarity Database | Pre-computed similarity matrix with JSON persistence |
| Aspect Ratio Matching | Intelligent filtering with fallback strategies |
The Mosaic Art Generator is built with a modular architecture:
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Material │ │ Similarity │ │ k-d Tree │
│ Loading │───▶│ Database │───▶│ Indexing │
│ (Parallel) │ │ (Cached) │ │ (O(log n)) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Grid │ │ Tile │ │ Color │
│ Generation │───▶│ Placement │───▶│ Adjustment │
│ (Target) │ │ (Multi- │ │ (HSV) │
│ │ │ factor) │ │ │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Optimization │ │ Image │ │ Final │
│ (Simulated │───▶│ Assembly │───▶│ Mosaic │
│ Annealing) │ │ (Parallel) │ │ Output │
└─────────────────┘ └─────────────────┘ └─────────────────┘Ready to create your first mosaic? Follow our comprehensive guide:
Ready to create stunning mosaic art? Get Started →