Provided by: xscreensaver-gl_5.04-4ubuntu1_i386 bug

NAME

       topblock - a 3D world of falling blocks that build up and up.

SYNOPSIS

       topblock  [-display  host:display.screen]  [-visual  visual]  [-window]
       [-root] [-delay number]  [-wireframe]  [-fps]  [-size  number]  [-spawn
       number]  [-camX  number]  [-camY number] [-camZ number] [-rotate] [-no-
       carpet]   [-no-nipples]   [-blob]   [-rotateSpeed   number]   [-follow]
       [-maxFalling   number]   [-resolution   number]   [-maxColors   number]
       [-dropSpeed number] [-override]

DESCRIPTION

       Creates a world of falling blocks that build up and up.

OPTIONS

       -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 Draw on a newly-created window.  This is the default.

       -root   Draw on the root window.

       -delay number
               Per-frame  delay,  in  microseconds.   Default:   10000   (0.01
               seconds.).

       -wireframe | -no-wireframe
               Render in wireframe instead of solid.

       -fps | -no-fps
               Whether  to  show  a frames-per-second display at the bottom of
               the screen.

       -size number
               Size of the base/carpet.

       -spawn number
               Likeyhood of a new block being created per frame : 1 high, 1000
               very low.

       -camX number
               Initial camera X location in the world.

       -camY number
               Initial camera Y location in the world.

       -camZ number
               Initial camera Z location in the world.

       -rotate | -no-rotate
               Add/Remove rotation to/from the animation.

       -no-carpet
               Remove the base/carpet.

       -no-nipples
               Remove  nipples  on the blocks (also applies to udders) (has no
               effect in blob mode).

       -blob   Run in blob mode, blocks become over sized spheres.

       -rotateSpeed number
               Varries speed of world rotation.

       -follow Camera follows blocks as they fall instead of camera being semi
               static (stays with top block).

       -maxFalling number
               Maximum number of objects created before recycling occurs.

       -resolution number
               Resolution of tubes, disks and spheres.

       -maxColors number
               Number of different colors available to falling objects.

       -dropSpeed number
               Varries speed of falling objects.

       -override
               Overrides camera settings and provides a tunnel view.

KEYS

       a       Increases viewing X coordinate.

       z       Decreases viewing X coordinate.

       s       Increases viewing Y coordinate.

       x       Decreases viewing Y coordinate.

       d       Increases viewing Z coordinate.

       c       Decreases  viewing  Z  coordinate.   TP  8  f  Increases camera
               location X coordinate.

       v       Decreases camera location X coordinate.

       g       Increases camera location Y coordinate.

       b       Decreases camera location Y coordinate.

       h       Increases camera location Z coordinate.

       n       Decreases camera location Z coordinate.

       r       Increases world rotation.

       q       quit.

EXAMPLES

       To see which block follow-mode is tracking, set  the  number  of  block
       colors to 1.

       topblock -follow -maxColors 1

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  ©  2006  by  rednuht.   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

       rednuht                       <topblock.xscreensaver@jumpstation.co.uk>
       <http://www.jumpstation.co.uk/xscreensaver/topblock/>