





                            K A L E I D O S C O P E
                                 By Don Thayer
                                   June 1986
        
           This program  creates a  kaleidoscope of patterns of varying
        colors on  the screen.   Many  of the  parameters that form the
        patterns can  be altered by using the options menu that appears
        when the  program is  first run  and again  whenever a  set  of
        patterns are complete.
        
        NOTE: An IBM or compatible graphics board is required.
        
                             --------------------
        
        KALEIDOSCOPE OPTIONS MENU:
          The options menu allows you to control many of the parameters
          that effect  the kaleidoscopic patterns as they are formed on
          the screen.
        
        The following is a description of each of the options:
        
        <1> Sound OFF/ON
           Option "1" toggles the sound ON and OFF.  When ON, each line
           that is  drawn will  sound a frequency that is approximately
           twice times  length of  each  line  in  pixels.    When  OFF
           (default), no sound is produced.
        
        <2> Boarder ON/OFF
           When is  option is  ON, a  boarder will  be drawn around the
           effective screen area and the screen number will be shown at
           the lower right portion of the screen. The OFF position will
           omit the boarder.
        
        <3> Status ON/OFF
           Selecting option  #3 toggles  the status ON and OFF. When is
           option is  OFF (default),  no statistics  are shown  on  the
           screen.  When this option is ON a set of data similar to the
           following line is displayed at the top of the screen:
           
                  P1  C3  B10  L 256  F 470       +-++
           
           The number following the "P" is the color palette that is in
           effect.   The number  following the  "C" is  the line color.
           The number  after the  "B" is  the background  color and the
           number following  the the  "L" is  the remaining  number  of
           lines to be drawn.  If the sound is ON the "F" value will be
           shown which is the frequency of the sound.
           
           The plus and minus signs shown at the upper right portion of
           the screen are direction indicators.  The first two indicate
           the horizontal movement of the two  end points of a line and
           the last two the movement of the vertical end points.
           

           NOTE: Whenever  the Status  option is  ON, the program slows
           down drastically.  This is  due in part to the time required
           to write  the data on the screen.  Also, if the sound is on,
           the program is slowed further.
           
        <4> Erase After #### lines
           If this  value is  greater than  zero, the  number of  lines
           corresponding to  this value  will be drawn before any lines
           are removed  from the screen.  If a zero is entered for this
           option the removal of lines will be deactivated and no lines
           will be  erased.   A maximum  of 500 can be entered for this
           option.
        
        <5> Number Of Screens = #
           After a  specified number  of lines  have  been  drawn,  the
           screen will  clear and a new pattern will emerge.  Option #5
           will allow you to set the number of screens to be shown.
           
           When the  number of  five (5)  is chosen,  a series  of five
           various sized  screens are  presented, each with a different
           number of lines per screen drawn.  This option overrides any
           value set for option #6.
           
        <6> Lines Per Screen = ###
           By selecting  option #6  you can specify the total number of
           lines drawn  on each  screen.  This number can be as high as
           32,000.
           
        <7> Maximum Increment = #
           This option  probably effects  the form  of the graphics the
           greatest.  Whenever an end point reaches a boarder boundary,
           it will  will change  direction and  a new  random increment
           will be  assigned to  that end  point's  incremental  value.
           This option  sets the  maximum increment  (in pixels) of any
           end point.   For  example, if the value of five (default) is
           chosen, the incremental value will vary between one and five
           pixels.   Small values tend to have the lines closely spaced
           while large  values tend  to space  the lines further apart.
           The largest  number that  can be  entered for this option is
           100.
        
        <8> GO
           Selecting this  option runs the program based on the options
           selected.   Once  the  program  is  running,  the  following
           options are available:
           
                "P" - Press the P key to change the palette color.
                "B" - Press the B key to change the background color.
                "Q" - Press the Q key to quit and return to the menu.
        
        <9> QUIT
           Ends the program and returns to the DOS prompt.
        


           Every effort has been taken to ensure that this program runs
        smoothly and  flawlessly.   Any suggestions,  comments or dona-
        tions  will  be  greatly  appreciated  (especially  donations),
        please mail any correspondence to:
        
                                  Don Thayer
                              1675 Hays St. #207
                             San Leandro, CA 94577

