libCZI
Reading CZI documents made easy
Building libCZI

libCZI aims to be portable and should build readily using a C++11 compiler. Here are some instructions for building on Windows and on Linux.

Building on Windows

For Windows a solution-file (for VisualStudio 2015) LibCZI-Solution is provided.

VisualStudioProj_1.PNG
libCZI solution
We find these solution configurations and solution platforms defined:

VisualStudioProj_2.PNG
libCZI solution configurations/platforms

The configuration "static Debug" and "static Release" are configured to build a static libCZI-library (and link this static library e. g. in the project CZIcmd). The configurations "Debug" and "Release" will create a dynamic link library libCZI.DLL (and CZIcmd will consume this DLL). The "UnitTest" project can only be used with the "static" configurations, so it needs to be excluded from a batch-build:

VisualStudioProj_3.PNG
libCZI batch build

The projects are configured to put their results into these respective folders:

VisualStudioProj_4.PNG
libCZI build-targets folder layout
After performing a build operation, you should find all build results there - like shown here:

VisualStudioProj_5.PNG
libCZI build results

Building on Linux

For building on Linux, we are providing CMake-files. The CMake-files are very basic and minimal at this point, but should give you a working build.

In order to generate makefiles from the CMake-files, execute this command

cmake -G "Unix Makefiles"
LinuxBuild_1.PNG
libCZI generate makefles with CMake
Now executing a make command should produce a working binary:

LinuxBuild_2.PNG
libCZI make

Building the documentation

Executing doxygen will produce the documentation in this folder:

doxygen_1.PNG
libCZI doxygen
In order to build the documentation in PDF-format, go into the folder ../Build/Doxygen/latex and execute make.
We had one issue with this: in order for the PDF-generation to succeed properly, we needed to make this change: in the file ../Build/Doxygen/latex/refman.tex (which is generated by the doxygen-run) find a line

\usepackage[utf8]{inputenc}

and change it into

\usepackage[utf8x]{inputenc}
doxygen_2.PNG
fixing issue with PDF