zpl.tools
Testing labels

BinaryKits.Zpl reference labels

9 labels measured against Labelary on every test run

Renderer fixtures published with BinaryKits.Zpl: stored-format download and recall, the three ~DG encodings, a ~DY download object, field reverse and extended-ASCII cases. Synthetic throughout — no recipient data. The corpus is published here.

The suite renders every label below on each test run, and compares the output with Labelary's for the same input. The status states what matters for a label: the layout is the same and every barcode carries the same data. The percentage is the share of pixels that differ — rendering detail such as font rasterization — and it does not set the status.

Summary

StatusLabels
Pass — the layout and the barcode data match9
Known defect — the output differs in what it says0
In the corpus9

The widest difference in the corpus is 0.98%, on ^FR field reverse combined with ^LR label reverse.

A label with a content or blocking known issue reads known defect, whatever it measures. Every other label reads pass: the layout and the barcode data match. A cosmetic issue names a visible rendering difference without changing what the label says.

Labels

Known defects first, then the widest rendering difference.

LabelDifferenceStatusKnown issueViewer
^FR field reverse combined with ^LR label reverse0.98%passzpl.toolsLabelary
Extended ASCII field data via ^FH hex escapes0.56%passzpl.toolsLabelary
~DY download object — embedded PNG recalled with ^IM0.25%passzpl.toolsLabelary
^FR field reverse over a filled box0.14%passzpl.toolsLabelary
Stored format — ^DF download merged with ^XF recall and ^FN field data0.12%passzpl.toolsLabelary
^A1 font assignment0.08%passcosmeticzpl.toolsLabelary
~DG graphic download — ACS-encoded raster recalled with ^XG0.00%passzpl.toolsLabelary
~DG graphic download — B64-encoded raster recalled with ^XG0.00%passzpl.toolsLabelary
~DG graphic download — Z64-encoded raster recalled with ^XG0.00%passzpl.toolsLabelary

Known issues

1 of the 9 labels carries an annotated defect, 1 defect in all. The severity comes from the label, not from the percentage:

  • blocking means content a reader misses;
  • content means the output differs in what it says;
  • cosmetic means it differs only in how it looks.

Cosmetic defects

  • ^A1 font assignment, 0.08% (^A, ^FD) — At 0.08% this is a measured limit and not an open defect. The CJK field the byte order mark decodes now blanks its undisplayable characters exactly as Labelary does, which took the label from 0.13% down. Every remaining differing pixel sits on the outlines of the second field's ABCDEFG in font 0, so the residual is the reconstructed face and not this format. Owned by docs/company/plan/phase-1/01-font-licensing/reconstruction.md.