This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

imresize

Syntax

J = imresize(I,scale)
J = imresize(I,[numrows numcols])
[Y,newmap] = imresize(X,map,___)
___ = imresize(___,method)
___ = imresize(___,Name,Value)

Description

example

J = imresize(I,scale) returns image J that is scale times the size of grayscale, RGB, or binary image I. If I has more than two dimensions, then imresize only resizes the first two dimensions. By default, imresize uses bicubic interpolation and performs antialiasing.

You optionally can resize images using a GPU (requires Parallel Computing Toolbox™). For more information, see Image Processing on a GPU.

example

J = imresize(I,[numrows numcols]) returns image J that has the number of rows and columns specified by the vector [numrows numcols].

example

[Y,newmap] = imresize(X,map,___) resizes the indexed image X with colormap map. By default, imresize returns an optimized colormap, newmap, with the resized image. To return a colormap that is the same as the original colormap, use the Colormap name-value pair argument.

This syntax is not supported on a GPU.

example

___ = imresize(___,method) specifies the interpolation method used.

Only the 'bicubic' and 'cubic' interpolation methods are supported on a GPU.

___ = imresize(___,Name,Value) uses name-value pair arguments to control various aspects of the resizing operation.

This syntax is not supported on a GPU.

Examples

collapse all

Read image into the workspace.

I = imread('rice.png');

Resize the image, specifying scale factor and using default interpolation method and antialiasing.

J = imresize(I, 0.5);

Display the original and the resized image.

figure
imshow(I)
title('Original Image')

figure
imshow(J)
title('Resized Image')

Read image into the workspace in a gpuArray.

I = im2double(gpuArray(imread('rice.png')));

Resize the image, performing the operation on a GPU.

J = imresize(I, 0.5);

Display the original image and the resized image.

figure
imshow(I)
title('Original')
figure
imshow(J)
title('Resized Image')

Read image into the workspace.

I = imread('rice.png');

Resize the image, specifying scale factor and the interpolation method.

J = imresize(I, 0.5, 'nearest');

Display the original and the resized image.

figure
imshow(I)
title('Original Image')

figure
imshow(J)
title('Resized Image Using Nearest-Neighbor')

Read image into the workspace.

[X, map] = imread('trees.tif');

Resize the image, specifying a scale factor. By default, imresize returns an optimized color map with the resized indexed image.

[Y, newmap] = imresize(X, map, 0.5);

Display the original image and the resized image.

figure
imshow(X,map)
title('Original Image')

figure
imshow(Y,newmap)
title('Resized Image')

Read image into the workspace.

RGB = imread('peppers.png');

Resize the image, specifying that the output image have 64 rows. Let imresize calculate the number of columns necessary to preserve the aspect ratio.

RGB2 = imresize(RGB, [64 NaN]);

Display the original image and the resized image.

figure
imshow(RGB)
title('Original Image')

figure
imshow(RGB2)
title('Resized Image')

Read image into the workspace in a gpuArray.

RGB = gpuArray(im2single(imread('peppers.png')));

Resize the image, performing the operation on a GPU.

RGB2 = imresize(RGB, 0.5);

Display the original image and the resized image.

figure
imshow(RGB)
title('Original')
figure
imshow(RGB2)
title('Resized Image')

Input Arguments

collapse all

Image to be resized, specified as a numeric or logical array of any dimension.

To resize images using a GPU, specify I as a gpuArray that contains a numeric array of data type double or single.

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | logical

Resize factor, specified as a positive number.

  • If scale is less than 1, then the output image (J or Y) is smaller than the input image (I or X).

  • If scale is greater than 1, then the output image is larger than the input image.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Row and column dimensions of output image, specified as a 2-element vector of positive numbers. Either numrows or numcols can be NaN, in which case imresize computes the number of rows or columns automatically to preserve the image aspect ratio.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Indexed image to be resized, specified as a numeric array.

Data Types: double | uint8 | uint16

Colormap associated with indexed image X, specified as a c-by-3 numeric matrix.

Data Types: double

Interpolation method, specified as a string scalar, character vector or 2-element cell array.

When method is a string scalar or character vector, it identifies a particular method or named interpolation kernel, listed in the following table.

MethodDescription

'nearest'

Nearest-neighbor interpolation; the output pixel is assigned the value of the pixel that the point falls within. No other pixels are considered.

'bilinear'

Bilinear interpolation; the output pixel value is a weighted average of pixels in the nearest 2-by-2 neighborhood

'bicubic'

Bicubic interpolation; the output pixel value is a weighted average of pixels in the nearest 4-by-4 neighborhood

Note

Bicubic interpolation can produce pixel values outside the original range.

Interpolation KernelDescription
'box'Box-shaped kernel
'triangle'Triangular kernel (equivalent to 'bilinear')
'cubic'Cubic kernel (equivalent to 'bicubic')
'lanczos2'Lanczos-2 kernel
'lanczos3'Lanczos-3 kernel

When method is a 2-element cell array, it defines a custom interpolation kernel. The cell array has the form {f,w}, where f is a function handle for a custom interpolation kernel and w is the width of the custom kernel. f(x) must be zero outside the interval -w/2 <= x < w/2. The function handle f can be called with a scalar or a vector input. For user-specified interpolation kernels, the output image can have some values slightly outside the range of pixel values in the input image.

Data Types: char | string | cell

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: I2 = imresize(I,0.5,'Antialiasing',false);

Perform antialiasing when shrinking an image, specified as the comma-separated pair consisting of 'Antialiasing' and true or false.

  • If method is nearest-neighbor ('nearest'), then the default value of 'Antialiasing' is false.

  • For all other interpolation methods, the default is true.

Data Types: logical

Return optimized colormap for indexed image X, specified as the comma-separated pair consisting of 'Colormap' and one of the following.

  • 'original' — The output colormap newmap is the same as the input colormap map.

  • 'optimized'imresize returns a new optimized colormap.

This argument is valid only when resizing indexed images.

Data Types: char | string

Perform color dithering, specified as the comma-separated pair consisting of 'Dither' and true or false. In dithering, you apply a form of noise to the image to randomize quantization error and prevent large-scale patterns.

This argument is valid only when resizing indexed images, X.

Data Types: logical

Interpolation method, specified as the comma-separated pair consisting of 'Method' and a scalar string, character vector, or 2-element cell array. For details, see method.

Data Types: char | string | cell

Size of the output image, specified as the comma-separated pair consisting of 'OutputSize' and a 2-element numeric vector of the form [numrows numcols].

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Resize scale factor, specified as the comma-separated pair consisting of 'Scale' and a positive number or 2-element vector of positive numbers.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Output Arguments

collapse all

Resized image, returned as a numeric or logical array of the same class as the input image, I.

If the image is resized using a GPU, then J is returned as a gpuArray containing a numeric array.

Resized indexed image, returned as a numeric array of the same class as the input indexed image, X.

Optimized colormap, returned as an c-by-3 numeric array.

Tips

  • The function imresize changed in version 5.4 (R2007a). Previous versions of the Image Processing Toolbox™ used a different algorithm by default. If you need the same results produced by the previous implementation, use the function imresize_old.

  • There is a slight numerical difference between the results of imresize on the CPU and the GPU. These differences occur on the right and bottom borders of the image and are barely noticeable to the naked eye.

  • If the size of the output image is not an integer, then imresize does not use the scale specified. imresize uses ceil when calculating the output image size.

Extended Capabilities

Introduced before R2006a