Класс QAbstractVideoBuffer

Класс QAbstractVideoBuffer является абстракцией для видеоданных. Подробнее...

• Список всех членов, включая наследуемые

Типы публичного доступа

Функции публичного доступа

Подробное описание

Класс QVideoFrame использует QAbstractVideoBuffer в качестве внутреннего объекта для ссылки на буфер видеоданных. Часто буферы видеоданных могут находиться в видеопамяти, а не в оперативной памяти, и этот класс предоставляет абстракцию расположения.

Кроме того, создание подкласса QAbstractVideoBuffer позволит вам создавать видеокадры из предварительно выделенных или статических буферов в тех случаях, когда конструкторы QVideoFrame, принимающие QByteArray или QImage, не подходят. Это может потребоваться при реализации новой системы видеообработки с аппаратным ускорением, например.

В содержимое буфера можно получить доступ, отобразив буфер в оперативную память с помощью функции map(), которая возвращает указатель на память, содержащую содержимое видеобуфера. Память, возвращенная функцией map(), освобождается путем вызова функции unmap().

Дескриптор (handle) буфера также может быть использован для управления его содержимым с помощью специфичных для типа API. Тип дескриптора буфера задается функцией handleType().

См. также QVideoFrame.

Документация типов членов

Перечисление QAbstractVideoBuffer::HandleType

Определяет тип дескриптора (handle) видеобуфера.

См. также handleType().

Перечисление QAbstractVideoBuffer::MapMode

Перечисляет способы отображения данных видеобуфера в оперативную память.

См. также mapMode() и map().

Документация функций членов

QAbstractVideoBuffer::QAbstractVideoBuffer(QAbstractVideoBuffer::HandleType type)

Создает абстрактный видеобуфер заданного типа type.

[virtual] QAbstractVideoBuffer::~QAbstractVideoBuffer()

Удаляет абстрактный видеобуфер.

[virtual] QVariant QAbstractVideoBuffer::handle() const

Возвращает специфичный для типа дескриптор (handle) буфера данных.

Тип дескриптора (handle) задается функцией handleType().

См. также handleType().

QAbstractVideoBuffer::HandleType QAbstractVideoBuffer::handleType() const

Возвращает тип дескриптора (handle) видеобуфера.

См. также handle().

[pure virtual] uchar *QAbstractVideoBuffer::map(QAbstractVideoBuffer::MapMode mode, int *numBytes, int *bytesPerLine)

Отображает содержимое видеобуфера в оперативную память.

В некоторых случаях видеобуфер может храниться в видеопамяти или в другой недоступной памяти, поэтому необходимо отобразить буфер перед доступом к данным пикселей. Это может включать копирование содержимого, поэтому избегайте отображения и скрытия, если это не требуется.

Режим отображения mode указывает, должно ли содержимое отображенной памяти считываться и/или записываться в буфер. Если режим отображения включает флаг QAbstractVideoBuffer::ReadOnly, отображенная память будет заполнена содержимым буфера при первоначальном отображении. Если режим отображения включает флаг QAbstractVideoBuffer::WriteOnly, содержимое, возможно, измененной отображенной памяти, будет записано обратно в буфер при скрытии.

Когда доступ к данным больше не нужен, убедитесь, что вызывается функция unmap(), чтобы освободить отображенную память и, возможно, обновить содержимое буфера.

Возвращает указатель на область отображенной памяти или нулевой указатель, если отображение завершилось неудачно. Размер отображенной области памяти в байтах возвращается в numBytes, а шаг строки в bytesPerLine.

Примечание: Запись в память, отображенную как только для чтения, является неопределенной и может привести к изменениям в общих данных или сбоям.

См. также unmap() и mapMode().

[pure virtual] QAbstractVideoBuffer::MapMode QAbstractVideoBuffer::mapMode() const

Возвращает режим отображения видеобуфера.

См. также map().

int QAbstractVideoBuffer::mapPlanes(QAbstractVideoBuffer::MapMode mode, int *numBytes, int [4] bytesPerLine = 4, uchar *[4] data = 4)

Независимо отображает плоскости буфера видео в память.

Режим отображения mode указывает, следует ли читать и/или записывать содержимое отображенной памяти в буфер. Если режим отображения включает флаг QAbstractVideoBuffer::ReadOnly, отображенная память будет заполнена содержимым буфера при первоначальном отображении. Если режим отображения включает флаг QAbstractVideoBuffer::WriteOnly, содержимое, возможно, изменённой отображенной памяти будет записано обратно в буфер при развязке.

Когда доступ к данным больше не требуется, обязательно вызовите функцию unmap() для освобождения отображенной памяти и, возможно, обновления содержимого буфера.

Возвращает количество плоскостей в отображенных видеоданных. Для каждой плоскости шаг строки этой плоскости будет возвращен в bytesPerLine, а указатель на данные плоскости будет возвращен в data. Кумулятивный размер отображенных данных возвращается в numBytes.

Не все реализации буферов будут отображать более чем первую плоскость. Если это возвращает одну плоскость для планарного формата, дополнительные плоскости необходимо будет рассчитать из шага строки первой плоскости и высоты кадра. Отображение буфера с QVideoFrame сделает это за вас.

Для реализации этой функции создайте производный класс от QAbstractPlanarVideoBuffer и реализуйте вместо этого экземпляр его функции map.

Эта функция была введена в Qt 5.4.

[virtual] void QAbstractVideoBuffer::release()

Освобождает буфер видео.

QVideoFrame вызывает QAbstractVideoBuffer::release, когда буфер больше не используется и может быть уничтожен или возвращён в пул буферов.

Реализация по умолчанию удаляет экземпляр буфера.

[pure virtual] void QAbstractVideoBuffer::unmap()

Освобождает память, отображённую функцией map().

Если MapMode включал флаг QAbstractVideoBuffer::WriteOnly, это запишет текущее содержимое отображенной памяти обратно в видеокадр.

См. также map().