
Kleine Doku zum PD-Programm Schoner 0.9
=======================================

Zuallerst: Bitte dieses Programm nicht allzu ernst nehmen! Ist eigentlich
nur eine "Spielerei" von mir gewesen und hat diesen Status noch nicht so
ganz berwunden... Bestimmt sind auch noch einige mehr oder weniger
gravierende Bugs in dem Teil! Aber nun zur Sache:

Wenn man sich die schnen Bildschirmschner (Afterdark etc.) auf MACs und
PCs ansieht, htte man auf dem heimischen Atari vielleicht auch gerne einen
hnlich schicken Schoner. Nur woher nehmen? Na gut, man knnte sich Midnight
installieren, das aber mit knapp 100 Mark die Kasse schon ganz erheblich
belastet... :-(

Andererseits knnte man sich auch selbst so ein Teil selber schreiben. Also:
Der Warp-8-Effekt sollte schon dabei sein. Natrlich auch das Bildschirm-
puzzle, die fliegenden Toaster und das Aquarium. Auerdem sollte das Teil
auch mit Grafikkarten und Mag!x laufen. Diese Wunschliste habe ich
kurzerhand (wg. Arbeitsaufwand) um das Aquarium und die Toaster gekrzt und
schonmal die beiden anderen Schoner implementiert. Damit war das Programm an
einem lauen Nachmittag samt zugehrigem Abend in neuer Rekordgeschwindigkeit
programmiert und aus (ziemlich) alten eigenen Programmen zusammengeklaubt.
Ich hoffe, man sieht's dem Code nicht allzusehr an ;-)

Damit es nicht so langweilig wird, dachte ich mir, da vielleicht der ein
oder andere noch einen anderen eigenen Schoner einbauen mchte (vielleicht
das Aquarium oder die Toaster! Lechz!). Damit das ganz einfach geht, liefere
ich einfach die C-Quellen zum Schoner mit. Das Resource wurde mit "RSC2CSRC"
von Hansi Richstein und Erik Dick (erhltlich z.B. bei MAXON) decompiliert.
Wer also Lust hat, kann gerne im Code rumeditieren und neue Features
einbauen! Aber bitte _niemals_ direkt in den Bildschirm schreiben, undoku-
mentierte Variablen verwenden, mein Copyright entfernen, diese Anleitung
ndern (hchstens gekennzeichnet erweitern oder Rchtsschroibfhlr
rausmachen) o..! Wer's doch tut, der kriegt grne Finger! Auf immer und
ewig! Ich wre dagegen fr ein Exemplar mit neuen "sauberen" Features und
weniger Bugs immer empfnglich und dankbar. Vielleicht hat ja auch noch
jemand tolle neue Ideen? :-)

Wie bedient man's?
==================

Schoner ist ein normales Accessory, das beim Booten des Rechners oder
mittels Chamelion geladen werden kann. Beim Anklicken erscheint ein Dialog,
in dem man das gewnschte Schonverfahren und die Zeit bis zum Schonbeginn
angeben kann. Die Einstellungen knnen dort auch gesichert werden. Beim
nchsten Start des Schoners werden diese dann bernommen.

Es gibt 2 spezielle Ecken auf dem Schirm. Rechts unten wird sofort geschont,
und links unten nie. Die XBRA-Kennung des Schoners lautet naheliegenderweise
"SCHO". Der Rest sollte eigentlich hoffentlich klar sein...

Wie funktioniert's?
===================

Schoner ist ein normales GEM-Accessories, das auf Anklick-Messages und
Timer-Events reagiert. Die verstrichene Zeit wird per Abfrage des 200Hz-
Zhlers des TOS ermittelt. Daneben gibt es noch einige Assemblerroutinen,
die an verschiedenen Vektoren (vornehmlich an mousevec, joyvec, ikbdsys, und
dem RS232-Overflow-Vektor) horchen und bei nderungen die Flagge "act_flag"
auf $FFFF setzen. Smtliche Schonverfahren sollten ihre "Arbeit" umgehendst
einstellen, sobald diese Flagge <>0 ist.

Whrend des Schonens ist wind_update gesetzt und die Maus ausgeschaltet.
Nach Beenden des Schonens wird per FMD_FINISH ein Redraw ber den ganzen
Schirm ausgelst. Dabei zeichnet das GEM jedoch den Menuebalken nicht neu
:-(((, so da dieser per vro_cpyfm zwischengespeichert werden mu. Wenn kein
Speicher (wird dynamisch allokiert!) verfgbar ist, kann diese Pufferung
nicht stattfinden, und der Menuebalken ist bis zum nchsten Programmwechsel
berschrieben. Keine Ahnung, was man da machen kann. Hat jemand eine Idee?
Kann gar etwa das GEM selbst den Menuebalken neumalen, wenn man den Redraw
nur geeignet veranlat???

Neue Routinen kann man in der switch-Anweisung im C-Unterprogramm
"schone_mal" einklinken. Diese sollten natrlich auch im RSC als Buttons
(Radio, Selectable, Touchexit) vorhanden sein. Die Codierung des
Schonverfahrens geschieht mittels der RSC-Nummer des entsprechenden Buttons
im Resource. Als Programmiersprache habe ich Pure-C verwendet. Was sonst!?

In der Konfigurationsdatei sind die Schonverfahren von 0 aufwrts so
numeriert wie sie im Dialog von oben nach unten sichtbar sind.

brigens ist so ein Bildschirmpuzzle garnicht so einfach zu programmieren,
wie man anfangs zu denken geneigt ist. Man mu nmlich den Schirm horizontal
und vertikal in gleichartige Blcke unterteilen, was bei manchen
Schirmgren (z.B. 2 Primzahlen als Schirm-X/Y-Auflsung) unmglich sein
kann. Der Schoner arbeitet daher mit dem ggt und anderen Tricks, um zu
versuchen, mit auch mit verschiedenen obskuren Auflsungen klarzukommen.
Wenn alle Mhe vergebens war, gibt der Schoner auf und malt dann eben den
Sternenhimmel bei Warp 8 trotz angeklicktem Puzzle. Seufz!

Im Modul RESOURCE.C sind diverse Routinen fr Radiobuttons und Checkboxen,
die mir Dirk Sabiwalsky freundlicherweise zur Verfgung gestellt hat. Thanx!

Fazit
=====

Natrlich lehne ich jede Verantwortung ab, die aus dem Gebrauch, Mibrauch,
Verbrauch, Verzehr und Verleih dieses Programms entstehen knnte.
Wer den "Schoner" verwenden und/oder erweitern mchte, ist herzlich
eingeladen, tut das aber auf eigenes Risiko! Aber keine Angst: Ich habe
keine absichtlichen Fehler eingebaut oder Kommandos, die gnadenlos die
Platte formatieren... ;-) Mein "Support" wird auch nicht sooo groartig
sein, weil es halt nur ein kleines, eigentlich nicht ernstzunehmendes
"Gimmick" ist und ich auerdem jede Menge wichtige Sachen zu tun habe. Fr
Glckwnsche, gute Tips, wste Beschimpfungen, glhende Lobesreden,
Bugreports, Anregungen und Geldsendungen, jedoch besonders fr neue
Versionen mit neuen Schonverfahren, neuen Features oder weniger Bugs bin ich
aber immer zu haben! Man kann mich im Mausnetz in @ ZW erreichen.

Viel Spa mit dem Gimmick-Schoner wnscht:

   Stefan Becker (Maus: @ ZW), Stand: 24.1.93


Gude!

Als ich den Schoner sah, kam ich nicht umhin, ein neues Modul zu schreiben (Lechtz!)
Hier ist Es!

Der Bildschirm schmiert so komisch nach unten weg, so als wenn einer im
Louvre mit ner Saeurebombe rumspielt :-)
(Sieht besonders gut in Farbe aus!)

Nennt sich: "Es regnet..."

Tschoe, Thorsten Pohlmann @ WI2 oder 2:248/4.8

