Print quality & DPI

Thermal printing uses a physical dot grid. Resolution, barcode module size, quiet zones, conversion, driver scaling, media and printer settings all affect the result. A successful export alone does not establish print or scan quality.

How BarcodeStack keeps output sharp

• The canvas is the dot grid. A 4×6” label at 203 DPI is designed on a true 812 × 1218 dot surface. Zoom only changes your view, never the label.
• Barcodes live at whole-module sizes. When you place or resize a barcode, it snaps to the nearest size where every module is a whole number of dots — the generated artwork uses whole-dot modules. Print quality, quiet zones, media and scanner settings still require testing.
• Review the output path. ZPL uses dot coordinates, but fonts, barcode fitting and firmware can change the result. PDF rasterization and driver scaling can also affect edges. Match actual resolution and test the file.

QR size and centering

A QR object’s width and height reserve its complete space, including the white border needed for scanning. BarcodeStack uses the largest square, whole-dot modules that fit inside that space and centers the result on both axes. The object keeps its dimensions when a different merge value produces a denser QR. The four-module white border follows DENSO WAVE’s QR sizing guidance.

For example, a 1-inch square at 203 DPI can hold a short, 21-module QR at seven dots per module: 147 dots of code plus 28 white dots on each side. Increasing to eight dots per module would need a 232-dot square. A box too small for even one-dot modules is rejected instead of silently stretching the code.

Saved-design ZPL uses the same QR pixels as the browser, positioned explicitly as a printer graphic. Printer offsets, media settings and driver scaling still need to be checked on a physical sample.

The three classic causes of blur

1. “Fit to page” scaling. Any print-dialog scaling other than 100% resamples the artwork. Always print at Actual size.
2. Driver re-rasterizing at a mismatched resolution. Printing a PDF through a queue configured for the wrong DPI smears bar edges. Prefer direct ZPL printing on Zebra printers.
3. Printer-side settings. Low darkness, high print speed, a dirty printhead, or incompatible media/ribbon can contribute to faint or patchy output. Follow the exact model’s documented settings and cleaning procedure; do not apply a generic cleaning solvent or calibration button sequence.

Match the printer’s DPI

Read the exact model’s configuration or manufacturer specification. A family name, stock code or rounded marketing DPI does not establish the installed printhead resolution. Common presets use 203 or 300 DPI; change the value when your printer differs. Follow the model-specific instructions for obtaining a configuration printout.

In the editor: Change size → Custom size has a DPI selector (203 / 200 / 300 / 600). The whole pipeline follows it — canvas dots, ZPL ^PW/^LL, and PDF rendering. Recheck dimensions and barcode modules after changing it, then measure a printed sample.

The label background

The label background is a color, a full-bleed image, or both. Either way it is part of the template rather than an object on the canvas: it is saved with the design, it travels in a shared design file, and a colleague who opens the file sees what you did. That is what makes it usable for color-coding — returns yellow, fragile pink — and for product labels whose artwork runs to the edge, where a rectangle or an image dropped onto the canvas would sit in the layer stack and get moved, covered, or deleted by accident.

Set it in the label panel (nothing selected) under Background. The named swatches are design choices, not a physical stock-color match or calibrated color proof. + Add background image places artwork behind everything else.

Whether it prints is a separate choice. In the editor: Export → Print the background — a switch that appears once the label has a background. It is saved in this browser, like the printer alignment nudge, because it answers a question about the stock in your printer rather than about the design.

That switch covers the whole background. Turning it off leaves off the color and the background image together — if your label is white with full-bleed artwork, turning it off prints a white label. What it never touches is anything you drew: boxes, table rules, lines, text, and barcodes print either way.

Turn it off when you print on stock that is already colored or pre-printed — check alignment against that stock. Leave it on to print the background yourself on blank stock with a color laser or inkjet. That is the normal case for product labels, and the switch appears wherever ink meets paper: the Print button, the sheet dialog, the spreadsheet batch, and the Export menu.

One thing to know before printing a background on die-cut sheets: it runs to the edge of every label. Sheets feed a millimeter or two off, so it can stop just short of one edge and leave a white hairline. The alignment nudge under Export → PDF — full sheet moves the whole label, which corrects a consistent drift. Colored stock can avoid printing a background, but placement and other artwork still need a physical alignment test.

Thermal printers

This application’s ZPL export and direct printing omit the label background, both color and image, and disclose that in conversion warnings. Other elements can also change during conversion; review every warning and the printed result. For color coding, consider stock supported by the exact printer and application.

Test before a run

Print one label and test-scan every barcode with the scanner you’ll actually use. Direct thermal stock fades with heat and sunlight — verify a stored label still scans if your labels live in a warehouse.