RVU(1)                                                                  RVU(1)



NNAAMMEE
       rvu - generate RADIANCE images interactively

SSYYNNOOPPSSIISS
       rrvvuu  [  rrppiicctt  ooppttiioonnss  ][ --nn nnpprroocc ][ --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.

       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.

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

       ffooccuuss _[_d_i_s_t_a_n_c_e_]
                 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 _r_v_i_e_w_, but can
                 be used in _r_p_i_c_t with the _-_p_d option  to  simulate  depth-of-
                 field on views saved from _r_v_i_e_w_._)

       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 _[ _n_p_r_o_c _]
                 Restart the image, using the specified  number  of  rendering
                 processes.  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), 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.

       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)
