diff --git a/CHANGELOG.md b/CHANGELOG.md index a2e4fff0..0688767d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,6 +3,11 @@ ## [Unreleased] ### Add - Add `IMGPROXY_CLIENT_KEEP_ALIVE_TIMEOUT` config. +- (pro) Add [disable_animation](https://docs.imgproxy.net/latest/generating_the_url?id=disable-animation) processing option. +- (pro) Add [gradient](https://docs.imgproxy.net/latest/generating_the_url?id=gradient) processing option. + +### Fix +- (pro) Fix saving of GIF with variable frame delay to MP4. ## [3.9.0] - 2022-10-19 ### Add diff --git a/docs/generating_the_url.md b/docs/generating_the_url.md index 0db7fdc8..3a0ba0b0 100644 --- a/docs/generating_the_url.md +++ b/docs/generating_the_url.md @@ -413,6 +413,24 @@ dd:%draw:%class_name1:%class_name2:...:%class_nameN When `draw` is set to `1`, `t` or `true`, imgproxy [detects objects](object_detection.md) of the provided classes and draws their bounding boxes. If class names are omitted, imgproxy draws the bounding boxes of all the detected objects. +### Gradient![pro](/assets/pro.svg) :id=gradient + +``` +gradient:%opacity:%color:%direction:%start%stop +gr:%opacity:%color:%direction:%start%stop +``` + +Places a gradient on the processed image. The placed gradient transitions from transparency to the specified color. + +* `opacity`: specifies gradient opacity. When set to `0`, gradient is not applied. +* `color`: _(optional)_ a hex-coded value of the gradient color. Default: `000` (black). +* `direction`: _(optional)_ specifies the direction of the gradient. Available values: + * `down`: _(default)_ the top side of the gradient is transparrent, the bottom side is opaque + * `up`: the bottom side of the gradient is transparrent, the top side is opaque + * `right`: the left side of the gradient is transparrent, the right side is opaque + * `left`: the right side of the gradient is transparrent, the left side is opaque +* `start`, `stop`: floating point numbers that define relative positions of where the gradient starts and where it ends. Default values are `0.0` and `1.0` respectively. + ### Watermark ``` @@ -635,6 +653,17 @@ When a source image supports pagination (PDF, TIFF) or animation (GIF, WebP), th Default: 0 +### Disable animation![pro](/assets/pro.svg) :id=disable-animation + +``` +disable_animation:%disable +da:%disable +``` + +When set to `1`, `t` or `true`, imgproxy will use a single frame of animated images. Use the [page](#page) option to specify which frame imgproxy should use. + +Default: `false` + ### Video thumbnail second![pro](/assets/pro.svg) :id=video-thumbnail-second ```