byuimage 0.5.0

Simple Image processing library, used for teaching people how to program

BYU Simple Image Library

This is a simple library for interacting with images. It is used for instruction in an introductory programming class, CS 110 Introduction to Programming, and CS 111 Introduction to Computer Science at Brigham Young University.

The interface for this library is based off a similar library developed at Stanford University, but was developed independently.

Importing the Library

from byuimage import Image

Creating an image

image = Image(filename)

• creates a new image from a filename

image = Image.blank(width, height)

• creates a new, blank, white image with the given width and height

Image properties

image.height

• returns image height in pixels

image.width

• returns image width in pixels

Iterating over pixels in an image

for pixel in image:

• loops over all pixels, from left to right and top to bottom

for y in range(image.height):
    for x in range(image.width):

• loops over all pixels, from left to right and top to bottom

Getting and setting pixels

pixel = image.get_pixel(x,y)

• gets the pixel at the given (x,y) coordinate

pixel.red = value
pixel.green = value
pixel.blue = value

• Sets the pixel red, green, or blue value to the given value

pixel.color = (10, 10, 10)

pixel.color = otherpixel.color

• Sets the pixel red, green, and blue values to the given tuple or pixel color

Showing and saving images

image.show()

• shows an image

image.save(filename)

• saves an image

Credits

The sample image used here is a photo from Mike Newbry, using the Unsplash License, and is available for free at https://unsplash.com/photos/BTE-k0V19Gw