visionhdl。PixelsToFrame

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

展开全部页面

描述

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

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

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

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

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

有关系统对象如何工作的详细信息，请参见什么是系统对象?

创建

语法

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填充帧中的像素总数。

请注意

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

依赖关系

当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
`自定义`	用户- 定义	用户- 定义

使用

语法

[frm,validOut] = P2F(pixels,ctrlIn)

描述

例子

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

像素流格式请参见流媒体像素接口．

输入参数

全部展开

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

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

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

请注意

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

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

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

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

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

输出参数

全部展开

`纳`-输出图像
矩阵

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

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

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

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

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

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

数据类型:逻辑

对象的功能

要使用对象函数，请将System对象指定为第一个输入参数。例如，释放system对象的系统资源obj，使用这种语法:

发行版(obj)

全部展开

所有系统对象通用

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

例子

全部折叠

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

这个例子使用了:

打开实时脚本

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

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

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

图中包含一个轴对象。标题为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,0,256);逆变器= 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);如果(frmOutput，“InitialMagnification”标题,300)输出图像的结束

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

版本历史

在R2015a中引入

全部展开

R2022a:更改默认帧尺寸

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

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

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

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

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

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

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

TPPL480 = a.TotalPixelsPerLine

Ans = 800

R2022a:每时钟两个像素的流媒体

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

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

R2020a:Multipixel-multicomponent流

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

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

R2019b:Multipixel流

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

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

另请参阅

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:每时钟两个像素的流媒体

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`-有效输出的指示
标量的逻辑