Raster Retrace

Image tracing utility.

Feature Set

• Curve (re)fitting, using an iterative simplification algorithm: see curve-fit-nd library.
• Black and white image tracing.
• Corner detection (with angle threshold).
• SVG vector output.

Note

This is an initial release, currently this tool works but only loads PPM images and writes out SVG.

Support for other image formats is planned.

Examples

Examples below use TANGENT and PIXEL passes to show the curve fit.

Usage

::

Bitmap image tracing utility

Options:

-h, --help Print help text

File Options:

-i, --input FILEPATH The file path to use for input -o, --output FILEPATH The file path to use for writing

Tracing Behavior:

-m, --mode MODE The method used for tracing the image in [OUTLINE, CENTER], (defaults to OUTLINE). -z, --turnpolicy POLICY Method for extracting outlines [BLACK, WHITE, MAJORITY, MINORITY], (defaults to MAJORITY).

Curve Evaluation Options:

Parameters controlling curve evaluation behavior.

-e, --error PIXELS The error threshold (defaults to 1.0) -t, --simplify PIXELS Simplify polygon before fitting (defaults to 2.0) -c, --corner DEGREES The corner threshold (pi or greater to disable, defaults to 30.0) --optimize-exhaustive When passed, perform exhaustive curve fitting (can be slow!)

Output Options:

Generic options for output (format agnostic).

-s, --scale SCALE Scale for output, (defaults to 1). -p, --passes PASSES Write extra debug graphics, comma separated list of passes including [PIXEL, PRE_FIT, TANGENT], (defaults to []). --pass-scale SCALE Scale graphic details used in some debug passes, (defaults to 1).

TODO

While the basics work, currently there are areas for improvement.

• Support for multiple image formats (most likely using the piston crate).
• Improve bitmap outline extraction method.
• Improve center-line extraction method.