ASCII.TXT fr ASCII.PRG ab V 7.00 09.12.91 =================================== Inhaltsverzeichnis ------------------ A Programmumfang B Allgemeines C Benutzung des Programms D Aufbau der HEX-Datei/ HEX_KONV.PRG E Mindestaustattung einer HEX-Datei F ASCII-Intern A. Programmumfang ================= ASCII.PRG Hauptprogramm ASCII.DRU Druckerkonfiguration (nach šbersetzung durch HEX_KONV.PRG) SWIFT_24.HEX Druckerkonfiguration fr Citizen SWIFT_24 (24 Nadeln, bis auf einige Ausnahmen Epson-Kompatibel:LQ-850) ATARI ST-Zeichensatz SW24_IBM.HEX Druckerkonfiguration fr Citizen SWIFT_24 (24 Nadeln, bis auf einige Ausnahmen Epson-Kompatibel:LQ-850) IBM-Zeichensatz HEX_KONV.PRG Konvertierungsprogramm bersetzt HEX-Datei in ein fr das Druckprogramm lesbares Format um -> DRU-Datei ASCII.TXT Diese Datei NEU.TXT Žnderungen gegenber „lteren Versionen ALPHABET.TXT gesamter ST-Zeichensatz ( oder auch IBM-Zeichensatz) LAENGE.TXT Text zur Bestimmung der Blattl„ngenkapazit„t B. Allgemeines ============== Dieses Programm-Paket ist frei kopierbar, darf aber nicht kommerziell vertrieben werden. ASCII.PRG - wurde in TURBO C 2.0 geschrieben. - ben”tigt eine Mindestaufl”sung von 640 * 200 Pixeln. Dies entspricht der mittleren Aufl”sung auf dem Atari ST. - l„dt nach dem Programmstart die ASCII.DRU-Datei, welche Voreinstel- lungen, Texte fr die Buttons, Druckcodes und Zeichencodes enth„lt. Die Zeichencodes k”nnen von den Druckerkonfigurationsdateien von 1st Word oder „hnlichen Dateien in die HEX-Datei bernommen werden. - l„dt keine RSC-Datei, da die Resource bereits im Programm integriert ist. Fr einen erfolgreichen Programmablauf wird ein Speicher von etwa 150 KByte plus Gr”že der auszudruckenden Datei ben”tigt. - erm”glicht die Pfadbergabe einer Textdatei durch eine Shell wie GEMINI und zeigt diesen Namen rechts hinter 'aktuelle Datei:' an. Erscheint dort "????????.???" ist keine Datei selektiert. - l„át sich ber Maus und/oder Tastatur( unterstrichene Buchstaben) bedienen. In 'HELP' wird die erforderliche Sondertaste angezeigt. Weitere Informationen: - Eine einmal geladene Datei wird solange im Speicher gehalten, bis eine neue ausgew„hlt wird oder eine neue DRU-Datei geladen wird. - Zur Erzeugung der DRU-Datei muá die HEX-Datei mittels HEX_KONV.PRG bersetzt werden. Treten dabei Fehler auf, so wird eine Fehlerdatei (Endung ERR) mit Hinweisen erstellt. Eine Pfadbergabe ber eine Shell wie GEMINI ist ebenfalls m”glich. - Es k”nnen alle Zeichen von 1 bis 255 bzw 01 Hex bis FF Hex an den Drucker bergeben werden. Dies gilt auch fr Steuerzeichen wie Linefeed (0AHex) oder CR (0DHex). Somit kann man auch mit dem universiellen IBM-Zeichensatz drucken. - Fr einen optimalen Ausdruck mssen fr die jeweiligen Schriftarten diese selbstdefinierten Grafikzeichen angepažt werden und in den Extra-Zeichencodebereichen abgelegt werden. Dazu sp„ter mehr. Wird diese Anpassung nicht durchgefhrt, so macht sich dies beim Spaltendruck bemerkbar. Dieses Verfahren wurde gew„hlt um eine einfache šbernahme der Zeichencodes von 1st Word zu gew„hrleisten. - Es lassen sich Texte mit beliebigen Zeilenendekennungen einlesen. Die Einstellung erfolgt im 'HELP'-Dialog. Standard/ Default CR + LF. C. Benutzung des Programms ========================== Erkl„rung diverser Buttons: Die aktuellen Einstellungen werden durch invertierte oder angekreuzte Buttons angezeigt. 1. Hauptdialog: ----------------- 1.1 Seitendruck: ( Popup-Men) normal: beidseitig: Die Einstellungen fr den rechten und linken Rand werden fr den Ausdruck der Rckseite vertauscht, so daž sich bei vorhandenem Rand fr die Lochung auch auf der Rckseite kein Text befindet. Dabei befinden sich die ungeraden Seiten auf der Vorderseite und die geraden auf der Rckseite. Ein Datei-Ausdruck l„žt sich nach einer Unterbrechung leicht fort- setzen, indem man die n„chste Seitennummer einstellt und wie gewohnt fortf„hrt. Hierbei werden Vorder- und Rckseite berck- sichtigt. ungerade: Ausdruck aller ungeraden (Vorder-) Seiten gerade: Ausdruck aller geraden (Rck-) Seiten 1.2 Papierart: ( Popup-Men) DIN A4, 12 Zoll und Endlos 1.3 Zeilenabstand: ( Popup-Men) - frei definierbar - beeinfluát maximale Zeilenanzahl je Seite 1.4 Druck ab Seite: siehe 1.1 1.5 Zeilennummern: Erleichtert den Ausdruck von Textbl”cken mit laufender Zeilenzahl. 1.6 Kopfzeile: Bei Bet„tigung erscheint der Dialog zur Kopfzeilenkonfiguration. Bei erneuter Bet„tigung wird die Vorauswahl der Kopfzeile ausge- schaltet. Der Ausdruck wird jetzt um 2 Zeilen verl„ngert. siehe 2. 1.7 Layout: fr aktuellen Zeilenabstand - maximale Zeilenanzahl - oberer und unterer Rand - Blattauswurf mittels Linefeed oder Formfeed Bei Erstellung einer HEX-/DRU-Datei fr einen anderen Drucker k”nnen hier die optimalen Werte ermittelt werden. Man nehme fr die Ermittlung der max. Zeilenanzahl die Datei LAENGE.TXT. 1.8 Spalten: ( Popup-Men) 1, 2 oder 3 Spalten - mit Mittelstrich: zwischen den Spalten wird ' | ' gedruckt. - ohne Mittelstrich: hier sind nur 2 Leerzeichen als optische Trennung vorgesehen 1.9 Help: - Tastatursteuerung mittels Control- oder Alternate-Taste - Zeilenendekennung des gewnschten Textes Default: CR + LF Stehen keine Zeichen im Dialog wird CR + LF benutzt. 1.10 Schriftarten: - Bedienung ber die Funktionstasten F1 bis F6. - bewirkt Anzeige der Voreinstellungen fr linken und rechten Blattrand. 1.11 Drucker: - Erm”glicht das Laden einer anderen DRU-Datei. - Alle Voreinstellungen werden aus der 'neuen' Datei bernommen. - Die Textdatei wird aus dem Speicher gel”scht: ->aktuelle Datei: ????????.??? 1.12 Slashed Zero (gestrichene Null): - alle 'Nullen' werden gestrichen ausgedruckt, sofern der Drucker ber diese Einstellungsm”glichkeit verfgt. ( in HEX-Datei Voreinstellung 30 oder 31) 1.13 Wortumbruch: - Jede Zeichenkette, die nicht mehr ganz in die Zeile paát, wird vom letzten Leerzeichen an in die n„chste Zeile bernommen. Es findet also keine Silbentrennung statt! 1.14 linker/ rechter Rand: - abh„ngig von der eingestellten Schriftart - Bei Wechsel der Schriftart, werden die Voreinstellungen aus der DRU-Datei bernommen. 1.15 TAB-Weite: - Bei Auftreten des Steuerzeichens Hex 9 in der Textdatei wird die Zeile mit Leerzeichen bis zur n„chsten Tabulatorposition aufgefllt. - Besonderheit: Wird die TAB-Weite im Dialog auf "0" gestellt, wird beim Ausdruck der Zeichencode fr ASCII 9 aus der DRU- Datei entnommem und an den Drucker bergeben. 1.16 Start: - Ist keine Datei im Speicher, so erscheint eine Dateiauswahlbox. - Befindet sich bereits eine Datei im Speicher, so besteht die M”glichkeit diese auszudrucken oder eine neue zu laden. - Der Ausdruck l„át sich durch Bet„tigung des Abbruch-Buttons (UNDO-taste) unterbrechen. 1.17 Preview: - wie 1.16 - Seitenbersicht 1:1 incl. Kopfzeile( durchgehender Strich) max. 186 Zeilen in der hohen ST-Aufl”sung max. 90 Zeilen in der mittleren ST-Aufl”sung ansonsten wird automatisch in den Statistik-Modus geschaltet - Statistik: Anzahl der Seiten und Zeilen. 2. Dialog zur Kopfzeilenkonfiguration ---------------------------------- Ist die L„nge der Kopfzeile gr”žer als die Differenz zwischen linkem und rechtem Rand, so erscheint vor dem Ausdruck eine Warnung. Der Ausdruck wird abgebrochen. Abhilfe: z:B. Kopfzeilentext ver- krzen. 2.1 Datum: Es wird das Systemdatum bernommen, es sei denn das Datum im neben- stehenden Textfeld wurde ver„ndert. 2.2 Uhrzeit: Es wird die Systemzeit bernommen. 2.3 Dateiname: Es wird der Name der Textdatei in Anfhrungsstrichen angegeben. 2.4 Seite: Seitenangabe erfolgt generell rechts oben. (Ausnahme bei 'beidseitigem Ausdruck' und beim Ausdruck aller gerader Seiten) 2.5 Infozeile: Ist dieser Button selektiert, so wird der darunterstehende Text bernommen. Dieser darf bei grožen Schriftarten nicht zu lang sein. (Siehe Bemerkung unter 2.) 2.6 Schriftart der Kopfzeile: Erm”glicht das Herausheben der Kopfzeile. Die eingestellten Para- meter haben aber keinen Einfluž auf den brigen Textausdruck. Der brige Ausdruck kann allerdings ebenfalls in fett usw. erfolgen, wenn eine Voreinstellung in der HEX-Datei unter 5A-5F vorhanden ist, da die Initialisierung nach der Kopfzeile wiederholt wird. D. Aufbau der HEX-Datei ======================= Allgemeines: ------------ - HEX-Datei im ASCII-Format abspeichern - Kommentare werden mit '*' eingeleitet - Leerzeilen sind erlaubt - alle Werte als Hex-Werte; Klein- und Groáschreibung erlaubt - Trennung der Werte mittels Komma - Textbereich, Druckcodebereich sowie die Zeichencodebereiche mssen durch '##' abgeschlossen werden! - es darf im Text auáer zur Trennung der Bereiche niemals >>##<< oder die Zahlenfolge >>23,23<< auftreten !!! Wrde in ASCII.PRG als zus„tzliche Trennung der Bereiche interpretiert -> evtl Fehler im Programmablauf bzw beim Ausdruck - siehe auch Kapitel E und Datei "SWIFT_24.HEX" - šbersetzung mit HEX_KONV.PRG: Die Informationen der HEX-Datei werden in der DRU-Datei komprimiert abgelegt. - Durch Umbenennen der erzeugten DRU-Datei in 'ASCII.DRU' wird die neue Druckerkonfiguration beim Programmstart eingelesen. Die Datei: ---------- 1.Textbereich Die Texte mssen in Hochkommata ' ' angegeben werden! Kennung max.L„nge Erkl„rung Mindestausstattung --------------------------------------------------------------------- <'DRU02' fr ASCII.PRG 7.00 ff ja > 20 Druckername ja A-F 18 Buttontexte fr Schriftarten A G-I 7 Buttontexte fr Zeilenabstand G 2.Trennzeichen '##' 3.Druckcode- und Voreinstellungsbereich 3.1 Druckcodes Abschluž immer mit Carriage Return (OD) !!! Erkennungs- Funktion Mindest- code ausstattung -------------------------------------------------------------------- 01 Initialisierung Ja 02 Drucker-Reset Ja 0A-0F Schriftart A-F 0A 11-13 Linespacing 1-3 11 20 Fett ein Ja 21 Fett aus Ja 24 Kursiv ein Ja 25 Kursiv aus Ja 26 unterstreichen ein Ja 27 unterstreichen aus Ja 30 oder 31 Slashed Zero (gestrichene 0) Nein 30: einmalige Initialisierung des Druckers je Seite z.B. Citizen-Drucker 31: Zeichencodefolge, die bei erscheinen einer '0' anstelle des ASCII-Wertes Hex 30 ausgegeben wird. Empfehlung: Zeichen '²'( == Hex B2 bzw. Dez 178 im ST-Zeichensatz) aus dem D„nischen Druckzeichensatz; Die Druckcodes fr die Schriftarten k”nnen z.B. Fett, Kursiv usw. enthalten. Proportionalschrift sollte nur bei einspaltigem Ausdruck Verwendung finden. 3.2 Voreinstellungen Erken- Anzahl Funktion Mindest- nungs- der ausstattung code Werte -------------------------------------------------------------------- 50 2 1. Drucker: 1=parallel oder 2=seriell ja 2. Tastenbedienung mittels Alternate: 0 " " Control : 1 51 1 Tabulator ja Voreinstellungen fr Hauptdialog: 1 = ja, 0 = nein 52 6 1. Kopfzeile ja/nein ja 2. Spaltenanzahl 1,2,3 3. Zeilennummern ja/nein 4. Mittelstrich fr Spaltendruck ja/nein 5. Slashed Zero ja/nein 6. Wortumbruch ja/nein 53 3 1. Schriftart 1-6 ja 2. Papierart 1-3 3. Linespacing 1-3 Voreinstellungen fr Kopfzeile: 1 = ja, 0 = nein ja 54 4 1. Dateiname 2. Datum 3. Systemzeit 4. Seite Schriftarten/-attribute nur fr die Kopfzeile ja 55 3 1. fett 2. kursiv 3. unterstrichen Voreinstellungen fr Schriftarten A-F: 5A 5A-5F 3 1. linker Rand 2. rechter Rand 3. max. Spalten Voreinstellungen: Seitenlayout und Blatt-Transport jeweils fr Zeilenabstand/ Linespacing 1-3: 61-63 15 1. DIN A4 : max. Zeilenanzahl 61 2. 12 Zoll : " 3. Endlos : " 4. DIN A4 : oberer Rand (Zeilenanzahl) 5. 12 Zoll : " " 6. Endlos : " " 7. DIN A4 : unterer Rand (Zeilenanzahl) 8. 12 Zoll : " " 9. Endlos : " " Blattauswurf/ Vorschub zum n„chsten Blatt 0: mittels Leerzeilen/Linefeed (Anzahl siehe 13/14/15) 1: mittels Formfeed = ASCII 12 bzw Hex 0C Bedingung ist hierbei, daá der Drucker intern auf die richtige Papierl„nge eingestellt ist. 10. DIN A4 : 0/1 11. 12 Zoll : 0/1 12. Endlos : 0/1 13. DIN A4 : Anzahl der Leerzeilen fr Blattauswurf 14. 12 Zoll : " 15. Endlos : Anzahl der Leerzeilen fr Vorschub zum n„chsten Blatt 2.Trennzeichen '##' 5.Allgemeiner Zeichencodebereich Fr folgende Standard-Zeichen werden die ASCII-Werte direkt an den Drucker bergeben und nicht aus der DRU-Datei entnommen: Leerzeichen bis " , % bis Z , _ , a bis z (in Hex) 20 bis 22, 25 bis 5A, 5F, 61 bis 7A (in Dez) 32 bis 34, 37 bis 90, 95, 97 bis 122. Die brigen Zeichen werden, wenn kein Code vorhanden ist, durch ein Leerzeichen ersetzt. Es wird empfohlen den Drucker im USA-Modus zu betreiben und fr die Sonderzeichen jeweils in den landesspezifischen Modus umzuschalten. Anschlieáend sollte wieder in den USA-Modus zurckgeschaltet werden. 6.Trennzeichen '##' 7.Extra-Zeichencodebereiche A-F Diese erm”glichen es dem Benutzer Zeichen, die in keinem Drucker- zeichensatz zu finden sind, mittels verschiedener Graphikdichten fr die verschiedenen Zeichenbreiten zuerstellen. Diese werden ebenfalls jeweils mit '##' abgeschlossen. 8.Dateiende: '##' E. Mindestaustattung einer HEX-Datei: ===================================== ** Texte ** <'DRU02' * Kennung >'Druckername' * Druckername A'Schrift A' * Schrift A G'1/6' * Zeilenabstand ## * Textbereichende ** Druckcodes ** 01, D * Initialisierung 02, D * Drucker-Reset 0A, D * Initialisieung fr Schrift A 11, D * Zeilenabstand 1 20, D * Fett ein 21, D * Fett aus 24, D * Kursiv ein 25, D * Kursiv aus 26, D * unterstreichen ein 27, D * " aus ** Voreinstellungen ** 50, 1, 0 51, 8 * Tabulator 52,1,1,0,0,0,0 53,1,1,1 54,1,1,1,0 55,0,0,0 5A, 8,4E,50 * Schrift A * Zeilenabstand 1 (G) 61,41,44,42, 0,0,0, 0,0,0, 1,1,1, 2,2,6 ## * Druckcodebereichende bzw. Anfang allg. Zeichencodebereich ## * Extra-Zeichencodebereich Schrift A ## * Extra-Zeichencodebereich Schrift B ## * Extra-Zeichencodebereich Schrift C ## * Extra-Zeichencodebereich Schrift D ## * Extra-Zeichencodebereich Schrift E ## * Extra-Zeichencodebereich Schrift F ## * Zeichencodebereichende/ Dateiende F. ASCII.Intern =============== 1. Format der DRU-Datei -------------------- 1.1 Dateikennung: Byte 1-4 'DRU:' 1.2 Textbereich: ( String in Pascalformat) 1.Byte: Kennbuchstabe/-Zeichen als ASCII-Zeichen 2. : L„nge des folgenden Textes ab 3. : Text 1.3 Trennzeichen '##' zwischen Text- und Druckcode- bzw. Voreinstellungsbereich 1.4 Druckcode- bzw. Voreinstellungsbereich: 1.Byte: L„nge des Strings + jeweils ein Byte fr L„ngenangabe und Kennung 2. : Kennung ab 3. : String 1.5 Trennzeichen '##' zwischen Druckcode- bzw. Voreinstellungs- und Zeichencodebereich 1.6 Allgemeiner Zeichencodebereich wie unter 1.4 1.7 Trennzeichen '##' 1.8 Extra-Zeichencodebereich Schrift A dito bis Schrift F jeweils Abschluá mit '##' 1.8 '##' Abschlužzeichen der HEX-Datei Sollte die HEX-Datei nichtmehr vorhanden sein, so kann man mit Hilfe des 'Hexdump'-Modus des Druckers und der Dateiausgabefunktion 'Drucken' des Desktop die DRU-Datei zu Papier bringen. Hierbei sind die vorherigen Ausfhrungen zur Dekodierung der DRU-Datei ntzlich. 2. Reihenfolge der Druckerinitialisierungen: ----------------------------------------- HEX 02 : Drucker-Reset HEX 01 : Druckerinitialisierung ( Epson-Mode usw. ) HEX 0A... 0F : aktuelle Schriftart (A-F) HEX 11... 13 : aktueller Zeilenabstand/ Linespacing HEX 30 : gestrichene Null/ Slashed Zero (einmalige Initialisierung z.B. Citizen-Drucker) oberer Rand (Leerzeilen) Kopfzeile: HEX 20 : Fett ein HEX 24 : Kursiv ein HEX 26 : Unterstrich ein Kopfzeilentext HEX 21 : Fett aus HEX 25 : Kursiv aus HEX 27 : Unterstrich aus Leerzeile HEX 0A... 0F : aktuelle Schriftart (A-F) nocheinmal ausgeben Text unterer Rand (Leerzeilen) Blattvorschub mittels Linefeed zum Entfernen des Blatts aus dem Drucker bei Endlos-Papier Vorschub bis zum n„chsten Blatt oder Formfeed --------------------------------------------------------------------- Bei Programmfehlern bitte ich um Rckmeldung. Meine Adresse: Frank M”nnig Heinestr. 59 4100 Duisburg 18