(* --------------------- DOKUMENTATION --------------------- *)
(* --------------- zum Screen Support Modul ---------------- *)

    -----------++++++****** OBERON ******++++++-----------

WRITTEN BY STEFAN HELLWIG 1992. RELEASED TO THE ZOC LIBRARY !!!

Electronic Mail Contacts:

Z-Netz (Germany) : STEFAN_HELLWIG@URANUS.ZER
UseNet/Internet  : stefan_hellwig@uranus.zer.sub.org
or               : osgo.ks.he.schule.de!uranus.zer.sub.org!stefan_hellwig
-------------------------------------------------------------------------

ScreenSupport ist ein Modul zur Vereinfachung des Umgangs mit Public-Screens
unter Amiga-OS 2.04 oder hoeher. Es wurde vorallem zur Ergaenzung der ZOC
(Zerberus Oberon Club) public domain library programmiert und wird noch
staendig erweitert und verbessert.

Momentan (Stand: 30.8.92) beinhaltet ScreenSupport folgende Funktionen:

OpenPubScr  - Oeffnen eines Standard-Public-Screens im Text-Overscan
ClosePubScr - Schliessen von Public-Screens
WaitPubScr  - Warten auf das Schliessen des letzten Windows auf einem
              Public-Screen mit evtl. anschliessenden Schliessung des Screens
DefPubScr   - Setzen des default public screen
ScrPublic   - Screen dem System als "public" melden
ScrPrivate  - Screen dem System als "privat" melden

GetVisibleArea  - Ermittlung des momentan sichtbaren Screen-Bereichs
                  (wichtig vorallem bei autoscrollenden Virtualscreens)
FreeVisibleArea - Freigeben der ermittelten Daten von GetVisibleArea()
CenterWindow    - Zentrieren eines Windows auf dem sichtbaren Screen-Bereichs

Momentan moegen die PubScreen-Funktionen noch etwas "primitiv" erscheinen,
aber sie funktionieren ;-). Es gibt hier sicherlich noch andere Loesungs-
moeglichkeiten und ich bin fuer jeden konstruktiven Vorschlag dankbar. Das
Supportmodul wurde innerhalb eines Tages "zusammengehackt", ausgetestet
und scheint gut zu funktionieren.

Naehere Details zum Aufruf und dem Umgang mit den enthaltenen Funktionen
sind in Kommentaren im Modul "ScreenSupport.mod" zu finden. Dazu gibt es
noch drei Demoprogramme ("PubWinTest.mod", "PubScreen3.mod" und
"DefPubScr2.mod"), die den Umgang mit dem Modul ein wenig demonstrieren
sollen.

Viel Spass damit.                              Stefan Hellwig, 31-Aug-92