This tool produces a polygon set from a grayscale image using halftoning.
The polygons are pixel aligned so when rendered with AGG based renderers (as well as many other rendering engines) the result will approximately match the input image being used as a coverage mask.
The output polygon grid has half the linear resolution of the input image.
The process used tries to minimize data size while maintaining consistency with the input data in terms of pixel coverage. It also tries to maintain some similarity regarding the topological configuration (as present in the double resolution input data).
Internally the tool uses some code and components from GDAL 2. To allow
building it with GDAL 1 the source file gdalrasterpolygonenumerator.cpp
(from GDAL 2.1.1) is included in the repository - building and linking this
should only be required for GDAL 1.x
The program offers the following command line options:
-iinput image (required)-ooutput vector file (required)-ccombined input image - to generate accurate output with several layers (optional)-loutput layer name. Default:polygons.-xx attribute to apply to generated polygons (integer value, optional)-yy attribute to apply to generated polygons (integer value, optional)-zz attribute to apply to generated polygons (integer value, optional)-complementprocess complement (inverse) of input. Default:off.-appendappend to existing output file. Default:off.-memaximum error to accept for pixel coverage fraction. Default:0.05.-debuggenerate additional debug output. Default:off.
##Legal stuff
This program is licensed under the GNU GPL version 3.
Copyright 2016 Christoph Hormann

