xenial (1) glrad.1.gz

NAME

       glrad - render a RADIANCE scene using OpenGL

SYNOPSIS

       glrad [ -w ][ -b ][ -s ][ -S ][ -v view ] rfile [ VAR=value ..  ]

DESCRIPTION

       Glrad  renders a Radiance scene description in OpenGL.  Its syntax and behavior is similar to rad(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 glrad to run rad silently,  not  echoing  oconv(1)
       command.   The  -b  option  turns  off  back  face visibility (i.e., enables back face culling).  This is
       equivalent to the -bv option of rpict(1) and rvu(1).  The -S  option  turns  on  full-screen  stereo  for
       displays  that  support  it.   (Be  sure  to  run  /usr/gfx/setmon(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 view assignments in rfile, or by a complete view specification, enclosed in quotes.  If no
       view is specified, then the first standard view from rfile is used to start.

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

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

       (mouse)   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 program 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.

       'l'       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  command  (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.

       'h'       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).

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

       'v'       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.

       'V'       Append the current view to the original rfile.  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.)

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

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

       'q'       Quit glrad.  This is the normal way to exit the program.

AUTHOR

       Greg Ward Larson

BUGS

       It would be nice if glrad set the appropriate video format for  stereo  viewing  automatically,  but  the
       process is different on different systems 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.

SEE ALSO

       chmod(1),  getinfo(1),  ls(1),  objview(1),  oconv(1),  ps(1),  rad(1), ranimate(1), rhcopy(1), rholo(1),
       rpict(1), rtrace(1), rvu(1), setmon(1)