QRenderCapture Class

class Qt3DRender::QRenderCapture

렌더링 캡처를 위한 프레임 그래프 노드입니다. 더 보기...

헤더: #include <Qt3DRender/QRenderCapture>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
QML에서: RenderCapture
상속합니다: Qt3DRender::QFrameGraphNode
상태: Deprecated

공용 함수

QRenderCapture(Qt3DCore::QNode *parent = nullptr)
Qt3DRender::QRenderCaptureReply *requestCapture()
Qt3DRender::QRenderCaptureReply *requestCapture(const QRect &rect)

상세 설명

QRenderCapture는 모든 렌더링 단계에서 렌더링을 이미지로 캡처하는 데 사용됩니다. 캡처는 사용자가 시작해야 하며 캡처 요청당 하나의 이미지가 반환됩니다. 사용자는 여러 렌더링 캡처 요청을 동시에 발행할 수 있지만, 프레임당 QRenderCapture 인스턴스당 하나의 요청만 제공됩니다.

멤버 함수 문서

[explicit] QRenderCapture::QRenderCapture(Qt3DCore::QNode *parent = nullptr)

생성자는 지정된 parent 로 인스턴스를 생성합니다.

[invokable] Qt3DRender::QRenderCaptureReply *QRenderCapture::requestCapture()

렌더 캡처를 요청할 때 사용됩니다. 프레임 그래프에 여러 리프 노드가 있더라도 요청 캡처 호출당 하나의 렌더링 캡처 결과만 생성됩니다. 이 함수는 QRenderCaptureReply 객체를 반환하며, 이 객체는 캡처가 완료되면 캡처된 이미지를 받습니다. 반환된 객체의 할당은 사용자가 deleterLater()를 호출하여 해제할 책임이 있습니다.

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

[invokable] Qt3DRender::QRenderCaptureReply *QRenderCapture::requestCapture(const QRect &rect)

지정된 rect 에서 렌더 캡처를 요청하는 데 사용됩니다. 프레임 그래프에 여러 리프 노드가 있더라도 요청Capture 호출당 하나의 렌더링 캡처 결과만 생성됩니다. 이 함수는 QRenderCaptureReply 객체를 반환하며, 이 객체는 캡처가 완료되면 캡처된 이미지를 받습니다. 사용자는 deleteLater()를 호출하여 반환된 객체의 할당을 해제할 책임이 있습니다.

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

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