--- ray/doc/man/man1/rvu.1	2004/01/01 19:31:45	1.1
+++ ray/doc/man/man1/rvu.1	2013/10/19 18:40:26	1.8
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: rvu.1,v 1.1 2004/01/01 19:31:45 greg Exp $"
+.\" RCSid "$Id: rvu.1,v 1.8 2013/10/19 18:40:26 greg Exp $"
 .TH RVU 1 1/1/04 RADIANCE
 .SH NAME
 rvu - generate RADIANCE images interactively
@@ -7,6 +7,8 @@ rvu - generate RADIANCE images interactively
 [
 .B "rpict options"
 ][
+.B "\-n nproc"
+][
 .B "\-o dev"
 ][
 .B \-b
@@ -60,6 +62,11 @@ option improves the display on greyscale monitors, and
 .I \-pe
 may be used to set an initial exposure value.
 .PP
+The
+.I \-n
+option may be used to specify multiple processes,
+to accelerate rendering.
+.PP
 In the second form, the default values
 for the options are printed with a brief explanation.
 In the third form, the list of supported output devices
@@ -147,6 +154,19 @@ is absent, or an '@' is followed by nothing, then
 the cursor is used to pick a specific image
 location for normalization.
 .TP
+.BI focus " [distance]"
+Set focus distance for depth-of-field sampling.
+If a distance in world coordinates is absent, then the cursor
+is used to choose a point in the scene on which to focus.
+(The focus distance setting does not affect rendering in
+.I rvu,
+but can be used in
+.I rpict
+with the
+.I \-pd
+option to simulate depth-of-field on views saved from
+.I rvu.)
+.TP
 .BI frame " [ xmin ymin xmax ymax ]"
 Set frame for refinement.
 If coordinates are absent, the cursor is used to
@@ -206,15 +226,28 @@ A negative magnification factor decreases the object s
 The default factor is one.
 Care must be taken to avoid moving behind or inside other objects.
 .TP
-.BR new
-Restart the image.
+.BI new " [ nproc ]"
+Restart the image, using the specified number of rendering processes.
 Usually used after the "set" command.
 .TP
+.BI origin " [ xo yo zo [ xd yd zd ] ]"
+Change view origin to the indicated world position
+.I "xo yo zo"
+looking in the direction
+.I "xd yd zd."
+If the direction is missing, the current view direction is used.
+If the origin is missing, the cursor is used to select the
+view origin, and the direction will be determined by the
+(reoriented) surface normal.
+The view type and size will not be altered, but the up vector
+may be changed if the new direction coincides.
+.TP
 .BI pivot " angle [ elev [ mag [ x y z ] ] ]"
 Similar to the "move" command, but pivots the view about a selected point.
 The
 .I angle
-is measured in degrees around the view up vector using the right hand rule.
+is measured in degrees around the view up vector using the right hand rule,
+so a positive value pivots the viewer to the right of the selected point.
 The optional
 .I elev
 is the elevation in degrees from the pivot point; positive raises the view point
@@ -233,7 +266,9 @@ color table selection.
 .BI rotate " angle [ elev [ mag ] ]"
 Rotate the camera horizontally by
 .I angle
-degrees.
+degrees using the right-hand rule.
+A positive value rotates the view towards the left, and a negative value
+looks to the right.
 If an elevation is specified, the camera looks upward
 .I elev
 degrees.
@@ -261,6 +296,7 @@ ambient divisions (ad),
 ambient radius (ar),
 ambient samples (as),
 black&white (b),
+back face visibility (bv),
 direct jitter (dj),
 direct sampling (ds),
 direct threshold (dt),
@@ -274,9 +310,9 @@ medium eccentricity (mg),
 medium sampling (ms),
 pixel sample (ps),
 pixel threshold (pt),
-back face visibility (bv),
-specular jitter (sj), and
-specular threshold (st).
+specular jitter (sj),
+specular threshold (st), and
+uncorrelated sampling (u).
 Once a variable has been changed, the "new" command can be used
 to recompute the image with the new parameters.
 If a program variable is not available here, it may show up under
@@ -323,6 +359,7 @@ Stop the program.
 The screen will be redrawn when the program resumes.
 .SH ENVIRONMENT
 RAYPATH		the directories to check for auxiliary files.
+.br
 DISPLAY_GAMMA		the value to use for monitor gamma correction.
 .SH AUTHOR
 Greg Ward