home *** CD-ROM | disk | FTP | other *** search
/ ST-Computer Leser 1998 October / STC_CD_10_1998.iso / ONLINE / DFUE / STARFAX / FDDKIT_FTQ / FAXINTER.TXT < prev    next >
Text File  |  1998-09-26  |  4KB  |  132 lines
  1. Dokument: FAXINTER.TXT
  2. Datum: 25.12.97
  3. Zweck: Verwendung von STarFax und Viewfax in eigenen Programmen.
  4. Stand: Version 2.0-C
  5.  
  6. Definition von Schnittstellen und Aufrufkonventionen
  7.  
  8. Inhalt:
  9.  
  10. STarFax Parameter........................ 1
  11. STarFax AES-Messages..................... 2
  12. ViewFax Parameter........................ 3
  13. ViewFax AES-Messages..................... 4
  14. Erstellen von eigenen Fax-Treibern....... 5
  15. Faxversand starten....................... 6
  16.  
  17.  
  18. -0- Allgemeine Infos:
  19. =====================
  20. STarFax & Viewfax können mit einfachen Parametern durch eigene Programme
  21. gesteuert werden.
  22. 1. Kommandozeilenparameter, z.B. für Dateinamen
  23. 2. AES-Nachrichten per APPL_WRITE für komplexere Aufgaben
  24. Damit lassen sich z.B. komplette Faxe einfach erstellen und versenden.
  25. Zum Empfang der AES-Bachricht muss das Programm natürlich bereits
  26. gestartet sein, bzw. vorher gestartet werden (SHELL_WRITE, P_EXEC)
  27.  
  28. -1- STARFAX Parameter:
  29. ======================
  30. Als Parameter kann der Name einer JOB-Datei angegeben werden.
  31. Diese wird geladen und sofort ausgeführt.
  32. JOB-Dateien enthalten in je 4 Zeilen:           
  33.  
  34. -1- Name
  35. -2- Fax-Nr.
  36. -3- zu sendende FAX-Dateien
  37. -4- Datum und Uhrzeit (optional, in Vorbereitung)
  38.  
  39. -2- STARFAX AES Messages:
  40. ========================= 
  41. var msg=array[1..16] of integer (ACHTUNG C-Programmierer: Index hier 1 !)
  42.  
  43. msg[1]=$5346 (="SF")
  44. msg[2]=eigene APP-Id
  45. msg[4]="J"
  46. msg[5]=Hi-Word Pointer auf Dateiname einer JOB-Datei
  47. msg[6]=Lo-Word "
  48.  
  49. STarFax antwortet in [1]..[3] wie oben,
  50.  
  51. msg[5]=Hi-Word Pointer auf Fehler-Status als Klartext.
  52. msg[6]=Lo
  53. msg[4]="JS" JobStart : Empfangen, JOB wird jetzt ausgeführt...
  54.        "JE" JobError : Fehler bei Ausführung (z.B. besetzt...)
  55.        "JO" JobOk    : Ohne Fehler beendet
  56.  
  57. -3- VIEWFAX Parameter:
  58. ======================
  59. Als optionaler Parameter kann bei Programmstart ein
  60. Name einer Faxdatei (.F* oder .I*) oder einer Kommandodatei (.CMD)
  61. angegeben werden, evtl. zusätzlich noch:
  62.  -I  Suchpfad=Eingehendes Fax
  63.  -O  Suchpfad=Ausgehendes Fax
  64.  
  65. Ohne Dateiname gibt's noch folgende Parameter:
  66.  -P  automatisch alle neuen Faxe selektieren und ausdrucken
  67.  -Q  Viewfax automatisch beenden
  68.  
  69. Viewfax kann mit Hilfe einer einfachen Kommandodatei auch
  70. Folgen vom Befehlen ausführen. Eine Kommandodatei
  71. enthält in jeder Zeile ein Kommandokürzel, evtl. gefolgt von einem
  72. Leerzeichen und einem Dateinamen.
  73.  
  74.  Kommando  Zweck
  75. -------------------
  76.  L DATEI   Fax laden, Zeiger auf Dateiname in msg[5] und msg[6]
  77.  S DATEI   Fax sichern als ...
  78.  Q         Quit
  79.  C         Close, Fenster schliessen
  80.  N         Neue DIN A4-Seite erstellen und Cursor an Seitenanfang
  81.  I DATEI   Importieren einer ASCII oder IMG Datei an aktueller Position
  82.  
  83. -4- VIEWFAX AES-Messages:
  84. =========================
  85. Über AES-Nachrichten kann Viewfax ebenfalls Kommandodateien ausführen.
  86.  
  87. var msg=array[1..16] of integer
  88. msg[1]=AES Funktionsnr, immer $5646  (="VF")
  89. msg[2]=Eigene App-ID.
  90. msg[4]="J"
  91. msg[5]=Hi-Word Dateiname einer CMD-Datei
  92. msg[6]=Lo-Word Dateiname
  93.                 
  94. Weitere Vorschläge nehme ich gerne an.
  95.  
  96. -5- Faxtreiber erstellen
  97. ========================
  98. Im Verzeichnis \FDDKIT\C bzw. \FDDKIT\GFA befinden sich
  99. Librarys mit Funktionen zum erstellen eigener Faxe mit
  100. GFA-Basic oder C (Die C-Variante geht auch in Pure Pascal)
  101. Die Funktionen dürften sich selbst erklären.
  102. Wichtig: Die Pfade für die Dateiablage werden in der Datei
  103. C:\STARCALL.SET fesgelegt. Man sollte also STarFax installieren
  104. oder selbst diese Datei anlegen und dort wie folgt festlegen:
  105.  
  106. SENDPATH E:\STARFAX\FAXE.OUT
  107. RECPATH E:\STARFAX\FAXE.IN
  108.  
  109. -6- Faxversand starten
  110. ======================
  111. Das Faxprogramm kann nach Erstellen der Faxe automatisch aktiviert
  112. werden:
  113. Dazu mu₧ der Wert des Cookie-Jar "FAX!" nach Erstellung der Faxe
  114. um die Seitenanzahl erhöht werden.
  115.  
  116. Das Fax-Programm wartet in seiner Event-loop auf "FAX!">0,
  117. durchsucht dann den Fax-Pfad nach den zuletzt erstellten n Seiten,
  118. fragt nach der Faxnummer und sendet.
  119.  
  120. Ich hoffe, dieses Verfahren wird in Zukunft auch von anderen
  121. Fax-Programmen unterstützt.
  122.  
  123. Cookie "FAX!":
  124.  
  125. Bit 0...7: Anzahl bereiter Fax-Seiten
  126. Bit 8..31: reserviert.
  127.  
  128. Ingo Linkweiler
  129.  
  130. -eof-
  131.  
  132.