Provided by: xscreensaver-data-extra_5.08-0ubuntu3_i386 bug
 

NAME

        boxfit - fills space with a gradient of growing boxes or circles.
 

SYNOPSIS

        boxfit   [-display   host:display.screen]  [-visual  visual]  [-window]
        [-root] [-delay usecs] [-count int] [-growby int] [-spacing int] [-bor-
        der int] [-circles | -squares | -random] [-grab] [-peek] [-fps]
 

DESCRIPTION

        Packs  the screen with growing boxes or circles, colored according to a
        horizontal or vertical gradient.  The objects grow  until  they  touch,
        then  stop.   When the screen is full, they shrink away and the process
        restarts.
 

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 microseconds
                How much of a delay should be introduced between steps  of  the
                animation.  Default 20000, or about 0.02 seconds.
 
        -count int
                How  many  boxes  or circles to animate simultaneously; default
                50.  Smaller numbers yield larger boxes/circles.
 
        -growby int
                How many  pixels  the  objects  should  grow  by,  each  frame.
                Default 1.
 
        -spacing int
                How  many  pixels  of space should be left between the objects.
                Default 1.
 
        -border int
                Thickness of the colored border around each object.  Default 1.
 
        -circles | -squares | -random
                Draw circles, squares, or choose randomly (the default).
 
        -grab   Normally it colors the boxes with a horizontal or vertical gra-
                dient.  If -grab is specified, it will instead  load  a  random
                image,  and  color  the  boxes  according to the colors in that
                image.  As the picture fills in, some features of the  underly-
                ing image may become recognisable.
 
                When  grabbing  images, the image will be grabbed from the por-
                tion of the screen underlying the window, or from the  system's
                video input, or from a random file on disk, as indicated by the
                grabDesktopImages,  grabVideoFrames,   and   chooseRandomImages
                options  in  the ~/.xscreensaver file; see xscreensaver-demo(1)
                for more details.
 
        -peek   This option says to  briefly  show  you  the  underlying  image
                before beginning.  The default is not to show the unadulterated
                image at all.  (This only has an effect when -grab is used.)
 
        -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.
        X(1), xscreensaver(1) xscreensaver-demo(1), xscreensaver-getimage(1)
 

COPYRIGHT

        Copyright (C) 2005 by Jamie Zawinski.  Permission to use, copy, modify,
        distribute, and sell this software and its documentation for  any  pur-
        pose  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 repre-
        sentations are made about the suitability of this software for any pur-
        pose.  It is provided "as is" without express or implied warranty.
 

AUTHOR

        Jamie Zawinski <jwz@jwz.org>