Skip to content

Latest commit

 

History

History
225 lines (131 loc) · 6.1 KB

README-windows.md

File metadata and controls

225 lines (131 loc) · 6.1 KB
Raw

ZBAR BAR CODE READER

ZBar Bar Code Reader is an open source software suite for reading bar codes from various sources, such as video streams, image files and raw intensity sensors. It supports EAN-13/UPC-A, UPC-E, EAN-8, Code 128, Code 93, Code 39, Codabar, Interleaved 2 of 5 and QR Code. Included with the library are basic applications for decoding captured bar code images and using a video device (e.g. webcam) as a bar code scanner. For application developers, language bindings are included for C, C++, Python and Perl as well as GUI widgets for Qt, GTK and PyGTK.

Check the ZBar home page for the latest release, mailing lists, etc.

License information can be found in 'COPYING'.

Once built, the Windows binaries will use binaries of several supporting libraries, each one with its own copyright, license and source code locations.

It follows a non-exhaustive list of those components:

  • The GNU libiconv character set conversion library

    Copyright (C) since 1999 Free Software Foundation, Inc.

    Licensed under LGPL. The source code is available from

  • The ImageMagick software imaging library

    Copyright since 1999 ImageMagick Studio LLC

    Licensed under a derived Apache 2.0 license:

    The source code is available from

  • The libxml2 XML C parser and toolkit

    Copyright (C) since 1998 Daniel Veillard.

    Licensed under the MIT license.

    The source code is available from:

  • JPEG library

    The Independent JPEG Group's software's version is:

    Copyright (C) since 1991 Thomas G. Lane, Guido Vollbeding.

    Libjpeg-turbo has additional copyrights:

    Copyright (C) since 2009 D. R. Commander. Copyright (C) since 2015 Google, Inc.

    Licensed under BSD-style licenses with their own terms:

    The source code is available from:

  • libtiff, a library for reading and writing TIFF

    Copyright (c) since 1988 Sam Leffler

    Copyright (c) since 1991 Silicon Graphics, Inc.

    Licensed under a BSD-style license.

    The source code is available from

  • libpng, the official PNG reference library

    Copyright (c) since 1998 Glenn Randers-Pehrson

    Licensed under a BSD-style license.

    The source code is available from

  • The zlib general purpose compression library

    Copyright (C) since 1995 Jean-loup Gailly and Mark Adler.

    Licensed under a BSD-style license.

    The source code is available from

  • The bzip2 compression library

    Copyright (C) since 1996 Julian Seward.

    Licensed under a BSD-style license.

    The source code is available from

  • Depending on how this is packaged, other licenses may apply

BUILDING

NOTE: this is a simplified version of what it was done in order to do the Travis CI builds. You may use this as a guide, but the instructions here may be incomplete. If you find inconsistencies, feel free to submit patches improving the building steps.

Also, please notice that the instructions here is for a minimal version, without any bindings nor ImageMagick.

Building on Ubuntu Bionic

You need to install the following packages:

sudo apt-get install -y \
autoconf automake autotools-dev libdbus-1-dev \
pkg-config binutils-mingw-w64-i686 gcc-mingw-w64 \
mingw-w64-i686-dev mingw-w64-common win-iconv-mingw-w64-dev \
xmlto autopoint

Then, build Zbar with:

export PKG_CONFIG_PATH=/usr/x86_64-w64-mingw32/lib/pkgconfig

autoreconf -vfi

CC=i686-w64-mingw32-gcc ./configure --host=i686-w64-mingw32 \
--prefix=/usr/local/win32 --with-directshow \
--without-gtk --without-python --without-qt --without-java \
--without-imagemagick --enable-pthread

make

Building natively on Windows

It is possible to build it natively on Windows too.

You need first to setup a building environment with minGw. One way would be to use Chocolatey to download what's needed:

With Cocolatey installed, ensure that you have minGw and needed deps with:

choco install -r --no-progress -y msys2 make

Then use pacman to install the needed packages:

pacman -Syu --noconfirm autoconf libtool automake make \
autoconf-archive pkg-config autopoint gettext-devel

Once you have everything needed and set the PATH to the places where the building environment is, you can build ZBar with:

autoreconf -vfi

./configure \
--host=i686-w64-mingw32 --prefix=/usr/local/win32 \
--without-gtk --without-python --without-qt --without-java \
--without-imagemagick --enable-pthread \
 --with-directshow --disable-dependency-tracking

make

RUNNING

This version of the package includes only command line programs. (The graphical interface is scheduled for a future release)

Invoke Start -> Programs -> ZBar Bar Code Reader -> Start ZBar Command Prompt to open a shell that has the zbarimg and zbarcam commands available (in the PATH).

To start the webcam reader using the default camera, type:

zbarcam

To decode an image file, type e.g.:

zbarimg -d examples\barcode.png

For basic command instructions, type:

zbarimg --help
zbarcam --help

Check the manual for more details.

REPORTING BUGS

Bugs can be reported at the GitHub project page

Please include the ZBar version number and a detailed description of the problem. You'll probably have better luck if you're also familiar with the concepts from: