このページは前リリースの情報です。該当の英語のページはこのリリースで削除されています。

imresize

イメージのサイズ変更

構文

J = imresize(I,scale)

J = imresize(I,[numrows numcols])

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

___ = imresize(___,method)

___ = imresize(___,Name,Value)

説明

J = imresize(I,scale) は、I のサイズの scale 倍のイメージ J を返します。入力イメージ I には、グレースケール イメージ、RGB イメージ、バイナリ イメージ、または categorical イメージを指定できます。

J = imresize(I,[numrows numcols]) は、ベクトル [numrows numcols] で指定された行数と列数を持つイメージ J を返します。

[Y,newmap] = imresize(X,map,___) はカラーマップ map を使用してインデックス付きイメージ X をサイズ変更します。既定の設定では、imresize は、サイズ変更されたインデックス付きイメージとともに最適化されたカラーマップ newmap を返します。元のカラーマップと同じカラーマップを返す場合は、名前と値のペアの引数 Colormap を使用します。

___ = imresize(___,method) は使用する内挿法を指定します。

___ = imresize(___,Name,Value) は、サイズ変更操作のさまざまな特性を制御する名前と値のペアの引数を使用します。

例

倍率の指定によるイメージのサイズ変更

イメージをワークスペースに読み取ります。

I = imread('rice.png');

倍率を指定し、既定の内挿法およびアンチエイリアス処理を使用してイメージをサイズ変更します。

J = imresize(I, 0.5);

元のイメージとサイズ変更されたイメージを表示します。

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

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

倍率と内挿法の指定によるイメージのサイズ変更

イメージをワークスペースに読み取ります。

I = imread('rice.png');

倍率と内挿法を指定してイメージをサイズ変更します。

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

元のイメージとサイズ変更されたイメージを表示します。

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

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

インデックス付きイメージのサイズ変更

イメージをワークスペースに読み取ります。

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

倍率を指定してイメージをサイズ変更します。既定の設定では、imresize は、サイズ変更されたインデックス付きイメージとともに最適化されたカラーマップを返します。

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

元のイメージとサイズ変更されたイメージを表示します。

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

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

出力イメージのサイズの指定による RGB イメージのサイズ変更

イメージをワークスペースに読み取ります。

RGB = imread('peppers.png');

出力イメージを 64 行にするように指定してイメージをサイズ変更します。縦横比を維持するのに必要な列数を、imresize で計算します。

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

元のイメージとサイズ変更されたイメージを表示します。

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

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

入力引数

I — サイズを変更するイメージ

数値配列 | logical 配列 | categorical 配列

サイズを変更するイメージ。任意の次元の数値配列、logical 配列、categorical 配列として指定します。I が 2 次元より大きい場合、imresize は最初の 2 次元のサイズのみを変更します。

データ型: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | logical | categorical

scale — サイズ変更係数

正の数値

サイズ変更係数。正の数値として指定します。

• scale が 1 より小さい場合、出力イメージは入力イメージより小さくなります。

• scale が 1 より大きい場合、出力イメージは入力イメージより大きくなります。

imresize はイメージの各次元に倍率を適用します。次元ごとに異なるサイズ変更係数を適用するには、代わりに Scale の名前と値のペアの引数を使用します。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

[numrows numcols] — 出力イメージの行と列の次元

正の整数の 2 要素ベクトル

出力イメージの行と列の次元。正の整数の 2 要素ベクトルとして指定します。numrows または numcols のいずれかに値 NaN を指定できます。この場合、imresize は、イメージの縦横比を保ちながら、その次元の行数または列数を自動的に計算します。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

X — サイズを変更するインデックス付きイメージ

数値配列

サイズを変更するインデックス付きイメージ。数値配列として指定します。

データ型: double | uint8 | uint16

map — カラーマップ

c 行 3 列の数値行列

インデックス付きイメージ X に関連付けられたカラーマップ。範囲 [0, 1] の値をもつ c 行 3 列の数値行列として指定します。各行は、カラーマップの単一色を構成する赤、緑、青の成分を指定する 3 要素の RGB 3 成分です。

データ型: double

method — 内挿法またはカーネル

string スカラー | 文字ベクトル | 2 要素 cell 配列

内挿法またはカーネル。string スカラー、文字ベクトルまたは 2 要素 cell 配列として指定します。

method が string スカラーまたは文字ベクトルの場合、次の表に示される特定のメソッドまたは名前付き内挿カーネルを識別します。

メソッド	説明
'nearest'	最近傍内挿。出力ピクセル値として、対象となる位置の中に存在している値を割り当てます。周りの他のピクセルは、考慮に入れません。 最近傍内挿は、categorical イメージでサポートされている唯一の内挿法であり、このタイプのイメージに対する既定のメソッドです。
'bilinear'	双一次内挿。出力ピクセル値は、最近傍の 2 行 2 列のピクセルの重み付き平均です。
'bicubic'	双三次内挿。出力ピクセル値は、最近傍の 4 行 4 列のピクセルの重み付き平均です。双三次内挿は、数値イメージと論理イメージに対する既定のメソッドです。 メモ 双三次内挿は、元の範囲外のピクセル値を生成します。
内挿カーネル	説明
'box'	箱型のカーネル 箱型のカーネルは、categorical イメージでサポートされている唯一の内挿カーネルです。
'triangle'	三角のカーネル ('bilinear' と等価)
'cubic'	3 次カーネル ('bicubic' と等価)
'lanczos2'	Lanczos-2 カーネル
'lanczos3'	Lanczos-3 カーネル

method が 2 要素 cell 配列の場合、カスタム内挿カーネルを定義します。cell 配列の形式は {f,w} で、f はカスタム内挿カーネルの関数ハンドル、w はカスタム カーネルの幅です。f(x) は -w/2 <= x < w/2 の区間外はゼロでなければなりません。関数ハンドル f は、スカラーまたはベクトル入力で呼び出すことができます。ユーザー指定の内挿カーネルの場合、出力イメージのいくつかの値が、入力イメージのピクセル値の範囲からわずかに外れる可能性があります。

データ型: char | string | cell

名前と値のペアの引数

オプションの引数 Name,Value のコンマ区切りペアを指定します。Name は引数名で、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を、任意の順番で指定できます。

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

Antialiasing — イメージ縮小時のアンチエイリアシングの実行

true | false

イメージ縮小時のアンチエイリアシングの実行。'Antialiasing' と true または false で構成されるコンマ区切りのペアとして指定します。

• method が 'nearest' の場合、'Antialiasing' の既定値は false になります。

• 内挿 method が 'box' 内挿カーネルで、入力イメージがカテゴリカルの場合、'Antialiasing' の既定値は false になります。

• その他すべての内挿法の場合、既定値は true です。

データ型: logical

Colormap — 最適化されたカラーマップまたは元のカラーマップの出力

'optimized' (既定値) | 'original'

インデックス付きイメージの最適化されたカラーマップまたは元のカラーマップの出力。'Colormap' と次のいずれかから構成されるコンマ区切りのペアとして指定します。

値	説明
'original'	出力カラーマップ newmap は入力カラーマップ map と同じになります。
'optimized'	imresize は新たに最適化されたカラーマップを返します。

'Colormap' 引数は、インデックス付きイメージのサイズを変更する場合のみ有効です。

データ型: char | string

Dither — カラー ディザリングの実行

true (既定値) | false

カラー ディザリングの実行。'Dither' と true または false で構成されるコンマ区切りのペアとして指定します。ディザリングでは、量子化誤差のランダム化や大規模パターンの回避のために、一種のノイズをイメージに適用します。

'Dither' 引数は、インデックス付きイメージのサイズを変更する場合のみ有効です。

データ型: logical

Method — 内挿法

string スカラー | 文字ベクトル | 2 要素 cell 配列

内挿法。'Method' と string スカラー、文字ベクトルまたは 2 要素 cell 配列から構成されるコンマ区切りのペアとして指定します。詳細については、method を参照してください。

データ型: char | string | cell

OutputSize — 出力イメージのサイズ

正の整数の 2 要素ベクトル

出力イメージのサイズ。'OutputSize' と [numrows numcols] 形式の正の整数の 2 要素ベクトルで構成されるコンマ区切りのペアとして指定します。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Scale — サイズ変更の倍率

正の数値 | 正の数値の 2 要素ベクトル

サイズ変更の倍率。'Scale' と正の数値または正の数値の 2 要素ベクトルで構成されるコンマ区切りのペアとして指定します。スカラーを指定する場合、imresize はイメージの各次元に同じ倍率を適用します。2 要素ベクトルを指定する場合、imresize は各次元に異なるスケール値を適用します。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

出力引数

J — サイズ変更されたイメージ

数値配列 | logical 配列 | categorical 配列

サイズ変更されたイメージ。入力イメージ I と同じクラスの数値配列、logical 配列、または categorical 配列として返されます。

Y — サイズ変更されたインデックス付きイメージ

数値配列

サイズ変更されたインデックス付きイメージ。入力インデックス付きイメージ X と同じクラスの数値配列として返されます。

newmap — 最適化されたカラーマップ

c 行 3 列の数値配列

最適化されたカラーマップ。範囲 [0, 1] の値をもつ c 行 3 列の数値行列として返されます。各行は、カラーマップの単一色を構成する赤、緑、青の成分を指定する 3 要素の RGB 3 成分です。

ヒント

• 関数 imresize は Version 5.4 (R2007a) で変更されました。以前のバージョンの Image Processing Toolbox™ は、既定の設定では異なるアルゴリズムを使用していました。以前の実装時と同じ結果を得る必要がある場合、関数 imresize_old を使用してください。

• 出力イメージのサイズが整数にならない場合、imresize は指定されたスケールを使用しません。出力イメージのサイズを計算する際、imresize は ceil を使用します。

拡張機能

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意および制限:

• imresize では C コードの生成がサポートされています (MATLAB^® Coder™ が必要)。詳細については、イメージ処理のコード生成を参照してください。

• 名前付きパラメーターの 'Colormap' や 'Dither' など、インデックス付きイメージに対応する構文はサポートされていません。

• カスタム内挿カーネルはサポートされません。

• すべての名前と値のペアの引数はコンパイル時の定数でなければなりません。

GPU コード生成

GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

使用上の注意および制限:

• 'Colormap' および 'Dither' の名前と値のペアの引数はサポートされません。

• インデックス付きイメージはサポートされません。

• カスタム内挿カーネルはサポートされません。

• すべての名前と値のペアはコンパイル時の定数でなければなりません。

• 特定の内挿カーネルでは、MATLAB と生成コードの結果間で小さな数値の不一致が発生する可能性があります。

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

使用上の注意および制限:

• 2²⁷ 要素を超える gpuArray 入力はサポートされません。

• gpuArray 入力は非スパースでなければなりません。

• 基となる型が categorical の gpuArray 入力はサポートされません。

• GPU では、インデックス付きイメージはサポートされません。

• 双三次内挿を使用する場合、出力イメージのいくつかの値が、入力イメージのピクセル値の範囲からわずかに外れる可能性があります。

• imresize は、CPU と GPU での結果にわずかな数値の差があります。これらの差はイメージの右と下の境界線上に生じ、肉眼ではほとんど確認できないものです。

詳細については、GPU でのイメージ処理を参照してください。

参考

imrotate | imresize3 | imtransform | tformarray | interp2

トピック

• ツールボックスでのイメージ タイプ

R2006a より前に導入