| 1 |
.\" RCSid "$Id: glrad.1,v 1.4 2004/01/01 19:31:45 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 |
shift left Orbit left around cursor position |
| 93 |
shift right Orbit right around cursor position |
| 94 |
shift middle Orbit skyward |
| 95 |
cntl middle Orbit earthward |
| 96 |
.fi |
| 97 |
.sp |
| 98 |
For all movements but rotating in place, the cursor must be placed over some |
| 99 |
bit of visible geometry, otherwise the program has no reference point from |
| 100 |
which to work. |
| 101 |
It is best to just experiment with these controls until you learn to fly |
| 102 |
safely in your model. |
| 103 |
And if you run into trouble, the 'l' command is very useful. |
| 104 |
(See below.)\0 |
| 105 |
.TP |
| 106 |
.BR '+' |
| 107 |
Zoom in on the current cursor position. |
| 108 |
(Beware of repeating keys that go faster than the display updates.) |
| 109 |
.TP |
| 110 |
.BR '-' |
| 111 |
Zoom out from the current cursor position. |
| 112 |
.TP |
| 113 |
.BR 'l' |
| 114 |
Return to the last saved view. |
| 115 |
Each time a new command changes the current view, the last view |
| 116 |
is saved, and may be recalled with this command. |
| 117 |
Multiple uses of the same command (e.g., rotation, zoom) will |
| 118 |
save only the view before the first such command. |
| 119 |
This way, it is easy to get back to where you were before a sequence |
| 120 |
of view changes. |
| 121 |
.TP |
| 122 |
.BR 'h' |
| 123 |
Fix the head height. |
| 124 |
All mouse-controlled view motions will be adjusted so that the head height |
| 125 |
does not change (where vertical is determined by the current |
| 126 |
view up vector). |
| 127 |
.TP |
| 128 |
.BR 'H' |
| 129 |
Release the head height, allowing it to change again during mouse-controlled |
| 130 |
movements. |
| 131 |
.TP |
| 132 |
.BR 'v' |
| 133 |
Print the current view parameters to the standard output. |
| 134 |
This is useful for finding out where you are, or for saving specific |
| 135 |
views in a keyframe file for animations or returning to later. |
| 136 |
.TP |
| 137 |
.BR 'V' |
| 138 |
Append the current view to the original |
| 139 |
.I rfile. |
| 140 |
This view will be unnamed, but can be referred to by number or the |
| 141 |
user may add a name later with a text editor. |
| 142 |
The current view number becomes the last standard view. |
| 143 |
(See the 'n' and 'p' commands, below.) |
| 144 |
.TP |
| 145 |
.BR 'n' |
| 146 |
Go to the next standard view stored in |
| 147 |
.I rfile. |
| 148 |
If the last view is currently displayed, then cycle to the first one. |
| 149 |
.TP |
| 150 |
.BR 'p' |
| 151 |
Go to the previous standard view stored in |
| 152 |
.I rfile. |
| 153 |
If the first view is currently displayed, then cycle to the last one. |
| 154 |
.TP |
| 155 |
.BR 'q' |
| 156 |
Quit |
| 157 |
.I glrad. |
| 158 |
This is the normal way to exit the program. |
| 159 |
.SH AUTHOR |
| 160 |
Greg Ward Larson |
| 161 |
.SH BUGS |
| 162 |
It would be nice if |
| 163 |
.I glrad |
| 164 |
set the appropriate video format for stereo viewing automatically, |
| 165 |
but the process is different on different systems and there is no |
| 166 |
single, sure-fire way to do it for all systems. |
| 167 |
On systems that do not support stereo extensions, the program |
| 168 |
may be compiled with the \-DNOSTEREO option, which will avoid |
| 169 |
undefined symbol errors. |
| 170 |
.SH "SEE ALSO" |
| 171 |
chmod(1), getinfo(1), ls(1), objview(1), oconv(1), ps(1), rad(1), |
| 172 |
ranimate(1), rhcopy(1), rholo(1), rpict(1), rtrace(1), rvu(1), setmon(1) |
