Image Transforms

Manipulate images using standard resizing, scaling, and cropping operations.

QueryString API

  • width constrains the image width. w is an alias for width

  • height constrains the image height. h is an alias for height

  • dpr is a multiplier for width/height to make responsive image usage easier.

  • mode determines how to handle aspect ratio differences.

    • stretch distorts the image to be exactly the given dimensions, if scale=both. If scale=down (the default), the image is only scaled if width and height are smaller than the image.

    • pad scales the image to fit within width and height, then pads 2 edges (bgcolor) to make it.

    • crop scales the image to fit above width and height, then minimally crops to meet aspect ratio.

    • max scales the image to fit within width and height

  • scale controls whether images are upsampled or not.

    • down - Never upscale an image - return at original size instead

    • both - Downscale or upscale to meet size requirements. Image enlargement causes blurriness and should be avoided.

    • canvas - Add padding instead of upscaling to meet size requirements.

    • up - Never downscale, only upscale to meet requirements. Rarely used.

  • anchor determines how the image is aligned when you use mode=crop, mode=pad or scale=canvas. The default is middlecenter

    • values are topleft, topcenter, topright, middleleft, middlecenter, middleright, bottomleft, bottomcenter, and bottomright.

  • sflip flips the source image in the x, y, or xy dimensions.

  • flip flips the result image in the x, y, or xy dimensions.

  • srotate rotates the source image 90, 180, or 270 degrees.

  • rotate rotates the result image 90, 180, or 270 degrees.

  • crop=x1,y1,x2,y2 crops the source image to the given coordinates. If x2 or y2 are negative, they are relative to the bottom-right corner of the image. crop=10,10,-10,-10 removes 10 pixels from the edge of the image.

  • cropxunits=100&cropyunits=100 makes the crop coordinates percentages of the image instead of pixels.

  • trim.threshold=80 specifies a threshold to use for trimming whitespace.

  • trim.percentpadding=0.5 specifies percentage of padding to restore after trimming.

  • bgcolor must be in the form RGB, RGBA, RRGGBBAA, RRGGBB, or be a named color. bgcolor determines the color of padding added with mode=pad or scale=canvas.

  • ignoreicc=true causes the source image's color profile to be ignored and treated as sRGB.

  • ignore_icc_errors=true causes color profile errors to be ignored rather than causing the operation to fail.

Last updated