Wir lassen drucken

Nicht immer ist der gesamte Bildschirminhalt für eine Hardcopy interessant. Oft würde es genügen, nur den Inhalt der aktuellen Dialogbox auf dem Drucker wiederzugeben. Auf den altbekannten Desktop-Hintergrund kann man ja bei der Ausgabe verzichten. PRINTBOX erweitert die im ATARI ST eingebaute Hardcopy-Routine um diese Möglichkeit.

Eigentlich hatte ich mir die Programmierung einer erweiterten Hardcopy-Routine recht einfach vorgestellt. Das war sie im Prinzip auch, die Tücke steckte jedoch in der vom Betriebssystem zur Verfügung gestellten PRTBLK-Funktion des XBIOS. Mit ihrer Hilfe sollte es möglich sein, einen beliebigen Bildschirmausschnitt auf dem Drucker auszugeben. Dazu muß PRTBLK mit einem Parameterblock versehen werden, der folgenden Aufbau hat:

Wie man sieht, bietet die PRTBLK-Funktion vielfältige Möglichkeiten. Wichtig ist, daß die Summe von “width”, “left” und “right” die Anzahl der Pixel pro Rasterzeile in der aktuellen Auflösung ergibt. Andernfalls erinnert der Bildschirmausdruck an gewisse Richtungen moderner Kunst: Was es sein soll, kann niemand so recht sagen. Die Druckerauflösung entspricht der “Qualität”-Einstellung in der Druckeranpassung. Als Farbpalette benutzt PRINTBOX die aktuelle Farbpalette ab SFF8240. So weit gab es mit den Parametern keine Probleme. Allerdings war da noch die sogenannte “Halbtonmaske”..

Welche Aufgabe diese Maske genau erfüllt, konnte ich anhand der mir zur Verfügung stehenden Literatur nicht ermitteln, da die PRTBLK-Funktion stets nur sehr unzureichend beschrieben ist. Vermutlich hat die Halbtonmaske etwas mit der Umsetzung der Bildschirmfarben auf den Druckertyp zu tun. Gibt man hier einen Null-Pointer vor, wählt das XBIOS automatisch eine im System definierte Default-Halbtonmaske aus. Das sollte mir bei der Programmierung gerade recht sein, so daß ich in der ersten Programmversion mit dieser Default-Maske arbeitete. Leider mußte ich feststellen, daß die Ausdrucke zwar die gewünschte Dialogbox darstellten, daß jedoch der rechte Rand der Box oft nur unvollständig vorhanden war (siehe Ausdruck 1). Es hatte den Anschein, als ob die Druckerausgabe innerhalb einer Zeile nach einer gewissen Anzahl nicht gesetzter Pixel einfach abgebrochen wurde. Ob hier ein Fall falsch verstandener Optimierung des Ausdrucks vorliegt? Ein plausibler Grund für einen vorzeitigen Abbruch der Druckzeile war jedenfalls nicht vorhanden. Ein Blick ins ROM-Listing (ATARI ST intern) sollte da eigentlich weiterhelfen. Das einzige, was es dort jedoch zu sehen gab, waren viele überflüssige Assembler-Befehle in undurchsichtigen Befehlssequenzen. Fazit: Ein C-Compiler hatte wieder einmal zugeschlagen. Dennoch war zu erkennen, daß es einen Unterschied bezüglich der Druckbreite macht, wenn man statt der Default-Halbtonmaske eine eigene Komposition verwendet. Deshalb gab ich PRTBLK eine Maske mit auf den Weg, die keinen Unterschied zur Default-Maske aufweist. Halt, fast hätte ich es vergessen: Ein Unterschied kam doch zum Vorschein. Nun war die Hardcopy nämlich fehlerfrei (siehe Ausdruck 2). Welchen Sinn es macht, daß die interne Halbtonmaske anders behandelt wird als eine eigens erstellte, auch wenn beide Masken gleich aufgebaut sind, konnte ich nicht klären. Vielleicht ist hier ein Leser fündig geworden.

Soweit meine Ergüsse zum Thema “Halbtonmaske”. Der eigentliche Programmablauf sieht nun folgendermaßen aus:

Bei jedem form_dial-Aufruf überprüft PRINTBOX, ob Bildschirmspeicher für eine Dialogbox reserviert werden soll. Ist dies der Fall, merkt sich das Programm die Koordinaten sowie Breite und Höhe der Box in ihrer größten Größe. Wird die Tastenkombination SHIFT/ALTERNATE/HELP betätigt, und ist eine Dialogbox auf dem Bildschirm vorhanden, holt sich PRINTBOX die aktuelle Druckereinstellung und ruft anschließend PRTBLK auf, um eine Hardcopy der Box zu machen. Befindet sich keine Box auf dem Bildschirm, geschieht nichts.

Nun noch ein paar Worte zu den vom Programm geänderten Systemvektoren. Die Werte der alten Vektoren merkt sich PRINTBOX innerhalb einer sogenannten XBRA-Struktur. Speziell bei residenten Programmen können sich auf diese Weise installierte Programme leicht wieder aus einer Vektorkette ausklinken oder erkennen, ob sie bereits installiert sind. Voraussetzung ist jedoch, daß jedes Programm für veränderte Systemvektoren eine XBRA-Struktur zur Verfügung stellt. Nähere Informationen hierzu finden sich im ATARI ST Profibuch (SYBEX-Verlag).

Soweit die wichtigsten Erläuterungen zum Programm. Abschließend noch ein Hinweis für die Besitzer von 24-Nadeldruckern. Möglicherweise gibt es bei diesen Druk-kern Schwierigkeiten beim Ausdruck. Da der ST Hardcopies auf 24-Nadeldruckern nicht vernünftig unterstützt, geschieht ein Bildschirmausdruck normalerweise über ein spezielles Druckprogramm. Damit PRINTBOX seine Aufgabe erfüllen kann, muß der geladene 24-Nadeltreiber nicht nur in der Lage sein, eine Hardcopy des gesamten Bildschirms zu machen, sondern er muß zusätzlich die PRTBLK-Funktion des XBIOS unterstützen. Dieses dürfte jedoch nicht bei allen Treibern der Fall sein.