ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/pextrem.1
Revision: 1.3
Committed: Fri Feb 4 20:11:48 2022 UTC (3 years, 3 months ago) by greg
Branch: MAIN
CVS Tags: rad5R4
Changes since 1.2: +6 -2 lines
Log Message:
feat(pvalue,pextrem): Added -O option to report watts/sr/meter^2 always

File Contents

# User Rev Content
1 greg 1.3 .\" RCSid "$Id: pextrem.1,v 1.2 2003/12/09 15:59:06 greg Exp $"
2 greg 1.1 .TH PEXTREM 1 11/15/93 RADIANCE
3     .SH NAME
4     pextrem - find minimum and maximum values in RADIANCE picture
5     .SH SYNOPSIS
6     .B pextrem
7     [
8 greg 1.3 .B "-o | -O"
9 greg 1.1 ]
10     [
11     picture
12     ]
13     .SH DESCRIPTION
14     .I Pextrem
15     locates the minimum and maximum values for the input
16     .I picture,
17     and prints their pixel locations and color values.
18     The first line printed contains the x and y pixel location
19     (x measured from the left margin, y measured from the bottom),
20     followed by the red, green and blue values.
21     The second line printed contains the same information for the
22     maximum value.
23     .PP
24     The
25     .I \-o
26     option prints the original (radiance) values, undoing any exposure
27     or color correction done on the picture.
28 greg 1.3 If the input is XYZE, then the second channel is in candelas/meter^2,
29     unless
30     .I \-O
31     is specified, when watts/sr/meter^2 are always reported.
32 greg 1.1 .PP
33     If no input
34     .I picture
35     is given, the standard input is read.
36     .SH AUTHOR
37     Greg Ward
38     .SH BUGS
39     The luminance value is used for comparison of pixels, although in
40     certain anomolous cases (ie. highly saturated colors) it is possible that
41     .I pextrem
42     will not pick the absolute minimum or maximum luminance value.
43     This is because a fast integer-space comparison is used.
44     A more reliable floating-point comparison would be slower by
45     an order of magnitude.
46     .SH "SEE ALSO"
47     falsecolor(1), getinfo(1), pcomb(1), pcompos(1), pextrem(1), pfilt(1),
48     pflip(1), protate(1), psign(1), rpict(1), ximage(1)