VideoOutput QML Type

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

Import Statement: import QtMultimedia
Inherits:

Item

속성

방법

상세 설명

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

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

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

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

MediaPlayerCamera도 참조하세요 .

속성 문서

contentRect : rectangle

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

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

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


endOfStreamPolicy : enumeration [since 6.9]

이 속성은 비디오 스트림이 종료될 때 적용할 정책을 지정합니다. 이는 미디어 재생이 종료되거나 카메라, 화면 또는 창 캡처가 비활성화될 때 발생합니다.

endOfStreamPolicy 중 하나를 사용할 수 있습니다:

상수설명
ClearOutput비디오 출력이 지워집니다.
KeepLastFrame비디오 출력에 마지막 프레임이 계속 표시됩니다. 출력을 수동으로 지우려면 clearOutput() 방법을 사용합니다.

기본값은 ClearOutput 입니다.

이 속성은 Qt 6.9에 도입되었습니다.


fillMode : enumeration

이 속성을 설정하여 대상 영역에 맞게 비디오의 크기를 조정하는 방법을 정의합니다.

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

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


mirrored : bool [since 6.9]

표시된 동영상이 세로축을 중심으로 미러링되는지 여부를 결정합니다. 전면 카메라와 같이 소스 비디오 스트림의 변환이 애플리케이션의 비즈니스 로직과 일치하지 않는 경우 이 속성을 사용하는 것이 좋습니다. 미러링은 orientation 이후에 적용됩니다.

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

기본값은 false 입니다.

이 속성은 Qt 6.9에 도입되었습니다.


orientation : int

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

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

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

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

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

기본값은 0 입니다.


sourceRect : rectangle

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

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

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

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


videoSink : object

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

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


메서드 문서

[since 6.9] void clearOutput()

현재 표시된 비디오 프레임을 제거하여 비디오 출력을 지웁니다. 이 방법은 소스에서 비디오 출력을 분리한 후 또는 비디오 출력의 endOfStreamPolicy 속성이 KeepLastFrame 으로 설정된 상태에서 소스 스트림이 종료된 후 마지막 비디오 프레임을 제거해야 할 때 권장됩니다.

이 메서드는 Qt 6.9에 도입되었습니다.


© 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.