Resizing Images

Updated on 2024-08-09 GMT+08:00

View PDF

You can use the GUI or code mode on OBS Console or make an API call to resize images. Images can be resized based on a specific rule or a fixed width, height, or percentage.

NOTE:

A long side refers to the side with a larger ratio of its original size to its target size, and a short side refers to the side with a smaller ratio. Assume that the original size of an image is 400 × 200 pixels and it is resized to 100 × 100 pixels. The ratio of 400 pixels to 100 pixels is 4 and that of 200 pixels to 100 pixels is 2, so the long side is 400 pixels and the short side is 200 pixels.
For a target image after resizing, its long side cannot exceed 9,999 pixels, and the product of its width and height cannot exceed 24,999,999 pixels.
If you only specify the height or width for resizing, the target image keeps the same aspect ratio and format as the original image.
By default, resizing is not allowed to scale up an image. If you want an image to become larger after resizing, you need to set limit to 0 to obtain the enlarged image, or the original image will be returned. To do this, use the following format:
https://hw-image-demo.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=image/resize,w_500,limit_0

Table 1 describes the parameters.

This operation is represented by resize.

**Table 1** Resizing parameters
Parameter	Value Description	Code Example
m	Type of resizing. The value can be lfit (the default value), mfit, fill, pad, or fixed. lfit: Specify a rectangle with a given width (indicated by w) and height (indicated by h), lock the aspect ratio, and obtain the largest image in the rectangle. mfit: Specify a rectangle with a given width (indicated by w) and height (indicated by h), lock the aspect ratio, and obtain the smallest image in the rectangle's extended area. fill: Specify a rectangle with a given width (indicated by w) and height (indicated by h) and lock the aspect ratio. Obtain the smallest image in the rectangle's extended area, and center and crop the image. fill-based resizing actually centers and crops a target image resized with mfit. pad: Specify a rectangle with a given width (indicated by w) and height (indicated by h) and lock the aspect ratio. Obtain the largest image in the rectangle and fill the blank area with color. pad-based resizing actually fills the blank area of a target image resized with lfit. fixed: Resize an image based on a fixed width and height. ratio: Specify an aspect ratio (a ratio of w to h), in the range of 1 to 1000, and obtain the largest image that meets the specified ratio.	image/resize,m_lfit,h_100,w_100
p	Percentage of the aspect ratio, in the range of 1 to 1000. If the value is: < 100: The image is scaled down. = 100: The image is kept unchanged in size. > 100: The image is scaled up.	image/resize,p_50
h	Height of the target image, in the range of 1 to 9999. The product of the target image's width and height cannot exceed 24,999,999.	image/resize,m_lfit,h_100
w	Width of the target image, in the range of 1 to 9999. The product of the target image's width and height cannot exceed 24,999,999.	image/resize,m_fixed,h_100,w_100
l	The long side of the target image, in the range of 1 to 4096. The product of the target image's width and height cannot exceed 24,999,999. The long side has a specified value, and the short side is scaled based on the ratio.	image/resize,l_100
s	The short side of the target image, in the range of 1 to 4096. The product of the target image's width and height cannot exceed 24,999,999. The short side has a specified value, and the long side is scaled based on the ratio.	image/resize,s_100
color	Color for filling the blank area after resizing. This parameter can be used when you set m to pad. The value is a hexadecimal code, from 000000 to FFFFFF (default value, representing white).	image/resize,m_pad,h_100,w_100,color_FF0000
limit	Whether to limit the size of the target image when the target image is larger than the original one. The value can be 0 or 1 (default value). 0: The size is not limited. 1: The size is limited.	image/resize,p_150,limit_0

CAUTION:

If a resized image is aliased, you can add /marker,u_plus to the end of the image processing URL for optimization.

For example, by adding /marker,u_plus, the processing URL https://hw-image-demo.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=image/resize,m_fixed,w_2668,h_1999,limit_0 becomes https://hw-image-demo.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=image/resize,m_fixed,w_2668,h_1999,limit_0/marker,u_plus. The latter displays an image with better quality.

Examples

Set h to 100 and m to lfit (the default value) to process the width proportionally.
https://hw-image-demo.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=image/resize,m_lfit,h_100
Lock the aspect ratio and specify the short side to resize the image into 100 x 100 pixels.
https://hw-image-demo.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=image/resize,m_lfit,h_100,w_100
Set the long side size to 100 and scale the short side based on the ratio.
https://hw-image-demo.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=image/resize,l_100
Fix the width and height, center and crop the image, resize the image into 100 x 100 pixels.
https://hw-image-demo.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=image/resize,m_fill,h_100,w_100
Fix both the width and height to 100.
https://hw-image-demo.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=image/resize,m_fixed,h_100,w_100
Fix the width and height. Resize the image into 100 x 100 pixels by specifying the short side and fill the blank area with white.
https://hw-image-demo.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=image/resize,m_pad,h_100,w_100
Fix the width and height. Resize the image into 100 x 100 pixels by specifying the short side and fill the blank area with red.
https://hw-image-demo.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=image/resize,m_pad,h_100,w_100,color_FF0000
Scale up the image to 150% of its original size and set limit to 0 to obtain the enlarged image.
https://hw-image-demo.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=image/resize,p_150,limit_0
Set p to 30 to scale down the image to 30% of its original size.
https://hw-image-demo.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=image/resize,p_30
Set an image's aspect ratio to 3:2.
https://hw-image-demo.obs.ap-southeast-1.myhuaweicloud.com/example.jpg?x-image-process=image/resize,m_ratio,w_3,h_2

Previous topic: Blur

Next topic: Rotating Images

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot