NAME

       bugsx - display and evolve biomorphs

DESCRIPTION

       bugsx  runs  under MIT's X11 window system. It was written under UNIX but should be easily
       portable.  It is a program which draws the biomorphs based on parametric plots of  Fourier
       sine and cosine series and let's you play with them using the genetic algorithm.

       The  original  version  which ran under Suntools and XViews was written by Joshua R. Smith
       sometime 1990. See the 'credits' section for more details.

       For more information about the theoretic backgrounds of bugsx consult  Joshua  R.  Smith's
       paper  distributed  with  this program (in postscript format). It can also be gotten from:
       http://physics.www.media.mit.edu/~jrs/biomorphs.ps

COMMAND LINE PARAMETERS

       bugsx accepts the following command line options:

               +rv                     reverse video (use to override xrdb entry)
               +synchronous            syncronous mode (use to override xrdb entry)
               -?                      help
               -background <arg>       backgound color
               -batch                  run program in batch mode
               -bg <arg>               same as -background
               -bordercolor <arg>      border color
               -borderwidth <arg>      border width
               -display                display
               -extend_print           show extended reproduction info while running
               -fg <arg>               same as -forground
               -font <arg>             font
               -foreground <arg>       forground color (also file system bar color)
               -geometry <arg>         geometry (will override extreme window sizes to
                                       apply reasonable settings)
               -help                   help
               -iconic                 iconic
               -interval <arg>         interval used per turn
               -mb                     show menu border
               -name <arg>             run bugsx under this name
               -nobreed                do not breed when running in bactch mode
               -number <arg>           number of biomorphs to draw (must be a square #)
               -printpop               print the population when breeding
               -rv                     reverse video
               -seed <arg>             use this seed for random number generator
               -segments <arg>         use this many segments to draw an organism
               -showbreed              show breeding subpopulation when in batch mode
            -showgenes          show a graphic representation of the genes
               -synchronous            synchronous mode
               -v                      verbose
               -xrm                    make no entry in resrouce database
               help                    help

RESOURCES

       bugsx can be controlled via the following resources:

               background              universal backgound color
               batch                   run program in batch mode
               batchbreed              do not breed when running in bactch mode
               borderColor             border color
               borderWidth             border width
               display                 display
               extend_print            show extended reproduction info while running
               font                    font
               foreground              universal foreground color
               help                    show help
               mainWin.geometry        main window geometry
               iconic                  start program in iconic mode
               interval                interval used per turn
               minimize                minimize window size
               menuborder              draw menu borders
               name                    run bugsxunder this name
               number                  number of biomorphs to draw (must be a square #)
               printpop                print the population when breeding
               reverseVideo            reverse video
               seed                    use this seed for random number generator
               segments                use this many segments to draw an organism
               showbreed               show breeding subpopulation when in batch mode
            showgenes      show a graphic representation of the genes
               synchronous             syncronous mode
               verbose                 verbose mode

BRIEF USER'S GUIDE

       Once you have started bugsx you will get a window containing the  drawing  windows  and  3
       menus. The Menus are:

            Initialize - Initializes the gene pool
            Breed        - Breed the selected organisms
            Quit       - exits bugsx

       Once  you  have chosen "Initialize" and the first set of drawings is shown, you can select
       the ones you wish to be included in the cross-breeding by clicking (with the left  button)
       on a drawing window. The selected organisms will be drawn inverse.

       Clicking  on Breed will cross breed the selected organisms using the genetic algorithm. If
       you have not selected at least two organisms, a set of  at  least  two  will  be  randomly
       chosen and used for the breeding.

       The following keys can be used to control bugsx:

            q - quit bugsx
            i - initialize population
            b - breed

AUTHOR

       bugsx  was written by Joshua R. Smith (jrs@media.mit.edu) and ported to XWindows by Robert
       Gasch (Robert_Gasch@peoplesoft.com) and is copyright by the author(s).

CREDITS

       The strstr() used for DYNIX ports is a slightly modified version of the GNU source.

                                               X11                                      BUGSX(1x)