--- ray/doc/man/man1/ranimove.1	2003/03/12 17:26:58	1.2
+++ ray/doc/man/man1/ranimove.1	2012/10/05 00:59:38	1.9
@@ -1,4 +1,4 @@
-.\" RCSid "$Id"
+.\" RCSid "$Id: ranimove.1,v 1.9 2012/10/05 00:59:38 greg Exp $"
 .TH RANIMOVE 1 1/30/03 RADIANCE
 .SH NAME
 ranimove - render a RADIANCE animation with motion
@@ -192,8 +192,8 @@ The first is the name of a parent move object, or "voi
 If given, the object's transformation will be prepended to that
 of its parent.
 The second argument is the name of this object, which will be used
-to name surfaces it contains, and as a modifier for any child objects
-that reference it.
+to name surfaces it contains, and as a parent identifier for any child
+objects that reference it.
 The third argument is the transformation string or file for this object.
 If this argument is enclosed in quotes and begins with a hyphen
 ('-'), then it will be interpreted as a
@@ -215,17 +215,17 @@ appended to the command, and its output will be passed
 the input of
 .I xform
 for each frame.
-An optinal fifth argument
+An optional fifth argument
 specifies the rendering priority for this object.
-Values greater than 1 will result in preferential rendering of
+Values greater than 1.0 will result in preferential rendering of
 this object over other portions of the image when it appears in a frame.
-Values less than 1 will cause the rendering to neglect this object in
+Values less than 1.0 will cause the rendering to neglect this object in
 favor of other parts of the image.
 A value of 3.0 can be interpreted as saying the viewer is three times more
 likely to look at this object than the background.
 A file may be given rather than a floating point value, and this file must
-contain one floating point number per line, corresponding to frames in the
-animation.
+contain one floating point number per line, corresponding to priorities
+for frames in the animation.
 .TP
 .BR VIEWFILE
 This variable names a file from which
@@ -253,7 +253,7 @@ how to adjust the exposure for each frame.
 As in
 .I pfilt,
 the exposure setting may be given either as a multiplier or as a
-number of f-stop adjustments (eg. +2 or -1.5).
+number of f\-stop adjustments (eg. +2 or \-1.5).
 Alternatively, a file name may be given, which
 .I ranimate
 will interpret as having one exposure value per line per frame,
@@ -269,7 +269,7 @@ The base output file name for the final frames.
 This string should contain a
 .I printf(3)
 style integer field to distinguish one frame number from another.
-The final frames will use this name with a ".pic" suffix.
+The final frames will use this name with a ".hdr" suffix.
 The default value is "frame%03d".
 .TP
 .BR MBLUR
@@ -277,8 +277,17 @@ This variable specifies the fraction of a frame time t
 is simulated as being open for motion blur.
 Motion blur is computed by
 .I ranimove
-using image-based rendering methods, and will not be exact.
-The default value is 0, meaning no motion blurring.
+using image-based rendering methods in a rather crude fashion.
+A much better result is achieved by setting
+.I MBLUR=0
+and using the
+.I pmblur2(1)
+command as a post-process, assigning the
+.I ZNAME
+and
+.I MNAME
+variables described below.
+The default motion blur is 0.
 .TP
 .BR RATE
 This variable specifies the animation frame rate, in frames per second.
@@ -328,6 +337,36 @@ manual page for a list of valid options.
 (The
 .I \-f
 option is specified by default.)\0
+.TP
+.BR ZNAME
+The base file name for the depth buffer output frames.
+This string should contain a
+.I printf(3)
+style integer field to distinguish one frame number from another.
+The final frames will use this name with a ".zbf" suffix.
+This is needed by the
+.I pmblur2
+command to compute a better motion blur.
+There is no default setting for this variable.
+.TP
+.BR MNAME
+The base file name for the motion vector output frames.
+This string should contain a
+.I printf(3)
+style integer field to distinguish one frame number from another.
+The final frames will use this name with a ".mvo" suffix.
+This file is used together with the image and depth buffer by
+.I pmblur2
+to compute a better motion blur.
+In this case, the
+.I MBLUR
+variable should be unset or zero.
+The file will contain 3 16-bit unsigned values per pixel.
+The first two are the x and y offsets to each pixel in the previous frame,
+with an offset of 32768 being no movement.
+The third value is 0 if the previous frame's pixel was on a
+different object, and 32768 if it was on the same object.
+There is no default setting for this variable.
 .SH EXAMPLES
 A minimal input file for
 .I ranimove
@@ -351,7 +390,7 @@ If we only want to see what default values
 would use without actually executing anything, we can invoke it
 thus:
 .IP "" .2i
-ranimove -n 0 -e sample.rnm
+ranimove \-n 0 \-e sample.rnm
 .PP
 This will print the variables we have given as well as default
 values
@@ -383,4 +422,5 @@ Note the use of abbreviation for variable names.
 .SH AUTHOR
 Greg Ward
 .SH "SEE ALSO"
-oconv(1), pfilt(1), pinterp(1), rad(1), ranimate(1), rpict(1), xform(1)
+fieldcomb(1), oconv(1), pfilt(1), pinterp(1), pmblur2(1), pvalue(1), rad(1),
+ran2tiff(1), ranimate(1), rpict(1), xform(1)