--- ray/doc/man/man1/vwrays.1 2011/08/20 20:57:51 1.8 +++ ray/doc/man/man1/vwrays.1 2021/12/04 16:29:29 1.12 @@ -1,10 +1,10 @@ -.\" RCSid "$Id: vwrays.1,v 1.8 2011/08/20 20:57:51 greg Exp $" +.\" RCSid "$Id: vwrays.1,v 1.12 2021/12/04 16:29:29 greg Exp $" .TH VWRAYS 1 1/15/99 RADIANCE .SH NAME vwrays - compute rays for a given picture or view .SH SYNOPSIS .B vwrays -.B "[ -i -u -f{a|f|d} | -d ]" +.B "[ -i -u -f{a|f|d} -c rept | -d ]" { .B "view opts .." | @@ -37,6 +37,20 @@ Using raw float or double records for example can redu requirements of transferring and interpreting information in .I rtrace. .PP +The +.I \-c +option repeats each pixel the given number of times (default is 1). +This is most useful when sending rays to +.I rcontrib(1) +with the same +.I \-c +setting, providing a much faster way to average pixels over image sets. +The +.I \-pj +and/or +.I \-pd +options should be used to jitter sample postions in most cases. +.PP View options may be any combination of standard view parameters described in the .I rpict(1) @@ -58,7 +72,10 @@ aspect ratio, unless this ratio is set to zero. The .I \-pj option may be used to jitter samples. -The default value of 0 turns off ray jittering. +The +.I \-pd +option specifies a world-diameter aperture for depth-of-field jittering. +The default value of 0 for both options turns off all ray jittering. .PP If the .I \-d @@ -132,4 +149,4 @@ can reproduce any pixel ordering (i.e., any image orie a rendered picture, it will only produce standard scanline-ordered rays when given a set of view parameters. .SH "SEE ALSO" -rcalc(1), rpict(1), rtcontrib(1), rtrace(1) +rcalc(1), rcode_depth(1), rcontrib(1), rpict(1), rtpict(1), rtrace(1)