MirOS Manual: ico(1)


ICO(1)              UNIX Programmer's Manual               ICO(1)

NAME

     ico - animate an icosahedron or other polyhedron

SYNOPSIS

     ico [-display display] [-geometry geometry] [-r] [-d pat-
     tern] [-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 avail-
     able; adding a new polyhedron to the program is quite sim-
     ple.

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

XFree86                   Version 4.5.0                         1

ICO(1)              UNIX Programmer's Manual               ICO(1)

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

     Pressing "q" will close a window. If compiled with threads
     support, the program will stop only when all threads ter-
     minate. 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.

XFree86                   Version 4.5.0                         2

Generated on 2014-07-04 21:17:45 by $MirOS: src/scripts/roff2htm,v 1.79 2014/02/10 00:36:11 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2014 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.