|
|
              
QAbstractVideoBuffer ClassThe QAbstractVideoBuffer class is an abstraction for video data. More... #include <QAbstractVideoBuffer>
Public Types
Public Functions
Detailed DescriptionThe QAbstractVideoBuffer class is an abstraction for video data. The QVideoFrame class makes use of a QAbstractVideoBuffer internally to reference a buffer of video data. Quite often video data buffers may reside in video memory rather than system memory, and this class provides an abstraction of the location. In addition, creating a subclass of QAbstractVideoBuffer will allow you to construct video frames from preallocated or static buffers, in cases where the QVideoFrame constructors taking a QByteArray or a QImage do not suffice. This may be necessary when implementing a new hardware accelerated video system, for example. The contents of a buffer can be accessed by mapping the buffer to memory using the map() function, which returns a pointer to memory containing the contents of the the video buffer. The memory returned by map() is released by calling the unmap() function. The handle() of a buffer may also be used to manipulate its contents using type specific APIs. The type of a buffer's handle is given by the handleType() function. See also QVideoFrame. Member Type Documentation
|
| Constant | Value | Description |
|---|---|---|
| QAbstractVideoBuffer::NoHandle | 0 | The buffer has no handle, its data can only be accessed by mapping the buffer. |
| QAbstractVideoBuffer::GLTextureHandle | 1 | The handle of the buffer is an OpenGL texture ID. |
| QAbstractVideoBuffer::XvShmImageHandle | 2 | The handle contains pointer to shared memory XVideo image. |
| QAbstractVideoBuffer::CoreImageHandle | 3 | The handle contains pointer to Mac OS X CIImage. |
| QAbstractVideoBuffer::QPixmapHandle | 4 | The handle of the buffer is a QPixmap. |
| QAbstractVideoBuffer::UserHandle | 1000 | Start value for user defined handle types. |
See also handleType().
enum QAbstractVideoBuffer::MapMode
Enumerates how a video buffer's data is mapped to system memory.
| Constant | Value | Description |
|---|---|---|
| QAbstractVideoBuffer::NotMapped | 0x00 | The video buffer is not mapped to memory. |
| QAbstractVideoBuffer::ReadOnly | 0x01 | The mapped memory is populated with data from the video buffer when mapped, but the content of the mapped memory may be discarded when unmapped. |
| QAbstractVideoBuffer::WriteOnly | 0x02 | The mapped memory is uninitialized when mapped, but the possibly modified content will be used to populate the video buffer when unmapped. |
| QAbstractVideoBuffer::ReadWrite | ReadOnly | WriteOnly | The mapped memory is populated with data from the video buffer, and the video buffer is repopulated with the content of the mapped memory when it is unmapped. |
Member Function Documentation
QAbstractVideoBuffer::QAbstractVideoBuffer(HandleType type)
Constructs an abstract video buffer of the given type.
QAbstractVideoBuffer::~QAbstractVideoBuffer() [virtual]
Destroys an abstract video buffer.
QVariant QAbstractVideoBuffer::handle() const [virtual]
Returns a type specific handle to the data buffer.
The type of the handle is given by handleType() function.
See also handleType().
HandleType QAbstractVideoBuffer::handleType() const
Returns the type of a video buffer's handle.
See also handle().
uchar * QAbstractVideoBuffer::map(MapMode mode, int * numBytes, int * bytesPerLine) [pure virtual]
Maps the contents of a video buffer to memory.
In some cases the video buffer might be stored in video memory or otherwise inaccessible memory, so it is necessary to map the buffer before accessing the pixel data. This may involve copying the contents around, so avoid mapping and unmapping unless required.
The map mode indicates whether the contents of the mapped memory should be read from and/or written to the buffer. If the map mode includes the QAbstractVideoBuffer::ReadOnly flag the mapped memory will be populated with the content of the buffer when initially mapped. If the map mode includes the QAbstractVideoBuffer::WriteOnly flag the content of the possibly modified mapped memory will be written back to the buffer when unmapped.
When access to the data is no longer needed be sure to call the unmap() function to release the mapped memory and possibly update the buffer contents.
Returns a pointer to the mapped memory region, or a null pointer if the mapping failed. The size in bytes of the mapped memory region is returned in numBytes, and the line stride in bytesPerLine.
Note: Writing to memory that is mapped as read-only is undefined, and may result in changes to shared data or crashes.
See also unmap() and mapMode().
MapMode QAbstractVideoBuffer::mapMode() const [pure virtual]
Returns the mode a video buffer is mapped in.
See also map().
void QAbstractVideoBuffer::unmap() [pure virtual]
Releases the memory mapped by the map() function.
If the MapMode included the QAbstractVideoBuffer::WriteOnly flag this will write the current content of the mapped memory back to the video frame.
See also map().