このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
insertObjectAnnotation
トゥルーカラー イメージ、グレースケール イメージ、またはビデオへの注釈付け
説明
例
イメージをワークスペースに読み取ります。
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 で表示されるように設定します。これらの値は、米国の通貨をそれぞれニッケル (5 セント硬貨) とダイム (10 セント硬貨) の形式で表すものです。
label = [5 10];
イメージに注釈を挿入します。
RGB = insertObjectAnnotation(I,"circle",position,label,LineWidth=3,AnnotationColor=["cyan","yellow"],FontColor="black");
注釈付きのイメージを表示します。
figure
imshow(RGB)
title("Annotated Coins")
入力引数
入力イメージ。M×N×3 のトゥルーカラー イメージまたは M 行 N 列のグレースケール イメージとして指定します。
データ型: single | double | int16 | uint8 | uint16
注釈の形状。"rectangle"、"circle"、"projected-cuboid"、または "ellipse" として指定します。"rectangle" の注釈を指定する場合は、軸方向に整列したまたは回転した四角形の位置を指定します。
データ型: char | string
形状の位置。次の表に示すように、形状のタイプに従って指定します。
| 形状 | 位置 | 定義 |
|---|---|---|
| 1 つ以上の軸に揃えられた四角形または塗りつぶされた四角形の場合、M 行 4 列の数値行列として指定します。ここで、各行は 形式の四角形を指定します。
| |
| 1 つ以上の回転した四角形の場合、空間座標で M 行 5 列の数値行列として指定します。ここで、各行は [xctr yctr w h yaw] 形式の回転した四角形を指定します。
|  | |
| 1 つ以上の円の場合、空間座標を M 行 3 列の数値行列として指定します。ここで、各行は [xctr yctr radius] 形式の円を指定します。
| |
ellipse | 1 つ以上の楕円の場合、空間座標で M 行 5 列の行列として指定します。ここで、各行は [xctr yctr major minor yaw] 形式の楕円を指定します。
| |
projected-cuboid | 1 つ以上の投影された直方体の場合、空間座標で 8×2×M の配列または M 行 8 列の行列として指定します。ここで、M は投影された直方体の数です。 8×2×M の配列として指定する場合、各行には投影された直方体の頂点の位置 [x y] が含まれていなければなりません。頂点が繋がって 6 つの面をもつ直方体を形成します。入力頂点の順序は、図に示されている順序と一致しなければなりません。 M 行 8 列の行列として指定する場合、各行は投影された直方体の前面と背面の寸法を [x1 y1 w1 h1 x2 y2 w2 h2] の形式で指定します。ここで、[x1 y1] と [x2 y2] はそれぞれ前面と背面の左上の座標を指定し、[w1 h1] と [w2 h2] は対応する幅と高さを指定します。 |
|
データ型: single | double | cell | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
形状に関連付けるラベル。M 要素の数値ベクトル、string 配列、カテゴリカル ラベルのベクトル、または ASCII 文字ベクトルの cell 配列として指定します。文字ベクトル、string スカラー、またはカテゴリ ラベルを使用する場合は、それらを ASCII 文字として符号化しなければなりません。cell 配列を指定する場合、配列の長さは指定した形状の位置の数と同じでなければなりません。すべての形状に対する単一のラベルを、数値スカラー、string スカラー、またはスカラーのカテゴリカル ラベルを使用して指定できます。
例: [5 10] は、最初の形状にラベル 5 を付け、2 番目の形状にラベル 10 を付けます。
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
例: insertObjectAnnotation(I,"rectangle",position,label,FontSize=18); は、注釈の挿入に使用するフォント サイズを 18 に設定します。
R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。
例: insertObjectAnnotation(I,"rectangle",position,label,"FontSize","18"); は、注釈の挿入に使用するフォント サイズを 18 に設定します。
ラベル テキストのフォント フェース。文字ベクトルまたは string スカラーとして指定します。フォント フェースは、システムにインストールされている使用可能な TrueType フォントでなければなりません。システム上で使用可能なフォントの一覧を取得するには、MATLAB® コマンド プロンプトから関数 listTrueTypeFonts を使用します。
データ型: char | string
ラベル テキストのフォント サイズ。[8 200] の範囲の点に対応する整数として指定します。
データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
フォント カラー。色の省略名、色の名前、色名のベクトル、RGB 3 成分の 3 列の行列として指定します。
サポートされている色の表には範囲 [0, 1] で RGB 強度を掲載していますが、RGB 3 成分の指定は選択するデータ型の範囲で行わなければなりません。たとえば、この引数を uint8 の値の行列として指定する場合、各強度値を [0, 255] の範囲に変換しなければなりません。掲載されている強度値を uint8 データ型に変換するには、コード uint8(255*intensity) を使用します。ここで、intensity は、表に掲載されている RGB 3 成分の値です。
フォント文字列ごとに異なる色を指定したり、すべての文字列に 1 つの色を指定したりできます。すべての文字列に 1 つの色を指定するには、FontColor を色の名前または [R G B] ベクトルとして指定します。
データ型: logical | uint8 | uint16 | int16 | double | single
注釈の色。色の省略名、色の名前、色名のベクトル、RGB 3 成分の 3 列の行列として指定します。
サポートされている色の表には範囲 [0, 1] で RGB 強度を掲載していますが、RGB 3 成分の指定は選択するデータ型の範囲で行わなければなりません。たとえば、この引数を uint8 の値の行列として指定する場合、各強度値を [0, 255] の範囲に変換しなければなりません。掲載されている強度値を uint8 データ型に変換するには、コード uint8(255*intensity) を使用します。ここで、intensity は、表に掲載されている RGB 3 成分の値です。
マーカーごとに異なる色を指定したり、すべてのマーカーに 1 つの色を指定したりできます。すべてのマーカーに 1 つの色を指定するには、AnnotationColor を色の名前または [R G B] ベクトルとして指定します。
| 仕様 | 形式 | 例 |
|---|---|---|
| すべての形状 (またはマーカー) に 1 つの色を指定 | 色の省略名または色の名前 |
|
RGB 3 成分 |
| |
| 各形状 (またはマーカー) の色を指定 | 色名のベクトル |
|
RGB 3 成分の 3 列の行列 | [1 0 0 0 1 1 1 0 1 1 1 1]  |
サポートされている色を次の表に示します。
| 色名 | 省略名 | 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] |
|
データ型: cell | char | uint8 | uint16 | int16 | double | single
テキスト ラベル ボックスの背景の不透明度。[0, 1] の範囲のスカラーとして指定します。値 0 はラベル テキスト ボックスの背景を完全な透明としてレンダリングし、値 1 は完全な不透明としてレンダリングします。
データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
形状の境界線の幅。正の整数としてピクセル単位で指定します。
元の方向インジケーター。数値または logical の 1 (true) または 0 (false) として指定します。値 1 (true) では、境界ボックスの矢印の注釈を使用して、回転した四角形の元の方向を表示します。元の方向は回転角度ゼロとして定義されます。値 0 (false) では、矢印の注釈を表示しません。
この引数は、Shape が回転した四角形または楕円を記述する場合にのみ適用されます。
データ型: logical | integer
