--- ray/doc/man/man1/rvu.1 2005/06/13 20:07:55 1.3 +++ ray/doc/man/man1/rvu.1 2013/12/05 18:12:42 1.9 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: rvu.1,v 1.3 2005/06/13 20:07:55 greg Exp $" +.\" RCSid "$Id: rvu.1,v 1.9 2013/12/05 18:12:42 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 @@ -40,7 +42,7 @@ A command argument beginning with an at sign ('@') is replaced by the contents of the given file. The options are the same as for rpict(1), with a few notable exceptions. The -.I "\-r, \-z, \-S, \-P, \-PP" +.I "\-pd, \-r, \-z, \-S, \-P, \-PP" and .I \-t options are not supported, and @@ -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 @@ -152,13 +159,13 @@ 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 rview, +.I rvu, but can be used in .I rpict with the .I \-pd option to simulate depth-of-field on views saved from -.I rview.) +.I rvu.) .TP .BI frame " [ xmin ymin xmax ymax ]" Set frame for refinement. @@ -219,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 @@ -246,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. @@ -274,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), @@ -287,10 +310,9 @@ medium eccentricity (mg), medium sampling (ms), pixel sample (ps), pixel threshold (pt), -back face visibility (bv), -random sampling (R), -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 @@ -337,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