
FORTUNE V1.1

von Harald Schnfeld und Bernd Spellenberg

17.4.94


Fortune ist ein Programm zum Abspielen und Verwalten von Sound- Zitat- Files
fr den ATARI FALCON. Wie bei groen UNIX-Rechnern blich, begrt Sie Ihr
Computer beim Einschalten mit einem Zitat einer bekannten Persnlichkeit.
Whrend bei blichen Computern die Zitate nur auf den Bildschirm geschrieben
werden, erlaubt es der FALCON, da diese wirklich in der Originalversion zu
hren sind.

Dieses Programm ist in dieser Version Public Domain. Das Program darf von
Privatpersonen fr nicht kommerzielle Zwecke kopiert und weitergegeben
werden unter der Voraussetzung, da alle Programm- und Text-Files dieses
Archivs unverndert enthalten sind. Ein Vertrieb in PD-Disk Reihen,
Verffentlichung in Zeitschriften und die kommerzielle Verwendung bedarf der
ausdrcklichen Genehmigung der Autoren.

Zitate bestehen aus den Sounddaten, dem Zitattext und eventuell weiteren
Informationen ber das Zitat. Im Bootmodus des Fortune-Programms werden die
Zitate einfach mit oder ohne Text abgespielt. Wird das Programm spter "von
Hand" gestartet kann man die Zitate bearbeiten und neue Zitate aus Samples
erstellen.

Eine ntzliches Feature von Fortune ist, da man viele verschiedene Sound-
formate importieren, und auch in andere Formate umwandeln kann.

Neu in Version 1.1:

- Timer-Funktion (bes. unter MultiTOS)
- verschiedene Boot-Modi
- Kommandozeilenauswertung
- Drag & Drop (nur MultiTOS)
- Untersttzung der 3D-Effekte auf dem Falcon ab TOS 4.02 oder MultiTOS
- Short-Cuts
- Diverse Bugs gefixed


1. Systemvoraussetzungen

Fortune luft auf allen Computern der FALCON-Serie, egal ob mit oder ohne
MultiTOS. Da die Zitate gesampelte Sounds enthalten belegen sie relativ
viel Platz auf dem Massenspeicher. Eine Festplatte ist somit unbedingt
notwendig. Fortune bentigt ungefhr 500KB freien RAM-Speicher. Damit sie
die Zitate hren knnen, mssen Sie entweder den internen Lautsprecher
anschalten, den Ton ber den Monitor wiedergeben oder (am besten) einen
Stereoverstrker anschliessen. Sie knnen auch einen Kopfhrer benutzen.



2. Installation

Kopieren Sie das Programm (FORTUNEG.PRG=deutsch, FORTUNEE.PRG=englisch) auf
Ihre Festplatte. Kopieren Sie die Zitatfiles (*.CIT) in einen Ordner auf
Ihre Platte.

Melden Sie nun FORTUNEx.PRG als Anwendung an. Dazu selektieren Sie
FORTUNEx.PRG mit der Maus und whlen im Desktop den Menpunkt "Anwendung
anmelden" an. Geben Sie als Parameter "MANAGE " an. Wenn Sie wollen, da
Fortune beim Booten gestartet wird, whlen Sie als Boot-Status "Auto" an.
Nun speichern Sie die Desktop-Konfiguration mit "Arbeit sichern".

Starten Sie nun FORTUNEx.PRG und whlen Sie den Menpunkt
"Konfig/Fileformat..." an. Legen Sie nun den Ordner fest, in dem sich die
Zitatfiles befinden. Klicken Sie dazu auf das PopUp "Zitat-Ordner" und geben
Sie in der folgenden Fileselectbox den Pfad an. Sollten Sie auch schon einen
speziellen Ordner fr Samples haben, knnen Sie diesen genauso festlegen.
Speichern Sie die Konfiguration mit "Konfig/Sichern" ab.

Whlen Sie nun "Datei/Zitat" an. Fortune whlt nun zufllig eines der
vorhandenen Zitate aus und spielt es vor. Sollten Sie nichts hren
berprfen Sie ob Sie alle obigen Schritte korrekt ausgefhrt haben.



3. Bedienung


a) Bootmodus

Im Bootmodus spielt Fortune nur ein Zitat vor (und zeigt eventuell dessen
Text an) und beendet sich danach automatisch wieder. Wird whrend des
Startens im Bootmodus eine SHIFT-Taste gedrckt, so wechselt Fortune in den
Manage-Modus.

Der Bootmodus wird aktiviert durch:

- kein bergabeparameter: Ein zuflliges Zitat wird gespielt
- "BOOT " als einzigen bergabeparameter: Wie oben
- "BOOT NAME.CIT" als Parameter: Das Zitat mit dem Namen 'NAME.CIT' wird
  gespielt.

Die Parameter knnen zum Beispiel per Kommandozeile bergeben werden. Man
kann das Programm auch als Applikation im Desktop anmelden und "BOOT " als
Parameter angeben. Wird im Desktop ein Zitatfile-Icon auf das FORTUNE-Icon
geschoben, so wird der Filename mit ausgewertet. Achtung: Im MultiTOS wird
dabei der, bei "Anwendung anmelden" eingegebene Parameter verworfen.

b) Managemodus

Bei normalen Programmstarts erscheint das Fortune-Men. 
Der Managemodus wird aktiviert durch:

- "MANAGE " als bergabeparamter: Das Hauptmen erscheint.
- Shift-Taste whrend des Startens gedrckt halten: Wie oben.
- Durch Aktivieren der Weckfunktion: Wie oben
- "FILE.CIT" als Parameter: Das Zitat wird vorgespielt, dann erscheint das
  Hauptmen.
- "MANAGE FILE.CIT": Wie oben.


Es gibt die folgenden Menpunkte mit ihren Funktionen:


Desk/ber FORTUNE...

Gibt Informationen ber die Versionsnummer von Fortune.


Datei/Zitat

Spielt zufllig ein Zitat vor. Je nach "Konfig/Abspielmodus..." wird der
Text mit angezeigt oder nicht. Die Soundaten werden dabei in Echtzeit von
Platte geladen, d.h. es wird nur sehr wenig RAM-Speicher bentigt. Sie
knnen also sehr lange Zitate (oder auch Musikteile) abspielen. Sollten
parallel andere Programme laufen kann es aber sein, da "die Platte
hngenbleibt", weil die Daten nicht schnell genug geladen werden knnen.


Datei/Manager...

Hier knnen Sie Samples zum Importieren ins Zitat whlen, Ausschnitte aus
Sounddaten whlen, Samples exportieren und Zitate laden und speichern. Auch
die Textinformationen der Zitate knnen Sie hier eingeben.

Zu Beginn mssen Sie ein Sample oder ein schon bestehendes Zitat whlen:

Klicken Sie dazu auf das PopUp Import/Sample oder Import/Zitat. Das File
wird geladen und analysiert. Der Filename erscheint nun im PopUp. Sie
knnen immer nur ein Sample ODER ein Zitat als Input whlen.
Sie knnen unter MultiTOS 1.08 dazu aber auch einfach ein Zitatfile-Icon aus
einem Desktopfenster auf den Manage-Dialog schieben.

Sollte Fortune keinen Fileheader erkennen, so ffnet sich eine Box, in der
Sie selbst das Format der zu ladenden Sampledaten festlegen knnen:
- Die Frequenz
- Das Pack/Datenformat
- Das Zahlenformat (mit oder ohne Vorzeichen)
Viele alte ST-samples sind 8-Bit Mono ohne Vorzeichen.

Die Textinformationen des Zitats knnen Sie mit "Zitat", "Quelle" und
"Bemerkung" editieren. Wenn Sie den jeweiligen Button anwhlen erscheint eine
Box, in der Sie den Text eingeben knnen. Orientieren Sie sich dabei an den
von uns vorgegebenen Zitaten. Sie knnen auch angeben, in welcher Sprache
das Zitat gesprochen ist.
Wenn Sie ein Samplefile als Import whlen und schon Textdaten des vorherigen
Zitats vorhanden sind, so knnen Sie whlen ob diese beibehalten werden
sollen.

Mit "Ausschnitt" knnen Sie auf 1/100 Sekunde genau den Anfang und Ende des
Zitats in den geladenen Sounddaten festlegen. Den Beginn legen Sie mit den 4
linken Knpfen fest, das Ende mit den 4 rechten. "Play" spielt den aktuellen
Ausschnitt vor. Die exakte Wahl des Ausschnitts ist wichtig, damit keine
Strgerusche zu hren sind und ausserdem kostet jede unntige 1/100 Sekunde
bis zu 2000 Bytes Platz auf der Platte!

"Info" zeigt Informationen zum gewhlten Input-File an. Die angezeigte Lnge
bezieht sich nur auf die Lnge der Sounddaten (ohne Header).

"Zitieren" spielt den Zitatsound vor.

Abspeichern der Samples und Zitate:

Im Bereich "Speichern" finden Sie 2 Knpfe und 2 PopUps zum Abspeichern.
Normalerweise sollten Sie zuerst das PopUp anwhlen um in der folgenden
Dialogbox den Filenamen anzugeben. Die Daten werden nun gespeichert und der
Name wird im PopUp angezeigt.
Ist im PopUp schon ein Name vorhanden, knnen Sie auch den daneben
befindlichen Knopf anklicken. Die Daten werden dann sofort mit dem selben
Namen abgespeichert.

Sind Import- und Export-Zitat identisch, wird beim Speichern ein temporres
File auf der Platte erzeugt. Es knnte deshalb sein da der
Abspeichervorgang nicht beendet werden kann, obwohl fr dieses eine Zitat
noch Platz wre.


Datei/Ende

Verlt das Programm.


Konfig/Fileformat...

Hier knnen Sie zunchst die Standard-Pfade fr die Sample- und Zitatfiles
angeben. Klicken Sie dazu das jeweilige PopUp an und geben Sie den Ordner
an.

Sampleformat whlen

Fortune kann Samples in 5 verschiedenen Formaten lesen und schreiben:
- DVSM: Fr Fortune und WinRec
- AVR: Viele ATARI St/Falcon Programme
- SND: Sun, NeXT, Mac
- WAV: PC
- Rohdaten: Rohdaten fr viele Programme

Packformat whlen

Auderdem knnen Sie festlegen, in welchem Packformat Zitatsounds
abgespeichert und Samples exportiert werden sollen. Grundstzlich gibt es
die folgenden Formate (nicht alle sind fr jeden Fall implementiert):

- Beibehalten: Sounddaten nicht verndern.
- 16 Bit Stereo: 2 Kanle mit 16 Bit abspeichern.
- 16 Bit Stereo deltapack: logarithmisch komprimierte Daten erzeugen, die
nur 50% Speicher belegen, aber fast wie 16 Bit klingen.
- 16 Bit Stereo -LAW: Komprimierung wie auf Sun und NeXT blich. Klingt
besser als 8 Bit, aber schlechter als deltapack.
- 8 Bit Stereo
- 16 Bit Mono: Sollen Stereodaten Mono abgespeichert werden, werden die
beiden Kanle zu einem addiert.
- 16 Bit Mono deltapack
- 16 Bit Mono -LAW
- 8 Bit Mono: Man sollte lieber deltapack verwenden!

Bedenken Sie, da es meist sinnlos ist von einem schlechteren Format auf ein
besseres zu wandeln. Es kostet nur mehr Speicher, wird aber nicht besser
klingen. Es knnte aber sein, da andere Programme nur bestimmte Formate
weiterverarbeiten knnen.
Eine Wandlung von -LAW nach DVS-deltapack wandelt zwar in ein besseres
Format um, kann jedoch zu etwas schlechteren Klangergebnissen fhren.
Zitate knnen nur dann als -LAW abgespeichert werden, wenn das Quellsample
in diesem Format vorliegt. Dazu whlen Sie "Beibehalten" an.

Speicher Optionen

Beim Abspeichern von Samples und Zitaten kann Fortune die Lautstrke auf
hchste Aussteuerung normieren. (Dies bezieht sich aber immer auf das
gesamte Sample, nicht nur auf den Ausschnitt der gespeichert wird. Somit
kann es sein, da das Sample doch nicht 100% ausgesteuert wird).

Auerdem kann ein Ein-und Ausblendeffekt angewhlt werden, der sich am
Anfang und Ende ber 0.2 Sekunden erstreckt. Sie sollten diesen Effekt nur
einmal auf ein Sample anwenden. Der Effekt ist erst hrbar, nachdem das
Sample gespeichert und wieder geladen wurde.


Konfig/Abspielmodus...

Zitatanzeige

Hier knnen Sie whlen wie zitiert werden soll. Ist "Zitieren ohne Text"
gewhlt, wird kein Text angezeigt. Nur der Sound ist zu hren. In MultiTOS
bedeutet das, da der Ablauf anderer Programme nicht behindert wird.
Ist "Zitieren mit Text" gewhlt, so wird solange der Sound ertnt der Text
in einer Box angezeigt und verschwindet danach automatisch.
Wenn Sie "Zitieren mit Dialog" whlen, so bleibt der Textdialog nach
Abspielen des Sounds weiter auf dem Bildschirm stehen. Wenn Sie nun
"Bemerkung" oder "Quelle" anwhlen, knnen Sie sich die Zusatzinformationen
zum Zitat ansehen. Mit "OK" verlassen Sie dann das Zitat.

Zitathufigkeit

Damit kann ausgewhlt werden, ob bei jedem Bootmodusstart ein Zitat gespielt
werden soll, oder hchstens einmal pro Stunde oder nur einmal pro Tag.
Besonders praktisch fr Programmierer die fters zum Resettaster greifen
mssen.

Weckfunktion

Hier kann man festlegen ob zu einem bestimmten Zeitpunkt automatisch ein
Zitat vorgespielt werden soll. Man kann whlen, ob dies zu jeder vollen
Stunde und/oder zu einer bestimmten Alarmzeit passieren soll.
Da das Programm dazu immer aktiv sein mu, ist diese Funktion nur unter
MultiTOS so richtig sinnvoll.

Die Alarmzeit kann eingetippt werden im HH:MM Format. Normalerweise wird ein
zuflliges Zitat vorgespielt. Ist dagegen bei 'Alarmzitat' ein Zitatfile
gewhlt, so wird dieses vorgespielt.


Die meisten Dialoge sind "Fly-Dials". Klicken Sie einfach in den freien
Hintergrundbereich des Dialogs um ihn bei gedrckter Maustaste zu
veschieben. Einige andere Dialoge sind in Windows untergebracht und mssen
somit nicht geschlossen werden wenn man weiterarbeiten will.

Durch Drcken der Shift-taste knnen sie das Vorspielen von Samples
jederzeit unterbrechen.



4. Interna

Ein untersttztes Sampleformat ist das DVSM-Format des Programms "WINREC".
Das Programm sollte dort zu haben sein, wo Sie Fortune erhalten haben.

Ein DVSM-Sample-File hat den folgenden Aufbau:

typedef struct
{
	char magic[6];     /* "DVSM" */
	int headlen;       /* Headlen in Bytes*/
	int freq;		   /* Samplefreqenz 0=8kHz 7=50kHz*/
	char pack;		   /* 0 ungepackt, 2=DVS Packmethode*/
	char mode;         /* 0=Stereo 8Bit,1=Stereo 16Bit,2=Mono 8Bit*/
	long blocklen;     /* falls pack>1: Lnge eines gepackten Blocks*/ 
} DVSMHEAD;

Dann folgen die 16-Bit Stereo-Daten (bzw. DVS-8 Bit Daten).

Die Samplefrequenzen 0 bis 7 entsprechen den folgenden Frequenzen:
sam_freq[8]={8195,9834,12292,16490,20770,24585,33880,49170};
Nheres siehe WinRec-Dokumentation.

Die Zitate werden im FORHEAD-Fortune-Format abgespeichert:

typedef struct
{
	char magic[24];         /* Versionsnummer z.Z. "Fortune V01.00" */
	int  lang;              /* Sprache des Zitats a la TOS */
	TEXTHEAD text;
	unsigned long t_length; /* Lnge der Textinformationen */
	FOSMHEAD sound;         
	unsigned long s_length; /* Lnge der Sounddaten */
	long res1;				/* reserviert */
	long res2;
}FORHEAD;

typedef struct
{
	long cite;			/* Lnge der einzelnen Informationsstrings */
	long signature;     /* einschl. Nullbyte am Ende */
	long author;
	long speaker;
	long source;
	long editor;
	long date;
	long remarks;
	long tres;			/* reserviert */
} TEXTHEAD;

Alle Texte sind Null-terminierte Strings. Cite und Remarks enthalten
hchstens je 5x40 Zeichen, jede Zeile wird mit "\n" beendet. Die anderen
Strings sind hchstens 40 Zeichen lang.

typedef struct
{
	char magic[6];		/* Info ber ursprngl. Sampleformat z.Z. "DVSM" */
	int freq;           /* siehe DVSMHEAD */
	char pack,mode;		/* s.u. */
	long real_l;        /* Expandierte Lnge */
	long pblock_l;		/* Kleinste entpackbare Blockgrsse, z.Z. 1 */
	long origfrequ;		/* Ursprungsfrequenz des Samples */
} FOSMHEAD;

Pack und Mode geben das Format der Daten an:

Ist Bit 0 in mode gesetzt, so liegen 16 Bit Daten vor, sonst 8 Bit.
Ist Bit 0 in pack gesetzt, so liegen Mono-Daten vor.
Ist Bit 1 in pack gesetzt, so liegen Deltapackdaten vor.
Ist Bit 2 in pack gesetzt, so liegen -LAW Daten vor.

Nach dem FORHEAD-Header folgen die Textdaten in der Reihenfolge wie im
Header. Danach folgen die Sounddaten.


Wird Fortune ohne Kommandozeilen-parameter gestartet (und wird die
SHIFT-Taste nicht gedrckt) so geht Fortune in den Boot-Modus. Normalerweise
wird jedoch (siehe Installation) der Parameter MANAGE bergeben, so da
Fortune in den Manage-Modus geht.



5. Bekannte Fehler

Noch keine ;-)



6. Zuknftige Versionen

- andere Kompressionsarten (ADPCM)
- weitere Editiermglichkeiten
- Playlist



7. Kontaktadresse

Anregungen, Vorschlge, Kommentare, Kritik, Bugreports und hbsche Zitate
(insbesondere auch Vorschlge und Informationen ber Kompressionsmethoden
und Fileformate) bitte richten an:

Harald Schnfeld
Email:
Harald.Schoenfeld@rzmail.uni-erlangen.de
Post:
Lerchenstrae 2, D-90587 Veitsbronn, Germany

Bernd Spellenberg
Email:
Bernd.Spellenberg@rzmail.uni-erlangen.de
Post:
Frther Strae 11, D-90617 Puschendorf, Germany

Es ist geplant auf dem Erlanger ftp-server "ftp.uni-erlangen.de" in
"/pub/atari/falcon" ein Zitat-Archiv einzurichten, wohin jeder eigene Zitate
uploaden kann. Besteht daran Interesse?



8. Release History

22.1.93: Version 1.0 Beta

26.2.93: Version 1.0
         - neue Soundformate: AVR, SND, WAV, Raw
         - neue Packformate: -LAW, deltapack
         - Anpassung an AES 4.02
         - einige Bugs gefixed
         - nderung des FOSM-Head (origfrequ)

17.4.94: Version 1.1
         - Timer-Funktion (bes. unter MultiTOS)
         - verschiedene Boot-Modi
         - Kommandozeilenauswertung 
         - Drag & Drop (nur MultiTOS)
         - Untersttzung der 3D-Effekte auf dem Falcon ab TOS 4.02 oder
           MultiTOS
         - Short-Cuts
         - Diverse Bugs gefixed
