visionhdl。PixelsToFrame

将像素流转换为基于帧的视频

描述

的visionhdl。PixelsToFrame系统对象™将彩色或灰度像素流和控制结构转换为基于帧的视频。控制结构表明每个像素及其在帧中的位置的有效性。像素流格式可以包括活动帧周围的填充像素。您可以通过选择通用视频格式或指定自定义尺寸来配置帧和填充尺寸。有关像素流格式的详细信息，请参见流像素接口．

使用此对象将针对HDL代码生成的函数的输出转换回帧。对象本身不支持HDL代码生成。

如果您的设计将帧转换为像素流，然后将流转换回帧，请为FrameToPixels对象和PixelsToFrame对象。

将像素流转换为基于帧的视频。

创建visionhdl。PixelsToFrame对象并设置其属性。
调用带有参数的对象，就像调用函数一样。

要了解更多关于System对象如何工作的信息，请参见什么是系统对象?

创建

语法

P2F = visionhdl.PixelsToFrame(名称、值)

描述

例子

P2F= visionhdl。PixelsToFrame(的名字，价值）返回一个将像素流转换为图像帧的System对象。使用一个或多个名值对设置属性。将每个属性名用单引号括起来。

属性

全部展开

除非另有说明，属性为nontunable，这意味着在调用对象后不能更改它们的值。对象在调用时锁定，而释放函数打开它们。

如果属性是可调，您可以随时更改其值。

有关更改属性值的更多信息，请参见在MATLAB中使用系统对象设计系统．

`NumComponents`- - - - - -用于表示每个像素的值的数目
`1`(默认)|`2`|`3.`|`4`

用于表示每个像素的值的数目，指定为1，2，3.,或4组件。

对于灰度视频，将此属性设置为1．
对于彩色视频，例如{R,G,B}或{Y,Cb,Cr}，将此属性设置为3.．
对于带有alpha通道的彩色视频，将此属性设置为4．

的visionhdl。PixelsToFrame对象期望的矩阵为P——- - - - - -NumComponents值,P填充帧中的像素总数。

依赖关系

当NumComponents大于1时，必须设置NumPixels财产1．

`NumPixels`- - - - - -每个时间步流的像素数
`1`(默认)|`2`|`4`|`8`

每个循环在流媒体接口上传输的像素数，指定为1，2，4,或8．若要启用多像素流媒体并提高高分辨率或高帧率视频的吞吐量，请将此属性设置为2，4,或8．的visionhdl。PixelsToFrame对象预计P——- - - - - -NumPixels矩阵,P填充帧中的像素总数。

请注意

可以使用多像素流接口模拟系统对象，但不能为使用多像素流的系统对象生成HDL代码。要为多像素算法生成HDL代码，请使用等效的Simulink^®块。

依赖关系

当NumPixels大于1时，必须设置NumComponents财产1．

`VideoFormat`- - - - - -视频帧中活动区域和非活动区域的尺寸
`“1080 p”`(默认)|`“240 p”`|`“480 p”`|`480 ph值`|`“576 p”`|`“720 p”`|`“768 p”`|`“1024 p”`|`“1200 p”`|`“2 kcinema”`|`“4 kuhdtv”`|`“8 kuhdtv”`|`“自定义”`

视频帧活动区域的尺寸。要选择预定义的格式，请指定VideoFormat属性作为表第一列中的选项之一。对于自定义格式，请设置VideoFormat来“自定义”，并将维度属性指定为整数。

`视频格式`	`每行活动像素`	`活跃的视频线`
`240便士`	320	240
`480便士`	640	480
`ph值480`	720	480
`576便士`	720	576
`720便士`	1280	720
`768便士`	1024	768
`1024便士`	1280	1024
`1080便士`(默认)	1920	1080
`1200便士`	1600	1200
`2 kcinema`	2048	1080
`4 kuhdtv`	3840	2160
`8 kuhdtv`	7680	4320
`自定义`	用户- 定义	用户- 定义

使用

语法

[农场,validOut] = P2F(像素,ctrlIn)

描述

例子

［纳，validOut) = P2F (像素，ctrlIn）转换表示填充图像的像素值向量，像素，以及控制结构的相关向量，ctrlIn，到图像矩阵，纳．控制结构表明每个像素及其在帧中的位置的有效性。输出图像,纳，如果为有效validOut是真正的．

有关像素流格式的详细信息，请参见流像素接口．

输入参数

全部展开

`像素`- - - - - -输入像素
矩阵

像素值，指定为P——- - - - - -NumComponents矩阵,或P——- - - - - -NumPixels矩阵,地点:

P填充图像中的像素总数是多少TotalPixelsPerLine×TotalVideoLines．
NumComponents表示用于表示单个像素的组件数量。
NumPixels是每个周期在流媒体接口上传输的像素数。当NumPixels大于1，必须设置吗NumComponents来1．

请注意

可以使用多像素流接口模拟系统对象，但不能为使用多像素流的系统对象生成HDL代码。要为多像素算法生成HDL代码，请使用等价的Simulink块。

方法设置填充图像的大小VideoFormat财产。如果元素的个数像素与指定的尺寸不符VideoFormat，该对象返回一个警告。

数据类型:使用uint|int|逻辑|fi|双|单

`ctrlIn`- - - - - -像素流控制信号
向量的结构

与输入像素相关联的控制结构，指定为P1的向量。P填充图像中的像素总数是多少TotalPixelsPerLine×TotalVideoLines．每个结构包含五个控制信号，指示像素的有效性及其在帧中的位置。对于多像素流，控制信号应用于每一组NumPixels值。看到像素控制结构．

输出参数

全部展开

`纳`——输出图像
矩阵

输出图像，返回为ActiveVideoLines——- - - - - -ActivePixelsPerLine——- - - - - -NumComponents矩阵,地点:

ActiveVideoLines是活动图像的高度。
ActivePixelsPerLine活动图像的宽度。
NumComponents表示用于表示单个像素的组件数量。

像素的数据类型与输入相同像素．

数据类型:使用uint|int|逻辑|fi|双|单

`validOut`-有效输出的指示
标量的逻辑

帧状态，作为逻辑值返回。当validOut为真，框架被重新组装并准备使用。

数据类型:逻辑

对象的功能

要使用对象函数，请将System对象指定为第一个输入参数。例如，释放名为obj，使用以下语法:

发行版(obj)

全部展开

通用于所有系统对象

`一步`	运行系统对象算法
`释放`	释放资源并允许更改系统对象属性值和输入特征
`重置`	的内部状态重置系统对象

例子

全部折叠

在全帧和像素流数据之间转换

这个示例使用:

打开生活的脚本

此示例将自定义大小的灰度图像转换为像素流。它使用visionhdl。LookupTable对象来获取负像。然后它将像素流转换回全帧图像。

从文件加载源图像。选择匹配所需测试大小的图像的一部分。

frmOrig = imread (“rice.png”）;frmActivePixels = 64;frmActiveLines = 48;frmInput = frmOrig (1: frmActiveLines, 1: frmActivePixels);图imshow (frmInput,“InitialMagnification”标题,300)输入图像的

图中包含一个axes对象。标题为Input Image的axes对象包含一个Image类型的对象。

创建一个序列化器对象并指定非激活像素区域的大小。

frm2pix = visionhdl。FrameToPixels (.．.“NumComponents”, 1.．.“VideoFormat”，“自定义”，.．.“ActivePixelsPerLine”frmActivePixels,.．.“ActiveVideoLines”frmActiveLines,.．.“TotalPixelsPerLine”frmActivePixels + 10,.．.“TotalVideoLines”frmActiveLines + 10,.．.“StartingActiveLine”6.．.“FrontPorch”5);

创建一个查找表(LUT)对象来生成输入图像的底片。

tabledata = linspace(255、0256);逆变器= visionhdl.LookupTable (tabledata);

通过调用序列化器对象来序列化测试映像。pixIn是强度值的向量。ctrlIn是控制信号结构的矢量。

[pixIn, ctrlIn] = frm2pix (frmInput);

准备通过预分配输出向量来处理像素。

[~, ~, numPixelsPerFrame] = getparamfromfrm2pix (frm2pix);pixOut = 0 (numPixelsPerFrame 1“uint8”）;ctrlOut = repmat (pixelcontrolstruct numPixelsPerFrame 1);

对于流中的每个像素，查找像素值的负数。

为p = 1:numPixelsPerFrame [pixOut(p)，ctrlOut(p)] =逆变器(pixIn(p)，ctrlIn(p));结束

创建一个格式与序列化器的格式匹配的反序列化器对象。通过调用反序列化器对象将像素流转换为图像帧。显示结果图像。

pix2frm = visionhdl。PixelsToFrame (.．.“NumComponents”, 1.．.“VideoFormat”，“自定义”，.．.“ActivePixelsPerLine”frmActivePixels,.．.“ActiveVideoLines”frmActiveLines,.．.“TotalPixelsPerLine”, frmActivePixels + 10);[frmOutput, frmValid] = pix2frm (pixOut ctrlOut);如果frmValid图imshow (frmOutput,“InitialMagnification”标题,300)输出图像的结束

图中包含一个axes对象。标题为Output Image的axes对象包含一个Image类型的对象。

版本历史

介绍了R2015a

全部展开

R2022a:更改默认帧尺寸

自定义格式的默认值已更改。在以前的版本中，默认尺寸与1080p格式匹配。从R2022a开始，默认值与帧像素而且像素帧块，它们定义了一个小的自定义框架，如此代码所示。

一个= visionhdl。FrameToPixels (“VideoFormat”，“自定义”）

一个= visionhdl。FrameToPixelswith properties: NumComponents: 1 NumPixels: 1 VideoFormat: 'Custom' ActivePixelsPerLine: 32 ActiveVideoLines: 18 TotalPixelsPerLine: 42 TotalVideoLines: 28 StartingActiveLine: 6 FrontPorch: 5

此更改意味着您可能需要为自定义格式指定额外的维度，而以前默认值会导致有效格式。

当您选择标准格式时，对象现在更新帧尺寸属性。此更改意味着您可以引用对象属性来确定格式所使用的维度。

一个= visionhdl。FrameToPixels (“VideoFormat”，“480 p”）

一个= visionhdl。FrameToPixelswith properties: NumComponents: 1 NumPixels: 1 VideoFormat: '480p'

TPPL480 = a.TotalPixelsPerLine

ans = 800

R2022a:两个pixels-per-clock流

该对象现在接受每个时钟周期有2个像素的多像素流。

可以使用多像素流接口模拟系统对象，但不能为使用多像素流的系统对象生成HDL代码。要为多像素算法生成HDL代码，请使用等价的Simulink块。

R2020a:Multipixel-multicomponent流

该对象现在可以接受多像素多组件流。该对象接受的输入矩阵为NumPixels——- - - - - -NumComponents像素。的ctrl参数保持标量，而控件中的控制信号pixelcontrol结构应用于矩阵中的所有像素。

可以使用多像素流接口模拟系统对象，但不能为使用多像素流的系统对象生成HDL代码。要为多像素算法生成HDL代码，请使用等价的Simulink块。

R2019b:Multipixel流

对象现在可以接受每个时钟周期有4或8像素的像素流。您可以设置NumPixels财产4或8．通过这个设置，对象期望在每个时间步上有一个4或8像素值的输入向量。

可以使用多像素流接口模拟系统对象，但不能为使用多像素流的系统对象生成HDL代码。要为多像素算法生成HDL代码，请使用等价的Simulink块。

另请参阅

visionhdl。FrameToPixels|像素帧

visionhdl。PixelsToFrame

描述

创建

语法

描述

属性

NumComponents- - - - - -用于表示每个像素的值的数目1(默认)|2|3.|4

依赖关系

NumPixels- - - - - -每个时间步流的像素数1(默认)|2|4|8

依赖关系

VideoFormat- - - - - -视频帧中活动区域和非活动区域的尺寸“1080 p”(默认)|“240 p”|“480 p”|480 ph值|“576 p”|“720 p”|“768 p”|“1024 p”|“1200 p”|“2 kcinema”|“4 kuhdtv”|“8 kuhdtv”|“自定义”

使用

语法

描述

输入参数

像素- - - - - -输入像素矩阵

ctrlIn- - - - - -像素流控制信号向量的结构

输出参数

纳——输出图像矩阵

validOut-有效输出的指示标量的逻辑

对象的功能

通用于所有系统对象

例子

在全帧和像素流数据之间转换

版本历史

R2022a:更改默认帧尺寸

R2022a:两个pixels-per-clock流

R2020a:Multipixel-multicomponent流

R2019b:Multipixel流

另请参阅

主题

`NumComponents`- - - - - -用于表示每个像素的值的数目
`1`(默认)|`2`|`3.`|`4`

`NumPixels`- - - - - -每个时间步流的像素数
`1`(默认)|`2`|`4`|`8`

`VideoFormat`- - - - - -视频帧中活动区域和非活动区域的尺寸
`“1080 p”`(默认)|`“240 p”`|`“480 p”`|`480 ph值`|`“576 p”`|`“720 p”`|`“768 p”`|`“1024 p”`|`“1200 p”`|`“2 kcinema”`|`“4 kuhdtv”`|`“8 kuhdtv”`|`“自定义”`

`像素`- - - - - -输入像素
矩阵

`ctrlIn`- - - - - -像素流控制信号
向量的结构

`纳`——输出图像
矩阵

`validOut`-有效输出的指示
标量的逻辑