summaryrefslogtreecommitdiffstats
path: root/hacks/glx/crackberg.man
blob: 5183baa326ffb2029e0d7919a6eb4428a22a4db3 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
.TH XScreenSaver 1 "" "X Version 11"
.SH NAME
crackberg - Lose your way wandering some height fields, and enjoy candy.
.SH SYNOPSIS
.B crackberg
[\-root]
[\-window]
[\-install]
[\-display \fIhost:display.screen\fP]
[\-visual \fIvisual\fP]
[\-window-id \fIid\fP]
[\-delay \fIusecs\fP]
[\-fps]
[\-crack]
[\-lit]
[\-boring]
[\-letterbox]
[\-flat]
[\-wire]
[\-nowater]
[\-visibility \fIfloat\fP]
[\-color \fIstring\fP]
[\-nsubdivs \fIinteger\fP]
.SH DESCRIPTION
Flies through height maps, optionally animating the instantiation and
destruction of generated tiles; by default, tiles 'grow' into place (height
gradually increased up to correct value).  In windowed mode the following key
controls are available:
.TP 8
.B left, right
Turn left and right.
.TP 8
.B a,w,s,d
Move left, forwards, backwards, and to the right, respectively.
.TP 8
.B 1,2
Decrease and increase manual speed, respectively.
.TP 8
.B Spacebar
Return to automatic control.
.SH OPTIONS
.I crackberg
accepts the following options:
.TP 8
.B \-root
Draw on the root window.
.TP 8
.B \-window
Draw on a newly-created window.  This is the default.
.TP 8
.B \-install
Install a private colormap for the window.
.TP 8
.B \-visual \fIvisual\fP
Specify which visual to use.  Legal values are the name of a visual
class, or the id number (decimal or hex) of a specific visual.
.TP 8
.B \-delay \fImicroseconds\fP
Delay between frames; default 20000 (1/50th of a second).
.TP 8
.B \-fps
Display the current frame rate, CPU load, and polygon count.
.TP 8
.B \-crack
Use all possible methods to animate tile instantiation.
.TP 8
.B \-boring
Do not animate instatiation at all; use this to get standard landscape 
generator behavior.
.TP 8
.B \-letterbox
Drawable window region has a 16:9 aspect ratio, regardless of actual
window size.
.TP 8
.B \-lit
Enable lighting.
.TP 8
.B \-flat
Flat shading (OpenGL will use one color per primitive, rather than
interpolating betwixt vertices).
.TP 8
.B \-wire
Wireframe.
.TP 8
.B \-nowater
Do not display 'water' (forces negative values to zero, and selects a 
different coloring method).
.TP 8
.B \-visibility \fIfloat\fP
Value in range [0.2,1.0] (default 0.6) specifying proportion of viewable 
XY plane which is to be drawn upon.
.TP 8
.B \-color \fIstring\fP
Selects color scheme.  Use with no or bogus argument for current list.
.TP 8
.B \-nsubdivs \fIinteger\fP
Number of times to recursively subdivide each triangular tile.  Each 
increment increases total triangles by a factor of 4; for instance the default
setting 4 results in 256 triangles per tile.

.SH ENVIRONMENT
.PP
.TP 8
.B DISPLAY
to get the default host and display number.
.TP 8
.B XENVIRONMENT
to get the name of a resource file that overrides the global resources
stored in the RESOURCE_MANAGER property.
.SH SEE ALSO
.BR X (1),
.BR xscreensaver (1)
.SH COPYRIGHT
Copyright \(co 2005 by Matus Telgarsky.  Permission to use, copy,
modify, distribute, and sell this software and its documentation for
any purpose is hereby granted without fee, provided that the above
copyright notice appear in all copies and that both that copyright
notice and this permission notice appear in supporting documentation.
No representations are made about the suitability of this software for
any purpose.  It is provided "as is" without express or implied
warranty.
.SH AUTHOR
Matus Telgarsky <catachresis@cmu.edu>, 2005.