# ALTO Image

HTML: [altophp.com/image](https://altophp.com/image/)

ALTO Image builds immutable image requests with predictable output geometry.
It can inspect and plan work before decoding pixels, then render several
derivatives from one source decode with GD or Imagick.

```php
use Alto\Image\Image;

$result = Image::open('photo.jpg')
    ->cover(800, 450)
    ->webp(80)
    ->save('hero.webp');
```

The source remains unchanged and the saved result measures 800 by 450 pixels.
Start with the complete first workflow, then choose pages by task.

![An 800 by 450 cover generated from the tutorial source](https://altophp.com/image/assets/examples/first-cover.webp)

## Documentation

- [Installation](https://altophp.com/image/installation.md): install the package and inspect available drivers.
- [Getting started](https://altophp.com/image/getting-started.md): create and verify a first image derivative.
- [Formats](https://altophp.com/image/formats.md): understand known formats and runtime read and write support.
- [Transform](https://altophp.com/image/transform.md): resize, crop, compose, and adjust pixels.
- [Image sets](https://altophp.com/image/image-sets.md): render several outputs from one source decode.
- [Storage](https://altophp.com/image/storage.md): save, cache, and reuse image derivatives.
- [Safety](https://altophp.com/image/safety.md): control metadata, resources, and untrusted input.
- [Analysis](https://altophp.com/image/analysis.md): extract colours and compare images perceptually.
- [Drivers](https://altophp.com/image/drivers.md): choose GD, Imagick, or a third-party implementation.
- [CLI](https://altophp.com/image/cli.md): inspect and convert images from the command line.

## Boundaries

Available formats and exact behavior depend on the selected driver and its
compiled delegates. Animated inputs are reduced to their first frame. GD does
not preserve metadata; Imagick support depends on its build. Run
`vendor/bin/image doctor` on each deployment target before relying on a format
or optional capability.

---

Next: [Installation](https://altophp.com/image/installation.md)

---

ALTO\IMAGE: [altophp.com/image](https://altophp.com/image/)
ALTO(PHP): [altophp.com](https://altophp.com/)