VideoOutput QML 类型

渲染视频或摄像头取景器。 更多...

导入语句import QtMultimedia

属性

详细说明

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

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

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

VideoOutput 项目支持未转换、拉伸和均匀缩放的视频呈现。有关拉伸均匀缩放呈现的描述,请参见 fillMode 属性描述。

另请参阅MediaPlayerCamera

属性说明

contentRect : rectangle

此属性保存将渲染视频的区域项坐标。在特定的填充模式下,此矩形将比可见的 VideoOutput 区域更大。

当使用源尺寸来指定其他坐标时,此属性很有用 - 这适用于 0 到 1.0 范围内的相对(归一化)帧坐标。

此区域以外的区域将是透明的。


fillMode : 枚举

将此属性设置为定义如何将视频缩放到目标区域。

  • 拉伸 - 将视频拉伸以适应。
  • PreserveAspectFit - 以均匀的方式缩放以适应,必要时裁剪
  • PreserveAspectCrop - 以均匀的方式缩放以填充,有必要时裁剪

默认填充模式为 PreserveAspectFit。


orientation : int

在某些情况下,源视频流需要特定的方向才能正确显示。这包括像摄像头取景器这样的来源,显示的取景器应该与现实相符,无论用户界面的其余部分如何旋转。

此属性允许您应用旋转(以90度为步长)来补偿任何用户界面旋转,正值表示逆时针方向。

方向变化也将影响从源到视口的坐标映射。


sourceRect : rectangle

此属性保存要渲染的源视频内容的区域。值以源像素坐标表示,根据源的像素宽高比进行调整。

请注意,通常情况下,此矩形的右上角将处于 0,0 的位置,而宽度和高度将是输入内容的宽度和高度。只有当视频源设置了视口时,这些值才会不同。

方向设置不影响此矩形。

另请参阅QVideoFrameFormat::viewport().


videoSink : 对象

此属性包含用于将视频帧渲染到该 VideoOutput 元素的底层 C++ QVideoSink 对象。

在 QML 中正常使用 VideoOutput 通常不需要使用此属性。


© 2024 The Qt Company Ltd。本文件中包含的文档贡献的版权归各自的所有者所有。本文件提供的文档是根据 Free Software Foundation 发布的条款许可的 GNU Free Documentation License 版本 1.3。Qt 和其相关标志是芬兰和/或世界其他地区的 The Qt Company Ltd. 的商标。所有其他商标均属于其各自的所有者。