Тип QML VideoOutput

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

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

Свойства

• contentRect : прямоугольник
• fillMode : перечисление
• orientation : int
• sourceRect : прямоугольник
• videoSink : объект

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

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

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

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

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

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

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

contentRect : прямоугольник

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

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

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

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

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

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

По умолчанию режим fillMode равен PreserveAspectFit.

orientation : int

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

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

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

sourceRect : прямоугольник

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

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

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

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

videoSink : объект

Это свойство содержит базовый объект C++ QVideoSink, который используется для рендеринга кадров видео в этот элемент VideoOutput.

При нормальном использовании VideoOutput из QML не требуется использовать это свойство.