このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
insertText
イメージまたはビデオへのテキストの挿入
構文
説明
例
イメージをワークスペースに読み取ります。
I = imread("board.tif");小数を含むテキスト文字列を作成します。
text_str = cell(3,1); conf_val = [85.212 98.76 78.342]; for ii = 1:3 text_str{ii} = ['Confidence: ' num2str(conf_val(ii), '%0.2f') '%']; end
テキスト ボックスの位置と色を定義します。
position = [23 373; 35 185; 77 107];
box_color = {"red","green","yellow"};対応するボックスの色を指定して各テキスト文字列を挿入し、すべての文字列のフォント サイズ、不透明度、テキストの色を指定します。
RGB = insertText(I,position,text_str,FontSize=18,TextBoxColor=box_color, ... BoxOpacity=0.4,TextColor="white");
注釈付きのイメージを表示します。
figure
imshow(RGB)
title("Board")
イメージをワークスペースに読み取ります。
I = imread("peppers.png");数値とその xy 位置を定義します。
position = [1 50; 100 50]; value = [555 pi];
各テキスト ボックスの左下隅をアンカー ポイントとして使用して、数値を挿入します。
RGB = insertText(I,position,value,AnchorPoint="LeftBottom");数値が挿入されたイメージを表示します。
figure
imshow(RGB)
title("Numeric Values")
Unicode U+014C をイメージに挿入します。
OWithMacron = native2unicode([hex2dec("C5") hex2dec("8C")],"UTF-8"); RGB = insertText(RGB,[256 50],OWithMacron,font="LucidaSansRegular",TextBoxColor="white");
Unicode 文字が挿入されたイメージを表示します。
figure
imshow(RGB)
title("Numeric Values");
入力引数
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
例: insertText(I,position,text,Font="Calibri") はフォント フェースを Calibri に設定します。
R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。
例: insertText(I,position,text,"Font","Calibri") はフォント フェースを Calibri に設定します。
テキストのフォント フェース。文字ベクトルまたは string スカラーとして指定します。フォント フェースは、システムにインストールされている使用可能な TrueType フォントでなければなりません。システム上で使用可能なフォントの一覧を取得するには、MATLAB® コマンド プロンプトから関数 listTrueTypeFonts を使用します。
データ型: char | string
フォント サイズ。範囲 [1, 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] ベクトルとして指定します。
| 仕様 | 形式 | 例 |
|---|---|---|
| すべての形状 (またはマーカー) に 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] |
|
データ型: 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 つの色を指定するには、FontColor を色の名前または [R G B] ベクトルとして指定します。
データ型: logical | uint8 | uint16 | int16 | double | single
テキスト ラベル ボックスの背景のテキスト ボックスの不透明度。[0, 1] の範囲のスカラーとして指定します。値 0 はラベル テキスト ボックスの背景を完全な透明としてレンダリングし、値 1 は完全な不透明としてレンダリングします。
データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
テキスト ボックスの基準点。次の値のいずれかとして指定します。
"LeftTop""LeftCenter""LeftBottom""CenterTop""Center""CenterBottom""RightTop""RightCenter""RightBottom"
アンカー ポイントは、各テキスト ボックス上の相対位置を定義します。position の対応する行で指定されたテキスト ボックスの配置を指定できます。たとえば、position で指定された xy 座標にテキスト ボックスの中心を配置するには、AnchorPoint を Center に設定します。
データ型: char | string
出力引数
制限
出力イメージに文字が表示されない場合は、指定したフォントにその文字が含まれていません。異なるフォントを選択します。システムで使用可能なフォントの一覧を取得するには、MATLAB コマンド プロンプトで
listTrueTypeFontsと入力します。フォント サイズを大きくすると、前処理の時間とメモリ使用量も増加します。
関数
insertTextは、特定の複合文字では機能しません。たとえば、文字コードに対応する 1 つのグリフをレンダリングすると、隣接するグリフの位置、形状またはサイズに影響する場合、テキストを挿入することはできません。
