

Kurzanleitung zu HackFax
========================


Was ist HackFax?
----------------

HackFax ist ein Programmpaket fr die Atari/TOS Computer und ein 
ZyXEL Fax-Modem. Mit Hilfe dieses Programmpaketes ist es mglich,
Fax Seiten zu Senden, zu Pollen, zu Empfangen, Anzuschauen, zu
Drucken und Weiterzuverarbeiten.

HackFax ist Freeware. D.h. man darf das Programmpaket unentgeltich
bentzen und beliebig oft kopieren und weitergeben. Die Weitergabe 
ist nur gestattet, wenn dafr keine Gebhren oder sonstige Zahlungen
verlangt werden. Eine Verbreitung ber Mailboxen ist erwnscht.

HackFax wurde von Helmut E. Neumann und Markus Bubendorf entwickelt.
Bei Problemen, Fragen, Fehlermeldungen und Verbesserungsvorschlge
wende man sich an Markus Bubendorf. Fehlermeldungen bitte immer mit
einer genauen Beschreibung des Fehlers und der Umgebung (Version von 
HackFax, TOS-Version, ROM-Version des Modems, AUTO-Programme, 
Accesories, Konfigurationsdateien, Kommandozeile, Startprogramm etc.)



Was gehrt zu HackFax?
----------------------

Dieses Paket enthlt nur die ausfhrbaren Programme mit den dazu
gehrenden Dateien. Auf Wunsch kann jeder Interessierte den Sourcecode
bei Markus beziehen. Dazu muss man lediglich eine formatierte Diskette
und das Geld fr das Rckporto (Bitte Schweizer Franken!) an Ihn schicken.

Dieses Paket enthlt HackFax in der Version 0.70. Dazu gehren die
folgenden Dateien. Sollte eine odere mehrere der Dateien fehlen, so
melde Dich bei Markus mit der Angabe, wo Du das Paket bezogen hast.

Datei                 Bemerkung
-------------------------------------------------------------------
FAXVIEW.PRG           Anzeige-, Druck- und Konvertierprogramm
FAXVIEW.RSC           Resource-File dazu
FAXVIEW.SYS           Gespeichertes Setup von FaxView
RCVFAX.TTP            Programm, um Fax-Seiten zu Empfangen
SENDFAX.TTP           Programm, um Fax-Seiten zu Senden
ASC2G3.TTP            Konverter ASCII-->Fax-Seiten
QFAX2G3.TTP           Konverter Fax-Seiten vom QFax-Format ins HackFax Format
HACKFAX.CFG           Konfigurationsdatei fr die Programme
FAX1628.FON           Zeichensatz (16*28) fr ASC2G3
FAX0816.FON           Zeichensatz ( 8*16) fr ASC2G3
FAX0814.FON
FAX0812.FON
FAX0716.FON
READ_ME.TXT           Dieser Text hier
BEISPIEL.TXT          Beispieltext fr ASC2G3
UPDATE.TXT            Text mit Neuerungen gegenber lteren Versionen



Wie bedient man HackFax?
------------------------


Als allererstes ist die Datei HACKFAX.CFG an die eigenen Bedrfnisse
und Gegebenheiten anzupassen. HACKFAX.CFG ist eine einfache Textdatei,
die mit jedem Editor editiert werden kann. Der Aufbau der Datei ist
in ihr selbst erklrt.


ASC2G3.TTP
----------

Aufruf: asc2g3 textfile

ASC2G3 konvertiert ein ASCII-Textfile in ein Fax-File. Dieses Fax-File
kann anschliessend mit SENDFAX.TTP verschickt werden. Die Konvertierung
geschieht gemss den Angaben in HACKFAX.CFG. Der Filename des Fax-Files
besteht aus dem Grundnamen des Textfiles plus der Endung FAX.

Innerhalb des Textfiles sind gewisse Steuermglichkeiten mit Hilfe von
Kommandos mglich. Alle Kommandos bestehen aus dem Zeichen '~' dem
direkt der Kommandobuchstabe folgen muss. Hinter dem Kommandobuchstaben
folgen direkt die Parameter (falls vorhanden).
Es wird unterschieden zwischen Zeilenkommandos und Buchstabenkommandos.
Die Zeilenkommandos mssen direkt am Zeilenanfang stehen und wirken
sich auf die nachfolgenden Zeilen aus. Text, der hinter einem Zeilen-
kommando steht, wird ignoriert.
Die Buchstabenkommandos drfen irgendwo innerhalb einer Textzeile 
stehen und ndern das Aussehen der einzelnen Buchstaben.

Folgende Zeilenkommandos sind mglich:

~Ln m : Zeilenabstand neu setzen. n gibt die Anzahl der Zeilen vor den
        Buchstaben an. m gitb die Anzahl der Zeilen nach den Buchstaben an.
~P    : Neue Seite beginnen
~Ifile: Textfile 'file' an der aktuellen Position einsetzen. Nachdem file
        abgearbeitet wurde, wird mit der aktuellen Textdatei weitergefahren.
        Es knnen max. 8 Texte ineinander verschachtelt werden.
~Cfile: Die Bearbeitung des aktuellen Textfiles wird beendet und es wird
        mit file weitergemacht.
~Ofile line from: Graphikdatei 'file' an der momentanten Position einfgen.
        Die Graphik wird ber den Text (wie Folien) gelegt. line gibt die
        max. Anzahl der Zeilen an. from gibt den Offset in Bytes an, den
        die Graphik vom linken Rand haben soll.
        Unterstzte Graphikformate: DOODLE 400*640
~Sfile line from: Wie ~O; die Graphik wird aber nicht ber den Text gelegt,
        sondern zwischen den Text eingefgt!
~Xn   : Zeichenabstand auf n Pixel ndern
~;    : Kommentarzeile
~:    : Kommentarzeile, die aber auf den Bildschirm und in das LogFile
        ausgegeben wird.

Buchstabenkommandos:

~B    : Auf Fettschrift umschalten (Noch nicht implementiert)
~N    : Normalschrift
~I    : Auf Schrgschrift umschalten (Noch nicht implementiert)
~U    : Buchstaben unterstreichen (Noch nicht implementiert)
~Cn   : Zeichenabstand auf n Pixel ndern


QFAX2G3.TTP
-----------

Aufruf: qfax2g3 qfaxfile [[qfaxfile]qfaxfile...] hackfaxfile

Die angegebenen QFax Dateien werden zu einer Datei zusammengefasst und
in der Datei hackfaxfile im HackFax Format gespeichert. Die Endung
dieser Datei lautet immer auf .FAX. Sollte die Datei hackfaxfile 
bereits existiert, so werden die QFax-Files an diese Datei angehngt.
Die Konvertierung ist nur dann mglich, wenn die Auflsung und die
Kodierungsart in allen Dateien gleich ist.

Rckgabewerte: 0: Konvertierung verlief ohne Fehler
               1: Fehler beim Konvertieren


RCVFAX.TTP
----------

Aufruf: rcvfax [MAILER|IMMED|WAIT|WAITONE]


Es werden ein oder mehrere Faxe empfangen. Wird keine Betriebsart in der
Kommandozeile angegeben, so wird die Standardbetriebsart gemss der
Konfigurationsdatei HACKFAX.CFG genommen. Ist beim Start von RCVFAX.TTP
die Leitung CD (Carrier Detect) aktiv, so wird unabhngig von den Angaben
immer die Betriebsart MAILER eingenommen. Die Betriebsart hat folgende
Auswirkungen auf das Verhalten des Programmes:

MAILER : Das Modem befindet sich bereits im Fax-Connect Zustand. Es kann
         sofort mit dem Empfangen der Faxseiten begonnen werden. Weder
         der INIT noch der RCVINIT String wird ans Modem geschickt. Die
         serielle Schnittstelle und das Modem muss vom aufrufenden Programm
         korrekt initialisiert worden sein. Die Parameter des Fax-Connects
         mssen noch im Puffer der seriellen Schnittstelle sein. Nach
         Empfang der Fax-Seiten wird das Programm beendet.
IMMED  : Das Modem und die serielle Schnittstelle wird initalisiert.
         Gleich anschliessend wird versucht, ein Connect zu erreichen. Bei
         einem Fax-Connect werden die Fax-Seiten empfangen. Bei einem
         sonstigen Connect wird das MAILER-Programm aus HACKFAX.CFG
         gestartet. Kommt kein Connect zustande, so wird das Programm
         beendet. Ebenso wird das Programm beendet, wenn die Fax-Seiten
         empfangen wurden und wenn das MAILER-PROGRAMM beendet wurde.
WAIT   : Es wird auf einen Anruf gewartet und nach der unter RING
         eingestellten Anzahl von RINGs entgegengenommen. Je nach Connect
         wird das MAILER-Programm gestartet oder die Fax-Seiten empfangen.
         Anschliessend geht das Programm wieder in die Warteschleife.
WAITONE: In dieser Betriebsart wartet RCVFAX.TTP ebenfalls auf einen Anruf.
         Nachdem dieser beantwortet wurde, wird das Programm allerdings
         beendet.



SENDFAX.TTP
-----------

Aufruf: sendfax nummer faxfile


Die Datei faxfile wird an das Fax-Gert unter der Nummer 'nummer'
geschickt. Unabhngig davon, ob die Datei fehlerfrei verschickt werden
konnte oder nicht, wird das Programm nach einem Anruf beendet.
Wenn innerhalb der Nummer Leerzeichen verwendet werden (z.B. 482 02 20),
so muss die ganze Nummer in Anfhrungszeichen " gesetzt werden.



FAXVIEW.PRG
-----------

Mit FaxView kann man erstellt Fax-Dateien vor dem Versenden kontrollieren
und empfangene Fax-Seiten anschauen. Das Programm kann zustzlich zu den
HackFax Dateien auch die Fax-Dateien von ZFAX (MS-DOS Programm) und QFax
verarbeiten.
Das Programm ist in GEM programmiert und sollte selbsterklrend sein.



Was, wenn etwas nicht wie gewnscht luft?
==========================================

Kein Programm ist fehlerfrei. Wer einen Fehler gefunden hat, soll mir 
diesen bitte melden, damit ich ihn beheben kann. Bei Fehlermeldungen
bitte IMMER die folgenden Informationen mitliefern:
- Konfigurationsdatei (HACKFAX.CFG)
- Computer-Modell, TOS Version, AUTO-Programme, Accesories
- ROM-Version des ZyXEL (ATI, ATI1)
- Programmversion (entspr. Programm mit '-v' starten)
Der Fehler muss von mir reproduzierbar sein. Dazu bentige ich die
verwendeten Dateien. Ausserdem ist das Programm danach zu untersuchen,
ob es ev. nur zusammen mit einem AUTO-Programm bzw. einem Accesory
Probleme macht.



Adressen (Fehlermeldungen bitte nur an Markus):


Autor des Originalpaketes:

Helmut E. Neumann
Im Appensee 4
W6100 Darmstadt 23
BR Deutschland


Weiterentwicklungen:

Markus Bubendorf
Kirchgasse 3
4124 Schnenbuch
Schweiz
Telephon: +41 (0)61 482 02 20
Bitte keine Faxe schicken, da der Computer i.d.R. ausgeschaltet ist.

E-Mail: Markus Bubendorf on 2:301/216.3 @ FidoNet



