--- ray/doc/man/man1/vwrays.1	2003/03/11 19:20:21	1.1
+++ ray/doc/man/man1/vwrays.1	2007/09/04 17:36:41	1.5
@@ -1,4 +1,4 @@
-.\" RCSid "$Id"
+.\" RCSid "$Id: vwrays.1,v 1.5 2007/09/04 17:36:41 greg Exp $"
 .TH VWRAYS 1 1/15/99 RADIANCE
 .SH NAME
 vwrays - compute rays for a given picture or view
@@ -22,12 +22,12 @@ If a given pixel has no corresponding ray (because it 
 legal view boundaries), then six zero values are sent instead.
 .PP
 The
-.I -i
+.I \-i
 option may be used to specify desired pixel positions on the standard
 input rather than generating all the pixels for a given view.
 .PP
 The
-.I -f
+.I \-f
 option may be used to set the record format to something other than the
 default ASCII.
 Using raw float or double records for example can reduce the time
@@ -41,30 +41,34 @@ manual page, including input from a view file with the
 .I \-vf
 option.
 Additionally, the target X and Y dimensions may be specified with
-.I -x
+.I \-x
 and
-.I -y
+.I \-y
 options, and the pixel aspect ratio may be given with
-.I -p.
+.I \-pa.
 The default dimensions are 512x512, with a pixel aspect ratio of 1.0.
 Just as in
 .I rpict,
 the X or the Y dimension will be reduced if necessary
 to best match the specified pixel
 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.
 .PP
 If the
-.I -d
+.I \-d
 option is given, then
 .I vwrays
 just prints the computed image dimensions, which are based on the view
 aspect and the pixel aspect ratio just described.
 The
-.I -ld
+.I \-ld
 switch will also be printed, with
-.I -ld+
+.I \-ld+
 if the view file has an aft clipping plane, and
-.I -ld-
+.I \-ld-
 otherwise.
 This is useful for passing options to the
 .I rtrace
@@ -78,7 +82,7 @@ equal the maximum distance for each pixel, which will 
 correctly by
 .I rtrace
 with the
-.I -ld+
+.I \-ld+
 option.
 Note that this option should not be given unless there is an aft
 clipping plane, since the ray direction vectors will be normalized
@@ -105,15 +109,15 @@ vwrays scene_v2.pic scene_v2.zbf > scene_v2.pts
 .PP
 To determine what the dimensions of a given view would be:
 .IP "" .2i
-vwrays -d -vf myview.vf -x 2048 -y 2048
+vwrays \-d \-vf myview.vf \-x 2048 \-y 2048
 .PP
 To generate a RADIANCE picture using
 .I rtrace
 instead of
 .I rpict:
 .IP "" .2i
-vwrays -ff -vf view1.vf -x 1024 -y 1024 |
-rtrace `vwrays -d -vf view1.vf -x 1024 -y 1024` -ffc scene.oct > view1.pic
+vwrays \-ff \-vf view1.vf \-x 1024 \-y 1024 |
+rtrace `vwrays \-d \-vf view1.vf \-x 1024 \-y 1024` \-ffc scene.oct > view1.pic
 .SH AUTHOR
 Greg Ward Larson
 .SH ACKNOWLEDGMENT
@@ -125,4 +129,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), rtrace(1)
+rcalc(1), rpict(1), rtcontrib(1), rtrace(1)