QSSGRenderExtension Class
확장 백엔드 노드 구현을 위한 베이스 클래스입니다. 더 보기...
| Header: | #include <QSSGRenderExtension> |
| Since: | Qt 6.7 |
공용 유형
| enum class | RenderMode { Standalone, Main } |
| enum class | RenderStage { PreColor, PostColor } |
공용 함수
| virtual QSSGRenderExtension::RenderMode | mode() const = 0 |
| virtual bool | prepareData(QSSGFrameData &data) = 0 |
| virtual void | prepareRender(QSSGFrameData &data) = 0 |
| virtual void | render(QSSGFrameData &data) = 0 |
| virtual void | resetForFrame() = 0 |
| virtual QSSGRenderExtension::RenderStage | stage() const = 0 |
QQuick3DRenderExtension 를참조하세요 .
멤버 유형 문서
enum class QSSGRenderExtension::RenderMode
렌더링 확장 모드를 지정합니다.
| Constant | 값 | 설명 |
|---|---|---|
QSSGRenderExtension::RenderMode::Standalone | 0 | 렌더링 준비 단계에서 렌더링 코드 전체가 기록됩니다. 이는 일반적으로 이전 렌더링 확장에 대해 일부 출력이 크레이트되어 있음을 의미합니다. 이 모드를 사용하면 프레임의 준비 단계에서 prepareRender() 및 render() 함수가 모두 호출됩니다. |
QSSGRenderExtension::RenderMode::Main | 1 | 렌더링 코드는 메인 렌더링 패스 내에 기록됩니다. 이 모드에서 prepareRender()는 프레임의 준비 단계에서 호출되고 render()는 프레임의 렌더링 단계에서 호출됩니다. |
enum class QSSGRenderExtension::RenderStage
확장 프로그램이 호출될 순서를 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QSSGRenderExtension::RenderStage::PreColor | 0 | 렌더링 코드가 메인(색상) 패스 전에 기록되고 실행됩니다. |
QSSGRenderExtension::RenderStage::PostColor | 1 | 렌더링 코드는 메인(컬러) 패스 후에 기록되고 실행됩니다. |
멤버 함수 문서
[pure virtual] QSSGRenderExtension::RenderMode QSSGRenderExtension::mode() const
이 확장에 사용된 렌더링 모드를 반환합니다.
[pure virtual] bool QSSGRenderExtension::prepareData(QSSGFrameData &data)
장면 data 이 수집된 후 현재 프레임의 렌더링 데이터 또는 렌더링이 완료되기 전에 호출됩니다.
더티 상태를 반환합니다. 렌더링해야 하는 더티 데이터가 있는 경우 true 을 반환합니다.
참고: 준비 및 렌더링 단계에서 엔진에서 생성/수집되는 대부분의 데이터는 프레임 단위이므로 다음 프레임이 시작될 때 해제되거나 해제된 것으로 간주해야 합니다.
QSSGFrameData 을참조하세요 .
[pure virtual] void QSSGRenderExtension::prepareRender(QSSGFrameData &data)
렌더링할 데이터를 준비합니다. 렌더링에 필요한 data 을 빌드하고 수집합니다. 이 렌더링 이전에 예약된 모든 렌더링 확장이 처리됩니다. 또한, RenderMode::Standalone 모드의 모든 렌더링 확장이 성공하면 완전히 완료된 것입니다.
참고: 준비 및 렌더링 단계에서 엔진에서 생성/수집되는 대부분의 데이터는 프레임 단위이며 다음 프레임이 시작될 때 해제되거나 해제된 것으로 간주해야 합니다.
QSSGFrameData 을참조하세요 .
[pure virtual] void QSSGRenderExtension::render(QSSGFrameData &data)
렌더 패스를 기록합니다. mode 확장에 따라 이 함수는 프레임의 준비 또는 렌더링 단계에서 호출됩니다.
data 을 사용하여 활성 QRhi 객체를 쿼리할 수 있는 렌더링 컨텍스트에 액세스합니다.
QSSGRenderExtension::RenderMode 를참조하세요 .
[pure virtual] void QSSGRenderExtension::resetForFrame()
새 프레임이 시작될 때마다 호출됩니다. 이 시점에서 이전 프레임의 모든 데이터가 지워져야 합니다.
[pure virtual] QSSGRenderExtension::RenderStage QSSGRenderExtension::stage() const
이 렌더링 확장이 사용될 스테이지를 반환합니다.
© 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.
