1
0
mirror of https://github.com/imgproxy/imgproxy.git synced 2025-01-18 11:12:10 +02:00
imgproxy/docs/presets.md

24 lines
885 B
Markdown
Raw Normal View History

2018-10-04 18:59:57 +06:00
# Presets
2018-10-08 12:23:20 +06:00
imgproxy preset is a named set of processing options. Presets can be used in [advanced URL format](./generating_the_url_advanced.md#preset) to get shorter and somewhat readable URLs.
2018-10-04 18:59:57 +06:00
### Presets definition
2018-10-08 12:23:20 +06:00
The preset definition looks like this:
2018-10-04 18:59:57 +06:00
```
%preset_name=%processing_options
```
2018-10-08 12:23:20 +06:00
Processing options should be defined in the same way as you define them in the [advanced URL format](./generating_the_url_advanced.md#preset). For example, here is a preset named `awesome` that sets the resizing type to `fill` and resulting format to `jpg`:
2018-10-04 18:59:57 +06:00
```
awesome=resizing_type:fill/format:jpg
```
2018-10-08 12:23:20 +06:00
Read how to specify your presets with imgproxy in the [Configuration](./configuration.md) guide.
2018-10-04 18:59:57 +06:00
### Default preset
2018-10-08 12:23:20 +06:00
A preset named `default` will be applied to each image. Useful in case you want your default processing options to be different from the imgproxy default ones.