--- ray/doc/man/man1/pcomb.1	2006/09/08 21:38:25	1.7
+++ ray/doc/man/man1/pcomb.1	2023/12/06 01:27:00	1.13
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: pcomb.1,v 1.7 2006/09/08 21:38:25 greg Exp $"
+.\" RCSid "$Id: pcomb.1,v 1.13 2023/12/06 01:27:00 greg Exp $"
 .TH PCOMB 1 8/31/96 RADIANCE
 .SH NAME
 pcomb - combine RADIANCE pictures
@@ -42,6 +42,10 @@ but an arbitrary mapping can be assigned with the
 and
 .I \-f
 options.
+(The variable and function definitions in each
+.I \-f source
+file are read and compiled from the RADIANCE library
+where it is found.)\0
 Negative coefficients and functions are allowed, and
 .I pcomb
 will produce color values of zero where they would be negative.
@@ -115,6 +119,9 @@ give the exposure values for picture
 and
 .I pa(n)
 gives the corresponding pixel aspect ratio.
+Exposure values will be set to 1.0 for inputs with the
+.I \-o
+option set.
 Finally, for pictures with stored view parameters,
 the functions
 .I "Ox(n), Oy(n)"
@@ -140,6 +147,8 @@ If the current pixel is outside the view region,
 will return a negative value, and
 .I S(n)
 will return zero.
+The first input picture with a view is assumed to correspond to the
+view of the output picture, which is written into the header.
 .PP
 The
 .I \-h
@@ -198,24 +207,26 @@ by preceeding it with an exclamation point ('!').
 .SH EXAMPLES
 To produce a picture showing the difference between pic1 and pic2:
 .IP "" .2i
-pcomb -e 'ro=ri(1)-ri(2);go=gi(1)-gi(2);bo=bi(1)-bi(2)' pic1 pic2 > diff
+pcomb \-e 'ro=ri(1)\-ri(2);go=gi(1)\-gi(2);bo=bi(1)\-bi(2)' pic1 pic2 > diff
 .PP
 Or, more efficiently:
 .IP "" .2i
-pcomb pic1 -s -1 pic2 > diff
+pcomb pic1 \-s \-1 pic2 > diff
 .PP
 To precompute the gamma correction for a picture:
 .IP "" .2i
-pcomb -e 'ro=ri(1)^.4;go=gi(1)^.4;bo=bi(1)^.4' pic > pic.gam
+pcomb \-e 'ro=ri(1)^.4;go=gi(1)^.4;bo=bi(1)^.4' inp.hdr > gam.hdr
 .PP
 To perform some special filtering:
 .IP "" .2i
-pcomb -f myfilt.cal -x xmax/2 -y ymax/2 input.pic > filtered.pic
+pcomb \-f myfilt.cal \-x xmax/2 \-y ymax/2 input.hdr > filtered.hdr
 .PP
 To make a picture of a dot:
 .IP "" .2i
-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
+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
+.SH ENVIRONMENT
+RAYPATH		the directories to check for auxiliary files.
 .SH AUTHOR
 Greg Ward
 .SH "SEE ALSO"
-getinfo(1), icalc(1), pcompos(1), pfilt(1), rpict(1)
+getinfo(1), icalc(1), pcompos(1), pfilt(1), rmtxcomb(1), rmtxop(1), rpict(1)