mirrors/zint-barcode-generator
1
0
Fork 0
mirror of https://git.code.sf.net/p/zint/code synced 2025-05-31 15:18:29 -04:00
Code Issues Projects Releases Packages 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

69
docs/manual.html
View file

@ -3091,7 +3091,7 @@ 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 <code>-v</code> or <code>--version</code>).</p>
<p>The <code>-t</code> or <code>--types</code> option gives the table of
symbologies along with the symbol ID numbers and names.</p>
symbologies listing the symbol ID numbers and names.</p>
<p>The <code>-e</code> or <code>--ecinos</code> option gives a list of
the ECI codes.</p>
<h2 id="other-options">4.19 Other Options</h2>
@ -4973,7 +4973,7 @@ starting and ending with the letters A-D and containing between these
letters the numbers 0-9, dash (<code>-</code>), dollar (<code>$</code>),
colon (<code>:</code>), slash (<code>/</code>), full stop
(<code>.</code>) or plus (<code>+</code>). No check character is
generated by default, but a modulo-16 one can be added by setting
generated by default, but a hidden modulo-16 one can be added by setting
<code>--vers=1</code> (API <code>option_2 = 1</code>). To have the check
character appear in the Human Readable Text, set <code>--vers=2</code>
(API <code>option_2 = 2</code>).</p>
@ -5058,10 +5058,10 @@ aria-hidden="true"><code>zint -b GS1_128 --compliantheight -d "[01]9889876543210
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.</p>
Readable Text. This method allows the inclusion of parentheses in the AI
data.</p>
<p>For compatibility with data entry in other systems, if the data does
not include round brackets, the option <code>--gs1parens</code> (API
not include parentheses, the option <code>--gs1parens</code> (API
<code>input_mode |= GS1PARENS_MODE</code>) may be used to signal that
AIs are encased in round brackets instead of square ones.</p>
<p>Fixed length data should be entered at the appropriate length for
@ -5205,7 +5205,7 @@ aria-hidden="true"><code>zint -b DBAR_OMN --compliantheight -d "0950110153001"</
code. A check digit and HRT-only Application Identifier of
<code>"(01)"</code> 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.)</p>
will be verified.) Input less than 13 digits will be zero-filled.</p>
<p>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 13 and 32. Truncated symbols may not be scannable by
@ -5229,7 +5229,8 @@ 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 <code>"(01)"</code> are added by Zint, and a 14-digit code
may be given in which case the check digit will be verified.</p>
may be given in which case the check digit will be verified. Input less
than 13 digits will be zero-filled.</p>
<h4 id="gs1-databar-expanded">6.1.11.3 GS1 DataBar Expanded</h4>
<figure>
<img src="images/dbar_exp.svg" title="fig:" class="lin"
@ -5240,17 +5241,16 @@ aria-hidden="true"><code>zint -b DBAR_EXP --compliantheight -d "[01]988987654321
<p>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 <code>--gs1parens</code> switch. See <a
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 <code>--gs1parens</code> switch - see <a
href="#gs1-128">6.1.10.3 GS1-128</a>.</p>
<p>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:</p>
<p>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:</p>
<div class="sourceCode" id="cb105"><pre
class="sourceCode bash"><code class="sourceCode bash"><span id="cb105-1"><a href="#cb105-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> 31 <span class="at">-d</span> <span class="st">&quot;[01]98898765432106[3202]012345[15]991231&quot;</span></span></code></pre></div>
<h3 id="korea-post-barcode">6.1.12 Korea Post Barcode</h3>
@ -5406,7 +5406,8 @@ alt="zint -b CODE16K --compliantheight -d &quot;ab0123456789&quot;" />
<figcaption
aria-hidden="true"><code>zint -b CODE16K --compliantheight -d "ab0123456789"</code></figcaption>
</figure>
<p>Code 16K uses a Code 128 based system which can stack up to 16 rows
<p>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
@ -5421,7 +5422,7 @@ alt="zint -b PDF417 -d &quot;PDF417&quot;" />
aria-hidden="true"><code>zint -b PDF417 -d "PDF417"</code></figcaption>
</figure>
<p>Heavily used in the parcel industry, the PDF417 symbology can encode
a vast amount of data into a small space. Zint supports encoding up to
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.</p>
@ -5525,16 +5526,16 @@ aria-hidden="true"><code>zint -b DBAR_EXPSTK --compliantheight -d "[01]988987654
</figure>
<p>A stacked variation of the GS1 DataBar Expanded symbol for smaller
packages. Input is the same as for GS1 DataBar Expanded (see <a
href="#gs1-databar-expanded">6.1.11.3 GS1 DataBar Expanded</a>). In
addition the width of the symbol can be altered using the
<code>--cols</code> switch (API <code>option_2</code>). 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 <code>--rows</code>
switch (API <code>option_3</code>) 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.</p>
href="#gs1-databar-expanded">6.1.11.3 GS1 DataBar Expanded</a>), with
the same maximum capacity. The width of the symbol can be altered using
the <code>--cols</code> switch (API <code>option_2</code>). 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
<code>--rows</code> switch (API <code>option_3</code>) 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.</p>
<h3 id="code-49">6.2.8 Code 49</h3>
<figure>
<img src="images/code49.svg" title="fig:" class="lin"
@ -5544,11 +5545,11 @@ aria-hidden="true"><code>zint -b CODE49 --compliantheight -d "MULTIPLE ROWS IN C
</figure>
<p>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 <code>--rows</code> option (API <code>option_1</code>), with
values from 2 to 8.</p>
the design of Code 16K a 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 <code>--rows</code> option (API <code>option_1</code>),
with values from 2 to 8.</p>
<h2 id="gs1-composite-symbols-iso-24723">6.3 GS1 Composite Symbols (ISO
24723)</h2>
<p>GS1 Composite symbols employ a mixture of components to give more