What D3 AQR is
D3 AQR ("Digital Address QR", beta status in this catalog) is a GS1-related structured QR variant that draws additional address/category marker cells around an inner, standard QR Code host symbol. bwip-js delegates the inner symbol's own encoding and drawing entirely to its qrcode encoder -- confirmed directly: bwipp_d3aqr deletes its own private option keys and calls bwipp_qrcode(), then reads the resulting pixel grid back out to build the final AQR pixel grid around it.
Generate it now
Enter a GS1 Digital Link URI (containing an AI (01) GTIN-14 segment) and a category number to see a live preview.
Valid input
A category value from 0 to 16383 is required -- there is no default; omitting it hard-fails ("The category option is required"). bwip-js/BWIPP itself does not parse or validate the payload's GS1 Digital Link structure at all -- it renders whatever text fits the QR host symbol's data capacity. This repository runs its own, separate application-layer validator on the payload before treating a render as valid: it requires an absolute URI containing an AI (01) path segment followed by a 14-digit GTIN whose Mod-10 check digit is correct, and reports the exact expected-vs-actual check digit when it is not.
Key options
Supported options include category (required, 0 to 16383) and hostratio (2, 2.5, or 3 -- bwip-js's own real, literal default is 2). hostratio controls how large the underlying QR "host" cells are drawn relative to the AQR overlay grid; changing it visibly changes the rendered symbol size.
Output and printing
Export SVG for vector-precise packaging artwork or PNG for a quick proof.
Common uses
D3 AQR is used in GS1 connected-packaging pilots that combine a scannable digital-link URI with an address/category marker layer around a standard QR host symbol.
Example
See the live preview above, seeded with a bwip-js-verified valid category/payload pair.
Size guidance
Overall symbol size grows with the inner host QR symbol's own version (driven by payload length and error correction) and scales further with the hostratio cell-size factor.
Troubleshooting
A rejected render is usually a missing category, a category outside 0-16383 ("Category must be between 0 and 16383 inclusive"), an invalid hostratio value other than 2/2.5/3 ("hostratio must be 2, 2.5 or 3"), or -- from this repository's own domain validator, not bwip-js itself -- a payload that is not an absolute GS1 Digital Link URI, has no AI (01) GTIN-14 segment, or carries an incorrect GTIN-14 check digit.
Related formats
Related formats: GS1 Digital Link QR Code and GS1 Digital Link Data Matrix (the other GS1 Digital Link carriers already in this catalog, without D3 AQR's own address/category overlay) and QR Code (the host encoder this capability delegates its inner symbol to).
FAQ
Does bwip-js itself validate the GTIN in a D3 AQR payload?
No -- bwip-js/BWIPP never parses the GS1 Digital Link structure of a D3 AQR payload at all; it only draws whatever text fits inside the QR host symbol's data capacity. This repository's own separate application-layer validator checks the AI (01) GTIN-14's Mod-10 check digit before a render is treated as valid, independently of bwip-js.
Is category optional?
No -- category has no usable default at all. Omitting it hard-fails unconditionally, the same shape as rectangularmicroqrcode's own required version option.