| 1 |
.\" RCSid "$Id: glrad.1,v 1.5 2007/09/04 17:36:40 greg Exp $"
|
| 2 |
.TH GLRAD 1 6/10/98 RADIANCE
|
| 3 |
.SH NAME
|
| 4 |
glrad - render a RADIANCE scene using OpenGL
|
| 5 |
.SH SYNOPSIS
|
| 6 |
.B glrad
|
| 7 |
[
|
| 8 |
.B \-w
|
| 9 |
][
|
| 10 |
.B \-b
|
| 11 |
][
|
| 12 |
.B \-s
|
| 13 |
][
|
| 14 |
.B \-S
|
| 15 |
][
|
| 16 |
.B "\-v view"
|
| 17 |
]
|
| 18 |
.B rfile
|
| 19 |
[
|
| 20 |
.B "VAR\=value .."
|
| 21 |
]
|
| 22 |
.SH DESCRIPTION
|
| 23 |
.I Glrad
|
| 24 |
renders a Radiance scene description in OpenGL.
|
| 25 |
Its syntax and behavior is similar to
|
| 26 |
.I rad(1)
|
| 27 |
with the
|
| 28 |
.I \-o
|
| 29 |
option, where the output device is assumed to be an X11 server
|
| 30 |
with GLX extensions.
|
| 31 |
.PP
|
| 32 |
The
|
| 33 |
.I \-w
|
| 34 |
option turns off warnings.
|
| 35 |
The
|
| 36 |
.I \-s
|
| 37 |
option tells
|
| 38 |
.I glrad
|
| 39 |
to run
|
| 40 |
.I rad
|
| 41 |
silently, not echoing
|
| 42 |
.I oconv(1)
|
| 43 |
command.
|
| 44 |
The
|
| 45 |
.I \-b
|
| 46 |
option turns off back face visibility (i.e., enables back face culling).
|
| 47 |
This is equivalent to the
|
| 48 |
.I \-bv
|
| 49 |
option of
|
| 50 |
.I rpict(1)
|
| 51 |
and
|
| 52 |
.I rvu(1).
|
| 53 |
The
|
| 54 |
.I \-S
|
| 55 |
option turns on full-screen stereo for displays that support it.
|
| 56 |
(Be sure to run
|
| 57 |
.I /usr/gfx/setmon(1)
|
| 58 |
or its equivalent to set STR_TOP or STR_BOT, first.)\0
|
| 59 |
The
|
| 60 |
.I \-v
|
| 61 |
option may be used to specify a starting view, either by symbolic name
|
| 62 |
as entered in the
|
| 63 |
.I view
|
| 64 |
assignments in
|
| 65 |
.I rfile,
|
| 66 |
or by a complete view specification, enclosed in quotes.
|
| 67 |
If no view is specified, then the first standard view from
|
| 68 |
.I rfile
|
| 69 |
is used to start.
|
| 70 |
.PP
|
| 71 |
Variables permitted in
|
| 72 |
.I rfile
|
| 73 |
are described in the
|
| 74 |
.I rad
|
| 75 |
manual page.
|
| 76 |
Additional or overriding assignments may be given on the command line
|
| 77 |
following
|
| 78 |
.I rfile.
|
| 79 |
.PP
|
| 80 |
The view is controlled via the mouse and simple one-character commands,
|
| 81 |
listed below:
|
| 82 |
.TP 10n
|
| 83 |
.BR "(mouse)"
|
| 84 |
Modify the current view.
|
| 85 |
The mouse is used to control the current view in the following ways:
|
| 86 |
.sp
|
| 87 |
.nf
|
| 88 |
CONTROL MOUSE ACTION
|
| 89 |
(none) left Move forward towards cursor position
|
| 90 |
(none) right Move backward away from cursor position
|
| 91 |
(none) middle Rotate in place (usually safe)
|
| 92 |
(none) wheel-up Zoom in on current position
|
| 93 |
(non) wheel-dn Zoom out around current position
|
| 94 |
shift left Orbit left around cursor position
|
| 95 |
shift right Orbit right around cursor position
|
| 96 |
shift middle Orbit skyward
|
| 97 |
cntl middle Orbit earthward
|
| 98 |
.fi
|
| 99 |
.sp
|
| 100 |
For all movements but rotating in place, the cursor must be placed over some
|
| 101 |
bit of visible geometry, otherwise the program has no reference point from
|
| 102 |
which to work.
|
| 103 |
It is best to just experiment with these controls until you learn to fly
|
| 104 |
safely in your model.
|
| 105 |
And if you run into trouble, the 'l' command is very useful.
|
| 106 |
(See below.)\0
|
| 107 |
.TP
|
| 108 |
.BR '+'
|
| 109 |
Zoom in on the current cursor position.
|
| 110 |
.TP
|
| 111 |
.BR '-'
|
| 112 |
Zoom out from the current cursor position.
|
| 113 |
.TP
|
| 114 |
.BR 'l'
|
| 115 |
Return to the last saved view.
|
| 116 |
Each time a new command changes the current view, the last view
|
| 117 |
is saved, and may be recalled with this command.
|
| 118 |
Multiple uses of the same command (e.g., rotation, zoom) will
|
| 119 |
save only the view before the first such command.
|
| 120 |
This way, it is easy to get back to where you were before a sequence
|
| 121 |
of view changes.
|
| 122 |
.TP
|
| 123 |
.BR 'h'
|
| 124 |
Fix the head height.
|
| 125 |
All mouse-controlled view motions will be adjusted so that the head height
|
| 126 |
does not change (where vertical is determined by the current
|
| 127 |
view up vector).
|
| 128 |
.TP
|
| 129 |
.BR 'H'
|
| 130 |
Release the head height, allowing it to change again during mouse-controlled
|
| 131 |
movements.
|
| 132 |
.TP
|
| 133 |
.BR 'v'
|
| 134 |
Print the current view parameters to the standard output.
|
| 135 |
This is useful for finding out where you are, or for saving specific
|
| 136 |
views in a keyframe file for animations or returning to later.
|
| 137 |
.TP
|
| 138 |
.BR 'V'
|
| 139 |
Append the current view to the original
|
| 140 |
.I rfile.
|
| 141 |
This view will be unnamed, but can be referred to by number or the
|
| 142 |
user may add a name later with a text editor.
|
| 143 |
The current view number becomes the last standard view.
|
| 144 |
(See the 'n' and 'p' commands, below.)
|
| 145 |
.TP
|
| 146 |
.BR 'n'
|
| 147 |
Go to the next standard view stored in
|
| 148 |
.I rfile.
|
| 149 |
If the last view is currently displayed, then cycle to the first one.
|
| 150 |
.TP
|
| 151 |
.BR 'p'
|
| 152 |
Go to the previous standard view stored in
|
| 153 |
.I rfile.
|
| 154 |
If the first view is currently displayed, then cycle to the last one.
|
| 155 |
.TP
|
| 156 |
.BR 'q'
|
| 157 |
Quit
|
| 158 |
.I glrad.
|
| 159 |
This is the normal way to exit the program.
|
| 160 |
.SH AUTHOR
|
| 161 |
Greg Ward Larson
|
| 162 |
.SH BUGS
|
| 163 |
It would be nice if
|
| 164 |
.I glrad
|
| 165 |
set the appropriate video format for stereo viewing automatically,
|
| 166 |
but the process is different on different systems and there is no
|
| 167 |
single, sure-fire way to do it for all systems.
|
| 168 |
On systems that do not support stereo extensions, the program
|
| 169 |
may be compiled with the \-DNOSTEREO option, which will avoid
|
| 170 |
undefined symbol errors.
|
| 171 |
.SH "SEE ALSO"
|
| 172 |
chmod(1), getinfo(1), ls(1), objview(1), oconv(1), ps(1), rad(1),
|
| 173 |
ranimate(1), rhcopy(1), rholo(1), rpict(1), rtrace(1), rvu(1), setmon(1)
|
