このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
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");
入力引数
I
— 入力イメージ
M×N×3 のトゥルーカラー イメージ | M 行 N 列のグレースケール イメージ
入力イメージ。M×N×3 のトゥルーカラー イメージまたは M 行 N 列のグレースケール イメージとして指定します。
データ型: single
| double
| int16
| uint8
| uint16
text
— Unicode テキスト文字ベクトル
文字ベクトル | string スカラー | 文字ベクトルの M 要素 cell 配列 | M 要素の string 配列
Unicode テキスト。文字ベクトル、string スカラー、文字ベクトルの M 要素 cell 配列、または M 要素の string 配列として指定します。M は、position
で指定するテキスト位置の数です。関数は、ピクセルを text
の値で上書きします。単一の string または文字ベクトルを指定すると、関数はそれを position
行列内のすべての位置に使用します。ほとんどの Unicode フォントには ASCII 文字が含まれます。1 つのフォントで、英語以外の文字と、数値を含む英語の文字を表示できます。
データ型: char
| string
| cell
position
— 挿入テキストの位置
M 行 2 列の行列
挿入テキストの位置。M 行 2 列の行列として指定します。M は指定するテキスト位置の数です。また、各行はテキスト ボックスの AnchorPoint
の xy 座標を指定します。
データ型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN
として指定します。ここで、Name
は引数名で、Value
は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
例: insertText(I,position,text,Font="Calibri")
はフォント フェースを Calibri
に設定します。
R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name
を引用符で囲みます。
例: insertText(I,position,text,"Font","Calibri")
はフォント フェースを Calibri
に設定します。
Font
— テキストのフォント フェース
"LucidaSansRegular"
(既定値) | 文字ベクトル | string スカラー
テキストのフォント フェース。文字ベクトルまたは string スカラーとして指定します。フォント フェースは、システムにインストールされている使用可能な TrueType フォントでなければなりません。システム上で使用可能なフォントの一覧を取得するには、MATLAB® コマンド プロンプトから関数 listTrueTypeFonts
を使用します。
データ型: char
| string
FontSize
— フォント サイズ
12
(既定値) | 範囲 [1, 200] の正の整数
フォント サイズ。範囲 [1, 200] の正の整数としてピクセル単位で指定します。
データ型: double
| single
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
FontColor
— フォント カラー
"green"
(既定値) | 色の省略名 | 色の名前 | 色名のベクトル | RGB 3 成分の 3 列の行列
フォント カラー。色の省略名、色の名前、色名のベクトル、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
TextBoxColor
— テキスト ボックスの色
"green"
(既定値) | 色の省略名 | 色の名前 | 色名のベクトル | RGB 3 成分の 3 列の行列
テキスト ボックスの色。色の省略名、色の名前、色名のベクトル、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
BoxOpacity
— テキスト ボックスの不透明度
0.6
(既定値) | [0
1
] の範囲のスカラー
テキスト ラベル ボックスの背景のテキスト ボックスの不透明度。[0, 1]
の範囲のスカラーとして指定します。値 0
はラベル テキスト ボックスの背景を完全な透明としてレンダリングし、値 1
は完全な不透明としてレンダリングします。
データ型: double
| single
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
AnchorPoint
— テキスト ボックスの基準点
"LeftTop"
(既定値) | "LeftCenter"
| "LeftBottom"
| "CenterTop"
| "Center"
| "CenterBottom"
| "RightTop"
| "RightCenter"
| "RightBottom"
テキスト ボックスの基準点。次の値のいずれかとして指定します。
"LeftTop"
"LeftCenter"
"LeftBottom"
"CenterTop"
"Center"
"CenterBottom"
"RightTop"
"RightCenter"
"RightBottom"
アンカー ポイントは、各テキスト ボックス上の相対位置を定義します。position
の対応する行で指定されたテキスト ボックスの配置を指定できます。たとえば、position
で指定された xy 座標にテキスト ボックスの中心を配置するには、AnchorPoint
を Center
に設定します。
データ型: char
| string
出力引数
RGB
— 出力イメージ
M×N×3 のトゥルーカラー イメージ
出力イメージ。指定のテキストが挿入された M×N× 3 のトゥルーカラー イメージとして返されます。
制限
出力イメージに文字が表示されない場合は、指定したフォントにその文字が含まれていません。異なるフォントを選択します。システムで使用可能なフォントの一覧を取得するには、MATLAB コマンド プロンプトで
listTrueTypeFonts
と入力します。フォント サイズを大きくすると、前処理の時間とメモリ使用量も増加します。
関数
insertText
は、特定の複合文字では機能しません。たとえば、文字コードに対応する 1 つのグリフをレンダリングすると、隣接するグリフの位置、形状またはサイズに影響する場合、テキストを挿入することはできません。
拡張機能
C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。
使用上の注意および制限:
Font
およびFontSize
はコンパイル時の定数でなければなりません。非 ASCII 文字はサポートされません。
コード生成には C++ コンパイラが必要です。サポートされているコンパイラの一覧については、Supported and Compatible Compilers を参照してください。
バージョン履歴
R2013a で導入R2023b: [0,1] の範囲での RGB カラー指定
R2023b 以降、マーカーの色の RGB 値を [0,1] の範囲で指定できるようになりました。
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)