boxfit



XScreenSaver(1)                                                XScreenSaver(1)




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]


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.)


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) xscreensaver-demo(1), xscreensaver-getimage(1)


COPYRIGHT

       Copyright  ©  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>



X Version 11                                                   XScreenSaver(1)

Man(1) output converted with man2html