|
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/
|