Sign In
Products
ZPL ViewerBarcode GeneratorImage → ZPLZPL cheat sheetLabel DesignerTemplate Gallery
Developers
API QuickstartAPI ReferenceMCP ServerBulk GenerationWebhooksSDKs & ExamplesLimitsDirectPrint agent NewGitHub ActionVS Code extensionOn-Premise
Solutions
Logistics & ShippingE-CommerceERP & WMSManufacturingRetailHealthcare & LaboratoryAll solutions
Tools
ZPL Diagnostics HubZPL DebuggerSize & DPI AnalyzerDPI ConverterBarcode fit calculatorShipping Label AnalyzerFont InspectorOrientation DebuggerCalibration AssistantPrinter Compatibility CheckerBarcode Readability CheckerPrinter Language DetectorThermal Printer Test PackZPL ToolsEPL ToolsTSPL ToolsCPCL ToolsPrinter Language ConverterAll ToolsGuidesPricing
Language
EnglishTürkçeDeutsch
Home›All TSPL commands›BITMAP

BITMAP — Raw bitmap

Draws a 1-bit image directly: width in BYTES (8 dots), height in dots, mode 0 overwrite, 1 OR, 2 XOR. A 0 bit prints BLACK — the opposite of ZPL ^GF; a solid black label means the bits are inverted. The data is binary and may contain line breaks.

Engine status: Rendered

This command produces visible output in the preview.

Syntax

BITMAP x, y, width_bytes, height, mode, <data>

Example

SIZE 100 mm, 150 mm
GAP 3 mm, 0 mm
CLS
BITMAP 200,200,2,16,0,?~?~?~?~                ?~?~?~?~
PRINT 1

Open this example in the preview →

Open the validator →

Rendered example

BITMAP 200,200,2,16,0,?~?~?~?~                ?~?~?~?~

Output of the example above in our renderer (203 dpi). Not verified on a physical printer.

Parameters

ParameterMeaning
x, yTop-left corner of the image, in dots
width_bytesRow width in BYTES, 8 dots each; 1–208 in the preview
heightNumber of rows, in dots
modeHow it combines with what is drawn: 0 overwrite, 1 OR, 2 XOR
<data>width_bytes × height bytes of binary data; a 0 bit prints black

Common mistake

Giving the width in dots: width_bytes counts BYTES, so a 200-dot-wide image is 25, not 200. With 200 the preview expects 1,600 dots per row and 8× the data, and reports the data as incomplete.

All TSPL commands

SIZE · GAP · REFERENCE · CLS · TEXT · BARCODE · QRCODE · BOX · BAR · PRINT · DIRECTION · DENSITY · SPEED · OFFSET · SET · CODEPAGE · BLINE

All TSPL commands