man/man1/glrad.1

.\" RCSid "$Id: glrad.1,v 1.4 2004/01/01 19:31:45 greg Exp $"
.TH GLRAD 1 6/10/98 RADIANCE
.SH NAME
glrad - render a RADIANCE scene using OpenGL
.SH SYNOPSIS
.B glrad
[
.B \-w
][
.B \-b
][
.B \-s
][
.B \-S
][
.B "\-v view"
]
.B rfile
[
.B "VAR\=value .."
]
.SH DESCRIPTION
.I Glrad
renders a Radiance scene description in OpenGL.
Its syntax and behavior is similar to
.I rad(1)
with the
.I \-o
option, where the output device is assumed to be an X11 server
with GLX extensions.
.PP
The
.I \-w
option turns off warnings.
The
.I \-s
option tells
.I glrad
to run
.I rad
silently, not echoing
.I oconv(1)
command.
The
.I \-b
option turns off back face visibility (i.e., enables back face culling).
This is equivalent to the
.I \-bv
option of
.I rpict(1)
and
.I rvu(1).
The
.I \-S
option turns on full-screen stereo for displays that support it.
(Be sure to run
.I /usr/gfx/setmon(1)
or its equivalent to set STR_TOP or STR_BOT, first.)\0
The
.I \-v
option may be used to specify a starting view, either by symbolic name
as entered in the
.I view
assignments in
.I rfile,
or by a complete view specification, enclosed in quotes.
If no view is specified, then the first standard view from
.I rfile
is used to start.
.PP
Variables permitted in
.I rfile
are described in the
.I rad
manual page.
Additional or overriding assignments may be given on the command line
following
.I rfile.
.PP
The view is controlled via the mouse and simple one-character commands,
listed below:
.TP 10n
.BR "(mouse)"
Modify the current view.
The mouse is used to control the current view in the following ways:
.sp
.nf
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
.fi
.sp
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.)\0
.TP
.BR '+'
Zoom in on the current cursor position.
(Beware of repeating keys that go faster than the display updates.)
.TP
.BR '-'
Zoom out from the current cursor position.
.TP
.BR '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.
.TP
.BR '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).
.TP
.BR 'H'
Release the head height, allowing it to change again during mouse-controlled
movements.
.TP
.BR '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.
.TP
.BR 'V'
Append the current view to the original
.I 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.)
.TP
.BR 'n'
Go to the next standard view stored in
.I rfile.
If the last view is currently displayed, then cycle to the first one.
.TP
.BR 'p'
Go to the previous standard view stored in
.I rfile.
If the first view is currently displayed, then cycle to the last one.
.TP
.BR 'q'
Quit
.I glrad.
This is the normal way to exit the program.
.SH AUTHOR
Greg Ward Larson
.SH BUGS
It would be nice if
.I 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.
.SH "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)
Revision:	1.5
Committed:	Tue Sep 4 17:36:40 2007 UTC (17 years, 8 months ago) by greg
Branch:	MAIN
CVS Tags:	rad4R2P2, rad5R0, rad4R2, rad4R1, rad4R0, rad3R9, rad4R2P1
Changes since 1.4:	+2 -2 lines
Log Message:	Added backslashes in front of hyphens (thanks to Bernd Zeimetz for his effort)
#	User	Rev	Content
1	greg	1.5	.\" RCSid "$Id: glrad.1,v 1.4 2004/01/01 19:31:45 greg Exp $"
2	greg	1.2	.TH GLRAD 1 6/10/98 RADIANCE
3	greg	1.1	.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	greg	1.4	.I rvu(1).
53	greg	1.1	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	greg	1.5	may be compiled with the \-DNOSTEREO option, which will avoid
169	greg	1.1	undefined symbol errors.
170			.SH "SEE ALSO"
171			chmod(1), getinfo(1), ls(1), objview(1), oconv(1), ps(1), rad(1),
172	greg	1.4	ranimate(1), rhcopy(1), rholo(1), rpict(1), rtrace(1), rvu(1), setmon(1)