8000 GitHub - robottini/Photo2svg: Raster photos to flat gap-free SVG for watercolor plotters · GitHub
[go: up one dir, main page]

Skip to content
robottiniPublic

About

Raster photos to flat gap-free SVG for watercolor plotters

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Photo2svg

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.

Caratteristiche

  • 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

Screenshot / uso

  1. Apri l'app (oppure trascina una foto sulla finestra)
  2. Regola numero colori, morbidezza forme, dettaglio minimo
  3. Anteprima affiancata originale / risultato
  4. Esporta SVG

CLI

# 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

Build

Richiede Rust 1.75+.

cargo build --release
./target/release/photo2svg

DMG per macOS

chmod +x scripts/*.sh
./scripts/make_dmg.sh 0.1.0
# → dist/Photo2svg-0.1.0.dmg

Senza account Apple Developer il DMG non è notarizzato: al primo avvio fare clic destro → Apri.

Contratto SVG (Plotter_MultiHatch)

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, viewBox coerenti (usati per la scala carta)
  • Sfondo #FFFFFF + forme in <g id="plot-shapes"> (mai shape radice singola)
  • Ogni area = un <path> con fill="#RRGGBB" inline
  • Path chiusi, polilinee (L), niente stroke
  • Colori riservati: #FFFFFF = carta non dipinta (opzione attiva di default), #E3E4E6 = colHide (mai usato)

Relazione con lo step di hatching

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.

Algoritmo

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.

Architettura

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.

Release GitHub

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.0

Licenza

MIT — vedi LICENSE.

About

Raster photos to flat gap-free SVG for watercolor plotters

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0