# com.google.appengine.api.images
Date: 2012-02-24

## Package com.google.appengine.api.images

This package provides facilities for the creation and manipulation of images by Java code.

See:
Description

Interface Summary
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
Composite: A `Composite` represents a composition of an image onto a canvas.
CompositeTransform: A transform that represents zero or more transforms executed in series.
ImagesServiceFactory: Factory for creating an `ImagesService`, `Image`s and `Transform`s.
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`.
Transform: A transform that can be applied to an `Image`.

Enum Summary
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
ImagesServiceFailureException: `ImagesServiceFailureException` is thrown when any unknown error occurs while communicating with the images service.

## Package com.google.appengine.api.images Description

This package provides facilities for the creation and manipulation of images by Java code. The starting point is the `ImagesServiceFactory` class, which can produce the `ImageService`, 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.