''' Module manip: provides a basic pattern for image manipulation
        and convenience functions for some basic transformations
'''

from PIL import Image

def manip( original, size, color, where ) :
    ''' Provide a pattern for image manipulation.

            function size():  determines size of new image based on the original

            function color(): determines color of new image pixel based on an original
                              pixel

            function where(): determines where on original to determine correspondent
                              pixel for the new image
    '''

    # set dimensions of the new image
    nw, nh = size( original )
 
    # get a new appropriately sized image
    new_image = Image.new( 'RGB', ( nw, nh ) )

    # fill in every pixel of the new image
    for nx in range( 0, nw ) :      # consider every x value for the new image
        for ny in range( 0, nh ) :  # in tandem with every y value for the image

            # set the spot to be filled in the new image
            nspot = ( nx, ny )

            # determine the corresponding spot of interest in the original
            ospot = where( nspot, original )

            # get the pixel at the ospot
            opixel = original.getpixel( ospot )

            # determine the pixel for the new image
            npixel = color( opixel )

            # set the nspot in the new image
            new_image.putpixel( nspot, npixel )

    # return the filled in new image
    return new_image