- 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

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