ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/Development/ray/doc/man/man1/pcomb.1
(Generate patch)

Comparing ray/doc/man/man1/pcomb.1 (file contents):
Revision 1.14 by greg, Wed Dec 6 17:56:57 2023 UTC vs.
Revision 1.15 by greg, Sat Dec 9 23:46:50 2023 UTC

# Line 1 | Line 1
1   .\" RCSid "$Id$"
2   .TH PCOMB 1 8/31/96 RADIANCE
3   .SH NAME
4 < pcomb - combine RADIANCE pictures
4 > pcomb - combine RADIANCE pictures and/or float matrices
5   .SH SYNOPSIS
6   .B pcomb
7   [
# Line 9 | Line 9 | pcomb - combine RADIANCE pictures
9   ][
10   .B -w
11   ][
12 + .B -ff
13 + ][
14   .B "\-x xres"
15   ][
16   .B "\-y yres"
# Line 29 | Line 31 | pcomb - combine RADIANCE pictures
31   ]
32   .SH DESCRIPTION
33   .I Pcomb
34 < combines equal-sized RADIANCE pictures and sends the result to the
35 < standard output.
34 > combines equal-sized RADIANCE pictures or raw float matrices
35 > and sends the result to the standard output.
36   By default, the result is just a linear combination of
37 < the input pictures multiplied by
37 > the input pixels multiplied by
38   .I \-s
39   and
40   .I \-c
# Line 49 | Line 51 | file are read and compiled from the RADIANCE library
51   where it is found.)\0
52   Negative coefficients and functions are allowed, and
53   .I pcomb
54 < will produce color values of zero where they would be negative.
54 > will produce color values of zero where they would be negative
55 > unless the
56 > .I \-ff
57 > option is used to specify floating-point matrix output.
58   .PP
59   The variables
60   .I ro,
# Line 65 | Line 70 | The predefined functions
70   .I gi(n)
71   and
72   .I bi(n)
73 < give the red, green and blue input values for
74 < picture
73 > give the red, green and blue values for
74 > input
75   .I n.
76   To access a pixel that is nearby the current one, these functions
77   also accept optional x and y offsets.
78   For example,
79   .I ri(3,-2,1)
80 < would return the red component of the pixel from picture 3
80 > would return the red component of the pixel from input 3
81   that is left 2 and up 1 from the current position.
82 < Although x offsets may be as large as width of the picture,
82 > Although x offsets may be as large as width of the input,
83   y offsets are limited to a small window (+/- 32 pixels) due to efficiency
84   considerations.
85   However, it is not usually necessary to worry about this problem --
# Line 83 | Line 88 | returned instead.
88   .PP
89   For additional convenience, the function
90   .I li(n)
91 < is defined as the input brightness for picture
91 > is defined as the input brightness for input
92   .I n.
93   This function also accepts x and y offsets.
94   .PP
# Line 115 | Line 120 | The constant functions
120   .I "re(n), ge(n), be(n),"
121   and
122   .I le(n)
123 < give the exposure values for picture
123 > give the exposure values for input
124   .I n,
125   and
126   .I pa(n)
# Line 123 | Line 128 | gives the corresponding pixel aspect ratio.
128   Exposure values will be set to 1.0 for inputs with the
129   .I \-o
130   option set.
131 < Finally, for pictures with stored view parameters,
131 > Finally, for inputs with stored view parameters,
132   the functions
133   .I "Ox(n), Oy(n)"
134   and
135   .I Oz(n)
136   return the ray origin in world coordinates for the current pixel
137 < in picture
137 > in input
138   .I n,
139   and
140   .I "Dx(n), Dy(n)"
# Line 148 | Line 153 | If the current pixel is outside the view region,
153   will return a negative value, and
154   .I S(n)
155   will return zero.
156 < The first input picture with a view is assumed to correspond to the
157 < view of the output picture, which is written into the header.
156 > The first input input with a view is assumed to correspond to the
157 > view of the output, which is written into the header.
158   .PP
159   The
160   .I \-h
# Line 165 | Line 170 | calculations.
170   The
171   .I \-o
172   option indicates that original pixel values are to be used for the next
173 < picture, undoing any previous exposure changes or color correction.
173 > input, undoing any previous exposure changes or color correction.
174   .PP
175   The
176   .I \-x
# Line 197 | Line 202 | the definitions of
202   and
203   .I bo
204   will be used to compute each output pixel.
205 < This is useful for producing simple test pictures for various
205 > This is useful for producing simple test inputs for various
206   purposes.
207   (Theoretically, one could write a complete renderer using just the
208   functional language...)
209   .PP
210   The standard input can be specified with a hyphen ('-').
211 < A command that produces a RADIANCE picture can be given in place of a file
211 > A command that produces a RADIANCE picture or float matrix
212 > can be given in place of a file
213   by preceeding it with an exclamation point ('!').
214   .SH EXAMPLES
215   To produce a picture showing the difference between pic1 and pic2:

Diff Legend

– Removed lines
+ Added lines
< Changed lines (old)
> Changed lines (new)