Mirrors/zint
1
0
Fork 0
mirror of https://git.code.sf.net/p/zint/code synced 2026-05-08 23:23:53 +00:00
Code Issues Projects Releases Wiki Activity

- CODABLOCKF: fix misencodation of extended ASCII 0xB0-0xB9 when

Browse Source 
followed by digit (ignore 2nd byte of FNC4 when categorizing
  Code C characters)
- New `ZBarcode_Cap()` flag `ZINT_CAP_BINDABLE`, differentiated
  from `ZINT_CAP_STACKABLE`, and new Qt Backend method
  `isBindable()`
- CLI: fix `separator` check to use new `ZINT_CAP_BINDABLE` instead
  of `ZINT_CAP_STACKABLE`
- ZBarcode_Cap: add missing symbologies to `ZINT_CAP_BINDABLE` (was
  `ZINT_CAP_STACKABLE`)
- DOTCODE: pad rows if given number of columns instead of failing
  if rows below min (5)
- DBAR/composites: ensure stacked symbologies and composites are
  not stacked (set `symbol->rows` to 0)
- test suite: move `test_perf` routines into single test
  "test_perf";
  new "test_random" (based on "test_bwipp") to test various
  symbologies with random binary - discovered CODABLOCKF bug;
  expand "test_bwipp"
manual: Feeback: mention AZTEC -1 meaning min & MICROPDF417:
  doc new `ZINT_CAP_BINDABLE`
general: various code fiddlings and re-formattings
This commit is contained in:
gitlost
2025-04-03 16:08:15 +01:00
parent 2370fbfbb7
commit a74871a7de
60 changed files with 3509 additions and 3267 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
docs/manual.html
View File

@@ -333,7 +333,7 @@
<h1 class="title">Zint Barcode Generator and Zint Barcode Studio User
Manual</h1>
<p class="author">Version 2.15.0.9</p>
<p class="date">March 2025</p>
<p class="date">April 2025</p>
</header>
<nav id="TOC" role="doc-toc">
<ul>
@@ -4224,7 +4224,8 @@ Text?</td>
</tr>
<tr>
<td style="text-align: left;"><code>ZINT_CAP_STACKABLE</code></td>
<td style="text-align: left;">Is the symbology stackable?</td>
<td style="text-align: left;">Is the symbology stackable? Note that
stacked symbologies are not stackable.</td>
</tr>
<tr>
<td style="text-align: left;"><code>ZINT_CAP_EANUPC</code><a
@@ -4255,7 +4256,7 @@ dots?</td>
<tr>
<td style="text-align: left;"><code>ZINT_CAP_QUIET_ZONES</code></td>
<td style="text-align: left;">Does the symbology have default quiet
zones?</td>
zones? Note that default quiet zones may be zero.</td>
</tr>
<tr>
<td style="text-align: left;"><code>ZINT_CAP_FIXED_RATIO</code></td>
@@ -4287,6 +4288,12 @@ style="text-align: left;"><code>ZINT_CAP_COMPLIANT_HEIGHT</code></td>
<td style="text-align: left;">Does the symbology have a compliant height
defined?</td>
</tr>
<tr>
<td style="text-align: left;"><code>ZINT_CAP_BINDABLE</code></td>
<td style="text-align: left;">Does the symbology have row separators
that can be set? Includes stacked symbologies and stackable linear
symbologies.</td>
</tr>
</tbody>
</table>
</div>
@@ -4317,9 +4324,9 @@ return the actual ECC percentage used in <code>option_1</code> as
<code>P &lt;&lt; 8</code>, where P is the integer percentage, the low
byte containing the values given in Table <a href="#tbl:aztec_eccs">:
Aztec Code Error Correction Modes</a> (with the addition of
<code>0</code> meaning less than 5% + 3 codewords). Micro PDF417 also
will return the ECC percentage in <code>option_1</code> as
<code>P &lt;&lt; 8</code>.</p>
<code>0</code> meaning less than 5% + 3 codewords and <code>-1</code>
meaning minimum 3 codewords). Micro PDF417 also will return the ECC
percentage in <code>option_1</code> as <code>P &lt;&lt; 8</code>.</p>
<p>Detailed feedback on the data encoded may be requested by specifying
the <code>BARCODE_RAW_TEXT</code> option in the
<code>output_options</code> member, which will populate the
@@ -4392,7 +4399,7 @@ default. To add just one check digit, set <code>--vers=1</code> (API
<h3 id="code-2-of-5">6.1.2 Code 2 of 5</h3>
<p>Code 2 of 5 is a family of one-dimensional self-checking symbols, 8
of which are supported by Zint. Note that the names given to these
standards alters from one source to another so you should take care to
standards alter from one source to another so you should take care to
ensure that you have the right barcode type before using them.</p>
<h4 id="standard-code-2-of-5">6.1.2.1 Standard Code 2 of 5</h4>
<figure>
@@ -7656,7 +7663,7 @@ alt="zint -b DOTCODE -d &quot;[01]00012345678905[17]201231[10]ABC123456&quot; --
aria-hidden="true"><code>zint -b DOTCODE -d "[01]00012345678905[17]201231[10]ABC123456" --gs1</code></figcaption>
</figure>
<p>DotCode uses a grid of dots in a rectangular formation to encode
characters up to a maximum of approximately 450 characters (or 900
characters up to a maximum of approximately 1220 characters (or 2940
numeric digits). The symbology supports ECI encoding and GS1 data
encoding. By default Zint will produce a symbol which is approximately
square, however the width of the symbol can be adjusted by using the

19
docs/manual.pmd
View File

@@ -1,6 +1,6 @@
% Zint Barcode Generator and Zint Barcode Studio User Manual
% Version 2.15.0.9
% March 2025
% April 2025
# 1. Introduction
@@ -2607,7 +2607,8 @@ Value Meaning
------------------------- --------------------------------------------------
`ZINT_CAP_HRT` Can the symbology print Human Readable Text?
`ZINT_CAP_STACKABLE` Is the symbology stackable?
`ZINT_CAP_STACKABLE` Is the symbology stackable? Note that stacked
symbologies are not stackable.
`ZINT_CAP_EANUPC`[^14] Is the symbology EAN/UPC?
@@ -2622,6 +2623,7 @@ Value Meaning
`ZINT_CAP_DOTTY` Can the symbology be outputted as dots?
`ZINT_CAP_QUIET_ZONES` Does the symbology have default quiet zones?
Note that default quiet zones may be zero.
`ZINT_CAP_FIXED_RATIO` Does the symbology have a fixed width-to-height
(aspect) ratio?
@@ -2636,6 +2638,10 @@ Value Meaning
`ZINT_CAP_COMPLIANT_HEIGHT` Does the symbology have a compliant height
defined?
`ZINT_CAP_BINDABLE` Does the symbology have row separators that can be
set? Includes stacked symbologies and stackable
linear symbologies.
------------------------------------------------------------------------------
Table: {#tbl:api_cap tag=": API Capability Flags"}
@@ -2671,8 +2677,9 @@ In particular for symbologies that have masks,[^15] `option_3` will contain the
mask used as `(N + 1) << 8`, N being the mask. Also Aztec Code will return the
actual ECC percentage used in `option_1` as `P << 8`, where P is the integer
percentage, the low byte containing the values given in Table {@tbl:aztec_eccs}
(with the addition of `0` meaning less than 5% + 3 codewords). Micro PDF417 also
will return the ECC percentage in `option_1` as `P << 8`.
(with the addition of `0` meaning less than 5% + 3 codewords and `-1` meaning
minimum 3 codewords). Micro PDF417 also will return the ECC percentage in
`option_1` as `P << 8`.
Detailed feedback on the data encoded may be requested by specifying the
`BARCODE_RAW_TEXT` option in the `output_options` member, which will populate
@@ -2765,7 +2772,7 @@ check digits are added by default. To add just one check digit, set `--vers=1`
### 6.1.2 Code 2 of 5
Code 2 of 5 is a family of one-dimensional self-checking symbols, 8 of which are
supported by Zint. Note that the names given to these standards alters from one
supported by Zint. Note that the names given to these standards alter from one
source to another so you should take care to ensure that you have the right
barcode type before using them.
@@ -4674,7 +4681,7 @@ Structured Append]) (API `structapp`). The ID ranges from 0 (default) to 255.
--gs1`](images/dotcode.svg){.i2d}
DotCode uses a grid of dots in a rectangular formation to encode characters up
to a maximum of approximately 450 characters (or 900 numeric digits). The
to a maximum of approximately 1220 characters (or 2940 numeric digits). The
symbology supports ECI encoding and GS1 data encoding. By default Zint will
produce a symbol which is approximately square, however the width of the symbol
can be adjusted by using the `--cols` option (API `option_2`) (maximum 200).

22
docs/manual.txt
View File

@@ -1,6 +1,6 @@
Zint Barcode Generator and Zint Barcode Studio User Manual
Version 2.15.0.9
March 2025
April 2025
*******************************************************************************
* For reference the following is a text-only version of the Zint manual, *
@@ -2553,7 +2553,8 @@ see which are set.
--------------------------- --------------------------------------------------
ZINT_CAP_HRT Can the symbology print Human Readable Text?
ZINT_CAP_STACKABLE Is the symbology stackable?
ZINT_CAP_STACKABLE Is the symbology stackable? Note that stacked
symbologies are not stackable.
ZINT_CAP_EANUPC[14] Is the symbology EAN/UPC?
@@ -2567,7 +2568,8 @@ see which are set.
ZINT_CAP_DOTTY Can the symbology be outputted as dots?
ZINT_CAP_QUIET_ZONES Does the symbology have default quiet zones?
ZINT_CAP_QUIET_ZONES Does the symbology have default quiet zones? Note
that default quiet zones may be zero.
ZINT_CAP_FIXED_RATIO Does the symbology have a fixed width-to-height
(aspect) ratio?
@@ -2582,6 +2584,10 @@ see which are set.
ZINT_CAP_COMPLIANT_HEIGHT Does the symbology have a compliant height
defined?
ZINT_CAP_BINDABLE Does the symbology have row separators that can be
set? Includes stacked symbologies and stackable
linear symbologies.
------------------------------------------------------------------------------
Table : API Capability Flags
@@ -2613,8 +2619,8 @@ mask used as (N + 1) << 8, N being the mask. Also Aztec Code will return the
actual ECC percentage used in option_1 as P << 8, where P is the integer
percentage, the low byte containing the values given in Table
: Aztec Code Error Correction Modes (with the addition of 0 meaning less than
5% + 3 codewords). Micro PDF417 also will return the ECC percentage in option_1
as P << 8.
5% + 3 codewords and -1 meaning minimum 3 codewords). Micro PDF417 also will
return the ECC percentage in option_1 as P << 8.
Detailed feedback on the data encoded may be requested by specifying the
BARCODE_RAW_TEXT option in the output_options member, which will populate the
@@ -2687,7 +2693,7 @@ check digits are added by default. To add just one check digit, set --vers=1
6.1.2 Code 2 of 5
Code 2 of 5 is a family of one-dimensional self-checking symbols, 8 of which are
supported by Zint. Note that the names given to these standards alters from one
supported by Zint. Note that the names given to these standards alter from one
source to another so you should take care to ensure that you have the right
barcode type before using them.
@@ -4469,7 +4475,7 @@ Structured Append) (API structapp). The ID ranges from 0 (default) to 255.
[zint -b DOTCODE -d "[01]00012345678905[17]201231[10]ABC123456" --gs1]
DotCode uses a grid of dots in a rectangular formation to encode characters up
to a maximum of approximately 450 characters (or 900 numeric digits). The
to a maximum of approximately 1220 characters (or 2940 numeric digits). The
symbology supports ECI encoding and GS1 data encoding. By default Zint will
produce a symbol which is approximately square, however the width of the symbol
can be adjusted by using the --cols option (API option_2) (maximum 200).
@@ -4930,7 +4936,7 @@ configured barcode is displayed once the "Generate" button is pressed.
Annex D. Man Page ZINT(1)
% ZINT(1) Version 2.15.0.9 % % March 2025
% ZINT(1) Version 2.15.0.9 % % April 2025
NAME

2
docs/zint.1
View File

@@ -1,6 +1,6 @@
.\" Automatically generated by Pandoc 3.6.4
.\"
.TH "ZINT" "1" "March 2025" "Version 2.15.0.9"
.TH "ZINT" "1" "April 2025" "Version 2.15.0.9"
.SH NAME
\f[CR]zint\f[R] \- encode data as a barcode image
.SH SYNOPSIS

2
docs/zint.1.pmd
View File

@@ -1,6 +1,6 @@
% ZINT(1) Version 2.15.0.9
%
% March 2025
% April 2025
# NAME