STIFF2PS(1) Impressario STIFF2PS(1)NAMEstiff2ps - convert a Stream TIFF (STIFF) image file to PostScript
SYNOPSISstiff2ps [-O filename] [-L filename] [-B]
[-C colorspace] [-F] [-f] [-r angle]
[-p imageRes] [-z factor] [-n nCopies]
[-G g0[,g1,g2[,g3]]] [-N nUpX[,nUpY]]
[-I filename] [-b kbytes] [-h] [-D]
[STIFFImageFilename ...]
DESCRIPTIONstiff2ps converts raster files in Stream TIFF (STIFF) image format into
PostScript code. The program provides a number of image transformation
capabilities including zooming, rotation and gamma correction. In
addition, stiff2ps provides the capability to display multiple images on
a single physical page.
stiff2ps supports conversion of all standard STIFF image file colorspaces
(i.e. K, W, RGB, CMY, YMC, CMYK, YMCK, KCMY) and data formats (i.e.
planar and chunky). stiff2ps supports images with 1, 4, 8 and 16 bits per
sample. For images with 16 bits per sample, stiff2ps will assume that the
full bit range is being used (i.e. data values range from 0 thru 65535
inclusive). If the STIFF tags STMinSampleValue or STMaxSampleValue are
found in the image file, the values of these tags will be used as the
image data range. This allows 16 bit images to contain data with
intermediate ranges (e.g. 12 bits per sample ranging from 0 thru 4095) to
be processed by stiff2ps. The PostScript image data written by stiff2ps
will be at the same bits per sample as the input image with the exception
of 16 bits per sample input images. These images will be scaled to 8 bits
per sample which is the highest sample depth available on PostScript
Level 1 interpreters.
Command Line Options
Typically, stiff2ps expects at least one STIFF image file to be specified
as input on the command line after all option switches. If no image file
is specified on the command line, stiff2ps will read from the standard
input. By default, stiff2ps assumes that its output should be written to
the standard output and messages should be written to standard error.
-O filename
Specifies the name of the file to which the PostScript output
will be sent. If the -O option is not specified, output will
be sent to the standard output.
-L filename
Specifies the name of the file to which error, warning and
informational messages are to be written. If the file specified
already exists, any messages generated by stiff2ps will be
appended to the end of the file. If the -L option is not
specified, message output will be sent to standard error.
Page 1
STIFF2PS(1) Impressario STIFF2PS(1)-B Specifies that binary PostScript should be output where
applicable. The majority of the output from stiff2ps is bitmap
image data. By default this data is output as ASCII hexadecimal
values. Specifying -B will output this image data as binary
values thereby cutting in half the number of bytes of
PostScript data output. However, binary data output should only
be used when the communications channel between stiff2ps and
the PostScript interpreter can accept 8-bit data. This
precludes the use of the -B switch when transmitting output
over serial connections.
-C colorspace
Specifies the output data colorspace. The value of colorspace
may be one of the following: w (black and white), the default,
cmyk, or rgb. The PostScript produced by cmyk and rgb can only
be interpreted by a Level 2 PostScript interpreter or a Level 1
interpreter with the CMYK color extensions (e.g. psrip(1)). The
PostScript produced by w can be sent to any Level 1
interpreter. The colorspace conversion equations used by
stiff2ps are:
W to RGB: r = g = b = w
W to CMYK: c = m = y = 0; k = 1 - w
RGB to W: w = 0.299 r + 0.587 g + 0.114 b
RGB to CMYK:
ci = 1 - r; mi = 1 - g; yi = 1 - b
k = min(ci, mi, yi)
c = ci - k; m = mi - k: y = yi - k
CMYK to RGB and to W:
ri = 1 - c
gi = 1 - m
bi = 1 - y
r = (ri > k)? ri - k: 0
g = (gi > k)? gi - k: 0
b = (bi > k)? bi - k: 0
w = 0.299 r + 0.587 g + 0.114 b
-F Specifies that the image should be oriented so that it best
fits the page. That is, the image is oriented such that its
longer dimension is parallel with the longer dimension of the
paper. If -F is specified, any rotation specified by the -r
switch is ignored. By default the image is oriented with zero
degrees of rotation unless the -r switch specifies a different
rotation.
Page 2
STIFF2PS(1) Impressario STIFF2PS(1)-f Specifies that the output image should be flipped (mirrored)
about the vertical axis. This flag is useful when creating
transparencies. Note that flipping of the image is performed
after any rotation. Therefore, the image is always flipped
about the vertical axis.
-r angle Specifies that the image is to be rotated by angle degrees.
angle may be any positive or negative integer value. Positive
rotations are counter-clockwise measured from the horizontal
axis. The default rotation angle is 0. Note that rotation is
performed before any image flipping (-f). The -r switch is
ignored if the best-fit switch -F is specified.
-z factor and -p imageRes
Each of these switches provides scaling of the original image.
The two switches are mutually exclusive.
The -z switch provides image zooming. factor is a positive
floating point value typically between 0.0 and 1.0. A zoom
factor of 1.0, the default, indicates that the image should be
scaled to fit the entire page while preserving the original
image's aspect ratio. A zoom factor of 0.5 would produce an
image sized to 50% of that needed to fit the entire page. A
zoom factor of 0.0 produces no zooming. Instead the image is
output at its original size.
If an image must be sized based on a given resolution, the -p
switch should be specified in place of the -z switch. The
imageRes argument specifies the resolution used to size the
image in dots per inch. This resolution is independent of the
output device resolution. For example, suppose an image is one
inch by one inch when displayed on a 96 dpi monitor. In order
to print that image on a 300 dpi printer so that it remains one
inch by one inch the -p switch would be specified with an
imageRes of 96.
-n nCopies
Specifies the number of copies to produce of each page.
Specifying this switch simply sets the value of the #copies
variable in the output PostScript code. The value of this
variable is used by the PostScript operator showpage to
determine the number of output copies to produce. By default
the #copies variable is not specified and the number of copies
then defaults to one.
-G g0[,g1,g2[,g3]]
This switch provides gamma correction of the input image data.
The gamma function is:
corrected value = value ^ gamma
Page 3
STIFF2PS(1) Impressario STIFF2PS(1)
The gamma value (g0, etc.) is typically a value between 0.0 and
3.0. A gamma value less than 1.0 will tend to lighten the image
while a value greater than 1.0 will tend to darken the image. A
gamma of 1.0 will leave the image data unchanged. The gamma
value may be specified for each input color channel
individually or as a group. If g0 is the only gamma value
specified, this value will be applied to all input channels.
Note that a black and white image contains one input color
channel, an RGB image contains three input channels and a CMYK
image contains four input channels. Note that gamma correction
of one bit per sample images has no meaning and therefore the
-G switch has no effect for these images. The default gamma
value is 1.0 for all channels.
-N nUpX[,nUpY]
stiff2ps allows multiple STIFF image files to be specified on
the command line. By default, each image is output on a
separate physical page. The -N switch provides the capability
to divide up one physical page into multiple virtual pages.
This is often called n-up display. Using n-up, multiple image
files can be displayed on the same physical page. If only the
nUpX value is specified the physical page will be divided into
nUpX by nUpX virtual pages. If both nUpX and nUpY are
specified, the physical page will be divided into nUpX by nUpY
virtual pages. Images are displayed in row (horizontal) major
order. Note that nUpX is measured along the horizontal, x,
axis. For an 8.5 by 11.0 inch page, the horizontal axis is the
short dimension in portrait mode and the long dimension in
landscape mode. Rotation is performed on each image
individually and best-fit orientation is determined for each
image individually. Zooming is relative to the virtual page
size. Note that image replication is not performed. The number
of images specified on the command line is the number of images
displayed in the virtual pages.
-I filename
stiff2ps places a PostScript code prolog at the start of the
output file. By default, this prolog code is read from the
file /usr/lib/print/data/PSImageProlog. The -I switch allows a
different prolog file to be specified. This switch is not
intended for general use.
-b kbytes stiff2ps allocates buffers for performing input/output and
conversion operations. By default, the total size of these
buffers is limited to 64 KBytes. The -b switch allows a new
buffer size to be specified. The buffer size is specified in
multiples of 1024 (one K) bytes. For example, specifying 128
KBytes for buffering would permit approximately 21 rows of a
2048 pixel wide 8 bit per sample RGB image to be buffered. Note
that internally stiff2ps buffers data in terms of image rows.
If the kbytes is less than that required to buffer one image
row, kbytes will be ignored and one row will be buffered.
Page 4
STIFF2PS(1) Impressario STIFF2PS(1)-h Prints a program usage message to the standard error. This
usage message also lists the currently supported output
configurations.
-D Specifies verbose output for debugging purposes.
NOTES
1. The PostScript output produced by stiff2ps conforms to the Adobe
PostScript Document Structuring Conventions Version 3.0 as specified
in Appendix G of the "PostScript Language Reference Manual", 2nd
edition.
2. The PostScript output produced by stiff2ps wraps the input bitmap
image data with PostScript instructions. Therefore, the amount of
output data can be quit large especially if multiple image files are
specified or if the images are large. The size of the output file
should be kept in mind when sending the PostScript output over a
slow communications channel such as a serial line.
3. If stiff2ps is given an unrecognized or incomplete command line
option switch, it will print a warning message to the standard
error, ignore the option and continue processing.
4. If an image file is specified on the command line, stiff2ps will not
read its stdin for images.
5. Processing a planar STIFF image file requires random seeking within
the file. Therefore, when stiff2ps is reading planar STIFF image
data from a pipe to standard input, a disk based copy of the input
image must be created. This temporary image file will be created in
the directory specified by the TMPDIR environment variable. If that
variable is not set, the temporary file will be created in /var/tmp.
There must be sufficient free space in the temporary file directory
to store a complete copy of the image file or stiff2ps will fail.
6. stiff2ps can only process a single image file when reading from
standard input.
FILES
/usr/lib/print/stiff2ps Program file
/usr/lib/print/data/PSImageProlog PostScript prolog file
TRADEMARKS
PostScript is a registered trademark of Adobe Systems, Inc.
SEE ALSOpsrip(1), sgi2ps(1), PostScript Language Reference Manual - 2nd ed.,
Adobe Systems, Inc.
Page 5
