--- ray/doc/man/man1/rpict.1	2003/03/11 19:20:21	1.1
+++ ray/doc/man/man1/rpict.1	2005/04/14 18:04:12	1.7
@@ -1,4 +1,4 @@
-.\" RCSid "$Id"
+.\" RCSid "$Id: rpict.1,v 1.7 2005/04/14 18:04:12 greg Exp $"
 .TH RPICT 1 2/26/99 RADIANCE
 .SH NAME
 rpict - generate a RADIANCE picture
@@ -89,6 +89,9 @@ center of a parallel projection.
 .BI -vd " xd yd zd"
 Set the view direction vector to
 .I "xd yd zd".
+The length of this vector indicates the focal distance as needed by the
+.I \-pd
+option, described below.
 .TP
 .BI -vu " xd yd zd"
 Set the view up vector (vertical direction) to
@@ -163,7 +166,7 @@ option.
 .BI -vf \ file
 Get view parameters from
 .I file,
-which may be a picture or a file created by rview (with the "view" command).
+which may be a picture or a file created by rvu (with the "view" command).
 .TP
 .BI -x \ res
 Set the maximum x resolution to
@@ -226,6 +229,23 @@ to use a very small fraction with the
 .I \-pm
 option, to avoid the ghosting effect of too few time samples.
 .TP
+.BI -pd \ dia
+Set the pixel depth-of-field aperture to a diameter of
+.I dia
+(in world coordinates).
+This will be used in conjunction with the view focal distance, indicated
+by the length of the view direction vector given in the
+.I \-vd
+option.
+It is not advisable to use this option in combination with the
+.I pdfblur(1)
+program, since one takes the place of the other.
+However, it may improve results with
+.I pdfblur
+to use a very small fraction with the
+.I \-pd
+option, to avoid the ghosting effect of too few samples.
+.TP
 .BI -dj \ frac
 Set the direct jittering to
 .I frac.
@@ -452,23 +472,23 @@ header of the ambient file.
 .I Getinfo(1)
 may be used to print out this information.
 .TP
-.BI -ae \ mat
+.BI -ae \ mod
 Append
-.I mat
+.I mod
 to the ambient exclude list,
 so that it will not be considered during the indirect calculation.
 This is a hack for speeding the indirect computation by
 ignoring certain objects.
 Any object having
-.I mat
+.I mod
 as its modifier will get the default ambient
 level rather than a calculated value.
-Any number of excluded materials may be given, but each
+Any number of excluded modifiers may be given, but each
 must appear in a separate option.
 .TP
-.BI -ai \ mat
+.BI -ai \ mod
 Add
-.I mat
+.I mod
 to the ambient include list,
 so that it will be considered during the indirect calculation.
 The program can use either an include list or an exclude
@@ -477,16 +497,16 @@ list, but not both.
 .BI -aE \ file
 Same as
 .I \-ae,
-except read materials to be excluded from
+except read modifiers to be excluded from
 .I file.
 The RAYPATH environment variable determines which directories are
 searched for this file.
-The material names are separated by white space in the file.
+The modifier names are separated by white space in the file.
 .TP
 .BI -aI \ file
 Same as
 .I \-ai,
-except read materials to be included from
+except read modifiers to be included from
 .I file.
 .TP
 .BI -me " rext gext bext"
@@ -752,7 +772,7 @@ rpict -S 1 -o frame%02d.pic scene.oct < keyframes.vf
 .SH ENVIRONMENT
 RAYPATH		the directories to check for auxiliary files.
 .SH FILES
-/usr/tmp/rtXXXXXX		common header information for picture sequence
+/tmp/rtXXXXXX		common header information for picture sequence
 .br
 rfXXXXXX		temporary name for recover file
 .SH DIAGNOSTICS
@@ -768,5 +788,5 @@ option.
 .SH AUTHOR
 Greg Ward
 .SH "SEE ALSO"
-getinfo(1), lookamb(1), oconv(1), pfilt(1), pinterp(1), pmblur(1),
-printf(3), ra_rgbe(1), rad(1), rtrace(1), rview(1)
+getinfo(1), lookamb(1), oconv(1), pdfblur(1), pfilt(1), pinterp(1), pmblur(1),
+printf(3), ra_rgbe(1), rad(1), rtrace(1), rvu(1)