Blame man/tiff2ps.1

Packit 7838c8
.\" $Id: tiff2ps.1,v 1.12 2016-09-25 20:05:51 bfriesen Exp $
Packit 7838c8
.\"
Packit 7838c8
.\" Copyright (c) 1988-1997 Sam Leffler
Packit 7838c8
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
Packit 7838c8
.\"
Packit 7838c8
.\" Permission to use, copy, modify, distribute, and sell this software and 
Packit 7838c8
.\" its documentation for any purpose is hereby granted without fee, provided
Packit 7838c8
.\" that (i) the above copyright notices and this permission notice appear in
Packit 7838c8
.\" all copies of the software and related documentation, and (ii) the names of
Packit 7838c8
.\" Sam Leffler and Silicon Graphics may not be used in any advertising or
Packit 7838c8
.\" publicity relating to the software without the specific, prior written
Packit 7838c8
.\" permission of Sam Leffler and Silicon Graphics.
Packit 7838c8
.\" 
Packit 7838c8
.\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
Packit 7838c8
.\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
Packit 7838c8
.\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
Packit 7838c8
.\" 
Packit 7838c8
.\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
Packit 7838c8
.\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
Packit 7838c8
.\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
Packit 7838c8
.\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
Packit 7838c8
.\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
Packit 7838c8
.\" OF THIS SOFTWARE.
Packit 7838c8
.\"
Packit 7838c8
.ds Ps PostScript
Packit 7838c8
.if n .po 0
Packit 7838c8
.TH TIFF2PS 1 "November 2, 2005" "libtiff"
Packit 7838c8
.SH NAME
Packit 7838c8
tiff2ps \- convert a
Packit 7838c8
.SM TIFF
Packit 7838c8
image to \*(Ps\*(Tm
Packit 7838c8
.SH SYNOPSIS
Packit 7838c8
.B tiff2ps
Packit 7838c8
[
Packit 7838c8
.I options
Packit 7838c8
]
Packit 7838c8
.I "input.tif ..."
Packit 7838c8
.SH DESCRIPTION
Packit 7838c8
.I tiff2ps
Packit 7838c8
reads
Packit 7838c8
.SM TIFF
Packit 7838c8
images and writes \*(Ps or Encapsulated \*(Ps (EPS)
Packit 7838c8
on the standard output.
Packit 7838c8
By default,
Packit 7838c8
.I tiff2ps
Packit 7838c8
writes Encapsulated \*(Ps for the first image in the specified
Packit 7838c8
.SM TIFF
Packit 7838c8
image file.
Packit 7838c8
.PP
Packit 7838c8
By default,
Packit 7838c8
.I tiff2ps
Packit 7838c8
will generate \*(Ps that fills a printed area specified
Packit 7838c8
by the 
Packit 7838c8
.SM TIFF
Packit 7838c8
tags in the input file.
Packit 7838c8
If the file does not contain
Packit 7838c8
.I XResolution
Packit 7838c8
or
Packit 7838c8
.I YResolution
Packit 7838c8
tags, then the printed area is set according to the image dimensions.
Packit 7838c8
The
Packit 7838c8
.B \-w
Packit 7838c8
and
Packit 7838c8
.B \-h
Packit 7838c8
options (see below)
Packit 7838c8
can be used to set the dimensions of the printed area in inches;
Packit 7838c8
overriding any relevant
Packit 7838c8
.SM TIFF
Packit 7838c8
tags.
Packit 7838c8
.PP
Packit 7838c8
The \*(Ps generated for
Packit 7838c8
.SM RGB,
Packit 7838c8
palette, and
Packit 7838c8
.SM CMYK
Packit 7838c8
images uses the
Packit 7838c8
.I colorimage
Packit 7838c8
operator.
Packit 7838c8
The \*(Ps generated for
Packit 7838c8
greyscale and bilevel images
Packit 7838c8
uses the
Packit 7838c8
.I image
Packit 7838c8
operator.
Packit 7838c8
When the
Packit 7838c8
.I colorimage
Packit 7838c8
operator is used, \*(Ps code to emulate this operator
Packit 7838c8
on older \*(Ps printers is also generated.
Packit 7838c8
Note that this emulation code can be very slow.
Packit 7838c8
.PP
Packit 7838c8
Color images with associated alpha data are composited over
Packit 7838c8
a white background.
Packit 7838c8
.SH OPTIONS
Packit 7838c8
.TP
Packit 7838c8
.B \-1
Packit 7838c8
Generate \*(Ps Level 1 (the default).
Packit 7838c8
.TP
Packit 7838c8
.B \-2
Packit 7838c8
Generate \*(Ps Level 2.
Packit 7838c8
.TP
Packit 7838c8
.B \-3
Packit 7838c8
Generate \*(Ps Level 3. It basically allows one to use the /flateDecode
Packit 7838c8
filter for ZIP compressed TIFF images.
Packit 7838c8
.TP
Packit 7838c8
.B \-8
Packit 7838c8
Disable use of ASCII85 encoding with \*(Ps Level 2/3.
Packit 7838c8
.TP
Packit 7838c8
.B \-a
Packit 7838c8
Generate output for all IFDs (pages) in the input file.
Packit 7838c8
.TP
Packit 7838c8
.B \-b
Packit 7838c8
Specify the bottom margin for the output (in inches). This does not affect
Packit 7838c8
the height of the printed image.
Packit 7838c8
.TP
Packit 7838c8
.B \-c
Packit 7838c8
Center the image in the output. This option only shows an effect if both
Packit 7838c8
the
Packit 7838c8
.B \-w
Packit 7838c8
and the
Packit 7838c8
.B \-h
Packit 7838c8
option are given.
Packit 7838c8
.TP
Packit 7838c8
.B \-C
Packit 7838c8
Specify the document creator name.
Packit 7838c8
.TP
Packit 7838c8
.B \-d
Packit 7838c8
Set the initial
Packit 7838c8
.SM TIFF
Packit 7838c8
directory to the specified directory number.
Packit 7838c8
(NB: Directories are numbered starting at zero.)
Packit 7838c8
This option is useful for selecting individual pages in a
Packit 7838c8
multi-page (e.g. facsimile) file.
Packit 7838c8
.TP
Packit 7838c8
.B \-D
Packit 7838c8
Enable duplex printing (two pages per sheet of paper).
Packit 7838c8
.TP
Packit 7838c8
.B \-e
Packit 7838c8
Force the generation of Encapsulated \*(Ps (implies
Packit 7838c8
.BR \-z ).
Packit 7838c8
.TP
Packit 7838c8
.B \-h
Packit 7838c8
Specify the vertical size of the printed area (in inches).
Packit 7838c8
.TP
Packit 7838c8
.B \-H
Packit 7838c8
Specify the maximum height of image (in inches). Images with larger sizes will
Packit 7838c8
be split in several pages. Option
Packit 7838c8
.B \-L
Packit 7838c8
may be used for specifying size of split images overlapping.
Packit 7838c8
.B \-i
Packit 7838c8
Enable/disable pixel interpolation.  This option requires a
Packit 7838c8
single numeric value: zero to disable pixel interpolation and
Packit 7838c8
non-zero to enable.  The default is enabled.
Packit 7838c8
.TP
Packit 7838c8
.B \-L
Packit 7838c8
Specify the size of overlapping for split images (in inches). Used in
Packit 7838c8
conjunction with
Packit 7838c8
.B \-H
Packit 7838c8
and
Packit 7838c8
.B \-W
Packit 7838c8
options.
Packit 7838c8
.TP
Packit 7838c8
.B \-l
Packit 7838c8
Specify the left margin for the output (in inches). This does not affect
Packit 7838c8
the width of the printed image.
Packit 7838c8
.TP
Packit 7838c8
.B \-m
Packit 7838c8
Where possible render using the
Packit 7838c8
.I imagemask
Packit 7838c8
\*(Ps operator instead of the
Packit 7838c8
.I image
Packit 7838c8
operator.  When this option is specified
Packit 7838c8
.I tiff2ps
Packit 7838c8
will use
Packit 7838c8
.I imagemask
Packit 7838c8
for rendering 1 bit deep images.  If this option is not specified
Packit 7838c8
or if the image depth is greater than 1 then the
Packit 7838c8
.I image
Packit 7838c8
operator is used.
Packit 7838c8
.TP
Packit 7838c8
.B \-o
Packit 7838c8
Set the initial
Packit 7838c8
.SM TIFF
Packit 7838c8
directory to the
Packit 7838c8
.SM IFD
Packit 7838c8
at the specified file offset.
Packit 7838c8
This option is useful for selecting thumbnail images and the
Packit 7838c8
like which are hidden using the
Packit 7838c8
.I SubIFD
Packit 7838c8
tag.
Packit 7838c8
.TP
Packit 7838c8
.B \-O
Packit 7838c8
Write \*(Ps to specified file instead of standard output.
Packit 7838c8
.TP
Packit 7838c8
.B \-p
Packit 7838c8
Force the generation of (non-Encapsulated) \*(Ps.
Packit 7838c8
.TP
Packit 7838c8
.B \-P L|P
Packit 7838c8
Set optional PageOrientation DSC comment to Landscape or Portrait.
Packit 7838c8
.TP
Packit 7838c8
.B \-r 90|180|270|auto
Packit 7838c8
Rotate image by 90, 180, 270 degrees or auto.  Auto picks the best
Packit 7838c8
fit for the image on the specified paper size (eg portrait
Packit 7838c8
or landscape) if -h or -w is specified. Rotation is in degrees 
Packit 7838c8
counterclockwise. Auto rotates 90 degrees ccw to produce landscape.
Packit 7838c8
.TP
Packit 7838c8
.B \-s
Packit 7838c8
Generate output for a single IFD (page) in the input file.
Packit 7838c8
.TP
Packit 7838c8
.B \-t
Packit 7838c8
Specify the document title string.
Packit 7838c8
.TP
Packit 7838c8
.B \-T
Packit 7838c8
Print pages for top edge binding.
Packit 7838c8
.TP
Packit 7838c8
.B \-w
Packit 7838c8
Specify the horizontal size of the printed area (in inches).
Packit 7838c8
.TP
Packit 7838c8
.B \-W
Packit 7838c8
Specify the maximum width of image (in inches). Images with larger sizes will
Packit 7838c8
be split in several pages. Options
Packit 7838c8
.B \-L
Packit 7838c8
and 
Packit 7838c8
.B \-W
Packit 7838c8
are mutually exclusive.
Packit 7838c8
.TP
Packit 7838c8
.B \-x
Packit 7838c8
Override resolution units specified in the TIFF as centimeters.
Packit 7838c8
.TP
Packit 7838c8
.B \-y
Packit 7838c8
Override resolution units specified in the TIFF as inches.
Packit 7838c8
.TP
Packit 7838c8
.B \-z
Packit 7838c8
When generating \*(Ps Level 2, data is scaled so that it does not
Packit 7838c8
image into the 
Packit 7838c8
.I deadzone
Packit 7838c8
on a page (the outer margin that the printing device is unable to mark).
Packit 7838c8
This option suppresses this behavior.
Packit 7838c8
When \*(Ps Level 1 is generated, data is imaged to the entire printed
Packit 7838c8
page and this option has no affect.
Packit 7838c8
.SH EXAMPLES
Packit 7838c8
The following generates \*(Ps Level 2 for all pages of a facsimile:
Packit 7838c8
.RS
Packit 7838c8
.nf
Packit 7838c8
tiff2ps \-a2 fax.tif | lpr
Packit 7838c8
.fi
Packit 7838c8
.RE
Packit 7838c8
Note also that if you have version 2.6.1 or newer of Ghostscript then you
Packit 7838c8
can efficiently preview facsimile generated with the above command.
Packit 7838c8
.PP
Packit 7838c8
To generate Encapsulated \*(Ps for a the image at directory 2
Packit 7838c8
of an image use:
Packit 7838c8
.RS
Packit 7838c8
.nf
Packit 7838c8
tiff2ps \-d 1 foo.tif
Packit 7838c8
.fi
Packit 7838c8
.RE
Packit 7838c8
(Notice that directories are numbered starting at zero.)
Packit 7838c8
.PP
Packit 7838c8
If you have a long image, it may be split in several pages:
Packit 7838c8
.RS
Packit 7838c8
.nf
Packit 7838c8
tiff2ps \-h11 \-w8.5 \-H14 \-L.5 foo.tif > foo.ps
Packit 7838c8
.fi
Packit 7838c8
.RE
Packit 7838c8
The page size is set to 8.5x11 by
Packit 7838c8
.B \-w
Packit 7838c8
and
Packit 7838c8
.B \-h
Packit 7838c8
options. We will accept a small amount of vertical compression, so
Packit 7838c8
.B \-H
Packit 7838c8
set to 14. Any pages between 11 and 14 inches will be fit onto one page.
Packit 7838c8
Pages longer than 14 inches are cut off at 11 and continued on the next
Packit 7838c8
page. The
Packit 7838c8
.B \-L.5
Packit 7838c8
option says to repeat a half inch on the next page (to improve readability).
Packit 7838c8
.SH BUGS
Packit 7838c8
Because \*(Ps does not support the notion of a colormap,
Packit 7838c8
8-bit palette images produce 24-bit \*(Ps images.
Packit 7838c8
This conversion results in output that is six times
Packit 7838c8
bigger than the original image and which takes a long time
Packit 7838c8
to send to a printer over a serial line.
Packit 7838c8
Matters are even worse for 4-, 2-, and 1-bit palette images.
Packit 7838c8
.PP
Packit 7838c8
Does not handle tiled images when generating \*(Ps Level I output.
Packit 7838c8
.SH "SEE ALSO"
Packit 7838c8
.BR pal2rgb (1),
Packit 7838c8
.BR tiffinfo (1),
Packit 7838c8
.BR tiffcp (1),
Packit 7838c8
.BR tiffgt (1),
Packit 7838c8
.BR tiffmedian (1),
Packit 7838c8
.BR tiff2bw (1),
Packit 7838c8
.BR tiffsv (1),
Packit 7838c8
.BR libtiff (3)
Packit 7838c8
.PP
Packit 7838c8
Libtiff library home page:
Packit 7838c8
.BR http://www.simplesystems.org/libtiff/