Open Source Cross-Platform C++ library to read CZI image files
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Open Source Cross-Platform C++ library to read CZI image files

libCZI is a library intended for providing read-only access to the information contained in CZI-documents.

It features:

  • reading subblocks and get the content as a bitmap
  • reading subblocks which are compressed with JPEG-XR
  • works with tiled images and pyramid images
  • composing multi-channel images with tinting and applying a gradation curve
  • access metadata

In a nutshell, it offers (almost...) the same functionality as the 2D-viewer in ZEN - in terms of composing the image (including display-settings) and managing the data found in a CZI-file. The libCZI libary is part of the Open Application Development Concept of Zeiss Microscopy. More information on OAD can be found here:

Testdata Definition

The code is written in C++11 and (so far) has been successfully compiled with:

  • Visual Studio 2015 (Microsoft C++ v. 19.00.23506)
  • GCC 5.2.1 (on Ubuntu Linux 4.2.0)
  • Clang 3.4.1 (on FreeBSD 10.2)

It is intended to be easily portable to other platforms.


libCZI is a reader for the CZI fileformat written in C++ Copyright (C) 2017 Zeiss Microscopy GmbH

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see

To obtain a commercial version please contact Zeiss Microscopy GmbH.