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)