man/man1/pvalue.1

.\" RCSid "$Id"
.TH PVALUE 1 1/15/99 RADIANCE
.SH NAME
pvalue - convert RADIANCE picture to/from alternate formats
.SH SYNOPSIS
.B pvalue
[
.B options
]
[
.B file
]
.br
.B "pvalue -r"
[
.B options
]
[
.B file1
[
.B "file2 file3"
]
]
.SH DESCRIPTION
.I Pvalue
converts the pixels of a RADIANCE picture to or from another format.
In the default mode, pixels are sent to the
standard output, one per line, in the following ascii format:

        xpos    ypos    red     green   blue

If no
.I file
is given, the standard input is read.
.PP
The reverse conversion option
.I (-r)
may be used with a single input file or when reading from the
standard input, but if the second form is used with three separate
input files, the three primaries are presumed to be separated in
these files.
.TP 10n
.BR \-u
Print only unique values in the output, skipping runs of equal pixels.
Specifying
.I \+u
turns this option off, which is the default.
.TP
.BR \-o
Print original values, before exposure compensation.
Specifying
.I \+o
uses final values, which is the default.
.TP
.BR \-h
Do not print header.
Specifying
.I \+h
causes the header to be printed, which is the default.
.TP
.BI \-H
Do not print the resolution string.
(See also the
.I \-r
option below.)
Specifying an input resolution for reverse conversion also turns
this option off.
Specifying
.I \+H
causes the resolution string to be printed, which is the default.
.TP
.BI \-s \ nbytes
Skip the specified number of bytes on the input header.
This option is useful for skipping unintelligible headers in
foreign file formats.
(Does not work when reading from standard input.)
.TP
.BI \-e \ exposure
Adjust the exposure by the amount specified.
If the exposure is being given as a conversion factor, use
.I \+e
instead, so an EXPOSURE line will not be recorded in the header
(if any).
.TP
.BI \-g \ gamma
Set gamma correction for conversion.
When converting from a RADIANCE picture to another format,
the inverse gamma is applied to correct for monitor response.
When converting to a RADIANCE picture
.I (\-r
option), the gamma is applied directly to recover the linear values.
By default,
.I gamma
is set to 1.0, meaning no gamma correction is performed.
.TP
.BR \-d
Data only,
do not print x and y pixel position.
.TP
.BR \-da
Same as
.I \-d.
.TP
.BR \-di
Print ascii integer values from 0 to 255+.
If
.I \+di
is given, the integer values will be preceded by
the x and y pixel locations.
.TP
.BR \-db
Output binary byte values from 0 to 255.
.TP
.BR \-dw
Output binary 16-bit words from 0 to 65535.
.TP
.BR \-dW
Output binary 16-bit words from 0 to 65535, byte-swapped.
.TP
.BR \-df
Output binary float values.
.TP
.BR \-dd
Output binary double values.
.TP
.BR \-R
Reverse ordering of colors so that the output is blue then green
then red.
The default ordering (specified with
.I \+R)
is red then green then blue.
.TP
.BR \-n
The RGB values are non-interleaved, meaning that all the red, green
and blue data are stored together in separate chunks.
Interleaving may be turned on with the
.I \+n
option, which is the default.
.TP
.BR \-b
Print brightness values rather than RGB.
Specifying
.I \+b
turns this option off, which is the default.
.TP
.BI \-p P
Put out only the primary
.I P,
where
.I P
is one of upper or lower case 'R', 'G' or 'B' for red, green or
blue, respectively.
This option may be used to separate the Radiance primaries into
three files with three separate runs of
.I pvalue,
or only one file when only one primary is needed.
Note that there is no space between this option and its argument.
.TP
.BR \-r
Perform reverse conversion.
Input is in the format given by the other options.
The x and y resolution must be specified on the command line, unless
the image file contains a Radiance resolution string at the
beginning (see 
.I \-H
option above and
.I \-y
option below).
Specifying
.I \+r
converts from a Radiance picture to other values, which is the
default.
.TP
.BI -y \ res
Set the output y resolution to
.I res.
If
.I \+y
is specified, then the scanlines are assumed to be in
increasing order (ie. bottom to top).
The default value for this option is 0, which means
that the picture size and scanline order must appear
as the first line after the header (if any) in the
input file.
Either an upper or lower case 'Y' may be used for this option.
Since Radiance files always contain such a line, 
this option has no effect for forward conversions.
.TP
.BI +x \ res
Set the output x resolution to
.I res.
If
.I \-x
is specified, then the scanlines are assumed to be in
decreasing order (ie. right to left).
The ordering of the
.I \-y
and
.I \+x
options determines whether the scanlines are sorted along
x or along y.
Most Radiance pictures are sorted top to bottom, then left
to right.
This corresponds to a specification of the form "-y yres +x xres".
Either an upper or lower case 'X' may be used for this option.
Like the
.I \-y
option,
.I \-x
options have no effect for forward conversions.
.SH EXAMPLE
To look at the original, unique pixels in picture:
.IP "" .2i
pvalue -o -u picture | more
.PP
To convert from a 512x400 8-bit greyscale image in bottom to top,
left to right scanline ordering:
.IP "" .2i
pvalue -r -db -b -h +y 400 +x 512 input.im > flipped.pic
.br
pflip -v flipped.pic > final.pic
.SH AUTHOR
Greg Ward
.SH BUGS
The
.I \-r
option does not work with the
.I \-u
option.
Also, input pixel locations are ignored during a reverse
conversion, so this information is not used in determining
the scanline ordering or picture size.
.SH "SEE ALSO"
getinfo(1), pcompos(1), pfilt(1), pflip(1),
protate(1), rpict(1), rtrace(1), rview(1)
Revision:	1.1
Committed:	Tue Mar 11 19:20:21 2003 UTC (22 years, 1 month ago) by greg
Branch:	MAIN
CVS Tags:	rad3R5
Log Message:	Added documentation to repository
#	User	Rev	Content
1	greg	1.1	.\" RCSid "$Id"
2			.TH PVALUE 1 1/15/99 RADIANCE
3			.SH NAME
4			pvalue - convert RADIANCE picture to/from alternate formats
5			.SH SYNOPSIS
6			.B pvalue
7			[
8			.B options
9			]
10			[
11			.B file
12			]
13			.br
14			.B "pvalue -r"
15			[
16			.B options
17			]
18			[
19			.B file1
20			[
21			.B "file2 file3"
22			]
23			]
24			.SH DESCRIPTION
25			.I Pvalue
26			converts the pixels of a RADIANCE picture to or from another format.
27			In the default mode, pixels are sent to the
28			standard output, one per line, in the following ascii format:
29
30			xpos ypos red green blue
31
32			If no
33			.I file
34			is given, the standard input is read.
35			.PP
36			The reverse conversion option
37			.I (-r)
38			may be used with a single input file or when reading from the
39			standard input, but if the second form is used with three separate
40			input files, the three primaries are presumed to be separated in
41			these files.
42			.TP 10n
43			.BR \-u
44			Print only unique values in the output, skipping runs of equal pixels.
45			Specifying
46			.I \+u
47			turns this option off, which is the default.
48			.TP
49			.BR \-o
50			Print original values, before exposure compensation.
51			Specifying
52			.I \+o
53			uses final values, which is the default.
54			.TP
55			.BR \-h
56			Do not print header.
57			Specifying
58			.I \+h
59			causes the header to be printed, which is the default.
60			.TP
61			.BI \-H
62			Do not print the resolution string.
63			(See also the
64			.I \-r
65			option below.)
66			Specifying an input resolution for reverse conversion also turns
67			this option off.
68			Specifying
69			.I \+H
70			causes the resolution string to be printed, which is the default.
71			.TP
72			.BI \-s \ nbytes
73			Skip the specified number of bytes on the input header.
74			This option is useful for skipping unintelligible headers in
75			foreign file formats.
76			(Does not work when reading from standard input.)
77			.TP
78			.BI \-e \ exposure
79			Adjust the exposure by the amount specified.
80			If the exposure is being given as a conversion factor, use
81			.I \+e
82			instead, so an EXPOSURE line will not be recorded in the header
83			(if any).
84			.TP
85			.BI \-g \ gamma
86			Set gamma correction for conversion.
87			When converting from a RADIANCE picture to another format,
88			the inverse gamma is applied to correct for monitor response.
89			When converting to a RADIANCE picture
90			.I (\-r
91			option), the gamma is applied directly to recover the linear values.
92			By default,
93			.I gamma
94			is set to 1.0, meaning no gamma correction is performed.
95			.TP
96			.BR \-d
97			Data only,
98			do not print x and y pixel position.
99			.TP
100			.BR \-da
101			Same as
102			.I \-d.
103			.TP
104			.BR \-di
105			Print ascii integer values from 0 to 255+.
106			If
107			.I \+di
108			is given, the integer values will be preceded by
109			the x and y pixel locations.
110			.TP
111			.BR \-db
112			Output binary byte values from 0 to 255.
113			.TP
114			.BR \-dw
115			Output binary 16-bit words from 0 to 65535.
116			.TP
117			.BR \-dW
118			Output binary 16-bit words from 0 to 65535, byte-swapped.
119			.TP
120			.BR \-df
121			Output binary float values.
122			.TP
123			.BR \-dd
124			Output binary double values.
125			.TP
126			.BR \-R
127			Reverse ordering of colors so that the output is blue then green
128			then red.
129			The default ordering (specified with
130			.I \+R)
131			is red then green then blue.
132			.TP
133			.BR \-n
134			The RGB values are non-interleaved, meaning that all the red, green
135			and blue data are stored together in separate chunks.
136			Interleaving may be turned on with the
137			.I \+n
138			option, which is the default.
139			.TP
140			.BR \-b
141			Print brightness values rather than RGB.
142			Specifying
143			.I \+b
144			turns this option off, which is the default.
145			.TP
146			.BI \-p P
147			Put out only the primary
148			.I P,
149			where
150			.I P
151			is one of upper or lower case 'R', 'G' or 'B' for red, green or
152			blue, respectively.
153			This option may be used to separate the Radiance primaries into
154			three files with three separate runs of
155			.I pvalue,
156			or only one file when only one primary is needed.
157			Note that there is no space between this option and its argument.
158			.TP
159			.BR \-r
160			Perform reverse conversion.
161			Input is in the format given by the other options.
162			The x and y resolution must be specified on the command line, unless
163			the image file contains a Radiance resolution string at the
164			beginning (see
165			.I \-H
166			option above and
167			.I \-y
168			option below).
169			Specifying
170			.I \+r
171			converts from a Radiance picture to other values, which is the
172			default.
173			.TP
174			.BI -y \ res
175			Set the output y resolution to
176			.I res.
177			If
178			.I \+y
179			is specified, then the scanlines are assumed to be in
180			increasing order (ie. bottom to top).
181			The default value for this option is 0, which means
182			that the picture size and scanline order must appear
183			as the first line after the header (if any) in the
184			input file.
185			Either an upper or lower case 'Y' may be used for this option.
186			Since Radiance files always contain such a line,
187			this option has no effect for forward conversions.
188			.TP
189			.BI +x \ res
190			Set the output x resolution to
191			.I res.
192			If
193			.I \-x
194			is specified, then the scanlines are assumed to be in
195			decreasing order (ie. right to left).
196			The ordering of the
197			.I \-y
198			and
199			.I \+x
200			options determines whether the scanlines are sorted along
201			x or along y.
202			Most Radiance pictures are sorted top to bottom, then left
203			to right.
204			This corresponds to a specification of the form "-y yres +x xres".
205			Either an upper or lower case 'X' may be used for this option.
206			Like the
207			.I \-y
208			option,
209			.I \-x
210			options have no effect for forward conversions.
211			.SH EXAMPLE
212			To look at the original, unique pixels in picture:
213			.IP "" .2i
214			pvalue -o -u picture \| more
215			.PP
216			To convert from a 512x400 8-bit greyscale image in bottom to top,
217			left to right scanline ordering:
218			.IP "" .2i
219			pvalue -r -db -b -h +y 400 +x 512 input.im > flipped.pic
220			.br
221			pflip -v flipped.pic > final.pic
222			.SH AUTHOR
223			Greg Ward
224			.SH BUGS
225			The
226			.I \-r
227			option does not work with the
228			.I \-u
229			option.
230			Also, input pixel locations are ignored during a reverse
231			conversion, so this information is not used in determining
232			the scanline ordering or picture size.
233			.SH "SEE ALSO"
234			getinfo(1), pcompos(1), pfilt(1), pflip(1),
235			protate(1), rpict(1), rtrace(1), rview(1)