man/man1/glrad.1

.\" RCSid "$Id: glrad.1,v 1.5 2007/09/04 17:36:40 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)
(none)  wheel-up        Zoom in on current position
(non)   wheel-dn        Zoom out around current position
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.
.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.6
Committed:	Thu Apr 28 16:28:20 2016 UTC (9 years, 6 months ago) by greg
Branch:	MAIN
CVS Tags:	rad5R4, rad5R2, rad5R3, rad5R1, rad6R0, HEAD
Changes since 1.5:	+6 -5 lines
Log Message:	Added listening for mouse wheel
#	User	Rev	Content
1	greg	1.6	.\" RCSid "$Id: glrad.1,v 1.5 2007/09/04 17:36:40 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	greg	1.6	(none) left Move forward towards cursor position
90	greg	1.1	(none) right Move backward away from cursor position
91			(none) middle Rotate in place (usually safe)
92	greg	1.6	(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	greg	1.1	shift right Orbit right around cursor position
96			shift middle Orbit skyward
97	greg	1.6	cntl middle Orbit earthward
98	greg	1.1	.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	greg	1.5	may be compiled with the \-DNOSTEREO option, which will avoid
170	greg	1.1	undefined symbol errors.
171			.SH "SEE ALSO"
172			chmod(1), getinfo(1), ls(1), objview(1), oconv(1), ps(1), rad(1),
173	greg	1.4	ranimate(1), rhcopy(1), rholo(1), rpict(1), rtrace(1), rvu(1), setmon(1)