DarthSim před 5 roky
rodič
revize
c6d4a681be

+ 15 - 4
docs/generating_the_url_advanced.md

@@ -59,8 +59,7 @@ rt:%resizing_type
 Defines how imgproxy will resize the source image. Supported resizing types are:
 
 * `fit`: resizes the image while keeping aspect ratio to fit given size;
-* `fill`: resizes the image while keeping aspect ratio to fill given size and cropping projecting parts;
-* `crop`: crops the image to a given size.
+* `fill`: resizes the image while keeping aspect ratio to fill given size and cropping projecting parts.
 
 Default: `fit`
 
@@ -71,7 +70,7 @@ width:%width
 w:%width
 ```
 
-Defines the width of the resulting image. When set to `0`, imgproxy will calculate the resulting width using the defined height and source aspect ratio. When set to `0` and the `crop` resizing type is used, imgproxy will use the full width of the source image.
+Defines the width of the resulting image. When set to `0`, imgproxy will calculate the resulting width using the defined height and source aspect ratio.
 
 Default: `0`
 
@@ -82,7 +81,7 @@ height:%height
 h:%height
 ```
 
-Defines the height of the resulting image. When set to `0`, imgproxy will calculate resulting height using the defined width and source aspect ratio. When set to `0` and `crop` resizing type is used, imgproxy will use the full height of the source image.
+Defines the height of the resulting image. When set to `0`, imgproxy will calculate resulting height using the defined width and source aspect ratio.
 
 Default: `0`
 
@@ -141,6 +140,18 @@ When imgproxy needs to cut some parts of the image, it is guided by the gravity.
 
 Default: `ce`
 
+##### Crop
+
+```
+crop:%width:%height:%gravity
+c:%width:%height:%gravity
+```
+
+Defines an area of the image to be processed (crop before resize).
+
+* `width` and `height` define the size of the area. When `width` or `height` is set to `0`, imgproxy will use the full width/height of the source image.
+* `gravity` accepts the same values as [gravity](#gravity) option. When `gravity` is not set, imgproxy will use the value of the [gravity](#gravity) option.
+
 ##### Quality
 
 ```

+ 1 - 2
docs/generating_the_url_basic.md

@@ -24,8 +24,7 @@ Once you set up your [URL signature](./configuration.md#url-signature), check ou
 imgproxy supports the following resizing types:
 
 * `fit`: resizes the image while keeping aspect ratio to fit given size;
-* `fill`: resizes the image while keeping aspect ratio to fill given size and cropping projecting parts;
-* `crop`: crops the image to a given size.
+* `fill`: resizes the image while keeping aspect ratio to fill given size and cropping projecting parts.
 
 #### Width and height
 

+ 9 - 6
docs/image_formats_support.md

@@ -7,18 +7,21 @@ At the moment, imgproxy supports only the most popular Web image formats:
 * WebP;
 * GIF;
 * ICO;
-* SVG _(source only)_.
+* SVG _(source only)_;
+* HEIC.
 
 ## GIF support
 
 imgproxy supports GIF output only when using libvips 8.7.0+ compiled with ImageMagick support. Official imgproxy Docker image supports GIF out of the box.
 
-Since processing of animated GIFs is pretty heavy, only one frame is processed by default. You can increase the maximum of GIF frames to process with the following variable:
+## ICO support
 
-* `IMGPROXY_MAX_GIF_FRAMES`: the maximum of animated GIF frames to being processed. Default: `1`.
+imgproxy supports ICO output only when using libvips 8.7.0+ compiled with ImageMagick support. Official imgproxy Docker image supports ICO out of the box.
 
-**Note:** imgproxy summarizes all GIF frames resolutions while checking source image resolution.
+## Animated images support
 
-## ICO support
+Since processing of animated images is pretty heavy, only one frame is processed by default. You can increase the maximum of animation frames to process with the following variable:
 
-imgproxy supports ICO output only when using libvips 8.7.0+ compiled with ImageMagick support. Official imgproxy Docker image supports ICO out of the box.
+* `IMGPROXY_MAX_ANIMATION_FRAMES`: the maximum of animated image frames to being processed. Default: `1`.
+
+**Note:** imgproxy summarizes all frames resolutions while checking source image resolution.