Back to Qt.io
Contact Us Blog Download Qt

VideoOutput QML Type

비디오 또는 카메라 뷰파인더 렌더링 더 보기...

Import Statement: import QtMultimedia

속성

상세 설명

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

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

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

비디오 출력 항목은 변형되지 않은, 늘어난, 균일한 비율의 비디오 프레젠테이션을 지원합니다. 균일한 비율로 늘어난 프레젠테이션에 대한 설명은 fillMode 속성 설명을 참조하세요.

MediaPlayer 및 Camera도 참조하세요 .

속성 문서

contentRect : rectangle

이 속성은 렌더링할 동영상이 포함될 영역의 항목 좌표를 보유합니다. 특정 채우기 모드에서는 이 사각형이 VideoOutput 의 보이는 영역보다 커집니다.

이 속성은 소스 치수와 관련하여 다른 좌표를 지정할 때 유용하며, 0~1.0 범위의 상대(정규화된) 프레임 좌표에 적용됩니다.

이 범위를 벗어난 영역은 투명하게 표시됩니다.


fillMode : enumeration

이 속성을 설정하면 대상 영역에 맞게 동영상의 크기를 조정하는 방법을 정의할 수 있습니다.

  • 늘이기 - 동영상의 크기를 조정합니다.
  • PreserveAspectFit - 자르지 않고 동영상 크기를 균일하게 조정합니다.
  • PreserveAspectCrop - 동영상의 크기를 균일하게 조정하여 채우고 필요한 경우 자릅니다.

기본 채우기 모드는 PreserveAspectFit입니다.


orientation : int

이 속성은 표시된 비디오가 비디오 좌표에서 시계 방향으로 회전하는 각도(각도)를 결정하며, 여기서 Y축은 디스플레이에서 아래쪽을 가리킵니다.

방향 변경은 소스에서 뷰포트로의 좌표 매핑에 영향을 줍니다.

0, 90, -90, 180, 270 등 90 도의 배수만 지원되며, 그렇지 않으면 지정된 값은 무시됩니다.

경우에 따라 소스 비디오 스트림에 특정 방향을 보정해야 하는 경우가 있습니다. 여기에는 카메라 뷰파인더와 같은 소스가 포함되며, 이 경우 나머지 사용자 인터페이스의 회전과 상관없이 표시되는 뷰파인더가 실제와 일치해야 합니다.

이 속성을 사용하여 사용자 인터페이스 회전을 보정하거나 출력 보기를 다른 애플리케이션 비즈니스 요구 사항에 맞추는 것이 좋습니다.

기본값은 0 입니다.


sourceRect : rectangle

이 속성은 렌더링에 고려되는 소스 비디오 콘텐츠의 영역을 보유합니다. 값은 소스 픽셀 좌표이며, 소스의 픽셀 종횡비에 맞게 조정됩니다.

일반적으로 이 직사각형의 왼쪽 상단 모서리는 0,0, 너비와 높이는 입력 콘텐츠의 너비와 높이가 됩니다. 비디오 소스에 뷰포트가 설정되어 있는 경우에만 이 값이 달라집니다.

방향 설정은 이 사각형에 영향을 주지 않습니다.

QVideoFrameFormat::viewport()도 참조하세요 .


videoSink : object

이 속성은 이 VideoOutput 요소에 비디오 프레임을 렌더링하는 데 사용되는 언더레이 C++ QVideoSink 객체를 보유합니다.

QML에서 VideoOutput 을 정상적으로 사용하는 경우 이 속성을 사용할 필요가 없습니다.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.