Sie senden ein Logo per BITMAP an einen TSC-Drucker
und erhalten ein schwarzes Rechteck, oder einen schwarzen Block mit dem Logo
als weißer Silhouette. Der Befehl stimmt. Die Bits sind verkehrt herum.
Die Ursache: In TSPL ist ein 0-Bit schwarz
Das eigene BITMAP-Beispiel im TSC-TSPL/TSPL2-
Programmierhandbuch druckt einen Pfeil, und die Zeilen aus lauter
00-Bytes sind sein schwarzer Balken. In TSPL druckt ein
0-Bit also einen Punkt, ein 1-Bit lässt das Papier weiß. ZPLs
^GF und die meisten Bildbibliotheken nutzen die umgekehrte
Konvention: 1 ist schwarz. Mit ZPL-Gewohnheit umgewandelte oder direkt aus
einer 1-Bit-Bildbibliothek übernommene Daten drucken daher ihr eigenes
Negativ. Ein überwiegend weißes Logo wird zum überwiegend schwarzen
Kasten.
Vier typische Fehler
Invertierte Bits. Der Fall oben. Jedes Byte vor dem
Senden invertieren (b ^ 0xFF).
Breite in Punkten statt Bytes. Der dritte Parameter
ist die Breite in Bytes: 8 Punkte pro Byte, aufgerundet. Ein
100 Punkte breites Bild sind 13 Bytes, nicht 100. Eine falsche Breite
zerschneidet das Bild in schräge Streifen.
Füllbits auf 0. Bei 13 Bytes für 100 Punkte sind die
letzten 4 Bits jeder Zeile Füllbits. In TSPL müssen sie 1 sein, sonst
entsteht ein schwarzer Streifen am rechten Rand.
Hex-Text oder Zeilenende-Umwandlung. Die Daten nach dem
sechsten Parameter sind rohe Binärdaten, genau Breite × Höhe
Bytes. Als Hex-Text gesendet, oder über einen Kanal, der
0D/0A-Bytes umschreibt (Dateikopie im Textmodus,
manche seriellen Treiber), verschiebt sich jedes folgende Byte.
So sieht der Befehl aus
SIZE 50 mm, 25 mm
GAP 3 mm, 0 mm
CLS
BITMAP 20,20,13,60,0,<780 rohe Bytes>
PRINT 1
Parameter: x, y, Breite in Bytes, Höhe in Punkten, Modus, Daten. Modus
0 überschreibt den Bereich, 1 verknüpft das Bild per
OR mit dem bereits Gezeichneten, 2 per XOR.
Vor dem Druck prüfen
Der TSPL-Viewer zeichnet
BITMAP mit der Bitbedeutung aus dem Handbuch; ein invertiertes
Bild erscheint auch am Bildschirm als schwarzer Kasten. Binärdaten senden
Sie als rohe Bytes an die Render-API (POST /v1/tspl/render); ein
Textfeld kann beliebige Bytes nicht tragen. Ohne eigene Umwandlung: Bild in
Bild zu ZPL hochladen, als Ausgabesprache
TSPL (BITMAP) wählen, und Sie erhalten einen fertigen Binärauftrag
mit richtigen Bits, Füllbits und Bytebreite.
Unsere Darstellung folgt dem TSC-Handbuch; sie wurde nicht gegen jede
TSC-Firmware geprüft. Vor einem großen Stapel ein Etikett drucken.
Häufig gestellte Fragen
Warum druckt mein TSPL-BITMAP ein schwarzes Quadrat?
In TSPL druckt ein 0-Bit einen Punkt und ein 1-Bit bleibt weiß, umgekehrt wie bei ZPL ^GF und den meisten Bildbibliotheken. Nach ZPL-Art vorbereitete Daten drucken ihr Negativ. Jedes Byte vor dem Senden invertieren.
Ist die BITMAP-Breite in Punkten oder Bytes?
In Bytes: 8 Punkte pro Byte, aufgerundet. Ein 100 Punkte breites Bild ist 13 Bytes breit, und die Füllbits am Zeilenende müssen in TSPL 1 (weiß) sein.
