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


Release history Release notifications

History Node

0.1.3

This version
History Node

0.1.2

History Node

0.1.1

History Node

0.1.0

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
image_novice-0.1.2.tar.gz (16.2 kB) Copy SHA256 hash SHA256 Source None Jan 4, 2014

Supported by

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