This manual page is for Mac OS X version 10.6.3

Reading manual pages

ICO(1)                                                                                                ICO(1)



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] [-objhelp] [-colors color-list]

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 polyhe-dron polyhedron
       dron 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 lim-ited limited
              ited 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.

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 (depend-ing (depending
       ing 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  polyhe-dron. polyhedron.
       dron.   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.



X Version 11                                      ico 1.0.2                                           ICO(1)