--- ray/doc/man/man1/ranimate.1	2003/12/09 15:59:06	1.2
+++ ray/doc/man/man1/ranimate.1	2008/11/10 19:08:17	1.10
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: ranimate.1,v 1.2 2003/12/09 15:59:06 greg Exp $"
+.\" RCSid "$Id: ranimate.1,v 1.10 2008/11/10 19:08:17 greg Exp $"
 .TH RANIMATE 1 6/24/98 RADIANCE
 .SH NAME
 ranimate - compute a RADIANCE animation
@@ -157,7 +157,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,
@@ -180,7 +180,7 @@ options of rpict, along with appropriate suffixes,
 and thus 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 the assigned
 .I DIRECTORY
 followed by "/frame%03d".
@@ -271,6 +271,10 @@ before it is executed.
 Normally, the transfer command does something such as convert the
 frames to another format and/or copy them to tape or some other
 destination device before removing them.
+The
+.I fieldcomb(1)
+script may be used to conveniently combine fields into frames for
+field-based animations.
 If this variable is not given, the final frames are left where they
 are.
 (See
@@ -279,22 +283,22 @@ above.)\0
 .TP
 .BR RSH
 The command to use instead of
-.I rsh(1)
+.I ssh(1)
 to execute commands remotely on another machine.
 The arguments and behavior of this program must be identical to the UNIX
-.I rsh
+.I ssh
 command, except that the
 .I -l
 option will always be used to specify an alternate user name rather than the
 .I "user@host"
 convention.
-Th
+The
 .I -l
 option may or may not appear, but the
 .I -n
 option will always be used, and the expected starting directory will
 be that of the remote user, just as with
-.I rsh.
+.I ssh.
 .TP
 .BR NEXTANIM
 This variable specifies the next
@@ -352,14 +356,35 @@ If this number is less than 2, then bluring is perform
 only, resulting in greater noise than the combination of
 .I rpict
 and
-.I pinterp used otherwise.
+.I pinterp
+used otherwise.
 (The default value for number of samples is 5.)\0
-The
-.I pmblur(1)
-command is used to generate the given number of additional views for
+The default fraction is 0, meaning no motion blurring.
+This option does not currently work with the
+.I ANIMATE
+variable, since pinterp only works for static environments.
+.TP
+.BR DBLUR
+This variable specifies the aperture diameter for depth-of-field blurring,
+in world units.
+A number of samples may be given as a second argument, which controls the
+number of additional frames computed and averaged together by
+.I pinterp.
+If this number is less than 2, then blurring is performed by
+.I rpict
+only, resulting in greater noise than the combination of
+.I rpict
+and
 .I pinterp
-to average together.
-The default value is 0, meaning no motion blurring.
+used otherwise.
+(The default value for number of samples is 5.)\0
+To simulate a particular camera's aperture, divide the focal length of
+the lens by the f-number, then convert to the corresponding
+world coordinate units.
+For example, if you wish to simulate a 50mm lens at f/2.0 in
+a scene modeled in meters, then you divide 50mm by 2.0 to get 25mm,
+which corresponds to an effective aperture of 0.025 meters.
+The default aperture is 0, meaning no depth-of-field blurring.
 This option does not currently work with the
 .I ANIMATE
 variable, since pinterp only works for static environments.
@@ -464,7 +489,7 @@ If we only want to see what default values
 would use without actually executing anything, we can invoke it
 thus:
 .IP "" .2i
-ranimate -n -e sample.ran
+ranimate \-n \-e sample.ran
 .PP
 This will print the variables we have given as well as default
 values
@@ -495,7 +520,7 @@ INTERP= 3				# render every fourth frame
 RES= 1024				# shoot for 1024x resolution
 MBLUR= .25				# apply camera motion blur
 EXP= anim1.exp				# adjust exposure according to file
-pfilt= -r .9				# use Gaussian filtering
+pfilt= \-r .9				# use Gaussian filtering
 ARCHIVE= tar cf /dev/nrtape		# save original renderings to tape
 .fi
 .PP
@@ -503,7 +528,7 @@ Note the use of abbreviation for variable names.
 .SH FILES
 $(DIRECTORY)/STATUS	animation status file
 $(DIRECTORY)/*		other temporary files
-$(BASENAME).pic		final animation frames
+$(BASENAME).hdr		final animation frames
 .SH AUTHOR
 Greg Ward
 .SH BUGS
@@ -560,7 +585,7 @@ to set whatever variables are important in the remote 
 This requirement may be circumvented by substituting the
 .I on(1)
 command for
-.I rsh(1)
+.I ssh(1)
 using the
 .I RSH
 control variable, or by writing a custom remote execution script.
@@ -584,5 +609,5 @@ is called if INTERPOLATE > 0 and/or MBLUR is assigned.
 Since most modern machines use IEEE floating point, this is not
 usually a problem, but it is something to keep in mind.
 .SH "SEE ALSO"
-pfilt(1), pinterp(1), pmblur(1), rad(1),
-ranimove(1), rpict(1), rsh(1), rtrace(1)
+fieldcomb(1), pfilt(1), pinterp(1), pmblur(1), rad(1),
+ran2tiff(1), ranimove(1), rpict(1), ssh(1), rtrace(1)