このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。
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,'BoxColor',... box_color,'BoxOpacity',0.4,'TextColor','white');
イメージを表示します。
figure
imshow(RGB)
title('Board');
イメージへの数値テキストの挿入
イメージを読み取ります。
I = imread('peppers.png');
テキストと値の ( x,_y_ ) 位置を定義します。
position = [1 50; 100 50]; value = [555 pi];
左下をアンカー ポイントとして使用してテキストを挿入します。
RGB = insertText(I,position,value,'AnchorPoint','LeftBottom');
数値テキストが挿入されたイメージを表示します。
figure
imshow(RGB),title('Numeric values');
非 ASCII 文字 (U+014C) を表示します。
OWithMacron=native2unicode([hex2dec('C5') hex2dec('8C')],'UTF-8'); RGB = insertText(RGB,[256 50],OWithMacron,'Font','LucidaSansRegular','BoxColor','w');
数値テキストが挿入されたイメージを表示します。
figure
imshow(RGB),title('Numeric values');
入力引数
I
— 入力イメージ
M x N x 3 のトゥルーカラー | M 行 N 列の 2 次元グレースケール イメージ
入力イメージ。M x N x 3 のトゥルーカラー イメージ、または M 行 N 列の 2 次元グレースケール イメージとして指定します。
データ型: single
| double
| int16
| uint8
| uint16
text
— Unicode テキスト文字ベクトル
文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列
Unicode テキスト。1 つの UNICODE テキスト文字列、または長さ M の UNICODE 文字列の cell 配列として指定します。ここで、M は position
の行数です。関数は、ピクセルを text
の値で上書きします。cell 配列の長さと position
行列の行数は等しくなければなりません。1 つの文字列を指定すると、関数はそれを position
行列のすべての位置に対して使用します。ほとんどの Unicode フォントには ASCII 文字が含まれます。1 つのフォントで、英語以外の文字と、数値を含む英語の文字を表示できます。
データ型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
position
— 挿入テキストの位置
ベクトル | 行列
挿入テキストの位置。ベクトルまたは [x y] 座標の M 行 2 列の行列として指定します。各行は、テキストの境界ボックスの AnchorPoint
の [x y] 座標を表します。
データ型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
名前と値の引数
例: 'AnchorPoint'
,'LeftTop'
オプションの引数 Name,Value
のコンマ区切りペアを指定します。Name
は引数名で、Value
は対応する値です。Name
は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN
のように、複数の名前と値のペアの引数を、任意の順番で指定できます。
Font
— テキストのフォント フェース
'LucidaSansRegular'
(既定値) | 文字ベクトル
テキストのフォント フェース。'Font
' と文字ベクトルで構成されるコンマ区切りのペアとして指定します。フォント フェースは、システムにインストールされている使用可能な TrueType フォントでなければなりません。システムで使用可能なフォントの一覧を表示するには、MATLAB® コマンド プロンプトで listTrueTypeFonts
と入力します。
データ型: char
FontSize
— フォント サイズ
12
(既定値) | [1,200] の範囲の正の整数
フォント サイズ。'
FontSize
'
と [1,200] の範囲の正の整数で構成されるコンマ区切りのペアとして指定します。
データ型: double
| single
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
TextColor
— テキストの色
'black
' (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | [R G B] ベクトル | M 行 3 列の行列
テキストの色。'
TextColor
'
と文字ベクトル、文字ベクトルの cell 配列、または行列で構成されるコンマ区切りのペアとして指定します。文字ベクトルごとに異なる色を指定したり、すべての文字ベクトルに 1 つの色を指定したりできます。
テキスト文字ベクトルごとに色を指定するには、
TextColor
を M 個の色を表す文字ベクトルの cell 配列に設定します。または、文字ベクトルの RGB カラー値の M 行 3 列の行列に設定できます。すべてのテキスト文字ベクトルに 1 つの色を指定するには、
TextColor
を色を表す文字ベクトル、または赤、緑および青の値の [R G B] ベクトルに設定します。RGB 値は、イメージ データ型の範囲内でなければなりません。サポートされる色は、
'blue'
、'green'
、'red'
、'cyan'
、'magenta'
、'yellow'
、'black'
および'white'
です。
データ型: cell
| char
| uint8
| uint16
| int16
| double
| single
BoxColor
— テキスト ボックスの色
'yellow
' (既定値) | 文字ベクトル | 文字ベクトルの cell 配列 | [R G B] ベクトル | M 行 3 列の行列
テキスト ボックスの色。'
BoxColor
'
と文字ベクトル、文字ベクトルの cell 配列、または行列で構成されるコンマ区切りのペアとして指定します。テキスト ボックスごとに異なる色を指定したり、すべてのテキスト ボックスに 1 つの色を指定したりできます。
テキスト ボックスごとに色を指定するには、
BoxColor
を M 個の色を表す文字ベクトルの cell 配列に設定します。または、M 個の RGB (赤、緑、青) 文字ベクトルの色値の M 行 3 列の行列に設定できます。すべてのテキスト ボックスに 1 つの色を指定するには、
BoxColor
を色を表す文字ベクトルまたは [R G B] ベクトルに設定します。[R G B] ベクトルには、赤、緑、青の値が含まれます。RGB 値は、イメージ データ型の範囲内でなければなりません。サポートされる色は、
'blue'
、'green'
、'red'
、'cyan'
、'magenta'
、'yellow'
、'black'
および'white'
です。
データ型: cell
| char
| uint8
| uint16
| int16
| double
| single
BoxOpacity
— テキスト ボックスの不透明度
0.6 (既定値) | [0
1
] の範囲のスカラー値
テキスト ボックスの不透明度。'BoxOpacity
' と [0,1] の範囲のスカラー値で構成されるコンマ区切りのペアとして指定します。値 0
は、完全に透明なテキスト ボックス、またはボックスなしに対応します。値 1
は、完全に不透明なテキスト ボックスに対応します。
データ型: double
| single
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
AnchorPoint
— テキスト ボックスの基準点
'LeftTop
' (既定値) | 'LeftCenter
' | 'LeftBottom
' | 'CenterTop
' | 'Center
' | 'CenterBottom
' | 'RightTop
' | 'RightCenter
' | 'RightBottom
'
テキスト ボックスの基準点。'AnchorPoint
' と文字ベクトル値で構成されるコンマ区切りのペアとして指定します。アンカー ポイントは、テキスト ボックスの相対位置を定義します。テキスト ボックスのアンカー ポイントを、テキストに対応する position
によって定義される [x,y] 座標に配置することによって、テキスト ボックスの位置を指定できます。たとえば、テキスト ボックスの中心を position
入力で指定した [x,y] 座標に配置するには、AnchorPoint
を Center
に設定します。
サポートされる位置は、LeftTop
、LeftCenter
、LeftBottom
、CenterTop
、Center
、CenterBottom
、RightTop
、RightCenter
および RightBottom
です。
データ型: char
出力引数
RGB
— 出力イメージ
M x N x 3 のトゥルーカラー イメージ
出力イメージ。指定のテキストが挿入された M x N x 3 のトゥルーカラー イメージとして返されます。
制限
出力イメージに文字が表示されていない場合、フォントにその文字が含まれなかったことを意味します。異なるフォントを選択します。システムで使用可能なフォントの一覧を表示するには、MATLAB プロンプトで
listTrueTypeFonts
と入力します。フォント サイズを大きくすると、前処理の時間とメモリ使用量も増加します。
関数
insertText
は、特定の複合文字では機能しません。たとえば、文字コードに対応する 1 つのグリフをレンダリングすると、隣接するグリフの位置、形状またはサイズに影響する場合、テキストを挿入することはできません。
拡張機能
C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。
使用上の注意および制限:
Font
およびFontSize
はコンパイル時の定数でなければなりません。非 ASCII 文字はサポートされません。
バージョン履歴
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)