Wand

Wand is a ctypes-based simple MagickWand API binding for Python.

from wand.image import Image
from wand.display import display

with Image(filename='mona-lisa.png') as img:
    print img.size
    for r in 1, 2, 3:
        with img.clone() as i:
            i.resize(int(i.width * r * 0.25), int(i.height * r * 0.25))
            i.rotate(90 * r)
            i.save('mona-lisa-{0}.png'.format(i))
            display(i)

You can install it from PyPI (and it requires MagickWand library):

$ apt-get install libmagickwand-dev
$ easy_install Wand

Why just another binding?

There are already many MagickWand API bindings for Python, however they are lacking something we need:

• Pythonic and modern interfaces
• Good documentation
• Binding through ctypes (not C API) — we are ready to go PyPy!
• Installation using pip or easy_install

Requirements

• Python 2.6 or higher
  • CPython 2.6 or higher
  • PyPy 1.5 or higher
• MagickWand library
  • libmagickwand-dev for APT on Debian/Ubuntu
  • imagemagick for MacPorts/Homebrew on Mac
  • ImageMagick-devel for Yum on CentOS

User’s guide

• Reading images
  • Open an image file
  • Read a input stream
  • Read a blob
  • Clone an image
• Writing images
  • Convert images to JPEG
  • Save to file
  • Save to stream
  • Get binary string
• Resizing and cropping
  • Resize images
  • Crop images
• Resource management
• Wand Changelog
  • Version 0.1.9
  • Version 0.1.8
  • Version 0.1.7
  • Version 0.1.6
  • Version 0.1.5
  • Version 0.1.4
  • Version 0.1.3
  • Version 0.1.2
  • Version 0.1.1
  • Version 0.1.0

References

• wand — Simple MagickWand API binding for Python
  • wand.image — Image objects
  • wand.color — Colors
  • wand.resource — Global resource management
  • wand.exceptions — Errors and warnings
  • wand.api — Low-level interfaces
  • wand.display — Displaying images
  • wand.version — Version data

Open source

Wand is an open source software to be used for StyleShare and written by Hong Minhee. The source code is distributed under MIT license and you can find it at GitHub repository. Check out now:

$ git clone https://github.com/StyleShare/wand

If you find a bug, please notify to our issue tracker. Pull requests are always welcome!

Check out Wand Changelog also.

Indices and tables

• Index
• Module Index
• Search Page