Qt
Internal/Contributor docs for the Qt SDK. <b>Note:</b> These are NOT official API docs; those are found <a href='https://doc.qt.io/'>here</a>.
Loading...
Searching...
No Matches
QCGImageVideoBuffer Class Reference
+ Inheritance diagram for QCGImageVideoBuffer:
+ Collaboration diagram for QCGImageVideoBuffer:

Public Member Functions

 QCGImageVideoBuffer (CGImageRef image)
 
 ~QCGImageVideoBuffer () override
 
MapData map (QtVideo::MapMode) override
 Maps the planes of a video buffer to memory.
 
QVideoFrameFormat format () const override
 Gets \l QVideoFrameFormat of the underlying video buffer.
 
- Public Member Functions inherited from QAbstractVideoBuffer
virtual ~QAbstractVideoBuffer ()
 \variable QAbstractVideoBuffer::MapData::planeCount
 
virtual void unmap ()
 Releases the memory mapped by the map() function.
 

Detailed Description

Definition at line 41 of file qcgwindowcapture.mm.

Constructor & Destructor Documentation

◆ QCGImageVideoBuffer()

QCGImageVideoBuffer::QCGImageVideoBuffer ( CGImageRef image)
inline

Definition at line 44 of file qcgwindowcapture.mm.

◆ ~QCGImageVideoBuffer()

QCGImageVideoBuffer::~QCGImageVideoBuffer ( )
inlineoverride

Definition at line 51 of file qcgwindowcapture.mm.

Member Function Documentation

◆ format()

QVideoFrameFormat QCGImageVideoBuffer::format ( ) const
inlineoverridevirtual

Gets \l QVideoFrameFormat of the underlying video buffer.

The format must be available upon construction of \l QVideoFrame. QVideoFrame will contain won instance of the given format, that can be detached and modified.

Implements QAbstractVideoBuffer.

Definition at line 65 of file qcgwindowcapture.mm.

◆ map()

MapData QCGImageVideoBuffer::map ( QtVideo::MapMode mode)
inlineoverridevirtual

Maps the planes of a video buffer to memory.

Returns a \l MapData structure that contains information about the plane layout of the mapped current video data. If the mapping fails, the method returns the default structure. For CPU memory buffers, the data is considered as already mapped, so the function just returns the plane layout of the preallocated underlying data.

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 QtVideo::MapMode::WriteOnly flag, the content of the possibly modified mapped memory is expected to be written back to the buffer when unmapped.

When access to the data is no longer needed, the \l unmap function is called to release the mapped memory and possibly update the buffer contents.

If the format of the video data is multiplanar, the method may map the whole pixel data as a single plane. In this case, mapping a buffer with \l QVideoFrame will calculate additional planes from the specified line stride of the first plane, the frame height, and the data size.

Implements QAbstractVideoBuffer.

Definition at line 53 of file qcgwindowcapture.mm.

References mapData().

+ Here is the call graph for this function:

The documentation for this class was generated from the following file: