Releases: zxing-cpp/zxing-cpp
v2.3.0
Shiny new stuff (more than I was aware of, after all this time...)
- Add support for DX Film Edge read by @Merinorus in #684
- Add support for detecting and reading Aztec Runes by @gormster in #763
- Add reader support for
DataBarLimited
symbols (sponsored by EUREKAM) - Add C-API in official build (EDIT: unfortunately the default is still off, to enable do
cmake -DZXING_C_API=ON
) - Add Kotlin/Native Wrapper by @ISNing in #719
- Add Rust wrapper based on C-API
- Add .NET wrapper based on C-API
- Introduce new name
Barcode
forResult
which will be removed in 3.0 - LocalAverage binarizer: re-implement with symmetric threshold interpolation for improved detection of inverted symbols
- cmake: replace
BUILD_...
prefix of cmake options withZXING_...
- cmake: switch to c++-20 by default for the core library
- ImageView: introduce bounds checks in constructor
- ImageView: Add ImageFormat::LumX for 2-byte grey + alpha input
- ImageFormat: replace 'X' with 'A', e.g. RGBX -> RGBA
- ZXingReader: add -binarizer <local|global|fixed> command line option
- ZXingReader: add -single option to setMaxNumberOfSymbols(1)
- ZXingReader: parse -formats (including 's') command line argument
- ZXingReader: support reading image file from stdin by passing '-'
- android: switch 'namespace' from
zxingcpp
tozxingcpp.lib
to fix issue with maven central publication - Python: add support to write
bytes
as binary data ZXing::Version()
function to query the library version at runtime (useful when dynamically linked)
New experimental API (cmake option -DZXING_EXPERIMENTAL_API=ON
)
- New experimental Create+Write API for generating/writing barcodes (will replace MultiFormatWriter)
- New experimental libzint based writer backend
- New
ImageView Barcode::symbol()
property - New experimental writer API in python
Minor changes and bug fixes
- Complete ZXIReaderOptions in iOS Wrapper by @markusfisch in #692
- ios: remove initWithFormats initializer by @markusfisch in #723
- cmake: Make build reproducible across different build directories by @EchterAgo in #730
- Release color space after use in iOS wrapper by @markusfisch in #790
- cmake: allow overriding python install directories by @jameshilliard in #842
- Refine MultiFormatReader results filtering and apply C++20
erase_if
by @Doekin in #846 - HRI: update AIs to latest gs1-syntax-dictionary.txt by @gitlost in #880
- android: add linker flag to support flexible page sizes in Android 15 by @ccrowell-kr in #872
- Deprecate
validateITFCheckSum
,validateCode39CheckSum
,returnCodabarStartEnd
- BitHacks: fix random QRCode content on pre-Haswell Windows machines
- DataMatrix: improve detection of near 45Β° rotated symbols
- cmake: add /utf-8 to MSVC compile flags
- Barcode: tune operator==() to not split up overly tall linear symbols
- Several ITFReader improvements
- QRDecoder: return some content even in the presence of a checksum error
- DataBar: improve detection rate by incorporating edge-2-edge pattern
- PDF417: prevent wrong position info with right side collapsing to (0,0)
- Python: make sure macOS and 64bit Linux packes on pypi.org support multi-symbol DataMatrix detection (c++20 support)
New Contributors
- @Merinorus made their first contribution in #684
- @ISNing made their first contribution in #718
- @hha1501 made their first contribution in #747
- @gormster made their first contribution in #763
- @549393092 made their first contribution in #777
- @bindreams made their first contribution in #787
- @johngladp made their first contribution in #808
- @jameshilliard made their first contribution in #842
- @Doekin made their first contribution in #846
- @spageektti made their first contribution in #858
- @stbergmann made their first contribution in #864
- @ccrowell-kr made their first contribution in #872
- @GUIEEN made their first contribution in #877
Sponsors
Thanks a lot for all 'old' and 'new' sponsors, listed here in alphabetical order:
Full Changelog: v2.2.1...v2.3.0
v2.3.0-rc1
Shiny new stuff (more than I was aware of, after all this time...)
- Add support for DX Film Edge read by @Merinorus in #684
- Add support for detecting and reading Aztec Runes by @gormster in #763
- Add reader support for
DataBarLimited
symbols (sponsored by EUREKAM) - Add C-API in official build
- Add Kotlin/Native Wrapper by @ISNing in #719
- Add Rust wrapper based on C-API
- Add .NET wrapper based on C-API
- Introduce new name
Barcode
forResult
which will be removed in 3.0 - LocalAverage binarizer: re-implement with symmetric threshold interpolation for improved detection of inverted symbols
- cmake: replace
BUILD_...
prefix of cmake options withZXING_...
- cmake: switch to c++-20 by default for the core library
- ImageView: introduce bounds checks in constructor
- ImageView: Add ImageFormat::LumX for 2-byte grey + alpha input
- ImageFormat: replace 'X' with 'A', e.g. RGBX -> RGBA
- ZXingReader: add -binarizer <local|global|fixed> command line option
- ZXingReader: add -single option to setMaxNumberOfSymbols(1)
- ZXingReader: parse -formats (including 's') command line argument
- ZXingReader: support reading image file from stdin by passing '-'
- android: switch 'namespace' from
zxingcpp
tozxingcpp.lib
to fix issue with maven central publication - Python: add support to write
bytes
as binary data
New experimental API (cmake option -DZXING_EXPERIMENTAL_API=ON
)
- New experimental Create+Write API for generating/writing barcodes (will replace MultiFormatWriter)
- New experimental libzint based writer backend
- New
ImageView Barcode::symbol()
property - New experimental writer API in python
Minor changes and bug fixes
- Complete ZXIReaderOptions in iOS Wrapper by @markusfisch in #692
- ios: remove initWithFormats initializer by @markusfisch in #723
- cmake: Make build reproducible across different build directories by @EchterAgo in #730
- Release color space after use in iOS wrapper by @markusfisch in #790
- cmake: allow overriding python install directories by @jameshilliard in #842
- Refine MultiFormatReader results filtering and apply C++20
erase_if
by @Doekin in #846 - HRI: update AIs to latest gs1-syntax-dictionary.txt by @gitlost in #880
- android: add linker flag to support flexible page sizes in Android 15 by @ccrowell-kr in #872
- Deprecate
validateITFCheckSum
,validateCode39CheckSum,
returnCodabarStartEnd
- BitHacks: fix random QRCode content on pre-Haswell Windows machines
- DataMatrix: improve detection of near 45Β° rotated symbols
- cmake: add /utf-8 to MSVC compile flags
- Barcode: tune operator==() to not split up overly tall linear symbols
- Several ITFReader improvements
- QRDecoder: return some content even in the presence of a checksum error
- DataBar: improve detection rate by incorporating edge-2-edge pattern
- PDF417: prevent wrong position info with right side collapsing to (0,0)
- Python: make sure macOS and 64bit Linux packes on pypi.org support multi-symbol DataMatrix detection (c++20 support)
New Contributors
- @Merinorus made their first contribution in #684
- @ISNing made their first contribution in #718
- @hha1501 made their first contribution in #747
- @gormster made their first contribution in #763
- @549393092 made their first contribution in #777
- @bindreams made their first contribution in #787
- @johngladp made their first contribution in #808
- @jameshilliard made their first contribution in #842
- @Doekin made their first contribution in #846
- @spageektti made their first contribution in #858
- @stbergmann made their first contribution in #864
- @ccrowell-kr made their first contribution in #872
- @GUIEEN made their first contribution in #877
Sponsors
Thanks a lot for all 'old' and 'new' sponsors, listed here in alphabetical order:
Full Changelog: v2.2.1...v2.3.0
Fix c++ ABI breakage of 2.2.0
I accidentally broke c++ ABI compatibility between 2.1.0 and 2.2.0. This is fixed here. This release is only of relevance for package maintainers caring about ABI stability of MINOR version changes according to semantic versioning. None of the wrappers are effected by this change and hence will not be released as 2.2.1.
DISCLAMER: Unfortunately, it turned out that the above mentioned fix for the c++ ABI can break your build if you have some kind of globally enabled pre-compiled-header setup, like apparently in libreoffice (see #685). In that case, either disable pre-compiled-headers or use 2.2.0.
Full Changelog: v2.2.0...v2.2.1
EDIT: added test_samples.tar.gz
containing the test/samples/
subfolder. See this discussion.
v2.2.0
WARNING: I accidentally broke c++ ABI compatibility between 2.1.0 and 2.2.0. This is fixed here. There will likely be a 2.2.1 patch release. If you are packaging this software for distribution, you might want to skip packaging this version or make sure the above patch is applied in your build. For all the wrapper code, this has no impact whatsoever. Please join the discussion if you have comments regarding the situation.
Major Changes
This release is mostly about the Python, Android and iOS wrappers. The latter 2 have changed considerably to have an API that is more in line with each other and with the core c++ library. The changes will most likely break existing app code but set a proper foundation for the future.
-
Python:
- Multithreading Support via GIL by @billmccartney in #616
- Remove numpy requirement, use buffer protocol instead by @EchterAgo in #615
- Support sliced numpy arrays
- Expose return_errors parameter to Python wrapper APIs. by @gregtws in #618
- Expose Result::ecLevel method as python property by @marcoffee in #600
- Build wheels for Python 3.12. by @dainnilsson in #625
-
Android:
- Android wrapper: Modernize build files by @okarmazin in #619
- Fix permissions on Android R+ by @markusfisch in #656
- Android wrapper improvements by @markusfisch in #659
- android: add consumerProguardFiles by @markusfisch in #660
- android: Fix build with NDK 26 by @michaelweghorn in #674
- Build with C++20 (improved DataMatrix detection) by default
- Don't
close()
theImageProxy
insideread()
anymore, need to do that outside now (this breaks existing code) - Change package name from
com.zxingcpp
to simplyzxingcpp
(breaking change) - publish library on mavenCentral for lowest possible barrier of entry
-
iOS/macOS:
- iOS Wrapper improvements by @benjohnde in #630
- iOS wrapper: Add functionality of encoding binary data into Barcodes by @alexmanzer in #635
- Rename ZXingCppWrapper to ZXingCpp by @alexmanzer in #638
- iOS: Enable CocoaPods by providing a podspec by @benjohnde in #637
- Build with C++20 (improved DataMatrix detection) by default
- ios: specify EC level/margin for generation by @markusfisch in #644
- ios: expose all native result items in wrapper by @markusfisch in #649
- ios: clean up ZXIDecodeHints by @markusfisch in #652
- ios: use a default error text instead of crashing by @markusfisch in #661
- ios: improve exception handling by @markusfisch in #664
- ios: rename
ZXIDecodeHints
toZXIReaderOptions
-
General:
- Rename
DecodeHints
toReaderOptions
. The old name is still available for backward API compatibility but deprecated. Since the C-API and the Qt wrapper code are not officially part of the library, they changed without backward compatibility. - WASM: bytes in
ReadResult
by @Sec-ant in #588 - DataMatrix: use charset for encoding by @markusfisch in #628
- QRCode: Support QR Code Model1 by @sayzzy-nt in #633
- rMQR Code: Support Rectangular Micro QR Code by @gitlost in #681
- Rename
Minor Changes and Fixes
- Fix QT 6 QML Crash & Enable QML Shape by @LeonnardoVerol in #597
- Python: Fix wrapper build on MSVC not having __cplusplus for BitHacks by @EchterAgo in #613
- Correctly handle supported image formats on Android APIs < 23 by @okarmazin in #622
- Add
DecodeHints.setMaxNumberOfSymbols()
to C API by @siiky in #665 - aztec: on decoding check for padding bits after B/S by @gitlost in #671
New Contributors
- @Sec-ant made their first contribution in #588
- @LeonnardoVerol made their first contribution in #597
- @EchterAgo made their first contribution in #613
- @billmccartney made their first contribution in #616
- @gregtws made their first contribution in #618
- @okarmazin made their first contribution in #619
- @alexmanzer made their first contribution in #624
- @dainnilsson made their first contribution in #625
- @benjohnde made their first contribution in #630
- @sayzzy-nt made their first contribution in #633
- @michaelweghorn made their first contribution in #674
Full Changelog: v2.1.0...v2.2.0
v2.1.0
Major Changes
- Considerable performance improvements in linear symbol detection (up to 2x speedup in select use cases of
ReadBarcodes
) - QRCode: major improvement in detection of high version symbols (see e.g. here)
- DMDetector: reduce runtime overhead of c++-20 builds by around 50%
- Refactor Python wrapper so the sdist includes the core library code by @stumpylog in #530
- wasm wrapper: add function to reader to scan multiple barcode by @Trim in #567
- Added a C wrapper by @siiky in #553. If you find this useful, please have a look at #583.
- new
BUILD_EXPERIMENTAL_API
cmake option (currently enablingDecodeHints::tryDenoise
feature, see 9bcfdb3)
[EDIT: just noticed that this does not work, see 8202a4e]
Minor Changes
- fix crash when the source image is less than 3 pixels width/height by @liulex in #476
- Android: Enable the saving of images to the phone gallery. by @Sergio- in #483
- WASM wrapper: add symbologyIdentifier into result by @AlexXiong-dev in #576
- CI: build universal2 python module for macos
- Python: compile module with c++20 (position independend DataMatrix support) by default
- Python: improve error reporting
- DMDetector: fix potential dead-lock
- DMDecoder: support 144x144 symbols in legacy and compliant variants
- UPC/EAN: reduce right quiet zone requirement -> fix non-conformant input
- EAN/UPCA: include AddOn in position calculation
- MSVC build option cleanup
- WASM: simplify and cleanup
demo_*.html
files - Updated live web demos to latest code (and setup semi-automatic gh-page creation for the future)
- a bunch of minor bug fixes
Sponsors
Thanks a lot to @Sergio- and @sdcubber for their sponsorship in the past and also to the current sponsors
New Contributors
- @liulex made their first contribution in #476
- @Sergio- made their first contribution in #483
- @FalsinSoft made their first contribution in #484
- @kientux made their first contribution in #507
- @cbm755 made their first contribution in #513
- @stumpylog made their first contribution in #533
- @nmariusp made their first contribution in #554
- @fedormsv made their first contribution in #573
- @AlexXiong-dev made their first contribution in #576
- @siiky made their first contribution in #553
Full Changelog: v2.0.0...v2.1.0
v2.0.0
The most visible change from the client perspective is the removal of all formerly deprecated API, (almost) completing the 'cleanup'. Since I was way too slow with this release to implement a 'cleanish' SemVer release as discussed in #333, I decided to release this 2.0 with SONAME 3. A 3.0 release might bring the major version number back in sync with the SONAME.
Major Changes
- switch to UTF8 based API and remove deprecated UTF16 one (
Result::text()
) - remove all API deprecated in 1.4
- Adding a wrapper for iOS by @parallaxe in #337
- new Aztec detector implementation to support arbitrary rotation and position of the symbol
- support multi-symbol detection in Aztec detector
- replace all Qt originated ECI/CharacterSet conversion code with a new implementation provided by @gitlost (libzueci)
- require c++17 to build library and client code
- new
DecodeHints::textMode()
andResult::text(TextMode)
API to specify howbytes
are rendered intotext
. - HRI (human readable interpretation) is the new default for the
TextMode
(has been for most cases before, but not all) - new
DecodeHits::tryInvert()
feature to test for inverted symbols (white on black background)
Minor Changes
- deprecate
TextUtfEncoding
helpers, not required anymore with UTF8 APIs for both reader and writer - support for multi-symbol and arbitrary position detection of DataMatrix symbols when library is built with c++20
- Include version number of QR Code and DataMatrix in Result by @markusfisch in #396
- reduce size of
Result
struct by about a third - cleanup all license related files (see removal of the Qt code above)
- update links and comments to refer to new github.com/zxing-cpp/zxing-cpp home
- improved Code128 decoder for over/underexposed images
- support python 3.11
- a whole bunch of fixes and minor improvements all over the place
New Contributors
- @khoren93 made their first contribution in #356
- @parallaxe made their first contribution in #337
- @Alex-MSFT made their first contribution in #415
- @Trim made their first contribution in #435
- @zander made their first contribution in #446
- @th1722 made their first contribution in #458
Thanks also to all the 'old' ones! :)
Full Changelog: v1.4.0...v2.0.0
Pre-2.0 API cleanup time
Note: this is an intermediary release on the way to 2.0. This code is (supposed to be) API compatible (via the ReadBarcode.h
interface) with v1.3.0 but contains quite a few additional deprecations. It still has SO number 1, which is as wrong as it was for release v1.3.0 and it is not ABI compatible with 1.3 either. 2.0 will be basically 1.4 but with all deprecated API removed and the final fix for #333.
Main changes
- Reader support for Micro QRCode by @corbers
- prepared switch from
std::wstring
based utf16 tostd::string
based utf8 results, use newZX_USE_UTF8
macro to transition to the upcoming 2.0 API - much improved 'binary' data support via new
Result::bytes()
API, see #334 for a detailed background discussion. - new
Result::contentType()
API returning information about the type of content (like text vs. binary, etc.) - better standards conformance with respect to ECI handling, see
Results::bytesECI()
- support for proper ECI handling across structured append symbols (see
MergeStructuredAppendResults()
) - new
Result::error()
API with improved error handling, see alsoDecodeHints::returnErrors()
- removed all internal header files from the installed set, so only the
ReadBarcode.h
based APIs are supported from here on out - removed all sample images from the 'source' distribution zip/tar balls (much reduced size)
- python
read_barcode
returnsNone
if no symbol was found (might break existing code if not checked forNone
before)
Minor changes
- lots of little bug fixes
- smaller per process runtime memory (thanks to @vkrause)
- clang-13 and gcc-13 compilation fixes
- ported Qt example code to Qt6
- experimental multi-symbol detection support for DataMatrix when compiled with c++-20
- fix error in multi-symbol detection of linear codes (sometimes reported 1 symbol as 2)
- new
-bytes
and-errors
options inZXingReader
- support
tryRotate
for PDF417 symbols
Full Changelog: v1.3.0...v1.4.0
Multi-Barcode + Multi-Resolution
DISCLAIMER: a note for downstream package maintainers: as discussed in #333 this release should have been named 2.0 not 1.3. Please don't package this release until the issue is resolved.
The major new features:
- Multi-barcode reading with the new
std::vector<Result> ReadBardcodes(...)
function. Does not work for Aztec, DataMatrix and Maxicode, yet. - Multi-resolution scanning that can automatically downscale the input to substantially increase the detection rate on high resolution scans, see
DecodeHints::tryDownscale
, currently only enabled in theReadBardcodes
function - New
Result::symbologyIdentifier
property (thanks to @gitlost) - Updated and improved android wrapper (thanks to @markusfisch)
Worth mentioning:
- Most deprecated APIs from last release were removed (will likely break your build if you still have deprecation warnings with 1.2.0)
- New
Result::lineCount
andDecodeHints::minLineCount
properties to improve reliability of 1D code reading - New
Result::isMirrored
property (works for QRCode, PDF417, DataMatrix) - Improved FNC1 handling and deprecation of
DecodeHints::assumeGS1
- Lots of small fixes all over the place
- Drop in-tree copy of stb image library
- New OpenCV example code
- QRCode reading improvements
- Python 3.10 support
This includes around 200 commits including those of 11 new contributors.
Full Changelog: v1.2.0...v1.3.0
There is so much stuff...
There have been nearly 800 commits that touched about 10k lines of code since the last release.
Here are the highlights/major changes:
- switch to C++-17 (client code can still be compiled with a C++-11 compiler)
- switch to the reimplemented 1D detectors (about 5x faster than old ones in false-positive use case)
- deprecate the use of
ResultMetadata
, see ZXingReader.cpp as an example - completely new Android wrapper library with CameraX support, integrated build system and demo app
- a lot faster and more capable
isPure
detection for all 2D codes - completely new QRCode reader (faster, better support for rotated symbols)
- new
BarcodeFormat
names (old ones still available but deprecated) - new ZXingQtCamReader demo app based on QtMultimedia and QtQuick
- reduced false positive rate for UPC/EAN barcodes + improved Add-On symbol handling
- 20% faster ReedSolomon error correcting
- PDF417 is faster and supports flipped symbols
- DataMatrix: added DMRE support
- much improved python wrapper incl. PyPI module for easy
pip
installation (thanks to antoinehumbert) - proper ECI handling in all 2D barcodes (thanks to gitlost)
- added Structured Append support for
DataMatrix
,Aztec
andMaxiCode
(thanks to gitlost)
Note: The next release will drop support for a number of deprecated APIs. Please update your code and fix all deprecation warnings now.
Final Final C++14 based release collecting a number of fixes
Since the switch to C++17 got delayed and a bunch of fixes and small improvements have piled up since the "Final C++14 based" release, here is the final-final pre C++17 release. This includes WinRT build improvements, Android and python wrapper fixes and pkgconfig fixes.