• Официальный сайт SDK
  • Сайт с примерами кода

Функции

Пакет 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.