--- ray/doc/man/man1/rvu.1 2013/10/18 17:20:55 1.7 +++ ray/doc/man/man1/rvu.1 2025/05/02 23:56:18 1.14 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: rvu.1,v 1.7 2013/10/18 17:20:55 greg Exp $" +.\" RCSid "$Id: rvu.1,v 1.14 2025/05/02 23:56:18 greg Exp $" .TH RVU 1 1/1/04 RADIANCE .SH NAME rvu - generate RADIANCE images interactively @@ -42,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 @@ -207,7 +207,9 @@ was started by .I rad, then the .I rfile -parameter will initially default to the rad input file used. +parameter will initially default to the +.I rad +input file used. .TP .BI move " [ mag [ x y z ] ]" Move camera @@ -230,13 +232,18 @@ Care must be taken to avoid moving behind or inside ot 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 +.BI origin " [ forward [ right [up] ] ]" +Move the view origin forward or backwards the distance specified by the +.I forward +argument, along the view direction vector. +If at least two arguments are given, the second distance will be a +.I right +shift, or left if negative relative to the current view direction. +If three arguments are given, the third distance will be a distance of +.I up +along the view up vector, or down if negative. +The view direction and size are unchanged in any of the above cases. +With no arguments, 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 @@ -246,7 +253,8 @@ may be changed if the new direction coincides. 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 @@ -265,7 +273,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. @@ -361,4 +371,5 @@ DISPLAY_GAMMA the value to use for monitor gamma corr .SH AUTHOR Greg Ward .SH "SEE ALSO" -getinfo(1), lookamb(1), oconv(1), pfilt(1), rad(1), rpict(1), rtrace(1) +getinfo(1), lookamb(1), mkpmap(1), +oconv(1), pfilt(1), rad(1), rpict(1), rtpict(1), rtrace(1)