insertObjectAnnotation

トゥルーカラー イメージ、グレースケール イメージ、またはビデオ ストリームに注釈を付ける

構文

RGB = insertObjectAnnotation(I,shape,position,label)

insertObjectAnnotation(I,"rectangle",position,label)

insertObjectAnnotation(I,"circle",position,label)

___ = insertObjectAnnotation(___,Name=Value)

説明

RGB = insertObjectAnnotation(I,shape,position,label) は、position で指定された場所の shape および label で注釈が付けられたトゥルーカラー イメージを返します。

insertObjectAnnotation(I,"rectangle",position,label) は、位置行列で示される位置に四角形とラベルを挿入します。

insertObjectAnnotation(I,"circle",position,label) は、位置行列で示される位置に円と対応するラベルを挿入します。

___ = insertObjectAnnotation(___,Name=Value) は、前の構文に加えて、名前と値の引数を 1 つ以上使用してオプションを指定します。たとえば、insertObjectAnnotation(I,"rectangle",position,label_str,FontSize=18) は、注釈のフォント サイズを 18 に設定します。

例

数値および文字列を使用したイメージへの注釈付け

イメージを読み取ります。

I = imread("board.tif");

浮動小数点数のラベルを作成します。信頼度の値ラベルに関連する浮動小数点数。

label_str = cell(3,1);
conf_val = [85.212 98.76 78.342];
for ii=1:3
    label_str{ii} = ['Confidence: ' num2str(conf_val(ii),'%0.2f') '%'];
end

[x y width height] の形式で四角形の位置を設定します。

position = [23 373 60 66;35 185 77 81;77 107 59 26];

ラベルを挿入します。

RGB = insertObjectAnnotation(I,"rectangle",position,label_str,TextBoxOpacity=0.9,FontSize=18);

注釈付きのイメージを表示します。

figure
imshow(RGB)
title("Annotated chips");

整数の数値を使用したイメージへの注釈付け

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

I = imread("coins.png");

円の形状のイメージ上の位置を設定します。最初の 2 つの値は (x,y) の中心を表し、3 番目の値は半径です。

position = [96 146 31;236 173 26];

整数 5 と 10 (米国セント) が表示されるようにラベルを設定します。

label = [5 10];

注釈を挿入します。

RGB = insertObjectAnnotation(I,"circle",position,label,LineWidth=3,Color=["cyan","yellow"],TextColor="black");

表示します。

figure
imshow(RGB)
title("Annotated coins");

入力引数

I — トゥルーカラー イメージまたはグレースケール イメージ

M x N x 3 のトゥルーカラー | M 行 N 列の 2 次元グレースケール イメージ

トゥルーカラー イメージまたはグレースケール イメージ。イメージまたはビデオ ストリームとして指定します。入力イメージは、M x N x 3 のトゥルーカラー イメージまたは M 行 N 列の 2 次元グレースケール イメージのいずれかです。

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

shape — 注釈の形状

"rectangle" | "circle" | "projected-cuboid"

注釈の形状。"rectangle" または "circle" として指定します。

データ型: char

position — 形状の位置

行列 | ベクトル | cell 配列

形状の位置。表に示す形状のタイプに従って指定します。

形状	位置	例
"rectangle"	1 つ以上の四角形の場合、M 行 4 列の行列を指定します。各行は四角形を $$\left[\begin{array}{cccc}x& y& width& height\end{array}\right]$$ として指定します。 $$\left[\begin{array}{cccc}{x}_1& y_1& widt{h}_1& heigh{t}_1\\ x_2& y_2& widt{h}_2& heigh{t}_2\\ ⋮& ⋮& ⋮& ⋮\\ x_M& y_M& widt{h}_M& heigh{t}_M\end{array}\right]$$	2 つの四角形。M=2
"circle"	M 行 3 列の行列。各行は円を $$\left[\begin{array}{ccc}x& y& radius\end{array}\right]$$ として指定するベクトルです。$$\left[\begin{array}{cc}x& y\end{array}\right]$$ 座標は円の中心を表します。 $$\left[\begin{array}{ccc}{x}_1& y_1& radiu{s}_1\\ x_2& y_2& radiu{s}_2\\ ⋮& ⋮& ⋮\\ x_M& y_M& radiu{s}_M\end{array}\right]$$
"projected-cuboid"	8×2×M の配列または M 行 8 列の行列。ここで、M は投影された直方体を指定します。 8×2×M の配列として指定する場合、各行には投影された直方体の頂点の位置 $$\left[\begin{array}{cc}x& y\end{array}\right]$$ が含まれていなければなりません。頂点は接続されて、6 つの面をもつ直方体を形成します。入力頂点の順序は、図に示されている順序と一致しなければなりません。 M 行 8 列の行列として指定された場合、各行は投影された直方体の前面と背面を次の形式で指定します。 $$\left[\begin{array}{cccccccc}x1& y1& w1& h1& x2& y2& w2& h2\end{array}\right]$$ ここで、[x1 y1] と [x2 y2] はそれぞれ前面と背面の左上の座標を指定し、[w1 h1] と [w2 h2] は、対応する幅と高さを指定します。

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

label — 形状に関連付けるラベル

M 要素の数値ベクトル | string | カテゴリカル ラベル | ASCII 文字ベクトルの cell 配列

形状に関連付けるラベル。M 数値ベクトル、string、カテゴリカル ラベル、または ASCII 文字ベクトルの cell 配列として指定します。文字、string またはカテゴリカル ラベルは ASCII 文字としてエンコードされていなければなりません。cell 配列の長さは形状の位置の数と等しくなければなりません。すべての形状に対するスカラー ラベルを数値スカラー、string または categorical として指定できます。

例: label = [5 10]。ここで、関数は最初の形状にラベル 5、2 番目の形状にラベル 10 のマークを付けます。

名前と値の引数

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用して名前と値の各ペアを区切り、Name を引用符で囲みます。

例: Color="white" では、ラベルのテキスト ボックスの色が白に設定されます。

Font — テキストのフォント フェース

"LucidaSansRegular" (既定値) | 文字ベクトル | string スカラー

テキストのフォント フェース。文字ベクトルとして指定します。フォント フェースは、システムにインストールされている使用可能な TrueType フォントでなければなりません。システムで使用可能なフォントの一覧を表示するには、MATLAB^® コマンド プロンプトで listTrueTypeFonts と入力します。

データ型: char

FontSize — ラベル テキストのフォント サイズ

12 (既定値) | [8 72] の範囲の整数

ラベル テキストのフォント サイズ。[8 72] の範囲の点に対応する整数として指定します。

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

LineWidth — 形状の境界線の幅

1 (既定値)

形状の境界線の幅。正のスカラー整数としてピクセル単位で指定します。

Color — 形状の色

"green" (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | string スカラー | string 配列 | M 行 3 列の行列

形状の色。文字ベクトル、文字ベクトルの cell 配列、ベクトル、または M 行 3 列の行列として指定します。形状ごとに異なる色を指定したり、すべての形状に 1 つの色を指定したりできます。カラー値は [0,255] の範囲で指定しなければなりません。[0,1] の範囲の値は、この関数で使用する前に値 255 でスケーリングしなければなりません。たとえば、[255 255 255].*colorvalue のようにします。

サポートされる色は、"blue"、"green"、"red"、"cyan"、"magenta"、"yellow"、"black"、および "white" です。

色	形式	例
すべての形状に 1 つの色を指定	string または文字の色の名前	"r" "red"
	1 行 3 列のベクトル (RGB 3 成分)	[255 0 0]
形状ごとに色を指定	M 要素ベクトル	["red","yellow","blue"]
	M 行 3 列の行列 (RGB 値のリスト)	255 0 0 255 0 0 0 255 255

データ型: cell | char | uint8 | uint16 | int16 | double | single

TextColor — テキスト ラベルのテキストの色

"black" (既定値) | 文字ベクトル | string スカラー | [R G B] ベクトル | cell 配列 | string 配列 | M 行 3 列の行列

テキスト ラベルのテキストの色。文字ベクトル、[R G B] ベクトル、cell 配列、または M 行 3 列の行列として指定します。すべてのテキストに 1 つの色を指定するには、このパラメーターを文字ベクトルまたは [R G B] ベクトルに設定します。各 M テキスト ラベルの色を指定するには、このパラメーターを M 文字ベクトルの cell 配列に設定します。または、注釈ごとに RGB 値の M 行 3 列の行列を指定できます。RGB 値は、入力イメージ データ型の範囲内でなければなりません。

サポートされる色は、"blue"、"yellow"、"green"、"cyan"、"red"、"magenta"、"black"、および "white" です。

データ型: char | uint8 | uint16 | int16 | double | single | cell

TextBoxOpacity — テキスト ラベル ボックスの背景の不透明度

0.6 (既定値) | [0 1] の範囲

テキスト ラベル ボックスの背景の不透明度。ラベル テキスト ボックスの背景の不透明度を定義するスカラーとして指定します。この値を 0 ～ 1 の範囲で指定します。

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

出力引数

RGB — 注釈付きのトゥルーカラー イメージまたはグレースケール イメージ

M x N x 3 のトゥルーカラー

注釈付きのトゥルーカラー イメージ。イメージまたはビデオ ストリームとして返されます。

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

拡張機能

C/C++ コード生成

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

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

• 入力イメージは範囲内になければなりません。可変サイズ配列の上限の指定 (MATLAB Coder)を参照してください。

• MATLAB コード生成における System object (MATLAB Coder)を参照してください。

バージョン履歴

R2012b で導入

R2022b: 投影された直方体の可視化

投影された直方体を可視化するためのサポートが追加されました。

参考

関数

• insertMarker | insertText | insertShape | insertObjectMask | cuboid2img

トピック

• 検出されたオブジェクトを可視化する関数の選択

×

例を開く

この例の変更されたバージョンがあります。編集された方の例を開きますか?

いいえ、変更されたバージョンを上書きします。 はい