ico(X)                        06 January 1993                         ico(X)


 Name

    ico - animate an icosahedron or other polyhedron

 Syntax

    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 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 lim-
                             ited to eight colors when using double buffer-
                             ing.

    -faces                   Draw filled faces instead of wire frames.

    -noedges                 Do not 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.


 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 else-
    where), 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(X)

 Known Limitations

    A separate color cell is allocated for each name in the -colors list,
    even when the same name may be specified twice.