QLayerFilter Class
class Qt3DRender::QLayerFilter프레임 그래프 분기에 그려진 레이어를 제어합니다. 더 보기...
| 헤더: | #include <QLayerFilter> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender)target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| QML에서: | LayerFilter |
| 상속합니다: | Qt3DRender::QFrameGraphNode |
| 상태: | Deprecated |
공용 유형
| 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 의 컴포넌트로서 어떤 엔티티를 그릴지 선택합니다.
filterMode 속성에 따라 특정 QLayer 을 가진 엔티티를 선택하거나 버리도록 QLayerFilter를 구성할 수 있습니다. 기본적으로 QLayerFilter 에서도 참조되는 QLayer 개체 중 하나를 참조하는 엔티티가 선택됩니다(AcceptAnyMatchingLayers).
프레임그래프 트리 내에서 루트에서 리프까지 하나의 분기 내에 여러 개의 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 제거
© 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.
