SimpleQuadRenderer QML Type
메인 렌더 타깃에 텍스처가 적용된 쿼드를 전체 화면으로 렌더링합니다. 더 보기...
| Import Statement: | import QtQuick3D.Helpers |
| Since: | Qt 6.11 |
| Inherits: |
속성
- texture : Texture
상세 설명
SimpleQuadRenderer는 Texture 를 화면 전체에 블릿(blit)하는 RenderExtension 입니다. 이 렌더러는 Main 렌더 모드에서 PostColor 단계에서 실행되며, 이는 장면이 그려진 후이지만 모든 후처리 효과 적용 전 단계에서 실행됨을 의미합니다. 또한 View3D 의 메인 렌더 타깃에 직접 쓰기를 수행하여, 장면에서 그려진 내용을 덮어씁니다.
가장 일반적인 사용 사례는 완전히 사용자 정의된 렌더링 파이프라인을 구축하는 것입니다. ` View3D.renderFormat `를 설정하여 ` Qt Quick 3D`의 내장 패스를 비활성화하고( View3D.DisableInternalPasses), 씬 콘텐츠를 하나 이상의 ` RenderPass ` 타깃에 렌더링한 다음, `SimpleQuadRenderer`를 사용하여 결과를 화면에 다시 합성합니다.
참고: SimpleQuadRenderer는 씬에 확장 기능으로 자동 등록되므로, View3D.extensions 에 수동으로 추가할 필요가 없습니다.
import QtQuick3D
import QtQuick3D.Helpers
View3D {
// Disable the built-in render passes so we can provide our own output
renderFormat: View3D.DisableInternalPasses
// A custom offscreen pass that renders scene content
RenderPass {
id: mainColorPass
commands: [
RenderablesFilter { renderableTypes: RenderablesFilter.Opaque | RenderablesFilter.Transparent }
]
}
// Blit the result of the custom pass to the screen
SimpleQuadRenderer {
texture: Texture {
textureProvider: RenderOutputProvider {
renderPass: mainColorPass
}
}
}
}RenderOutputProvider, RenderPass 및 View3D도 참조하십시오 .
속성 문서
texture : Texture
전체 화면 쿼드 전체에 렌더링할 텍스처입니다. 이는 임의의 ` Texture`일 수 있으며, 여기에는 ` textureProvider `가 ` RenderOutputProvider `로 설정되어 ` RenderPass `의 출력이나 ` Qt Quick 3D`의 내장 패스(예: 깊이 텍스처 또는 AO 텍스처) 중 하나를 표시하는 텍스처도 포함됩니다.
© 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.