Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

QVideoFrame Class Reference
^{[QtMultimedia module]}

该QVideoFrame类提供​​的视频数据的帧的表示。More...

Types

• enum FieldType { ProgressiveFrame, TopField, BottomField, InterlacedFrame }
• enum PixelFormat { Format_Invalid, Format_ARGB32, Format_ARGB32_Premultiplied, Format_RGB32, ..., Format_User }

Methods

• __init__ (self)
• __init__ (self, QAbstractVideoBuffer buffer, QSize size, PixelFormat format)
• __init__ (self, int bytes, QSize size, int bytesPerLine, PixelFormat format)
• __init__ (self, QImage image)
• __init__ (self, QVideoFrame other)
• sip.voidptr bits (self)
• int bytesPerLine (self)
• int endTime (self)
• FieldType fieldType (self)
• QVariant handle (self)
• QAbstractVideoBuffer.HandleType handleType (self)
• int height (self)
• bool isMapped (self)
• bool isReadable (self)
• bool isValid (self)
• bool isWritable (self)
• bool map (self, QAbstractVideoBuffer.MapMode mode)
• QAbstractVideoBuffer.MapMode mapMode (self)
• int mappedBytes (self)
• PixelFormat pixelFormat (self)
• setEndTime (self, int time)
• setFieldType (self, FieldType)
• setStartTime (self, int time)
• QSize size (self)
• int startTime (self)
• unmap (self)
• int width (self)

Static Methods

• QImage.Format imageFormatFromPixelFormat (PixelFormat format)
• PixelFormat pixelFormatFromImageFormat (QImage.Format format)

Detailed Description

该QVideoFrame类提供​​的视频数据的帧的表示。

一个QVideoFrame封装了一个视频帧，以及有关帧信息的数据。

一视频帧的内容可以通过使用被映射到存储器中的map（）函数。而映射到的视频数据可以使用访问bits（）函数返回一个指向缓冲区的指针，它的总的大小是由给定的mappedBytes（）和每一行的大小由下式给出bytesPerLine（ ） 。的返回值handle（）函数可用于使用内部缓冲器的本机API来访问帧数据。

在一个QVideoFrame视频数据被封装在一个QAbstractVideoBuffer。一个QVideoFrame可以从任何缓冲类型的子类的构造QAbstractVideoBuffer类。

Note:QVideoFrame是公开共享的，以视频帧所做的任何更改也将适用于任何副本。

Type Documentation

QVideoFrame.FieldType

指定的隔行扫描视频帧所属的领域。

QVideoFrame.PixelFormat

列举的视频数据类型。

Method Documentation

QVideoFrame.__init__ (self)

构造一个空的视频帧。

QVideoFrame.__init__ (self, QAbstractVideoBuffer buffer, QSize size, PixelFormat format)

构造一个视频帧从一个buffer给定像素的format和size以像素为单位。

Note:这不会增加视频缓冲区的引用计数。

QVideoFrame.__init__ (self, int bytes, QSize size, int bytesPerLine, PixelFormat format)

构造的给定像素的视频帧format和size以像素为单位。

该bytesPerLine（步幅），以字节为单位的每个扫描线的长度，并bytes是一个字节必须被分配给该帧的总数。

QVideoFrame.__init__ (self, QImage image)

构造一个视频帧从image。

Note:这将构造一个无效的视频帧，如果没有帧类型等效于图像格式。

See also pixelFormatFromImageFormat（ ） 。

QVideoFrame.__init__ (self, QVideoFrame other)

构造的副本other。

sip.voidptr QVideoFrame.bits (self)

返回一个指向帧数据缓冲区的开始。

而帧数据是这个值才有效mapped。

See also map（ ）mappedBytes（）和bytesPerLine（ ） 。

int QVideoFrame.bytesPerLine (self)

返回的字节中的扫描线的数目。

Note:这是每个唯一的第一平面的线的字节数。随后飞机每行的字节数应计算为每帧类型。

而帧数据是这个值才有效mapped。

See also bits（ ）map（）和mappedBytes（ ） 。

int QVideoFrame.endTime (self)

返回演示文稿时，当一帧应该停止显示。

See also setEndTime（ ） 。

FieldType QVideoFrame.fieldType (self)

返回一个隔行视频帧所属的领域。

如果视频不隔行扫描，这将返回WholeFrame 。

See also setFieldType（ ） 。

QVariant QVideoFrame.handle (self)

返回一个特定类型的句柄，一个视频帧的缓冲区。

对于OpenGL纹理，这将是质感的ID 。

See also QAbstractVideoBuffer.handle（ ） 。

QAbstractVideoBuffer.HandleType QVideoFrame.handleType (self)

返回一个视频帧的句柄类型。

int QVideoFrame.height (self)

返回一个视频帧的高度。

QImage.Format QVideoFrame.imageFormatFromPixelFormat (PixelFormat format)

返回一个图像格式等同于一个视频帧的像素format。如果没有相等的格式QImage.Format_Invalid返回来代替。

bool QVideoFrame.isMapped (self)

如果一个视频帧的内容被当前映射到系统存储器标识。

这是一个方便的功能，它会检查MapMode帧不等于QAbstractVideoBuffer.NotMapped。

返回True如果视频帧的内容映射到系统内存，否则返回False 。

See also mapMode（）和QAbstractVideoBuffer.MapMode。

bool QVideoFrame.isReadable (self)

如果确定一个视频帧的映射内容物从帧中读出时，它被映射。

这是一个方便的功能，如果它检查MapMode包含QAbstractVideoBuffer.WriteOnly标志。

返回True如果映射的内存中的内容是从视频帧读出，否则返回False 。

See also mapMode（）和QAbstractVideoBuffer.MapMode。

bool QVideoFrame.isValid (self)

识别的视频帧是否是有效的。

无效帧都有一个与之关联的视频缓冲器。

返回True如果该帧是有效的，并且假，如果事实并非如此。

bool QVideoFrame.isWritable (self)

如果识别视频帧的映射内容时，帧映射将被保存。

这是一个方便的功能，如果它检查MapMode包含QAbstractVideoBuffer.WriteOnly标志。

返回True ，如果视频帧将被更新，否则取消映射时，假。

Note:改变被映射在只读模式中的帧的数据的结果是不确定的。根据不同的缓冲区实现的变更可能会持续存在，或者更糟改变一个共享缓冲区。

See also mapMode（）和QAbstractVideoBuffer.MapMode。

bool QVideoFrame.map (self, QAbstractVideoBuffer.MapMode mode)

映射一个视频帧的内容到存储器中。

地图mode指示是否映射存储器中的内容应被读出和/或写入帧。如果映射模式包括QAbstractVideoBuffer.ReadOnly标志映射的内存将被填充的视频帧的内容映射时。如果地图模式inclues的QAbstractVideoBuffer.WriteOnly映射的内存的标志内容将被保存在帧映射时。

而映射的一个视频帧的内容可以直接通过由返回的指针来访问bits（）函数。

当访问数据不再需要，一定要调用unmap（ ）函数释放映射内存。

返回True如果缓冲区被映射到内存中给定的mode否则为False。

See also unmap（ ）mapMode（）和bits（ ） 。

QAbstractVideoBuffer.MapMode QVideoFrame.mapMode (self)

返回一个视频帧被映射到系统存储器英寸的模式

See also map（）和QAbstractVideoBuffer.MapMode。

int QVideoFrame.mappedBytes (self)

返回由对应的帧数据所佔用的字节数。

而帧数据是这个值才有效mapped。

See also map（ ） 。

PixelFormat QVideoFrame.pixelFormat (self)

返回一个视频帧的颜色格式。

PixelFormat QVideoFrame.pixelFormatFromImageFormat (QImage.Format format)

返回一个视频像素格式相当于一个图像format。如果没有相等的格式QVideoFrame.InvalidType返回来代替。

QVideoFrame.setEndTime (self, int time)

设置演示文稿time当一个帧应停止显示。

See also endTime（ ） 。

QVideoFrame.setFieldType (self, FieldType)

设置field隔行扫描视频帧属于。

See also fieldType（ ） 。

QVideoFrame.setStartTime (self, int time)

设置演示文稿time当帧的显示方式。

See also startTime（ ） 。

QSize QVideoFrame.size (self)

返回一个视频帧的大小。

int QVideoFrame.startTime (self)

返回时，应显示的帧的显示时间。

See also setStartTime（ ） 。

QVideoFrame.unmap (self)

发布映射的内存map（）函数。

如果MapMode包括QAbstractVideoBuffer.WriteOnly标志，这将持续映射内存的当前内容到视频帧。

See also map（ ） 。

int QVideoFrame.width (self)

返回一个视频帧的宽度。