# ALTO Image

> Lazy image resizing, cropping and encoding with predictable geometry and efficient multi-output rendering.

Explore [ALTO Image](https://altophp.com/image/) on the ALTO PHP website for guides and examples.

An immutable, lazy image pipeline with predictable geometry and efficient multi-output rendering. Build transformations, inspect headers, calculate projected dimensions, and derive cache signatures and storage paths before decoding pixels. ImageSet renders multiple sizes and formats from one source decode, making responsive image generation a first-class operation. Cropping supports anchors, focal points, attention, and entropy; encoding exposes quality, byte limits, and supported format controls. GD and Imagick provide rendering, with ICC profile preservation and colour-space conversion through Imagick. Local and Flysystem stores, dominant-colour analysis, perceptual hashes, input limits, and CLI inspection support production asset workflows.

Install with `composer require alto/image`. [Packagist package](https://packagist.org/packages/alto/image) and [source repository](https://github.com/altophp/image).

License: MIT.

Composer runtime requirements: `php >=8.3`.

PSR-4 autoloading: `Alto\Image\` maps to `src/`.

ALTO PHP is a family of open-source PHP libraries for building content tools,
documentation systems, developer interfaces, and asset pipelines. Its packages
cover document processing, source code, images, fonts, and web standards. Install
the components your application needs; each has its own Composer package and
repository, and complementary packages can be composed into a larger workflow.

The family is created and maintained by [Simon André](https://smnandre.dev/)
([smnandre on GitHub](https://github.com/smnandre)), a PHP and Symfony developer,
Symfony UX core team member, and creator of ALTO, Atelier SVG, PHPColor, and
Playwright PHP. The [ALTO PHP GitHub organization](https://github.com/altophp)
hosts the source repositories, issue trackers, and contributions. Development
can be supported through [GitHub Sponsors](https://github.com/sponsors/smnandre).

The shared foundation is MIT licensing, Composer installation, PSR-4 autoloading
under `Alto\`, typed PHP APIs, and repository checks using PHPUnit, PHPStan, and
PHP CS Fixer. The focus is on explicit behavior, standards-based formats, and
small components with documented contracts. Core libraries work independently
of a web framework; integration packages connect them to tools such as Twig.
Runtime dependencies and PHP extensions vary by package.
Markdown, RST, Image, and Code Highlight have no third-party Composer runtime
dependencies; Image rendering still requires GD or Imagick.

Names follow three related conventions: `alto/<package>` on
[Packagist](https://packagist.org/packages/alto/), `altophp/<repository>` on
GitHub, and a package-specific PSR-4 prefix in PHP. For example,
`alto/markdown` maps to `altophp/markdown` and `Alto\Markdown\`;
`alto/code-highlight` maps to `altophp/code-highlight` and `Alto\Code\Highlight\`.
Use each package's published Composer metadata for its exact requirements and
available releases. Documentation describes the source used to build this site;
check the installed version when adopting an API.

## Documentation

- [Overview](https://altophp.com/image/): [Markdown](https://altophp.com/image/index.md).
- [Installation](https://altophp.com/image/installation/): [Markdown](https://altophp.com/image/installation.md).
- [Getting started](https://altophp.com/image/getting-started/): [Markdown](https://altophp.com/image/getting-started.md).
- [Formats](https://altophp.com/image/formats/): [Markdown](https://altophp.com/image/formats.md).
- [Transform](https://altophp.com/image/transform/): [Markdown](https://altophp.com/image/transform.md).
- [Image sets](https://altophp.com/image/image-sets/): [Markdown](https://altophp.com/image/image-sets.md).
- [Storage](https://altophp.com/image/storage/): [Markdown](https://altophp.com/image/storage.md).
- [Safety](https://altophp.com/image/safety/): [Markdown](https://altophp.com/image/safety.md).
- [Analysis](https://altophp.com/image/analysis/): [Markdown](https://altophp.com/image/analysis.md).
- [Drivers](https://altophp.com/image/drivers/): [Markdown](https://altophp.com/image/drivers.md).
- [CLI](https://altophp.com/image/cli/): [Markdown](https://altophp.com/image/cli.md).

## Additional reference

- [GD](https://altophp.com/image/drivers/gd/): [Markdown](https://altophp.com/image/drivers/gd.md).
- [Imagick](https://altophp.com/image/drivers/imagick/): [Markdown](https://altophp.com/image/drivers/imagick.md).
- [Writing a driver](https://altophp.com/image/drivers/writing-a-driver/): [Markdown](https://altophp.com/image/drivers/writing-a-driver.md).
- [Image errors](https://altophp.com/image/errors/): [Markdown](https://altophp.com/image/errors.md).
- [Adjust](https://altophp.com/image/transform/adjust/): [Markdown](https://altophp.com/image/transform/adjust.md).
- [Blur](https://altophp.com/image/transform/blur/): [Markdown](https://altophp.com/image/transform/blur.md).
- [Convert a colour profile](https://altophp.com/image/transform/colour-profile/): [Markdown](https://altophp.com/image/transform/colour-profile.md).
- [Contain](https://altophp.com/image/transform/contain/): [Markdown](https://altophp.com/image/transform/contain.md).
- [Cover](https://altophp.com/image/transform/cover/): [Markdown](https://altophp.com/image/transform/cover.md).
- [Crop](https://altophp.com/image/transform/crop/): [Markdown](https://altophp.com/image/transform/crop.md).
- [Extend](https://altophp.com/image/transform/extend/): [Markdown](https://altophp.com/image/transform/extend.md).
- [Fit](https://altophp.com/image/transform/fit/): [Markdown](https://altophp.com/image/transform/fit.md).
- [Flatten](https://altophp.com/image/transform/flatten/): [Markdown](https://altophp.com/image/transform/flatten.md).
- [Flip](https://altophp.com/image/transform/flip/): [Markdown](https://altophp.com/image/transform/flip.md).
- [Grayscale](https://altophp.com/image/transform/grayscale/): [Markdown](https://altophp.com/image/transform/grayscale.md).
- [Invert](https://altophp.com/image/transform/invert/): [Markdown](https://altophp.com/image/transform/invert.md).
- [Orient](https://altophp.com/image/transform/orient/): [Markdown](https://altophp.com/image/transform/orient.md).
- [Overlay](https://altophp.com/image/transform/overlay/): [Markdown](https://altophp.com/image/transform/overlay.md).
- [Pixelate](https://altophp.com/image/transform/pixelate/): [Markdown](https://altophp.com/image/transform/pixelate.md).
- [Resize](https://altophp.com/image/transform/resize/): [Markdown](https://altophp.com/image/transform/resize.md).
- [Rotate](https://altophp.com/image/transform/rotate/): [Markdown](https://altophp.com/image/transform/rotate.md).
- [Scale](https://altophp.com/image/transform/scale/): [Markdown](https://altophp.com/image/transform/scale.md).
- [Sharpen](https://altophp.com/image/transform/sharpen/): [Markdown](https://altophp.com/image/transform/sharpen.md).
- [Stretch](https://altophp.com/image/transform/stretch/): [Markdown](https://altophp.com/image/transform/stretch.md).
- [Tint](https://altophp.com/image/transform/tint/): [Markdown](https://altophp.com/image/transform/tint.md).
- [Trim](https://altophp.com/image/transform/trim/): [Markdown](https://altophp.com/image/transform/trim.md).

## Optional

- [Complete documentation](https://altophp.com/image/llms-full.txt): All published documentation pages in one file.
- [Source repository](https://github.com/altophp/image)