1DMTXREAD(1) General Commands Manual DMTXREAD(1)
2
6 dmtxread - scan Data Matrix barcodes
7
9 dmtxread [options] [FILE]...
10
12 dmtxread searches the named input FILEs (or standard input if no files
13 are named or the filename "-" is given) for ECC200 Data Matrix bar‐
14 codes, reads their contents, and writes the decoded messages to stan‐
15 dard output.
16
18 -c, --codewords
19 Only print the codewords extracted from a Data Matrix, and not
20 the actual decoded message.
21 -e, --minimum-edge=N
23 Pixel length of smallest expected edge in image.
24 -E, --maximum-edge=N
26 Pixel length of largest expected edge in image.
27 -g, --gap=N
29 Use scan grid with gap of N pixels (or less) between lines.
30 -l, --list-formats
32 List the supported input image formats.
33 -m, --milliseconds=N
35 Stop scan after N milliseconds (per image).
36 -n, --newline
38 Print a newline character at the end of decoded data.
39 -p, --page=N
41 Only scan Nth page of images.
42 -q, --square-deviation=N
44 Maximum deviation (degrees) from squareness between adjacent
45 barcode sides. Default value is N=40, but N=10 is recommended
46 for flat applications like faxes and other scanned documents.
47 Barcode regions found with corners <(90-N) or >(90+N) will be
48 ignored by the decoder.
49 -r, --resolution=N
51 Decoding resolution in dots per inch (DPI). Only used for vecto‐
52 rial input images such as SVG, PDF, etc... This option accepts a
53 single argument (eg: 300) as well as horizontal and vertical
54 resolutions (eg: 300x150). The default resolution is 72dpi.
55 -s, --symbol-size=[asr|RxC]
57 Only consider barcodes of specific size or shape.
58 a = All sizes [default]
59 s = Only squares
60 r = Only rectangles
61 RxC = Exactly this many rows and columns (10x10, 8x18, etc...)
62 -t, --threshold=N
64 Set the minimum edge threshold as a percentage of maximum. For
65 example, an edge between a pure white and pure black pixel would
66 have an intensity of 100. Edges with intensities below the indi‐
67 cated threshold will be ignored by the decoding process. Lower‐
68 ing the threshold will increase the amount of work to be done,
69 but may be necessary for low contrast or blurry images.
70 -x, --x-range-min=N[%]
72 Do not scan pixels to the left of pixel column N (or N%).
73 -X, --x-range-max=N[%]
75 Do not scan pixels to the right of pixel column N (or N%).
76 -y, --y-range-min=N[%]
78 Do not scan pixels below pixel row N (or N%).
79 -Y, --y-range-max=N[%]
81 Do not scan pixels above pixel row N (or N%).
82 -C, --corrections-max=N
84 Correct at most N errors per image (0 = correction disabled).
85 -D, --diagnose
87 Make copy of image with additional diagnostic data.
88 -M, --mosaic (experimental)
90 Interpret detected regions as Data Mosaic barcodes.
91 -N, --stop-after=N
93 Stop scanning after Nth barcode is returned.
94 -P, --page-numbers
96 Print each decoded message with its fax/tiff page number.
97 -R, --corners
99 Prefix the decoded message with the barcode's corner locations.
100 -S, --shrink=N
102 Internally shrink image by factor of N. Shrinking is accom‐
103 plished by skipping N-1 pixels at a time, often producing sig‐
104 nificantly faster scan times. It also improves scan success rate
105 for images taken with poor camera focus provided the image is
106 sufficiently large.
107 -U, --unicode
109 Print Extended ASCII characters in UTF-8 Unicode.
110 -v, --verbose
112 Use verbose messages.
113 -V, --version
115 Print program version information.
116 --help Display this help message and quit.
118
120 ISO/IEC 16022:2000
121 ANSI/AIM BC11 ISS
123
125 Exit status has following possible meanings:
126 0 At least one barcode was found and decoded
127 1 No barcodes were found
128 >1 Error occurred that prevented command from executing normally
129
131 Email bug reports to mike@dragonflylogic.com
132
134 Copyright (C) 2008, 2009 Mike Laughton
135 June 2, 2011 DMTXREAD(1)