Mirrors/zint
1
0
Fork 0
mirror of https://git.code.sf.net/p/zint/code synced 2025-12-17 18:07:02 +00:00
Code Issues Projects Releases Wiki Activity

Re commit [789e04] and [86363f] allow prefixes without check digit

Browse Source
This commit is contained in:
gitlost
2025-04-21 18:45:23 +01:00
parent 3592edd64e
commit 51ebca182c
12 changed files with 400 additions and 393 deletions
Download Patch File Download Diff File Expand all files Collapse all files

75
docs/manual.pmd
View File

@@ -1625,8 +1625,8 @@ line. The `-h` or `--help` option will display a list of all of the valid
options available, and also gives the exact version of the software (the version
by itself can be displayed with `-v` or `--version`).
The `-t` or `--types` option gives the table of symbologies along with the
symbol ID numbers and names.
The `-t` or `--types` option gives the table of symbologies listing the symbol
ID numbers and names.
The `-e` or `--ecinos` option gives a list of the ECI codes.
@@ -3236,9 +3236,9 @@ adopted Codabar in 1979 as the standard barcode for blood products. Codabar can
encode up to 103 characters starting and ending with the letters A-D and
containing between these letters the numbers 0-9, dash (`-`), dollar (`$`),
colon (`:`), slash (`/`), full stop (`.`) or plus (`+`). No check character is
generated by default, but a modulo-16 one can be added by setting `--vers=1`
(API `option_2 = 1`). To have the check character appear in the Human Readable
Text, set `--vers=2` (API `option_2 = 2`).
generated by default, but a hidden modulo-16 one can be added by setting
`--vers=1` (API `option_2 = 1`). To have the check character appear in the Human
Readable Text, set `--vers=2` (API `option_2 = 2`).
### 6.1.9 Pharmacode One-Track
@@ -3321,13 +3321,12 @@ still recognised.
A variation of Code 128 previously known as UCC/EAN-128, this symbology is
defined by the GS1 General Specifications. Application Identifiers (AIs) should
be entered using [square bracket] notation. These will be converted to
parentheses (round brackets) for the Human Readable Text. This will allow round
brackets to be used in the data strings to be encoded.
parentheses (round brackets) for the Human Readable Text. This method allows the
inclusion of parentheses in the AI data.
For compatibility with data entry in other systems, if the data does not include
round brackets, the option `--gs1parens` (API `input_mode |= GS1PARENS_MODE`)
may be used to signal that AIs are encased in round brackets instead of square
ones.
parentheses, the option `--gs1parens` (API `input_mode |= GS1PARENS_MODE`) may
be used to signal that AIs are encased in round brackets instead of square ones.
Fixed length data should be entered at the appropriate length for correct
encoding. GS1-128 does not support extended ASCII (ISO/IEC 8859-1) characters.
@@ -3416,8 +3415,6 @@ 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.
\clearpage
#### 6.1.10.8 UPU S10
![`zint -b UPU_S10 --compliantheight -d
@@ -3448,7 +3445,8 @@ GS1 DataBar symbol is to be printed with a 2D component as specified in ISO/IEC
Previously known as RSS-14 this standard encodes a 13-digit item code. A check
digit and HRT-only Application Identifier of `"(01)"` are added by Zint. (A
14-digit code that appends the standard GS1 check digit may be given, in which
case the check digit will be verified.)
case the check digit will be verified.) Input less than 13 digits will be
zero-filled.
GS1 DataBar Omnidirectional symbols should have a height of 33 or greater. To
produce a GS1 DataBar Truncated symbol set the symbol height to a value between
@@ -3467,7 +3465,8 @@ can be used in the same way as GS1 DataBar Omnidirectional above. GS1 DataBar
Limited, however, is limited to data starting with digits 0 and 1 (i.e. numbers
in the range 0 to 1999999999999). As with GS1 DataBar Omnidirectional a check
digit and HRT-only Application Identifier of `"(01)"` are added by Zint, and a
14-digit code may be given in which case the check digit will be verified.
14-digit code may be given in which case the check digit will be verified. Input
less than 13 digits will be zero-filled.
#### 6.1.11.3 GS1 DataBar Expanded
@@ -3476,16 +3475,17 @@ digit and HRT-only Application Identifier of `"(01)"` are added by Zint, and a
Previously known as RSS Expanded this is a variable length symbology capable of
encoding data from a number of AIs in a single symbol. AIs should be encased in
[square brackets] in the input data, which will be converted to parentheses
(round brackets) before being included in the Human Readable Text attached to
the symbol. This method allows the inclusion of parentheses in the data to be
encoded. If the data does not include parentheses, the AIs may alternatively be
encased in parentheses using the `--gs1parens` switch. See [6.1.10.3 GS1-128].
[square brackets] in the input data, which will be displayed as parentheses
(round brackets) in the Human Readable Text. This method allows the inclusion of
parentheses in the AI data. If the data does not include parentheses, the AIs
may alternatively be encased in parentheses using the `--gs1parens` switch - see
[6.1.10.3 GS1-128].
GTIN data AI (01) should also include the standard GS1 check digit data as this
is not calculated by Zint when this symbology is encoded. Fixed length data
should be entered at the appropriate length for correct encoding. The following
is an example of a valid GS1 DataBar Expanded input:
The GTIN-14 data for AI (01) must include the standard GS1 check digit as this
is not calculated by Zint when this symbology is encoded. Data for fixed-length
AIs must be entered at the appropriate length. The maximum capacity is 74
numerics or 41 alphanumerics. The following is an example of a valid GS1 DataBar
Expanded input:
```bash
zint -b 31 -d "[01]98898765432106[3202]012345[15]991231"
@@ -3604,8 +3604,9 @@ modulo-49 check digit to the encoded data.
![`zint -b CODE16K --compliantheight -d
"ab0123456789"`](images/code16k.svg){.lin}
Code 16K uses a Code 128 based system which can stack up to 16 rows in a block.
This gives a maximum data capacity of 77 characters or 154 numerical digits and
Code 16K, invented by Ted Williams for LaserLight Systems in 1988, uses a Code
128 based system which can stack up to 16 fixed-width rows in a block. This
gives a maximum data capacity of 77 characters or 154 numerical digits and
includes two modulo-107 check digits. Code 16K also supports ISO/IEC 8859-1
character encoding in the same manner as Code 128. GS1 data encoding is also
supported. The minimum number of rows to use can be set using the `--rows`
@@ -3615,7 +3616,7 @@ option (API `option_1`), with values from 2 to 16.
![`zint -b PDF417 -d "PDF417"`](images/pdf417.svg){.lin}
Heavily used in the parcel industry, the PDF417 symbology can encode a vast
Heavily used in the parcel industry, the PDF417 symbology can encode a large
amount of data into a small space. Zint supports encoding up to the ISO standard
maximum symbol size of 925 codewords which (at error correction level 0) allows
a maximum data size of 1850 text characters, or 2710 digits.
@@ -3701,14 +3702,14 @@ symbol.
A stacked variation of the GS1 DataBar Expanded symbol for smaller packages.
Input is the same as for GS1 DataBar Expanded (see [6.1.11.3 GS1 DataBar
Expanded]). In addition the width of the symbol can be altered using the
`--cols` switch (API `option_2`). In this case the number of columns (values 1
to 11) relates to the number of character pairs on each row of the symbol.
Alternatively the `--rows` switch (API `option_3`) can be used to specify the
maximum number of rows (values 2 to 11), and the number of columns will be
adjusted accordingly. This symbol can be generated with a two-dimensional
component to make a composite symbol. For symbols with a 2D component the number
of columns must be at least 2.
Expanded]), with the same maximum capacity. The width of the symbol can be
altered using the `--cols` switch (API `option_2`). In this case the number of
columns (values 1 to 11) relates to the number of character pairs on each row of
the symbol. Alternatively the `--rows` switch (API `option_3`) can be used to
specify the maximum number of rows (values 2 to 11), and the number of columns
will be adjusted accordingly. This symbol can be generated with a
two-dimensional component to make a composite symbol. For such symbols the
number of columns must be at least 2.
### 6.2.8 Code 49
@@ -3717,9 +3718,9 @@ of columns must be at least 2.
Developed in 1987 at Intermec, Code 49 is a cross between UPC and Code 39. It is
one of the earliest stacked symbologies and influenced the design of Code 16K a
few years later. It supports full 7-bit ASCII input up to a maximum of 49
characters or 81 numeric digits. GS1 data encoding is also supported. The
minimum number of rows to use can be set using the `--rows` option (API
year later. It supports full 7-bit ASCII input up to a maximum of 49 characters
or 81 numeric digits. GS1 data encoding is also supported. The minimum number
of fixed-width rows to use can be set using the `--rows` option (API
`option_1`), with values from 2 to 8.
\clearpage