| 1 |
< |
.\" RCSid "$Id" |
| 1 |
> |
.\" RCSid "$Id$" |
| 2 |
|
.TH PCOMB 1 8/31/96 RADIANCE |
| 3 |
|
.SH NAME |
| 4 |
|
pcomb - combine RADIANCE pictures |
| 5 |
|
.SH SYNOPSIS |
| 6 |
|
.B pcomb |
| 7 |
|
[ |
| 8 |
+ |
.B -h |
| 9 |
+ |
][ |
| 10 |
|
.B -w |
| 11 |
|
][ |
| 12 |
|
.B "\-x xres" |
| 42 |
|
and |
| 43 |
|
.I \-f |
| 44 |
|
options. |
| 45 |
+ |
The variable and function definitions in each |
| 46 |
+ |
.I \-f source |
| 47 |
+ |
file are read and compiled from the RADIANCE library where it is found. |
| 48 |
|
Negative coefficients and functions are allowed, and |
| 49 |
|
.I pcomb |
| 50 |
|
will produce color values of zero where they would be negative. |
| 73 |
|
would return the red component of the pixel from picture 3 |
| 74 |
|
that is left 2 and up 1 from the current position. |
| 75 |
|
Although x offsets may be as large as width of the picture, |
| 76 |
< |
y offsets are limited to a small window (+/- 8 pixels) due to efficiency |
| 76 |
> |
y offsets are limited to a small window (+/- 32 pixels) due to efficiency |
| 77 |
|
considerations. |
| 78 |
|
However, it is not usually necessary to worry about this problem -- |
| 79 |
|
if the requested offset is not available, the next best pixel is |
| 90 |
|
gives the number of input files present, |
| 91 |
|
and |
| 92 |
|
.I WE |
| 93 |
< |
gives the white efficacy (lumens/brightness) for pixel values. |
| 93 |
> |
gives the white efficacy (lumens/brightness) for pixel values, |
| 94 |
> |
which may be used with the |
| 95 |
> |
.I \-o |
| 96 |
> |
option or the le(n) values to convert to absolute |
| 97 |
> |
photometric units (see below). |
| 98 |
|
The variables |
| 99 |
|
.I x |
| 100 |
|
and |
| 118 |
|
and |
| 119 |
|
.I pa(n) |
| 120 |
|
gives the corresponding pixel aspect ratio. |
| 121 |
+ |
Exposure values will be set to 1.0 for inputs with the |
| 122 |
+ |
.I \-o |
| 123 |
+ |
option set. |
| 124 |
|
Finally, for pictures with stored view parameters, |
| 125 |
|
the functions |
| 126 |
|
.I "Ox(n), Oy(n)" |
| 146 |
|
will return a negative value, and |
| 147 |
|
.I S(n) |
| 148 |
|
will return zero. |
| 149 |
+ |
The first input picture with a view is assumed to correspond to the |
| 150 |
+ |
view of the output picture, which is written into the header. |
| 151 |
|
.PP |
| 152 |
|
The |
| 153 |
+ |
.I \-h |
| 154 |
+ |
option may be used to reduce the information header size, which |
| 155 |
+ |
can grow disproportionately after multiple runs of |
| 156 |
+ |
.I pcomb |
| 157 |
+ |
and/or |
| 158 |
+ |
.I pcompos(1). |
| 159 |
+ |
The |
| 160 |
|
.I \-w |
| 161 |
|
option can be used to suppress warning messages about invalid |
| 162 |
|
calculations. |
| 206 |
|
.SH EXAMPLES |
| 207 |
|
To produce a picture showing the difference between pic1 and pic2: |
| 208 |
|
.IP "" .2i |
| 209 |
< |
pcomb -e 'ro=ri(1)-ri(2);go=gi(1)-gi(2);bo=bi(1)-bi(2)' pic1 pic2 > diff |
| 209 |
> |
pcomb \-e 'ro=ri(1)\-ri(2);go=gi(1)\-gi(2);bo=bi(1)\-bi(2)' pic1 pic2 > diff |
| 210 |
|
.PP |
| 211 |
|
Or, more efficiently: |
| 212 |
|
.IP "" .2i |
| 213 |
< |
pcomb pic1 -s -1 pic2 > diff |
| 213 |
> |
pcomb pic1 \-s \-1 pic2 > diff |
| 214 |
|
.PP |
| 215 |
|
To precompute the gamma correction for a picture: |
| 216 |
|
.IP "" .2i |
| 217 |
< |
pcomb -e 'ro=ri(1)^.4;go=gi(1)^.4;bo=bi(1)^.4' pic > pic.gam |
| 217 |
> |
pcomb \-e 'ro=ri(1)^.4;go=gi(1)^.4;bo=bi(1)^.4' inp.hdr > gam.hdr |
| 218 |
|
.PP |
| 219 |
|
To perform some special filtering: |
| 220 |
|
.IP "" .2i |
| 221 |
< |
pcomb -f myfilt.cal -x xmax/2 -y ymax/2 input.pic > filtered.pic |
| 221 |
> |
pcomb \-f myfilt.cal \-x xmax/2 \-y ymax/2 input.hdr > filtered.hdr |
| 222 |
|
.PP |
| 223 |
|
To make a picture of a dot: |
| 224 |
|
.IP "" .2i |
| 225 |
< |
pcomb -x 100 -y 100 -e 'ro=b;go=b;bo=b;b=if((x-50)^2+(y-50)^2-25^2,0,1)' > dot |
| 225 |
> |
pcomb \-x 100 \-y 100 \-e 'ro=b;go=b;bo=b;b=if((x-50)^2+(y-50)^2\-25^2,0,1)' > dot |
| 226 |
> |
.SH ENVIRONMENT |
| 227 |
> |
RAYPATH the directories to check for auxiliary files. |
| 228 |
|
.SH AUTHOR |
| 229 |
|
Greg Ward |
| 230 |
|
.SH "SEE ALSO" |
| 231 |
< |
calc(1), getinfo(1), pcompos(1), pfilt(1), rpict(1) |
| 231 |
> |
getinfo(1), icalc(1), pcompos(1), pfilt(1), rpict(1) |
