mirrors/zint-barcode-generator
1
0
Fork 0
mirror of https://git.code.sf.net/p/zint/code synced 2025-05-09 13:41:59 -04:00
Code Issues Projects Releases Packages Wiki Activity

For Windows, assume outfile & API filename args are in UTF-8,

Browse source 
& use xxxW() APIs accordingly, ticket #288, props Marcel
  **Backwards-incompatible change**
This commit is contained in:
gitlost 2023-05-10 00:47:44 +01:00
parent cc69c86129
commit 15fdca2a03
12 changed files with 151 additions and 47 deletions
Download patch file Download diff file Expand all files Collapse all files

34
docs/manual.txt
View file

@ -1,6 +1,6 @@
Zint Barcode Generator and Zint Barcode Studio User Manual
Version 2.12.0.9
February 2023
May 2023
*******************************************************************************
* For reference the following is a text-only version of the Zint manual, *
@ -701,6 +701,8 @@ created if they don’t already exist:
zint -o "dir/subdir/filename.eps" -d "This Text"
Note that on Windows, filenames are assumed to be UTF-8 encoded.
4.3 Selecting Barcode Type
Selecting which type of barcode you wish to produce (i.e. which symbology to
@ -1668,7 +1670,8 @@ values are 0, 90, 180 and 270.
The ZBarcode_Encode_File() and ZBarcode_Encode_File_and_Print() functions can be
used to encode data read directly from a text file where the filename is given
in the NUL-terminated filename string. The special filename "-" (single hyphen)
can be used to read from stdin.
can be used to read from stdin. Note that on Windows, filenames are assumed to
be UTF-8 encoded.
If printing more than one barcode, the zint_symbol structure may be re-used by
calling the ZBarcode_Clear() function after each barcode to free any output
@ -1836,7 +1839,7 @@ encoding stages. The zint_symbol structure consists of the following variables:
in .png, .gif, .bmp, .emf,
.eps, .pcx, .svg, .tif or
.txt followed by a
terminating NUL.
terminating NUL.[8]
primary character Primary message data for "" (empty)
string more complex symbols, with a
@ -1956,9 +1959,8 @@ background alpha to "00" where the values for R, G and B will be ignored:
5.7 Handling Errors
If errors occur during encoding a non-zero integer value is passed back to the
calling application. In addition the errtxt variable is used to give a message
detailing the nature of the error. The errors generated by Zint are given in the
table below:
calling application. In addition the errtxt variable is set to a message
detailing the nature of the error. The errors generated by Zint are:
-------------------------------------------------------------------------------
Return Value Meaning
@ -2077,10 +2079,10 @@ together when adjusting this value:
-------------------------- ----------------------------------------------------
0 No options selected.
BARCODE_BIND_TOP Boundary bar above the symbol only.[8]
BARCODE_BIND_TOP Boundary bar above the symbol only.[9]
BARCODE_BIND Boundary bars above and below the symbol and between
rows if stacking multiple symbols.[9]
rows if stacking multiple symbols.[10]
BARCODE_BOX Add a box surrounding the symbol and whitespace.
@ -2105,7 +2107,7 @@ together when adjusting this value:
separate colour channels (OUT_BUFFER only).
BARCODE_QUIET_ZONES Add compliant quiet zones (additional to any
specified whitespace).[10]
specified whitespace).[11]
BARCODE_NO_QUIET_ZONES Disable quiet zones, notably those with defaults.
@ -2806,7 +2808,7 @@ Alphabet No. 1 (ISO/IEC 8859-1).
[zint -b CODE128AB -d "130170X178"]
It is sometimes advantageous to stop Code 128 from using Code Set C which
compresses numerical data. The BARCODE_CODE128AB[11] variant (symbology 60)
compresses numerical data. The BARCODE_CODE128AB[12] variant (symbology 60)
suppresses Code Set C in favour of Code Sets A and B.
Note that the special escapes to manually switch Code Sets mentioned above are
@ -4406,7 +4408,7 @@ defined.
Annex B. Man Page ZINT(1)
% ZINT(1) Version 2.12.0.9 % % February 2023
% ZINT(1) Version 2.12.0.9 % % May 2023
NAME
@ -4999,13 +5001,15 @@ Code (including HIBC, Micro QR, rMQR and UPNQR), and Ultracode - all of which
have a fixed width-to-height ratio (or, in the case of Code One, a fixed
height).
[8] The BARCODE_BIND_TOP flag is set by default for DPD - see 6.1.10.7 DPD Code.
[8] For Windows, outfile is assumed to be UTF-8 encoded.
[9] The BARCODE_BIND flag is always set for Codablock-F, Code 16K and Code 49.
[9] The BARCODE_BIND_TOP flag is set by default for DPD - see 6.1.10.7 DPD Code.
[10] 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.
[10] Codablock-F, Code 16K, Code 49, EAN-2 to EAN-13, ISBN, ITF-14, UPC-A and
[11] 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.
[11] BARCODE_CODE128AB previously used the name BARCODE_CODE128B, which is still
[12] BARCODE_CODE128AB previously used the name BARCODE_CODE128B, which is still
recognised.