Qt3DRender::QLayerFilter Class
class Qt3DRender::QLayerFilter프레임 그래프 분기에 그려진 레이어를 제어합니다. 더 보기...
| 헤더: | #include <qlayerfilter.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| QML에서: | LayerFilter |
| 상속: | Qt3DRender::QFrameGraphNode |
| 상태: | 사용 중단됨 |
이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.
공개 유형
| enum | FilterMode { AcceptAnyMatchingLayers, AcceptAllMatchingLayers, DiscardAnyMatchingLayers, DiscardAllMatchingLayers } |
속성
- filterMode : FilterMode
공개 함수
| QLayerFilter(Qt3DCore::QNode *parent = nullptr) | |
| void | addLayer(Qt3DRender::QLayer *layer) |
| Qt3DRender::QLayerFilter::FilterMode | filterMode() const |
| QList<Qt3DRender::QLayer *> | layers() const |
| void | removeLayer(Qt3DRender::QLayer *layer) |
| void | setFilterMode(Qt3DRender::QLayerFilter::FilterMode filterMode) |
신호
| void | filterModeChanged(Qt3DRender::QLayerFilter::FilterMode filterMode) |
상세 설명
Qt3DRender::QLayerFilter 는 프레임 그래프의 해당 분기에서 어떤 레이어를 렌더링할지 렌더러에 지시하는 데 사용할 수 있습니다. QLayerFilter는 QLayerFilter에 추가된 QLayer 인스턴스 및 Qt3DCore::QEntity 의 컴포넌트를 기반으로 렌더링할 엔티티를 선택합니다.
QLayerFilter는 filterMode 속성에 따라 특정 QLayer 를 가진 엔티티를 선택하거나 제외하도록 구성할 수 있습니다. 기본적으로, QLayerFilter 에서도 참조되고 있는 QLayer 객체 중 하나를 참조하는 엔티티가 선택됩니다(AcceptAnyMatchingLayers).
FrameGraph 트리 내에서, 루트에서 리프까지 이어지는 하나의 분기 내에 여러 개의 QLayerFilter 노드가 중첩될 수 있습니다. 이 경우 필터링은 먼저 선언된 첫 번째 ` QLayerFilter`에 지정된 필터링 방법을 사용하여 씬의 모든 엔티티에 대해 수행됩니다. 그런 다음 필터링된 엔티티 하위 집합은 선언된 두 번째 ` QLayerFilter `에 설정된 필터링 방법을 기반으로 다시 필터링됩니다. 이 과정은 해당 분기의 모든 ` QLayerFilter ` 노드가 처리될 때까지 반복됩니다.
멤버 유형 설명서
enum QLayerFilter::FilterMode
그릴 개체를 선택하는 규칙을 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
Qt3DRender::QLayerFilter::AcceptAnyMatchingLayers | 0 | 이 QLayerFilter 에 추가된 하나 이상의 QLayer 객체를 참조하는 엔티티를 허용합니다. 이것이 기본값입니다. |
Qt3DRender::QLayerFilter::AcceptAllMatchingLayers | 1 | 이 에 추가된 모든 QLayer 객체를 참조하는 엔티티를 허용합니다. QLayerFilter |
Qt3DRender::QLayerFilter::DiscardAnyMatchingLayers | 2 | 이 에 추가된 하나 이상의 QLayer 객체를 참조하는 엔티티를 거부합니다. QLayerFilter |
Qt3DRender::QLayerFilter::DiscardAllMatchingLayers | 3 | 이 에 추가된 모든 QLayer 객체를 참조하는 엔티티를 제외합니다. QLayerFilter |
속성 설명서
filterMode : FilterMode
그리기 위해 선택할 엔티티를 지정하는 필터 모드를 저장합니다.
기본값은 AcceptMatchingLayers입니다.
액세스 함수:
| Qt3DRender::QLayerFilter::FilterMode | filterMode() const |
| void | setFilterMode(Qt3DRender::QLayerFilter::FilterMode filterMode) |
알림 신호:
| void | filterModeChanged(Qt3DRender::QLayerFilter::FilterMode filterMode) |
멤버 함수 설명서
[explicit] QLayerFilter::QLayerFilter(Qt3DCore::QNode *parent = nullptr)
이 생성자는 지정된 ` parent`을 사용하여 인스턴스를 생성합니다.
void QLayerFilter::addLayer(Qt3DRender::QLayer *layer)
layer 를 현재 레이어 목록에 추가합니다.
QList<Qt3DRender::QLayer *> QLayerFilter::layers() const
현재 레이어 목록을 반환합니다.
void QLayerFilter::removeLayer(Qt3DRender::QLayer *layer)
현재 레이어 목록에서 ‘ layer ’을 제거합니다.
© 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.
