AZTEC/PDF417: stripf ecc feedback (was getting 32-bit difference)

test suite: test for `arc4random_uniform()` before including "test_bwipp" & "test_random" in build github/ci: try enabling Qt test for ubuntu
2026-01-10 05:26:00 +00:00 · 2025-05-24 02:51:18 +01:00
parent 578d3e4df9
commit 18096a25a7
6 changed files with 129 additions and 114 deletions
--- a/docs/zint.1
+++ b/docs/zint.1
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pandoc 3.6.4
+.\" Automatically generated by Pandoc 3.7.0.1
 .\"
 .TH "ZINT" "1" "April 2025" "Version 2.15.0.9"
 .SH NAME
@@ -51,8 +51,8 @@ Treat each line of an input file specified with \f[CR]\-i\f[R] |
 \f[CR]\-\-input\f[R] as a separate data set and produce a barcode image
 for each one.
 The barcode images are outputted by default to numbered filenames
-starting with \[lq]00001.png\[rq], \[lq]00002.png\[rq] etc., which can
-be changed by using the \f[CR]\-o\f[R] | \f[CR]\-\-output\f[R] option.
+starting with \(lq00001.png\(rq, \(lq00002.png\(rq etc., which can be
+changed by using the \f[CR]\-o\f[R] | \f[CR]\-\-output\f[R] option.
 .TP
 \f[CR]\-\-bg=COLOUR\f[R]
 Specify a background (paper) colour where \f[I]COLOUR\f[R] is in
@@ -63,7 +63,7 @@ decimal \f[CR]C,M,Y,K\f[R] percentages format.
 Treat input data as raw 8\-bit binary data instead of the default
 UTF\-8.
 Automatic code page translation to an ECI page is disabled, and no
-validation of the data\[cq]s character encoding takes place.
+validation of the data\(cqs character encoding takes place.
 .TP
 \f[CR]\-\-bind\f[R]
 Add horizontal boundary bars (also known as bearer bars) to the symbol.
@@ -104,7 +104,7 @@ Affects Codablock\-F, DotCode, GS1 DataBar Expanded Stacked
 .TP
 \f[CR]\-\-compliantheight\f[R]
 Warn if the height specified by the \f[CR]\-\-height\f[R] option is not
-compliant with the barcode\[cq]s specification, or if
+compliant with the barcode\(cqs specification, or if
 \f[CR]\-\-height\f[R] is not given, default to the height specified by
 the specification (if any).
 .TP
@@ -123,7 +123,7 @@ Use \f[CR]\-\-filetype\f[R] to specify output format.
 \f[CR]\-\-dmiso144\f[R]
 For Data Matrix symbols, use the standard ISO/IEC codeword placement for
 144 x 144 (\f[CR]\-\-vers=24\f[R]) sized symbols, instead of the default
-\[lq]de facto\[rq] placement (which rotates the placement of ECC
+\(lqde facto\(rq placement (which rotates the placement of ECC
 codewords).
 .TP
 \f[CR]\-\-dmre\f[R]
@@ -141,7 +141,7 @@ Use dots instead of squares for matrix symbols.
 DotCode is always in dotty mode.
 .TP
 \f[CR]\-\-dump\f[R]
-Dump a hexadecimal representation of the symbol\[cq]s encodation to
+Dump a hexadecimal representation of the symbol\(cqs encodation to
 stdout.
 The same representation may be outputted to a file by using a
 \f[CR].txt\f[R] extension with \f[CR]\-o\f[R] | \f[CR]\-\-output\f[R] or
@@ -168,45 +168,44 @@ The escape sequences are:
 .RS
 .IP
 .EX
-\[rs]0       (0x00)    NUL  Null character
-\[rs]E       (0x04)    EOT  End of Transmission
-\[rs]a       (0x07)    BEL  Bell
-\[rs]b       (0x08)    BS   Backspace
-\[rs]t       (0x09)    HT   Horizontal Tab
-\[rs]n       (0x0A)    LF   Line Feed
-\[rs]v       (0x0B)    VT   Vertical Tab
-\[rs]f       (0x0C)    FF   Form Feed
-\[rs]r       (0x0D)    CR   Carriage Return
-\[rs]e       (0x1B)    ESC  Escape
-\[rs]G       (0x1D)    GS   Group Separator
-\[rs]R       (0x1E)    RS   Record Separator
-\[rs](       (0x28)    (    Opening parenthesis (only with
+\(rs0       (0x00)    NUL  Null character
+\(rsE       (0x04)    EOT  End of Transmission
+\(rsa       (0x07)    BEL  Bell
+\(rsb       (0x08)    BS   Backspace
+\(rst       (0x09)    HT   Horizontal Tab
+\(rsn       (0x0A)    LF   Line Feed
+\(rsv       (0x0B)    VT   Vertical Tab
+\(rsf       (0x0C)    FF   Form Feed
+\(rsr       (0x0D)    CR   Carriage Return
+\(rse       (0x1B)    ESC  Escape
+\(rsG       (0x1D)    GS   Group Separator
+\(rsR       (0x1E)    RS   Record Separator
+\(rs(       (0x28)    (    Opening parenthesis (only with
                        \-\-gs1parens)
-\[rs])       (0x29)    )    Closing parenthesis (only with
+\(rs)       (0x29)    )    Closing parenthesis (only with
                        \-\-gs1parens)
-\[rs]\[rs]       (0x5C)    \[rs]    Backslash
-\[rs]dNNN    (NNN)          Any 8\-bit character where NNN is
+\(rs\(rs       (0x5C)    \(rs    Backslash
+\(rsdNNN    (NNN)          Any 8\-bit character where NNN is
                        decimal (000\-255)
-\[rs]oNNN    (0oNNN)        Any 8\-bit character where NNN is
+\(rsoNNN    (0oNNN)        Any 8\-bit character where NNN is
                        octal (000\-377)
-\[rs]xNN     (0xNN)         Any 8\-bit character where NN is
+\(rsxNN     (0xNN)         Any 8\-bit character where NN is
                        hexadecimal (00\-FF)
-\[rs]uNNNN   (U+NNNN)       Any 16\-bit Unicode BMP character
+\(rsuNNNN   (U+NNNN)       Any 16\-bit Unicode BMP character
                        where NNNN is hexadecimal
-\[rs]UNNNNNN (U+NNNNNN)     Any 21\-bit Unicode character
+\(rsUNNNNNN (U+NNNNNN)     Any 21\-bit Unicode character
                        where NNNNNN is hexadecimal
 .EE
 .RE
 .TP
 \f[CR]\-\-extraesc\f[R]
 For Code 128 only, as well as processing the normal escape sequences
-above, process the special escape sequences \f[CR]\[rs]\[ha]A\f[R],
-\f[CR]\[rs]\[ha]B\f[R], \f[CR]\[rs]\[ha]C\f[R] and
-\f[CR]\[rs]\[ha]\[at]\f[R] that allow manual switching of Code Sets, and
-the special escape sequence \f[CR]\[rs]\[ha]1\f[R] that inserts an
-\f[CR]FNC1\f[R] character.
-The sequence \f[CR]\[rs]\[at]\f[R] turns off manual switching.
-The sequence \f[CR]\[rs]\[ha]\[ha]\f[R] can be used to encode data that
+above, process the special escape sequences \f[CR]\(rs\(haA\f[R],
+\f[CR]\(rs\(haB\f[R], \f[CR]\(rs\(haC\f[R] and \f[CR]\(rs\(ha\(at\f[R]
+that allow manual switching of Code Sets, and the special escape
+sequence \f[CR]\(rs\(ha1\f[R] that inserts an \f[CR]FNC1\f[R] character.
+The sequence \f[CR]\(rs\(at\f[R] turns off manual switching.
+The sequence \f[CR]\(rs\(ha\(ha\f[R] can be used to encode data that
 contains special escape sequences.
 .TP
 \f[CR]\-\-fast\f[R]
@@ -231,16 +230,16 @@ non\-ASCII data.
 \f[CR]\-\-gs1\f[R]
 Treat input as GS1 compatible data.
 Application Identifiers (AIs) should be placed in square brackets
-\f[CR]\[dq][]\[dq]\f[R] (but see \f[CR]\-\-gs1parens\f[R]).
+\f[CR]\(dq[]\(dq\f[R] (but see \f[CR]\-\-gs1parens\f[R]).
 .TP
 \f[CR]\-\-gs1nocheck\f[R]
 Do not check the validity of GS1 data.
 .TP
 \f[CR]\-\-gs1parens\f[R]
-Process parentheses \f[CR]\[dq]()\[dq]\f[R] as GS1 AI delimiters, rather
-than square brackets \f[CR]\[dq][]\[dq]\f[R].
+Process parentheses \f[CR]\(dq()\(dq\f[R] as GS1 AI delimiters, rather
+than square brackets \f[CR]\(dq[]\(dq\f[R].
 If the AI data contains parentheses, they must be backslashed
-(\f[CR]\[dq]\[rs](\[dq]\f[R] or \f[CR]\[dq]\[rs])\[dq]\f[R]) and the
+(\f[CR]\(dq\(rs(\(dq\f[R] or \f[CR]\(dq\(rs)\(dq\f[R]) and the
 \f[CR]\-\-esc\f[R] option selected.
 .TP
 \f[CR]\-\-gssep\f[R]
@@ -253,8 +252,8 @@ main bars, where \f[I]NUMBER\f[R] is in X\-dimensions.
 \f[I]NUMBER\f[R] may be floating\-point.
 .TP
 \f[CR]\-\-guardwhitespace\f[R]
-For EAN/UPC symbols, add quiet zone indicators \f[CR]\[dq]<\[dq]\f[R]
-and/or \f[CR]\[dq]>\[dq]\f[R] to HRT where applicable.
+For EAN/UPC symbols, add quiet zone indicators \f[CR]\(dq<\(dq\f[R]
+and/or \f[CR]\(dq>\(dq\f[R] to HRT where applicable.
 .TP
 \f[CR]\-\-height=NUMBER\f[R]
 Set the height of the symbol in X\-dimensions.
@@ -321,16 +320,16 @@ Remove the Human Readable Text (HRT).
 .TP
 \f[CR]\-o\f[R], \f[CR]\-\-output=FILE\f[R]
 Send the output to \f[I]FILE\f[R].
-When not in batch mode, the default is \[lq]out.png\[rq] (or
-\[lq]out.gif\[rq] if zint built without PNG support).
+When not in batch mode, the default is \(lqout.png\(rq (or
+\(lqout.gif\(rq if zint built without PNG support).
 When in batch mode (\f[CR]\-\-batch\f[R]), special characters can be
 used to format the output filenames:
 .RS
 .IP
 .EX
-\[ti]           Insert a number or 0
+\(ti           Insert a number or 0
 #           Insert a number or space
-\[at]           Insert a number or * (+ on Windows)
+\(at           Insert a number or * (+ on Windows)
 Any other   Insert literally
 .EE
 .RE
@@ -346,8 +345,7 @@ This is in addition to any whitespace specified by \f[CR]\-w\f[R] |
 .TP
 \f[CR]\-r\f[R], \f[CR]\-\-reverse\f[R]
 Reverse the foreground and background colours (white on black).
-Known as \[lq]reflectance reversal\[rq] or \[lq]reversed
-reflectance\[rq].
+Known as \(lqreflectance reversal\(rq or \(lqreversed reflectance\(rq.
 .TP
 \f[CR]\-\-rotate=INTEGER\f[R]
 Rotate the symbol by \f[I]INTEGER\f[R] degrees, where \f[I]INTEGER\f[R]
@@ -389,16 +387,15 @@ used.
 .PP
 The scaling takes into account the output filetype, and deals with all
 the details mentioned above.
-Units may be specified for \f[I]X\f[R] by appending \[lq]in\[rq] (inch)
-or \[lq]mm\[rq], and for \f[I]R\f[R] by appending \[lq]dpi\[rq] (dots
-per inch) or \[lq]dpmm\[rq] \-
-e.g.\ \f[CR]\-\-scalexdimdp=0.013in,300dpi\f[R].
+Units may be specified for \f[I]X\f[R] by appending \(lqin\(rq (inch) or
+\(lqmm\(rq, and for \f[I]R\f[R] by appending \(lqdpi\(rq (dots per inch)
+or \(lqdpmm\(rq \- e.g.\ \f[CR]\-\-scalexdimdp=0.013in,300dpi\f[R].
 .RE
 .TP
 \f[CR]\-\-scmvv=INTEGER\f[R]
 For MaxiCode, prefix the Structured Carrier Message (SCM) with
-\f[CR]\[dq][)>\[rs]R01\[rs]Gvv\[dq]\f[R], where \f[CR]vv\f[R] is a
-2\-digit \f[I]INTEGER\f[R].
+\f[CR]\(dq[)>\(rsR01\(rsGvv\(dq\f[R], where \f[CR]vv\f[R] is a 2\-digit
+\f[I]INTEGER\f[R].
 .TP
 \f[CR]\-\-secure=INTEGER\f[R]
 Set the error correction level (ECC) to \f[I]INTEGER\f[R].
@@ -411,7 +408,7 @@ Aztec Code  1 to 4 (10%, 23%, 36%, 50%)
 Grid Matrix 1 to 5 (10% to 50%)
 Han Xin     1 to 4 (8%, 15%, 23%, 30%)
 Micro QR    1 to 3 (7%, 15%, 25%) (L, M, Q)
-PDF417      0 to 8 (2\[ha](INTEGER + 1) codewords)
+PDF417      0 to 8 (2\(ha(INTEGER + 1) codewords)
 QR Code     1 to 4 (7%, 15%, 25%, 30%) (L, M, Q, H)
 rMQR        2 or 4 (15% or 30%) (M or H)
 Ultracode   1 to 6 (0%, 5%, 9%, 17%, 25%, 33%)
@@ -580,8 +577,8 @@ rMQR            1 to 38 (33 to 38 automatic width) (HxW)
 .EE
 .PP
 For a number of linear symbols, it specifies check character options
-(\[lq]hide\[rq] or \[lq]hidden\[rq] means don\[cq]t show in HRT,
-\[lq]visible\[rq] means do display in HRT):
+(\(lqhide\(rq or \(lqhidden\(rq means don\(cqt show in HRT,
+\(lqvisible\(rq means do display in HRT):
 .IP
 .EX
 C25IATA         1 or 2 (add visible or hidden check digit)
@@ -691,27 +688,27 @@ Error counterpart of warning if \f[CR]\-\-werror\f[R] given
 Error counterpart of warning if \f[CR]\-\-werror\f[R] given
 (\f[CR]ZINT_ERROR_HRT_TRUNCATED\f[R])
 .SH EXAMPLES
-Create \[lq]out.png\[rq] (or \[lq]out.gif\[rq] if zint built without PNG
+Create \(lqout.png\(rq (or \(lqout.gif\(rq if zint built without PNG
 support) in the current directory, as a Code 128 symbol.
 .IP
 .EX
-zint \-d \[aq]This Text\[aq]
+zint \-d \(aqThis Text\(aq
 .EE
 .PP
-Create \[lq]qr.svg\[rq] in the current directory, as a QR Code symbol.
+Create \(lqqr.svg\(rq in the current directory, as a QR Code symbol.
 .IP
 .EX
-zint \-b QRCode \-d \[aq]This Text\[aq] \-o \[aq]qr.svg\[aq]
+zint \-b QRCode \-d \(aqThis Text\(aq \-o \(aqqr.svg\(aq
 .EE
 .PP
-Use batch mode to read from an input file \[lq]ean13nos.txt\[rq]
+Use batch mode to read from an input file \(lqean13nos.txt\(rq
 containing a list of 13\-digit GTINs, each on a separate line, to create
 a series of EAN\-13 barcodes, formatting the output filenames to
-\[lq]ean001.gif\[rq], \[lq]ean002.gif\[rq] etc.
-using the special character \[lq]\[ti]\[rq].
+\(lqean001.gif\(rq, \(lqean002.gif\(rq etc.
+using the special character \(lq\(ti\(rq.
 .IP
 .EX
-zint \-b EAN13 \-\-batch \-i \[aq]ean13nos.txt\[aq] \-o \[aq]ean\[ti]\[ti]\[ti].gif\[aq]
+zint \-b EAN13 \-\-batch \-i \(aqean13nos.txt\(aq \-o \(aqean\(ti\(ti\(ti.gif\(aq
 .EE
 .SH BUGS
 Please send bug reports to https://sourceforge.net/p/zint/tickets/.