Класс QVideoSurfaceFormat

Класс QVideoSurfaceFormat определяет формат потока видео-представления поверхности. Подробнее...

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

Типы

Общедоступные функции

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

Класс QVideoSurfaceFormat определяет формат потока видео-представления поверхности.

Поверхность видео отображает поток кадров видео. Формат поверхности описывает тип кадров и определяет, как они должны отображаться.

Основные свойства потока видео, необходимые для настройки поверхности видео, — это формат пикселей, задаваемый функцией pixelFormat(), и размеры кадра, задаваемые функцией frameSize().

Если поверхность предназначена для отображения кадров с использованием дескриптора кадра, формат поверхности также будет включать тип дескриптора, который задаётся функцией handleType().

Область кадра, которая фактически отображается на поверхности видео, задаётся функцией viewport(). Поток может иметь область просмотра меньше всей области кадра, чтобы позволить отображать видео, размер которого меньше ближайшего оптимального размера кадра видео. Например, ширина кадра может быть расширена, чтобы начало каждой строки сканирования было кратно восьми байтам.

Другие распространённые свойства — это pixelAspectRatio(), scanLineDirection() и frameRate(). Кроме того, поток может иметь некоторые дополнительные свойства, специфичные для типа, которые перечислены функцией dynamicPropertyNames() и к которым можно получить доступ с помощью функций property() и setProperty().

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

enum QVideoSurfaceFormat::Direction

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

enum QVideoSurfaceFormat::YCbCrColorSpace

Перечисляет цветовое пространство Y'CbCr видеокадров.

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

QVideoSurfaceFormat::QVideoSurfaceFormat()

Создаёт формат видеопотока по умолчанию.

QVideoSurfaceFormat::QVideoSurfaceFormat(const QSize &size, QVideoFrame::PixelFormat format, QAbstractVideoBuffer::HandleType type = QAbstractVideoBuffer::NoHandle)

Создаёт описание потока, принимающего буферы типа type с заданным размером кадра size и форматом пикселей format.

QVideoSurfaceFormat::QVideoSurfaceFormat(const QVideoSurfaceFormat &other)

Создаёт копию other.

QVideoSurfaceFormat::~QVideoSurfaceFormat()

Удаляет описание видеопотока.

int QVideoSurfaceFormat::frameHeight() const

Возвращает высоту кадра в видеопотоке.

qreal QVideoSurfaceFormat::frameRate() const

Возвращает частоту кадров видеопотока в кадрах в секунду.

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

QSize QVideoSurfaceFormat::frameSize() const

Возвращает размеры кадров в видеопотоке.

См. также setFrameSize(), frameWidth() и frameHeight().

int QVideoSurfaceFormat::frameWidth() const

Возвращает ширину кадров в видеопотоке.

См. также frameSize() и frameHeight().

QAbstractVideoBuffer::HandleType QVideoSurfaceFormat::handleType() const

Возвращает тип дескриптора, используемого поверхностью для представления данных кадра.

Если тип дескриптора равен QAbstractVideoBuffer::NoHandle, буферы с любым типом дескриптора допустимы, при условии, что они могут быть отображены с флагом QAbstractVideoBuffer::ReadOnly. Если handleType() не равен QAbstractVideoBuffer::NoHandle, тогда тип дескриптора буфера должен совпадать с типом дескриптора формата поверхности.

bool QVideoSurfaceFormat::isMirrored() const

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

Примечание: Зеркалирование здесь отличается от QImage::mirrored, так как вертикально зеркальное отображение QImage будет отображаться в зеркальном виде по оси x.

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

bool QVideoSurfaceFormat::isValid() const

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

Возвращает true, если формат допустимый, и false в противном случае.

QSize QVideoSurfaceFormat::pixelAspectRatio() const

Возвращает соотношение сторон пикселей видеопотока.

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

QVideoFrame::PixelFormat QVideoSurfaceFormat::pixelFormat() const

Возвращает формат пикселей кадров в видеопотоке.

QVariant QVideoSurfaceFormat::property(const char *name) const

Возвращает значение свойства видеоформата с именем name.

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

QList<QByteArray> QVideoSurfaceFormat::propertyNames() const

Возвращает список имён динамических свойств видеоформата.

QVideoSurfaceFormat::Direction QVideoSurfaceFormat::scanLineDirection() const

Возвращает направление сканирования строк.

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

void QVideoSurfaceFormat::setFrameRate(qreal rate)

Устанавливает частоту кадров видеопотока в кадрах в секунду.

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

void QVideoSurfaceFormat::setFrameSize(const QSize &size)

Устанавливает размер кадров в видеопотоке на size.

Это сбросит viewport() на заполнение всего кадра.

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

void QVideoSurfaceFormat::setFrameSize(int width, int height)

Это перегруженная функция.

Устанавливает ширину и высоту кадров в видеопотоке.

Это сбросит viewport() на заполнение всего кадра.

void QVideoSurfaceFormat::setMirrored(bool mirrored)

Устанавливает, отображается ли поверхность в зеркальном виде по вертикальной оси. Значение по умолчанию — false.

Примечание: Зеркалирование здесь отличается от QImage::mirrored, так как вертикально зеркальное отображение QImage будет отображаться в зеркальном виде по оси x.

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

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

void QVideoSurfaceFormat::setPixelAspectRatio(const QSize &ratio)

Устанавливает соотношение сторон пикселей видеопотока.

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

void QVideoSurfaceFormat::setPixelAspectRatio(int horizontal, int vertical)

Это перегруженная функция.

Устанавливает горизонтальную и вертикальную составляющие соотношения сторон пикселей видеопотока.

void QVideoSurfaceFormat::setProperty(const char *name, const QVariant &value)

Устанавливает свойство видеоформата с именем name на значение value.

Попытка установить только для чтения свойство будет проигнорирована.

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

void QVideoSurfaceFormat::setScanLineDirection(QVideoSurfaceFormat::Direction direction)

Устанавливает направление сканирования строк.

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

void QVideoSurfaceFormat::setViewport(const QRect &viewport)

Устанавливает область просмотра видеопотока на viewport.

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

void QVideoSurfaceFormat::setYCbCrColorSpace(QVideoSurfaceFormat::YCbCrColorSpace space)

Устанавливает пространство цветов Y'CbCr видеопотока. Используется только с сырыми типами кадров YUV.

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

QSize QVideoSurfaceFormat::sizeHint() const

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

Это размер области просмотра, масштабированный в соответствии с соотношением сторон пикселей.

QRect QVideoSurfaceFormat::viewport() const

Возвращает область отображения видеопотока.

Область отображения — это область кадра видео, которая фактически отображается.

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

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

QVideoSurfaceFormat::YCbCrColorSpace QVideoSurfaceFormat::yCbCrColorSpace() const

Возвращает цветовое пространство Y'CbCr видеопотока.

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

bool QVideoSurfaceFormat::operator!=(const QVideoSurfaceFormat &other) const

Возвращает true, если other отличается от текущего видеоформата, и false, если они одинаковые.

QVideoSurfaceFormat &QVideoSurfaceFormat::operator=(const QVideoSurfaceFormat &other)

Присваивает значения other данному объекту.

bool QVideoSurfaceFormat::operator==(const QVideoSurfaceFormat &other) const

Возвращает true, если other совпадает с текущим видеоформатом, и false, если они разные.