Класс QVideoFrame

Класс QVideoFrame представляет кадр видеоданных. Подробнее...

Заголовок:	#include <QVideoFrame>
qmake:	QT += multimedia

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

Типы

Перечисление	FieldType { ProgressiveFrame, TopField, BottomField, InterlacedFrame }
Перечисление	PixelFormat { Format_Invalid, Format_ARGB32, Format_ARGB32_Premultiplied, Format_RGB32, ..., Format_User }

Открытые функции

	QVideoFrame()
	QVideoFrame(QAbstractVideoBuffer *buffer, const QSize &size, PixelFormat format)
	QVideoFrame(int bytes, const QSize &size, int bytesPerLine, PixelFormat format)
	QVideoFrame(const QImage &image)
	QVideoFrame(const QVideoFrame &other)
	~QVideoFrame()
QVariantMap	availableMetaData() const
uchar *	bits()
QSize	size() const
qint64	startTime() const
void	unmap()
int	width() const
bool	operator!=(const QVideoFrame &other) const
QVideoFrame &	operator=(const QVideoFrame &other)
bool	operator==(const QVideoFrame &other) const

Статические открытые члены

QImage::Format	imageFormatFromPixelFormat(PixelFormat format)
PixelFormat	pixelFormatFromImageFormat(QImage::Format format)

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

Класс QVideoFrame представляет кадр видеоданных.

Класс QVideoFrame инкапсулирует пиксельные данные кадра видео и информацию о кадре.

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

Содержание пикселей видеокадра может быть отображено в памяти с помощью функции map(). В процессе отображения к видеоданным можно получить доступ с помощью функции bits(), которая возвращает указатель на буфер. Общий размер этого буфера задаётся функцией mappedBytes(), а размер каждой строки - функцией bytesPerLine(). Возвращаемое значение функции handle() также может быть использовано для доступа к данным кадра с помощью собственных API внутреннего буфера (например, идентификатор текстуры OpenGL).

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

Видеоданные пикселей в QVideoFrame инкапсулированы в QAbstractVideoBuffer. Класс QVideoFrame может быть создан из любого типа буфера путём наследования класса QAbstractVideoBuffer.

Примечание: Поскольку копирование видеокадров может быть ресурсоёмкой операцией, класс QVideoFrame специально реализован с поддержкой совместного использования, поэтому любые изменения, внесённые в видеокадр, также применяются к любым его копиям.

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

перечисление QVideoFrame::FieldType

Указывает поле, к которому относится интерлинованный видеокадр.

Постоянная	Значение	Описание
`QVideoFrame::ProgressiveFrame`	`0`	Кадр не чересстрочный.
`QVideoFrame::TopField`	`1`	Кадр содержит верхнее поле.
`QVideoFrame::BottomField`	`2`	Кадр содержит нижнее поле.
`QVideoFrame::InterlacedFrame`	`3`	Кадр содержит объединённое верхнее и нижнее поле.

enum QVideoFrame::PixelFormat

Перечисляет типы видеоданных.

Постоянная	Значение	Описание
`QVideoFrame::Format_Invalid`	`0`	Кадр недействителен.
`QVideoFrame::Format_ARGB32`	`1`	Кадр хранится в формате ARGB 32 бита (0xAARRGGBB). Эквивалентен QImage::Format_ARGB32.
`QVideoFrame::Format_ARGB32_Premultiplied`	`2`	Кадр хранится в предопределённом формате ARGB 32 бита (0xAARRGGBB). Эквивалентен QImage::Format_ARGB32_Premultiplied.
`QVideoFrame::Format_RGB32`	`3`	Кадр хранится в формате RGB 32 бита (0xffRRGGBB). Эквивалентен QImage::Format_RGB32
`QVideoFrame::Format_RGB24`	`4`	Кадр хранится в формате RGB 24 бита (8-8-8). Эквивалентен QImage::Format_RGB888
`QVideoFrame::Format_RGB565`	`5`	Кадр хранится в формате RGB 16 бита (5-6-5). Эквивалентен QImage::Format_RGB16.
`QVideoFrame::Format_RGB555`	`6`	Кадр хранится в формате RGB 16 бита (5-5-5). Эквивалентен QImage::Format_RGB555.
`QVideoFrame::Format_ARGB8565_Premultiplied`	`7`	Кадр хранится в предопределённом формате ARGB 24 бита (8-5-6-5).
`QVideoFrame::Format_BGRA32`	`8`	Кадр хранится в формате BGRA 32 бита (0xBBGGRRAA).
`QVideoFrame::Format_BGRA32_Premultiplied`	`9`	Кадр хранится в предопределённом формате BGRA 32 бита.
`QVideoFrame::Format_BGR32`	`10`	Кадр хранится в формате BGR 32 бита (0xBBGGRRff).
`QVideoFrame::Format_BGR24`	`11`	Кадр хранится в формате BGR 24 бита (0xBBGGRR).
`QVideoFrame::Format_BGR565`	`12`	Кадр хранится в формате BGR 16 бита (5-6-5).
`QVideoFrame::Format_BGR555`	`13`	Кадр хранится в формате BGR 16 бита (5-5-5).
`QVideoFrame::Format_BGRA5658_Premultiplied`	`14`	Кадр хранится в предопределённом формате BGRA 24 бита (5-6-5-8).
`QVideoFrame::Format_AYUV444`	`15`	Кадр хранится в упакованном формате AYUV 32 бита (0xAAYYUUVV).
`QVideoFrame::Format_AYUV444_Premultiplied`	`16`	Кадр хранится в предопределённом упакованном формате AYUV 32 бита (0xAAYYUUVV).
`QVideoFrame::Format_YUV444`	`17`	Кадр хранится в формате YUV 24 бита (8-8-8).
`QVideoFrame::Format_YUV420P`	`18`	Кадр хранится в планарном формате YUV 8 бит на компонент, с подвыборочным размещением U и V планов по горизонтали и вертикали (половина высоты и ширины по сравнению с планом Y).
`QVideoFrame::Format_YV12`	`19`	Кадр хранится в планарном формате YVU 8 бит на компонент, с подвыборочным размещением V и U планов по горизонтали и вертикали (половина высоты и ширины по сравнению с планом Y).
`QVideoFrame::Format_UYVY`	`20`	Кадр хранится в упакованном формате YUV 8 бит на компонент с подвыборочным размещением U и V планов по горизонтали (U-Y-V-Y). Два соседних пикселя по горизонтали хранятся как макропиксель 32 бита, имеющий значение Y для каждого пикселя и общие значения U и V.
`QVideoFrame::Format_YUYV`	`21`	Кадр хранится в упакованном формате YUV 8 бит на компонент с подвыборочным размещением U и V планов по горизонтали (Y-U-Y-V). Два соседних пикселя по горизонтали хранятся как макропиксель 32 бита, имеющий значение Y для каждого пикселя и общие значения U и V.
`QVideoFrame::Format_NV12`	`22`	Кадр хранится в полупланарном формате YUV 8 бит на компонент с планом Y, за которым следует упакованный подвыборочный UV-план (U-V).
`QVideoFrame::Format_NV21`	`23`	Кадр хранится в полупланарном формате YUV 8 бит на компонент с планом Y, за которым следует упакованный подвыборочный VU-план (V-U).
`QVideoFrame::Format_IMC1`	`24`	Кадр хранится в планарном формате YUV 8 бит на компонент с подвыборочным размещением U и V планов по горизонтали и вертикали. Аналогичен типу Format_YUV420P, за исключением того, что байты на строку в U и V планах дополнены до того же шага, что и в плане Y.
`QVideoFrame::Format_IMC2`	`25`	Кадр хранится в планарном формате YUV 8 бит на компонент с подвыборочным размещением U и V планов по горизонтали и вертикали. Аналогичен типу Format_YUV420P, за исключением того, что строки U и V планов чередуются, т.е. за каждой строкой данных U следует строка данных V, создавая единую строку с тем же шагом, что и данные Y.
`QVideoFrame::Format_IMC3`	`26`	Кадр хранится в планарном формате YVU 8 бит на компонент с подвыборочным размещением V и U планов по горизонтали и вертикали. Аналогичен типу Format_YV12, за исключением того, что байты на строку в V и U планах дополнены до того же шага, что и в плане Y.
`QVideoFrame::Format_IMC4`	`27`	Кадр хранится в планарном формате YVU 8 бит на компонент с подвыборочным размещением V и U планов по горизонтали и вертикали. Аналогичен типу Format_YV12, за исключением того, что строки V и U планов чередуются, т.е. за каждой строкой данных V следует строка данных U, создавая единую строку с тем же шагом, что и данные Y.
`QVideoFrame::Format_Y8`	`28`	Кадр хранится в формате 8-битного серого цвета.
`QVideoFrame::Format_Y16`	`29`	Кадр хранится в линейном 16-битном формате серого цвета. Маленький порядок байтов.
`QVideoFrame::Format_Jpeg`	`30`	Кадр хранится в сжатом формате JPEG.
`QVideoFrame::Format_CameraRaw`	`31`	Кадр хранится в формате камеры, специфичном для устройства.
`QVideoFrame::Format_AdobeDng`	`32`	Кадр хранится в формате сырых данных Adobe Digital Negative (DNG).
`QVideoFrame::Format_User`	`1000`	Начальное значение для пользовательских форматов пикселей.

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

QVideoFrame::QVideoFrame()

Создаёт пустой видеокадр.

QVideoFrame::QVideoFrame(QAbstractVideoBuffer **buffer, const QSize &size, PixelFormat format*)

Создаёт видеокадр из buffer с заданным форматом пикселей format и размерами size в пикселях.

Примечание: Это не увеличивает счётчик ссылок на буфер видео.

QVideoFrame::QVideoFrame(int bytes, const QSize &size, int bytesPerLine, PixelFormat format)

Создаёт видеокадр заданного формата пикселей format и размеров size в пикселях.

bytesPerLine (шаг) — длина каждой строки в байтах, а bytes — общее количество байтов, которое должно быть выделено для кадра.

QVideoFrame::QVideoFrame(const QImage &image)

Создаёт видеокадр из image.

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

END_OF_DOCUMENT_MARKER

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

QVideoFrame::QVideoFrame(const QVideoFrame &other)

Создает неглубокую копию other. Поскольку QVideoFrame явно разделяется, эти два экземпляра будут отражать один и тот же кадр.

QVideoFrame::~QVideoFrame()

Удаляет видеокадр.