# QAbstractVideoBuffer Class Reference ## [[QtMultimedia](index.htm) module] 該QAbstractVideoBuffer類是視頻數據的抽象。[More...](#details) ### Types * `enum HandleType { NoHandle, GLTextureHandle, XvShmImageHandle, CoreImageHandle, QPixmapHandle, UserHandle }` * `enum MapMode { NotMapped, ReadOnly, WriteOnly, ReadWrite }` ### Methods * `__init__ (self, HandleType?type)` * `QVariant handle (self)` * `HandleType handleType (self)` * `(sip.voidptr, int?numBytes, int?bytesPerLine) map (self, MapMode?mode)` * `MapMode mapMode (self)` * `unmap (self)` * * * ## Detailed Description 該QAbstractVideoBuffer類是視頻數據的抽象。 該[QVideoFrame](qvideoframe.html)類利用一個QAbstractVideoBuffer的內部參考視頻數據的緩沖區。創建QAbstractVideoBuffer的子類可以讓你從預分配或靜態緩沖構造的視頻幀。 一個緩沖區的內容可以通過使用緩沖映射到存儲器進行訪問的[map](qabstractvideobuffer.html#map)（）函數返回一個指針，指向包含在視頻緩沖器中的內容的記憶。通過返回的內存[map](qabstractvideobuffer.html#map)（ ）被釋放通過調用[unmap](qabstractvideobuffer.html#unmap)（）函數。 該[handle](qabstractvideobuffer.html#handle)的緩沖液（）也可以被用來操縱它的使用類型特定的API含量。的緩沖器的句柄類型是由給定的[handleType](qabstractvideobuffer.html#handleType)（）函數。 * * * ## Type Documentation ``` QAbstractVideoBuffer.HandleType ``` 確定了視頻緩沖器處理的類型。 | Constant | Value | Description | | --- | --- | --- | | `QAbstractVideoBuffer.NoHandle` | `0` | 該緩沖液具有無手柄，它的數據只能通過映射緩沖存取。 | | `QAbstractVideoBuffer.GLTextureHandle` | `1` | 緩沖區的句柄是一個OpenGL紋理的ID 。 | | `QAbstractVideoBuffer.XvShmImageHandle` | `2` | 手柄中包含指向共享內存的XVideo形象。 | | `QAbstractVideoBuffer.CoreImageHandle` | `3` | 手柄包含指針到Mac OS X CIImage 。 | | `QAbstractVideoBuffer.QPixmapHandle` | `4` | 緩沖區的把手是[QPixmap](qpixmap.html)。 | | `QAbstractVideoBuffer.UserHandle` | `1000` | 用戶定義句柄類型起始值。 | **See also** [handleType](qabstractvideobuffer.html#handleType)（ ） 。 ``` QAbstractVideoBuffer.MapMode ``` 列舉了視頻緩沖器的數據是如何映射到內存。 | Constant | Value | Description | | --- | --- | --- | | `QAbstractVideoBuffer.NotMapped` | `0x00` | 視頻緩沖區沒有映射到內存。 | | `QAbstractVideoBuffer.ReadOnly` | `0x01` | 映射的內存中填充了從視頻緩沖區中的數據映射時，但映射的內存的內容可能會被丟棄時映射。 | | `QAbstractVideoBuffer.WriteOnly` | `0x02` | 所映射的存儲器是未初始化的映射時，內容將被用于映射時填充視頻緩沖器。 | | `QAbstractVideoBuffer.ReadWrite` | `ReadOnly | WriteOnly` | 所映射的存儲器中填充了從視頻緩沖器中的數據，和視頻緩沖器被重新填充與映射的存儲器的內容。 | **See also** [mapMode](qabstractvideobuffer.html#mapMode)（）和[map](qabstractvideobuffer.html#map)（ ） 。 * * * ## Method Documentation ``` QAbstractVideoBuffer.__init__ (self, HandleType?type) ``` 構造給定一個抽象的視頻緩沖器_type_。 ``` QVariant QAbstractVideoBuffer.handle (self) ``` 返回一個類型的具體處理到數據緩沖區。 手柄的類型由下式給出[handleType](qabstractvideobuffer.html#handleType)（）函數。 **See also** [handleType](qabstractvideobuffer.html#handleType)（ ） 。 ``` HandleType QAbstractVideoBuffer.handleType (self) ``` [ 傳回的視頻緩沖區的句柄類型。 ](qabstractvideobuffer.html#HandleType-enum) [**See also**](qabstractvideobuffer.html#HandleType-enum) [handle](qabstractvideobuffer.html#handle)（ ） 。 ``` (sip.voidptr, int?numBytes, int?bytesPerLine) QAbstractVideoBuffer.map (self, MapMode?mode) ``` 這種方法是抽象的，應在任何子類中重新實現。 映射一個視頻緩沖器的內容傳送到存儲器中。 地圖_mode_指示是否映射存儲器中的內容應被讀出和/或寫入到緩沖區。如果映射模式包括[QAbstractVideoBuffer.ReadOnly](qabstractvideobuffer.html#MapMode-enum)標志映射的內存將被填入視頻緩沖區的內容映射時。如果映射模式包括[QAbstractVideoBuffer.WriteOnly](qabstractvideobuffer.html#MapMode-enum)映射的內存的標志內容將被保存在緩沖區中，當未映射。 當訪問數據不再需要，一定要調用[unmap](qabstractvideobuffer.html#unmap)（ ）函數釋放映射內存。 返回一個指針映射內存區域，或一個空指針，如果映射失敗。在映射內存區域的字節大小的返回_numBytes_和線步幅在_bytesPerLine_。 當訪問數據不再需要，一定要[unmap](qabstractvideobuffer.html#unmap)（）的緩沖液中。 **Note:**記錄到被映射為只讀存儲器是不確定的，并且可能導致改變的共享數據。 **See also** [unmap](qabstractvideobuffer.html#unmap)（）和[mapMode](qabstractvideobuffer.html#mapMode)（ ） 。 ``` MapMode QAbstractVideoBuffer.mapMode (self) ``` [ 這種方法是抽象的，應在任何子類中重新實現。 返回視頻緩沖器被映射英寸的模式 ](qabstractvideobuffer.html#MapMode-enum) [**See also**](qabstractvideobuffer.html#MapMode-enum) [map](qabstractvideobuffer.html#map)（ ） 。 ``` QAbstractVideoBuffer.unmap (self) ``` 這種方法是抽象的，應在任何子類中重新實現。 發布映射的內存[map](qabstractvideobuffer.html#map)（ ）函數 如果[MapMode](qabstractvideobuffer.html#MapMode-enum)包括[QAbstractVideoBuffer.WriteOnly](qabstractvideobuffer.html#MapMode-enum)標志，這將持續映射內存的當前內容到視頻幀。 **See also** [map](qabstractvideobuffer.html#map)（ ） 。