--- ray/doc/man/man1/pcomb.1 2003/12/09 15:59:06 1.4 +++ ray/doc/man/man1/pcomb.1 2007/09/04 17:36:40 1.8 @@ -1,10 +1,12 @@ -.\" RCSid "$Id: pcomb.1,v 1.4 2003/12/09 15:59:06 greg Exp $" +.\" RCSid "$Id: pcomb.1,v 1.8 2007/09/04 17:36:40 greg Exp $" .TH PCOMB 1 8/31/96 RADIANCE .SH NAME pcomb - combine RADIANCE pictures .SH SYNOPSIS .B pcomb [ +.B -h +][ .B -w ][ .B "\-x xres" @@ -68,7 +70,7 @@ For example, would return the red component of the pixel from picture 3 that is left 2 and up 1 from the current position. Although x offsets may be as large as width of the picture, -y offsets are limited to a small window (+/- 8 pixels) due to efficiency +y offsets are limited to a small window (+/- 32 pixels) due to efficiency considerations. However, it is not usually necessary to worry about this problem -- if the requested offset is not available, the next best pixel is @@ -140,6 +142,13 @@ will return a negative value, and will return zero. .PP The +.I \-h +option may be used to reduce the information header size, which +can grow disproportionately after multiple runs of +.I pcomb +and/or +.I pcompos(1). +The .I \-w option can be used to suppress warning messages about invalid calculations. @@ -189,24 +198,24 @@ 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' pic > pic.gam .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.pic > filtered.pic .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 AUTHOR Greg Ward .SH "SEE ALSO" -calc(1), getinfo(1), pcompos(1), pfilt(1), rpict(1) +getinfo(1), icalc(1), pcompos(1), pfilt(1), rpict(1)