VideoOutput QML Type

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

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• contentRect : rectangle
• endOfStreamPolicy : enumeration (since 6.9)
• fillMode : enumeration
• mirrored : bool (since 6.9)
• orientation : int
• sourceRect : rectangle
• videoSink : object

방법

• void clearOutput() (since 6.9)

상세 설명

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 : rectangle

이 속성은 렌더링할 비디오가 포함될 영역의 항목 좌표를 저장합니다. 특정 채우기 모드를 사용할 경우, 이 사각형은 VideoOutput 의 표시 영역보다 더 커집니다.

이 속성은 소스 크기를 기준으로 다른 좌표가 지정된 경우에 유용하며, 이는 0에서 1.0 사이의 상대적(정규화된) 프레임 좌표에 적용됩니다.

이 영역 밖의 부분은 투명하게 표시됩니다.

endOfStreamPolicy : enumeration [since 6.9]

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

endOfStreamPolicy 의 값은 다음 중 하나일 수 있습니다:

기본값은 ` ClearOutput`입니다.

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

fillMode : enumeration

이 속성을 설정하여 동영상이 대상 영역에 맞게 어떻게 크기가 조정될지 지정합니다.

• Stretch - 동영상이 영역에 맞게 크기가 조정됩니다.
• 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에서 도입되었습니다.