This guide is designed to inform our partners about the capabilities of our image manipulation services. By appending specific query parameters to an image URL, users can modify the appearance of images in various ways, adapting them for different needs without any in-depth technical knowledge.

  1. Query Parameters

  2. 1. Width Modification (width)

    • Syntax: ?width=[width in pixels]

    • Example: ?width=100

    • Description:

    • Changes the width of the image to the specified pixel value while automatically adjusting the height to maintain the original aspect ratio.

  3. 2. Height Modification (height)

    • Syntax: ?height=[height in pixels]

    • Example: ?height=50

    • Description: 

    • Adjusts the height of the image, automatically altering the width to keep the aspect ratio intact.

  4. 3. Explicit Width and Height Modification (width, height)

    • Syntax: ?width=[width in pixels]&height=[height in pixels]

    • Example: ?width=100&height=50

    • Description: 

    • Sets both the width and height of the image to specified values, which can modify the original aspect ratio.

  5. 4. Cropping (mode=crop)

    • Syntax: ?width=[width]&height=[height]&mode=crop

    • Example: ?width=100&height=50&mode=crop

    • Description: 

    • Crops the image to the given width and height dimensions. This mode removes parts of the image to fit the defined size.

  6. 5. Cropping with Anchor (anchor)

    • Syntax: ?width=[width]&height=[height]&mode=crop&anchor=[anchor point]

    • Example: ?width=100&height=50&mode=crop&anchor=top

    • Anchor Values: top, bottom, left, right

    • Description: 

    • Extends the cropping function by allowing specification of an anchor point. The anchor determines which part of the image is prioritized in the cropping process.

  7. 6. Background Color (bgcolor)

    • Syntax: ?width=[width]&height=[height]&bgcolor=[hex color code]

    • Example: ?width=100&height=50&bgcolor=ff0000

    • Description: 

    • Applies a background color in hexadecimal format when resizing leads to changes in the original aspect ratio.

  8. 7. Quality Adjustment (quality)

    • Syntax: ?quality=[value]

    • Example: ?quality=80

    • Description: 

    • Adjusts the quality of the image. The value ranges from 0 (lowest quality) to 100 (highest quality). This is useful for reducing file size for faster loading times on websites.

  9. Implementation and Usage

    • The parameters can be used individually or in combination to achieve the desired image manipulation.

    • Ensure the URL is correctly formatted, with parameters spelled correctly to avoid errors.

    • These parameters are useful for various applications like web design, e-commerce platforms, or any digital medium requiring image customization.

    • The final quality and appearance of the image depend on the original dimensions and aspect ratio. Be mindful of significant enlargements from small originals, as they may result in quality loss.