juggler3d (6)

Leading comments

** The above line should force tbl to be used as a preprocessor **

(The comments found at the beginning of the groff file "man6/juggler3d.6x".)

NAME

juggler3d - juggling man screen saver.

SYNOPSIS

juggler3d [-display host:display.screen ] [-root ] [-window ] [-mono ] [-install | -noinstall ] [-visual visual ] [-window-id id ] [-pattern pattern ] [-tail number ] [-real | -no-real ] [-describe | -no-describe ] [-balls | -no-balls ] [-clubs | -no-clubs ] [-torches | -no-torches ] [-knives | -no-knives ] [-rings | -no-rings ] [-bballs | -no-bballs ] [-count count ] [-cycles cycles ] [-delay delay ] [-ncolors ncolors ] [-fps]

DESCRIPTION

Draws a stick-man juggling various collections of objects.

OPTIONS

juggler3d accepts the following options:

-display host:display.screen

X11 display to use. Overrides DISPLAY environment variable.

-root

Draw on the root window.

-window

Draw on a newly-created X window. This is the default.

-mono

Draw in monochrome.

-install | -noinstall

Turn on/off installing colormap.

-visual visual

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.

-window-id id

Draw on an already existing X window.

-pattern dq pattern dq

Specify juggling pattern in annotated site-swap notation. In site-swap notation, the "height" of each throw is given. E.g., "3" is the height needed to juggle a 3-Cascade. Note that these sequences need to be chosen carefully, to avoid collisions.
Annotations indicate relative hand movements or tricks:

-	Inside throw (default)
+	Outside throw
=	Cross Throw
&	Cross Catch
x	Cross Throw and Catch
_	Bounce

-pattern dq[ pattern ]dq

Specify juggling pattern in annotated Adam notation. Adam notation is a little harder to visualize. Each integer n represents a cyclic permutation of (0...n). The equivalent site-swap value is determined by calculating how many of the permutations it takes to get back to the identity. The largest number used is the same as the number of objects in the pattern. The advantage of Adam notation is that these sequences do not need to be chosen carefully, since all possible sequences are juggle-able. Annotations are the same as in site-swap notation.
For example, both of these describe a 3-Shower:

-pattern +5 1

-pattern [+3 1]
For further examples, see the portfolio list in the source code.

-tail number

Minimum Trail Length. 0 - 100. Default: 1. Objects may override this, for example flaming torches always leave a trail.

-real|-no-real

Turn on/off real-time juggling. Deprecated. There should be no need to turn off real-time juggling, even on slow systems. Adjust speed using -count above.

-describe|-no-describe

Turn on/off pattern descriptions.

-balls|-no-balls

Turn on/off Balls.

-clubs|-no-clubs

Turn on/off Clubs.

-torches|-no-torches

Turn on/off Flaming Torches.

-knives|-no-knives

Turn on/off Knives.

-rings|-no-rings

Turn on/off Rings.

-bballs|-no-bballs

Turn on/off Bowling Balls.

-count number

Speed. 50 - 1000. Default: 200. This determines the expected time interval between a throw and the next catch, in milliseconds.

-cycles number

Performance Length. 50 - 1000. Default: 1000. Setting this smaller will force the juggler to switch patterns (and objects) more often.

-delay delay

Additional delay between frames, in microseconds. Default: 10000. Deprecated. Adjust speed using -count.

-ncolors ncolors

Maximum number of colors to use. Default: 32.

-fps

Display the current frame rate and CPU load.

ENVIRONMENT

DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

SEE ALSO

X(1), xscreensaver(1)

COPYRIGHT

Copyright © 1996,2000,2002,2004 by Tim Auckland. 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.

AUTHOR

Tim Auckland.
Converted to OpenGL by Jamie Zawinski, 2009.