1.0.0-alpha.3

Added

• vtracer-bench: a blind fidelity benchmark for raster-to-vector tracers — it compares an original raster against a rendered reconstruction and reports one 0..1 score built from PSNR, SSIM, and a clustered-diff "missing patch" metric (geometric mean, so a single collapsed axis drags the score down). Blind to how the reconstruction was produced: render any tracer's output to pixels and score it. A new workspace crate, separate from the four shipped packages.

Fixed

• Watershed no longer leaks a region along a blurred low-contrast crack as a 1-px filament (a slightly soft image could grow a hairline of one region's color running tens of px down a neighbouring boundary). The boundary snap's mixture gate now also admits pixels that blend two neighbouring regions — a blend band belongs to its closer flank even when the basin cut misattributed it to a distant region. On the blurred striped synthetic the circle's max boundary error drops from 31.6 px to 1.5 px; crisp images are byte-unaffected.

1.0.0-alpha.2

Added

• Watershed clustering (--clustering watershed): a new region-forming frontend — a hierarchical watershed on the pixel graph (Cousty et al. 2009; Najman et al. 2013), controlled by one dial, --watershed-detail (0..=255; each +25.5 roughly doubles the region count). Regions follow image content, with no watershed-line pixels.
  • Boundaries come out calm: antialiased pixels snap to the color-midpoint iso-line instead of meandering with the noise inside the ramp.
  • stacked stacks the merge tree itself (coarse ancestors below, refined regions on top), so overdraw stays seam-free.
  • cutout gets the partition natively; neighbouring faces closer than max(2, (255 − detail) / 8) merge, so faces a human cannot tell apart never survive as separate patches.
  • WatershedHierarchy is public, split into build (expensive, image-only) and cut (near-instant); Session re-cuts a cached hierarchy on detail changes, making the slider fully interactive (~25 ms vs ~40 ms on a 1400×775 photo).
• Curve simplification (--simplify <tolerance>, Config::simplify, simplify in Python and Node; off by default): a paper.js-style Schneider re-fit — each smooth run between corners is redrawn with the fewest cubics that stay within the tolerance (px). Roughly halves file size (sample photo at tolerance 1: 229 → 138 KB stacked, 103 → 36 KB watershed cutout). Runs on fitted geometry before composition, so cutout simplifies each shared boundary once and stays seam-free; corners and junction endpoints stay pinned.
• Binary thresholding: a tunable fixed threshold (--threshold) and Bradley–Roth adaptive thresholding for uneven lighting (--adaptive, --adaptive-window, --adaptive-t) — also on Config, Python, and Node.
• Cutout mode merges neighbouring faces whose colors are within one gradient step, rejoining the near-identical faces that stacked gradient layering splits a smooth area into.

Changed

• color_mode is replaced by clustering (color-cluster | bw | watershed) across the CLI, Rust, Python, and Node — the field selects the region-forming algorithm, not a color space.
• The spline fine-tuning flags (--corner-threshold, --segment-length, --splice-threshold) are hidden from CLI help — still accepted, but without their -c/-l/-s short forms. The defaults serve virtually every conversion; --simplify supersedes them.

Fixed

• Spline fitting no longer swings far away from the outline around thin strands (a long-standing defect, fixed via visioncortex 0.9.1): a sparse splice slice could be fitted by a single cubic that passed through every sample yet ballooned up to ~30 px sideways between them. Slices are now densified before fitting and multi-cubic fits kept in full, in both stacked mode and the mosaic fitter.

1.0.0-alpha.1

Ground-up rewrite of VTracer into a vectorization framework with pluggable stages.

Added

• Pluggable pipeline: swappable frontend (segmentation), color fitting (incl. custom palettes), curve-fitting backend, and an optimizer pass phase.
• Mosaic mode: true seam-free, gapless tessellation via shared boundary-graph tracing (pixel, polygon, and spline fitters), replacing the old "cutout" that produced seams.
• SVG optimizer: relative path syntax, shorthand commands, and coordinate-precision reduction for smaller files.
• @visioncortex/vtracer Node.js package (npm): wasm core with a native image reader.
• Rewritten Python bindings (vtracer-py) with a richer API; pyo3 bumped to 0.26 (fixes CPython 3.14 segfaults, #124).
• CLI accepts positional input/output arguments (#114).

Changed

• Workspace restructured into crates/vtracer (core lib), crates/vtracer-cli, crates/vtracer-py, and nodejs/.
• CLI upgraded from clap 2.x to 4.x (#118).
• filter_speckle CLI cap raised from 16 to 128, matching the web app (#115).
• Depends on visioncortex 0.9.
• Python wheel CI now runs only on release tags and manual dispatch, not on every commit.

webapp.2024.5

• Key transparent image in webapp
• Stop inverting black/white for binary images

0.6.4

• Update visioncortex version to 0.8.8

0.6.1

• Fixed "The two lines are parallel!"

Python Binding

Thanks to the contribution of @etjones, we now have an official Python binding! #55

https://pypi.org/project/vtracer/0.6.10/

0.6.0

Nothing is new. Other than a new set of compiled binaries.

0.5.0

What's Changed

• Fix deprecation warning from converter.rs by @wolfgangmeyers in #16
• Fix docs typo by @skuteli in #25
• Alpha channel handling in CLI by @zachwolfe in #23

New Contributors

• @wolfgangmeyers made their first contribution in #16
• @skuteli made their first contribution in #25
• @zachwolfe made their first contribution in #23

Full Changelog: 0.4.0...0.5.0

0.4.0

• SVG path string numeric precision

0.3.0

• Added cutout mode