Python Pillow (PIL) examples

About this site

This site provides the simple examples of Pillow, mainly for the users, not for plugin-users. Note that this site is unofficial, and the contents are written by only one person (it’s me). So, there might be incompleteness. And I’m not a native English speaker, so my English might be strange, sorry.

Note

From wikipedia:

Python Imaging Library (abbreviated as PIL) (in newer versions known as Pillow) is a free library for the Python programming language that adds support for opening, manipulating, and saving many different image file formats. It is available for Windows, Mac OS X and Linux. The latest version of PIL is 1.1.7, was released in September 2009 and supports Python 1.5.2-2.7, with Python 3 support to be released “later”.

Development appears to be discontinued with the last commit to the PIL repository coming in 2011. Consequently, a successor project called Pillow has forked the PIL repository and added Python 3.x support. This fork has been adopted as a replacement for the original PIL in Linux distributions including Debian and Ubuntu (since 13.04).

The examples in this documents are basically for Pillow, not original PIL. So, if you need to run the codes for original PIL, see Porting.

Table of Contents

• Image Module
  • Image Module - Functions
    • Open images, Constructing images
      • open
      • new
      • fromarray
      • frombytes
      • fromstring
      • frombuffer
    • Image processing
      • alpha_composite
      • blend
      • composite
      • eval
      • merge
  • Image Module - class Image
    • Methods
      • convert
      • copy
      • crop
      • draft
      • filter
      • getbands
      • getbbox
      • getcolors, getpalette
      • getdata
      • getextrema
      • getpixel
      • histogram
      • offset
      • paste
      • point
      • putalpha
      • putdata
      • putpalette, remap_palette
      • putpixel
      • quantize
      • resize
      • rotate
      • save
      • seek, tell
      • show
      • split
      • thumbnail
      • tobitmap
      • tobytes
      • tostring
      • transform
      • transpose
      • verify
    • Attributes
• ImageChops (“Channel Operations”) Module
  • Functions
    • add
    • add_modulo
    • blend
    • composite
    • constant
    • darker
    • difference
    • duplicate
    • invert
    • lighter
    • logical_and
    • logical_or
    • multiply
    • offset
    • screen
    • subtract
    • subtract_modulo
• ImageColor Module
  • getrgb, getcolor, colormap
• ImageDraw Module
  • class Draw
    • arc, chord, ellipse, pieslice, rectangle
    • bitmap
    • line, polygon
    • point
    • text, textsize
    • multiline_text, multiline_textsize
• ImageEnhance Module
  • Interface and class _Enhance
  • Predefined Enhancer classes
    • class Color
    • class Contrast
    • class Brightness
    • class Sharpness
• ImageFilter Module
  • Filters
    • class GaussianBlur
    • class UnsharpMask
    • class Kernel
    • class RankFilter, MedianFilter, MinFilter, MaxFilter
    • class ModeFilter
• ImageFont Module
  • Using TrueType (or OpenType) Fonts
    • truetype factory function
    • class FreeTypeFont
    • Enumerating truetype fonts on Windows
    • Enumerating truetype fonts in some directory
  • Using Bitmap Fonts
    • load_default
    • pilfont utility script
    • load, load_path
    • class ImageFont
• ImageGrab Module (macOS and Windows only)
  • Functions
    • grab
    • grabclipboard
• ImageMorph Module
  • with known patterns
  • with custom structuring element
• ImageOps Module
  • Functions
    • autocontrast
    • colorize
    • crop
    • deform
    • equalize
    • expand
    • fit
    • flip
    • grayscale
    • invert
    • mirror
    • posterize
    • solarize
• ImagePath Module
  • class Path
    • compact
    • getbbox
    • map
    • tolist
    • transform
• ImageSequence Module
• ImageStat Module
• ImageTk Module
• ExifTags Module
  • Keeping exif data when saving
  • Exploring Exif Items As Human Readable
  • Building the exif tags by hand, and saving it
  • Accessing to GeoTIFF tags by Pillow
• PSDraw Module, EpsImagePlugin Module
  • EpsImagePlugin basics
  • PSDraw basics
  • writing PS with PSDraw, and converting it to EPS
  • More complex example (pscal wrapper)
• Apendices
  • Notices about “Concept”
    • about “Concept” Filters
  • Notices about Installation
    • Windows

Other documents I’m writing

• ffmpeg examples