diff --git a/docs/generating_the_url.md b/docs/generating_the_url.md index 54a7dc35..5187b4d9 100644 --- a/docs/generating_the_url.md +++ b/docs/generating_the_url.md @@ -197,24 +197,6 @@ Defines an area of the image to be processed (crop before resize). * When `width` or `height` is set to `0`, imgproxy will use the full width/height of the source image. * `gravity` _(optional)_ accepts the same values as [gravity](#gravity) option. When `gravity` is not set, imgproxy will use the value of the [gravity](#gravity) option. -### Padding - -``` -padding:%top:%right:%bottom:%left -pd:%top:%right:%bottom:%left -``` - -Defines padding size in css manner. All arguments are optional but at least one dimension must be set. Padded space is filled according to [background](#background) option. - -* `top` - top padding (and all other sides if they won't be set explicitly); -* `right` - right padding (and left if it won't be set explicitly); -* `bottom` - bottom padding; -* `left` - left padding. - -**📝Note:** Padding is applied after all image transformations (except watermark) and enlarges generated image which means that if your resize dimensions were 100x200px and you applied `padding:10` option then you will get 120x220px image. - -**📝Note:** Padding follows [dpr](#dpr) option so it will be scaled too if you set it. - ### Trim ``` @@ -235,6 +217,33 @@ Removes surrounding background. **📝Note:** Trimming of animated images is not supported. +### Padding + +``` +padding:%top:%right:%bottom:%left +pd:%top:%right:%bottom:%left +``` + +Defines padding size in css manner. All arguments are optional but at least one dimension must be set. Padded space is filled according to [background](#background) option. + +* `top` - top padding (and all other sides if they won't be set explicitly); +* `right` - right padding (and left if it won't be set explicitly); +* `bottom` - bottom padding; +* `left` - left padding. + +**📝Note:** Padding is applied after all image transformations (except watermark) and enlarges generated image which means that if your resize dimensions were 100x200px and you applied `padding:10` option then you will get 120x220px image. + +**📝Note:** Padding follows [dpr](#dpr) option so it will be scaled too if you set it. + +### Auto Rotate + +``` +auto_rotate:%auto_rotate +ar:%auto_rotate +``` + +When set to `1`, `t` or `true`, imgproxy will automatically rotate images based onon the EXIF Orientation parameter (if available in the image meta data). The orientation tag will be removed from the image anyway. Normally this is controlled by the [IMGPROXY_AUTO_ROTATE](configuration.md#miscellaneous) configuration but this procesing option allows the configuration to be set for each request. + ### Rotate ``` @@ -246,32 +255,6 @@ Rotates the image on the specified angle. The orientation from the image metadat **📝Note:** Only 0/90/180/270/etc degrees angles are supported. -Default: 0. - -### Quality - -``` -quality:%quality -q:%quality -``` - -Redefines quality of the resulting image, percentage. When `0`, quality is assumed based on `IMGPROXY_QUALITY` and `IMGPROXY_FORMAT_QUALITY`. - -Default: 0. - -### Max Bytes - -``` -max_bytes:%bytes -mb:%bytes -``` - -When set, imgproxy automatically degrades the quality of the image until the image is under the specified amount of bytes. - -**📝Note:** Applicable only to `jpg`, `webp`, `heic`, and `tiff`. - -**⚠️Warning:** When `max_bytes` is set, imgproxy saves image multiple times to achieve specified image size. - Default: 0 ### Background @@ -435,6 +418,50 @@ When set, imgproxy will prepend `