主要内容

插入文本

在图像或视频帧上绘制文本

  • 库:
  • 计算机视觉工具箱/文本和图形

  • 插入文本块

描述

插入文本块在输入图像或视频流上绘制格式化文本。该块使用开源字体引擎Free Type 2.3.5库生成风格化的文本位图。有关该库的详细信息,请参见FreeType项目的网站。

请注意

此块仅支持ASCII字万博1manbetx符。

此块允许您绘制:

  • 一个文本实例

  • 同一文本的多个实例

  • 文本的多个实例,每个位置有不同的文本

港口

输入

全部展开

输入图像或视频,指定为——- - - - - -N矩阵,——- - - - - -N——- - - - - -T数组,——- - - - - -N——- - - - - -C数组,或——- - - - - -N——- - - - - -C——- - - - - -T数组中。T视频或图像序列中的帧数,和C是颜色通道的数量。

依赖关系

若要启用此端口,请设置图像信号参数一个多维信号

数据类型:||int8|int16|int32|uint8|uint16|uint32|布尔

输入图像或视频的红色组件,指定为——- - - - - -N矩阵或——- - - - - -N——- - - - - -T数组,T输入视频中的帧数。

请注意

的输入RG,B端口尺寸和数据类型必须一致。

依赖关系

若要启用此端口,请设置图像信号参数单独的颜色信号

数据类型:||int8|int16|int32|uint8|uint16|uint32|布尔

输入图像或视频的绿色组件,指定为——- - - - - -N矩阵或——- - - - - -N——- - - - - -T数组,T输入视频中的帧数。

请注意

的输入RG,B端口尺寸和数据类型必须一致。

依赖关系

若要启用此端口,请设置图像信号参数单独的颜色信号

数据类型:||int8|int16|int32|uint8|uint16|uint32|布尔

输入图像或视频的蓝色组件,指定为——- - - - - -N矩阵或——- - - - - -N——- - - - - -T数组,T输入视频中的帧数。

请注意

的输入RG,B端口尺寸和数据类型必须一致。

依赖关系

若要启用此端口,请设置图像信号参数单独的颜色信号

数据类型:||int8|int16|int32|uint8|uint16|uint32|布尔

选择文本字符串,指定为正整数。时的值文本参数是字符向量的单元格数组插入文本控件的输入值所指示的单元格中显示文本字符串选择端口。该端口的输入范围必须为1到单元格数组中文本字符串的数目,其中1表示第一个字符向量。

依赖关系

要启用此端口,请指定文本参数作为字符向量的单元格数组,例如{“Text1”、“Text2”}

数据类型:|

文本颜色值,指定为标量、向量或矩阵。输入图像的数据类型决定了颜色值的范围。例如,浮点输入图像数据类型的颜色值必须在[01].对于uint8数据类型的输入图像,该值必须在[0255].该端口的输入形状取决于输入信号是基于强度的还是基于颜色的。

  • 强度信号-指定颜色作为强度值的标量(在这种情况下,块将强度值应用于所有文本字符串),或者作为长度等于指定的文本字符串数量的强度值的向量文本参数。

  • 颜色信号-指定颜色作为一个三元素向量,它将所有文本字符串的颜色定义为RGB三元组,或者年代-by-3矩阵的颜色值,其中年代文本字符串的数目是否指定给文本参数。

请注意

此端口的输入必须与输入图像具有相同的数据类型。

依赖关系

若要启用此端口,请设置颜色值来源参数输入端口

数据类型:||int8|int16|int32|uint8|uint16|uint32

位置索引,两个元素向量或年代-by-2 matrix,指定要插入文本的输入图像的坐标。如果指定为两元素向量,则第一个元素表示图像的行,第二个元素表示要插入字符向量的图像列。如果指定为年代-by-2矩阵,每行包含图像中要显示文本的位置的行索引和列索引。

依赖关系

若要启用此端口,请设置源位置参数输入端口

数据类型:||int8|int16|int32|uint8|uint16|uint32

不透明度因子,指定为标量或向量。如果指定为标量,则不透明度因子应用于所有文本字符串。属性中指定的文本字符串的个数文本参数。不透明度因子的每个元素的范围为01

依赖关系

若要启用此端口,请设置不透明度源参数输入端口

数据类型:|

文本变量值,指定为标量或向量。控件中的格式规范文本参数,例如% d% f,或% s,与输入的元素。使用% s选项,指定一组以值0分隔的文本字符串,以便块在不同位置同时显示。例如,要插入两个字符串,使用a常数(万博1manbetx模型)块,并将其值指定为[uint8('Text1') 0 uint8('Text2')]变量输入端口。有关格式说明符的更多信息,请参见sprintf

依赖关系

要启用此端口,请输入ANSI Cprintf样式格式规范,例如% d% f,或% s文本参数。

数据类型:uint8|

输出

全部展开

输出图像或视频,返回为——- - - - - -N矩阵,——- - - - - -N——- - - - - -T数组,——- - - - - -N——- - - - - -C数组,或——- - - - - -N——- - - - - -C——- - - - - -T数组中。T视频或图像序列中的帧数,和C是颜色通道的数量。

依赖关系

若要启用此端口,请设置图像信号参数一个多维信号

数据类型:||int8|int16|int32|uint8|uint16|uint32|布尔

红色组件的输出图像或视频,返回为——- - - - - -N矩阵或——- - - - - -N——- - - - - -T数组,T输出视频中的帧数。

依赖关系

若要启用此端口,请设置图像信号参数单独的颜色信号

数据类型:||int8|int16|int32|uint8|uint16|uint32|布尔

输出图像或视频的绿色组件,作为——- - - - - -N矩阵或——- - - - - -N——- - - - - -T数组,T输出视频中的帧数。

依赖关系

若要启用此端口,请设置图像信号参数单独的颜色信号

数据类型:||int8|int16|int32|uint8|uint16|uint32|布尔

输出图像或视频的蓝色组件,返回为——- - - - - -N矩阵或——- - - - - -N——- - - - - -T数组,T输出视频中的帧数。

依赖关系

若要启用此端口,请设置图像信号参数单独的颜色信号

数据类型:||int8|int16|int32|uint8|uint16|uint32|布尔

参数

全部展开

主要

指定要插入到输入图像中的文本。

  • 您可以将此参数指定为单个文本字符串或字符向量,例如“Text1”,或作为字符向量的单元格数组,例如{“Text1”、“Text2”}.方法指定单元格数组,则还必须指定要显示的文本字符串选择输入端口。

  • 你可以包括ANSI Cprintf样式格式规范,例如“文本% d '.方法指定它们的值变量输入端口。万博1manbetx支持的格式说明符包括% d%我% u% c% f%啊% x% X% e% E% g,% G.有关格式说明符的更多信息,请参见sprintf

从以下选项中选择文本颜色源:通过对话框指定而且输入端口.如果将该参数设置为通过对话框指定属性指定文本颜色颜色值参数。如果将该参数设置为输入端口属性指定文本颜色颜色输入端口。

文本颜色值,指定为标量、向量或矩阵。输入图像的数据类型决定了颜色值的范围。例如,浮点输入图像数据类型的颜色值必须在[01].对于uint8数据类型的输入图像,该值必须在[0255].文本颜色值的大小取决于输入信号是基于强度的还是基于颜色的。

  • 强度信号-指定颜色作为强度值的标量(在这种情况下,块将强度值应用于所有文本字符串),或者作为长度等于指定的文本字符串数量的强度值的向量文本参数。

  • 颜色信号-指定颜色作为一个三元素向量,它将所有文本字符串的颜色定义为RGB三元组,或者年代-by-3矩阵的颜色值,其中年代文本字符串的数目是否指定给文本参数。

依赖关系

若要启用此参数,请设置颜色值来源参数通过对话框指定

从以下选项中选择文本位置源:通过对话框指定而且输入端口.如果将该参数设置为通过对话框指定属性指定文本位置位置[x y]参数。如果将该参数设置为输入端口属性指定文本位置位置输入端口。

文本位置索引,两元素向量或年代-by-2 matrix,指定要插入文本的输入图像的坐标。如果指定为两元素向量,则第一个元素表示图像的行,第二个元素表示要插入字符向量的图像列。如果指定为年代-by-2矩阵,每行包含图像中要显示文本的位置的行索引和列索引。

依赖关系

若要启用此参数,请设置源位置参数通过对话框指定

从以下选项中选择不透明度因子来源:通过对话框指定而且输入端口.如果将该参数设置为通过对话框指定,则必须使用不透明度参数。如果将该参数设置为输入端口属性指定不透明度因子不透明度输入端口。

不透明度因子,指定为标量或向量。如果指定为标量,则不透明度因子应用于所有文本字符串。属性中指定的文本字符串的个数文本参数。不透明度因子的每个元素的范围为01

依赖关系

若要启用此参数,请设置不透明度源参数通过对话框指定

使用以下选项指定块的输入和输出图像的格式:

  • 一个多维信号—块只有一个输入端口和一个输出端口。

  • 单独的颜色信号-该块有三个输入和输出信号,每个颜色通道一个,接受和返回图像的单个颜色通道。

启用此参数以镜像文本字符串并反转其在图像中的位置(x, y)(x, y)

字体

指定插入文本的字体。该块用系统上安装的字体填充此列表。在Windows上,该块在系统注册表中搜索字体文件。在UNIX上,块搜索X Server的字体路径以查找字体文件。

指定插入文本的字体大小。

启用此参数可平滑插入文本的边缘。平滑过程的计算成本很高。

块特征

数据类型

布尔||不动点一个|整数|

多维信号

是的

适应信号

是的

一个万博1manbetx支持字长小于或等于32位。

扩展功能

C/ c++代码生成
使用Simulink®Coder™生成C和c++代码。万博1manbetx

版本历史

在R2013a中引入

另请参阅

|