@database Flamingo
@author "Rajnai Álmos"
@(c) "2000 BiřHazard"

@node "Main" "Colour Lines logic game"

                              @{i}@{fg shine}Colour Lines@{ui}@{fg text}
                               @{fg fill}logic game@{fg text}

    Graphics by UnReal, music by Teo.p3/BiřHazard, code by Rachy/BiřHazard.

                           Version 1.03, 01.12.2000

               @{"Intro         " link "Intro" 0       }   @{i}What is this then?@{ui}
               @{"Requirements  " link "Requirements" 0}   @{i}What do I really need?@{ui}
               @{"Installation  " link "Installation" 0}   @{i}This should be my biggest problem...@{ui}
               @{"Usage         " link "Usage" 0       }   @{i}Playing games, eh?@{ui}
               @{"Disclaimer    " link "Dist" 0        }   @{i}Should I register?@{ui}
               @{"Author        " link "Author" 0      }   @{i}Who cares about, eh?@{ui}
               @{"Other Projects" link "Projects" 0    }   @{i}Should I look that also?@{ui}
               @{"Thanks to...  " link "Thanx" 0       }   @{i}Who was his help? (Also guilty!)@{ui}
               @{"Bugs          " link "Bugs" 0        }   @{i}Fear of the bug@{ui}
               @{"History       " link "History" 0     }   @{i}Once upon a time?@{ui}
               @{"To do         " link "Todo" 0        }   @{i}"Son, don't forget do the homework!"@{ui}

                             @{i}©2000 @{fg fill}BiřHazard @{ui}@{fg text}

@endnode

@node "Intro" "How this story began"

 One of my colleague (Edina Horváth) brought once a quite easy and nice
logical game into our office. It was a russian program, written for IBM-PC
soapboxes under DOS. I found it very amusing, so I took it home. Under the
PC emulator it was @{fg shine}soooo@{fg text} slow! (Probably written in some kind of old Pascal
version...)
 I showed it to my spouse, and that was hardly a good idea at all... :) She
just LOVED that game, but it took about half an our while she played a
round. So I could leave my two women together for at least an hour in pair
alone. (My spouse and my Amiga.) After a while I got rid of the situation,
and I looked for an Amiga clone for this game on Aminet. I found one, but it
was an altered version, did not behave similar in all rules, written in AMOS,
and after all I did not liked very much. The other reason was: I got some new
ideas to be implemented.
 Let's start from scrach then... And I wrote it. There is a possibility to
play under the original rules, but extended rules give more pleasure I think.
 Now my spouse is still playing at least an hour, but now she could complete
4-6 games... She is unbeatable in the high scores... :)

@endnode

@node "Requirements" "Well, you will need at least an Alpha! :)"

 @{i}So, what do you really need?@{ui}

 ř at least Kickstart 2.04

 ř External libraries: iff.library v23, reqtools.library v37

 ř At least a 68000 processor :)

 ř Any, Intuition compatible gfx display, with at least 16 colour and
   320x200 resolution

 ř Paula sound chip for music (Sorry DraCo users!)

 ř Some free memory

@endnode

@node "Installation" "Why this s**t does not want to work???"

 All you have to do to install is:

    @{fg shine}copy all files and subdirs to one directory!@{fg text}

 Quite easy, isn't it?

@endnode

@node "Usage" "Easy-to-use is always suspicious!"

 So, you have finally decided to read the docs, eh? :)

 The basic rules of the game

 Your playground is a square, divided into 81 pieces (9 rows by 9 columns).
Almost every round in the game 3 coloured ball appear randomly at free
places on this table. (You can look forward to the oncoming balls at the
right of the table.) Now, you can pick one of the balls on the table (left
mouse click), and choose an empty space, which one is not separated by other
balls (left mouse click). You can change your mind before moving the ball
into an other position you can simply pick an other ball by using the left
button again.
 Picked ball will be moved to the empty place, and if 5 or more exists in one
line from the same colour, the line disappears. When this happened, in the
next round no new balls come to the table. (So you can decrease the number of
the balls, if you are good enough...)
 After each disappeared ball you get points, scoring is non linear, more
balls give you much more points. If random balls cause a line to be
disappeared, you won't get any points for it.
 Game ends when the table is full.

 The extended rules

 The high scores of the extended rules registered separately from each other,
features help sometimes a lot, so much more scores can be achieved. It would
not be a fair play using the same Hall-Of-Fame.

 1. Joker ball

 If you choose this extended rule, you can apply for a joker ball at any time
in the game by left clicking to the black joker ball at the right from the
table. After picking the joker, you can place at any free sqaure in the table
by left clicking, and it can be used as any colour.
 At the start you have 3 joker balls, more joker can be earned by
disappearing at least 7 balls at the same time.

 2. Exchanging balls

 This extended rule let you exchanging any two balls instead of moving them.
Choose first ball by left clicking, then pick the other one by a right click.
The punishment: there piece of walls will appear on random places, those can
be moved, but will never vanish.

@endnode

@node "Author" "...nobody calls me Lebowski. You got the wrong guy. I'm the Dude, man..."

 Who did this boring/lame/shitty/great game?

                      @{fg shine}Rajnai Álmos@{fg text} @{fg fill}(Rachy of BiřHazard)@{fg text}
                  mostly coder, sometimes even musician...

                  If you want to contact me, then write to

                                 Snail mail:

                              H-8360 Keszthely
                              Bercsényi M.u. 46
                                   Hungary

                                 Or E-mail:

                               @{fg shine}RACS@FS2.BDTF.HU@{fg text}

                Please read docs carefully before asking me!

 You can find me on the hungarian Amiga mailing list:

  http://www.fa.gau.hu/mailman/listinfo/amiga

  Sometimes I am on the IRC channel @{fg shine}#amigahu@{fg text} on @{fg shine}IRCNET@{fg text}.

@endnode

@node "Projects" "The future is Bright!"

 I have (had) some other projects, take a peek on them:

 @{fg shine}*@{fg text} Flamingo, the Commodore Plus/4 emulator for the Amiga.
 Aminet: misc/emu/flamingo.lha

 @{fg shine}*@{fg text} Fřnt!, a hungarian disk magazine
 Aminet: docs/mags/f0ntxx.lha

 @{fg shine}*@{fg text} MoovidPPC, and extension of the great Moovid video
 player from László Török (pH03N1x), I take care of some PPC parts

 @{fg shine}*@{fg text} Some nice programs, find them on the Aminet:
   dev/c/measureconpup.lha - a context switch measuring utility for PowerUP
   dev/c/measureconwos.lha - a context switch measuring utility for WarpOS
   game/misc/shells.lha - a nice gambling game
   misc/emu/fastformat1541.lha - a utility for Commodore 1541, fast formatting
   util/boot/bootprogress - a boottime progressbar with any iff picture
   util/pack/headbanger.lha - an XPK based experimental compressing utility
   util/pack/xfddir.lha - replacement of xfdlist with more features

 @{i}That's all, Folks! (For today...)@{ui}
@endnode

@node "Dist" "So you want to register... Don't you?"

 This archive can be copied and spreaded in any electronic, magnetic or
optical way, while it is kept together. Do not add or remove any part!

      This program is @{fg shine}FREEWARE@{fg text}, anyway if you like it, please send
                        anything you think I deserve
   (money, registered copy of your software, beer, mailbombs or anything)

                                   to @{"me." link "Author" 0 }

                             Thanks in advance!

 Don't forget: @{fg shine}I take no responsibility for ANY harm, caused use or misuse of
this program!@{fg text} (Eg. crashes your machine, while you lost all your files from
your hard disk, drinks all beer at home, drives crazy your girlfriend...)

 This software or any parts could not be used for commercial purposes without
the written permission of the authors.

@endnode

@node "Thanx" "Thanks to..."

  This program could not become to real without those men, and I would like
to thank them:

 @{fg shine}*@{fg text}@{i}Olga Demina, Igor Ivkin, Gennady Denisov @{ui} for the original game.

 @{fg shine}*@{fg text}@{i}Wouter van Oortmerssen@{ui} for creating @{fg shine}AmigaE@{fg text}.

 @{fg shine}*@{fg text}@{i}UnReal@{ui} for quite good graphics.

 @{fg shine}*@{fg text}@{i}TEO.p3/BiřHazard@{ui} for nice music.

 @{fg shine}*@{fg text}@{i}Sau@{ui} for beta testing and new ideas.

 @{fg shine}*@{fg text}@{i}Simba/FD@{ui} for beta testing.

 @{fg shine}*@{fg text}@{i}Péter "Smith" Kovács@{ui} for beta testing.

 @{fg shine}*@{fg text}@{i}Péter "jam" Markovits@{ui} for helps and @{i}lotsa@{ui} beers together...

 @{fg shine}*@{fg text}@{i}Edina Horváth@{ui} for the original game

 and

 @{fg shine}*@{fg text}@{i}Timea@{ui}, my spouse for moral support.

 Finally greets to:

  all other @{i}BiřHazard@{ui} members (especially @{i}R.I.P.@{ui}),

  @{i}asdf@{ui},
  @{i}Att1s^SH@{ui},
  @{i}BSZ/NST@{ui},
  @{i}CHIP@{ui},
  @{i}Darklon/Scoopex@{ui},
  @{i}Enc0re@{ui},
  @{i}Emeric/SpaceHawks@{ui},
  @{i}Grass/CDi@{ui},
  @{i}IBRON@{ui},
  @{i}Jocó@{ui},
  @{i}Kovács Dezső@{ui},
  @{i}lORD/Absolute!^CJ^Impulse@{ui},
  @{i}Leeroy/SMV Design@{ui},
  @{i}Louise@{ui},
  @{i}Magic@{ui},
  @{i}MakkMarci@{ui},
  @{i}Steffen "MagicSN" Heauser@{ui},
  @{i}Napi Kettő@{ui},
  @{i}Pethő Szabolcs@{ui},
  @{i}Petike/AmigaVilág@{ui},
  @{i}pH03N1X/CDi@{ui},
  @{i}Ray/Therapy@{ui},
  @{i}QXYka@{ui},
  @{i}RatMan/CJ@{ui},
  @{i}Sensor/NST@{ui},
  @{i}Stinky/NST@{ui},
  @{i}Szabó "Cybergolyó" András@{ui},
  @{i}Valenta Ferenc@{ui},
  @{i}Watt@{ui}.

@endnode

@node "Bugs" "Beatlejuice! Beatlejuice! Beatlejuice!"

 Known bugs:

 Balls sometimes start "roaming" on the playground, but finally they
made it into the destination. This small bug is coming from my lazyness. I
had no intention at all writing a better routine for ball routing. Maybe
once...

 Music module playing is hardware banging yet, I have not enough knowledge
writing an other, system friendly player. If you know one, please let me
know!

@endnode

@node "Todo" "Let's check handkerchief!"

 Well, there are a lot of things to improve:

 @{fg shine}*@{fg text} Better gfx, more gfx sets
 @{fg shine}*@{fg text} Windowplay on any screen
 @{fg shine}*@{fg text} More special possibilities in advanced game mode
 @{fg shine}*@{fg text} Much more configurable
 @{fg shine}*@{fg text} Change music player to AHI compatible(?)

@endnode

@node "History" "Once Upon A Time..."

History

v1.03 Internal beta on 01.12.2000

 Added brand new graphics.

v1.02 Internal beta on 26.03.2000

 Added ball exchange and music.

v1.01 Internal beta on 12.02.2000

 Added joker balls and buttons.

v1.00 First beta on 23.01.2000

@endnode