-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathREADME.txt
50 lines (41 loc) · 1.89 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
============
Image novice
============
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