企业🤖AI智能体构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
# QVideoFrame Class Reference ## [[QtMultimedia](index.htm) module] 该QVideoFrame类提供​​的视频数据的帧的表示。[More...](#details) ### 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](qvideoframe.html#map)()函数。而映射到的视频数据可以使用访问[bits](qvideoframe.html#bits)()函数返回一个指向缓冲区的指针,它的总的大小是由给定的[mappedBytes](qvideoframe.html#mappedBytes)()和每一行的大小由下式给出[bytesPerLine](qvideoframe.html#bytesPerLine)( ) 。的返回值[handle](qvideoframe.html#handle)()函数可用于使用内部缓冲器的本机API来访问帧数据。 在一个QVideoFrame视频数据被封装在一个[QAbstractVideoBuffer](qabstractvideobuffer.html)。一个QVideoFrame可以从任何缓冲类型的子类的构造[QAbstractVideoBuffer](qabstractvideobuffer.html)类。 **Note:**QVideoFrame是公开共享的,以视频帧所做的任何更改也将适用于任何副本。 * * * ## Type Documentation ``` QVideoFrame.FieldType ``` 指定的隔行扫描视频帧所属的领域。 | Constant | Value | Description | | --- | --- | --- | | `QVideoFrame.ProgressiveFrame` | `0` | 该框架是没有交错。 | | `QVideoFrame.TopField` | `1` | 该帧包含一个顶场。 | | `QVideoFrame.BottomField` | `2` | 该帧包含一个底场。 | | `QVideoFrame.InterlacedFrame` | `3` | 该帧包含一个合并的顶和底场。 | ``` QVideoFrame.PixelFormat ``` 列举的视频数据类型。 | Constant | Value | Description | | --- | --- | --- | | `QVideoFrame.Format_Invalid` | `0` | 该框架是无效的。 | | `QVideoFrame.Format_ARGB32` | `1` | 该帧是使用32位ARGB格式( 0xAARRGGBB )存储。这等效于[QImage.Format_ARGB32](qimage.html#Format-enum)。 | | `QVideoFrame.Format_ARGB32_Premultiplied` | `2` | 使用预乘32位ARGB格式( 0xAARRGGBB )存储帧。这等效于[QImage.Format_ARGB32_Premultiplied](qimage.html#Format-enum)。 | | `QVideoFrame.Format_RGB32` | `3` | 使用32位RGB格式( 0xffRRGGBB )存储帧。这等效于[QImage.Format_RGB32](qimage.html#Format-enum) | | `QVideoFrame.Format_RGB24` | `4` | 该框架是采用24位RGB格式( 8-8-8 )存储。这等效于[QImage.Format_RGB888](qimage.html#Format-enum) | | `QVideoFrame.Format_RGB565` | `5` | 该帧是使用一个16位的RGB格式( 5-6-5 )存储。这等效于[QImage.Format_RGB16](qimage.html#Format-enum)。 | | `QVideoFrame.Format_RGB555` | `6` | 该帧是使用一个16位的RGB格式( 5-5-5 )存储。这等效于[QImage.Format_RGB555](qimage.html#Format-enum)。 | | `QVideoFrame.Format_ARGB8565_Premultiplied` | `7` | 该框架是用一个24位预乘的ARGB格式( 8-6-6-5 )存储。 | | `QVideoFrame.Format_BGRA32` | `8` | 该帧是使用32位ARGB格式( 0xBBGGRRAA )存储。 | | `QVideoFrame.Format_BGRA32_Premultiplied` | `9` | 该框架是使用预乘32位的BGRA格式存储。 | | `QVideoFrame.Format_BGR32` | `10` | 该帧是使用一个32位的BGR格式( 0xBBGGRRff )存储。 | | `QVideoFrame.Format_BGR24` | `11` | 该框架是使用24位BGR格式( 0xBBGGRR )存储。 | | `QVideoFrame.Format_BGR565` | `12` | 该帧是使用一个16位的BGR格式( 5-6-5 )存储。 | | `QVideoFrame.Format_BGR555` | `13` | 该帧是使用一个16位的BGR格式( 5-5-5 )存储。 | | `QVideoFrame.Format_BGRA5658_Premultiplied` | `14` | 该框架是用一个24位预乘的BGRA格式( 5-6-5-8 )存储。 | | `QVideoFrame.Format_AYUV444` | `15` | 该框架是使用填充32位AYUV格式( 0xAAYYUUVV )存储。 | | `QVideoFrame.Format_AYUV444_Premultiplied` | `16` | 该框架是使用填充预乘32位AYUV格式( 0xAAYYUUVV )存储。 | | `QVideoFrame.Format_YUV444` | `17` | 该框架是使用24 - bit包装YUV格式( 8-8-8 )存储。 | | `QVideoFrame.Format_YUV420P` | `18` | 该帧是使用与U和V平面的8位每个组件的平面YUV格式的水平和垂直子采样,即, U和V平面的高度和宽度的一半, Y平面的存储。 | | `QVideoFrame.Format_YV12` | `19` | 该帧被使用与所述V和U平面的8位每个组件的平面YVU格式水平和垂直子采样,即V和U平面的高度和宽度的一半, Y平面的存储。 | | `QVideoFrame.Format_UYVY` | `20` | 该帧是使用与U和V平面的8位每个组件填充YUV格式的水平子采样( UYVY )存储的,也就是两个水平相邻的像素被作为一个32位的宏像素具有用于每个像素的Y值和存储普通U和V值。 | | `QVideoFrame.Format_YUYV` | `21` | 该帧是使用与U和V平面的8位每个组件填充YUV格式的水平子采样( YUYV )存储的,也就是两个水平相邻的像素被作为一个32位的宏像素具有用于每个像素的Y值和存储普通U和V值。 | | `QVideoFrame.Format_NV12` | `22` | 该帧被使用每组件半平面YUV格式的8位与后跟一个水平和垂直子采样,填充UV平面(UV)一个Y平面(Y)存储起来。 | | `QVideoFrame.Format_NV21` | `23` | 该帧被使用每组件半平面YUV格式的8位与后跟一个水平和垂直子采样一Y平面(Y)存储,包装VU平面( VU) 。 | | `QVideoFrame.Format_IMC1` | `24` | 该帧是使用与U和V平面的8位每个组件的平面YUV格式的水平和垂直子采样存储。这是类似于Format_YUV420P类型,不同的是每U和V平面的线的字节被填充为同一跨距为Y平面。 | | `QVideoFrame.Format_IMC2` | `25` | 该帧是使用与U和V平面的8位每个组件的平面YUV格式的水平和垂直子采样存储。这是类似于Format_YUV420P类型,不同的是U和V平面的线被交织,即U数据的每一行之后是一条线的V数据的创建相同的跨距为Y数据的一条线。 | | `QVideoFrame.Format_IMC3` | `26` | 该帧被使用与所述V和U平面水平和垂直子采样的一个8位的每部分的平面YVU格式存储。这是类似于Format_YV12类型,不同之处在于每对V和U平面的线的字节被填充为相同的跨距为Y平面。 | | `QVideoFrame.Format_IMC4` | `27` | 该帧被使用与所述V和U平面水平和垂直子采样的一个8位的每部分的平面YVU格式存储。这是类似于Format_YV12类型,除了V和U平面的线是交错的,即V数据的每一行之后是一条线的U数据创建相同的跨距为Y数据的一条线。 | | `QVideoFrame.Format_Y8` | `28` | 该帧被使用8位灰度格式存储。 | | `QVideoFrame.Format_Y16` | `29` | 该帧是使用一个16位线性灰度格式存储。小尾数。 | | `QVideoFrame.Format_User` | `1000` | 用户定义的像素格式起始值。 | * * * ## 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.html#pixelFormatFromImageFormat)( ) 。 ``` QVideoFrame.__init__ (self, QVideoFrame other) ``` 构造的副本_other_。 ``` sip.voidptr QVideoFrame.bits (self) ``` 返回一个指向帧数据缓冲区的开始。 而帧数据是这个值才有效[mapped](qvideoframe.html#map)。 **See also** [map](qvideoframe.html#map)( )[mappedBytes](qvideoframe.html#mappedBytes)()和[bytesPerLine](qvideoframe.html#bytesPerLine)( ) 。 ``` int QVideoFrame.bytesPerLine (self) ``` 返回的字节中的扫描线的数目。 **Note:**这是每个唯一的第一平面的线的字节数。随后飞机每行的字节数应计算为每帧类型。 而帧数据是这个值才有效[mapped](qvideoframe.html#map)。 **See also** [bits](qvideoframe.html#bits)( )[map](qvideoframe.html#map)()和[mappedBytes](qvideoframe.html#mappedBytes)( ) 。 ``` int QVideoFrame.endTime (self) ``` 返回演示文稿时,当一帧应该停止显示。 **See also** [setEndTime](qvideoframe.html#setEndTime)( ) 。 ``` FieldType QVideoFrame.fieldType (self) ``` [ 返回一个隔行视频帧所属的领域。 如果视频不隔行扫描,这将返回WholeFrame 。 ](qvideoframe.html#FieldType-enum) [**See also**](qvideoframe.html#FieldType-enum) [setFieldType](qvideoframe.html#setFieldType)( ) 。 ``` QVariant QVideoFrame.handle (self) ``` 返回一个特定类型的句柄,一个视频帧的缓冲区。 对于OpenGL纹理,这将是质感的ID 。 **See also** [QAbstractVideoBuffer.handle](qabstractvideobuffer.html#handle)( ) 。 ``` QAbstractVideoBuffer.HandleType QVideoFrame.handleType (self) ``` [ 返回一个视频帧的句柄类型。 ``` int QVideoFrame.height (self) ``` 返回一个视频帧的高度。 ](qabstractvideobuffer.html#HandleType-enum) ``` QImage.Format QVideoFrame.imageFormatFromPixelFormat (PixelFormat format) ``` [](qimage.html#Format-enum) [返回一个图像格式等同于一个视频帧的像素_format_。如果没有相等的格式](qimage.html#Format-enum)[QImage.Format_Invalid](qimage.html#Format-enum)返回来代替。 ``` bool QVideoFrame.isMapped (self) ``` 如果一个视频帧的内容被当前映射到系统存储器标识。 这是一个方便的功能,它会检查[MapMode](qabstractvideobuffer.html#MapMode-enum)帧不等于[QAbstractVideoBuffer.NotMapped](qabstractvideobuffer.html#MapMode-enum)。 返回True如果视频帧的内容映射到系统内存,否则返回False 。 **See also** [mapMode](qvideoframe.html#mapMode)()和[QAbstractVideoBuffer.MapMode](qabstractvideobuffer.html#MapMode-enum)。 ``` bool QVideoFrame.isReadable (self) ``` 如果确定一个视频帧的映射内容物从帧中读出时,它被映射。 这是一个方便的功能,如果它检查[MapMode](qabstractvideobuffer.html#MapMode-enum)包含[QAbstractVideoBuffer.WriteOnly](qabstractvideobuffer.html#MapMode-enum)标志。 返回True如果映射的内存中的内容是从视频帧读出,否则返回False 。 **See also** [mapMode](qvideoframe.html#mapMode)()和[QAbstractVideoBuffer.MapMode](qabstractvideobuffer.html#MapMode-enum)。 ``` bool QVideoFrame.isValid (self) ``` 识别的视频帧是否是有效的。 无效帧都有一个与之关联的视频缓冲器。 返回True如果该帧是有效的,并且假,如果事实并非如此。 ``` bool QVideoFrame.isWritable (self) ``` 如果识别视频帧的映射内容时,帧映射将被保存。 这是一个方便的功能,如果它检查[MapMode](qabstractvideobuffer.html#MapMode-enum)包含[QAbstractVideoBuffer.WriteOnly](qabstractvideobuffer.html#MapMode-enum)标志。 返回True ,如果视频帧将被更新,否则取消映射时,假。 **Note:**改变被映射在只读模式中的帧的数据的结果是不确定的。根据不同的缓冲区实现的变更可能会持续存在,或者更糟改变一个共享缓冲区。 **See also** [mapMode](qvideoframe.html#mapMode)()和[QAbstractVideoBuffer.MapMode](qabstractvideobuffer.html#MapMode-enum)。 ``` bool QVideoFrame.map (self, QAbstractVideoBuffer.MapMode mode) ``` 映射一个视频帧的内容到存储器中。 地图_mode_指示是否映射存储器中的内容应被读出和/或写入帧。如果映射模式包括[QAbstractVideoBuffer.ReadOnly](qabstractvideobuffer.html#MapMode-enum)标志映射的内存将被填充的视频帧的内容映射时。如果地图模式inclues的[QAbstractVideoBuffer.WriteOnly](qabstractvideobuffer.html#MapMode-enum)映射的内存的标志内容将被保存在帧映射时。 而映射的一个视频帧的内容可以直接通过由返回的指针来访问[bits](qvideoframe.html#bits)()函数。 当访问数据不再需要,一定要调用[unmap](qvideoframe.html#unmap)( )函数释放映射内存。 返回True如果缓冲区被映射到内存中给定的_mode_否则为False。 **See also** [unmap](qvideoframe.html#unmap)( )[mapMode](qvideoframe.html#mapMode)()和[bits](qvideoframe.html#bits)( ) 。 ``` QAbstractVideoBuffer.MapMode QVideoFrame.mapMode (self) ``` [ 返回一个视频帧被映射到系统存储器英寸的模式 ](qabstractvideobuffer.html#MapMode-enum) [**See also**](qabstractvideobuffer.html#MapMode-enum) [map](qvideoframe.html#map)()和[QAbstractVideoBuffer.MapMode](qabstractvideobuffer.html#MapMode-enum)。 ``` int QVideoFrame.mappedBytes (self) ``` 返回由对应的帧数据所佔用的字节数。 而帧数据是这个值才有效[mapped](qvideoframe.html#map)。 **See also** [map](qvideoframe.html#map)( ) 。 ``` PixelFormat QVideoFrame.pixelFormat (self) ``` [ 返回一个视频帧的颜色格式。 ](qvideoframe.html#PixelFormat-enum) ``` PixelFormat QVideoFrame.pixelFormatFromImageFormat (QImage.Format format) ``` [ 返回一个视频像素格式相当于一个图像_format_。如果没有相等的格式QVideoFrame.InvalidType返回来代替。 ``` QVideoFrame.setEndTime (self, int time) ``` 设置演示文稿_time_当一个帧应停止显示。 ](qvideoframe.html#PixelFormat-enum) [**See also**](qvideoframe.html#PixelFormat-enum) [endTime](qvideoframe.html#endTime)( ) 。 ``` QVideoFrame.setFieldType (self, FieldType) ``` 设置_field_隔行扫描视频帧属于。 **See also** [fieldType](qvideoframe.html#fieldType)( ) 。 ``` QVideoFrame.setStartTime (self, int time) ``` 设置演示文稿_time_当帧的显示方式。 **See also** [startTime](qvideoframe.html#startTime)( ) 。 ``` QSize QVideoFrame.size (self) ``` [ 返回一个视频帧的大小。 ``` int QVideoFrame.startTime (self) ``` 返回时,应显示的帧的显示时间。 ](qsize.html) [**See also**](qsize.html) [setStartTime](qvideoframe.html#setStartTime)( ) 。 ``` QVideoFrame.unmap (self) ``` 发布映射的内存[map](qvideoframe.html#map)()函数。 如果[MapMode](qabstractvideobuffer.html#MapMode-enum)包括[QAbstractVideoBuffer.WriteOnly](qabstractvideobuffer.html#MapMode-enum)标志,这将持续映射内存的当前内容到视频帧。 **See also** [map](qvideoframe.html#map)( ) 。 ``` int QVideoFrame.width (self) ``` 返回一个视频帧的宽度。