GLRAD(1)                                                              GLRAD(1)



NNAAMMEE
       glrad - render a RADIANCE scene using OpenGL

SSYYNNOOPPSSIISS
       ggllrraadd [ --ww ][ --bb ][ --ss ][ --SS ][ --vv vviieeww ] rrffiillee [ VVAARR==vvaalluuee ....  ]

DDEESSCCRRIIPPTTIIOONN
       _G_l_r_a_d  renders  a Radiance scene description in OpenGL.  Its syntax and
       behavior is similar to _r_a_d_(_1_) with the  _-_o  option,  where  the  output
       device is assumed to be an X11 server with GLX extensions.

       The _-_w option turns off warnings.  The _-_s option tells _g_l_r_a_d to run _r_a_d
       silently, not echoing _o_c_o_n_v_(_1_) command.  The _-_b option turns  off  back
       face  visibility (i.e., enables back face culling).  This is equivalent
       to the _-_b_v option of _r_p_i_c_t_(_1_) and _r_v_u_(_1_)_.  The _-_S option turns on full-
       screen   stereo  for  displays  that  support  it.   (Be  sure  to  run
       _/_u_s_r_/_g_f_x_/_s_e_t_m_o_n_(_1_)  or  its  equivalent  to  set  STR_TOP  or  STR_BOT,
       first.)   The  _-_v option may be used to specify a starting view, either
       by symbolic name as entered in the _v_i_e_w assignments in _r_f_i_l_e_, or  by  a
       complete  view specification, enclosed in quotes.  If no view is speci-
       fied, then the first standard view from _r_f_i_l_e is used to start.

       Variables permitted in _r_f_i_l_e are described  in  the  _r_a_d  manual  page.
       Additional  or  overriding assignments may be given on the command line
       following _r_f_i_l_e_.

       The view is controlled via the mouse and simple one-character commands,
       listed below:

       ((mmoouussee))   Modify  the  current  view.  The mouse is used to control the
                 current view in the following ways:

                 CONTROL   MOUSE     ACTION
                 (none)    left Move forward towards cursor position
                 (none)    right     Move backward away from cursor position
                 (none)    middle    Rotate in place (usually safe)
                 shift     left Orbit left around cursor position
                 shift     right     Orbit right around cursor position
                 shift     middle    Orbit skyward
                 cntl middle    Orbit earthward

                 For all movements but rotating in place, the cursor  must  be
                 placed  over some bit of visible geometry, otherwise the pro-
                 gram has no reference point from which to work.  It  is  best
                 to just experiment with these controls until you learn to fly
                 safely in your model.  And if you run into trouble,  the  'l'
                 command is very useful.  (See below.)

       ''++''       Zoom in on the current cursor position.  (Beware of repeating
                 keys that go faster than the display updates.)

       ''--''       Zoom out from the current cursor position.

       ''ll''       Return to the last saved  view.   Each  time  a  new  command
                 changes  the current view, the last view is saved, and may be
                 recalled with this command.  Multiple uses of the  same  com-
                 mand  (e.g.,  rotation,  zoom) will save only the view before
                 the first such command.  This way, it is easy to get back  to
                 where you were before a sequence of view changes.

       ''hh''       Fix  the head height.  All mouse-controlled view motions will
                 be adjusted so that the head height does  not  change  (where
                 vertical is determined by the current view up vector).

       ''HH''       Release  the  head height, allowing it to change again during
                 mouse-controlled movements.

       ''vv''       Print the current view parameters  to  the  standard  output.
                 This  is  useful for finding out where you are, or for saving
                 specific views in a keyframe file for animations or returning
                 to later.

       ''VV''       Append  the  current  view  to the original _r_f_i_l_e_.  This view
                 will be unnamed, but can be referred to by number or the user
                 may  add  a  name later with a text editor.  The current view
                 number becomes the last standard view.  (See the 'n' and  'p'
                 commands, below.)

       ''nn''       Go  to  the  next standard view stored in _r_f_i_l_e_.  If the last
                 view is currently displayed, then cycle to the first one.

       ''pp''       Go to the previous standard view stored  in  _r_f_i_l_e_.   If  the
                 first  view  is  currently  displayed, then cycle to the last
                 one.

       ''qq''       Quit _g_l_r_a_d_.  This is the normal way to exit the program.

AAUUTTHHOORR
       Greg Ward Larson

BBUUGGSS
       It would be nice if _g_l_r_a_d set the appropriate video format  for  stereo
       viewing  automatically,  but the process is different on different sys-
       tems and there is no single, sure-fire way to do it  for  all  systems.
       On  systems  that  do not support stereo extensions, the program may be
       compiled with the -DNOSTEREO option, which will avoid undefined  symbol
       errors.

SSEEEE AALLSSOO
       chmod(1), getinfo(1), ls(1), objview(1), oconv(1), ps(1), rad(1), rani-
       mate(1), rhcopy(1), rholo(1), rpict(1), rtrace(1), rvu(1), setmon(1)



RADIANCE                            6/10/98                           GLRAD(1)
