From http://www.jwz.org/xscreensaver/xscreensaver-5.23.tar.gz
[xscreensaver] / hacks / glx / polytopes.man
index 71d2aaeb79d3f38720c2d63b0b16ef41079ba009..45fcb4a88da62a12ee78a39268a5b26a60a8cf6f 100644 (file)
@@ -16,7 +16,7 @@ polytopes - Draws one of the six regular 4d polytopes rotating in 4d.
 [\-24-cell]
 [\-120-cell]
 [\-600-cell]
-[\-mesh]
+[\-wireframe]
 [\-surface]
 [\-transparent]
 [\-single-color]
@@ -109,14 +109,14 @@ regular tetrahedra as its cells, 1200 equilateral triangles as faces,
 The following three options are mutually exclusive.  They determine
 how the polytope is displayed.
 .TP 8
-.B \-mesh
-Display the polytope as a wireframe mesh (default).
+.B \-wireframe
+Display the polytope as a wireframe mesh.
 .TP 8
 .B \-surface
 Display the polytope as a solid object.
 .TP 8
 .B \-transparent
-Display the polytope as a transparent object.
+Display the polytope as a transparent object (default).
 .PP
 The following two options are mutually exclusive.  They determine how
 to color the polytope.
@@ -154,10 +154,10 @@ 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-xw \fIfloat\fP
+.B \-speed-wx \fIfloat\fP
 Rotation speed around the wx plane (default: 1.1).
 .TP 8
-.B \-speed-xy \fIfloat\fP
+.B \-speed-wy \fIfloat\fP
 Rotation speed around the wy plane (default: 1.3).
 .TP 8
 .B \-speed-wz \fIfloat\fP
@@ -171,6 +171,17 @@ 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).
+.SH INTERACTION
+If you run this program in standalone mode you can rotate the polytope
+by dragging the mouse while pressing the left mouse button.  This
+rotates the polytope 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 polytope is rotated in 4D, i.e., around the xy, xz,
+and yz planes.  To examine the polytope at your leisure, it is best to
+set all speeds to 0.  Otherwise, the polytope will rotate while the
+left mouse button is not pressed.
+.B \-fps
+Display the current frame rate, CPU load, and polygon count.
 .SH ENVIRONMENT
 .PP
 .TP 8
@@ -184,7 +195,7 @@ stored in the RESOURCE_MANAGER property.
 .BR X (1),
 .BR xscreensaver (1)
 .SH COPYRIGHT
-Copyright \(co 2003 by Carsten Steger.  Permission to use, copy,
+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
@@ -193,4 +204,4 @@ 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>, 10-aug-2003.
+Carsten Steger <carsten@mirsanmir.org>, 28-sep-2005.