Notice: Over the next few months, we're reorganizing the App Engine documentation site to make it easier to find content and better align with the rest of Google Cloud products. The same content will be available, but the navigation will now match the rest of the Cloud products.

Python 3.10 is now generally available.


Asynchronously crops the given image.

The four arguments are the scaling numbers that describe the bounding box that will crop the image. The upper left point of the bounding box will be at (left_x*image_width, top_y*image_height), and the lower right point will be at (right_x*image_width, bottom_y*image_height).

image_data String of the source image data.
left_x Float value between 0.0 and 1.0, inclusive.
top_y Float value between 0.0 and 1.0, inclusive.
right_x Float value between 0.0 and 1.0, inclusive.
bottom_y Float value between 0.0 and 1.0, inclusive.
output_encoding A value from OUTPUT_ENCODING_TYPES.
quality A value between 1 and 100 to specify the quality of the encoding. This value is only used to control JPEG quality.
correct_orientation A value from ORIENTATION_CORRECTION_TYPE to indicate if orientation correction should be performed during the transformation.
rpc An optional UserRPC object.
transparent_substitution_rgb When transparent pixels are not supported in the destination image format, then transparent pixels will be substituted for the specified color, which must be in 32-bit RGB format.

A UserRPC object; call get_result() to complete the RPC and obtain the crop result.

TypeError If the args are not of type float.
BadRequestError When the bounding box values are invalid.
Error All other errors. See Image.ExecuteTransforms for more details.