  ==============
  - GhostFax/2 -
  ==============

  Version: 1.1, 12-August-1998

  License: FREEWARE 

  Platform: IBM OS/2 Warp 3, 4,...

  Author: Jens Schiffler, 86152 Augsburg, Germany 

  E-Mail: jens.jakob.schiffler @ student.uni-augsburg.de
          jens-schiffler@freeyellow.com

  WWW: <A HREF="http://www.freeyellow.com/members3/jens-schiffler">
       Jens Schiffler EDV-Service</A> 


  Disclaimer
  ==========  
  Der Autor uebernimmt keinerlei Garantie fr dieses Softwarepaket.
  Die Benutzung erfolgt auf eigenes Risiko.


  Lizenz
  ======
  Dieses Softwarepaket ist Freeware. 
  PSExtract.EXE und ReverseFaxBits.EXE Copyright (C) 1998 Jens Schiffler.
 

  Dateien in diesem Softwarepaket
  ===============================
 
  KBDVIO32.DLL         DLL, die von PSExtract und RevertFaxBits bentigt wird

  PSExtract.EXE        Extract text from a PostScript file 

  ReverseFaxBits.EXE	  Vertauscht die Bitreihenfolge in TIFF-F files

  FaxFilter.CMD        Filter fr "printmon"

  sample.txt           Beispieltext fr Faxversand

  liesmich.txt         diese Datei
  

  Bentigte Programme: (nicht in diesem Archiv enthalten)
  =======================================================

  GhostScript          eines meiner Lieblingsprogramme!
                       ftp://ftp.cs.wisc.edu/ghost/aladdin/
                       http://www.leo.org/pub/comp/os/os2/leo

  FaxWorks             wer OS/2 Warp hat, hat auch FaxWorks.
                       http://www.kellergroup.com

  printmon.exe         ein kleines Programm zur LPT-Umleitung
                       http://www.leo.org/pub/comp/os/os2/leo


  Zweck
  =====
  GhostFax/2 ermglicht, Faxdaten in ein beliebiges Textverarbeitungs-
  Dokument einzubinden. So ist man nicht mehr auf den FaxWorks Sende-Dialog 
  angewiesen.
  Dies ist insbesondere dann praktisch, wenn man personalisierte Faxe an 
  mehrere Empfnger senden mchte.


  Arbeitsweise
  ============
  Das Dokument mu auf einem PostScript Druckerobjekt gedruckt werden, 
  dessen Ausgabe (LPT) via "printmon" auf "PSFilter.CMD" umgeleitet wird.

  PSFilter.CMD startet PSExtract.exe, um Text aus den PS Daten zu 
  extrahieren. Extrahierter Text wird NICHT gedruckt.

  Falls der extrahierte Text das Schlsselwort "FAX" enthlt, 
  verwendet "PSFilter" GhostScript, um eine Tiff Class F Datei in Ihrem
  FaxWorks Verzeichnis zu erzeugen. Die Faxdatei wird nach der Zahl in 
  "FAX.IDX" benannt.
  Sonst wird das Dokument von GhostScript auf dem lokalen Drucker ausgegeben.

  Wenn eine Faxdatei erzeugt wurde, wird ein Eintrag an "FAX.LOG" angehngt, 
  der die ID der Faxdatei sowie die Fax - Information aus dem Dokument 
  enthlt.
  (an Fax, an Name, an Firma, an Tel., von Name, von Fax, von Tel.)   
  Sobald FaxWorks das nchste mal seine Logdatei berprft (Programmstart) 
  wird das Fax gesendet.

  Da GhostScript etwas ungewhnliche Tiff Class F Dateien erzeugt  
  (FillOrder=2), wird "RevertFaxBits.EXE" bentigt, um diese fr FaxWorks 
  (FillOrder=1) lesbar zu machen. Obwohl FaxWorks GhostScripts tiffg3 Dateien 
  importieren kann, interpretiert es sie falsch, wenn sie nur in der
  Logdatei angefgt wurden.


  Installation
  ============
  1. Erzeugen Sie ein PostScript Druckerobjekt auf der 
  Arbeitsoberflche. Whlen Sie einen bisher unbenutzten LPT.

  2. Installieren Sie die bentigten Programme (FaxWorks, GhostScript,
  Printmon)

  3. Unzippen Sie das GhostFax/2 zipfile (z.B. in das Verzeichnis von 
  printmon)

  4. ndern Sie die *Dir und *Command Variablendefinitionen in 
  "PSFaxFilter.CMD" entsprechend Ihrer Konfiguration.
   

  Anwendung
  =========
  Starten Sie printmon um die Ausgabe des PostScript Druckerobjekts 
  abzufangen:

  printmon LPT2 "c:\printmon\FaxFilter.CMD"

  Legen Sie in Ihrer Textverarbeitung ein Faxdokument an. 
  Fgen Sie den folgenden Text am Ende des Dokuments an:

  Einzufgender Text:          Erklrung:

  <PSEXTRACT>               -- Grobuchstaben, keine fhrenden Leerzeichen
  FAX                       -- Schlsselwort
  <NEWLINE>                 -- Grobuchstaben, keine fhrenden Leerzeichen
  an Fax                    -- WICHTIG: Faxnummer an die gesendet werden soll 
  <NEWLINE>                 
  "an Name"                 -- OPTIONAL: Name des Empfngers
  <NEWLINE>
  "an Firma"                -- OPTIONAL: org des Empfngers
  <NEWLINE>                 
  an Tel.                   -- OPTIONAL: phone des Empfngers
  <NEWLINE>                 
  "von Name"                -- OPTIONAL: Ihr name 
  <NEWLINE>
  "von Firma"               -- OPTIONAL: Ihre Firma
  <NEWLINE>
  von Fax                   -- OPTIONAL: Ihre Faxnummer
  <NEWLINE>
  von Tel.                  -- OPTIONAL: Ihr Tel.
  </PSEXTRACT>
  
  Die maximale Lnge fr den extrahierten Text betrgt 8 kilobytes.

  Formatieren Sie den Text in der Schriftart "Helvetica". Whlen Sie eine 
  geringe Schriftgre, damit der Text auf die Letzte Seite pat.

  Da der Text in die Fax.Log Datei eingefgt wird, muss jede Zeile die ein 
  Komma ',' enthlt mit doppelten Anfhrungszeichen '"' beginnen und enden.

  Um ein Fax zu senden, drucken Sie das Dokument auf dem umgeleiteten 
  PostScript Drucker. 


  Mgliche Probleme
  =================
  Problem: Das Fax steht in FAX.LOG, wird aber nicht gesendet.
  ------------------------------------------------------------

  Antwort: Starten Sie FaxWorks neu - jetzt sollte es mit dem Senden 
  beginnen. In der Vollversion kann es gengen, die Funktion "Fax Hold" 
  ein- und wieder auszuschalten.
  

  Problem: Die Datei wird gedruckt, obwohl sie gefaxt werden sollte.
  ------------------------------------------------------------------

  1. Antwort: 
  Aufgrund der Methode, nach der PSExtrakt arbeitet, hngt der Erfolg von 
  den Einstellungen des PostScript Druckertreibers und der ausgewhlten 
  Schriftart ab.
  Deshalb sollten Sie im Druckertreiber einstellen, dass sowohl die 
  eingebauten als auch downloaded Fonts verwendet werden drfen, und immer 
  eine Standard PS Schriftart wie "Helvetica" fr den 
  <PSEXTRACT>...</PSEXTRACT> Bereich verwenden.
  Sonst konvertiert der Druckertreiber mglicherweise den Text in 
  Bitmaps. Das kann auch mit sehr kleinen Systemschriftarten passieren.

  2. Antwort: 
  Stellen Sie sicher, da alle Schlsselworte in Grobuchstaben geschrieben 
  sind und am Zeilenanfang stehen. Andernfalls wird PSExtract nicht 
  funktionieren.

  
  Problem: Druck von Serienbriefen fhrt zu EINEM riesigen Fax.
 --------------------------------------------------------------

  Antwort: Jedes Fax mu ein einzelner Druckauftrag sein. Eventuell kann Ihre 
  Textverarbeitung Serienbriefe nur in einem groen Druckauftrag 
  ausgeben.
  

  Problem: Nichts funktioniert.
  -----------------------------

  1. Antwort: Prfen Sie die Installation.
  
  2. Antwort: Sehen Sie sich die Bildschirmausgabe der printmon 
  Programmsitzung an.

  3. Antwort: Sehen Sie nach, ob die Dateien "PSextract.PS" 
  und "PSExtract.txt" angelegt wurden - falls nicht, drfte mit den 
  printmon Parametern etwas nicht stimmen.

  4. Antwort: Vielleicht enthlt die Datei FAX.IDX eine schon verwendete 
  Nummer.

  5. Antwort: Kontaktieren Sie den Autor.
  

--- 

Jens Schiffler, 02.August 1998



