| 1 |
.\" RCSid "$Id: ra_ps.1,v 1.3 2004/03/26 22:58:20 greg Exp $"
|
| 2 |
.TH RA_PS 1 8/28/98 RADIANCE
|
| 3 |
.SH NAME
|
| 4 |
ra_ps - convert RADIANCE picture to a PostScript file
|
| 5 |
.SH SYNOPSIS
|
| 6 |
.B ra_ps
|
| 7 |
[
|
| 8 |
.B \-b|c
|
| 9 |
][
|
| 10 |
.B \-A|B|C
|
| 11 |
][
|
| 12 |
.B "\-n ncopies"
|
| 13 |
][
|
| 14 |
.B "\-e +/-stops"
|
| 15 |
][
|
| 16 |
.B "\-g gamma"
|
| 17 |
][
|
| 18 |
.B "\-p paper"
|
| 19 |
][
|
| 20 |
.B "\-m[h|v] margin"
|
| 21 |
][
|
| 22 |
.B "\-d dpi"
|
| 23 |
]
|
| 24 |
[
|
| 25 |
.B input
|
| 26 |
[
|
| 27 |
.B output
|
| 28 |
]
|
| 29 |
]
|
| 30 |
.SH DESCRIPTION
|
| 31 |
.I Ra_ps
|
| 32 |
translates a RADIANCE picture to a color or greyscale
|
| 33 |
Adobe PostScript file for printing on
|
| 34 |
a laser printer or importing to a page layout program.
|
| 35 |
The
|
| 36 |
.I \-b
|
| 37 |
option tells
|
| 38 |
.I ra_ps
|
| 39 |
to produce greyscale output.
|
| 40 |
(The default is color, which may be specified explicitly with the
|
| 41 |
.I \-c
|
| 42 |
option.)\0
|
| 43 |
.PP
|
| 44 |
The
|
| 45 |
.I \-A
|
| 46 |
option specifies that the output should be in uncompressed ASCII
|
| 47 |
hexstring format (the default).
|
| 48 |
The
|
| 49 |
.I \-B
|
| 50 |
option specifies that the output should be in uncompressed binary
|
| 51 |
string format.
|
| 52 |
The file size will be roughly half that of the ASCII equivalent,
|
| 53 |
but some printers and especially some printer connections do not
|
| 54 |
support binary transfer, so this option should be used with caution.
|
| 55 |
The
|
| 56 |
.I \-C
|
| 57 |
option specifies that the output should be in run-length compressed
|
| 58 |
ASCII format.
|
| 59 |
The file size will be one half to one tenth as large as the
|
| 60 |
hexstring equivalent and can be sent over any network or by e-mail.
|
| 61 |
The only disadvantage is that it will actually take longer to print
|
| 62 |
on some printers, since the "readhexstring" procedure is generally
|
| 63 |
faster than a custom replacement.
|
| 64 |
.PP
|
| 65 |
The
|
| 66 |
.I \-n
|
| 67 |
option specifies the number of copies to print of this image.
|
| 68 |
It is often preferable to use this option instead of the
|
| 69 |
multiple copy option of the print spooler program,
|
| 70 |
since the latter often results in duplication of the input
|
| 71 |
file with a large associated cost.
|
| 72 |
.PP
|
| 73 |
The
|
| 74 |
.I \-e
|
| 75 |
option specifies an exposure compensation in f-stops (powers of two).
|
| 76 |
Only integer stops are allowed, for efficiency.
|
| 77 |
The
|
| 78 |
.I \-g
|
| 79 |
option specifies a power law for the printer
|
| 80 |
transfer function.
|
| 81 |
The default gamma setting for greyscale printers is 1.0 (linear),
|
| 82 |
and the default gamma for color printers is 1.8 (commonly used in prepress).
|
| 83 |
If your output seems to have too much contrast relative to its screen
|
| 84 |
equivalent, print out the file "ray/lib/lib/gamma.hdr" to your printer
|
| 85 |
without any gamma correction and using the
|
| 86 |
.I \-d
|
| 87 |
option to set the dots-per-inch (see below).
|
| 88 |
The best match between the small lines and the grey patch next to it indicate
|
| 89 |
the approximate gamma of your printer, which you should use with the
|
| 90 |
.I \-g
|
| 91 |
option for best contrast reproduction in subsequent conversions.
|
| 92 |
.PP
|
| 93 |
The standard print area assumes 8.5 by 11 inch (U.S. letter)
|
| 94 |
paper, with 0.5 inch margins on all sides.
|
| 95 |
The image will be rotated 90 degrees
|
| 96 |
if it fits better that way in the available print area, and
|
| 97 |
it will always be centered on the page.
|
| 98 |
The
|
| 99 |
.I \-p
|
| 100 |
and
|
| 101 |
.I \-m
|
| 102 |
options to control the paper size and margins, respectively.
|
| 103 |
The argument to the
|
| 104 |
.I \-p
|
| 105 |
option is the common name for a given paper size, or WWxHH, where
|
| 106 |
WW is the width (in inches) and HH is the height.
|
| 107 |
If millimeters or centimeters are the preferred measurement unit,
|
| 108 |
the 'x' may be replaced by 'm' or 'c', respectively.
|
| 109 |
The WW and HH values are decimal quantities, of course.
|
| 110 |
The current paper identifiers understood by the program may be discovered
|
| 111 |
by giving a 0 argument to the
|
| 112 |
.I \-p
|
| 113 |
option.
|
| 114 |
They are currently:
|
| 115 |
.PP
|
| 116 |
.nf
|
| 117 |
_Name________Width_Height_(inches)
|
| 118 |
envelope 4.12 9.50
|
| 119 |
executive 7.25 10.50
|
| 120 |
letter 8.50 11.00
|
| 121 |
lettersmall 7.68 10.16
|
| 122 |
legal 8.50 14.00
|
| 123 |
monarch 3.87 7.50
|
| 124 |
statement 5.50 8.50
|
| 125 |
tabloid 11.00 17.00
|
| 126 |
A3 11.69 16.54
|
| 127 |
A4 8.27 11.69
|
| 128 |
A4small 7.47 10.85
|
| 129 |
A5 6.00 8.27
|
| 130 |
A6 4.13 6.00
|
| 131 |
B4 10.12 14.33
|
| 132 |
B5 7.17 10.12
|
| 133 |
C5 6.38 9.01
|
| 134 |
C6 4.49 6.38
|
| 135 |
DL 4.33 8.66
|
| 136 |
hagaki 3.94 5.83
|
| 137 |
.fi
|
| 138 |
.PP
|
| 139 |
The paper size name may be abbreviated with three or more letters, and
|
| 140 |
character case is ignored.
|
| 141 |
The argument to the
|
| 142 |
.I \-m
|
| 143 |
option is the margin width, which is 0.5 inches by default.
|
| 144 |
A millimeter or centimeter quantity may be given instead of inches
|
| 145 |
by immediately following the value with a 'm' or 'c' character, respectively.
|
| 146 |
(Leave no space between the quantity and its unit letter.)\0
|
| 147 |
If you wish to specify the horizontal and vertical margins separately,
|
| 148 |
use the
|
| 149 |
.I \-mh
|
| 150 |
and
|
| 151 |
.I \-mv
|
| 152 |
options, instead.
|
| 153 |
.PP
|
| 154 |
The
|
| 155 |
.I \-d
|
| 156 |
option may be used to explicitly set the print density (in dots per inch).
|
| 157 |
If the input picture is lower resolution than the printer and has square
|
| 158 |
pixels, then
|
| 159 |
.I ra_ps
|
| 160 |
will adjust the image size so that pixels map to dot regions exactly.
|
| 161 |
This may improve the appearance of fine detail, and may speed up the
|
| 162 |
printing process as well, at the expense of a slightly smaller image area.
|
| 163 |
If you wish to maximize print area and the input image contains no fine
|
| 164 |
detail, then do not specify this option.
|
| 165 |
.PP
|
| 166 |
The output from
|
| 167 |
.I ra_ps
|
| 168 |
is designed to be compatible with the Encapsulated PostScript standard,
|
| 169 |
which means that the resulting file may be incorporated into
|
| 170 |
documents by page layout programs that can read in EPS files.
|
| 171 |
Unfortunately, there is currently no option for generating a preview
|
| 172 |
bitmap, so the image will show up on the screen as a rectangular area only.
|
| 173 |
To control the EPS image size directly, use the
|
| 174 |
.I \-p
|
| 175 |
option as explained above with the WWxHH specification, and set
|
| 176 |
.I "\-m 0"
|
| 177 |
to turn off the margins.
|
| 178 |
.SH AUTHOR
|
| 179 |
Greg Ward
|
| 180 |
.SH "SEE ALSO"
|
| 181 |
pfilt(1), ra_bmp(1), ra_bn(1), ra_pr(1), ra_pr24(1), ra_t8(1), ra_t16(1),
|
| 182 |
ra_ppm(1), ra_tiff(1), ximage(1)
|
