QVideoFrameInput Class

멤버 함수 문서

[explicit] QVideoFrameInput::QVideoFrameInput(QObject *parent = nullptr)

parent 를 사용하여 새 QVideoFrameInput 객체를 생성합니다.

[explicit] QVideoFrameInput::QVideoFrameInput(const QVideoFrameFormat &format, QObject *parent = nullptr)

비디오 프레임 format 과 parent 을 사용하여 새로운 QVideoFrameInput 객체를 생성합니다.

지정된 format 은 QMediaRecorder::record() 호출 시 일치하는 비디오 인코더의 초기화에 대한 힌트로 작동합니다. 형식이 지정되지 않았거나 유효하지 않으면 첫 번째 프레임을 전송할 때 비디오 인코더가 초기화됩니다. 일치하는 동영상 인코더를 초기화한 후 다른 픽셀 형식과 크기의 동영상 프레임을 전송하면 녹화 중에 성능 저하가 발생할 수 있습니다.

어떤 종류의 프레임을 전송할지 미리 알고 있다면 형식을 지정하는 것이 좋습니다.

[override virtual noexcept] QVideoFrameInput::~QVideoFrameInput()

개체를 파괴합니다.

QMediaCaptureSession *QVideoFrameInput::captureSession() const

이 비디오 프레임 입력이 연결된 캡처 세션을 반환하거나, 비디오 프레임 입력이 캡처 세션에 연결되어 있지 않은 경우 nullptr 을 반환합니다.

비디오 프레임 입력을 세션에 연결하려면 QMediaCaptureSession::setVideoFrameInput()를 사용합니다.

QVideoFrameFormat QVideoFrameInput::format() const

비디오 프레임 입력 구성 시 지정한 비디오 프레임 형식을 반환합니다.

[signal] void QVideoFrameInput::readyToSendVideoFrame()

비디오 프레임 입력에 새 프레임을 보낼 수 있다는 신호를 보냅니다. 신호를 수신한 후 전송할 프레임이 있는 경우 sendVideoFrame 을 한 번 또는 false 으로 반환될 때까지 반복해서 호출합니다.

sendVideoFrame()도 참조하세요 .

bool QVideoFrameInput::sendVideoFrame(const QVideoFrame &frame)

QVideoFrame 을 QMediaRecorder 으로 보내거나 QMediaCaptureSession 을 통해 비디오 출력을 보냅니다.

지정된 frame 이 대상에 성공적으로 전송된 경우 true 을 반환합니다. 프레임이 전송되지 않은 경우 false 를 반환하며, 이는 인스턴스가 QMediaCaptureSession 에 할당되지 않았거나 세션에 비디오 출력 또는 미디어 레코더가 없거나 미디어 레코더가 시작되지 않았거나 대기열이 꽉 찬 경우에 발생할 수 있습니다. 대상에서 새 프레임을 처리할 수 있게 되는 즉시 readyToSendVideoFrame 신호가 전송됩니다.

빈 비디오 프레임의 전송은 QMediaRecorder 에서 입력 스트림의 종료로 처리됩니다. QMediaRecorder 은 QMediaRecorder::autoStop 이 true 이고 모든 입력이 스트림의 종료를 보고한 경우 자동으로 녹화를 중지합니다.