Update status and add complete compile instructions

This commit is contained in:
hooper114 2009-07-17 22:12:39 +00:00
parent bd840d1ab9
commit d4f8b96a1d

142
readme
View File

@ -1,9 +1,8 @@
Zint and libzint 2.2 Zint and libzint 2.2
-------------------- --------------------
Zint is a suite of programs to allow easy encoding of data in any of the wide range of public domain
Zint is a front end program and library which provides support for over 40 barcode symbologies barcode standards and to allow integration of this capability into your own programs. This version
in an open source package released under the GNU General Public License. Currently supported of Zint is able to encode data in the following formats:
symbologies include:
Code 11, Standard Code 2 of 5, IATA Code 2 of 5, Industrial Code 2 of 5, Interleaved Code 2 of 5, Code 11, Standard Code 2 of 5, IATA Code 2 of 5, Industrial Code 2 of 5, Interleaved Code 2 of 5,
Code 2 of 5 Data Logic, ITF-14, Deutche Post Leitcode, Deutche Post Identcode, UPC-A, UPC-E, EAN-2, Code 2 of 5 Data Logic, ITF-14, Deutche Post Leitcode, Deutche Post Identcode, UPC-A, UPC-E, EAN-2,
@ -16,73 +15,91 @@ Korea Post Barcode, HIBC Code 128, HIBC Code 39, HIBC Data Matrix, HIBC PDF417,
HIBC QR Code, HIBC Codablock-F, Japanese Postal Code, Code 49, Channel Code, Code One, FIM and HIBC QR Code, HIBC Codablock-F, Japanese Postal Code, Code 49, Channel Code, Code One, FIM and
Flattermarken. Flattermarken.
Full documentation is now available from the project website at http://www.zint.org.uk Full documentation is available at project website: http://www.zint.org.uk
SUPPORT ZINT
------------
The Zint project is committed to providing the open source community with encoding software for
all public domain barcode standards. For this we need access to the standard documentation and,
unfortunately, this is not free. Your donation will contribute towards the purchase of standard documents
from ANSI. Standards which we hope to add to Zint in this way include Aztec Mesas, Supercode,
Code One and many others.
To donate to this project go to: http://sourceforge.net/project/project_donations.php?group_id=199350
QT FRONT END PROJECT STATUS
------------ --------------
This package includes a Qt4 GUI front end. This feature is still under development but if you would With the release of version 2.2 of this project the status will change to a "maintainance mode".
like to give it a try then here is how to get to it: You will need Qt4 and cmake to compile the code. This means that for the near future I do not expect to be adding new features and development work
cd to the folder that contains this README file then... will consist of fixing bugs when they appear. In the long term the only advances planned are the
addition of six more public domain barcode standards: Dot Code A, PosiCode, SuperCode, DataStrip,
Aztec Mesas and Grid Matrix. If you would like to see this process accelerated then please consider
donating to this project at http://sourceforge.net/project/project_donations.php?group_id=199350
If you would like to see this project expanded in other ways then your suggestions are very
welcome. Contact details are given below. If you want to expand it yourself there are some
ideas below and I am very happy to answer questions regarding the code or the barcode standards
which are supported.
COMPILING THE CODE
------------------
This package includes files for compiling in a number of ways depending on what functionality you
want and what platform you are targeting. Zint has been tested on both 32 and 64-bit systems.
It does not use any unusual memory manipulation and so should easily port to a wide range of hardware.
GNU/Linux and OpenBSD:
To compile the Zint library for you will need libpng and libz pre-installed. You can compile
with or without QR Code support. If you want QR Code support you will need qrencode installed. Then:
make
make install
If you do not want QR Code support:
make zint_noqr
make install
For some distributions it may be necessary to run
ldconfig
as root before libzint can be used.
To install the GUI interface you will need Qt4 and cmake. Follow these steps:
mkdir 'build'
cd build cd build
cmake .. cmake ..
make -j2 make -j2
This will make libzint library and a Qt specific version of the library. To install these do the following
as root:
make install make install
You can then execute the Qt front end with The command line program can be accessed by typing
./frontend_qt4/QZint_frontend zint {options} -d {data}
Notice that the data needs to be entered after all other options. Any options given after the
data will be ignored. The GUI can be accessed by typing
CONTACT ME zint-qt
----------
The home of libzint is MS Windows:
On the Windows platform you have the choice of compiling with MinGW or with the native compiler,
Microsoft Visual C++. To compile with MinGW follow the instructions for Linux above substituting
the MinGW makefiles for the default Linux ones. For compiling with MS Visual Studio open the
libzint.vcproj project file in the win32 folder and compile in the usual way.
http://www.sourceforge.net/projects/zint Mac OSX:
To compile on Macintosh you will need Qt4 and cmake. Follow the steps for the GUI interface
and the home for information about Zint is at: as given in the Linux section above.
http://www.zint.org.uk
I am keen to hear your ideas / recieve bug reports at robin@zint.org.uk
Thanks for your interest in libzint.
Happy encoding.
Robin.
THINGS TO DO THINGS TO DO
------------ ------------
If you are interested in improving this package then here are a few ideas.
If you are interested in expanding the functionality of this package then here are a few Backend
things which need to be done! -------
* Create filters for more output file formats.
* Add ECI character support to allow encoding in more languages than are covered
by the Latin-1 character set.
* The code was developed to be easy to understand rather than efficient so may benefit
from some memory optimisation for embedded systems.
Frontend GUI Frontend
-------- ------------
* Allow copying of generated barcodes to the clipboard with "Copy" button * Allow copying of generated barcodes to the clipboard with a "Copy" button.
* Allow dragging and dropping to external apps. * Allow dragging and dropping to external apps.
NOTE: Although I have tried to add these functions I have not been succesful in
making them useful. Therefore, although I would like to see this added,
I have abandoned this.
Packaging Packaging
--------- ---------
@ -103,6 +120,23 @@ Research
* DPD Code * DPD Code
* Italian Postal Code * Italian Postal Code
Coming Soon
----------- CONTACT ME
The next symbology to be added may be Dot Code A or ISS PosiCode ----------
The home of libzint is:
http://www.sourceforge.net/projects/zint
and the home for information about Zint is:
http://www.zint.org.uk
I am keen to hear your ideas / recieve bug reports at robin@zint.org.uk
Thanks for your interest in libzint.
Happy encoding.
Robin.