bionic (6) juggler3d.6x.gz

Provided by: xscreensaver-gl-extra_5.36-1ubuntu1_amd64 bug

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 " pattern "
               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 "[ pattern ]"
               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  ©  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.