CATpost 1.01                                                23.08.1998


Sinn und Zweck

CATpost soll ein Sample abspielen, wenn neue PMs in der CAT-Message-
base vorliegen. Auf die Idee brachte mich das Sample "Sie haben Post",
das CATpost auch beiliegt.


Installation

Laden Sie die Datei CATPOST.INF in einen beliebigen Texteditor und
passen Sie die Pfade an Ihre Verhltnisse an. Zeilen, die mit einem
#-Zeichen beginnen, sind Kommentare. Es gibt fnf Schlsselwrter,
die alle mit einem Doppelpunkt enden mssen ("data:", "prog:",
"post:", "nope:" und "start:"). Zeilen, die etwas anderes enthalten
oder leer sind, werden schlicht ignoriert.

Hinter den Schlsselwrtern mssen folgende Informationen stehen:

data:  Der Pfad des DATABASE-Ordners fr CAT
prog:  Das Programm, das gestartet werden soll (meistens CAT).

CATpost sollte statt CAT vom Desktop gestartet werden. Es sieht dann
nach, ob neue PMs vorliegen, spielt ggfs. ein Sample ab und startet
dann CAT nach. Statt CAT knnen Sie aber auch CATalog starten lassen,
das dann seinerseits CAT startet. CATpost beendet sich selbst wieder,
sobald das Sample zuende ist. Unter SingleTOS wird CAT (bzw. das
Programm hinter "prog:") erst nach dem Ende des Samples gestartet,
unter einem Multitasking-System wird CAT parallel gestartet. Wenn das
zu startende Programm Parameter bentigt, knnen Sie diese einfach
hinter den Programmnamen schreiben (mit einem Leerzeichen dazwischen
und maximal 124 Zeichen).

Die anderen drei Schlsselwrter geben die Samples an:

post:  Dieses Sample wird abgespielt, wenn neue PMs vorliegen.
nope:  Dieses Sample wird abgespielt, wenn keine neuen PMs vorliegen
       und CATpost als I/O-Filter gestartet wurde.
start: Dieses Sample wird abgespielt, wenn keine neuen PMs vorliegen
       und CATpost vom Desktop gestartet wurde.

Die Samples "nope:" und "start:" knnen auch fehlen, dann wird in
der entsprechenden Situation eben kein Sample abgespielt. Fr "post:"
mu aber immer ein Sample angegeben werden.

Die Samples mssen im CrazySounds-Format (*.HSN) vorliegen. Um Samples
abspielen zu knnen, mu eine der folgenden Bedingungen zutreffen:

- der Rechner mu ber DMA-Sound-Hardware verfgen (Atari STE,
  Mega STE, TT oder Falcon)
- eines der Programme MacSound oder WeirdMac mu installiert sein
  (unter MagiCMac)
- das Programm Petra mu installiert sein (alte ST-Modelle)

Wer mein Kartenspiel Yukon kennt: Die Abspielroutinen von CATpost
sind die gleichen wie in Yukon.

Wenn Sie alle Pfade angepat haben, knnen Sie CATPOST.INF entweder
in das Verzeichnis kopieren, in dem auch CATpost steht, oder in
den Ordner $HOME/defaults oder in $HOME.


Installation als I/O-Filter

Natrlich soll das Sample fr neue PMs nicht nur beim Start von CAT
sondern auch dann abgespielt werden, wenn in CAT ein neues Outfile
eingefgt wird. Dazu mu CATpost zustzlich noch als I/O-Filter in CAT
installiert werden. Das geht so:

- CAT starten
- suchen Sie im Dialog "In- und Outfile-Filter installieren"
  (Menpunkt "I/O-Filter" im Men "Optionen") einen freien Filter-Slot
- tragen Sie unter "Name:" 'CATpost' ein
- klicken Sie auf den Button hinter "Programm:" und suchen Sie im
  Fileselektor die Datei CATPOST.APP
- whlen Sie unter "Wofr:" 'nach Einsortieren'
- geben Sie als Kommandozeile '--filter' (ohne Hochkommata, aber mit
  zwei(!) Minuszeichen) ein
- klicken Sie auf "aktiv", so da dies angekreuzt ist
- Optionen sichern
- Fertig.

Wenn Sie das nchste Mal ein Outfile einfgen, werden Sie nun hren
knnen, ob Sie neue PMs bekommen haben oder nicht.


Anmerkungen

- CATpost bentigt CAT 2.5 oder neuer
- bei neueren oder lteren CAT-Versionen erscheint ein entsprechender
  Hinweis. Es wird aber in jedem Fall das Sample "nope:" oder "start:"
  (je nach Situation) abgespielt. Mit einer zu alten oder zu neuen
  Version wird das "post:"-Sample niemals erklingen.
- Die Fehlermeldungen von CATpost sind etwas knapp gehalten. Um
  genau zu sein, gibt es ganze drei Fehlermeldungen:

  "Falsches Datenbank-Format"
  Die CAT-Version ist zu alt (kleiner 2.5) oder zu neu (falls Dirk
  Steins in Zukunft einmal das Datenbankformat ndern sollte)

  "Fehler beim Lesen der INF-Datei"
  Die INF-Datei konnte nicht gefunden oder nicht gelesen werden (kann
  auch Speichermangel sein), oder es fehlte eins der drei verbindlichen
  Schlsselwrter "data:", "prog:" oder "post:".

  "Trabbel mit dem Sound"
  Ein Sample wurde nicht gefunden, konnte nicht geladen werden (auch:
  Speichermangel) oder konnte nicht abgespielt werden (fehlende
  Abspielmglichkeit, siehe oben).


Neu in Version 1.01

- Bugfix: Manchmal wurde ein falsches Sample abgespielt.
  Die Situtation: Wenn man mit einem Tausch sowohl neue PMs bekam, als
  auch selbst welche abgeschickt hatte, anschlieend nur die neuen,
  nicht aber die eigenen las und CAT verlie, meldete CATpost beim
  nchsten Start trotzdem wieder "Sie haben Post".

- Bugfix: Es wird jetzt in den Pfad des nachzustartenden Programms
  (Schlsselwort "prog:") gewechselt. Einige Programme hatten
  Probleme damit, da das aktuelle Verzeichnis nicht ihr eigenes war
  und fanden INF-Files und hnliches nicht.


Rechtliches

CATpost ist Freeware, (c) 1996-98 by Terra Software Systems/Dirk Haun.
Eine unentgeltliche Weitergabe ist gestattet, insbesondere ber
Mailboxen sowie per ftp.


Autor

Dirk Haun
Johanniterstr. 3
74177 Bad Friedrichshall

e-mail: Dirk Haun @ LB (MausNet)
