
	   POTRACE - transform bitmaps into vector graphics
			
				* * *
	   
DESCRIPTION

 Potrace is a utility for tracing a bitmap, which means, transforming
 a bitmap into a smooth, scalable image.  The input is a bitmap (PBM,
 PGM, PPM, or BMP), and the default output is an encapsulated
 PostScript file (EPS).  A typical use is to create EPS files from
 scanned data, such as company or university logos, handwritten notes,
 etc.  The resulting image is not "jaggy" like a bitmap, but
 smooth. It can then be rendered at any resolution.

 Potrace can currently produce the following output formats: EPS,
 PostScript, SVG (scalable vector graphics), and PGM (for easy
 antialiasing). Additional backends might be added in the future.

COMPILATION

 For generic compilation instructions, see the file INSTALL.  In
 addition, the following compile time options (options to ./configure)
 are supported:

 --enable-compress:   enable PostScript level 2 compression via the
	 	      external "compress" program
 --disable-compress:  disable PostScript level 2 compression
 --enable-metric:     use metric units (centimeters) as default
 --enable-a4:	      use a4 as the default papersize

INSTALLING

 If you are installing from sources, just do "make install" as root.
 If you are installing from a binary distribution, just copy the
 binary "potrace" to a place where the operating system usually looks
 for binaries, such as /usr/local/bin, and copy the file "potrace.1"
 to a place where the operating system usually looks for man pages,
 such as /usr/local/man/man1. For instructions on installing potrace
 under Windows, see the file README.win.

PATENT ISSUES

 Potrace uses PostScript level 2 compression by default.
 Unfortunately, the LZW algorithm which performs this compression is
 patented, and thus it cannot be implemented directly in potrace.  We
 circumvent this problem by using the external compress program to
 perform the actual compression, then transforming the output into the
 required format.  Note that the compress program is a separate piece
 of software and is not a part of potrace; it is the user's
 responsibility to ensure that his or her copy of compress is properly
 licensed.

 On systems where the compress program is not available, one should
 disable level 2 compression by specifying the -c or -3 options. It is
 also possible to configure potrace at compile time not to use
 compress; in this case, level 2 compression will not be available.
 Normally, the presence of the compress program is detected
 automatically at compile time.  It can be overridden by passing the
 --enable-compress or --disable-compress option to ./configure.

USAGE

 For more detailed usage information, see the man page. 

Usage: potrace [options] [file...]
General options:
 -h, --help                 - print this help message and exit
 -v, --version              - print version info and exit
 -l, --license              - print license info and exit
 -V, --show-defaults        - print compiled-in defaults and exit
Input/output options:
 -o, --output <file>        - output to file
Backend selection:
 -e, --eps                  - EPS backend (encapsulated postscript) (default)
 -p, --postscript           - Postscript backend
 -s, --svg                  - SVG backend (scalable vector graphics)
 -g, --pgm                  - PGM backend (portable greymap)
 -b, --backend <name>       - select backend by name
Algorithm options:
 -z, --turnpolicy <policy>  - how to resolve ambiguities in path decomposition
 -t, --turdsize <n>         - suppress speckles of up to this size (default 2)
 -a, --alphamax <n>         - corner threshold parameter (default 1)
 -n, --longcurve            - turn off curve optimization
 -O, --opttolerance <n>     - curve optimization tolerance (default 0.2)
 -u, --unit <n>             - quantize output to 1/unit pixels (default 10)
 -d, --debug <n>            - produce debugging output of type n (n=1,2,3)
Scaling and placement options:
 -W, --width <dim>          - width of output image
 -H, --height <dim>         - height of output image
 -r, --resolution <n>[x<n>] - resolution (in dpi)
 -x, --scale <n>[x<n>]      - scaling factor (pgm backend)
 -S, --stretch <n>          - yresolution/xresolution
 -A, --rotate <angle>       - rotate counterclockwise by angle
 -M, --margin <dim>         - margin
 -L, --leftmargin <dim>     - left margin
 -R, --rightmargin <dim>    - right margin
 -T, --topmargin <dim>      - top margin
 -B, --bottommargin <dim>   - bottom margin
Postscript/EPS options:
 -P, --pagesize <format>    - page size (default is letter)
 -C, --color #rrggbb        - set foreground color (default black)
 -c, --cleartext            - do not compress the output
 -2, --level2               - use postscript level 2 compression (default)
 -3, --level3               - use postscript level 3 compression
 -q, --longcoding           - do not optimize for file size
PGM options:
 -G, --gamma <n>            - gamma value for anti-aliasing (default 2.2)
Frontend options:
 -k, --blacklevel <n>       - black/white cutoff in input file (default 0.5)
 -i, --invert               - invert bitmap

Dimensions can have optional units, e.g. 6.5in, 15cm, 100pt.
Default is inches (or pixels for PGM backend).
Possible input file formats are: pnm (pbm, pgm, ppm), bmp.

DOCUMENTATION

 The man page contains detailed usage information:
 http://potrace.sourceforge.net/potrace.html

 Many common questions are answered in the FAQ:
 http://potrace.sourceforge.net/faq.html

 Some examples are given on the following web page:
 http://potrace.sourceforge.net/samples.html

 The following document describes in detail how potrace works:
 http://potrace.sourceforge.net/potrace.pdf

COPYRIGHT

 Copyright (C) 2001-2003 Peter Selinger

 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation; either version 2 of the License, or (at
 your option) any later version.

 This program is distributed in the hope that it will be useful, but
 WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 General Public License for more details.

 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307,
 USA. See also http://www.gnu.org/.

 See the file COPYING for details.
