Qt3DRender::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 |
| 상태: | 사용 중단됨 |
이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.
공개 함수
| 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()
렌더 캡처를 요청하는 데 사용됩니다. 프레임 그래프에 여러 개의 리프 노드가 있더라도 requestCapture 호출당 하나의 렌더 캡처 결과만 생성됩니다. 이 함수는 QRenderCaptureReply 객체를 반환하며, 이 객체는 캡처가 완료되면 캡처된 이미지를 수신합니다. 사용자는 deleterLater()를 호출하여 반환된 객체의 할당을 해제해야 합니다.
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
[invokable] Qt3DRender::QRenderCaptureReply *QRenderCapture::requestCapture(const QRect &rect)
지정된 프레임 그래프( rect)로부터 렌더 캡처를 요청하는 데 사용됩니다. 프레임 그래프에 여러 개의 리프 노드가 있더라도 requestCapture 호출 한 번당 하나의 렌더 캡처 결과만 생성됩니다. 이 함수는 QRenderCaptureReply 객체를 반환하며, 캡처가 완료되면 이 객체를 통해 캡처된 이미지를 수신합니다. 사용자는 deleteLater()를 호출하여 반환된 객체의 할당을 해제해야 합니다.
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
© 2026 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.
