mirror of
https://github.com/zint/zint
synced 2024-11-16 20:57:25 +13:00
e30e1f9651
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding certain trailing bytes libzint: fix some confusing error messages introduced by segment stuff general: new escape chars \U, \d and \o backend_qt: fudge rendering of border rectangles due to scaling/translation rounding errors TODO: better fudge GUI: foreground/background colours -> text boxes and icon buttons, add swap button, independently movable picker (NULL parent), preview colour changes, preview Data Window changes, add clear data (del) buttons, add zap button and Factory Reset menu option, various other fixes libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers CMake: add find package QtSvg, remove QtXml manual: split symbology and general specs and sort, move DAFT to 4-state, UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info, various other fiddlings man page: options or -> |, expand MSI Plessey check digit options README.linux: add packages info license: add SPDX-License-Identifier to touched files
125 lines
3.3 KiB
Plaintext
125 lines
3.3 KiB
Plaintext
1. Prerequisites for building zint
|
|
==================================
|
|
|
|
Prerequisites are git, cmake, make, gcc and gcc-c++, e.g. Ubuntu/Debian
|
|
|
|
sudo apt install git cmake build-essential
|
|
|
|
or Fedora (git, make and gcc should already be installed)
|
|
|
|
sudo dnf install cmake gcc-c++
|
|
|
|
libpng is optional but necessary for PNG support, e.g. Ubuntu/Debian
|
|
|
|
sudo apt install libpng-dev
|
|
|
|
or Fedora
|
|
|
|
sudo dnf install libpng-devel
|
|
|
|
Then either download the source code tarball
|
|
|
|
wget -O zint-2.11.0-src.tar.gz \
|
|
https://sourceforge2.11.0net/projects/zint/files/zint/2.11.0/zint-2.11.0-src.tar.gz/download
|
|
tar xf zint-2.11.0-src.tar.gz
|
|
cd zint-2.11.0-src
|
|
|
|
or clone the latest source
|
|
|
|
git clone https://git.code.sf.net/p/zint/code zint
|
|
cd zint
|
|
|
|
|
|
2. Prerequisites for building zint-qt
|
|
=====================================
|
|
|
|
zint-qt can be built with either Qt5 (preferred) or Qt6. First, install mesa (for OpenGL), e.g.
|
|
Ubuntu/Debian
|
|
|
|
sudo apt install mesa-common-dev libglu1-mesa-dev
|
|
|
|
or Fedora
|
|
|
|
sudo dnf install mesa-libGL mesa-libGL-devel
|
|
|
|
2.1. Using Qt packages
|
|
----------------------
|
|
|
|
If packages for Qt exist for your distro, it might be easiest to use them, although knowing
|
|
what their ever-changing names and contents are isn't. A complication is that zint-qt uses 2 Qt
|
|
components beyond the basic setup: Qt UI Tools (for dynamically loading the symbology-specific
|
|
tabs), and Qt SVG (for rendering icons).
|
|
|
|
E.g. on Ubuntu 22.04
|
|
|
|
sudo apt install qtbase5-dev qttools5-dev qttools5-dev-tools libqt5svg5-dev
|
|
|
|
or Ubuntu 20.04
|
|
|
|
sudo apt install qt5-default qt5-uitools
|
|
|
|
or Fedora 36 (Qt6 NOT recommended, currently uses 6.3.0 which is flaky)
|
|
|
|
sudo dnf install qt5-qtbase-devel qt5-qttools-devel qt5-qttools-static qt5-qtsvg-devel
|
|
|
|
You may need to tell CMake where to find the ".cmake" modules:
|
|
|
|
export CMAKE_MODULE_PATH=<cmake-module-path>/Qt5
|
|
|
|
e.g. CMAKE_MODULE_PATH=/usr/lib/x86_64-linux-gnu/cmake/Qt5
|
|
|
|
2.2. Using the Qt Maintenance Tool
|
|
----------------------------------
|
|
|
|
Alternatively, for a more consistent, dependable, flexible experience, sign up and download the
|
|
Qt Maintenance Tool from
|
|
|
|
https://www.qt.io/download-qt-installer
|
|
|
|
On Ubuntu/Debian you may need to install xinerama to run the tool:
|
|
|
|
sudo apt install libxcb-xinerama0
|
|
|
|
Launch the tool and install the "Desktop gcc 64-bit" component for either Qt 5.15.2 or Qt 6
|
|
(>= 6.1, and not 6.3.0).
|
|
|
|
Once Qt is installed you may need to tell CMake where it is:
|
|
|
|
export CMAKE_PREFIX_PATH=<qt-version-dir>/gcc_64
|
|
|
|
e.g. export CMAKE_PREFIX_PATH=/opt/Qt/5.15.2/gcc_64
|
|
|
|
|
|
3. Build
|
|
========
|
|
|
|
The rest is standard CMake
|
|
|
|
cd zint
|
|
mkdir build
|
|
cd build
|
|
cmake ..
|
|
make
|
|
sudo make install
|
|
|
|
|
|
4. CMake options
|
|
================
|
|
|
|
A number of options are available:
|
|
|
|
ZINT_COVERAGE:BOOL=OFF # Set code coverage flags
|
|
ZINT_DEBUG:BOOL=OFF # Set debug compile flags
|
|
ZINT_NOOPT:BOOL=OFF # Set no optimize compile flags
|
|
ZINT_SANITIZE:BOOL=OFF # Set sanitize compile/link flags
|
|
ZINT_STATIC:BOOL=OFF # Build static library
|
|
ZINT_TEST:BOOL=OFF # Set test compile flag
|
|
ZINT_USE_PNG:BOOL=ON # Build with PNG support
|
|
ZINT_USE_QT:BOOL=ON # Build with Qt support
|
|
|
|
which can be set by doing e.g.
|
|
|
|
cmake -DZINT_SANITIZE=ON ..
|
|
|
|
For details on ZINT_TEST and building the zint test suite, see "backend/tests/README".
|