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 (21 years, 7 months 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
#	User	Rev	Content
1	greg	1.3	.\" RCSid "$Id: ra_ps.1,v 1.2 2003/12/09 15:59:06 greg Exp $"
2	greg	1.1	.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	greg	1.3	pfilt(1), ra_bmp(1), ra_bn(1), ra_pr(1), ra_pr24(1), ra_t8(1), ra_t16(1),
182	greg	1.1	ra_ppm(1), ra_tiff(1), ximage(1)