1 |
.\" RCSid "$Id: ra_ps.1,v 1.2 2003/12/09 15:59:06 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.pic" 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) |