imresize

调整图像大小

全页折叠

语法

B = imresize(A,scale)

B = imresize(A,[numrows numcols])

[Y,newmap] = imresize(X,map,___)

___ = imresize(___,method)

___ = imresize(___,Name,Value)

说明

示例

B = imresize(A,scale) 返回图像 B，它是将 A 的长宽大小缩放图像 scale 倍之后的图像。输入图像 A 可以是灰度图像、RGB 图像、二值图像或分类图像。

如果 A 有两个以上维度，则 imresize 只调整前两个维度的大小。如果 scale 介于 0 和 1 之间，则 B 小于 A。如果 scale 大于 1，则 B 大于 A。默认情况下，imresize 使用双三次插值。

示例

B = imresize(A,[numrows numcols]) 返回图像 B，其行数和列数由二元素向量 [numrows numcols] 指定。

示例

[Y,newmap] = imresize(X,map,___) 调整索引图像 X 的大小，其中 map 是与该图像关联的颜色图。

示例

___ = imresize(___,method) 指定使用的插值方法。

___ = imresize(___,Name,Value) 返回调整大小后的图像，其中名称-值参量控制大小调整操作的各个方面。在所有其他输入参量之后指定名称-值参量。

示例

全部折叠

使用默认插值方法将图像的长宽缩小二分之一

打开实时脚本

将图像加载到工作区。

I = imread('ngc6543a.jpg');

将图像的长宽缩小二分之一。

J = imresize(I, 0.5);

显示原始图像和调整大小后的图像。

figure, imshow(I), figure, imshow(J)

使用最近邻点插值缩小图像

打开实时脚本

将图像加载到工作区。

I = imread('ngc6543a.jpg');

使用最近邻点插值将图像缩小到原始大小的 40%。这是最快的方法，但质量最差。

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

显示原始图像和调整大小后的图像。

imshow(I)
title('Original Image')

imshow(J)
title('Resized Image Using Nearest Neighbor Interpolation')

通过指定输出图像的大小调整 RGB 图像的大小

打开实时脚本

将 RGB 图像读取到工作区。

RGB = imread('peppers.png');

将 RGB 图像的大小调整为 64 行。imresize 会自动计算列数。

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

获取调整大小后的图像的大小。

sz = size(RGB2)

sz = 1×3

    64    86     3

显示原始图像和调整大小后的图像。

imshow(RGB)
title("Original Image")

imshow(RGB2)
title("Resized Image with 64 Rows")

调整索引图像的大小

打开实时脚本

将索引图像读取到工作区。

[X,map] = imread("corn.tif");

将索引图像的大小增大 50%。

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

显示原始图像和调整大小后的图像。

imshow(X,map)
title("Original Indexed Image and Colormap")

imshow(Y,newmap)
title("Resized Image and Optimized Colormap")

输入参数

全部折叠

`A` — 要调整大小的图像
数值数组 | 逻辑数组 | 分类数组

要调整大小的图像，指定为任意维度的数值数组、逻辑数组或分类数组。输入必须为非稀疏的，数值输入必须为实数。

`scale` — 大小调整因子
正数

大小调整因子，指定为正数。imresize 对行和列维度应用相同的缩放因子。要对每个维度应用不同的大小调整因子，请使用 Scale 名称-值参量。

如果您指定的大小调整因子不会产生整数长度的图像维度，则 imresize 会在调整大小操作后调用 ceil 函数。换句话说，输出图像有 ceil(scale*size(A,1)) 行和 ceil(scale*size(A,2)) 列。

`[numrows numcols]` — 输出图像的行和列维度
由正数组成的二元素向量

输出图像的行和列维度，指定为由正数组成的二元素向量。您可以为 numrows 或 numcols 指定 NaN 值。在这种情况下，imresize 会自动计算该维度的行数或列数，同时保持图像的纵横比。

`X` — 要调整大小的索引图像
实数非稀疏数值数组

要调整大小的索引图像，指定为由正整数组成的实数非稀疏数值数组。

数据类型: double | uint8 | uint16

`map` — 与索引图像关联的颜色图
c×3 数值矩阵

与索引图像 X 相关联的颜色图，指定为由范围 [0, 1] 内的值组成的 c×3 数值矩阵。每行是一个三元素 RGB 三元组，指定颜色图的单个颜色的红、绿和蓝分量。

数据类型: double

`method` — 插值方法
字符向量 | 字符串标量 | 二元素元胞数组

插值方法，指定为字符向量、字符串标量或二元素元胞数组。数值图像和逻辑图像的默认值为 "bicubic"。分类图像的默认值为 "nearest"。分类图像仅支持值 "nearest" 和 "box"。

当 method 是字符向量或字符串标量时，它标识下表中列出的特定方法或指定的插值核。

方法	描述
`"nearest"`	最近邻插值；赋给输出像素的值就是其输入点所在像素的值。不考虑其他像素。
`"bilinear"`	双线性插值；输出像素值是最近 2×2 邻域中的像素的加权平均值。
`"bicubic"`	双三次插值；输出像素值是最近 4×4 邻域中的像素的加权平均值。注意双三次插值可能生成在原始范围之外的像素值。
插值核	描述
`"box"`	盒形核
`"triangle"`	三角形核（等效于 `"bilinear"`）
`"cubic"`	三次方核（等效于 `"bicubic"`）
`"lanczos2"`	Lanczos-2 核
`"lanczos3"`	Lanczos-3 核

当 method 是二元素元胞数组时，用来定义自定义插值核。元胞数组的形式为 {f,w}，其中 f 是自定义插值核的函数句柄，w 是自定义核的宽度。f(x) 在区间 -w/2 <= x < w/2 外的值必须为零。函数句柄 f 可通过标量或向量输入进行调用。对于用户指定的插值核，输出图像可以有一些值稍微超出输入图像中的像素值范围。

有关内置和自定义插值核的详细信息，请参阅Create and Compare Resizing Interpolation Kernels。

数据类型: char | string | cell

名称-值参数

将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但参量对组的顺序无关紧要。

示例: B = imresize(A,0.5,Antialiasing=false) 在缩小图像时不执行抗锯齿操作。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: B = imresize(A,0.5,"Antialiasing",false) 在缩小图像时不执行抗锯齿操作。

`Antialiasing` — 缩小图像时执行抗锯齿操作
`true` | `false`

缩小图像时执行抗锯齿操作，指定为 true 或 false。

如果插值 method 为 "nearest"，则 Antialiasing 的默认值为 false。
如果插值 method 为 "box"，并且输入图像是分类图像，则 Antialiasing 的默认值为 false。
对于其他所有插值方法，默认值为 true。

数据类型: logical

`Colormap` — 返回优化的颜色图
`"optimized"` (默认) | `"original"`

返回索引图像的优化或原始颜色图，指定为以下值之一。

值	描述
`"original"`	输出颜色图 `newmap` 与输入颜色图 `map` 相同。
`"optimized"`	`imresize` 返回新的优化颜色图。

Colormap 参量仅在调整索引图像大小时有效。

数据类型: char | string

`Dither` — 执行颜色抖动
`true` (默认) | `false`

执行颜色抖动，指定为 true 或 false。执行抖动时，会对图像应用一种噪声，以使量化误差随机化并防止出现大范围色块。

Dither 参量仅在调整索引图像大小时有效。

数据类型: logical

`Method` — 插值方法
字符向量 | 字符串标量 | 元胞数组

插值方法，指定为字符向量、字符串标量或二元素元胞数组。有关详细信息，请参阅 method。

数据类型: char | string | cell

`OutputSize` — 输出图像的大小
由正数组成的二元素向量

输出图像的大小，指定为由正数组成的二元素向量。有关详细信息，请参阅 [numrows numcols]。

`Scale` — 大小调整缩放因子
正数 | 由正数组成的二元素向量

大小调整缩放因子，指定为正数或由正数组成的二元素向量。如果指定标量，则 imresize 对行维度和列维度应用相同的缩放因子。如果指定二元素向量，则 imresize 对每个维度应用不同的缩放值。

如果您指定的大小调整缩放因子不会产生整数长度的图像维度，则 imresize 会在调整大小操作后调用 ceil 函数。换句话说，输出图像有 ceil(Scale(1)*size(A,1)) 行和 ceil(Scale(2)*size(A,2)) 列。

输出参量

全部折叠

`B` — 调整大小后的图像
数值数组 | 逻辑数组 | 分类数组

调整大小后的图像，返回为与输入图像 A 的数据类型相同的数值、逻辑或分类数组。

`Y` — 调整大小后的索引图像
数值数组

调整大小后的索引图像，返回为与输入索引图像 X 的数据类型相同的数值数组。

`newmap` — 调整大小后的索引图像的颜色图
m×3 数值矩阵

调整大小后的索引图像 Y 的颜色图，以 m×3 数值矩阵形式返回。默认情况下，imresize 返回经过优化的新颜色图和已调整大小的图像。要返回与原始颜色图相同的颜色图，请使用 Colormap 名称-值参量。

扩展功能

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

用法说明和限制：

不支持用于索引图像的语法，包括名称-值参量 Colormap 和 Dither。
不支持自定义插值核。
所有名称-值参量都必须为编译时常量。

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

用法说明和限制：

不支持 Colormap 和 Dither 名称-值参量。
不支持索引图像。
不支持自定义插值核。
所有名称-值对组都必须为编译时常量。
对于某些插值核，MATLAB^® 和生成代码之间的结果可能在数值上存在微小差异。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

此函数完全支持基于线程的环境。有关详细信息，请参阅在基于线程的环境中运行 MATLAB 函数。

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

用法说明和限制：

不支持超过 2²⁷ 个元素的 gpuArray 输入。
gpuArray 输入必须为非稀疏值。
不支持基础类型为 categorical 的 gpuArray 输入。
GPU 不支持索引图像。
如果使用双三次插值，输出图像可以有一些值稍微超出输入图像中的像素值范围。
在 CPU 和 GPU 上使用 imresize 的结果在数值上略有差异。这些差异出现在图像的右边界和下边界，肉眼几乎看不到。

有关详细信息，请参阅Run MATLAB Functions on a GPU (Parallel Computing Toolbox)。

版本历史记录

在 R2006a 之前推出

全部展开

R2019a: 支持分类图像

imresize 函数现在支持分类图像。

另请参阅

imresize3 (Image Processing Toolbox) | interp2

imresize

语法

说明

示例

使用默认插值方法将图像的长宽缩小二分之一

使用最近邻点插值缩小图像

通过指定输出图像的大小调整 RGB 图像的大小

调整索引图像的大小

输入参数

A — 要调整大小的图像 数值数组 | 逻辑数组 | 分类数组

scale — 大小调整因子 正数

[numrows numcols] — 输出图像的行和列维度 由正数组成的二元素向量

X — 要调整大小的索引图像 实数非稀疏数值数组

map — 与索引图像关联的颜色图 c×3 数值矩阵

method — 插值方法 字符向量 | 字符串标量 | 二元素元胞数组

名称-值参数

Antialiasing — 缩小图像时执行抗锯齿操作 true | false

Colormap — 返回优化的颜色图 "optimized" (默认) | "original"

Dither — 执行颜色抖动 true (默认) | false

Method — 插值方法 字符向量 | 字符串标量 | 元胞数组

OutputSize — 输出图像的大小 由正数组成的二元素向量

Scale — 大小调整缩放因子 正数 | 由正数组成的二元素向量

输出参量

B — 调整大小后的图像 数值数组 | 逻辑数组 | 分类数组

Y — 调整大小后的索引图像 数值数组

newmap — 调整大小后的索引图像的颜色图 m×3 数值矩阵

扩展功能

C/C++ 代码生成 使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

GPU 代码生成 使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

基于线程的环境 使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

GPU 数组 通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

版本历史记录

R2019a: 支持分类图像

另请参阅

主题

WeChat

`A` — 要调整大小的图像
数值数组 | 逻辑数组 | 分类数组

`scale` — 大小调整因子
正数

`[numrows numcols]` — 输出图像的行和列维度
由正数组成的二元素向量

`X` — 要调整大小的索引图像
实数非稀疏数值数组

`map` — 与索引图像关联的颜色图
c×3 数值矩阵

`method` — 插值方法
字符向量 | 字符串标量 | 二元素元胞数组

`Antialiasing` — 缩小图像时执行抗锯齿操作
`true` | `false`

`Colormap` — 返回优化的颜色图
`"optimized"` (默认) | `"original"`

`Dither` — 执行颜色抖动
`true` (默认) | `false`

`Method` — 插值方法
字符向量 | 字符串标量 | 元胞数组

`OutputSize` — 输出图像的大小
由正数组成的二元素向量

`Scale` — 大小调整缩放因子
正数 | 由正数组成的二元素向量

`B` — 调整大小后的图像
数值数组 | 逻辑数组 | 分类数组

`Y` — 调整大小后的索引图像
数值数组

`newmap` — 调整大小后的索引图像的颜色图
m×3 数值矩阵

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。