Package com.google.appengine.api.images

Provides facilities for the creation and manipulation of images. The starting point is the ImagesServiceFactory class, which can produce the ImagesService, but also the basic Image object and Transform classes. More information is available in the on-line documentation.

Image data is represented as a byte[] of data, in any of the supported formats: JPEG, PNG, GIF (including animated GIF), BMP, TIFF, and ICO formats. The format can be accessed via the Image.getFormat() method. The image format may be converted during transformation.

Supported transformations include cropping, resizing, rotating in 90-degree increments, horizontal and vertical flips, and automated color enhancement.

See Also:

ImagesService, The Images Java API in the Google App Engine Developer's Guide.

Interface Summary

Interface	Description
IImagesServiceFactory	Factory for creating an ImagesService, Images and Transforms.
Image	Image represents an image that can be manipulated by the ImagesService.
ImagesService	The images service provides methods to apply transformations to images.

Class Summary

Class	Description
Composite	A Composite represents a composition of an image onto a canvas.
CompositeTransform	A transform that represents zero or more transforms executed in series.
IImagesServiceFactoryProvider	Factory provider for IImagesServiceFactory.
ImagesServiceFactory	Factory for creating an ImagesService, Images and Transforms.
InputSettings	InputSettings represents the different settings to specify how an Image is interpreted by a transform.
OutputSettings	OutputSettings represents the different settings to specify how a particular transform or composite will return an Image.
ServingUrlOptions	Allow users to customize the behavior of creating a image serving URL using the ImagesService.
ServingUrlOptions.Builder	Contains static creation methods for ServingUrlOptions.
Transform	A transform that can be applied to an Image.

Enum Summary

Enum	Description
Composite.Anchor	Valid anchoring positions for a compositing operation.
Image.Format	Image formats usable by the images api.
ImagesService.OutputEncoding	Valid output encoding formats usable for image transforms.
InputSettings.OrientationCorrection	Actions to take with respect to correcting image orientation based on image metadata.

Exception Summary

Exception	Description
ImagesServiceFailureException	ImagesServiceFailureException is thrown when any unknown error occurs while communicating with the images service.