DMTXREAD(1)

💖 DMTXREAD 💖

okay so bestie, gather round, because this is dmtxread, a lil general commands manual situation, and it is genuinely one of my faves. no cap.

---

✨ NAME ✨

dmtxread — scan Data Matrix barcodes 📷🦋

---

✨ SYNOPSIS ✨

dmtxread [options] [FILE]...

---

✨ DESCRIPTION ✨

so here's the vibe: dmtxread goes looking through the input FILEs you name for ECC200 Data Matrix barcodes — like, it hunts them down — then reads what's inside them and writes the decoded messages out to standard output. 💅

and if you don't name any files at all? or you literally just pass the filename "-"? it reads from standard input instead. she's flexible like that. ✨

---

✨ OPTIONS ✨

• -c, --codewords — only prints the codewords pulled out of a Data Matrix, and NOT the actual decoded message. raw vibes only.
• -e, --minimum-edge=N — the pixel length of the smallest edge you're expecting in the image.
• -E, --maximum-edge=N — the pixel length of the largest edge you're expecting in the image.
• -g, --gap=N — use a scan grid with a gap of N pixels (or less) between the lines. 🕸️
• -l, --list-formats — lists out all the supported input image formats. very "let me show you the menu" energy.
• -m, --milliseconds=N — stop scanning after N milliseconds, and yes that's per image. ⏱️
• -n, --newline — prints a newline character at the end of the decoded data. tiny but iconic.
• -p, --page=N — only scans the Nth page of the images. one page, one moment, main character energy.
• -q, --square-deviation=N — the maximum deviation (in degrees) from squareness between adjacent barcode sides. the default is N=40, but N=10 is what's recommended for flat applications like faxes and other scanned documents. any barcode regions found with corners <(90-N) or >(90+N) get ignored by the decoder. so pick your N wisely bestie.
• -r, --resolution=N — decoding resolution in dots per inch (DPI). this one is only used for vectorial input images like SVG, PDF, etc... it takes a single argument (eg: 300) and also horizontal and vertical resolutions (eg: 300x150). the default resolution is 72dpi. 🎀
• -s, --symbol-size=[asr|RxC] — only consider barcodes of a specific size or shape. options are:
  • a = All sizes [default]
  • s = Only squares
  • r = Only rectangles
  • RxC = Exactly this many rows and columns (10x10, 8x18, etc...)
• -t, --threshold=N — sets the minimum edge threshold as a percentage of maximum. for example, an edge between a pure white and a pure black pixel would have an intensity of 100. edges with intensities below the threshold you indicate get ignored by the decoding process. lowering the threshold increases the amount of work to be done, but it may be necessary for low contrast or blurry images. 😭 tradeoffs, always tradeoffs.
• -x, --x-range-min=N[%] — don't scan pixels to the left of pixel column N (or N%).
• -X, --x-range-max=N[%] — don't scan pixels to the right of pixel column N (or N%).
• -y, --y-range-min=N[%] — don't scan pixels below pixel row N (or N%).
• -Y, --y-range-max=N[%] — don't scan pixels above pixel row N (or N%).
• -C, --corrections-max=N — correct at most N errors per image (0 = correction disabled). zero chill, zero corrections.
• -D, --diagnose — makes a copy of the image with additional diagnostic data. detective mode 🔍
• -M, --mosaic (experimental) — interpret detected regions as Data Mosaic barcodes.

ok so --mosaic is marked experimental, so like, be aware, it's still figuring itself out. 🫶

• -N, --stop-after=N — stop scanning after the Nth barcode is returned. she's done, she's leaving the party.
• -P, --page-numbers — prints each decoded message with its fax/tiff page number.
• -R, --corners — prefixes the decoded message with the barcode's corner locations. 📐
• -S, --shrink=N — internally shrinks the image by a factor of N. the shrinking works by skipping N-1 pixels at a time, which often produces significantly faster scan times. it also improves the scan success rate for images taken with poor camera focus, provided the image is sufficiently large. 🔥
• -U, --unicode — prints Extended ASCII characters in UTF-8 Unicode. ✨
• -v, --verbose — use verbose messages. she will tell you EVERYTHING.
• -V, --version — prints program version information.
• --help — displays this help message and quits. the classic. 🙈

---

✨ STANDARDS ✨

• ISO/IEC 16022:2000
• ANSI/AIM BC11 ISS

she's certified, she's official, she's got the paperwork. 👑

---

✨ DIAGNOSTICS ✨

the exit status has the following possible meanings, and honestly they're giving fortune cookie:

• 0 — at least one barcode was found and decoded 🎉
• 1 — no barcodes were found 😭
• > 1 — an error occurred that prevented the command from executing normally 💀

---

✨ BUGS ✨

found a bug? email bug reports to mike@dragonflylogic.com 💌

---

✨ AUTHOR ✨

Copyright (C) 2008, 2009 Mike Laughton

---

okay that's the whole thing bestie, no cap. this was a General Commands Manual situation, and it's dated June 2, 2011. go scan something slay 💅🎀🦋