RVU(1)                                                                  RVU(1)



NNAAMMEE
       rvu - generate RADIANCE images interactively

SSYYNNOOPPSSIISS
       rrvvuu [ rrppiicctt ooppttiioonnss ][ --oo ddeevv ][ --bb ][ --ppee eexxppoossuurree ] [ $$EEVVAARR ] [ @@ffiillee
       ] ooccttrreeee
       rrvvuu [[ ooppttiioonnss ]] --ddeeffaauullttss
       rrvvuu --ddeevviicceess

DDEESSCCRRIIPPTTIIOONN
       _R_v_u generates RADIANCE images using _o_c_t_r_e_e_.  (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_, _-_P_P and _-_t options are not
       supported, and _-_o specifies which output device is being  used  instead
       of  the output file.  The _-_x_, _-_y and _-_p_a options are unnecessary, since
       _r_v_u scales the display image to the specified output device.  Addition-
       ally, the _-_b option improves the display on greyscale monitors, and _-_p_e
       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.

       _r_v_u starts rendering the image from the selected viewpoint  and  gradu-
       ally  improves  the resolution of the display until interrupted by key-
       board input.  _r_v_u then issues a prompt (usually ':') and accepts a com-
       mand  line  from  the user.  _r_v_u 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 _r_v_u 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.

       _r_v_u is not meant to be a rendering program, and we  strongly  recommend
       that  _r_p_i_c_t_(_1_)  be  used instead for that purpose.  Since _r_p_i_c_t_(_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 _r_v_u_.  _r_v_u is
       intended as a quick interactive program  for  deciding  viewpoints  and
       debugging  scene  descriptions and is not suited for producing polished
       images.

CCOOMMMMAANNDDSS
       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.

       aaiimm _[ _m_a_g _[ _x _y _z _] _]
                 Zoom in by _m_a_g 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.

       ^^CC        Interrupt.  Go to the command line.

       eexxppoossuurree _[ _s_p_e_c _]
                 Adjust exposure.  The number _s_p_e_c 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 _s_p_e_c begins with a '+' or '-',
                 the compensation is interpreted in f-stops (ie. the power  of
                 two).   If  _s_p_e_c  begins  with an '=', an absolute setting is
                 performed.  An '=' by itself permits interactive display  and
                 setting  of  the  exposure.   If _s_p_e_c begins with an '@', the
                 exposure is adjusted to present similar  visibility  to  what
                 would  be  experienced  in  the real environment.  If _s_p_e_c is
                 absent, or an '@' is followed by nothing, then the cursor  is
                 used to pick a specific image location for normalization.

       ffrraammee _[ _x_m_i_n _y_m_i_n _x_m_a_x _y_m_a_x _]
                 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.

       ffrreeee      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.

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

       LL _[ _v_w _[ _r_f_i_l_e _] _]
                 Load  parameters  for  view  _v_w  from  the _r_a_d_(_1_) input file,
                 _r_f_i_l_e_.  Both _v_w and _r_f_i_l_e must be given the first  call,  but
                 subsequent  calls  will  use the last _r_f_i_l_e as a default, and
                 "1" as the default view (ie.  the  first  view  appearing  in
                 _r_f_i_l_e_)_.   If _r_v_u was started by _r_a_d_, then the _r_f_i_l_e parameter
                 will initially default to the rad input file used.

       mmoovvee _[ _m_a_g _[ _x _y _z _] _]
                 Move camera _m_a_g 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.

       nneeww       Restart the image.  Usually used after the "set" command.

       ppiivvoott _a_n_g_l_e _[ _e_l_e_v _[ _m_a_g _[ _x _y _z _] _] _]
                 Similar to the "move" command, but pivots the  view  about  a
                 selected  point.  The _a_n_g_l_e is measured in degrees around the
                 view up vector using the right hand rule.  The optional  _e_l_e_v
                 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.

       qquuiitt      Quit the program.

       ^^RR        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.

       rroottaattee _a_n_g_l_e _[ _e_l_e_v _[ _m_a_g _] _]
                 Rotate the camera horizontally by _a_n_g_l_e degrees.  If an  ele-
                 vation  is  specified,  the camera looks upward _e_l_e_v degrees.
                 (Negative means look downward.)

       sseett _[ _v_a_r _[ _v_a_l _] _]
                 Check/change program variable.  If _v_a_r is absent, the list of
                 available variables is displayed.  If _v_a_l is absent, the cur-
                 rent value of the variable is displayed and changed  interac-
                 tively.   Otherwise,  the variable _v_a_r assumes the value _v_a_l_.
                 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),  direct  jitter (dj), direct sampling (ds),
                 direct threshold (dt),  direct  visibility  (dv),  irradiance
                 (i),  limit weight (lw), limit recursion (lr), medium extinc-
                 tion (me), medium  albedo  (ma),  medium  eccentricity  (mg),
                 medium  sampling  (ms),  pixel  sample  (ps), pixel threshold
                 (pt), back face visibility (bv), specular  jitter  (sj),  and
                 specular  threshold  (st).  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 impossi-
                 ble to change once the program is running.

       ttrraaccee _[ _x_b_e_g _y_b_e_g _z_b_e_g _x_d_i_r _y_d_i_r _z_d_i_r _]
                 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.

       vviieeww _[ _f_i_l_e _[ _c_o_m_m_e_n_t_s _] _]
                 Check/change view parameters.  If _f_i_l_e is present,  the  view
                 parameters  are  appended  to a file, followed by _c_o_m_m_e_n_t_s 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.

       VV _[ _v_w _[ _r_f_i_l_e _] _]
                 Append the current view as view _v_w in  the  rad  file  _r_f_i_l_e_.
                 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 _r_a_d_.

       wwrriittee _[ _f_i_l_e _]
                 Write  picture  to _f_i_l_e_.  If argument is missing, the current
                 file name is used.

       ^^ZZ        Stop the program.  The screen will be redrawn when  the  pro-
                 gram resumes.

EENNVVIIRROONNMMEENNTT
       RAYPATH        the  directories  to  check  for  auxiliary files.  DIS-
       PLAY_GAMMA       the value to use for monitor gamma correction.

AAUUTTHHOORR
       Greg Ward

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



RADIANCE                            1/1/04                              RVU(1)
