.. image:: https://github.com/d0m3nik/pycimg/workflows/Build/badge.svg :target: https://github.com/d0m3nik/pycimg/actions :alt: Build Status .. image:: https://codecov.io/gh/d0m3nik/pycimg/branch/feature_pybind/graph/badge.svg?token=FGVRN9LTIK :target: https://codecov.io/gh/d0m3nik/pycimg :alt: Coverage Status .. image:: https://readthedocs.org/projects/pycimg/badge/?version=latest :target: http://pycimg.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status .. image:: https://badge.fury.io/py/pycimg.svg :target: https://badge.fury.io/py/pycimg :alt: PyPI version
pycimg is a python extension for the CImg_ library.
The package contains a single class CImg that provides access to the image processing methods of the CImg_ library.
Pixel data of CImg objects can be accessed as a numpy_ array.
Vice versa new CImg objects can be created from pixel data in a numpy array or an image file. Supported file formats are png, jpeg, tiff, bmp, and cimg.
.. code-block:: python
from pycimg import CImg
import numpy as np
# Load image from file
img = CImg('test/test.png')
img.display()
# Access pixel data as numpy array
arr = img.asarray()
# Set pixels in upper left 100 x 100 px rectangle
arr[:,:,0:99,0:99] = 0
# Pixel data is shared with the image instance
img.display()
# Create image from numpy array
img = CImg(np.random.randn(100,100))
Install pycimg by running:
.. code-block:: bash
pip install pycimg
See readthedocs_.
The project is licensed under the GPL3 license.
.. _CImg: http://www.cimg.eu .. _numpy: http://www.numpy.org/ .. _jpeg: https://github.com/libjpeg-turbo/libjpeg-turbo .. _png: https://github.com/glennrp/libpng/ .. _tiff: https://gitlab.com/libtiff/libtiff .. _readthedocs: http://pycimg.readthedocs.io/en/latest/