man/man1/ra_ps.1

.\" RCSid "$Id: ra_ps.1,v 1.2 2003/12/09 15:59:06 greg Exp $"
.TH RA_PS 1 8/28/98 RADIANCE
.SH NAME
ra_ps - convert RADIANCE picture to a PostScript file
.SH SYNOPSIS
.B ra_ps
[
.B \-b|c
][
.B \-A|B|C
][
.B "\-n ncopies"
][
.B "\-e +/-stops"
][
.B "\-g gamma"
][
.B "\-p paper"
][
.B "\-m[h|v] margin"
][
.B "\-d dpi"
]
[
.B input
[
.B output
]
]
.SH DESCRIPTION
.I Ra_ps
translates a RADIANCE picture to a color or greyscale
Adobe PostScript file for printing on
a laser printer or importing to a page layout program.
The
.I \-b
option tells
.I ra_ps
to produce greyscale output.
(The default is color, which may be specified explicitly with the
.I \-c
option.)\0
.PP
The
.I \-A
option specifies that the output should be in uncompressed ASCII
hexstring format (the default).
The
.I \-B
option specifies that the output should be in uncompressed binary
string format.
The file size will be roughly half that of the ASCII equivalent,
but some printers and especially some printer connections do not
support binary transfer, so this option should be used with caution.
The
.I \-C
option specifies that the output should be in run-length compressed
ASCII format.
The file size will be one half to one tenth as large as the
hexstring equivalent and can be sent over any network or by e-mail.
The only disadvantage is that it will actually take longer to print
on some printers, since the "readhexstring" procedure is generally
faster than a custom replacement.
.PP
The
.I \-n
option specifies the number of copies to print of this image.
It is often preferable to use this option instead of the
multiple copy option of the print spooler program,
since the latter often results in duplication of the input
file with a large associated cost.
.PP
The
.I \-e
option specifies an exposure compensation in f-stops (powers of two).
Only integer stops are allowed, for efficiency.
The
.I \-g
option specifies a power law for the printer
transfer function.
The default gamma setting for greyscale printers is 1.0 (linear),
and the default gamma for color printers is 1.8 (commonly used in prepress).
If your output seems to have too much contrast relative to its screen
equivalent, print out the file "ray/lib/lib/gamma.pic" to your printer 
without any gamma correction and using the
.I \-d
option to set the dots-per-inch (see below).
The best match between the small lines and the grey patch next to it indicate
the approximate gamma of your printer, which you should use with the
.I \-g
option for best contrast reproduction in subsequent conversions.
.PP
The standard print area assumes 8.5 by 11 inch (U.S. letter)
paper, with 0.5 inch margins on all sides.
The image will be rotated 90 degrees
if it fits better that way in the available print area, and
it will always be centered on the page.
The
.I \-p
and
.I \-m
options to control the paper size and margins, respectively.
The argument to the
.I \-p
option is the common name for a given paper size, or WWxHH, where
WW is the width (in inches) and HH is the height.
If millimeters or centimeters are the preferred measurement unit,
the 'x' may be replaced by 'm' or 'c', respectively.
The WW and HH values are decimal quantities, of course.
The current paper identifiers understood by the program may be discovered
by giving a 0 argument to the
.I \-p
option.
They are currently:
.PP
.nf
_Name________Width_Height_(inches)
envelope      4.12   9.50
executive     7.25  10.50
letter        8.50  11.00
lettersmall   7.68  10.16
legal         8.50  14.00
monarch       3.87   7.50
statement     5.50   8.50
tabloid      11.00  17.00
A3           11.69  16.54
A4            8.27  11.69
A4small       7.47  10.85
A5            6.00   8.27
A6            4.13   6.00
B4           10.12  14.33
B5            7.17  10.12
C5            6.38   9.01
C6            4.49   6.38
DL            4.33   8.66
hagaki        3.94   5.83
.fi
.PP
The paper size name may be abbreviated with three or more letters, and
character case is ignored.
The argument to the
.I \-m
option is the margin width, which is 0.5 inches by default.
A millimeter or centimeter quantity may be given instead of inches
by immediately following the value with a 'm' or 'c' character, respectively.
(Leave no space between the quantity and its unit letter.)\0
If you wish to specify the horizontal and vertical margins separately,
use the
.I \-mh
and
.I \-mv
options, instead.
.PP
The
.I \-d
option may be used to explicitly set the print density (in dots per inch).
If the input picture is lower resolution than the printer and has square
pixels, then
.I ra_ps
will adjust the image size so that pixels map to dot regions exactly.
This may improve the appearance of fine detail, and may speed up the
printing process as well, at the expense of a slightly smaller image area.
If you wish to maximize print area and the input image contains no fine
detail, then do not specify this option.
.PP
The output from
.I ra_ps
is designed to be compatible with the Encapsulated PostScript standard,
which means that the resulting file may be incorporated into
documents by page layout programs that can read in EPS files.
Unfortunately, there is currently no option for generating a preview
bitmap, so the image will show up on the screen as a rectangular area only.
To control the EPS image size directly, use the
.I \-p
option as explained above with the WWxHH specification, and set
.I "\-m 0"
to turn off the margins.
.SH AUTHOR
Greg Ward
.SH "SEE ALSO"
pfilt(1), ra_bmp(1), ra_bn(1), ra_pr(1), ra_pr24(1), ra_t8(1), ra_t16(1),
ra_ppm(1), ra_tiff(1), ximage(1)
Revision:	1.3
Committed:	Fri Mar 26 22:58:20 2004 UTC (20 years, 1 month ago) by greg
Branch:	MAIN
CVS Tags:	rad3R7P2, rad3R7P1, rad3R6, rad3R6P1, rad3R8, rad3R9
Changes since 1.2:	+2 -2 lines
Log Message:	Added support to ra_bmp for 16-bit images and RLE, plus created man page
#	Content
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)