xenial (1) rvu.1.gz

Provided by: radiance_4R1+20120125-1.1_amd64 bug

NAME

       rvu - generate RADIANCE images interactively

SYNOPSIS

       rvu [ rpict options ][ -n nproc ][ -o dev ][ -b ][ -pe exposure ] [ $EVAR ] [ @file ] octree
       rvu [ options ] -defaults
       rvu -devices

DESCRIPTION

       Rvu generates RADIANCE images using octree.  (The octree may be given as the output of a command enclosed
       in quotes and preceded by a `!'.)  Options specify the viewing parameters as well as giving some  control
       over  the  calculation.  Options may be given on the command line and/or read from the environment and/or
       read from a file.  A command argument beginning with a dollar sign ('$') is immediately replaced  by  the
       contents  of  the  given  environment  variable.   A  command argument beginning with an at sign ('@') is
       immediately replaced by the contents of the given file.  The options are the same as for rpict(1), with a
       few notable exceptions.  The -r, -z, -S, -P, -PP and -t options are not supported, and -o specifies which
       output device is being used instead of the output file.  The -x, -y  and  -pa  options  are  unnecessary,
       since  rvu scales the display image to the specified output device.  Additionally, the -b option improves
       the display on greyscale monitors, and -pe may be used to set an initial exposure value.

       The -n option may be used to specify multiple processes, to accelerate rendering.

       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 is displayed.

       rvu  starts  rendering the image from the selected viewpoint and gradually improves the resolution of the
       display until interrupted by keyboard input.  rvu then issues  a  prompt  (usually  ':')  and  accepts  a
       command  line  from  the  user.   rvu  may  also  stop  its calculation and wait for command input if the
       resolution of the display has reached the resolution of the graphics device.  At this point, it will give
       the 'done:' prompt and await further instructions.  If rvu runs out of memory due to lack of resources to
       store its computed image, it will give the 'out of memory:' prompt.  At this prompt, the  user  can  save
       the  image,  quit,  or  even  restart  a new image, although this is not generally recommended on virtual
       memory machines for efficiency reasons.

       rvu is not meant to be a rendering program, and we strongly recommend that rpict(1) be used  instead  for
       that  purpose.  Since rpict(1) does not store its image in memory or update any display of its output, it
       is much faster and less wasteful of its resources than rvu.  rvu  is  intended  as  a  quick  interactive
       program for deciding viewpoints and debugging scene descriptions and is not suited for producing polished
       images.

COMMANDS

       Once the program starts, a number of commands can be used to control it.  A command is given by its name,
       which can be abbreviated, followed by its arguments.

       aim [ mag [ x y z ] ]
                 Zoom  in  by mag on point x y z .  The view point is held constant; only the view direction and
                 size are changed.  If x y z is missing, the cursor is  used  to  select  the  view  center.   A
                 negative magnification factor means zoom out.  The default factor is one.

       ^C        Interrupt.  Go to the command line.

       exposure [ spec ]
                 Adjust  exposure.   The number spec is a multiplier used to compensate the average exposure.  A
                 value of 1 renormalizes the image to the computed average, which is  usually  done  immediately
                 after  startup.   If  spec begins with a '+' or '-', the compensation is interpreted in f-stops
                 (ie. the power of two).  If spec begins with an '=', an absolute setting is performed.  An  '='
                 by itself permits interactive display and setting of the exposure.  If spec begins with an '@',
                 the exposure is adjusted to present similar visibility to what would be experienced in the real
                 environment.   If  spec is absent, or an '@' is followed by nothing, then the cursor is used to
                 pick a specific image location for normalization.

       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 rview, but can be used in rpict with  the  -pd  option  to
                 simulate depth-of-field on views saved from rview.)

       frame [ xmin ymin xmax ymax ]
                 Set  frame  for  refinement.   If  coordinates  are  absent,  the  cursor is used to pick frame
                 boundaries.  If ``all'' is specified, the frame is reset to the entire image.

       free      Free cached object structures and associated data.  This command may be useful when  memory  is
                 low and a completely different view is being generated from the one previous.

       last [ file ]
                 Restore  the  previous  view.  If a view or picture file is specified, the parameters are taken
                 from the last view entry in the file.

       L [ vw [ rfile ] ]
                 Load parameters for view vw from the rad(1) input file, rfile.  Both vw and rfile must be given
                 the  first  call,  but  subsequent  calls  will use the last rfile as a default, and "1" as the
                 default view (ie. the first view appearing in rfile).  If rvu was  started  by  rad,  then  the
                 rfile parameter will initially default to the rad input file used.

       move [ mag [ x y z ] ]
                 Move  camera mag times closer to point x y z .  For a perspective projection (or fisheye view),
                 only the view point is changed; the view direction and size remain  constant.   The  view  size
                 must  be  modified  in  a  parallel  projection since it determines magnification.  If x y z is
                 missing, the cursor is used to  select  the  view  center.   A  negative  magnification  factor
                 decreases  the  object  size.   The  default factor is one.  Care must be taken to avoid moving
                 behind or inside other objects.

       new [ nproc ]
                 Restart the image, using the specified number of rendering processes.  Usually used  after  the
                 "set" command.

       pivot angle [ elev [ mag [ x y z ] ] ]
                 Similar  to  the  "move"  command,  but  pivots  the view about a selected point.  The angle is
                 measured in degrees around the view up vector using the right hand rule.  The optional elev  is
                 the  elevation in degrees from the pivot point; positive raises the view point to look downward
                 and negative lowers the view point to look upward.

       quit      Quit the program.

       ^R        Redraw the image.  Use when the  display  gets  corrupted.   On  some  displays,  occassionally
                 forcing  a redraw can improve appearance, as more color information is available and the driver
                 can make a better color table selection.

       rotate angle [ elev [ mag ] ]
                 Rotate the camera horizontally by angle degrees.  If an  elevation  is  specified,  the  camera
                 looks upward elev degrees.  (Negative means look downward.)

       set [ var [ val ] ]
                 Check/change program variable.  If var is absent, the list of available variables is displayed.
                 If val is absent, the current value of the variable is  displayed  and  changed  interactively.
                 Otherwise,  the  variable  var  assumes  the value val.  Variables include: ambient value (av),
                 ambient value weight (aw), ambient bounces (ab), ambient accuracy (aa), 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), direct  visibility  (dv),  irradiance
                 (i),  limit  weight  (lw),  limit  recursion  (lr), medium extinction (me), medium albedo (ma),
                 medium eccentricity (mg), medium sampling  (ms),  pixel  sample  (ps),  pixel  threshold  (pt),
                 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 some other command or it may
                 be impossible to change once the program is running.

       trace [ xbeg ybeg zbeg xdir ydir zdir ]
                 Trace a ray.  If the ray origin and direction are absent, the cursor is used to pick a location
                 in  the  image  to  trace.   The  object  intersected  and its material, location and value are
                 displayed.

       view [ file [ comments ] ]
                 Check/change view parameters.  If file is present, the view parameters are appended to a  file,
                 followed  by comments if any.  Alternatively, view options may be given directly on the command
                 line instead of an output view file.  Otherwise, view  parameters  are  displayed  and  changed
                 interactively.

       V [ vw [ rfile ] ]
                 Append  the current view as view vw in the rad file rfile.  Compliment to L command.  Note that
                 the view is simply appended to the file, and previous  views  with  the  same  name  should  be
                 removed before using the file with rad.

       write [ file ]
                 Write picture to file.  If argument is missing, the current file name is used.

       ^Z        Stop the program.  The screen will be redrawn when the program resumes.

ENVIRONMENT

       RAYPATH        the  directories  to  check for auxiliary files.  DISPLAY_GAMMA       the value to use for
       monitor gamma correction.

AUTHOR

       Greg Ward

SEE ALSO

       getinfo(1), lookamb(1), oconv(1), pfilt(1), rad(1), rpict(1), rtrace(1)