NAME

       jigglypuff - save your screen by tormenting your eyes.

SYNOPSIS

       jigglypuff  [--display  host:display.screen]  [--visual  visual] [--window] [--root] [--window-id number]
       [-delay number] [-cycles number] [-wireframe] [-fps] [-color colorspec] [-spooky] [-complexity n] [-speed
       n] [-spherism n] [-hold n] [-distance n] [-damping n]

DESCRIPTION

       This draws all manners of obscene, spastic, puffy, vaguely ball-shaped objects orbiting lazily about  the
       screen, with a dizzying array of mostly pointless options.

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.

       --window-id number
               Draw on the specified window.

       --delay number
               Per-frame delay, in microseconds.  Default: 20000 (0.02 seconds.).

       --wireframe
               Render in wireframe instead of solid. Default: render solid.

       --fps   Display the current frame rate, CPU load, and polygon count.

       -tetra | -no-tetra
               Whether to start the shape in the form of a tetrahedron. The default is to start as a sphere.

       -color colorspec
               Available options for colorspec are: cycle, flowerbox, clownpuke,  chrome  and  #xxxxxx  (i.e  an
               (old-style) X color specification.) Default: cycle

       -spooky n
               This  option  controls a kind of interesting effect obtained by using unnormalized normal vectors
               (how's that for an oxymoron?) in OpenGL.  A value of zero disables the effect. Other values  vary
               the lengths of the normals proportionally.  Okay, so it's not very spooky. Sue me.  Default: 0

       -complexity n
               Valid  options  are  1,  2,  and  3. Everything else is treated as though it were 2, which is the
               default. This controls the number of polygons in the 'thing'. A value of 1 yields 1024,  and  the
               values go up in powers of 4. (i.e. 4096, 16384.)
                note:  There  is an inherent lack of stability at lower complexity, which can cause the shape to
               devolve into a 'flying snotrag'.

       -speed n
               Controls how fast the blob moves around the screen. Default: 500.

       -spherism, -hold, -distance, -damping
               These options control the 'jigglyness'.  The  best  way  to  explain  these  is  to  explain  how
               jigglypuff  works. Basically, the shape is a tetrahedron whose faces are subdivided into a number
               of triangles, forming a mesh.  Each of the vertices of the mesh has two different forces  applied
               to it: one proportional to its distance from the surface of a sphere, and one proportional to the
               difference  of  the  distance  to each of its neighbors in the mesh to a given ideal distance. In
               short, one tries to move the points into the configuration of a sphere, and the  other  tries  to
               push  them  back  into  a  tetrahedron. The catch is that the points have inertia, so they always
               overshoot their target, and hence they oscillate. The magnitudes of the two forces is  controlled
               by the options 'spherism' and ´hold'; 'distance' specifies the distance the vertices seek to keep
               from  their  neighbors, with 500 corresponding to the size of the start tetrahedron.  e.g. if you
               were to give the options '-tetra -spherism 0 -distance 500', you  would  end  up  with  a  stable
               tetrahedron.  The 'damping' option can help to keep the blob from collapsing or flying apart. The
               option specifies the speed at which  damping  starts,  hence  lower  values  mean  more  damping.
               Defaults: spherism: 75; hold: 800; distance: 100; damping: 500.

       -random Probably  the  only parameter you'l ever need. Overrides almost all of the parameters with random
               values. The values affected  are:  speed,  spherism,  hold,  distance,  damping,  spooky,  color,
               wireframe and tetra.  Default: off

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.

       XSCREENSAVER_WINDOW
               The window ID to use with --root.

SEE ALSO

       X(1), xscreensaver(1)

COPYRIGHT

       Copyright © 2003 by Keith Macleod.  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

       By Keith Macleod

X Version 11                                   6.08 (10-Oct-2023)                                 jigglypuff(6x)