Функции

Пакет google.appengine.api.images содержит определения следующих функций:

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

Выполняет изменение размера изображения, масштабируя его в большую или меньшую сторону, в зависимости от переданных параметров ширины и высоты. Функция принимает в качестве параметра содержимое изображения, размер которого требуется изменить, и возвращает его в преобразованном виде в том же самом формате.

Параметры:

image_data

Изображение, размер которого необходимо изменить, в виде массива байт (str) в форматах JPEG, PNG, GIF (включая анимированный), BMP, TIFF или ICO.

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 * ширина, top_y * высота, right_x * ширина и bottom_y * высота. Это позволяет вам указывать параметры ограничительной рамки независимо от окончательных размеров изображения, которые могут поменяться при выполнении операции изменения размеров.

Параметры:

image_data

Изображение, которое необходимо обрезать, в виде массива байт (str) в форматах JPEG, PNG, GIF (включая анимированный), BMP, TIFF или ICO.

left_x

Левая граница ограничительной рамки, задается как пропорция ширины изображения, определяемая значением типа float в интервале от 0.0 до 1.0 (включительно).

top_y

Верхняя граница ограничительной рамки, задается как пропорция высоты изображения, определяемая значением типа float в интервале от 0.0 до 1.0 (включительно).

right_x

Правая граница ограничительной рамки, задается как пропорция ширины изображения, определяемая значением типа float в интервале от 0.0 до 1.0 (включительно).

bottom_y

Нижняя граница ограничительной рамки, задается как пропорция высоты изображения, определяемая значением типа float в интервале от 0.0 до 1.0 (включительно).

output_encoding

Заданный формат выходного изображения. Может быть либо images.PNG, либо images.JPEG. По умолчанию - images.PNG.

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

Поворачивает изображение. Требуемый угол вращения должен быть кратен 90 градусам. Функция принимает в качестве параметра содержимое изображения, которое требуется повернуть, и возвращает его в преобразованном виде в том же самом формате.

Поворот осуществляется по часовой стрелке. Например, параметр 90 градусов поворачивает изображение таким образом, что его верхняя сторона становится правой.

Параметры:

image_data

Изображение, которое требуется повернуть, в виде массива байт (str) в форматах JPEG, PNG, GIF (включая анимированный), BMP, TIFF или ICO.

degrees

Требуемый угол вращения, задаваемый в градусах и кратный 90-та.

output_encoding

Заданный формат выходного изображения. Может быть либо images.PNG, либо images.JPEG. По умолчанию - images.PNG.

horizontal_flip(image_data, output_encoding=images.PNG)

Переворачивает изображение по горизонтали. Его левая сторона становится правой и наоборот. Функция принимает в качестве параметра содержимое изображения, которое требуется перевернуть, и возвращает его в преобразованном виде в том же самом формате.

Параметры:

image_data

Изображение, которое требуется перевернуть, в виде массива байт (str) в форматах JPEG, PNG, GIF (включая анимированный), BMP, TIFF или ICO.

output_encoding

Заданный формат выходного изображения. Может быть либо images.PNG, либо images.JPEG. По умолчанию - images.PNG.

vertical_flip(image_data, output_encoding=images.PNG)

Переворачивает изображение по вертикали. Его верхняя сторона становится нижней и наоборот. Функция принимает в качестве параметра содержимое изображения, которое требуется перевернуть, и возвращает его в преобразованном виде в том же самом формате.

Параметры:

image_data

Изображение, которое требуется перевернуть, в виде массива байт (str) в форматах JPEG, PNG, GIF (включая анимированный), BMP, TIFF или ICO.

output_encoding

Заданный формат выходного изображения. Может быть либо images.PNG, либо images.JPEG. По умолчанию - images.PNG.

im_feeling_lucky(image_data, output_encoding=images.PNG)

Преобразует уровни контрастности и цвета изображения по алгоритму для улучшения фотографий. Является функцией, подобной возможности "I'm Feeling Lucky" продукта Google Picasa. Функция принимает в качестве параметра содержимое изображения, которое требуется преобразовать, и возвращает его в преобразованном виде в том же самом формате.

Параметры:

image_data

Изображение, которое требуется преобразовать, в виде массива байт (str) в форматах JPEG, PNG, GIF (включая анимированный), BMP, TIFF или ICO.

output_encoding

Заданный формат выходного изображения. Может быть либо images.PNG, либо images.JPEG. По умолчанию - images.PNG.

Примечание: В локальном пакете разработки SDK метод im_feeling_lucky() является заглушкой и не выполняет никаких функций, так как не имеет эквивалента в библиотеке PIL.