gmic 2.9.1a3

Binary Python3 bindings for the G'MIC C++ image processing library

Python binding for G'MIC - A Full-Featured Open-Source Framework for Image Processing

https://gmic.eu

---

gmic-py

gmic-py is the official Python 3 binding for the G'MIC C++ image processing library purely written with Python's C API. Its Python package name on pypi.org is just gmic. This project lives under the CeCILL license (similar to GNU Public License).

You can use the gmic Python module for projects related to desktop or server-side graphics software, numpy, video-games, image procesing.

gmic-blender is a Blender3d add-on bundling gmic-py and allowing you use a new gmic module from there without installing anything more.

Quickstart

First install the G'MIC Python module in your (virtual) environment.

pip install gmic

G'MIC is a language processing framework, interpreter and image-processing scripting language. Here is how to load gmic, and evaluate some G'MIC commands with an interpreter.

import gmic
gmic.run("sp earth blur 4") # On Linux a window shall open-up with a blurred earth
gmic.run("sp rose fx_bokeh 3,8,0,30,8,4,0.3,0.2,210,210,80,160,0.7,30,20,20,1,2,170,130,20,110,0.15,0 output rose_with_bokeh.png") # Save a rose with bokeh effect to file

Longer tutorials are available in the documentation.

Documentation

Full documentation is being written at https://gmic-py.readthedocs.io/.

Supported platforms

gmic-py works for Linux and Mac OS x 64bits architecture x Python >= 3.6. Windows support is planned for Q4 2020.

In case your environment is a type of Unix, but compiling from source is needed, note that the pip installer will download gmic-py's source and most possibly compile it very well. See the CONTRIBUTING.md file and the documentation for tips on building gmic-py for your own OS.

Examples

Using your camera with G'MIC's optional OpenCV linking

If your machine has libopencv installed and your gmic-py was compiled from source (ie. python setup.py build), it will be dynamically linked.

Example script