Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
AUTOTRACE(1)		    General Commands Manual		  AUTOTRACE(1)

       autotrace - converts bitmap image data into vector graphics

       autotrace  [-background-color	hexvalue] [-centerline]	[-color-count
       int] [-corner-always-threshold  angle] [-corner-surround	  int]	[-cor-
       ner-threshold	angle]	[-despeckle-level  int]	[-despeckle-tightness
       real] [-dpi  int] [-error-threshold  real]  [-filter-iterations	  int]
       [-help]	[-input-format	  format]  [-line-reversion-threshold	 real]
       [-line-threshold	  real]	 [-list-input-formats]	[-list-output-formats]
       [-log]  [-output-file  file] [-output-format  format] [-preserve-width]
       [-remove-adjacent-corners]  [-report-progress]  [-debug-arch]  [-debug-
       bitmap]	[-tangent-surround   int] [-version] [-width-factor  real] in-

       The autotrace program accepts bitmap graphics from the  file  inputfile
       specified  on  the command line,	and as output produces a collection of
       splines approximating the original image, the converting	the image from
       bitmap to vector	format.	 It behaves in a manner	similar	to the commer-
       cial software known as *tream*ine or *orel*race.	 The result is sent to
       standard	output unless the -output-file option is active.

       Options	can  begin  with either	-- or -.  Any unambiguous abbreviation
       can be used for the option name.	 Option	names and values can be	 sepa-
       rated with either a space or equal sign (=).

       -background-color hexvalue
	      Employ  the  color  specified by the hexadecimal code hexcode as
	      the background that should be ignored, for example  FFFFFF  (de-
	      fault: no	background color).

	      Trace an object's	centerline (default: employ its	outline).

       -color-count int
	      Reduce the bitmap	to using the number of colors specified	by the
	      unsigned integer int (range: 1-256).  The	default	value of 0 in-
	      dicates  that  no	 color reduction is to be done.	 Does not work
	      with grayscale images.

       -corner-always-threshold	angle
	      Consider any angle at a pixel which falls	 below	the  specified
	      angle  (in degrees) as a corner, even if it is bordered by other
	      corner pixels (default: 60).

       -corner-surround	int
	      Consider the specified number of pixels  on  either  side	 of  a
	      point when determining if	that point is a	corner (default: 4).

       -corner-threshold angle
	      Consider	any pixel which	forms an angle with its	predecessor(s)
	      and successor(s) that is smaller than the	 specified  angle  (in
	      degrees) as a corner (default: 100).

       -despeckle-level	int
	      Employ  the specified integer (range: 1-20) as the value for de-
	      speckling	(default: no despeckling).

       -despeckle-tightness real
	      Employ the specified real	number (range: 0.0-8.0)	as  the	 value
	      for despeckle tightness (default:	2.0).

       -dpi int
	      The  dots	 per inch value	in the input image, affects scaling of
	      mif output image.

       -error-threshold	real
	      Subdivide	fitted curves that are offset by a  number  of	pixels
	      exceeding	the specified real number (default: 2.0).

       -filter-iterations int
	      Smooth  the curve	the specified number of	times prior to fitting
	      (default:	4).

       -help  Print a help message and exit.

       -input-format format
	      Employ the specified input format, where format is one of:

	      BMP (Windows bitmap format)

	      PBM (Portable BitMap format)

	      PGM (Portable Graymap format)

	      PNM (Portable Anymap format)

	      PPM (Portable Pixmap format)

	      TGA (Targa format)

	      The supported input formats are determined when the  application
	      is built and depend upon the availability	of other software (the
	      -list-input-formats command can be used to determine  which  are
	      supported	locally).

       -line-reversion-threshold real
	      When  a  spline  is closer to a straight line than the specified
	      real number weighted by the square of the	curve length (default:
	      .01),  maintain it as a straight line, even if it	is a list with

       -line-threshold real
	      If a spline does not deviate from	the straight line  defined  by
	      its  endpoints by	more than the specified	number of pixels, then
	      treat it as a straight line (default: 1).

	      Send a list of the supported input formats to stderr.

	      Send a list of the supported output formats to stderr.

       -log   Send a detailed progress report to the file inputfile.log.

       -output-file file
	      Send the output to the specified file.

       -output-format format
	      Employ the specified output format, where	format is one of:

	      ai(Adobe Illustrator)

	      cgm(Computer Graphics Metafile)

	      dr2d(IFF DR2D format, used almost	 exclusively  on  Amiga	 plat-

	      dxf(AutoCAD Drawing Exchange format)

	      emf(Windows Enhanced Metafile format)

	      epd(Encapsulated Vectorial Graphics format)

	      eps(Encapsulated )

	      er(Elastic Reality Shape format)

	      fig(xfig (1) 3.2)

	      mif(FrameMaker MIF format)

	      pdf(Portable Data	Format)

	      p2e(pstoedit (1) frontend)


	      svg(Scalable Vector Graphics)

	      swf(Shockwave Flash 3)

	      The supported output formats are determined when the application
	      is built and depend upon the availability	of other software (the
	      -list-output-formats  command can	be used	to determine which are
	      supported	locally).

	      Whether to preserve line width prior to thinning.

	      Remove adjacent corners.

	      Report tracing status in real time.

	      Print the	type of	cpu.

	      Dump loaded bitmap to <input_name>.bitmap.

       -tangent-surround int
	      Consider the specified number of points  to  either  side	 of  a
	      point when computing the tangent at that point (default: 3).

	      Print the	version	number of the program and exit.

       -width-factor real
	      Weight factor for	fitting	the linewidth.

       /depot/bin/autotrace  binary

       gimp(1),	   ImageMagick(1),    pbm(1),	pgm(1),	  pnm(1),   ps2pdf(1),
       pstoedit(1), pstoepd(1),	sketch(1), xfig(1), xv(1)

       Martin Weber (

       Manual page by R. P. C. Rodgers,	Lister Hill National Center  for  Bio-
       medical	  Communications,    U.S.   National   Library	 of   Medicine

				10 October 2002			  AUTOTRACE(1)


Want to link to this manual page? Use this URL:

home | help