# QAbstractVideoSurface Class Reference ## [[QtMultimedia](index.htm) module] 該QAbstractVideoSurface類是視頻演示表面的基類。[More...](#details) 繼承[QObject](qobject.html)。 ### Types * `enum Error { NoError, UnsupportedFormatError, IncorrectFormatError, StoppedError, ResourceError }` ### Methods * `__init__ (self, QObject?parent?=?None)` * `Error error (self)` * `bool isActive (self)` * `bool isFormatSupported (self, QVideoSurfaceFormat?format)` * `QVideoSurfaceFormat nearestFormat (self, QVideoSurfaceFormat?format)` * `bool present (self, QVideoFrame?frame)` * `setError (self, Error?error)` * `bool start (self, QVideoSurfaceFormat?format)` * `stop (self)` * `list-of-QVideoFrame.PixelFormat supportedPixelFormats (self, QAbstractVideoBuffer.HandleType?type?=?QAbstractVideoBuffer.NoHandle)` * `QVideoSurfaceFormat surfaceFormat (self)` ### Qt Signals * `void activeChanged (bool)` * `void supportedFormatsChanged ()` * `void surfaceFormatChanged (const QVideoSurfaceFormat&)` * * * ## Detailed Description 該QAbstractVideoSurface類是視頻演示表面的基類。 該QAbstractVideoSurface類定義了視頻制作者用它來與視頻演示表面互操作的標準接口。它不應該被直接實例化。相反，你應該繼承它來創建新的視頻表面。 一種視頻表面呈現格式相同的幀，其中每個幀的格式與開始演示時供給的流格式兼容的連續流。 像素的列表格式的表面可呈現由給定[supportedPixelFormats](qabstractvideosurface.html#supportedPixelFormats)（）函數，并且[isFormatSupported](qabstractvideosurface.html#isFormatSupported)（）函數將測試是否受支持的視頻格式表面。如果不支持的格式[nearestFormat](qabstractvideosurface.html#nearestFormat)（）函數可能能夠提供一個類似的格式。例如，如果一個表面上支持固定的分辨率可能暗示包含提呈之決議案的最小支持的分辨率。 該[start](qabstractvideosurface.html#start)（ ）函數接受一個支持的格式，使視頻的表面。一旦開始了表面會開始顯示它接收的幀[present](qabstractvideosurface.html#present)（）函數。表面可持有，直到一個新的框架，提出或流停止時的參考，提出了視頻幀的緩沖區。該[stop](qabstractvideosurface.html#stop)（ ）函數將禁用表面和發布任何視頻緩沖其持有的引用。 * * * ## Type Documentation ``` QAbstractVideoSurface.Error ``` 該枚舉描述了可以通過返回的錯誤[error](qabstractvideosurface.html#error)（）函數。 | Constant | Value | Description | | --- | --- | --- | | `QAbstractVideoSurface.NoError` | `0` | 未發生錯誤。 | | `QAbstractVideoSurface.UnsupportedFormatError` | `1` | 不支持的視頻格式。 | | `QAbstractVideoSurface.IncorrectFormatError` | `2` | 一個視頻幀是不與該表面的格式不兼容。 | | `QAbstractVideoSurface.StoppedError` | `3` | 表面尚未啟動。 | | `QAbstractVideoSurface.ResourceError` | `4` | 表面無法分配一些資源。 | * * * ## Method Documentation ``` QAbstractVideoSurface.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個視頻面與給定_parent_。 ``` Error QAbstractVideoSurface.error (self) ``` [ 返回所發生的最后一個錯誤。 ](qabstractvideosurface.html#Error-enum) [如果表面不](qabstractvideosurface.html#Error-enum)[start](qabstractvideosurface.html#start)（ ） ，或意外停止此功能可以被調用來發現什么錯誤發生。 **See also** [setError](qabstractvideosurface.html#setError)（ ） 。 ``` bool QAbstractVideoSurface.isActive (self) ``` 表示視頻表面是否已經啟動。 返回True如果表面已經啟動，否則返回False 。 ``` bool QAbstractVideoSurface.isFormatSupported (self, QVideoSurfaceFormat?format) ``` 測試一個視頻面_format_以確定是否一個面都能接受。 如果格式是由表面支撐，否則為False ，則返回True 。 ``` QVideoSurfaceFormat QAbstractVideoSurface.nearestFormat (self, QVideoSurfaceFormat?format) ``` [ 返回一個支持的視頻格式的表面，類似于_format_。 ](qvideosurfaceformat.html) [類似的表面格式是一個具有相同](qvideosurfaceformat.html)[pixel format](qvideosurfaceformat.html#pixelFormat)和[handle type](qvideosurfaceformat.html#handleType)但在其他一些特性是不同的。例如，如果有就限制[frame sizes](qvideosurfaceformat.html#frameSize)視頻表面可以接受它可能意味著一種格式具有較大的幀大小和[viewport](qvideosurfaceformat.html#viewport)原始幀尺寸的大小。 如果已支持的格式也將原樣返回，或如果沒有類似支持的格式無效的格式將被退回。 ``` bool QAbstractVideoSurface.present (self, QVideoFrame?frame) ``` 這種方法是抽象的，應在任何子類中重新實現。 提出了一個視頻_frame_。 返回True如果在發生錯誤的幀被提出，并假的。 不是所有的表面將被阻塞，直到一個幀的顯示已經完成。如果調用前一幀的呈現完成之前無阻塞表面上調用存在（ ）可能會失敗。在這種情況下，直到它有機會處理事件的表面可能不會返回到就緒狀態。 如果存在（ ）失敗因任何其他原因，表面會立即進入停止狀態和[error](qabstractvideosurface.html#error)（ ）值將被設置。 視頻表面必須處于啟動狀態的存在（ ）成功，和視頻幀的格式必須與當前的視頻表面格式兼容。 **See also** [error](qabstractvideosurface.html#error)（ ） 。 ``` QAbstractVideoSurface.setError (self, Error?error) ``` 設置的值[error](qabstractvideosurface.html#error)（）來_error_。 **See also** [error](qabstractvideosurface.html#error)（ ） 。 ``` bool QAbstractVideoSurface.start (self, QVideoSurfaceFormat?format) ``` 開始視頻表面呈現_format_幀。 如果表面已經開始，并且假，如果發生錯誤，則返回True 。 **See also** [isActive](qabstractvideosurface.html#isActive)（）和[stop](qabstractvideosurface.html#stop)（ ） 。 ``` QAbstractVideoSurface.stop (self) ``` 停止視頻表面呈現幀并釋放所收購的任何資源[start](qabstractvideosurface.html#start)（ ） 。 **See also** [isActive](qabstractvideosurface.html#isActive)（）和[start](qabstractvideosurface.html#start)（ ） 。 ``` list-of-QVideoFrame.PixelFormat QAbstractVideoSurface.supportedPixelFormats (self, QAbstractVideoBuffer.HandleType?type?=?QAbstractVideoBuffer.NoHandle) ``` 這種方法是抽象的，應在任何子類中重新實現。 返回的像素格式的視頻表面可呈現為一個給定的句柄列表_type_。 像素格式返回的[QAbstractVideoBuffer.NoHandle](qabstractvideobuffer.html#HandleType-enum)類型是有效的，可以映射到只讀模式的任何緩沖區。 這是第一個在列表中的類型可以被假定為更快的渲染。 ``` QVideoSurfaceFormat QAbstractVideoSurface.surfaceFormat (self) ``` [ 返回視頻表面的格式。 * * * ## Qt Signal Documentation ``` void activeChanged (bool) ``` 這是該信號的默認超載。 信號的_active_視頻表面狀態發生了變化。 ](qvideosurfaceformat.html) [**See also**](qvideosurfaceformat.html) [isActive](qabstractvideosurface.html#isActive)（ ）[start](qabstractvideosurface.html#start)（）和[stop](qabstractvideosurface.html#stop)（ ） 。 ``` void supportedFormatsChanged () ``` 這是該信號的默認超載。 該組由視頻表面支持的格式發生了變化的信號。 **See also** [supportedPixelFormats](qabstractvideosurface.html#supportedPixelFormats)（）和[isFormatSupported](qabstractvideosurface.html#isFormatSupported)（ ） 。 ``` void surfaceFormatChanged (const QVideoSurfaceFormat&) ``` 這是該信號的默認超載。 所配置的信號_format_的一個視頻表面發生了變化。 **See also** [surfaceFormat](qabstractvideosurface.html#surfaceFormat)（）和[start](qabstractvideosurface.html#start)（ ） 。