# Vecto

> Free, open-source bitmap-to-vector (PNG/JPG → SVG) tracing app for Windows with a cross-platform command-line tool. Its planar-partition engine fits every boundary once and shares it between adjacent shapes, so the output has no hairline gaps and no overlaps — the defect that plagues most image vectorizers.

## Tech Stack
* Language: C# / .NET 8
* Engine: Vecto.Core — zero-dependency planar vectorization pipeline (Oklab weighted k-means++ palette inference, crack-following shared boundary graph, corner detection with sub-pixel validation, clamped smoothing, sub-pixel edge refinement from anti-aliasing, simplest-model-first fitting: line → circular arc → least-squares Bezier)
* App: WPF, Windows 10/11 (64-bit); CLI: Windows, Linux, macOS

## Key Features & Differentiators
* **Planar shared-boundary tracing:** every boundary between two shapes is fitted once and used by both sides — gaps and overlaps are structurally impossible, the same property Vector Magic's output has and stacked-layer tracers (potrace, Inkscape) don't.
* **Geometric intelligence:** straight edges become true straight lines; circles, dots and round caps become mathematically exact arcs.
* **Sub-pixel precision:** anti-aliasing is read to place boundaries between pixels instead of snapping to the pixel grid.
* **Live side-by-side compare:** synced zoom/pan, segmentation view, palette swatches, instant re-trace on every setting change.
* **Deterministic and tested:** same input → byte-identical SVG; geometric-invariant test suite; round-trip quality benchmark (`vecto bench`).
* **Free:** MIT license, no accounts, no upload — runs fully offline.

## Install & Run from Source
```bash
git clone https://github.com/DanielMevit/Vecto.git
cd Vecto
dotnet build -c Release
```