Класс QVideoSurfaceFormat

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

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

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

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

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

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

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

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

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

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

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

Перечисление QVideoSurfaceFormat::Direction

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

Перечисление QVideoSurfaceFormat::YCbCrColorSpace

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

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

QVideoSurfaceFormat::QVideoSurfaceFormat(const QVideoSurfaceFormat &other)

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

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

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

QVideoSurfaceFormat::QVideoSurfaceFormat()

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

QVideoSurfaceFormat &QVideoSurfaceFormat::operator=(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)

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

Устанавливает width и height кадров в видеопотоке.

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

void QVideoSurfaceFormat::setMirrored(bool mirrored)

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

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

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

void QVideoSurfaceFormat::setPixelAspectRatio(const QSize &ratio)

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

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

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

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

Устанавливает значения horizontal и 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 space видеопотока. Используется только с типами кадров 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, если они одинаковы.

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

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