README revision 32001f49 
1/*
2 * Copyright (c) 1991, 1992, 1993 Silicon Graphics, Inc.
3 *
4 * Permission to use, copy, modify, distribute, and sell this software and
5 * its documentation for any purpose is hereby granted without fee, provided
6 * that (i) the above copyright notices and this permission notice appear in
7 * all copies of the software and related documentation, and (ii) the name of
8 * Silicon Graphics may not be used in any advertising or
9 * publicity relating to the software without the specific, prior written
10 * permission of Silicon Graphics.
11 *
12 * THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF
13 * ANY KIND,
14 * EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
15 * WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
16 *
17 * IN NO EVENT SHALL SILICON GRAPHICS BE LIABLE FOR
18 * ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
19 * OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
20 * WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
21 * LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
22 * OF THIS SOFTWARE.
23 */
24
25accum - Accumulation test.
26    - RGBA, SB/DB (SB default).
27    - cmd line options:
28	-sb	Single buffer mode.
29	-db	Double buffer mode.
30    - keys:
31	ESC	Quit
32	1	Use filled polygon mode.
33	2	Use outlined polygon mode.
34
35bitmap1 - Bitmap test.
36    - RGBA/CI (RGBA default), SB/DB (SB default).
37    - cmd line options:
38	-rgb	RGBA mode.
39	-ci	Color index mode.
40	-sb	Single buffer mode.
41	-db	Double buffer mode.
42    - keys:
43	ESC	Quit.
44
45bitmap2 - Bitmap test.
46    - RGBA/CI (RGBA default), SB/DB (SB default).
47    - cmd line options:
48	-rgb	RGBA mode.
49	-ci	Color index mode.
50	-sb	Single buffer mode.
51	-db	Double buffer mode.
52    - keys:
53	ESC	Quit.
54	1	Toggle display list mode.
55	2	Toggle color animation mode.
56
57copy - Pixel copy test.
58    - RGBA, SB/DB (SB default).
59    - cmd line options:
60	-sb		Single buffer mode.
61	-db		Double buffer mode.
62	-dr		Direct render mode.
63	-ir		Indirect render mode.
64	-f <file name>	RGB image file.
65    - keys:
66	ESC		Quit.
67	Z		Increase zoom factor.
68	z		Decrease zoom factor.
69    - mouse input:
70	Left		Copy location.
71
72cursor - Cursor test.
73    - RGBA/CI (RGBA default), SB/DB (SB default).
74    - cmd line options:
75	-rgb	RGBA mode.
76	-ci	Color index mode.
77	-sb	Single buffer mode.
78	-db	Double buffer mode.
79    - keys:
80	ESC	Quit.
81	SPACE	switch cursor color.
82
83depth - Z buffer test.
84    - RGBA/CI (RGBA default), SB/DB (SB default).
85    - cmd line options:
86	-rgb	RGBA mode.
87	-ci	Color index mode.
88	-sb	Single buffer mode.
89	-db	Double buffer mode.
90    - keys:
91	ESC	Quit.
92	1	Toggle anti-aliased mode.
93	2	Toggle stipple mode.
94
95eval - Evaluator test.
96    - RGBA, SB/DB (SB default).
97    - cmd line options:
98	-sb	Single buffer mode.
99	-db	Double buffer mode.
100    - keys:
101	ESC	Quit.
102	LEFT	Rotate.
103	RIGHT	Rotate.
104	UP	Rotate.
105	DOWN	Rotate.
106	1	Toggle dimensions.
107	2	Toggle dimensions.
108	e	Use eval mode.
109	m	Use mesh mode.
110	f	Toggle polygon mode.
111	p	Toggle point mode.
112	c	Toggle color mode.
113	t	Toggle texture mode.
114	l	Toggle lighting mode.
115
116fog - Fog test.
117    - RGBA/CI (RGBA default), SB/DB (SB default).
118    - cmd line options:
119	-rgb	RGBA mode.
120	-ci	Color index mode.
121	-sb	Single buffer mode.
122	-db	Double buffer mode.
123    - keys:
124	ESC	Quit.
125	LEFT	Rotate.
126	RIGHT	Rotate.
127	UP	Rotate.
128	DOWN	Rotate.
129	D	Increase fog density.
130	d	Decrease fog density.
131
132font - font test.
133    - RGBA/CI (RGBA default), SB/DB (SB default).
134    - cmd line options:
135	-rgb	RGBA mode.
136	-ci	Color index mode.
137	-sb	Single buffer mode.
138	-db	Double buffer mode.
139    - keys:
140	ESC	Quit.
141	Left	Shift left.
142	Right	Shift right.
143	Up	Shift up.
144	Down	Shift down.
145	n	Shift in.
146	m	Shift out.
147	q	Scale up x.
148	w	Scale down x.
149	a	Scale up y.
150	s	Scale down y.
151	z	Scale up z.
152	x	Scale down z.
153	e	Rotate clockwise x.
154	r	Rotate counter-clockwise x.
155	d	Rotate clockwise y.
156	f	Rotate counter-clockwise y.
157	c	Rotate clockwise z.
158	v	Rotate counter-clockwise z.
159
160line - Line test.
161    - RGBA/CI (RGBA default), SB/DB (SB default).
162    - cmd line options:
163	-rgb	RGBA mode.
164	-ci	Color index mode.
165	-sb	Single buffer mode.
166	-db	Double buffer mode.
167    - keys:
168	ESC	Quit.
169	W	Increase line width.
170	w	Decrease line width.
171	1	Toggle stipple mode.
172	2	Toggle anti-aliased mode.
173
174logo - Demo.
175    - RGBA/CI (RGBA default), SB/DB (SB default).
176    - cmd line options:
177	-rgb	RGBA mode.
178	-ci	Color index mode.
179	-sb	Single buffer mode.
180	-db	Double buffer mode.
181    - keys:
182	ESC	Quit.
183	LEFT	Rotate.
184	RIGHT	Rotate
185	UP	Move clipping plane.
186	DOWN	Move clipping plane.
187	Z	Translate.
188	z	Translate.
189	1	Use GL_POINT polygon mode.
190	2	Use GL_LINE polygon mode.
191	3	Use GL_FILL polygon mode.
192	p	Toggle polygon fill modes.
193	4	Use GL_NICEST for GL_POLYGON_SMOOTH_HINT.
194	5	Use anti-aliased polygon mode.
195	6	Use aliased polygon mode.
196	8	Toggle dither mode.
197	9	Toggle stipple polygon mode.
198	0	Toggle flat/smooth shading mode.
199	q	Disable cull mode.
200	w	Use front face cull mode.
201	e	Use back face cull mode.
202	r	Use clockwise front face mode.
203	t 	Use counter-clockwise front face mode.
204	y	Use MSB first stipple pattern.
205	u	Use LSB first stipple pattern.
206	a	Use brick texture map.
207	s	Use checker texture map.
208	d	Disable texture map.
209	f	Use decal texture environment mode.
210	g	Use modulate texture environment mode.
211
212nurb - Nurb test.
213    - RGBA, SB/DB (SB default).
214    - cmd line options:
215	-sb	Single buffer mode.
216	-db	Double buffer mode.
217    - keys:
218	ESC	Quit.
219	LEFT	Rotate.
220	RIGHT	Rotate.
221	UP	Rotate.
222	DOWN	Rotate.
223
224olympic - Olymipic rings demo.
225    - RGBA/CI (RGBA default), SB/DB (SB default).
226    - cmd line options:
227	-rgb	RGBA mode.
228	-ci	Color index mode.
229	-sb	Single buffer mode.
230	-db	Double buffer mode.
231    - keys:
232	ESC	Quit.
233	SPACE	Restart demo.
234
235overlay - Overlay plane demo.
236    - RGBA, SB/DB (SB default).
237    - cmd line options:
238	-sb	Single buffer mode.
239	-db	Double buffer mode.
240    - keys:
241	ESC	Quit.
242	SPACE	Toggle star weird movement mode.
243	t	Toggle star turbo mode.
244
245point - Point test.
246    - RGBA/CI (RGBA default), SB/DB (SB default).
247    - cmd line options:
248	-rgb	RGBA mode.
249	-ci	Color index mode.
250	-sb	Single buffer mode.
251	-db	Double buffer mode.
252    - keys:
253	ESC	Quit.
254	LEFT	Translate.
255	RIGHT	Translate.
256	UP	Translate.
257	DOWN	Translate.
258	W	Increase point width.
259	w	Decrease point width.
260	1	Toggle anti-aliased mode.
261
262prim - Primitive test.
263    - RGBA/CI (RGBA default), SB/DB (SB default).
264    - cmd line options:
265	-rgb	RGBA mode.
266	-ci	Color index mode.
267	-sb	Single buffer mode.
268	-db	Double buffer mode.
269    - keys:
270	ESC	Quit.
271	1	Toggle flat/smooth shade mode.
272	2	Toggle outlined/filled polygon mode.
273	3	Toggle color mask mode.
274
275quad - Quadric test.
276    - RGBA/CI (RGBA default), SB/DB (SB default).
277    - cmd line options:
278	-rgb		RGBA mode.
279	-ci		Color index mode.
280	-sb		Single buffer mode.
281	-db		Double buffer mode.
282	-dr		Direct render mode.
283	-ir		Indirect render mode.
284	-f <file name>	texture file.
285    - keys:
286	ESC		Quit.
287	LEFT		Rotate.
288	RIGHT		Rotate.
289	UP		Rotate.
290	DOWN		Rotate.
291	X		Rotate.
292	x		Rotate.
293	1		Use GLU_FILL draw style.
294	2		Use GLU_POINT draw style.
295	3		Use GLU_LINE draw style.
296	4		Use GLU_SILHOUETTE draw style.
297	0		Toggle flat/smooth shade mode.
298	f		Cylce through quadrics.
299	d		Toggle orientation.
300	A		Increase number of stacks.
301	a		Decrease number of stacks.
302	S		Increase number of slices.
303	s		Decrease number of slices.
304	G		Increase radius1.
305	g		Decrease radius1.
306	J		Increase radius2.
307	j		Decrease radius2.
308	H		Increase height.
309	h		Decrease height.
310	K		Increase angle1.
311	k		Decrease angle1.
312	L		Increase angle2.
313	l		Decrease angle2.
314	z		Toggle texture mode.
315	q		Disable cull mode.
316	w		Use front face cull mode.
317	e		Use back face cull mode.
318	r		Use clockwise front face mode.
319	t 		Use counter-clockwise front face mode.
320	y		Toggle dither mode.
321
322select - Selection test.
323    - RGBA, SB.
324    - cmd line options:
325    - keys:
326	ESC	Quit.
327	LEFT	Rotate.
328	RIGHT	Rotate.
329	Z	Increase zoom factor.
330	z	Decrease zoom factor.
331	d	Zoom at current mouse location.
332	f	Print feedback information.
333	l	Toggle outlined/filled polygon mode.
334    - mouse:
335	Left	Recolor selected triangle.
336	Center	Enlarge selected triangle.
337	Right	Delete selected triangle.
338
339shape - shape test.
340    - RGBA/CI (RGBA default), SB/DB (SB default).
341    - cmd line options:
342	-rgb	RGBA mode.
343	-ci	Color index mode.
344	-sb	Single buffer mode.
345	-db	Double buffer mode.
346    - keys:
347	ESC	Quit.
348	Left	Shift left.
349	Right	Shift right.
350	Up	Shift up.
351	Down	Shift down.
352	n	Shift in.
353	m	Shift out.
354	q	Scale up x.
355	w	Scale down x.
356	a	Scale up y.
357	s	Scale down y.
358	z	Scale up z.
359	x	Scale down z.
360	e	Rotate clockwise x.
361	r	Rotate counter-clockwise x.
362	d	Rotate clockwise y.
363	f	Rotate counter-clockwise y.
364	c	Rotate clockwise z.
365	v	Rotate counter-clockwise z.
366	SPACE	switch shapes.
367
368speed - Speed test.
369    - RGBA/CI (RGBA default), SB/DB (SB default).
370    - cmd line options:
371	-rgb	RGBA mode.
372	-ci	Color index mode.
373	-sb	Single buffer mode.
374	-db	Double buffer mode.
375    - keys:
376	ESC	Quit.
377	a	Toggle anti-aliased mode.
378	d	Toggle z buffering mode.
379	f	Toggle fog mode.
380	F	Toggle fog hint mode.
381	s	Toggle flat/smooth shading mode.
382	t	Toggle texturing mode.
383
384sphere - Spheremap test.
385    - RGBA, SB/DB (SB default).
386    - cmd line options:
387	-sb		Single buffer mode.
388	-db		Double buffer mode.
389	-dr		Direct render mode.
390	-ir		Indirect render mode.
391	-f <file name>	texture file.
392	-3		Use RGB components.
393	-4		Use RGBA components.
394    - keys:
395	ESC		Quit.
396        LEFT		Rotate about the y axis.
397        RIGHT		Rotate about the y axis.
398        UP		Rotate about the x axis.
399        DOWN		Rotate about the x axis.
400        a		Toggle auto rotate mode.
401        c		toggle between cylinder or cube object.
402        t		Use torus object.
403        d		Use decal texture mode.
404      	m		Use modulate texture mode.
405        l		Toggle lighted mode.
406        f		Toggle fog mode.
407        0		Use nearest magification filter.
408        1		Use linear magification.
409        2		Use nearest minification filter.
410        3		Use linear minification filter. 
411        4		Use nearest-mipmap-nearest minification filter. 
412        5		Use nearest-mipmap-linear minification filter. 
413        6		Use linear-mipmap-nearest minification filter. 
414        7		Use linear-mipmap-linear minification filter. 
415
416star - Demo.
417    - RGBA, SB/DB (SB default).
418    - cmd line options:
419	-sb	Single buffer mode.
420	-db	Double buffer mode.
421    - keys:
422	ESC	Quit.
423	SPACE	Toggle weird movement mode.
424	t	Toggle turbo mode.
425
426stencil - Stencil test.
427    - RGBA, SB.
428    - cmd line options:
429
430stretch - Texture test.
431    - RGBA, SB.
432    - cmd line options:
433	-sb		Single buffer mode.
434	-db		Double buffer mode.
435	-dr		Direct render mode.
436	-ir		Indirect render mode.
437	-f <file name>	texture file.
438    - keys:
439	ESC		Quit.
440	SPACE		Start animation.
441    - mouse:
442	Left		Added stretch point.
443
444texture - Texture test.
445    - RGBA, SB/DB (SB default).
446    - cmd line options:
447	-sb		Single buffer mode.
448	-db		Double buffer mode.
449	-dr		Direct render mode.
450	-ir		Indirect render mode.
451	-f <file name>	texture file.
452    - keys:
453	ESC		Quit.
454	LEFT		Rotate.
455	RIGHT		Rotate.
456	UP		Rotate.
457	DOWN		Rotate.
458	T		Translate.
459	t		Translate.
460	s		Toggle sphere map mode.
461	0		Use nearest magification filter.
462	1		Use linear magification filter.
463	2		Use nearest minification filter.
464	3		Use linear minification filter.
465	4		Use nearest-mipmap-nearest minification filter.
466	5		Use nearest-mipmap-linear minification filter.
467	6		Use linear-mipmap-nearest minification filter.
468	7		Use linear-mipmap-linear minification filter.
469
470tri - Triangle test.
471    - RGBA/CI (RGBA default), SB/DB (SB default).
472    - cmd line options:
473	-rgb	RGBA mode.
474	-ci	Color index mode.
475	-sb	Single buffer mode.
476	-db	Double buffer mode.
477    - keys:
478	ESC	Quit.
479	LEFT	Translate.
480	RIGHT	Translate.
481	Z	Increase zoom factor.
482	z	Decrease zoom factor.
483	1	Use point polygon mode.
484	2	Use line polygon mode.
485	3	Use filled polygon mode.
486	4	Use point primitive.
487	5	Use line-loop primitive.
488	6	Use polygon primitive.
489	7	Toggle cull mode.
490	8	Use clockwise/counter-clockwise front face mode.
491	9	Toggle front/back face cull mode.
492	v	Toggle show verticies mode.
493	s	Toggle flat/smooth shade mode.
494	h	Toggle hide bottom triangle mode.
495	o	Toggle outline mode.
496	m	Toggle dither mode.
497	0	Toggle anti-aliased mode.
498
499wave - Demo.
500    - RGBA/CI (RGBA default), SB/DB (SB default).
501    - cmd line options:
502	-rgb		RGBA mode.
503	-ci		Color index mode.
504	-sb		Single buffer mode.
505	-db		Double buffer mode.
506	-dr		Direct render mode.
507	-ir		Indirect render mode.
508	-grid <x> <y>	Number of grids.
509	-size <number>	Size of grid.
510	-wave <number>	Height of wave (floating point number).
511	-frames <count>	Number of frames.
512    - keys:
513	ESC		Quit.
514	c		Toggle contouring mode.
515	s		Toggle flat/smooth shade mode.
516	l		Toggle lighting mode.
517	d		Toggle depth checking mode.
518	SPACE		Toggle step/animation mode.
519	n		Single step in step mode.
520	a		Toggle spin mode.
521