imoverlay

バイナリ イメージを 2 次元イメージに書き込む

構文

B = imoverlay(A,BW)

B = imoverlay(A,BW,color)

説明

B = imoverlay(A,BW) は、グレースケールまたは RGB イメージ A に対して、入力バイナリ マスク BW が true となる場所を単色で塗りつぶします。

B = imoverlay(A,BW,color) は、imoverlay がイメージの塗りつぶしに使用する色を指定します。

例

バイナリ イメージをグレースケール イメージに書き込む

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

A = imread('cameraman.tif');

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

BW = imread('text.png');

バイナリ マスクに使用する色を指定して、バイナリ イメージをグレースケール イメージに書き込みます。

B = imoverlay(A,BW,'yellow');

結果を表示します。

imshow(B)

バイナリ イメージを RGB イメージに書き込む

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

RGB = imread('peppers.png');

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

BW = imread('text.png');

RGB イメージをトリミングして、バイナリ マスクと同じサイズにします。

RGB_cropped = imcrop(RGB,[64,128,255,255]);

使用する色を選択して、バイナリ イメージをトリミング後の RGB イメージに書き込みます。

B = imoverlay(RGB_cropped,BW,'red');

結果を表示します。

figure
imshow(B)

入力引数

A — 入力イメージ

2 次元グレースケール イメージ | 2 次元 RGB イメージ

入力イメージ。2 次元グレースケール イメージまたは 2 次元 RGB イメージとして指定します。

データ型: single | double | int16 | uint8 | uint16 | logical

BW — マスク イメージ

2 次元バイナリ行列 | 2 次元数値行列

マスク イメージ。イメージ A の最初の 2 つの次元と同じサイズの、2 次元バイナリ行列または 2 次元数値行列として指定します。数値入力の場合、非ゼロのピクセルは 1 (true) であると見なされます。

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

color — 重ね書きに使用される色

"yellow" (既定値) | RGB 3 成分 | 色名 | 色の省略名

オーバーレイに使用する色。RGB 3 成分、色の名前、または色の省略名として指定します。

RGB 3 成分を使用すると、任意の色を指定できます。RGB 3 成分は、色の赤、緑、青の成分の強度を指定する 3 つの要素から成る行ベクトルです。強度は [0, 1] の範囲でなければなりません。

いくつかの一般的な色については、色の名前を string スカラーまたは文字ベクトルとして指定できます。次の表に、名前付きの色のオプション、およびそれと等価な RGB 3 成分を示します。

色名	省略名	RGB 3 成分	外観
"red"	"r"	[1 0 0]
"green"	"g"	[0 1 0]
"blue"	"b"	[0 0 1]
"cyan"	"c"	[0 1 1]
"magenta"	"m"	[1 0 1]
"yellow"	"y"	[1 1 0]
"black"	"k"	[0 0 0]
"white"	"w"	[1 1 1]

次の表に、ライト テーマとダーク テーマにおけるプロットの既定のカラー パレットを示します。

パレット	パレット カラー
"gem" — ライト テーマの既定 R2025a より前: ほとんどのプロットでは既定でこれらの色が使用されます。
"glow" — ダーク テーマの既定

orderedcolors 関数を使用して、これらのパレットの RGB 3 成分を取得できます (R2023b 以降)。たとえば、"gem" パレットの RGB 3 成分を取得します。

RGB = orderedcolors("gem");

例: "r"

例: "green"

例: [0 0.4470 0.7410]

出力引数

B — 出力イメージ

2 次元 RGB イメージ

出力イメージ。2 次元 RGB イメージとして返されます。

データ型: uint8

拡張機能

C/C++ コード生成

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

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

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

• コード生成時、color を string または文字ベクトルとして指定した場合、その値はコンパイル時の定数でなければなりません。

GPU コード生成

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

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

• コード生成時、color を string または文字ベクトルとして指定した場合、その値はコンパイル時の定数でなければなりません。

バージョン履歴

R2016a で導入

参考

imblend | superpixels | boundarymask | labeloverlay