PSTOTIFF 1 "08 April 2001" "Version 1.00"

Table of contents


pstotiff - convert (Encapsulated) PostScript files to TIFF bitmap files


pstotiff [ -? ] [ -crop ] [ -debug ] [ -extension name ] [ -gamma float-value ] [ -help ] [ -icon ] [ -margin pixels ] [ -norun ] [ -resolution dpi ] [ -version ] [ -Wcomponent,option ] PostScript-files


pstotiff converts one or more input (Encapsulated) PostScript files to output Tag Image File Format (TIFF) lossless compressed bitmap files.

For maximal color fidelity, bitmaps are produced in 24-bit color mode, with 16,777,216 possible colors.

For each file given on the command line, an output file is written with the same basename as the input file, but with extension tiff, or the name specified by the -extension option.

With the -icon option, small companion files with the same name are also written in a subdirectory icons, which is created if necessary.

If no files are given on the command line, then stdin is read, and stdout is written, and no icon file can be produced.

pstotiff is a convenient interface to gs(1), pngtopnm(1), pnmcrop(1), pnmmargin(1), and pnmtotiff(1), which do the real work.


Command-line options may be abbreviated to a unique leading prefix.

To avoid confusion with options, if a filename begins with a hyphen, it must be disguised by a leading absolute or relative directory path, e.g. /tmp/-foo.eps or ./-foo.eps.

Options may begin with either UNIX-style single hyphens, or GNU/POSIX-style double hyphens, and may be abbreviated to any unique prefix.

Crop the image to remove edges that are the background color.
Turn on debug tracing.
-extension name
Replace the default output file extension, tiff, with name.
-gamma float-value
Specify an image gamma correction as a floating-point number. Small values darken the image, and large values lighten it. Typical values are in the range 0.5 .. 3.0.

[Default: 1.0]


Display a brief help message on stdout, and exit with a success status code (0 on UNIX).
Produce icon files as well as TIFF files. An icon file is just a low-resolution (12dpi) bitmap that may be useful as a compact representation of what is in the TIFF file.

In filter mode (no files on the command line), this option is ignored.

-margin pixels
Add a background margin of width pixels to the output image. This option is usually specified together with -crop.
Show on stdout the commands that would be executed, but do not run them.

Use this option to trap the complex command pipelines for further private customization.

-resolution dpi
Set the output bitmap resolution to dpi dots per inch.

[Default: 100 dpi, suitable only for screen resolution].

Display program version numbers and dates on stdout, and exit with a success status code (0 on UNIX).
Pass option to the program component, which must be one of gs, pngtopnm, pnmcrop, pnmmargin, or pnmtotiff.

This option, a POSIX convention, provides a general way for a user to pass options to programs invoked by another program. The value option is passed after any generated in response to options supplied to pstotiff. For example, -Wpnmmargin,-black would cause any added margin to be colored black.


epsutil(1), gs(1), gimp(1), photoshop(1), pngtopnm(1), pnmcrop(1), pnmmargin(1), pnmtotiff(1), pstojpeg(1), pstopng(1), xv(1).

Tag Image File Format ({TIFF}) Specification Revision 5.0, Aldus Corporation, Seattle, WA, and Microsoft Corporation, Redmond, WA, August 1988.

David C. Kay and John R. Levine, Graphics File Formats, Chapter 5, Windcrest/McGraw-Hill, Blue Ridge Summit, PA, 1992, ISBN 0-8306-3060-0 (hardcover), 0-8306-3059-7 (paperback).

Steve Rimmer, Bit-Mapped Graphics, Windcrest/McGraw-Hill, Blue Ridge Summit, PA, 1993, ISBN 0-8306-4209-9 (hardback), 0-8306-4208-0 (paperback).

GŁnter Born, The File Formats Handbook, Chapter 27, International Thomson Computer Press, Boston, MA, 1995, ISBN 1-85032-117-5 (hardback), 1-85032-128-0 (paperback).

John Miano, The programmer's guide to compressed image files: JPEG, TIFF, GIF, XBM, BMP, Addison-Wesley Longman, Harlow, Essex, England 1999, ISBN 0-201-60443-4.


Nelson H. F. Beebe, Ph.D.
Center for Scientific Computing
University of Utah
Department of Mathematics, 322 INSCC
155 S 1400 E RM 233
Salt Lake City, UT 84112-0090
Tel: +1 801 581 5254
FAX: +1 801 585 1640, +1 801 581 4148