                                              Zuletzt geschrieben 19.04.1994

Dies ist eine Textdatei zu dem Spiel 'Karl Quappe' ( Copyright 1994 ) !!!

Das Spiel wurde 1994 von Malban geschrieben.
=========================================================

COPYRIGHT 1994 VON MALBAN !!!


Das Spiel ist SHAREWARE.
========================

Einschrnkungen
===============

Diese Version ist eingeschrnkt. Mein letztes Spiel,
'Pacman' war in keiner Weise eingeschrnkt, allerdings lieen demzufolge
auch die Anzahl der Registrierungen zu wnschen brig.
( Vielleicht war es aber auch nicht gut genug, oder es bestand keine Interesse
  an der 1000sten Version des Spiels. ( Obwohl es NATRLICH die BESTE, SCHNSTE,
  TOLLSTE und behaupte, Version von PACMAN war ! ))

Wie dem auch sei, ich habe beschlossen dieses Spiel nur eingeschrnkt zu
verffentlichen, ich mchte mal ausprobieren, ob sich etwas an der
Registrierfreudigkeit der Spieler ndert.

Manche Leute knnen eingeschrnkte SHAREWARE nicht leiden ( ich gehre dazu ! )
diese knnen, dann den Begriff SHAREWARE in diesem Text durch DEMOWARE
ersetzen ( sollte mit jedem guten Editor mglich sein ).

Folgendes sind die Einschrnkungen :

- Dieses Spiel hat in der SHAREWARE Version nur 3 verschiedene Level ( diese
  wiederholen sich dann immer wieder ).

- Vor jedem Spiel und vor dem Verlassen des Programmes erscheint eine kurze
  Shareware-Notiz ( Da ich der tolle Hecht bin, der das Spiel programmiert hat,
  und da man sich gerne registrieren lassen kann, und wie und wo ... )
  Diese sollte nicht allzu strend sein, sie erscheint fr ca. 2 Sekunden und
  verschwindet auf Tastendruck.


 Weitergabe dieser Version
===========================

Diese Version darf weitergegeben und kopiert werden nach Lust und Laune, bis
auf die unten genannten Einschrnkungen.

- Es drfen keinerlei Dateien gendert werden, weder Text-, Grafik- oder
  Programm-Dateien.

- Das Programm darf NICHT verkauft werden !

- Es darf nicht durch sogenannte SHAREWARE-HNDLER vertrieben werden, die eine
  Kopiergebhr von mehr als 5,- DM pro Diskette verlangen !

- Das Programm darf auf einer CD-ROM Sammlung erscheinen ( wenn's denn einer
    haben will ), ich bitte jedoch um eine Benachrichtigung.


 Registrierungen
=================

Wenn Jemanden das Spiel gefllt, dann darf er sich gerne bei mir registrieren.
In der Vollversion wird der Shareware-Hinweis wegfallen, und jede Menge neue
Level erscheinen. Wahrscheinlich wird auch die Mglichkeit gegeben sein selber
Level zu erstellen. ( Allerdings ohne Level-Editor, hnlich (un-) konfortabel
  wie beim Pacman ).

NIEMAND muss sich registrieren lassen, wem die 3 Level gengen, der kann diese
von mir aus spielen bis er schwarz wird oder der Computer kaputt geht, ist mir
egal !

Ihr knnt Euch auch die Festplatte zuhauen mit dem Programm und es Jahre darauf
lassen und jeden Tag spielen, wer mit den 3 Levels glcklich wird, ist mir egal.

Wer aber meint, das Programm ist gut, und wer meint er mchte gerne mehr Level
spielen ( ist halt abwechslungsreicher ! ), oder wer mir einfach eine Freude
machen mchte, oder wer zu viel Geld hat ( gibt es Jemanden ? :-) ) ...

Der kann sich bei mir registrieren lassen :

        Adresse :       Malban
                        ======

        Ich bin auch im FIDO - Netz zu erreichen unter :

                        2:2457/315.16           ( Stand April 1994 )

KOSTEN
======
Ich bin bereit mich fr 30,- DM von einer Vollversion des Spieles zu trennen.

Am liebsten ist mir Bares :-)))) .

Oder ein Verrechnungsscheck.

Nachname kostet 12,- DM mehr !!! ( Ist nicht meine Schuld ... )

Ich wrde hier auch meine Kontonummer angeben, aber man wei ja nie wie lange
man sein Konto noch hat :-(.


Warum Shareware
===============

Ich weiss nicht ob das Programm gut genug fr irgendwas Kommerzielles ist,
schliesslich und endlich ist die Spielidee ber 10 Jahre alt, und das Spiel
vielleicht nicht mehr ganz zeitgem ( obwohl ich es immer gern gespielt habe,
  es ist halt ein kleines Spiel fr zwischendurch, ebenso wie Pacman ).

Die Umsetzung ist selbstverstndlich berragend gut !!!
( Ich bin nicht wirklich so eingebildet, aber ich muss doch versuchen mein
  Produkt mglichst gut an den Mann zu bringen ;-) )

Ich mchte das Programm NICHT ber einen Hndler vertreiben, registrierte
Vollversionen werden AUSSCHLIELICH von mir weitergegeben !!!
( Niemand der diese Datei liest sollte auf die Idee kommen seinen PD-, oder
  Shareware - Hndler zu belstigen, das bringt nichts.
  ( Beim Pacman haben das auch welche versucht, WARUM ??? ))

Auerdem freue ich mich ber jede Post, die ich bekomme. Am liebsten sind mir
Briefe in denen auch was drin steht. Ein paar Registrierungen von Pacman waren
3 Zeilen lang z.B.

                ' Ich mchte mich fr Pacman registrieren.
                  Geld liegt bei.
                  Tsch                                        '

Nicht, da ich das Geld nicht genommen htte, und natrlich ist auch in jedem
Falle die Vollversion verschickt worden, aber ich htte mich gefreut, htte
noch ein wenig Kritik ( positive und negative ) dringestanden.
Was besser sein knnte, was schlechter, was gut ankommt, was nicht.
Was man noch in das Spiel mit aufnehmen sollte, was fr einen Computer man
hat, ob man selber Level erstellt hat, der aktuelle HighScore oder oder oder.

( Macht doch was Ihr wollt, macht Ihr doch eh ! )


 STARTEN
=========
Das Spiel bentigt mindesten einen 386er. Ich habe einen Prozessor Test
eingebaut, der beim Starten des Spieles den Prozessor ermittelt.
Sollte nicht mindestens ein 386 ermittelt werden, kann das Spiel nicht
gestartet werden ( wenn der Test funktioniert, hatte noch keine Gelegenheit
  ihn auszuprobieren, bei mir klappt er ( ich habe einen 386er )).
Desweiteres bentigt man eine VGA-Grafikkarte, auch das wird getestet, sollte
keine ermittelt werden, kann das Spiel auch nicht gestartet werden.

Beim ersten Starten des Spieles ( oder wenn keine default.frg Datei gefunden
  wurde ), wird ein Geschwindigkeitstest der VGA-Karte durchgefhrt,
und entsprechend kommentiert. Bei meinem 386er 40 Mhz luft das Spiel
einwandfrei, allerdings kann ich keine Mix-Geschwindigkeiten fr die
Soundeinstellungen eingeben, die ber 8000 liegen, sonst ruckeln verschiedene
Level. ( Level, wo wirklich viel auf dem Bildschirm bewegt wird )
Der Geschwindigkeitstest ist sehr einfach aufgebaut, ich schreibe 100.000
Punkte in das Videoram und messe die Zeit, die dafr bentigt wurde.
Um das Ergebnis nicht zu verflschen wird die Musik in dieser Zeit
ausgeschaltet.
Da ich nicht sehr viele Rechner zur Verfgung habe, sind manche Werte nur
Schtzwerte ( bei den Empfehlungen ), am Besten ist -> einfach ausprobieren.
Wenn es zu langsam wird, ruckelt es halt, da kann ich nicht mehr viel
dran machen, es wird halt ziemlich viel bewegt, das erfordert viel Zeit,
bzw. eine schnelle Grafikkarte.

Wichtige Werte werden in der 'default.frg' Datei  gespeichert, so z.B. die
Audio-Einstellungen, den Startlevel, die Froschbewegungsgeschwindigkeit ( wow ).


 KARL QUAPPE
=============

Der Star des Spiels ist KARL, Nachnahme QUAPPE.
    ( Namensgebung -> meine Freundin ).

Karl ist ein Frosch !

Kennt zufllig Jemand FROGGER ? Wenn ja, kann er sich ungefhr vorstellen, um
was es bei dem Spiel geht, es besteht nmlich eine entfernte Verwandschaft !

( hnlichkeiten mit dem Original Frogger sind rein zufllig und berhaupt nicht
  beabsichtigt ! )

Nun gut, vielleicht kennt Jemand Frogger nicht, oder irgendjemanden ist die
Verwandschaft zwischen den beiden Programmen doch ein wenig zu sehr an den
Haaren herbeigezogen, fr diejenigen eine kurze Erklrung des Spieles.

Der Spieler steuert Karl ( den Frosch ). Steuern geht mit den Cursortasten.

Taste nach oben   -> Frosch springt nach oben
Taste nach unten  -> Frosch springt nach unten
Taste nach links  -> Frosch springt nach links
Taste nach rechts -> Frosch springt nach rechts

( Gut, 'ne ? )

Der Bildschirm teilt sich in zwei Abschnitte auf, den unteren und den oberen !
( Mei, was schreibe ich heute wieder klug ! )

Also, im unteren Bildschirm sieht man eine 5 spurige Strasse (gibts sowas ?).
Ja, das soll wirklich eine Strasse darstellen, die farbigen Dinger die sich
darauf bewegen, sollen verschiedene Autos darstellen
( keine speziellen Marken ).

Der Spieler muss nun versuchen den Frosch ber die Strasse zu bringen ohne ein
Auto zu berhren ( dann macht es leider FLATSCH ( zumindest auf dem alten Atari
Telespiel ) und ein Frosch-Leben ist nicht mehr ) !

Mit steigendem Schwierigkeitsgrad, fahren auch mehr Autos ber die Strasse !

Zwischen der oberen und der unteren Hlfte ( h ?!?! Was ist den zwischen zwei
Hlften ? Na, egal - ) wird eine Art Grnstreifen dargestellt. Dort kann sich
Karl ein wenig ausruhen ( in den nicht so schwierigen Levels auf jeden Fall ).

Jetzt muss er versuchen ber den Fluss zu kommen und in eines seiner noch
unbesetzten Nester zu springen.
( Nester sind die grneren Teile, wenn er gegen die brauneren Springt -> Exitus.
  Ich verstehe gar nicht, warum das manche Leute nicht erkennen !?!? )

Wie dem auch sei Karl ist scheinbar ein noch recht junger Frosch, er kann
nmlich nicht schwimmern ! ( Vielleicht ist auch die Strmung in dem Fluss zu,
stark, oder irgendein Chemie-Konzern hat soviel Abfall darein gekippt, das
Frsche darin nicht berleben knnen ... ) Um ber den Fluss zu kommen, muss
er auf die im Fluss schwimmenden Teile springen. Springt er mal daneben landet
er im Fluss und stirbt dann an den Folgen des Fehlsprunges.
Ausserdem kann er in eine bodenlose Tiefe fallen, wenn er sich ber den
Bildschirmrand hinaustreiben lt.
In dem Fluss schwimmen verschiedene 'Sachen' rum.
Holzstmme in zwei verschiedenen Gren, Krokodile ( auf das Maul muss man
aufpassen, ffnet sich das, und man sitzt auf dem Maul, wird Karl leider
Krokodilfutter ... ( Das berlebt er nicht )), Schildkrten ( welche in manchen
Leveln auch wegtauchen knnen). Ab und zu kann auch schonmal ein Otter
auftauchen, auf diesen kann man NICHT springen ( zumindest nicht ohne im Fluss
zu landen ), allerdings kann Karl auch durch den Otter ber den Jordan gebracht
werden ! ( Nein dieser Fluss heisst nicht Jordan ! )
Befindet sich Karl am Rand eines im Fluss treibenden 'Gegenstandes' und kommt
ein Otter auf Ihn zu, dann kann es passieren, da der Otter nach Karl schnappt
und in verspeist...

Auf dem Weg ber den Fluss kann Karl noch eine Freundin treffen, das bespringen
dieser gibt Bonuspunkte. ( :-)) )
In seinem Nest kann eine Fliege auf Ihn warten (wrde ich nicht tun, wenn ich
eine Fliege wre ), berhrt er diese gibt
es wieder mal Bonus Punkte. ( Allerdings kann auch ein Krokodil auftauchen,
das gibt keine Bonuspunkte, zumindest nicht fr den Spieler ... )

Ausserdem knnen in manchen Levels noch Schlangen auftauchen. Auf Baumstmmen
oder auf dem Grnstreifen, berhrt Karl eine Schlange am Kopf
( schn bld fr einen Frosch ), wird er auch von dieser verspeist.

Desweiteren bietet einem jeder Level noch ein Zeitlimit an, sollte Karl es nicht
schaffen innerhalb dieses Zeitlimits sein Nest zu erreichen zerfllt er leider
durch Alterschwche zu Staub.
Dieses Zeitlimit kann von Level zu Level variieren.

Ach, ja erreicht der Spieler 10000 Punkte oder ein vielfaches davon, bekommt
er einen Karl dazu.

Ob in der SHAREWARE Version wirklich alle oben genannten 'Sachen' auftauchen,
weiss ich noch nicht, kann man aber leicht durch Spielen herausfinden !


Bedienung
=========

Die Tasten fr die Fortbewegung des Frosches habe ich ja schon erwhnt, die
wiederhole ich auch nicht, die sind ziemlich intuitiv.

Whrend des Spieles kann man noch folgende Tasten drcken ( drcken kann man
alle, aber nur die folgenden haben einen bemerkbaren Effekt ) :

P       -       Pause-Toggle
ESC     -       Spiel abbrechen ( keine Sicherheitsabfrage )
c       -       Cheatmode-Toggle ( keine Highscoreeintragung mglich )
+       -       Musik lauter (10er Block)
-       -       Musik leiser (10er Block)
0       -       Karl springt schnell ( default )
1       -       Karl springt normal ( sieht besser aus, kann man aber
                leider schlechter spielen
2       -       Karl springt langsam ( man kann die Animation sehr gut
                sehen, leider wird das Spielen fast unmglich )

Ausserhalb des Spiels, wenn der Titelschriftzug sichtbar ist, kann man
folgende Tasten benutzen um einen Effekt zu erzielen.

SPACE   -       Spiel starten
ESC     -       Ausgang zu DOS
M       -       Musik und Geraeusche Einstellungen
Q       -       Geschwindigekeitstest
C       -       Copyright Meldung
I       -       Info, oder About, wer, wann, wo was geschrieben hat
R       -       Der Shareware Hinweis ( wer sich daran nicht sattsehen kann )
S       -       Anzeige der Highscore Tabelle
L       -       Einstellen des Startlevels
+       -       Musik lauter (10er Block)
-       -       Musik leiser (10er Block)

 Sonstiges
===========

Ich mchte noch erwhnen, da ich fr smtliche Audio-Sachen das MODOBJ Modul
von Mark J. Cox verwende. Leider ist das Teil schon etwas lter, daher
untersttzt es viele neuere Soundkarten nicht. Kennt Jemand eine neuere
universellere Abspielmglichkeit fr Sounds ?
( Ich bin zu faul mich selber eingehender damit zu beschftigen ! )

Die Grafikroutinen die ich verwende stammen zu einem groen Teil aus der
MODEX-Library von Matt Pritchard.
Fr Pacman hatte ich meine eigenen Routinen verwendet, diese waren fr Frogger
allerdings nicht schnell genug. Ich htte mir auch selber bessere Routinen
schreiben knnen ( man lernt schlielich dazu ), aber warum das Rad zweimal
erfinden ? ( Ich hatte auch schon die eine und andere Routine fertig, die sogar
  noch schneller war, als die von Matt Pritchard, aber die Library an sich war
  fr meine Anwendung gut und schnell genug. Ich htte nochmal sehr viel
  Zeit investieren muessen um smtliche bentigten Unterroutinen zu einem
  brauchbaren Paket zusammenzufgen. )
So habe ich groe Teile von der MODEX Library verwendet, und diese
teilweise fr meine Bedrfnisse abgendert.

Die Testroutine fr die Prozessoren habe ich aus einer Routinensammlung von
Intel entnommen, die speziell fr Prozessortests ausgeliefert wurde. Sie ist
Public Domain.

Whrend des Spieles habe ich allerhand Interrupts abgeschaltet. Auch verbiege
ich den normalen Tastaturhandler. Inspiriert wurde ich durch ein kleines
Programm von Lee Hamel, das eben diesen Interrupt verbiegt.
Allerdings war die Version, die ich von seinem Programm hatte nicht ganz
korrekt, so dass ich auch diese Routinen neu geschrieben und meinen
Bedrfnissen angepasst habe.


 Bekannte Unzulnglichkeiten
=============================

WINDOWS
        Leider sollte man unter Windows ( hauptschlich im erweiterten Modus )
        nur ohne Sounds und Musik spielen, da MODOBJ davon beeinflusst wird,
        und damit das Spielen nahezu unmglich wird.


MIX-GESCHWINDIGKEIT
        Sollte diese zu hoch eingestellt werden, dann wird sich der Computer
        wahrscheinlich verabschieden. Daran kann ich leider nichts machen,
        da die Soundroutinen nicht von mir sind.

NOVELLDOS 7.00
        Ein Freund von mir hat Novell Dos 7.00. Er hat 639.000 KB freien
        Speicher. Trotzdem meint das MODOBJ Modul zu wenig Speicher zu
        haben um die Musik richtig laden zu koennen.
        Keine Ahnung warum. Wir haben beim Hochfahren des Rechners F5
        gedrckt, und somit keine config.sys oder autoexec.bat
        durchlaufen lassen ( wohl aber mit Novell Dos 7.00 gestartet ).
        Dann lief alles einwandfrei. Auf Grund mangelnder Testmglichkeiten,
        weiss ich jetzt nicht, ob mein Freund irgendwelchen exotischen
        TSR oder Treiber geladen hatte, oder ob das was mit Novell Dos 7.00
        zu tun hat. Also, falls bei Jemanden so etwas auftritt, DON'T PANIC !
        Just do it the other way.

        Ansonsten hat Novell Dos scheinbar auch einige Schwierigkeiten mit
        MODOBJ. Falls alles ausprobieren nichts ntzt, dann am Besten ohne
        Sound & Musik spielen. ( Ich kann nichts dafr, tut mir Leid.
        Falls Jemand eine besser Abspielmglichkeit wei, dann bin ich
        gerne bereit diese in Anspruch zu nehmen ).

SPEICHERBEDARF
        Keine Ahnung ! Ich habe ca. 618kB frei. Soviel braucht man garantiert
        nicht. Wenn zu wenig fr die Musik da ist, blinkt der Bildschirm kurz
        auf. Dann wird versucht nur die Geraeusche zu laden ( Ersparniss ca.
        70 KB ). Schlaegt auch das fehl, wird das Spiel ganz ohne Sound
        gestartet ( Ersparnis nochmal ca. 25 KB ). Wenn dann nicht genug
        Speicher da ist ... Pech gehabt, dann muss man sich irgendwie
        anders behelfen.

 Bekannte Bugs im Programm
===========================

- Manchmal taucht ein Otter auf, der nur auf einer Bildschirmseite
  dargestellt ist, das heit er flimmert sehr stark.
  ( Habe versucht diesen Fehler zu beseitigen, seit dem ist er nicht mehr
    aufgetaucht, ich kann allerdings nicht sicher sein, da der Fehler
    wirklich drauen ist, da er sehr selten auftrat )

- Manchmal bleibt ein Punkt von dem Weibchen ( ROSA ) 'hngen',
  das heit er wird nicht gelscht.
  Dieser Fehler tritt auch sehr selten auf, und ich wei nicht wann und
  warum.

- Manchmal erscheint nach einer Animationssequenz in der zweiten Autoreihe
  eine kleine hell-blaue Flche, die aber von den nachfolgenden Autos wieder
  gelscht wird. Auch dieser Fehler tritt sehr selten auf, ich habe
  noch keine Ahnung woran das liegen kann.
  ( Vermutung: irgendwas mit Animation und Otter ! )

Sollte Jemand nhere Hinweise zu den Bugs haben, oder weitere entdecken,
so bitte ich um Benachrichtigung.
Gnstig wre es zu wissen, WAS genau dieses Verhalten auslst, so da ich
es nachvollziehen kann.
Smtliche Bug-Berichte bitte mit Versionsangabe von 'Karl Quappe'
und Hardware - Konfiguration des Gertes auf dem der Fehler entdeckt wurde.
Wenn mglich eine Kopie der config.sys und autoexec.bat beilegen.



So, viel Spass mit KARL  wnscht

                                        Malban


