NAME

       ico - animate an icosahedron or other polyhedron

SYNOPSIS

       ico  [-display display] [-geometry geometry] [-r] [-d pattern] [-i] [-dbl] [-faces] [-noedges] [-sleep n]
       [-obj object] [-colors color-list]

       ico -objhelp

       ico -version

DESCRIPTION

       Ico displays a wire-frame rotating polyhedron, with hidden lines removed, or a solid-fill polyhedron with
       hidden  faces  removed.   There are a number of different polyhedra available; adding a new polyhedron to
       the program is quite simple.

OPTIONS

       -r     Display on the root window instead of creating a new window.

       -d pattern
              Specify a bit pattern for drawing dashed lines for wire frames.

       -i     Use inverted colors for wire frames.

       -dbl   Use double buffering on the display.  This works for either wire frame  or  solid  fill  drawings.
              For  solid fill drawings, using this switch results in substantially smoother movement.  Note that
              this requires twice as many bit planes  as  without  double  buffering.   Since  some  colors  are
              typically  allocated  by other programs, most eight-bit-plane displays will probably be limited to
              eight colors when using double buffering.

       -faces Draw filled faces instead of wire frames.

       -noedges
              Don't draw the wire frames.  Typically used only when -faces is used.

       -sleep n
              Sleep n seconds between each move of the object.

       -obj object
              Specify what object to draw.  If no object is specified, an icosahedron is drawn.

       -objhelp
              Print out a list of the available objects, along with information about each object.

       -colors color color ...
              Specify what colors should be used to draw the filled faces of the object.  If  less  colors  than
              faces are given, the colors are reused.

       -version
              Print program version information and exit.

PROGRAM TERMINATION

       Pressing  "q"  will close a window. If compiled with threads support, the program will stop only when all
       threads terminate. You can also close an animation window using the ICCCM delete  message  (depending  on
       your window manager, you will have a decoration button or menu to send such message).

ADDING POLYHEDRA

       If  you  have the source to ico, it is very easy to add more polyhedra.  Each polyhedron is defined in an
       include file by the name of objXXX.h, where XXX is something related to the name of the polyhedron.   The
       format of the include file is defined in the file polyinfo.h.  Look at the file objcube.h to see what the
       exact format of an objXXX.h file should be, then create your objXXX.h file in that format.

       After making the new objXXX.h file (or copying in a new one from elsewhere), simply do a  'make  depend'.
       This  will recreate the file allobjs.h, which lists all of the objXXX.h files.  Doing a 'make' after this
       will rebuild ico with the new object information.

SEE ALSO

       X(7)

BUGS

       Pyramids and tetrahedrons with filled faces do not display correctly.

       A separate color cell is allocated for each name in the -colors list, even when  the  same  name  may  be
       specified twice.  Color allocation fails in TrueColor displays and option -faces does not work well.

COPYRIGHT

       Copyright 1994 X Consortium
       See X(7) for a full statement of rights and permissions.