Тип QML VideoOutput

Отображение видео или видоискателя камеры. Подробнее...

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

Свойства

• autoOrientation : bool
• contentRect : rectangle
• fillMode : перечисление
• filters : список<объект>
• flushMode : перечисление
• orientation : int
• source : значение
• sourceRect : rectangle

Методы

• QPointF mapNormalizedPointToItem (const QPointF &point)
• QRectF mapNormalizedRectToItem(const QRectF &rectangle)
• QPointF mapPointToItem(const QPointF &point)
• QPointF mapPointToSource(const QPointF &point)
• QPointF mapPointToSourceNormalized(const QPointF &point)
• QRectF mapRectToItem(const QRectF &rectangle)
• QRectF mapRectToSource(const QRectF &rectangle)
• QRectF mapRectToSourceNormalized(const QRectF &rectangle)

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

Rectangle {
    width: 800
    height: 600
    color: "black"

    MediaPlayer {
        id: player
        source: "file://video.webm"
        autoPlay: true
    }

    VideoOutput {
        id: videoOutput
        source: player
        anchors.fill: parent
    }
}

Элемент VideoOutput поддерживает отображение видео без преобразований, с растяжением и с равномерным масштабированием. Описание растянутого отображения с равномерным масштабированием см. в описании свойства fillMode.

Элемент VideoOutput работает с бэкендами, которые поддерживают либо QVideoRendererControl, либо QVideoWindowControl. Если бэкенд поддерживает только QVideoWindowControl, видео рендерится на окно наложения, которое расположено поверх окна QtQuick. Из-за особенностей наложений видео, некоторые функции недоступны для таких бэкендов:

• Некоторые преобразования, такие как повороты
• Наличие других элементов QtQuick поверх элемента VideoOutput

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

См. также MediaPlayer и Camera.

Документация по свойствам

autoOrientation : bool

Это свойство позволяет включить и выключить автоматическую ориентацию потока видео, чтобы его ориентация всегда соответствовала ориентации экрана. Если autoOrientation включено, свойство orientation перезаписывается.

По умолчанию autoOrientation отключено.

Это свойство было добавлено в Qt 5.2.

См. также orientation.

contentRect : rectangle

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

Это свойство полезно, когда другие координаты заданы в терминах размеров источника - это относится к относительным (нормализованным) координатам кадра в диапазоне от 0 до 1,0.

Области за пределами этого будут прозрачными.

См. также mapRectToItem() и mapPointToItem().

fillMode : перечисление

Установите это свойство для определения того, как видео масштабируется для соответствия целевой области.

• Stretch - видео масштабируется для соответствия.
• PreserveAspectFit - видео масштабируется равномерно для соответствия без обрезки
• PreserveAspectCrop - видео масштабируется равномерно для заполнения, с обрезкой при необходимости

По умолчанию режим заполнения - PreserveAspectFit.

filters : список<объект>

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

См. также QAbstractVideoFilter.

flushMode : перечисление

Установите это свойство, чтобы определить, что VideoOutput должно отображаться, когда воспроизведение завершено или остановлено.

• EmptyFrame - очищает вывод видео.
• FirstFrame - отображает первый допустимый кадр.
• LastFrame - отображает последний допустимый кадр.

По умолчанию режим очистки - EmptyFrame.

Это свойство было добавлено в Qt 5.13.

orientation : int

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

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

Изменение ориентации также повлияет на отображение координат от источника до области просмотра.

См. также autoOrientation.

source : значение

Это свойство содержит элемент источника, предоставляющий кадры видео, такие как MediaPlayer или Camera.

Если вы расширяете свои собственные классы C++ для взаимодействия с VideoOutput, вы можете предоставить класс на основе QObject со свойством mediaObject, которое раскрывает производный от QMediaObject класс, имеющий доступный QVideoRendererControl, или вы можете предоставить класс на основе QObject со свойством для записи videoSurface, которое может принимать класс на основе QAbstractVideoSurface и может следовать правильному протоколу для доставки QVideoFrames в него.

sourceRect : rectangle

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

Обратите внимание, что обычно верхний левый угол этого прямоугольника будет 0,0, а ширина и высота будут шириной и высотой входного содержимого. Только когда у источника видео есть область просмотра, эти значения будут отличаться.

Настройка ориентации не влияет на этот прямоугольник.

См. также QVideoSurfaceFormat::pixelAspectRatio() и QVideoSurfaceFormat::viewport().

Документация по методам

QPointF mapNormalizedPointToItem (const QPointF &point)

При заданных нормализованных координатах point (то есть каждый компонент в диапазоне от 0 до 1,0), возвращает сопоставленную точку, которая соответствует ей (в координатах элемента). Это отображение зависит от ориентации.

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

QRectF mapNormalizedRectToItem(const QRectF &rectangle)

При заданном прямоугольнике rectangle в нормализованных координатах (то есть каждый компонент в диапазоне от 0 до 1,0), возвращает сопоставленный прямоугольник, который соответствует ему (в координатах элемента). Это отображение зависит от ориентации.

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

QPointF mapPointToItem(const QPointF &point)

При заданной точке point в координатах источника, возвращает соответствующую точку в координатах элемента. Это отображение зависит от ориентации.

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

QPointF mapPointToSource(const QPointF &point)

При заданной точке point в координатах элемента, возвращает соответствующую точку в координатах источника. Это отображение зависит от ориентации.

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

QPointF mapPointToSourceNormalized(const QPointF &point)

При заданной точке point в координатах элемента, возвращает соответствующую точку в нормализованных координатах источника. Это отображение зависит от ориентации.

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

QRectF mapRectToItem(const QRectF &rectangle)

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

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

QRectF mapRectToSource(const QRectF &rectangle)

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

Это отображение зависит от ориентации.

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

QRectF mapRectToSourceNormalized(const QRectF &rectangle)

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

Это отображение зависит от ориентации.

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