Download: latest (1.8.0)

pymagery — python imagery


1.8.0 documentation / canvasresize plugin

The canvasresize plugin adjusts the size of the canvas. The original image can be translated vertically or horizontally. When translating the original image you can move it anywhere, even if the all image data is lost.

This plugin is similar to the crop plugin with no bounding box checks.

This plugin is not like the resize plugin. This plugin does not change pixel values nor does it interpolate.

The plugin prototype is:

def canvasresize(width, height, fillval, left=0, top=0)

The following example adds a 10-pixel white border. It adds 20 pixels to the width and 20 pixels to the height then translates the original image down 10 pixels and right 10 pixels. This creates a 10 pixel border all the way around. This is, in fact, how the border plugin works.

import pymagery i = pymagery.image('foo.ppm') i.canvasresize(i.width+20, i.height+20, (255<<16)+(255<<8)+255, 10, 10)

The following example of a 100x100 pixel image yields a complete loss of image data because it is translated off the canvas by 900 pixels. It results in an all-white image because of the fill value.

import pymagery i = pymagery.image('foo.ppm') i.canvasresize(100, 100, (255<<16)+(255<<8)+255, 1000, 1000)

Change Log