summaryrefslogtreecommitdiffstats
path: root/hacks/glx/romanboy.man
diff options
context:
space:
mode:
Diffstat (limited to 'hacks/glx/romanboy.man')
-rw-r--r--hacks/glx/romanboy.man110
1 files changed, 66 insertions, 44 deletions
diff --git a/hacks/glx/romanboy.man b/hacks/glx/romanboy.man
index 2957a0e..e4e947b 100644
--- a/hacks/glx/romanboy.man
+++ b/hacks/glx/romanboy.man
@@ -20,9 +20,11 @@ smoothly deforms between the Roman surface and the Boy surface.
[\-distance-bands]
[\-direction-bands]
[\-colors \fIcolor-scheme\fP]
+[\-onesided-colors]
[\-twosided-colors]
[\-distance-colors]
[\-direction-colors]
+[\-change-colors]
[\-view-mode \fIview-mode\fP]
[\-walk]
[\-turn]
@@ -59,26 +61,27 @@ non-orientable).
The real projective plane is a model for the projective geometry in 2d
space. One point can be singled out as the origin. A line can be
singled out as the line at infinity, i.e., a line that lies at an
-infinite distance to the origin. The line at infinity is
-topologically a circle. Points on the line at infinity are also used
-to model directions in projective geometry. The origin can be
-visualized in different manners. When using distance colors, the
-origin is the point that is displayed as fully saturated red, which is
-easier to see as the center of the reddish area on the projective
-plane. Alternatively, when using distance bands, the origin is the
-center of the only band that projects to a disk. When using direction
-bands, the origin is the point where all direction bands collapse to a
-point. Finally, when orientation markers are being displayed, the
-origin the the point where all orientation markers are compressed to a
-point. The line at infinity can also be visualized in different ways.
-When using distance colors, the line at infinity is the line that is
-displayed as fully saturated magenta. When two-sided colors are used,
-the line at infinity lies at the points where the red and green
-"sides" of the projective plane meet (of course, the real projective
-plane only has one side, so this is a design choice of the
-visualization). Alternatively, when orientation markers are being
-displayed, the line at infinity is the place where the orientation
-markers change their orientation.
+infinite distance to the origin. The line at infinity, like all lines
+in the projective plane, is topologically a circle. Points on the
+line at infinity are also used to model directions in projective
+geometry. The origin can be visualized in different manners. When
+using distance colors (and using static colors), the origin is the
+point that is displayed as fully saturated red, which is easier to see
+as the center of the reddish area on the projective plane.
+Alternatively, when using distance bands, the origin is the center of
+the only band that projects to a disk. When using direction bands,
+the origin is the point where all direction bands collapse to a point.
+Finally, when orientation markers are being displayed, the origin the
+the point where all orientation markers are compressed to a point.
+The line at infinity can also be visualized in different ways. When
+using distance colors (and using static colors), the line at infinity
+is the line that is displayed as fully saturated magenta. When
+two-sided (and static) colors are used, the line at infinity lies at
+the points where the red and green "sides" of the projective plane
+meet (of course, the real projective plane only has one side, so this
+is a design choice of the visualization). Alternatively, when
+orientation markers are being displayed, the line at infinity is the
+place where the orientation markers change their orientation.
.PP
Note that when the projective plane is displayed with bands, the
orientation markers are placed in the middle of the bands. For
@@ -114,23 +117,27 @@ origin) is a Moebius strip, which also shows that the projective plane
is non-orientable.
.PP
Finally, the colors with with the projective plane is drawn can be set
-to two-sided, distance, or direction. In two-sided mode, the
-projective plane is drawn with red on one "side" and green on the
-"other side". As described above, the projective plane only has one
-side, so the color jumps from red to green along the line at infinity.
-This mode enables you to see that the projective plane is
-non-orientable. In distance mode, the projective plane is displayed
-with fully saturated colors that depend on the distance of the points
-on the projective plane to the origin. The origin is displayed in
-red, the line at infinity is displayed in magenta. If the projective
-plane is displayed as distance bands, each band will be displayed with
-a different color. In direction mode, the projective plane is
-displayed with fully saturated colors that depend on the angle of the
-points on the projective plane with respect to the origin. Angles in
-opposite directions to the origin (e.g., 15 and 205 degrees) are
-displayed in the same color since they are projectively equivalent.
-If the projective plane is displayed as direction bands, each band
-will be displayed with a different color.
+to one-sided, two-sided, distance, or direction. In one-sided mode,
+the projective plane is drawn with the same color on both "sides." In
+two-sided mode (using static colors), the projective plane is drawn
+with red on one "side" and green on the "other side." As described
+above, the projective plane only has one side, so the color jumps from
+red to green along the line at infinity. This mode enables you to see
+that the projective plane is non-orientable. If changing colors are
+used in two-sided mode, changing complementary colors are used on the
+respective "sides." In distance mode, the projective plane is
+displayed with fully saturated colors that depend on the distance of
+the points on the projective plane to the origin. If static colors
+are used, the origin is displayed in red, while the line at infinity
+is displayed in magenta. If the projective plane is displayed as
+distance bands, each band will be displayed with a different color.
+In direction mode, the projective plane is displayed with fully
+saturated colors that depend on the angle of the points on the
+projective plane with respect to the origin. Angles in opposite
+directions to the origin (e.g., 15 and 205 degrees) are displayed in
+the same color since they are projectively equivalent. If the
+projective plane is displayed as direction bands, each band will be
+displayed with a different color.
.PP
The rotation speed for each of the three coordinate axes around which
the projective plane rotates can be chosen.
@@ -230,18 +237,23 @@ to color the projective plane.
.B \-colors random
Display the projective plane with a random color scheme (default).
.TP 8
+.B \-colors onesided \fP(Shortcut: \fB\-onesided-colors\fP)
+Display the projective plane with a single color.
+.TP 8
.B \-colors twosided \fP(Shortcut: \fB\-twosided-colors\fP)
-Display the projective plane with two colors: red on one "side" and
-green on the "other side." Note that the line at infinity lies at the
+Display the projective plane with two colors: one color one "side" and
+the complementary color on the "other side." For static colors, the
+colors are red and green. Note that the line at infinity lies at the
points where the red and green "sides" of the projective plane meet,
i.e., where the orientation of the projective plane reverses.
.TP 8
.B \-colors distance \fP(Shortcut: \fB\-distance-colors\fP)
Display the projective plane with fully saturated colors that depend
on the distance of the points on the projective plane to the origin.
-The origin is displayed in red, the line at infinity is displayed in
-magenta. If the projective plane is displayed as distance bands, each
-band will be displayed with a different color.
+For static colors, the origin is displayed in red, while the line at
+infinity is displayed in magenta. If the projective plane is
+displayed as distance bands, each band will be displayed with a
+different color.
.TP 8
.B \-colors direction \fP(Shortcut: \fB\-direction-colors\fP)
Display the projective plane with fully saturated colors that depend
@@ -251,6 +263,16 @@ degrees) are displayed in the same color since they are projectively
equivalent. If the projective plane is displayed as direction bands,
each band will be displayed with a different color.
.PP
+The following options determine whether the colors with which the
+projective plane is displayed are static or are changing dynamically.
+.TP 8
+.B \-change-colors
+Change the colors with which the projective plane is displayed
+dynamically.
+.TP 8
+.B \-no-change-colors
+Use static colors to display the projective plane (default).
+.PP
The following three options are mutually exclusive. They determine
how to view the projective plane.
.TP 8
@@ -378,7 +400,7 @@ stored in the RESOURCE_MANAGER property.
.BR X (1),
.BR xscreensaver (1)
.SH COPYRIGHT
-Copyright \(co 2013-2014 by Carsten Steger. Permission to use, copy,
+Copyright \(co 2013-2020 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
@@ -387,4 +409,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>, 03-oct-2014.
+Carsten Steger <carsten@mirsanmir.org>, 06-jan-2020.