boing(6x)

NAME
boing - draws a bouncing ball like the ancient Amiga demo

SYNOPSIS
boing [--display host:display.screen] [--window] [--root] [--window-id number][--install] [--visual visual] [--delay usecs] [--smooth] [--lighting] [--scanlines] [--speed] [--no-spin] [--angle degrees] [--size ratio] [--parallels n] [--meridians n] [--wireframe] [--fps]

DESCRIPTION
The boing program draws a bouncing checkered ball on a grid.

This is a clone of the first graphics demo for the Amiga 1000, which was written by Dale Luck and RJ Mical during a break at the 1984 Consumer Electronics Show (or so the legend goes.) The boing ball was briefly the official logo of Amiga Inc., until they were bought by Commodore later that year.

With no arguments, this program looks a lot like the original Amiga demo. With "-smooth -lighting", it looks... less old.

OPTIONS
boing accepts the following options:

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

--install
    Install a private colormap for the window.

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

--delay usecs
    The delay between frames of the animation, in microseconds: default 15000.

--smooth
    Draw a smooth sphere instead of a faceted polyhedron.

--lighting
    Do shaded lighting instead of flat colors.

--scanlines
    If the window is large enough, draw horizontal lines to simulate the scanlines on a low resolution monitor.

--speed ratio
    Change the animation speed; 0.5 to go half as fast, 2.0 to go twice as fast.

--no-spin
    Don't rotate the ball.

--angle degrees
    The jaunty angle at which the ball sits. Default 15 degrees.

--size ratio
    How big the ball is; default 0.5 meaning about half the size of the window.

--parallels n
    --meridians n The pattern of rectangles on the ball. Default 8x16.

--wireframe
    Look crummy.

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

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
bsod(6x), pong(6x), xscreensaver(1), X(1)

COPYRIGHT
Copyright © 2005 by Jamie Zawinski. 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
Jamie Zawinski <jwz@jwz.org>, 19-Feb-2005.