mirror of
https://git.code.sf.net/p/zint/code
synced 2025-12-17 09:57:02 +00: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:
gitlost
@@ -19,19 +19,23 @@ IMAGES = \
|
||||
images/zint.png \
|
||||
images/zint-qt.png \
|
||||
images/gui_main.png \
|
||||
images/gui_delete.png \
|
||||
images/gui_zap.png \
|
||||
images/gui_menus.png \
|
||||
images/gui_composite.png \
|
||||
images/gui_segs.png \
|
||||
images/gui_aztec.png \
|
||||
images/gui_appearance.png \
|
||||
images/gui_scaling.png \
|
||||
images/gui_set_printing_scale.png \
|
||||
images/gui_black_eye.png \
|
||||
images/gui_white_eye.png \
|
||||
images/gui_swap.png \
|
||||
images/gui_colour.png \
|
||||
images/gui_data_dialog.png \
|
||||
images/gui_sequence.png \
|
||||
images/gui_export.png \
|
||||
images/gui_cli_equivalent.png \
|
||||
images/gui_black_eye.png \
|
||||
images/gui_white_eye.png \
|
||||
images/gui_swap.png \
|
||||
images/pdf417_heightperrow.svg \
|
||||
images/code128_box.svg \
|
||||
images/qrcode_box.svg \
|
||||
@@ -77,7 +81,7 @@ IMAGES = \
|
||||
images/codabar.svg \
|
||||
images/pharma.svg \
|
||||
images/code128.svg \
|
||||
images/code128b.svg \
|
||||
images/code128ab.svg \
|
||||
images/gs1_128.svg \
|
||||
images/ean14.svg \
|
||||
images/nve18.svg \
|
||||
|
||||
|
Before Width: | Height: | Size: 3.0 KiB After Width: | Height: | Size: 3.0 KiB |
@@ -1,50 +1,50 @@
|
||||
<?xml version="1.0" standalone="no"?>
|
||||
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN"
|
||||
"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
|
||||
<svg width="562" height="286" version="1.1"
|
||||
<svg width="562" height="391" version="1.1"
|
||||
xmlns="http://www.w3.org/2000/svg">
|
||||
<desc>Zint Generated Symbol
|
||||
</desc>
|
||||
|
||||
<g id="barcode" fill="#000000">
|
||||
<rect x="0" y="0" width="562" height="286" fill="#FFFFFF" />
|
||||
<rect x="0.00" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="9.60" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="19.20" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="38.40" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="57.60" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="67.20" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="86.40" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="105.60" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="124.80" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="153.60" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="163.20" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="172.80" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="192.00" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="201.60" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="220.80" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="240.00" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="259.20" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="278.40" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="288.00" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="316.80" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="336.00" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="355.20" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="364.80" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="384.00" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="393.60" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="403.20" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="422.40" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="451.20" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="460.80" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="480.00" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="489.60" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="508.80" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="537.60" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="556.80" y="0.00" width="4.80" height="240.00" />
|
||||
<text x="280.80" y="276.96" text-anchor="middle"
|
||||
<rect x="0" y="0" width="562" height="391" fill="#FFFFFF" />
|
||||
<rect x="0.00" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="9.60" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="19.20" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="38.40" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="57.60" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="67.20" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="86.40" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="105.60" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="124.80" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="153.60" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="163.20" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="172.80" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="192.00" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="201.60" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="220.80" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="240.00" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="259.20" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="278.40" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="288.00" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="316.80" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="336.00" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="355.20" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="364.80" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="384.00" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="393.60" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="403.20" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="422.40" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="451.20" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="460.80" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="480.00" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="489.60" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="508.80" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="537.60" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="556.80" y="0.00" width="4.80" height="345.60" />
|
||||
<text x="280.80" y="382.56" text-anchor="middle"
|
||||
font-family="Helvetica, sans-serif" font-size="33.6" >
|
||||
912320967127
|
||||
91.23 2.096.712 7
|
||||
</text>
|
||||
</g>
|
||||
</svg>
|
||||
|
||||
|
Before Width: | Height: | Size: 2.7 KiB After Width: | Height: | Size: 2.7 KiB |
@@ -1,55 +1,55 @@
|
||||
<?xml version="1.0" standalone="no"?>
|
||||
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN"
|
||||
"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
|
||||
<svg width="648" height="286" version="1.1"
|
||||
<svg width="648" height="391" version="1.1"
|
||||
xmlns="http://www.w3.org/2000/svg">
|
||||
<desc>Zint Generated Symbol
|
||||
</desc>
|
||||
|
||||
<g id="barcode" fill="#000000">
|
||||
<rect x="0" y="0" width="648" height="286" fill="#FFFFFF" />
|
||||
<rect x="0.00" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="9.60" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="19.20" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="28.80" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="57.60" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="67.20" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="86.40" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="105.60" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="124.80" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="144.00" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="153.60" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="163.20" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="192.00" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="211.20" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="240.00" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="249.60" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="259.20" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="278.40" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="288.00" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="307.20" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="326.40" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="355.20" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="364.80" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="374.40" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="393.60" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="412.80" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="432.00" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="451.20" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="470.40" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="480.00" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="499.20" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="508.80" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="537.60" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="556.80" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="576.00" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="604.80" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="614.40" y="0.00" width="4.80" height="240.00" />
|
||||
<rect x="624.00" y="0.00" width="14.40" height="240.00" />
|
||||
<rect x="643.20" y="0.00" width="4.80" height="240.00" />
|
||||
<text x="324.00" y="276.96" text-anchor="middle"
|
||||
<rect x="0" y="0" width="648" height="391" fill="#FFFFFF" />
|
||||
<rect x="0.00" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="9.60" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="19.20" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="28.80" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="57.60" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="67.20" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="86.40" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="105.60" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="124.80" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="144.00" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="153.60" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="163.20" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="192.00" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="211.20" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="240.00" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="249.60" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="259.20" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="278.40" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="288.00" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="307.20" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="326.40" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="355.20" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="364.80" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="374.40" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="393.60" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="412.80" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="432.00" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="451.20" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="470.40" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="480.00" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="499.20" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="508.80" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="537.60" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="556.80" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="576.00" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="604.80" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="614.40" y="0.00" width="4.80" height="345.60" />
|
||||
<rect x="624.00" y="0.00" width="14.40" height="345.60" />
|
||||
<rect x="643.20" y="0.00" width="4.80" height="345.60" />
|
||||
<text x="324.00" y="382.56" text-anchor="middle"
|
||||
font-family="Helvetica, sans-serif" font-size="33.6" >
|
||||
92123209671456
|
||||
92123.209.671.456
|
||||
</text>
|
||||
</g>
|
||||
</svg>
|
||||
|
||||
|
Before Width: | Height: | Size: 3.0 KiB After Width: | Height: | Size: 3.0 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 302 KiB After Width: | Height: | Size: 340 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 713 B After Width: | Height: | Size: 881 B |
BIN
docs/images/gui_delete.png
Normal file
BIN
docs/images/gui_delete.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 410 B |
BIN
docs/images/gui_scaling.png
Normal file
BIN
docs/images/gui_scaling.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 439 B |
BIN
docs/images/gui_set_printing_scale.png
Normal file
BIN
docs/images/gui_set_printing_scale.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 116 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 994 B After Width: | Height: | Size: 334 B |
Binary file not shown.
|
Before Width: | Height: | Size: 952 B After Width: | Height: | Size: 955 B |
BIN
docs/images/gui_zap.png
Normal file
BIN
docs/images/gui_zap.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 533 B |
272
docs/manual.pmd
272
docs/manual.pmd
@@ -1,6 +1,6 @@
|
||||
% Zint Barcode Generator and Zint Barcode Studio User Manual
|
||||
% Version 2.11.1.9
|
||||
% November 2022
|
||||
% December 2022
|
||||
|
||||
# 1. Introduction
|
||||
|
||||
@@ -250,6 +250,17 @@ 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
|
||||
 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
|
||||
 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
|
||||
@@ -295,23 +306,40 @@ part of a Structured Append sequence of symbols.
|
||||
|
||||
|
||||
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  icon to invoke the "Set
|
||||
Printing Scale" dialog - see [4.9 Adjusting Image Size] for further details.
|
||||
|
||||
|
||||
|
||||
The foreground and background colours can be set either using the text boxes
|
||||
which accept RRGGBBAA hexadecimal values or by clicking the foreground eye
|
||||
 and background eye
|
||||
 buttons which invoke a colour picker.
|
||||
|
||||
|
||||
|
||||
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
|
||||
 or background 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  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  button
|
||||
next to it.
|
||||
|
||||
## 3.6 Data Dialog
|
||||
|
||||
|
||||
|
||||
@@ -329,7 +357,7 @@ box any separate lines in the data will be escaped as `'\n'` and the
|
||||
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
|
||||
|
||||
|
||||
|
||||
@@ -351,7 +379,7 @@ meanings as given below:
|
||||
|
||||
Table: {#tbl:sequence_format_characters tag=": Sequence Format Characters"}
|
||||
|
||||
## 3.9 Export Dialog
|
||||
## 3.8 Export Dialog
|
||||
|
||||
|
||||
@@ -361,7 +389,7 @@ Dialog 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
|
||||
|
||||
|
||||
|
||||
@@ -510,6 +538,13 @@ for 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:
|
||||
|
||||
```bash
|
||||
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
|
||||
@@ -613,7 +648,7 @@ Value
|
||||
|
||||
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
|
||||
|
||||
@@ -929,11 +964,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
|
||||
@@ -946,63 +981,73 @@ 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
|
||||
|
||||
```bash
|
||||
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:
|
||||
|
||||
```bash
|
||||
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:
|
||||
|
||||
```bash
|
||||
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
|
||||
```bash
|
||||
zint -b EANX -d "501234567890" --compliantheight --scalexdimdp=0
|
||||
```
|
||||
|
||||
Table: {#tbl:scaling_xdim_0_33mm tag=": 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: {#tbl:maxicode_raster_scaling tag=": 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.
|
||||
```bash
|
||||
zint -b MAXICODE -d "MaxiCode (19 chars)" --scalexdimdp=0,600dpi
|
||||
```
|
||||
|
||||
## 4.10 Input Modes
|
||||
|
||||
@@ -1270,6 +1315,16 @@ Input Filenames Generated
|
||||
|
||||
Table: {#tbl:batch_filename_examples tag=": 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: {#tbl:batch_dir_examples tag=": Batch Directory Examples"}
|
||||
|
||||
## 4.12 Direct Output
|
||||
|
||||
The finished image files can be output directly to stdout for use as part of a
|
||||
@@ -1731,7 +1786,11 @@ Variable Name Type Meaning Default Value
|
||||
`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 5.0
|
||||
@@ -2142,7 +2201,53 @@ int main(int argc, char **argv)
|
||||
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:
|
||||
|
||||
```c
|
||||
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:
|
||||
|
||||
```c
|
||||
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:
|
||||
|
||||
@@ -2180,7 +2285,7 @@ if (ZBarcode_BarcodeName(BARCODE_PDF417, name) == 0) {
|
||||
|
||||
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:
|
||||
@@ -2246,7 +2351,7 @@ if (cap & ZINT_CAP_ECI) {
|
||||
}
|
||||
```
|
||||
|
||||
## 5.14 Zint Version
|
||||
## 5.15 Zint Version
|
||||
|
||||
Whether the Zint library linked to was built with PNG support may be determined
|
||||
with:
|
||||
@@ -2362,16 +2467,16 @@ bind or bindtop) and leaving the border width 0.
|
||||
|
||||
|
||||
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
|
||||
|
||||
|
||||
|
||||
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.
|
||||
|
||||
|
||||
\clearpage
|
||||
@@ -2389,7 +2494,7 @@ to draw a UPC-A symbol with the data 72527270270 with an EAN-5 add-on showing
|
||||
the data 12345 use the command:
|
||||
|
||||
```bash
|
||||
zint -b UPCA -d 72527270270+12345
|
||||
zint -b UPCA -d "72527270270+12345"
|
||||
```
|
||||
|
||||
or using the API encode a data string with the + character included:
|
||||
@@ -2423,7 +2528,7 @@ encoding by entering a 7-digit article number starting with the digit 1. For
|
||||
example:
|
||||
|
||||
```bash
|
||||
zint -b UPCE -d 1123456
|
||||
zint -b UPCE -d "1123456"
|
||||
```
|
||||
|
||||
or
|
||||
@@ -2456,7 +2561,7 @@ 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:
|
||||
|
||||
```bash
|
||||
zint -b EANX -d 54321
|
||||
zint -b EANX -d "54321"
|
||||
```
|
||||
|
||||
|
||||
@@ -2464,7 +2569,7 @@ zint -b EANX -d 54321
|
||||
will encode a stand-alone EAN-5, whereas
|
||||
|
||||
```bash
|
||||
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
|
||||
@@ -2599,7 +2704,7 @@ PZN encodes a 7-digit number to which Zint will add a modulo-11 check digit.
|
||||
--vers=1`](images/logmars.svg)
|
||||
|
||||
LOGMARS (Logistics Applications of Automated Marking and Reading Symbols) is a
|
||||
variation of the Code 39 symbology used by the US Department of Defense.
|
||||
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`).
|
||||
@@ -2669,13 +2774,16 @@ the 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)
|
||||
|
||||
|
||||
|
||||
|
||||
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.
|
||||
|
||||
[^10]: `BARCODE_CODE128AB` previously used the name `BARCODE_CODE128B`, which is
|
||||
still recognised.
|
||||
|
||||
#### 6.1.10.3 GS1-128
|
||||
|
||||
@@ -3318,10 +3426,10 @@ these will be appended by Zint if not included in the input data.
|
||||
|
||||
|
||||
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:
|
||||
@@ -3375,7 +3483,7 @@ zint -b RM4SCC --compliantheight -d "W1J0TR01"
|
||||
--square`](images/hibc_dm.svg)
|
||||
|
||||
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
|
||||
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
|
||||
@@ -3727,7 +3835,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
|
||||
[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)
|
||||
|
||||
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.
|
||||
|
||||
28
docs/zint.1
28
docs/zint.1
@@ -14,7 +14,7 @@
|
||||
. ftr VB CB
|
||||
. ftr VBI CBI
|
||||
.\}
|
||||
.TH "ZINT" "1" "November 2022" "Version 2.11.1.9" ""
|
||||
.TH "ZINT" "1" "December 2022" "Version 2.11.1.9" ""
|
||||
.hy
|
||||
.SH NAME
|
||||
.PP
|
||||
@@ -348,11 +348,29 @@ for MaxiCode) before being applied.
|
||||
The default scale is 1.
|
||||
.RS
|
||||
.PP
|
||||
For MaxiCode, the scale is multiplied by 10 for raster output, by 20 for
|
||||
For MaxiCode, the scale is multiplied by 10 for raster output, by 40 for
|
||||
EMF output, and by 2 otherwise.
|
||||
.PP
|
||||
Increments of 0.5 (half-integers) are recommended for non-MaxiCode
|
||||
raster output (BMP, GIF, PCX, PNG and TIF).
|
||||
.PP
|
||||
See also \f[V]--scalexdimdp\f[R] below.
|
||||
.RE
|
||||
.TP
|
||||
\f[V]--scalexdimdp=X[,R]\f[R]
|
||||
Scale the image according to X-dimension \f[I]X\f[R] and resolution
|
||||
\f[I]R\f[R], where \f[I]X\f[R] is in mm and \f[I]R\f[R] is in dpmm (dots
|
||||
per mm).
|
||||
\f[I]X\f[R] and \f[I]R\f[R] may be floating-point.
|
||||
\f[I]R\f[R] is optional and defaults to 12 dpmm (approximately 300 dpi).
|
||||
.RS
|
||||
.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[V]--scalexdimdp=0.013in,300dpi\f[R].
|
||||
.RE
|
||||
.TP
|
||||
\f[V]--scmvv=INTEGER\f[R]
|
||||
@@ -400,9 +418,9 @@ For Data Matrix symbols, exclude rectangular sizes when considering
|
||||
automatic sizes.
|
||||
.TP
|
||||
\f[V]--structapp=I,C[,ID]\f[R]
|
||||
Set Structured Append info, where \f[V]I\f[R] is the 1-based index,
|
||||
\f[V]C\f[R] is the total number of symbols in the sequence, and
|
||||
\f[V]ID\f[R], which is optional, is the identifier that all symbols in
|
||||
Set Structured Append info, where \f[I]I\f[R] is the 1-based index,
|
||||
\f[I]C\f[R] is the total number of symbols in the sequence, and
|
||||
\f[I]ID\f[R], which is optional, is the identifier that all symbols in
|
||||
the sequence share.
|
||||
Structured Append is supported by Aztec Code, Code One, Data Matrix,
|
||||
DotCode, Grid Matrix, MaxiCode, MicroPDF417, PDF417, QR Code and
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
% ZINT(1) Version 2.11.1.9
|
||||
%
|
||||
% November 2022
|
||||
% December 2022
|
||||
|
||||
# NAME
|
||||
|
||||
@@ -280,10 +280,21 @@ Paintbrush (`PCX`), Portable Network Format (`PNG`), Scalable Vector Graphic (`S
|
||||
: Adjust the size of the X-dimension. *NUMBER* may be floating-point, and is 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 output, and by 2 otherwise.
|
||||
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 `"[)>\R01\Gvv"`, where `vv` is a 2-digit *INTEGER*.
|
||||
@@ -322,8 +333,8 @@ Paintbrush (`PCX`), Portable Network Format (`PNG`), Scalable Vector Graphic (`S
|
||||
|
||||
`--structapp=I,C[,ID]`
|
||||
|
||||
: Set Structured Append info, where `I` is the 1-based index, `C` is the total number of symbols in the sequence,
|
||||
and `ID`, which is optional, is the identifier that all symbols in the sequence share. Structured Append is
|
||||
: Set Structured Append info, where *I* is the 1-based index, *C* is the total number of symbols in the sequence,
|
||||
and *ID*, which is optional, is the identifier that all symbols in the sequence share. Structured Append is
|
||||
supported by Aztec Code, Code One, Data Matrix, DotCode, Grid Matrix, MaxiCode, MicroPDF417, PDF417, QR Code and
|
||||
Ultracode.
|
||||
|
||||
|
||||
@@ -66,7 +66,7 @@ zint -b VIN -d "2FTPX28L0XCA15511" --vers=1 --scale=$SCALE_LINEAR -o images/vin.
|
||||
zint -b CODABAR --compliantheight -d "A37859B" --scale=$SCALE_LINEAR -o images/codabar.svg
|
||||
zint -b PHARMA --compliantheight -d "130170" --scale=$SCALE_LINEAR -o images/pharma.svg
|
||||
zint -b CODE128 --bind -d "130170X178" --scale=$SCALE_LINEAR -o images/code128.svg
|
||||
zint -b CODE128B -d "130170X178" --scale=$SCALE_LINEAR -o images/code128b.svg
|
||||
zint -b CODE128AB -d "130170X178" --scale=$SCALE_LINEAR -o images/code128ab.svg
|
||||
zint -b GS1_128 --compliantheight -d "[01]98898765432106[3202]012345[15]991231" --scale=$SCALE_LINEAR -o images/gs1_128.svg
|
||||
zint -b EAN14 --compliantheight -d "9889876543210" --scale=$SCALE_LINEAR -o images/ean14.svg
|
||||
zint -b NVE18 --compliantheight -d "37612345000001003" --scale=$SCALE_LINEAR -o images/nve18.svg
|
||||
|
||||
Reference in New Issue
Block a user