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
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
|
.TH XScreenSaver 1 "" "X Version 11"
.SH NAME
hypertorus - Draws a hypertorus that rotates in 4d
.SH SYNOPSIS
.B hypertorus
[\-display \fIhost:display.screen\fP]
[\-install]
[\-visual \fIvisual\fP]
[\-window]
[\-root]
[\-delay \fIusecs\fP]
[\-fps]
[\-wireframe]
[\-surface]
[\-transparent]
[\-solid]
[\-bands]
[\-spirals-{1,2,4,8,16}]
[\-twosided]
[\-colorwheel]
[\-perspective-3d]
[\-orthographic-3d]
[\-perspective-4d]
[\-orthographic-4d]
[\-speed-wx \fIfloat\fP]
[\-speed-wy \fIfloat\fP]
[\-speed-wz \fIfloat\fP]
[\-speed-xy \fIfloat\fP]
[\-speed-xz \fIfloat\fP]
[\-speed-yz \fIfloat\fP]
.SH DESCRIPTION
The \fIhypertorus\fP program shows the Clifford torus as it rotates in
4d. The Clifford torus is a torus lies on the "surface" of the
hypersphere in 4d. The program projects the 4d torus to 3d using
either a perspective or an orthographic projection. Of the two
alternatives, the perspective projection looks much more appealing.
In orthographic projections the torus degenerates into a doubly
covered cylinder for some angles. The projected 3d torus can then be
projected to the screen either perspectively or orthographically.
There are three display modes for the torus: mesh (wireframe), solid,
or transparent. Furthermore, the appearance of the torus can be as a
solid object or as a set of see-through bands or see-through spirals.
Finally, the colors with with the torus is drawn can be set to either
two-sided or to a color wheel. In the first case, the torus is drawn
with red on the outside and green on the inside. This mode enables
you to see that the torus turns inside-out as it rotates in 4d. The
second mode draws the torus with a fully saturated color wheel. This
gives a very nice effect when combined with the see-through bands or
see-through spirals mode. The rotation speed for each of the six
planes around which the torus rotates can be chosen. This program is
very much inspired by Thomas Banchoff's book "Beyond the Third
Dimension: Geometry, Computer Graphics, and Higher Dimensions",
Scientific American Library, 1990.
.SH OPTIONS
.I hypertorus
accepts the following options:
.TP 8
.B \-window
Draw on a newly-created window. This is the default.
.TP 8
.B \-root
Draw on the root window.
.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
How much of a delay should be introduced between steps of the
animation. Default 25000, or 1/40th second.
.PP
The following three options are mutually exclusive. They determine
how the torus is displayed.
.TP 8
.B \-wireframe
Display the torus as a wireframe mesh.
.TP 8
.B \-surface
Display the torus as a solid surface (default).
.TP 8
.B \-transparent
Display the torus as a transparent surface.
.PP
The following seven options are mutually exclusive. They determine the
appearance of the torus.
.TP 8
.B \-solid
Display the torus as a solid object.
.TP 8
.B \-bands
Display the torus as see-through bands (default).
.TP 8
.B \-spirals-1, \-spirals-2, \-spirals-4, \-spirals-8, \-spirals-16
Display the torus as see-through spirals with the indicated number of
spirals.
.PP
The following two options are mutually exclusive. They determine how
to color the torus.
.TP 8
.B \-twosided
Display the torus with two colors: red on the outside and green on
the inside.
.TP 8
.B \-colorwheel
Display the torus with a fully saturated color wheel (default). If
the torus is displayed as see-through bands each band will be
displayed with a different color. Likewise, if the torus is displayed
as see-through spirals each spiral will receive a different color.
.PP
The following two options are mutually exclusive. They determine how
the torus is projected from 3d to 2d (i.e., to the screen).
.TP 8
.B \-perspective-3d
Project the torus from 3d to 2d using a perspective projection
(default).
.TP 8
.B \-orthographic-3d
Project the torus from 3d to 2d using an orthographic projection.
.PP
The following two options are mutually exclusive. They determine how
the torus is projected from 4d to 3d.
.TP 8
.B \-perspective-4d
Project the torus from 4d to 3d using a perspective projection
(default).
.TP 8
.B \-orthographic-4d
Project the torus from 4d to 3d using an orthographic projection.
.PP
The following six options determine the rotation speed of the torus
around the six possible hyperplanes. The rotation speed is measured
in degrees per frame. The speeds should be set to relatively small
values, e.g., less than 4 in magnitude.
.TP 8
.B \-speed-wx \fIfloat\fP
Rotation speed around the wx plane (default: 1.1).
.TP 8
.B \-speed-wy \fIfloat\fP
Rotation speed around the wy plane (default: 1.3).
.TP 8
.B \-speed-wz \fIfloat\fP
Rotation speed around the wz plane (default: 1.5).
.TP 8
.B \-speed-xy \fIfloat\fP
Rotation speed around the xy plane (default: 1.7).
.TP 8
.B \-speed-xz \fIfloat\fP
Rotation speed around the xz plane (default: 1.9).
.TP 8
.B \-speed-yz \fIfloat\fP
Rotation speed around the yz plane (default: 2.1).
.TP 8
.B \-fps
Display the current frame rate, CPU load, and polygon count.
.SH INTERACTION
If you run this program in standalone mode you can rotate the
hypertorus by dragging the mouse while pressing the left mouse button.
This rotates the hypertorus in 3D, i.e., around the wx, wy, and wz
planes. If you press the shift key while dragging the mouse with the
left button pressed the hypertorus is rotated in 4D, i.e., around the
xy, xz, and yz planes. To examine the hypertorus at your leisure, it
is best to set all speeds to 0. Otherwise, the hypertorus will rotate
while the left mouse button is not pressed.
.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 2003-2005 by Carsten Steger. 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
Carsten Steger <carsten@mirsanmir.org>, 28-sep-2005.
|
