Radiance rvu program



RVU(1)                                                                  RVU(1)




NAME

       rvu - generate RADIANCE images interactively


SYNOPSIS

       rvu [ rpict options ][ -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 con-
       tents 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.  Addition-
       ally, the -b option improves the display on greyscale monitors, and -pe
       may be used to set an initial exposure value.

       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  gradu-
       ally  improves  the resolution of the display until interrupted by key-
       board input.  rvu then issues a prompt (usually ':') and accepts a com-
       mand  line  from  the user.  rvu may also stop its calculation and wait
       for command input if the resolution of the display has reached the res-
       olution  of  the  graphics  device.   At  this  point, it will give the
       'done:' prompt and await further instructions.  If rvu runs out of mem-
       ory  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 gener-
       ally 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  con-
                 stant;  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 dis-
                 tance 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 spec-
                 ified, the frame is reset to the entire image.

       free      Free cached object structures and associated data.  This com-
                 mand  may  be useful when memory is low and a completely dif-
                 ferent 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 perspec-
                 tive 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       Restart the image.  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 ele-
                 vation 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 cur-
                 rent  value of the variable is displayed and changed interac-
                 tively.  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  vari-
                 able  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 pro-
                 gram 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  pro-
                 gram resumes.


ENVIRONMENT

       RAYPATH        the  directories  to  check  for  auxiliary files.  DIS-
       PLAY_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)



RADIANCE                            1/1/04                              RVU(1)

Man(1) output converted with man2html