Proportion

​

How to use

The proportion transformation allows you to scale an image to a specified percentage of its original dimensions.

Pass the following query param to the API endpoint:

proportion=percentage

Where:

• percentage is the desired proportion of the original image size.

For example: proportion=50

​

Parameter

percentage: The percentage to scale the image. This parameter accepts integer values:

• Values less than 100 will reduce the image size.
• Values greater than 100 will enlarge the image.
• A value of 100 will keep the image at its original size.

​

Effect of Proportion Scaling

• Scales both the width and height of the image by the specified percentage.
• Maintains the original aspect ratio of the image.
• Can be used to create thumbnails (with values less than 100) or enlarge images (with values greater than 100).

This transformation is useful for creating consistent scaled versions of images, regardless of their original dimensions.

​

Original Image

​

Image scaled to 50% of original size

​

Image scaled to 150% of original size

​

Best Practices

• Use proportion scaling when you want to maintain the aspect ratio of the original image.
• For creating thumbnails, consider values between 25 and 50 percent.
• Be cautious when scaling images up (values over 100), as this may lead to loss of quality or pixelation.
• Combine with other transformations like quality adjustment to optimize file size when scaling down.
• Consider the end-use of the image when choosing the scaling percentage (e.g., web display, print, etc.).
• Remember that extreme scaling (very low or very high percentages) may significantly affect image quality.

​

Note

The proportion transformation affects both width and height equally, ensuring that the image’s aspect ratio is preserved.