函数

google.appengine.api.images 包提供以下函数：

resize(image_data, width=0, height=0, output_encoding=images.PNG)

缩放图像，缩小或放大到指定宽度和高度。函数采用图像数据进行缩放，并以相同的格式返回转换后的图像。

参数：

image_data

要缩放的图像，是 JPEG、PNG、GIF（包括动画）、BMP、TIFF 或 ICO 格式的字节字符串 (str)。

width

所需的宽度，以像素数量表示。必须为 int 或 long。

height

所需的高度，以像素数量表示。必须为 int 或 long。

output_encoding

转换的图像所需的格式。可以是 images.PNG 或 images.JPEG 格式。默认为 images.PNG。

crop(image_data, left_x, top_y, right_x, bottom_y), output_encoding=images.PNG)

将图像裁剪到指定边界框。函数采用图像数据进行裁剪，并以相同的格式返回转换后的图像。

将边界框的左侧、顶部、右侧和底部指定为一定比例的距离。将边界框的坐标确定为 left_x * width、top_y * height、right_x * width 和 bottom_y * height。这可让您指定与图像的最终宽度和高度无关的边界框，图像的最终宽度和高度可能与缩放操作同时更改。

参数：

image_data

要裁剪的图像，是 JPEG、PNG、GIF（包括动画）、BMP、TIFF 或 ICO 格式的字节字符串 (str)。

left_x

边界框的左边界，采用指定为 float 值从 0.0 到 1.0（包括 0.0 和 1.0）的图像宽度的比例。

top_y

边界框的上边界，采用指定为 float 值从 0.0 到 1.0（包括 0.0 和 1.0）的图像高度的比例。

right_x

边界框的右边界，采用指定为 float 值从 0.0 到 1.0（包括 0.0 和 1.0）的图像宽度的比例。

bottom_y

边界框的下边界，采用指定为 float 值从 0.0 到 1.0（包括 0.0 和 1.0）的图像高度的比例。

output_encoding

转换的图像所需的格式。可以是 images.PNG 或 images.JPEG 格式。默认为 images.PNG。

rotate(image_data, degrees, output_encoding=images.PNG)

旋转图像。旋转量必须是 90 度的倍数。函数采用图像数据进行旋转，并以相同的格式返回转换后的图像。

旋转沿顺时针方向执行。旋转 90 度会使图像的上边缘成为右边缘。

参数：

image_data

要旋转的图像，是 JPEG、PNG、GIF（包括动画）、BMP、TIFF 或 ICO 格式的字节字符串 (str)。

degrees

旋转图像的量，以度数表示，是 90 度的倍数。

output_encoding

转换的图像所需的格式。可以是 images.PNG 或 images.JPEG 格式。默认为 images.PNG。

horizontal_flip(image_data, output_encoding=images.PNG)

水平翻转图像。左边缘变成右边缘，或者反之。函数采用图像数据进行翻转，并以相同的格式返回转换后的图像。

参数：

image_data

要翻转的图像，是 JPEG、PNG、GIF（包括动画）、BMP、TIFF 或 ICO 格式的字节字符串 (str)。

output_encoding

转换的图像所需的格式。可以是 images.PNG 或 images.JPEG 格式。默认为 images.PNG。

vertical_flip(image_data, output_encoding=images.PNG)

垂直翻转图像。上边缘变成下边缘，或者反之。函数采用图像数据进行翻转，并以相同的格式返回转换后的图像。

参数：

image_data

要翻转的图像，是 JPEG、PNG、GIF（包括动画）、BMP、TIFF 或 ICO 格式的字节字符串 (str)。

output_encoding

转换的图像所需的格式。可以是 images.PNG 或 images.JPEG 格式。默认为 images.PNG。

im_feeling_lucky(image_data, output_encoding=images.PNG)

根据算法调整图像的对比度和颜色级别以改进图像。这与 Google Picasa 的 [手气不错] 功能类似。函数采用图像数据进行调整，并以相同的格式返回转换后的图像。

参数：

image_data

要调整的图像，是 JPEG、PNG、GIF（包括动画）、BMP、TIFF 或 ICO 格式的字节字符串 (str)。

output_encoding

转换的图像所需的格式。可以是 images.PNG 或 images.JPEG 格式。默认为 images.PNG。

注意：当在 SDK 中本地使用 im_feeling_lucky() 方法时，该方法是 no-op，因为 PIL 上没有等效方法。