QVideoSurfaceFormat Class Reference · PyQt4 中文文檔

# QVideoSurfaceFormat Class Reference ## [[QtMultimedia](index.htm) module] 該QVideoSurfaceFormat類指定視頻演示表面的流格式。[More...](#details) ### Types * `enum Direction { TopToBottom, BottomToTop }` * `enum YCbCrColorSpace { YCbCr_Undefined, YCbCr_BT601, YCbCr_BT709, YCbCr_xvYCC601, YCbCr_xvYCC709, YCbCr_JPEG }` ### Methods * `__init__ (self)` * `__init__ (self, QSize?size, QVideoFrame.PixelFormat?format, QAbstractVideoBuffer.HandleType?type?=?QAbstractVideoBuffer.NoHandle)` * `__init__ (self, QVideoSurfaceFormat?format)` * `int frameHeight (self)` * `float frameRate (self)` * `QSize frameSize (self)` * `int frameWidth (self)` * `QAbstractVideoBuffer.HandleType handleType (self)` * `bool isValid (self)` * `QSize pixelAspectRatio (self)` * `QVideoFrame.PixelFormat pixelFormat (self)` * `QVariant property (self, str?name)` * `list-of-QByteArray propertyNames (self)` * `Direction scanLineDirection (self)` * `setFrameRate (self, float?rate)` * `setFrameSize (self, QSize?size)` * `setFrameSize (self, int?width, int?height)` * `setPixelAspectRatio (self, QSize?ratio)` * `setPixelAspectRatio (self, int?width, int?height)` * `setProperty (self, str?name, QVariant?value)` * `setScanLineDirection (self, Direction?direction)` * `setViewport (self, QRect?viewport)` * `setYCbCrColorSpace (self, YCbCrColorSpace?colorSpace)` * `QSize sizeHint (self)` * `QRect viewport (self)` * `YCbCrColorSpace yCbCrColorSpace (self)` ### Special Methods * `bool __eq__ (self, QVideoSurfaceFormat?format)` * `bool __ne__ (self, QVideoSurfaceFormat?format)` * * * ## Detailed Description 該QVideoSurfaceFormat類指定視頻演示表面的流格式。視頻表面呈現的視頻幀流。表面的形式描述了幀的類型，并確定應如何呈現。需要設置一個視頻表面上的視頻信息流的核心屬性是由給定的像素格式[pixelFormat](qvideosurfaceformat.html#pixelFormat)（），并給出了框架尺寸[frameSize](qvideosurfaceformat.html#frameSize)（）。如果表面是用一幀的把手表面的格式呈現的幀也將包括由給定的一個句柄類型[handleType](qvideosurfaceformat.html#handleType)（）函數。實際上是顯示在視頻面一幀的區域是通過在給定[viewport](qvideosurfaceformat.html#viewport)（）。甲流可具有視口比一幀的整個區域減去，以允許視頻比視頻幀的最接近的最佳尺寸。例如一幀的寬度可以延伸，使得每個掃描行的開始是8字節對齊的。其他常見的屬性是[pixelAspectRatio](qvideosurfaceformat.html#pixelAspectRatio)（）[scanLineDirection](qvideosurfaceformat.html#scanLineDirection)（）和[frameRate](qvideosurfaceformat.html#frameRate)（）。另外一個數據流可以具有所列的dynamicPropertyNames一些額外類型的特定屬性（）函數，并且可以使用被訪問的[property](qvideosurfaceformat.html#property)（）和[setProperty](qvideosurfaceformat.html#setProperty)（）函數。 * * * ## Type Documentation ``` QVideoSurfaceFormat.Direction ``` 列舉的視頻掃描線的布局方向。 | Constant | Value | Description | | --- | --- | --- | | `QVideoSurfaceFormat.TopToBottom` | `0` | 掃描線被布置在框架的頂部向底部。 | | `QVideoSurfaceFormat.BottomToTop` | `1` | 掃描線被布置在框架的底部到頂部。 | ``` QVideoSurfaceFormat.YCbCrColorSpace ``` 列舉了視頻幀的Y'CbCr的色彩空間。 | Constant | Value | Description | | --- | --- | --- | | `QVideoSurfaceFormat.YCbCr_Undefined` | `0` | 未指定的色彩空間。 | | `QVideoSurfaceFormat.YCbCr_BT601` | `1` | 由ITU -R BT.601建議與Y值的范圍從16到235 ，和CB / CR范圍從16到240定義的Y'CbCr的色彩空間。用于標準清晰度視頻。 | | `QVideoSurfaceFormat.YCbCr_BT709` | `2` | 由ITU- R BT.709具有相同的值定義的Y'CbCr的色彩空間范圍內YCbCr_BT601 。用于高清晰度電視。 | | `QVideoSurfaceFormat.YCbCr_xvYCC601` | `3` | 同的數值范圍的BT.601顏色空間擴大到0 ?255。它是落后的。兼容與BT.601和使用外BT.601范圍值來表示更廣泛的色彩范圍。 | | `QVideoSurfaceFormat.YCbCr_xvYCC709` | `4` | 同的數值范圍的BT.709顏色空間擴大到0 ?255。 | | `QVideoSurfaceFormat.YCbCr_JPEG` | `5` | 在JPEG文件中使用的全范圍Y'CbCr的色彩空間。 | * * * ## Method Documentation ``` QVideoSurfaceFormat.__init__ (self) ``` 構造一個空的視頻流格式。 ``` QVideoSurfaceFormat.__init__ (self, QSize?size, QVideoFrame.PixelFormat?format, QAbstractVideoBuffer.HandleType?type?=?QAbstractVideoBuffer.NoHandle) ``` Contructs流的描述，它接收的數據流_type_緩沖區與給定的框架_size_和像素_format_。 ``` QVideoSurfaceFormat.__init__ (self, QVideoSurfaceFormat?format) ``` 構造的副本_other_。 ``` int QVideoSurfaceFormat.frameHeight (self) ``` 返回幀中的視頻流的高度。 ``` float QVideoSurfaceFormat.frameRate (self) ``` 返回以每秒幀數的視頻流的幀速率。 **See also** [setFrameRate](qvideosurfaceformat.html#setFrameRate)（）。 ``` QSize QVideoSurfaceFormat.frameSize (self) ``` [ 返回視頻流中的幀的大小。 ](qsize.html) [**See also**](qsize.html) [setFrameSize](qvideosurfaceformat.html#setFrameSize)（）[frameWidth](qvideosurfaceformat.html#frameWidth)（）和[frameHeight](qvideosurfaceformat.html#frameHeight)（）。 ``` int QVideoSurfaceFormat.frameWidth (self) ``` 返回視頻流中幀的寬度。 **See also** [frameSize](qvideosurfaceformat.html#frameSize)（）和[frameHeight](qvideosurfaceformat.html#frameHeight)（）。 ``` QAbstractVideoBuffer.HandleType QVideoSurfaceFormat.handleType (self) ``` [ 返回表面采用提呈本幀數據處理的類型。 ](qabstractvideobuffer.html#HandleType-enum) [如果句柄類型是](qabstractvideobuffer.html#HandleType-enum)[QAbstractVideoBuffer.NoHandle](qabstractvideobuffer.html#HandleType-enum)緩沖區與任何句柄類型是有效的，只要它們能[mapped](qabstractvideobuffer.html#map)與[QAbstractVideoBuffer.ReadOnly](qabstractvideobuffer.html#MapMode-enum)標志。如果handleType （）不是[QAbstractVideoBuffer.NoHandle](qabstractvideobuffer.html#HandleType-enum)然后緩沖區的句柄類型是相同的，該表面的格式。 ``` bool QVideoSurfaceFormat.isValid (self) ``` 如果識別的視頻格式，表面具有有效像素格式和幀大小。返回True如果該格式是有效的，否則為False。 ``` QSize QVideoSurfaceFormat.pixelAspectRatio (self) ``` [ 返回視頻流的像素寬高比。 ](qsize.html) [**See also**](qsize.html) [setPixelAspectRatio](qvideosurfaceformat.html#setPixelAspectRatio)（）。 ``` QVideoFrame.PixelFormat QVideoSurfaceFormat.pixelFormat (self) ``` [ 返回視頻流中的幀的像素格式。 ``` QVariant QVideoSurfaceFormat.property (self, str?name) ``` 傳回的視頻格式的值_name_屬性。 ](qvideoframe.html#PixelFormat-enum) [**See also**](qvideoframe.html#PixelFormat-enum) [setProperty](qvideosurfaceformat.html#setProperty)（）。 ``` list-of-QByteArray QVideoSurfaceFormat.propertyNames (self) ``` 傳回的視頻格式動態屬性名稱的列表。 ``` Direction QVideoSurfaceFormat.scanLineDirection (self) ``` [ 返回掃描線的方向。 ](qvideosurfaceformat.html#Direction-enum) [**See also**](qvideosurfaceformat.html#Direction-enum) [setScanLineDirection](qvideosurfaceformat.html#setScanLineDirection)（）。 ``` QVideoSurfaceFormat.setFrameRate (self, float?rate) ``` 設置框架_rate_在幀每秒的視頻流。 **See also** [frameRate](qvideosurfaceformat.html#frameRate)（）。 ``` QVideoSurfaceFormat.setFrameSize (self, QSize?size) ``` 設置幀的大小在視頻流中，以_size_。這將重置[viewport](qvideosurfaceformat.html#viewport)（）來填滿整個畫面。 **See also** [frameSize](qvideosurfaceformat.html#frameSize)（）。 ``` QVideoSurfaceFormat.setFrameSize (self, int?width, int?height) ``` 這是一個重載函數。設置_width_和_height_的幀中的視頻流。這將重置[viewport](qvideosurfaceformat.html#viewport)（）來填滿整個畫面。 ``` QVideoSurfaceFormat.setPixelAspectRatio (self, QSize?ratio) ``` 設置一個視頻流的像素寬高比_ratio_。 **See also** [pixelAspectRatio](qvideosurfaceformat.html#pixelAspectRatio)（）。 ``` QVideoSurfaceFormat.setPixelAspectRatio (self, int?width, int?height) ``` 這是一個重載函數。設置_horizontal_和_vertical_的視頻流的像素寬高比的元素。 ``` QVideoSurfaceFormat.setProperty (self, str?name, QVariant?value) ``` 設置視頻格式的_name_屬性為_value_。 **See also** [property](qvideosurfaceformat.html#property)（）。 ``` QVideoSurfaceFormat.setScanLineDirection (self, Direction?direction) ``` 設置_direction_的掃描線。 **See also** [scanLineDirection](qvideosurfaceformat.html#scanLineDirection)（）。 ``` QVideoSurfaceFormat.setViewport (self, QRect?viewport) ``` 設置一個視頻流的視口_viewport_。 **See also** [viewport](qvideosurfaceformat.html#viewport)（）。 ``` QVideoSurfaceFormat.setYCbCrColorSpace (self, YCbCrColorSpace?colorSpace) ``` 設置Y'CbCr的顏色_space_的視頻流。它僅用于與原始YUV幀類型。 **See also** [yCbCrColorSpace](qvideosurfaceformat.html#yCbCrColorSpace)（）。 ``` QSize QVideoSurfaceFormat.sizeHint (self) ``` [ 返回視頻流像素的建議的大小。這是根據該像素縱橫比縮放的視口的大小。 ](qsize.html) ``` QRect QVideoSurfaceFormat.viewport (self) ``` [ 返回視頻流的視口。視口是實際顯示一個視頻幀的區域。默認情況下，視口復蓋整個幀。 ](qrect.html) [**See also**](qrect.html) [setViewport](qvideosurfaceformat.html#setViewport)（）。 ``` YCbCrColorSpace QVideoSurfaceFormat.yCbCrColorSpace (self) ``` [ 返回視頻流的Y'CbCr的色彩空間。 ](qvideosurfaceformat.html#YCbCrColorSpace-enum) [**See also**](qvideosurfaceformat.html#YCbCrColorSpace-enum) [setYCbCrColorSpace](qvideosurfaceformat.html#setYCbCrColorSpace)（）。 ``` bool QVideoSurfaceFormat.__eq__ (self, QVideoSurfaceFormat?format) ``` ``` bool QVideoSurfaceFormat.__ne__ (self, QVideoSurfaceFormat?format) ```