KOZMIC_2 Read_me file.

Notes:

1.   Medium Resolution needed to read this file on screen.

2.   This is an ascii file without page-breaks or perforation skips.


Thanks for taking the trouble to read this file.   The  following 
files should be in the Kozmic_2 folder:

1.   READ_ME.TXT    (You are reading it now.)
2.   KOZMIC_2.PRG
3.   KOZ_LOAD.MBS
4.   KOZMIC_2.MBS


What you need to run the program:

     (a)  Atari ST/STF/STFM/STE with 1 Megabyte of memory or more 
          and a double-sided disk drive.

     (b)  A colour monitor     (poor results with an ordinary TV)


This program is Shareware, in other words it may be freely copied 
providing the entire KOZMIC_2 folder is left intact.  If you like 
the program then it is suggested that you send 5 to the  author, 
(yours truly).   This will encourage me to add more features  and 
release updates.

As  an incentive to persuade you to part with 5,  I'll send  you 
the Source Code in STOS basic in ascii format.   This amounts  to 
about  1300 lines of code,  and if printed out uses at  least  23 
pages  of  standard  fanfold  printer  paper.    This  is   fully 
commented  with rem statements.   Also on the disk will  be  some 
original art done with VidiST and/or Deluxe Paint.

            Things you could do with the Source Code:

1.   Load it into STOS Basic, see how it works, add more features 
     or grab chunks of code into your own programs.

2.   If  you don't have STOS you could load it into other  basics 
     which accept ascii listings and edit the program to make  it 
     run.

3.   Print it out and study the routines.  The ideas should be of 
     use to programmers in other languages.

     The  best way to print it out is using Fontswitch by  Jeremy 
     Hughes  of  the  ST Club.   Select  condensed  print  (saves 
     paper).   If using standard fanfold paper set pagelen to  66 
     and textlen to 56 to skip the perforations.


The  following is a quote from Jeff Minter's Llamatron  shareware 
disk.   His  views  on  Shareware are  eloquently  expressed  and 
deserve to be repeated:

 
"The principle of Shareware is simple. The game is distributed by the
PD libraries, by uploading onto BBSes and giving copies away. Users can
get a complete version of the game just for the price of the media,
and then take it home and play it. If the user likes the game, he
sends the author a Shareware fee.  Usually, the author will send
back a few goodies (as an incentive to register) and, if enough people
send in the dosh to make it worthwhile, he may do more Shareware stuff.

Naturally you don't have to pay anything if you don't like the game.
Of course a lot of people might like the game and decide not to pay,
but if too many people do that then nobody will ever bother doing any
decent Shareware at all, and it's back to Darren's 25 quid games.
So, it's down to the users - if they're honest, then programmers will
be more inclined to work hard on Shareware releases.

The idea of Shareware is very idealistic, perhaps impracticably so,
but the advantages over the conventional videogame market are so
enormous that I thought it had to be tried, at least once.  The response
from this experiment will determine whether or not Llamasoft release
any more shareware.

Advantages of Shareware:

1- It is a totally honest way of selling. All users can try the game
and only those who get hooked are morally obliged to pay the fee.
Nobody is disappointed or feels ripped-off.

2- There are no constraints on creativity. No-one says 'we cannot
publish this because it ain't mainstream'. Programmers do what the
hell they like and the users vote with their Shareware fees.

3- Anyone can play. The mechanism of distribution is already in
place in the form of PD libraries. All the originator has to provide
is a disk to each of the PD libraries with game and documentation.
So if you have good stuff it doesn't matter if you aren't signed to
a major label - if it's good, it'll get passed around the PD scene;
if it's bad nobody will bother with it.  The author could be working
for a company or coding in his bedroom; the potential for distribution
is the same. Forget spending thousands on adverts trying to convince
people to spend lots of money on a game they haven't even played
yet...

4- The concept of piracy becomes null. All that business of hacking
and cracking doesn't apply to software which is both free and
unprotected.  Shareware authors WANT their software to be spread
and copied. If it gets onto a BB in America and spreads all over
the US, well and groovy! Good Shareware exports itself!

5- Prices can be way low. Since the authors have no overheads in
terms of production and advertising, they don't need to ask as
much in payment.  And the users pay the programmers directly - 
nobody else takes a cut. 100% of five pounds is better than 5% of
twenty pounds.


The advantages of Shareware as a democratic, honest way of
publishing software are pretty obvious, but it does have to go
both ways. If a programmer puts a lot of time and effort into his
code and releases it as Shareware, he's trusting you, the users, to
be honest and pay him if you like his program.  If you all just
skive off and take the stuff for free, he won't bother to do any
more stuff.  If you support the author, he'll be inclined to do
much better next time - and you'll be the ones to benefit!"

                  ____________________________

Thanks to Jeff Minter for these words of wisdom.  The cheque's in 
the  post,  along with a copy of Kozmic.   Now some  words  about 
Kozmic.   A  description  is available from  within  the  program 
itself; click on About The Program.

The  purpose  of the program is to  create  psychedelic  patterns 
which  can be saved to disk.   No drawing skills are  needed  but 
experimentation  is  required to increase the range  of  effects.  
The Help option provides enough information to get  started,  and 
further on-line help is available from several of the  menus. 

     I  also intend to write a monochrome version soon as  I  get 
     the time.   In the meantime,  please enjoy Kozmic_2 and give 
     copies to everyone!

     Dave Henniker
     199 (4F1) Bruntsfield Place
     Edinburgh EH10 4DQ
     Scotland UK


I've tried to make the program as user-friendly and intuitive as
possible; an instruction manual should hardly be necessary.

Nevertheless someone might like to print out the main Help screen -
there are actually four I think - so I'll tag it onto the end of
this file.  Remember to experiment.  There are some undocumented
features eg Restore Symettry works differently if you right-click.
Actually, I have now documented that feature so it is no longer
undocumented.

I'm fairly confident there are no bugs.  A full disk does not crash
the program if you're saving your masterpiece.  Please let me know
if you find any bugs.  Here are the Help screens:

                          INSTRUCTIONS

The  boxes  in  the  first two  columns  make  patterns,  some  finish  by 
themselves  but  others  must be stopped  by  right-clicking  or  pressing 
<SPACE>.   You  may alter the parameters of some patterns by  clicking  on 
their SET boxes.   Menus appear, often with additional help.

Left-click  on SloMo to slow down drawing,  right-click for normal  speed.  
The  <->  and  <+> keys also control the  speed,  if  pressed  as  drawing 
occurs.

Left-click  on CLIP to define a rectangle to restrict the area  drawn  on.  
Click once to define the top left corner,  again to define the  base-line.  
Right-click to return to the full screen.

When  drawing stops,  you are in View mode.   To return to the  main  menu 
screen,  press <SPACE> or the right mouse button.   Do it again to go back 
to View mode (or click on VIEW).

Either mouse button works with CYCLE PALETTES,  left for slow,  right  for 
fast.    You  can also select a palette by clicking on it or pressing  the 
left or right Cursor Keys.

The  MORE  PALETTES  window  has options to LOAD a  screen  and  grab  its 
palette into the USER DEFINED palette,  and to edit your own palette.   If 
you want to modify an existing palette then right-click on it.

Palette boxes containing three horizontal bars have interleaved  palettes.  
Interesting  effects  occur with these when some Alternate  sweep  effects 
are selected from the SET COLOUR RANGE menu,  or if boxes 3, 4 or 5 in the 
first column of the menu screen are clicked on.

Left-click  on CYCLE COL to start colour-cycling or right-click  to  alter 
the  cycling speed.   Whilst in View mode you may start colour cycling  by 
pressing <C>.

SET  COLOUR  RANGE  has  lots of menu options -  including  its  own  Help 
screen.  The DEFAULT range box is highlighted if selected.

CLS clears the screen.   UNDO removes the pattern last drawn.  PARTLY UNDO 
removes  alternate horizontal lines from the last pattern.   This  can  be 
interrupted for extra effects by pressing <SPACE> or the right mouse key.

SAVE permits saving in Degas or Neochrome formats.  

The second box down in column one can also be right-clicked on for  dotted 
or  dashed line effects.   Left-clicking during drawing alters the  effect 
and  the  number  of  audible tweets indicates which  line  effect  is  in 
operation.   These  dotted  /  dashed  lines can also  be  used  in  MOIRE 
patterns  (or  the box above MOIRE) if you right-click on  them,  but  the 
effect may get a bit messy.


                            Keys in View Mode

<SPACE> ............................... Toggle between View and Main Menu

<C> ................................... Start colour cycling

Left / Right Cursor keys (arrows) ..... Change palette


                           Keys whilst Drawing

<SPACE> ............................... Stop drawing

<-> (Minus on numeric keypad) ......... SloMo on

<+> (Plus on numeric keypad) .......... SloMo off

