# Package com.google.appengine.api.images

Provides facilities for the creation and manipulation of images.

See: Description

- Interface Summary
  Interface | Description
  --- | ---
  IImagesServiceFactory | Factory for creating an `ImagesService`, `Image`s and `Transform`s.
  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`, `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`.
  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.

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

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.