mirror of
https://github.com/zint/zint
synced 2024-11-16 20:57:25 +13:00
- API: add new zint_symbol dpmm
field for output resolution (BMP/
EMF/PCX/PNG/TIF only, i.e. excluding EPS, GIF & SVG) - Add support for specifying scale by X-dimension and resolution with new option `--scalexdimdp` for CLI/Tcl & new API function `ZBarcode_Scale_From_XdimDp()` (+ `ZBarcode_XdimDp_From_Scale()` & `ZBarcode_Default_Xdim()`) and new GUI popup; manual: document - BMP/EMF/PCX/PNG/TIF: use new `dpmm` resolution field (for EMF following Inkscape) - backend_qt: add `dpmm()`, `vectorWidth()`, `vectorHeight()`, `noPng()`, `getVersion()`, `takesGS1AIData()`, & `XdimDp` stuff incl. new `QZintXdimDp` struct for passing around scale vars & use in `getAsCLI()`; add comments - Raise `scale` limit to 200 (from 100) to allow for large dpmm - output: create directories & subdirectories as necessary for output path using new function `out_fopen()` and use in BMP/EMF/ EPS/GIF/PCX/PNG/SVG/TIF - DPLEIT/DPIDENT: format HRT according to (incomplete) documentation, and set default height to 72X (from 50X) - CODE128B renamed to CODE128AB as can use subsets A and/or B - CODABAR: fix minimum height calc - EMF: fix indexing of handles (zero-based not 1-based) - GUI: fix symbology zap (previous technique of clearing and re-loading settings without doing a sync no longer works); fix UPCEAN guard descent enable - MAILMARK: better error message if input < 14 characters - GUI: add "Default" button for DAFT tracker ratio & enable/disable various default buttons; use new `takesGS1AIData()` to enable/disable GS1-specific checkboxes - CLI: use new `validate_float()` to parse float options (7 significant digits allowed only, no scientific notation) - DATAMATRIX/GRIDMATRIX/PDF417/QR/ULTRA: micro-optimize structapp ID parse - library/CLI: fiddle with static asserts (make CHAR_BIT sensitive, supposedly) - win32/README: update building libpng (assembly removed) - README.linux: document incompatibility of Qt6 >= 6.3 - manual: expand Barcode Studio waffle - test suite: change range separator to hyphen and allow multiple excludes
This commit is contained in:
298
docs/manual.txt
298
docs/manual.txt
@ -1,6 +1,6 @@
|
||||
Zint Barcode Generator and Zint Barcode Studio User Manual
|
||||
Version 2.11.1.9
|
||||
November 2022
|
||||
December 2022
|
||||
|
||||
*******************************************************************************
|
||||
* For reference the following is a text-only version of the Zint manual, *
|
||||
@ -22,11 +22,10 @@ November 2022
|
||||
- 3.3 Additional ECI/Data Segments Groupbox
|
||||
- 3.4 Symbology-specific Tab
|
||||
- 3.5 Appearance Tab
|
||||
- 3.6 Colour Dialog
|
||||
- 3.7 Data Dialog
|
||||
- 3.8 Sequence Dialog
|
||||
- 3.9 Export Dialog
|
||||
- 3.10 CLI Equivalent Dialog
|
||||
- 3.6 Data Dialog
|
||||
- 3.7 Sequence Dialog
|
||||
- 3.8 Export Dialog
|
||||
- 3.9 CLI Equivalent Dialog
|
||||
- 4. Using the Command Line
|
||||
- 4.1 Inputting Data
|
||||
- 4.2 Directing Output
|
||||
@ -37,8 +36,9 @@ November 2022
|
||||
- 4.7 Using Colour
|
||||
- 4.8 Rotating the Symbol
|
||||
- 4.9 Adjusting Image Size
|
||||
- 4.9.1 Scaling Example
|
||||
- 4.9.2 MaxiCode Raster Scaling
|
||||
- 4.9.1 Scaling by X-dimension and Resolution
|
||||
- 4.9.2 Scaling Example
|
||||
- 4.9.3 MaxiCode Raster Scaling
|
||||
- 4.10 Input Modes
|
||||
- 4.10.1 Unicode, Data, and GS1 Modes
|
||||
- 4.10.2 Input Modes and ECI
|
||||
@ -65,9 +65,10 @@ November 2022
|
||||
- 5.9 Adjusting Other Output Options
|
||||
- 5.10 Setting the Input Mode
|
||||
- 5.11 Multiple Segments
|
||||
- 5.12 Verifying Symbology Availability
|
||||
- 5.13 Checking Symbology Capabilities
|
||||
- 5.14 Zint Version
|
||||
- 5.12 Scaling Helpers
|
||||
- 5.13 Verifying Symbology Availability
|
||||
- 5.14 Checking Symbology Capabilities
|
||||
- 5.15 Zint Version
|
||||
- 6. Types of Symbology
|
||||
- 6.1 One-Dimensional Symbols
|
||||
- 6.1.1 Code 11
|
||||
@ -105,7 +106,7 @@ November 2022
|
||||
- 6.1.9 Pharmacode
|
||||
- 6.1.10 Code 128
|
||||
- 6.1.10.1 Standard Code 128 (ISO 15417)
|
||||
- 6.1.10.2 Code 128 Subset B
|
||||
- 6.1.10.2 Code 128 Suppress Subset C (Subsets A and B only)
|
||||
- 6.1.10.3 GS1-128
|
||||
- 6.1.10.4 EAN-14
|
||||
- 6.1.10.5 NVE-18 (SSCC-18)
|
||||
@ -415,6 +416,16 @@ only show barcodes in the drop-down whose names contain the word "mail". Each
|
||||
word entered will match. So typing "mail post" will show barcodes whose names
|
||||
contain "mail" or "post" (or both).
|
||||
|
||||
The ellipsis button "..." to the right of the data text box invokes the Data
|
||||
Dialog - see 3.6 Data Dialog for details. The delete button [delete] next to it
|
||||
will clear the data text box and the ECI (Extended Channel Interpretations)
|
||||
drop-down if set.
|
||||
|
||||
To set the barcode as a Programming Initialisation symbol click the
|
||||
"Reader Init" checkbox. The "1234.." button to its right invokes the Sequence
|
||||
Dialog - see 3.7 Sequence Dialog. The zap button [zap] will clear all data and
|
||||
reset all settings for the barcode to defaults.
|
||||
|
||||
The "BMP" and "SVG" buttons at the bottom will copy the image to the clipboard
|
||||
in BMP format and SVG format respectively. Further copy-to-clipboard formats are
|
||||
available by clicking the "Menu" button, along with "CLI Equivalent", "Save As",
|
||||
@ -458,22 +469,38 @@ part of a Structured Append sequence of symbols.
|
||||
[Zint Barcode Studio showing Appearance tab options]
|
||||
|
||||
The Appearance tab can be used to adjust the dimensions and other properties of
|
||||
the symbol. The "Height" value affects the height of symbologies which do not
|
||||
have a fixed width-to-height ratio, i.e. those other than matrix symbologies.
|
||||
Boundary bars ("Border Type") can be added and adjusted ("Border Width") and the
|
||||
size of the saved image ("Printing Scale") can be specified.
|
||||
the symbol.
|
||||
|
||||
3.6 Colour Dialog
|
||||
The "Height" value affects the height of symbologies which do not have a fixed
|
||||
width-to-height ratio, i.e. those other than matrix symbologies. For such
|
||||
symbologies the "Automatic Height" checkbox will be enabled - uncheck this to
|
||||
manually adjust the height. The "Compliant Height" checkbox applies to
|
||||
symbologies that define a standard height - see 4.4 Adjusting Height.
|
||||
|
||||
Boundary bars can be added with the "Border Type" drop-down and their size
|
||||
adjusted with "Border Width", and whitespace can be adjusted both horizontally
|
||||
(first spinbox) and vertically (second spinbox), and also through the
|
||||
"Quiet Zones" checkbox if standard quiet zones are defined for the symbology.
|
||||
|
||||
The size of the saved image can be specified with "Printing Scale", and also by
|
||||
clicking the [scaling] icon to invoke the “Set Printing Scale” dialog - see 4.9
|
||||
Adjusting Image Size for further details.
|
||||
|
||||
[Adjusting the Print Size]
|
||||
|
||||
The foreground and background colours can be set either using the text boxes
|
||||
which accept RRGGBBAA hexadecimal values or by clicking the foreground eye [eye]
|
||||
and background eye [eye] buttons which invoke a colour picker.
|
||||
|
||||
[The colour picker tool]
|
||||
|
||||
A colour dialog is used to adjust the colour of the foreground and background of
|
||||
the generated image. In the Appearance tab click on the foreground eye [eye] or
|
||||
background eye [eye] button respectively. The colours can be reset to
|
||||
black-on-white using the "Reset" button, and exchanged one for the other using
|
||||
the swap [swap] button next to it.
|
||||
(Note that to change the colours visually, the luminence slider, the long narrow
|
||||
column on the right, must be adjusted.)
|
||||
|
||||
3.7 Data Dialog
|
||||
The colours can be reset to black-on-white using the "Reset" button, and
|
||||
exchanged one for the other using the swap [swap] button next to it.
|
||||
|
||||
3.6 Data Dialog
|
||||
|
||||
[Entering longer text input]
|
||||
|
||||
@ -491,7 +518,7 @@ checkbox will be set. This only affects line feeds, not carriage returns (CR) or
|
||||
CR+LF pairs, and behaves the same on both Windows and Unix. (For details on
|
||||
escape sequences, see 4.1 Inputting Data.)
|
||||
|
||||
3.8 Sequence Dialog
|
||||
3.7 Sequence Dialog
|
||||
|
||||
[Creating a sequence of barcode symbols]
|
||||
|
||||
@ -513,7 +540,7 @@ meanings as given below:
|
||||
|
||||
: Table : Sequence Format Characters:
|
||||
|
||||
3.9 Export Dialog
|
||||
3.8 Export Dialog
|
||||
|
||||
[Setting filenames for an exported sequence of barcode symbols]
|
||||
|
||||
@ -522,7 +549,7 @@ sets the parameters for exporting a sequence of barcode images. Here you can set
|
||||
the filename and the output image format. Note that the symbology, colour and
|
||||
other formatting information are taken from the main window.
|
||||
|
||||
3.10 CLI Equivalent Dialog
|
||||
3.9 CLI Equivalent Dialog
|
||||
|
||||
[CLI Equivalent Dialog]
|
||||
|
||||
@ -652,6 +679,11 @@ the other supported file types:
|
||||
|
||||
zint -o there.eps -d "This Text"
|
||||
|
||||
The filename can contain directories and sub-directories also, which will be
|
||||
created if they don’t already exist:
|
||||
|
||||
zint -o "dir/subdir/filename.eps" -d "This Text"
|
||||
|
||||
4.3 Selecting Barcode Type
|
||||
|
||||
Selecting which type of barcode you wish to produce (i.e. which symbology to
|
||||
@ -751,7 +783,7 @@ underscores are optional.
|
||||
|
||||
58 BARCODE_QRCODE QR Code
|
||||
|
||||
60 BARCODE_CODE128B Code 128 (Subset B)
|
||||
60 BARCODE_CODE128AB Code 128 (Suppress subset C)
|
||||
|
||||
63 BARCODE_AUSPOST Australia Post Standard Customer
|
||||
|
||||
@ -1032,11 +1064,11 @@ The scale of the image can be altered using the --scale option followed by a
|
||||
multiple of the default X-dimension. The scale is multiplied by 2 (with the
|
||||
exception of MaxiCode) before being applied. The default scale is 1.
|
||||
|
||||
For MaxiCode, the scale is multiplied by 10 for raster output, by 20 for EMF
|
||||
For MaxiCode, the scale is multiplied by 10 for raster output, by 40 for EMF
|
||||
vector output, and by 2 otherwise (non-EMF vector output).
|
||||
|
||||
For raster output, the default X-dimension is 2 pixels (except for MaxiCode, see
|
||||
4.9.2 MaxiCode Raster Scaling below). For example for PNG images a scale of 5
|
||||
4.9.3 MaxiCode Raster Scaling below). For example for PNG images a scale of 5
|
||||
will increase the X-dimension to 10 pixels. Scales for raster output should be
|
||||
given in increments of 0.5, i.e. 0.5, 1, 1.5, 2, 2.5, 3, 3.5, etc., to avoid the
|
||||
X-dimension varying across the symbol due to interpolation. 0.5 increments are
|
||||
@ -1048,61 +1080,61 @@ minimum scale for raster output in dotty mode is 1 (see 4.14 Working with Dots).
|
||||
|
||||
The minimum scale for vector output is 0.1, giving a minimum X-dimension of 0.2.
|
||||
|
||||
The maximum scale for both raster and vector is 100.
|
||||
The maximum scale for both raster and vector is 200.
|
||||
|
||||
4.9.1 Scaling Example
|
||||
4.9.1 Scaling by X-dimension and Resolution
|
||||
|
||||
An alternative way to specify the scale which takes these details into account
|
||||
is to use the --scalexdimdp option, which has the format
|
||||
|
||||
--scalexdimdp=X[,R]
|
||||
|
||||
where X is the X-dimension (in mm by default) and R is the resolution (in dpmm,
|
||||
dots per mm, by default). R is optional, and defaults to 12 dpmm, and X may be
|
||||
zero, in which case it uses a symbology-specific default. The units may be given
|
||||
in inches for X by appending "in", and in dpi (dots per inch) for R by appending
|
||||
"dpi". For example
|
||||
|
||||
zint -d "1234" --scalexdimdp=0.013in,300dpi
|
||||
|
||||
Explicit metric units may also be given by appending "mm" and "dpmm" as
|
||||
appropriate, and may be mixed with U.S. units:
|
||||
|
||||
zint -d "1234" --scalexdimdp=0.33mm,300dpi
|
||||
|
||||
4.9.2 Scaling Example
|
||||
|
||||
The GS1 General Specifications Section 5.2.6.6 ‘Symbol dimensions at nominal
|
||||
size’ gives an example of an EAN-13 barcode using the X-dimension of 0.33mm. To
|
||||
print that example as a PNG at 12 dots per mm (dpmm), the equivalent of 300 dots
|
||||
per inch (dpi = dpmm * 25.4), specify a scale of 2, since 0.33 * 12 = 3.96
|
||||
pixels, or 4 pixels rounding to the nearest pixel:
|
||||
print that example as a PNG at 12 dpmm, the approximate equivalent of 300 dpi
|
||||
(dpi = dpmm * 25.4), specify a scale of 2, since 0.33 * 12 = 3.96 pixels, or 4
|
||||
pixels rounding to the nearest pixel:
|
||||
|
||||
zint -b EANX -d "501234567890" --compliantheight --scale=2
|
||||
|
||||
This will result in output of 38.27mm x 26.08mm (WxH) at 300 dpi. The following
|
||||
table shows the scale to use (in 0.5 increments) depending on the dpmm desired,
|
||||
for a target X-dimension of 0.33mm:
|
||||
This will result in output of 37.29mm x 25.56mm (WxH) at 12 dpmm. The same
|
||||
result can be achieved using the --scalexdimdp option with
|
||||
|
||||
dpmm dpi scale
|
||||
------ ------ -------
|
||||
6 150 1
|
||||
8 200 1.5
|
||||
12 300 2
|
||||
16 400 3
|
||||
24 600 4
|
||||
47 1200 8
|
||||
95 2400 15.5
|
||||
189 4800 31
|
||||
zint -b EANX -d "501234567890" --compliantheight --scalexdimdp=0
|
||||
|
||||
: Table : Scaling for X-dimension 0.33mm:
|
||||
as 0.33mm is the default X-dimension for EAN, and 12 dpmm the default
|
||||
resolution.
|
||||
|
||||
4.9.2 MaxiCode Raster Scaling
|
||||
4.9.3 MaxiCode Raster Scaling
|
||||
|
||||
For MaxiCode symbols, which use hexagons, the scale for raster output is
|
||||
multiplied by 10 before being applied. The minimum scale is 0.2, so the minimum
|
||||
X-dimension is 2 pixels.
|
||||
multiplied by 10 before being applied. The 0.5 increment recommended for normal
|
||||
raster output does not apply.
|
||||
|
||||
The minimum scale is 0.2, so the minimum X-dimension is 2 pixels. However scales
|
||||
below 0.5 are not recommended and may produce symbols that are not within the
|
||||
following size ranges.
|
||||
|
||||
MaxiCode symbols have fixed size ranges of 24.82mm to 27.93mm in width, and
|
||||
23.71mm to 26.69mm in height, excluding quiet zones. The following table shows
|
||||
the scale to use depending on the dpmm desired, with dpi equivalents:
|
||||
23.71mm to 26.69mm in height, excluding quiet zones. The default X-dimension is
|
||||
0.88mm. For example, to output at the default X-dimension at 600 dpi specify:
|
||||
|
||||
dpmm dpi scale
|
||||
------ ------ -------
|
||||
6 150 0.5
|
||||
8 200 0.7
|
||||
12 300 1
|
||||
16 400 1.4
|
||||
24 600 2.1
|
||||
47 1200 4.1
|
||||
95 2400 8.2
|
||||
189 4800 16.4
|
||||
|
||||
: Table : MaxiCode Raster Scaling:
|
||||
|
||||
Note that the 0.5 increment recommended for normal raster output does not apply.
|
||||
Scales below 0.5 are not recommended and may produce symbols that are not within
|
||||
the minimum/maximum size ranges.
|
||||
zint -b MAXICODE -d "MaxiCode (19 chars)" --scalexdimdp=0,600dpi
|
||||
|
||||
4.10 Input Modes
|
||||
|
||||
@ -1348,6 +1380,16 @@ The following table shows some examples to clarify this method:
|
||||
|
||||
: Table : Batch Filename Examples:
|
||||
|
||||
The special characters can span directories also, which is useful when creating
|
||||
a large number of barcodes:
|
||||
|
||||
Input Filenames Generated
|
||||
--------------------- -----------------------------------------
|
||||
-o dir~/file~~~.svg dir0/file001.svg, dir0/file002.svg, …
|
||||
, dir0/file999.svg, dir1/file000.svg, …
|
||||
|
||||
: Table : Batch Directory Examples:
|
||||
|
||||
4.12 Direct Output
|
||||
|
||||
The finished image files can be output directly to stdout for use as part of a
|
||||
@ -1776,7 +1818,11 @@ encoding stages. The zint_symbol structure consists of the following variables:
|
||||
eci integer Extended Channel 0 (none)
|
||||
Interpretation code.
|
||||
|
||||
dot_size float Diameter of dots used in 4.0 / 5.0
|
||||
dpmm float Resolution of output in dots 0 (none)
|
||||
per mm (BMP/EMF/PCX/PNG/TIF
|
||||
only).
|
||||
|
||||
dot_size float Diameter of dots used in 0.8
|
||||
dotty mode.
|
||||
|
||||
guard_descent float Height of guard bar descent 5.0
|
||||
@ -2147,7 +2193,49 @@ example:
|
||||
A maximum of 256 segments may be specified. Use of multiple segments with GS1
|
||||
data is not currently supported.
|
||||
|
||||
5.12 Verifying Symbology Availability
|
||||
5.12 Scaling Helpers
|
||||
|
||||
To help with scaling the output, the following three function are available:
|
||||
|
||||
float ZBarcode_Default_Xdim(int symbol_id);
|
||||
|
||||
float ZBarcode_Scale_From_XdimDp(int symbol_id, float x_dim_mm, float dpmm,
|
||||
const char *filetype) {
|
||||
|
||||
float ZBarcode_XdimDP_From_Scale(int symbol_id, float scale,
|
||||
float x_dim_mm_or_dpmm, const char *filetype);
|
||||
|
||||
The first ZBarcode_Default_Xdim() returns the default X-dimension suggested by
|
||||
Zint for symbology symbol_id.
|
||||
|
||||
The second ZBarcode_Scale_From_XdimDp() returns the scale to use to output to a
|
||||
file of type filetype with X-dimension x_dim_mm at dpmm dots per mm. The given
|
||||
X-dimension must be non-zero and less than or equal to 10mm, however dpmm may be
|
||||
zero and defaults to 12 dpmm, and filetype may be NULL or empty in which case a
|
||||
GIF filetype is assumed. For raster output (BMP/GIF/PCX/PNG/TIF) the scale is
|
||||
rounded to half-integer increments.
|
||||
|
||||
For example:
|
||||
|
||||
my_symbol->symbology = BARCODE_RM4SCC; /* Royal Mail 4-State Customer Code */
|
||||
my_symbol->dpmm = 600.0f / 25.4f; /* 600 dpi */
|
||||
my_symbol->scale = ZBarcode_Scale_From_XdimDp(
|
||||
my_symbol->symbology,
|
||||
ZBarcode_Default_Xdim(my_symbol->symbology),
|
||||
my_symbol->dpmm, "PNG"); /* 7.5 */
|
||||
|
||||
The third function ZBarcode_XdimDP_From_Scale() is the “reverse” of
|
||||
ZBarcode_Scale_From_XdimDp(), returning the X-dimension (in mm) or the dot
|
||||
density (in dpmm) given a scale scale. Both scale and x_dim_mm_or_dpmm must be
|
||||
non-zero. The returned value is bound to the maximum value of dpmm (1000), so
|
||||
must be further bound to 10 on return if the X-dimension is sought.
|
||||
|
||||
Note that the X-dimension to use is application dependent, and varies not only
|
||||
due to the symbology, resolution and filetype but also due to the type of
|
||||
scanner used, the intended scanning distance, and what media (“substrates”) the
|
||||
barcode appears on.
|
||||
|
||||
5.13 Verifying Symbology Availability
|
||||
|
||||
An additional function available in the API is:
|
||||
|
||||
@ -2177,7 +2265,7 @@ success. For instance:
|
||||
|
||||
will print BARCODE_PDF417.
|
||||
|
||||
5.13 Checking Symbology Capabilities
|
||||
5.14 Checking Symbology Capabilities
|
||||
|
||||
It can be useful for frontend programs to know the capabilities of a symbology.
|
||||
This can be determined using another additional function:
|
||||
@ -2239,7 +2327,7 @@ For example:
|
||||
printf("PDF417 does not support ECI\n");
|
||||
}
|
||||
|
||||
5.14 Zint Version
|
||||
5.15 Zint Version
|
||||
|
||||
Whether the Zint library linked to was built with PNG support may be determined
|
||||
with:
|
||||
@ -2349,16 +2437,16 @@ bind or bindtop) and leaving the border width 0.
|
||||
[zint -b DPLEIT -d "9212320967145"]
|
||||
|
||||
Leitcode is based on Interleaved Code 2 of 5 and is used by Deutsche Post for
|
||||
mailing purposes. Leitcode requires a 13-digit numerical input and includes a
|
||||
check digit.
|
||||
routing purposes. Leitcode requires a 13-digit numerical input to which Zint
|
||||
adds a check digit.
|
||||
|
||||
6.1.2.8 Deutsche Post Identcode
|
||||
|
||||
[zint -b DPIDENT -d "91232096712"]
|
||||
|
||||
Identcode is based on Interleaved Code 2 of 5 and is used by Deutsche Post for
|
||||
mailing purposes. Identcode requires an 11-digit numerical input and includes a
|
||||
check digit.
|
||||
identification purposes. Identcode requires an 11-digit numerical input to which
|
||||
Zint adds a check digit.
|
||||
|
||||
6.1.3 UPC (Universal Product Code) (ISO 15420)
|
||||
|
||||
@ -2372,7 +2460,7 @@ EAN-2 and EAN-5 add-on symbols can be added using the + character. For example,
|
||||
to draw a UPC-A symbol with the data 72527270270 with an EAN-5 add-on showing
|
||||
the data 12345 use the command:
|
||||
|
||||
zint -b UPCA -d 72527270270+12345
|
||||
zint -b UPCA -d "72527270270+12345"
|
||||
|
||||
or using the API encode a data string with the + character included:
|
||||
|
||||
@ -2401,7 +2489,7 @@ calculated by Zint. EAN-2 and EAN-5 add-on symbols can be added using the +
|
||||
character as with UPC-A. In addition Zint also supports Number System 1 encoding
|
||||
by entering a 7-digit article number starting with the digit 1. For example:
|
||||
|
||||
zint -b UPCE -d 1123456
|
||||
zint -b UPCE -d "1123456"
|
||||
|
||||
or
|
||||
|
||||
@ -2430,13 +2518,13 @@ Zint will decide which symbology to use depending on the length of the input
|
||||
data. In addition EAN-2 and EAN-5 add-on symbols can be added to EAN-8 and
|
||||
EAN-13 symbols using the + character as with UPC symbols. For example:
|
||||
|
||||
zint -b EANX -d 54321
|
||||
zint -b EANX -d "54321"
|
||||
|
||||
[zint -b EANX --compliantheight -d "54321"]
|
||||
|
||||
will encode a stand-alone EAN-5, whereas
|
||||
|
||||
zint -b EANX -d 7432365+54321
|
||||
zint -b EANX -d "7432365+54321"
|
||||
|
||||
will encode an EAN-8 symbol with an EAN-5 add-on. As before these results can be
|
||||
achieved using the API:
|
||||
@ -2567,9 +2655,9 @@ PZN encodes a 7-digit number to which Zint will add a modulo-11 check digit.
|
||||
[zint -b LOGMARS --compliantheight -d "12345/ABCDE" --vers=1]
|
||||
|
||||
LOGMARS (Logistics Applications of Automated Marking and Reading Symbols) is a
|
||||
variation of the Code 39 symbology used by the US Department of Defense. LOGMARS
|
||||
encodes the same character set as Standard Code 39. It does not require a check
|
||||
digit but a modulo-43 check digit can be added by setting --vers=1 (API
|
||||
variation of the Code 39 symbology used by the U.S. Department of Defense.
|
||||
LOGMARS encodes the same character set as Standard Code 39. It does not require
|
||||
a check digit but a modulo-43 check digit can be added by setting --vers=1 (API
|
||||
option_2 = 1).
|
||||
|
||||
6.1.7.6 Code 32
|
||||
@ -2636,13 +2724,13 @@ encoding of ISO/IEC 8859-1 (non-English) characters in Code 128 symbols. The
|
||||
ISO/IEC 8859-1 character set is shown in Appendix A.2 Latin Alphabet No. 1
|
||||
(ISO/IEC 8859-1).
|
||||
|
||||
6.1.10.2 Code 128 Subset B
|
||||
6.1.10.2 Code 128 Suppress Subset C (Subsets A and B only)
|
||||
|
||||
[zint -b CODE128B -d "130170X178"]
|
||||
[zint -b CODE128AB -d "130170X178"]
|
||||
|
||||
It is sometimes advantageous to stop Code 128 from using subset mode C which
|
||||
compresses numerical data. The BARCODE_CODE128B variant (symbology 60)
|
||||
suppresses mode C in favour of mode B.
|
||||
compresses numerical data. The BARCODE_CODE128AB[10] variant (symbology 60)
|
||||
suppresses mode C in favour of modes A and B.
|
||||
|
||||
6.1.10.3 GS1-128
|
||||
|
||||
@ -3242,10 +3330,10 @@ these will be appended by Zint if not included in the input data.
|
||||
|
||||
[zint -b USPS_IMAIL --compliantheight -d "01234567094987654321-01234"]
|
||||
|
||||
Also known as the OneCode barcode and used in the US by the United States Postal
|
||||
Service (USPS), the Intelligent Mail system replaced the POSTNET and PLANET
|
||||
symbologies in 2009. Intelligent Mail is a fixed length (65-bar) symbol which
|
||||
combines routing and customer information in a single symbol. Input data
|
||||
Also known as the OneCode barcode and used in the U.S. by the United States
|
||||
Postal Service (USPS), the Intelligent Mail system replaced the POSTNET and
|
||||
PLANET symbologies in 2009. Intelligent Mail is a fixed length (65-bar) symbol
|
||||
which combines routing and customer information in a single symbol. Input data
|
||||
consists of a 20-digit tracking code, followed by a dash (-), followed by a
|
||||
delivery point zip-code which can be 0, 5, 9 or 11 digits in length. For example
|
||||
all of the following inputs are valid data entries:
|
||||
@ -3290,8 +3378,8 @@ as
|
||||
[zint -b HIBC_DM -d "/ACMRN123456/V200912190833" --fast --square]
|
||||
|
||||
Also known as Semacode this symbology was developed in 1989 by Acuity CiMatrix
|
||||
in partnership with the US DoD and NASA. The symbol can encode a large amount of
|
||||
data in a small area. Data Matrix encodes characters in the Latin-1 set by
|
||||
in partnership with the U.S. DoD and NASA. The symbol can encode a large amount
|
||||
of data in a small area. Data Matrix encodes characters in the Latin-1 set by
|
||||
default but also supports encoding in other character sets using the ECI
|
||||
mechanism. It can also encode GS1 data. The size of the generated symbol can be
|
||||
adjusted using the --vers option (API option_2) as shown in the table below. A
|
||||
@ -3627,7 +3715,7 @@ using the --structapp option (see 4.16 Structured Append) (API structapp). It
|
||||
does not support specifying an ID.
|
||||
|
||||
MaxiCode uses a different scaling than other symbols for raster output, see
|
||||
4.9.2 MaxiCode Raster Scaling, and also for EMF vector output, when the scale is
|
||||
4.9.3 MaxiCode Raster Scaling, and also for EMF vector output, when the scale is
|
||||
multiplied by 20 instead of 2.
|
||||
|
||||
6.6.7 Aztec Code (ISO 24778)
|
||||
@ -4165,7 +4253,7 @@ defined.
|
||||
|
||||
Annex B. Man Page ZINT(1)
|
||||
|
||||
% ZINT(1) Version 2.11.1.9 % % November 2022
|
||||
% ZINT(1) Version 2.11.1.9 % % December 2022
|
||||
|
||||
NAME
|
||||
|
||||
@ -4478,12 +4566,25 @@ OPTIONS
|
||||
multiplied by 2 (except for MaxiCode) before being applied. The default
|
||||
scale is 1.
|
||||
|
||||
For MaxiCode, the scale is multiplied by 10 for raster output, by 20 for EMF
|
||||
For MaxiCode, the scale is multiplied by 10 for raster output, by 40 for EMF
|
||||
output, and by 2 otherwise.
|
||||
|
||||
Increments of 0.5 (half-integers) are recommended for non-MaxiCode raster
|
||||
output (BMP, GIF, PCX, PNG and TIF).
|
||||
|
||||
See also --scalexdimdp below.
|
||||
|
||||
--scalexdimdp=X[,R]
|
||||
|
||||
Scale the image according to X-dimension X and resolution R, where X is in
|
||||
mm and R is in dpmm (dots per mm). X and R may be floating-point. R is
|
||||
optional and defaults to 12 dpmm (approximately 300 dpi).
|
||||
|
||||
The scaling takes into account the output filetype, and deals with all the
|
||||
details mentioned above. Units may be specified for X by appending “in”
|
||||
(inch) or “mm”, and for R by appending “dpi” (dots per inch) or “dpmm” -
|
||||
e.g. --scalexdimdp=0.013in,300dpi.
|
||||
|
||||
--scmvv=INTEGER
|
||||
|
||||
For MaxiCode, prefix the Structured Carrier Message (SCM) with
|
||||
@ -4728,3 +4829,6 @@ Special considerations apply to ITF-14 - see 6.1.2.6 ITF-14.
|
||||
|
||||
[9] 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.
|
||||
|
||||
[10] BARCODE_CODE128AB previously used the name BARCODE_CODE128B, which is still
|
||||
recognised.
|
||||
|
Reference in New Issue
Block a user