https://github.com/openslide/openslide
C library for reading virtual slide images
https://github.com/openslide/openslide
c pathology whole-slide-imaging
Last synced: 7 months ago
JSON representation
C library for reading virtual slide images
- Host: GitHub
- URL: https://github.com/openslide/openslide
- Owner: openslide
- License: lgpl-2.1
- Created: 2010-08-09T23:49:32.000Z (over 15 years ago)
- Default Branch: main
- Last Pushed: 2025-04-24T22:09:48.000Z (8 months ago)
- Last Synced: 2025-04-24T23:25:39.542Z (8 months ago)
- Topics: c, pathology, whole-slide-imaging
- Language: C
- Homepage: https://openslide.org/
- Size: 4.22 MB
- Stars: 430
- Watchers: 34
- Forks: 227
- Open Issues: 119
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: COPYING.LESSER
Awesome Lists containing this project
README
# OpenSlide
OpenSlide is a C library for reading whole slide image files (also known as
virtual slides). It provides a consistent and simple API for reading files
from multiple vendors.
## Features
OpenSlide can read brightfield whole slide images in [several formats][]:
* [Aperio][] (`.svs`, `.tif`)
* [DICOM][] (`.dcm`)
* [Hamamatsu][] (`.ndpi`, `.vms`, `.vmu`)
* [Leica][] (`.scn`)
* [MIRAX][] (`.mrxs`)
* [Philips][] (`.tiff`)
* [Sakura][] (`.svslide`)
* [Trestle][] (`.tif`)
* [Ventana][] (`.bif`, `.tif`)
* [Zeiss][] (`.czi`)
* [Generic tiled TIFF][] (`.tif`)
OpenSlide can also provide access to ICC profiles, textual metadata, and
associated images such as a slide label and thumbnail.
[several formats]: https://openslide.org/formats/
[Aperio]: https://openslide.org/formats/aperio/
[DICOM]: https://openslide.org/formats/dicom/
[Hamamatsu]: https://openslide.org/formats/hamamatsu/
[Leica]: https://openslide.org/formats/leica/
[MIRAX]: https://openslide.org/formats/mirax/
[Philips]: https://openslide.org/formats/philips/
[Sakura]: https://openslide.org/formats/sakura/
[Trestle]: https://openslide.org/formats/trestle/
[Ventana]: https://openslide.org/formats/ventana/
[Zeiss]: https://openslide.org/formats/zeiss/
[Generic tiled TIFF]: https://openslide.org/formats/generic-tiff/
## Documentation
The [API reference][API] is available on the web, and is also included as
`doc/html/openslide_8h.html` in the source tarball. [Additional
documentation][docs] is available on the [OpenSlide website][website].
[API]: https://openslide.org/api/openslide_8h.html
[docs]: https://openslide.org/#documentation
[website]: https://openslide.org/
## License
OpenSlide is released under the terms of the [GNU Lesser General Public
License, version 2.1](https://openslide.org/license/).
OpenSlide 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 Lesser General Public License for
more details.
## Compiling
To build OpenSlide, you will need:
- Meson
- cairo ≥ 1.2
- GDK-PixBuf
- glib ≥ 2.56
- libdicom ≥ 1.2 (automatically built if missing)
- libjpeg
- libpng
- libtiff ≥ 4.0
- libxml2
- OpenJPEG ≥ 2.1
- SQLite ≥ 3.14
- zlib
- Zstandard
Then:
```
meson setup builddir
meson compile -C builddir
meson install -C builddir
```
## Acknowledgements
OpenSlide has been developed by Carnegie Mellon University and other
contributors.
OpenSlide has been supported by the National Institutes of Health and
the Clinical and Translational Science Institute at the University of
Pittsburgh.
Development of DICOM and ICC functionality was supported by NCI Imaging
Data Commons and has been funded in whole or in part with Federal funds
from the National Cancer Institute, National Institutes of Health, under
Task Order No. HHSN26110071 under Contract No. HHSN261201500003l.