QVideoFrame Class Reference · PyQt4 中文文檔

# 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) ``` 返回一個視頻幀的寬度。