A ctypes-based wrapper around the libdmtx datamatrix barcode reader.
Project description
A ctypes-based Python wrapper around the libdmtx datamatrix barcode reader.
The pydmtx wrapper is stuck in Python 2.x-land. This ctypes-based wrapper brings libdmtx to Python 2.7 and to Python 3.4 or greater.
Installation
The libdmtx DLLs are included with the Windows Python wheels. On other operating systems, you will need to install the libdmtx shared library.
On Mac OS X:
brew install libdmtx
On Linux:
sudo apt-get install libdmtx0a
Install this Python wrapper; use the second form to install dependencies of the read_datamatrix command-line script:
pip install pylibdmtx pip install pylibdmtx[scripts]
Example usage
The decode function accepts instances of PIL.Image.
>>> from pylibdmtx.pylibdmtx import decode >>> from PIL import Image >>> decode(Image.open('pylibdmtx/tests/datamatrix.png')) [Decoded(data='Stegosaurus', rect=Rect(left=5, top=6, width=96, height=95)), Decoded(data='Plesiosaurus', rect=Rect(left=298, top=6, width=95, height=95))]
It also accepts instances of numpy.ndarray, which might come from loading images using OpenCV.
>>> import cv2 >>> decode(cv2.imread('pylibdmtx/tests/datamatrix.png')) [Decoded(data='Stegosaurus', rect=Rect(left=5, top=6, width=96, height=95)), Decoded(data='Plesiosaurus', rect=Rect(left=298, top=6, width=95, height=95))]
You can also provide a tuple (pixels, width, height)
>>> image = cv2.imread('pylibdmtx/tests/datamatrix.png') >>> height, width = image.shape[:2] >>> decode((image.tobytes(), width, height)) [Decoded(data='Stegosaurus', rect=Rect(left=5, top=6, width=96, height=95)), Decoded(data='Plesiosaurus', rect=Rect(left=298, top=6, width=95, height=95))]
Limitations
Feel free to submit a PR to address any of these.
decoding only - no encoding
I took the bone-headed approach of copying the logic in pydmtx’s decode function (in `pydmtxmodule.c <https://sourceforge.net/p/libdmtx/dmtx-wrappers/ci/master/tree/python/>`__); there might be more of libdmtx’s functionality that could be used to read barcodes
I exposed the bare minimum of functions, defines, enums and typedefs neede to reimplement pydmtx’s decode function
License
pylibdmtx is distributed under the MIT license (see LICENCE.txt). The libdmtx shared library is distributed under the Simplified BSD license (see libdmtx-LICENCE.txt).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Hashes for pylibdmtx-0.1.1-py2.py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bc2d48eec68eecddddfcc28218721c04030891e40fa9e325f9d3fa43844cf316 |
|
MD5 | ed495743e46d111afa3e3d4af1d34003 |
|
BLAKE2b-256 | d0ce2d90f74f7bd6cbb18992ada989d186e97dd89c1d06648937e09ff2ec0ec7 |
Hashes for pylibdmtx-0.1.1-py2.py3-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d36ce945c039b660abf07af03ab9e98f248e79533e5137b5ef7e81d9b10cc083 |
|
MD5 | e6334d130078e9a387eeadfab67cebff |
|
BLAKE2b-256 | 8771a8d3c2766ec00c370572384c2bc50d1cf2d05e7946e98a8b38f998f21d6e |
Hashes for pylibdmtx-0.1.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 94e274fd2d7c8a43dfa73280ae16e4b671f675a36acaee031e6c7f01b72a3c19 |
|
MD5 | ffd48a7fd4a57d688f8f9eedee063048 |
|
BLAKE2b-256 | 58b2dc926dabb46ae8fdb21844038054e8a4ebe3a04a267adf2f69a7c31d39cc |