ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/pextrem.1
Revision: 1.4
Committed: Fri Sep 20 17:39:12 2024 UTC (7 months, 3 weeks ago) by greg
Branch: MAIN
CVS Tags: HEAD
Changes since 1.3: +7 -4 lines
Log Message:
feat(pextrem): Added handling of hyperspectral pictures

File Contents

# User Rev Content
1 greg 1.4 .\" RCSid "$Id: pextrem.1,v 1.3 2022/02/04 20:11:48 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 greg 1.4 .SH NOTES
37 greg 1.1 The luminance value is used for comparison of pixels, although in
38     certain anomolous cases (ie. highly saturated colors) it is possible that
39     .I pextrem
40     will not pick the absolute minimum or maximum luminance value.
41     This is because a fast integer-space comparison is used.
42     A more reliable floating-point comparison would be slower by
43     an order of magnitude.
44 greg 1.4 .PP
45     Hyperspectral pictures report min/max values as RGB colors for
46     output consistency.
47     .SH AUTHOR
48     Greg Ward
49 greg 1.1 .SH "SEE ALSO"
50     falsecolor(1), getinfo(1), pcomb(1), pcompos(1), pextrem(1), pfilt(1),
51     pflip(1), protate(1), psign(1), rpict(1), ximage(1)