Image tracing utility.
- 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 below use TANGENT
and PIXEL
passes to show the curve fit.
- ::
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).
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.