Simple module with a small number of functions:

imread

Reads an image file

imread_multi

Reads an image file with multiple images. Currently, TIFF and STK (a TIFF sub-based format) support this function.

imsave

Writes an image file

Example (which uses mahotas for Gaussian filtering):

from imread import imread, imsave
from mahotas import gaussian_filter
lena = imread('lena.jpeg')

lena = gaussian_filter(lena.astype(float), 4.)
imsave('lena-filtered.jpeg', lena)

This grew out of frustration at current image loading solutions in Python, in either my packages [mahotas] or packages from others [scikits.image, for example].

The relationship with numpy is very contained and this could be easily repurposed to load images in other frameworks, even other programming languages.

Online documentation

To install on debian/ubuntu:

sudo apt-get install libpng12-dev libtiff4-dev libwebp-dev
sudo apt-get install xcftools

To install on Mac:

sudo port install libpng tiff webp

Please report any bugs either on github or by email to luis@luispedro.org

If you are not sure of whether this is the correct behaviour, you can discuss this on the pythonvision mailing list

If at all possible, include a small image as a test case.

• Correctly accept uppercase extensions
• Python 3 support (patch by Christoph Gohlke [pull request 8 on github])
• Read 1-Bit PNGs
• Read simple BMPs (compression and many bit types not supported)
• More complete debug mode (export DEBUG=2 when building), more checks

Version 0.2.4 (2012-06-26) -------------------------- Add lzw.cpp to source distribution - Support saving 16-bit TIFF - Better Mac OS support (patch from Alexander Bohn)

• Fix imread_multi

• Add formatstr argument to imread
• Open files in binary mode on Windows (patch by Christoph Gohlke)
• Read-only support for LSM files
• Read-only support for XCF files (through xcf2png)
• Fix writing of non-contiguous images (at least PNG was affected)

• Add missing files to distribution

• Compile on MSVC++ (Patches by Christoph Gohlke)
• Support for WebP
• Support for 1-bit TIFFs
• Better error message
• Support for multi-page TIFF reading
• Experimental read-only support for STK files

• Support for PNG
• Support for TIFF
• Support for JPEG