mirror of
https://git.code.sf.net/p/zint/code
synced 2025-05-19 17:55:10 -04:00
- API/CLI/Tcl/GUI: new output option BARCODE_BIND_TOP/--bindtop/
`-bindtop`/"Bind Top" - DPD: add top boundary (width 3X) by default, using new BARCODE_BIND_TOP; "relabel" option; some compliance checks - GUI: only skip encoded/errored signal processing if active modal ExportDialog (wasn't clearing/setting error text bar correctly for DataDialog) - CODE128: debug print checksum - CODE49/DATAMATRIX/QR/ULTRA: fix uniqueness of errtxt nos - manual: fuller DPD doc; some spelling typos, formatting
This commit is contained in:
gitlost
parent
e515f63fab
commit
2f8681b21a
44 changed files with 3643 additions and 2465 deletions
|
|
@ -62,7 +62,8 @@ composite
|
|||
linear and stacked. Those currently supported are made up of a linear
|
||||
'primary' message above which is printed a stacked component based on the
|
||||
PDF417 symbology. These symbols also have a separator which separates the
|
||||
linear and the stacked components.
|
||||
linear and the stacked components. The stacked component is most often
|
||||
referred to as the 2D (two-dimensional) component.
|
||||
|
||||
X-dimension
|
||||
|
||||
|
|
@ -842,7 +843,8 @@ zint --box --border=10 -w 10 -d "This Text"
|
|||
|
||||
gives a box with a width 10 times the X-dimension of the symbol. Note that when
|
||||
specifying a box, horizontal whitespace is usually required in order to create a
|
||||
quiet zone between the barcode and the sides of the box.
|
||||
quiet zone between the barcode and the sides of the box. To add a boundary bar
|
||||
to the top only use `--bindtop`.
|
||||
|
||||
For linear symbols, horizontal boundary bars appear tight against the barcode,
|
||||
inside any vertical whitespace (or text). For matrix symbols, however, where
|
||||
|
|
@ -854,7 +856,7 @@ whitespace.
|
|||
|
||||
Codablock-F, Code 16K and Code 49 always have boundary bars, and default to
|
||||
particular horizontal whitespace values. Special considerations apply to ITF-14
|
||||
- see [6.1.2.6 ITF-14] for that symbology.
|
||||
and DPD - see [6.1.2.6 ITF-14] and [6.1.10.7 DPD Code] for those symbologies.
|
||||
|
||||
## 4.7 Using Colour
|
||||
|
||||
|
|
@ -1084,11 +1086,12 @@ may encode it using an ECI-aware symbology and an ECI value from Table
|
|||
{@tbl:eci_codes} below. The ECI information is added to your code symbol as
|
||||
prefix data. The symbologies that support ECI are
|
||||
|
||||
------------ ------------ ------------ ------------
|
||||
Aztec Code DotCode MaxiCode QR Code
|
||||
Code One Grid Matrix MicroPDF417 rMQR
|
||||
Data Matrix Han Xin Code PDF417 Ultracode
|
||||
------------ ------------ ------------ ------------
|
||||
------------ ------------ ------------
|
||||
Aztec Code Grid Matrix PDF417
|
||||
Code One Han Xin Code QR Code
|
||||
Data Matrix MaxiCode rMQR
|
||||
DotCode MicroPDF417 Ultracode
|
||||
------------ ------------ ------------
|
||||
|
||||
Table: {#tbl:eci_aware_symbologies tag=": ECI-Aware Symbologies"}
|
||||
|
||||
|
|
@ -1956,8 +1959,10 @@ Value Effect
|
|||
------------------------- -----------------------------------------------------
|
||||
0 No options selected.
|
||||
|
||||
`BARCODE_BIND_TOP` Boundary bar above the symbol only.[^7]
|
||||
|
||||
`BARCODE_BIND` Boundary bars above and below the symbol and between
|
||||
rows if stacking multiple symbols.[^7]
|
||||
rows if stacking multiple symbols.[^8]
|
||||
|
||||
`BARCODE_BOX` Add a box surrounding the symbol and whitespace.
|
||||
|
||||
|
|
@ -1982,7 +1987,7 @@ Value Effect
|
|||
separate colour channels (`OUT_BUFFER` only).
|
||||
|
||||
`BARCODE_QUIET_ZONES` Add compliant quiet zones (additional to any
|
||||
specified whitespace).[^8]
|
||||
specified whitespace).[^9]
|
||||
|
||||
`BARCODE_NO_QUIET_ZONES` Disable quiet zones, notably those with defaults.
|
||||
|
||||
|
|
@ -1992,10 +1997,13 @@ Value Effect
|
|||
|
||||
Table: API `output_options` Values {#tbl:api_output_options tag="$ $"}
|
||||
|
||||
[^7]: The `BARCODE_BIND` flag is always set for Codablock-F, Code 16K and Code
|
||||
[^7]: The `BARCODE_BIND_TOP` flag is set by default for DPD - see [6.1.10.7 DPD
|
||||
Code].
|
||||
|
||||
[^8]: The `BARCODE_BIND` flag is always set for Codablock-F, Code 16K and Code
|
||||
49. Special considerations apply to ITF-14 - see [6.1.2.6 ITF-14].
|
||||
|
||||
[^8]: Codablock-F, Code 16K, Code 49, EAN-2 to EAN-13, ISBN, ITF-14, UPC-A and
|
||||
[^9]: Codablock-F, Code 16K, Code 49, EAN-2 to EAN-13, ISBN, ITF-14, UPC-A and
|
||||
UPC-E have compliant quiet zones added by default.
|
||||
|
||||
\clearpage
|
||||
|
|
@ -2335,7 +2343,7 @@ border width of 5. This behaviour can be overridden by using the `--bind` option
|
|||
(API `output_options |= BARCODE_BIND`). Similarly the border width can be
|
||||
overridden using `--border` (API `border_width`). If a symbol with no border is
|
||||
required this can be achieved by explicitly setting the border type to box (or
|
||||
bind) and leaving the border width 0.
|
||||
bind or bindtop) and leaving the border width 0.
|
||||
|
||||
|
||||
|
|
@ -2356,6 +2364,9 @@ Identcode is based on Interleaved Code 2 of 5 and is used by Deutsche Post for
|
|||
mailing purposes. Identcode requires an 11-digit numerical input and includes a
|
||||
check digit.
|
||||
|
||||
|
||||
\clearpage
|
||||
|
||||
### 6.1.3 UPC (Universal Product Code) (ISO 15420)
|
||||
|
||||
#### 6.1.3.1 UPC Version A
|
||||
|
|
@ -2399,7 +2410,7 @@ UPC-E is a zero-compressed version of UPC-A developed for smaller packages. The
|
|||
code requires a 6-digit article number (digits 0-9). The check digit is
|
||||
calculated by Zint. EAN-2 and EAN-5 add-on symbols can be added using the +
|
||||
character as with UPC-A. In addition Zint also supports Number System 1
|
||||
encoding by entering a 7-digit article number stating with the digit 1. For
|
||||
encoding by entering a 7-digit article number starting with the digit 1. For
|
||||
example:
|
||||
|
||||
```bash
|
||||
|
|
@ -2466,8 +2477,8 @@ If you are encoding an EAN-8 or EAN-13 symbol and your data already includes
|
|||
the check digit then you can use symbology `BARCODE_EANX_CHK` (14) which takes
|
||||
an 8 or 13-digit input and validates the check digit before encoding.
|
||||
|
||||
Options to adjust the add-on gap and the descent height of guard bars are the
|
||||
same as for [6.1.3.2 UPC Version E].
|
||||
Options to adjust the add-on gap and the guard bar descent height are the same
|
||||
as for [6.1.3.2 UPC Version E].
|
||||
|
||||
#### 6.1.4.2 SBN, ISBN and ISBN-13
|
||||
|
||||
|
|
@ -2478,7 +2489,7 @@ EAN-13 symbols (also known as Bookland EAN-13) can also be produced from
|
|||
needs to be present in the input data and will be verified before the symbol is
|
||||
generated. In addition EAN-2 and EAN-5 add-on symbols can be added using the +
|
||||
character as with UPC symbols, and there are options to adjust the add-on gap
|
||||
and the descent height of guard bars - see [6.1.3.2 UPC Version E].
|
||||
and the guard bar descent height - see [6.1.3.2 UPC Version E].
|
||||
|
||||
### 6.1.5 Plessey
|
||||
|
||||
|
|
@ -2715,11 +2726,39 @@ standards.
|
|||
#### 6.1.10.7 DPD Code
|
||||
|
||||
|
||||
"000393206219912345678101040"`](images/dpd.svg)
|
||||
|
||||
Another variation of Code 128 as used by DPD (Deutscher Paketdienst). Requires
|
||||
a 28 character alphanumeric input. Zint formats the Human Readable Text as
|
||||
specified by DPD and adds a modulo-36 check character.
|
||||
Another variation of Code 128 as used by DPD (Deutscher Paketdienst). Requires a
|
||||
27 or 28 character input. For 28 character input, the first character is an
|
||||
identification tag (Barcode ID), which should usually be `"%"` (ASCII 37). If
|
||||
27 characters are supplied, `"%"` will be prefixed by Zint (except if marked as
|
||||
a "relabel", see below). The rest of the 27-character input must be
|
||||
alphanumeric, and is of the form:
|
||||
|
||||
Destination Post Code Tracking Number Service Code Dest. Country Code
|
||||
--------------------- ------------------ ------------ --------------------
|
||||
PPPPPPP TTTTTTTTTTTTTT SSS CCC
|
||||
(7 alphanumerics) (14 alphanumerics) (3 digits) (3-digit ISO 3166-1)
|
||||
|
||||
Table: {#tbl:dpd_input_fields tag=": DPD Input Fields"}
|
||||
|
||||
A warning will be generated if the Service Code, the Destination Country Code,
|
||||
or the last 10 characters of the Tracking Number are non-numeric.
|
||||
|
||||
Zint formats the Human Readable Text as specified by DPD, leaving out the
|
||||
identication tag, and adds a modulo-36 check character to the text (not to the
|
||||
barcode itself), thus:
|
||||
|
||||
`PPPP PPP TTTT TTTT TTTT TT SSS CCC D`
|
||||
|
||||
By default a top boundary bar is added, with default width 3X. The width can be
|
||||
overridden using `--border` (API `border_width`). For a symbol with no top
|
||||
boundary bar, explicitly set the border type to bindtop (or bind or box) and
|
||||
leave the border width 0.
|
||||
|
||||
A DPD Code can be marked as a "relabel" by specifying `--vers=1` (API
|
||||
`option_2 = 1`), which omits the identification tag and prints the barcode at
|
||||
half height. In this case, an input of 27 alphanumeric characters is required.
|
||||
|
||||
### 6.1.11 GS1 DataBar (ISO 24724)
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue