1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
|
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.
* <https://github.com/mchehab/zbar>
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
* <http://www.gnu.org/software/libiconv>
* The ImageMagick software imaging library
Copyright since 1999 ImageMagick Studio LLC
Licensed under a derived Apache 2.0 license:
* https://imagemagick.org/script/license.php
The source code is available from
* <http://imagemagick.org>
* The libxml2 XML C parser and toolkit
Copyright (C) since 1998 Daniel Veillard.
Licensed under the MIT license.
The source code is available from:
* <http://xmlsoft.org>
* 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:
* https://www.ijg.org/files/README
* https://github.com/libjpeg-turbo/libjpeg-turbo/blob/master/LICENSE.md
The source code is available from:
* <http://www.ijg.org>
* 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
* <http://www.libtiff.org>
* 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
* <http://www.libpng.org/pub/png/libpng.html>
* 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
* <http://zlib.net>
* The bzip2 compression library
Copyright (C) since 1996 Julian Seward.
Licensed under a BSD-style license.
The source code is available from
* <http://bzip.org>
* 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:
* https://chocolatey.org/
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
* <https://github.com/mchehab/zbar>
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:
* <http://www.catb.org/~esr/faqs/smart-questions.html>
|
