Skip to main content

A special Python image submodule for beginners.

Project description

A special Python image submodule for beginners.

Description

image_novice is a simple wrapper around the Python Image Library (PIL) for beginners. It allows for easy loading, manipulating, and saving of image files.

NOTE: This module uses the Cartesian coordinate system!

Example

>>> import image_novice as novice         # special submodule for beginners

>>> picture = novice.open('sample.png')   # create a picture object from a file
>>> print picture.format                  # pictures know their format...
'png'
>>> print picture.path                    # ...and where they came from...
'/Users/example/sample.png'
>>> print picture.size                    # ...and their size
(665, 500)
>>> print picture.width                   # 'width' and 'height' also exposed
665
>>> picture.size = (200, 250)             # changing size automatically resizes
>>> for pixel in picture:                 # can iterate over pixels
>>> ... if ((pixel.red > 128) and         # pixels have RGB (values are 0-255)...
>>> ...     (pixel.x < picture.width)):   # ...and know where they are
>>> ...     pixel.red /= 2                # pixel is an alias into the picture
>>> ...
>>> print picture.modified                # pictures know if their pixels are dirty
True
>>> print picture.path                    # picture no longer corresponds to file
None
>>> picture[0:20, 0:20] = (0, 0, 0)       # overwrite lower-left rectangle with black
>>> picture.save('sample-bluegreen.jpg')  # guess file type from suffix
>>> print picture.path                    # picture now corresponds to file
'/Users/example/sample-bluegreen.jpg'
>>> print picture.format                  # ...has a different format
jpeg
>>> print picture.modified                # and is now in sync
False

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for image_novice, version 0.1.3
Filename, size File type Python version Upload date Hashes
Filename, size image_novice-0.1.3.tar.gz (16.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page