ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/glrad.1
Revision: 1.4
Committed: Thu Jan 1 19:31:45 2004 UTC (20 years, 4 months ago) by greg
Branch: MAIN
CVS Tags: rad3R7P2, rad3R7P1, rad3R6, rad3R6P1, rad3R8
Changes since 1.3: +3 -3 lines
Log Message:
Renamed rview, lam, calc, and neat to rvu, rlam, icalc, and neaten

File Contents

# User Rev Content
1 greg 1.4 .\" RCSid "$Id: glrad.1,v 1.3 2003/12/09 15:59:06 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     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 greg 1.4 ranimate(1), rhcopy(1), rholo(1), rpict(1), rtrace(1), rvu(1), setmon(1)