English documentation: see INSTRUCTIONS.md for the complete user guide (installation, presets, CLI, Plotter_MultiHatch, troubleshooting).
App macOS che converte foto raster (JPG, PNG, WebP) in SVG flat con palette ridotta (8–20 colori), forme armoniche e zero gap tra le aree adiacenti.
Pensata per alimentare pipeline di plotter ad acquerello (es. Plotter_MultiHatch) che generano hatching e GCODE da SVG con fill espliciti.
- Quantizzazione K-means in CIELAB (fedele percettivamente, 8–20 colori)
- Filtro bilaterale edge-preserving per appiattire le texture fotografiche
- Vettorizzazione con confini condivisi (shared arcs): ogni bordo esiste una sola volta, smussato una sola volta → nessuna area bianca tra le forme
- Output SVG compatibile con Plotter_MultiHatch / Geomerative
- App nativa Rust (~10–15 MB), nessun runtime esterno
- CLI per scripting e batch
- Apri l'app (oppure trascina una foto sulla finestra)
- Regola numero colori, morbidezza forme, dettaglio minimo
- Anteprima affiancata originale / risultato
- Esporta SVG
# GUI (nessun argomento)
./Photo2svg
# Da riga di comando
photo2svg foto.jpg -o output.svg --colors 12 --smoothness 2 --min-area 0.05
# Con preview raster e mappa gap (magenta = pixel scoperti, deve essere 0)
photo2svg foto.jpg -o out.svg --colors 12 --preview preview.png --gap-map gaps.png| Opzione | Default | Descrizione |
|---|---|---|
--colors N |
12 | Numero colori palette (8–20 consigliato) |
--smoothness N |
2 | Morbidezza forme 0–5 |
--min-area P |
0.05 | Area minima forma (% immagine) |
--max-side N |
1000 | Lato max immagine di lavoro (px) |
--detail N |
1.5 | Riduzione texture 0–3 |
--no-white-paper |
off | Non mappare le tinte chiare a #FFFFFF |
Richiede Rust 1.75+.
cargo build --release
./target/release/photo2svgchmod +x scripts/*.sh
./scripts/make_dmg.sh 0.1.0
# → dist/Photo2svg-0.1.0.dmgSenza account Apple Developer il DMG non è notarizzato: al primo avvio fare clic destro → Apri.
L'SVG prodotto rispetta il contratto richiesto da Geomerative / Plotter_MultiHatch:
<svg xmlns="http://www.w3.org/2000/svg" width="1000" height="667" viewBox="0 0 1000 667">
<rect x="0" y="0" width="1000" height="667" fill="#FFFFFF"/>
<g id="plot-shapes">
<path fill="#1B4D89" d="M 100 120 L 420 120 L 390 360 Z"/>
<path fill="#C0392B" d="M 520 160 L 790 310 L 510 300 Z"/>
</g>
</svg>width,height,viewBoxcoerenti (usati per la scala carta)- Sfondo
#FFFFFF+ forme in<g id="plot-shapes">(mai shape radice singola) - Ogni area = un
<path>confill="#RRGGBB"inline - Path chiusi, polilinee (
L), niente stroke - Colori riservati:
#FFFFFF= carta non dipinta (opzione attiva di default),#E3E4E6= colHide (mai usato)
Plotter_MultiHatch usa step=1.5 mm tra le righe di hatching. Dettagli più piccoli dello spacing carta non vengono tratteggiati: aumentare --min-area se servono forme più grandi e meno frammentazione.
Foto → resize + filtro bilaterale
→ K-means CIELAB (K colori)
→ merge regioni piccole
→ grafo planare (archi condivisi tra regioni)
→ semplificazione + smoothing PER ARCO (Visvalingam-Whyatt + Chaikin)
→ ricostruzione anelli → SVG flat
Il cuore anti-gap: ogni confine tra due regioni è un unico arco nel grafo topologico. Smussandolo una volta, entrambe le regioni lo riusano identico.
| Crate | Ruolo |
|---|---|
photo2svg-core |
Pipeline (preprocess, quantize, regions, topology, smooth, svg, render) |
photo2svg-app |
GUI egui + CLI |
Dipendenze principali: image, rayon, eframe, rfd — tutte MIT/Apache.
Push di un tag v* attiva la GitHub Action che compila il DMG e lo allega alla Release:
git tag v0.1.0
git push origin v0.1.0MIT — vedi LICENSE.