GLRAD(1)						      General Commands Manual							  GLRAD(1)

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  com-
		 mand.	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 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.

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)

RADIANCE
							      6/10/98								  GLRAD(1)