이 페이지에서

Qt3DRender::QLayer Class

class Qt3DRender::QLayer

QLayer 클래스는 렌더링될 엔티티를 필터링하는 방법을 제공합니다. 더 보기...

헤더: #include <qlayer.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
QML에서: Layer
상속: Qt3DCore::QComponent
상태: 사용 중단됨

이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.

속성

공개 함수

QLayer(Qt3DCore::QNode *parent = nullptr)
bool recursive() const
void setRecursive(bool recursive)

신호

상세 설명

Qt3DRender::QLayer FrameGraph의 Qt3DRender::QLayerFilter 와 연동하여 작동합니다.

QLayer는 recursive 속성을 true로 설정하여 엔티티의 하위 트리에 적용할 수 있습니다.

 #include <Qt3DCore/QEntity>
 #include <Qt3DRender/QGeometryRenderer>
 #include <Qt3DRender/QLayer>
 #include <Qt3DRender/QLayerFilter>
 #include <Qt3DRender/QViewport>

// Scene
Qt3DCore::QEntity *rootEntity = new Qt3DCore::Qt3DCore::QEntity;

Qt3DCore::QEntity *renderableEntity = new Qt3DCore::Qt3DCore::QEntity(rootEntity);
Qt3DRender::QGeometryRenderer *geometryRenderer = new Qt3DCore::QGeometryRenderer(renderableEntity);
Qt3DRender::QLayer *layer1 = new Qt3DCore::QLayer(renderableEntity);
layer1->setRecursive(true);
renderableEntity->addComponent(geometryRenderer);
renderableEntity->addComponent(layer1);

...

// FrameGraph
Qt3DRender::QViewport *viewport = new Qt3DRender::QViewport;
Qt3DRender::QLayerFilter *layerFilter = new Qt3DRender::QLayerFilter(viewport);
layerFilter->addLayer(layer1);

...

Qt3DRender::QLayerFilter도 참조하십시오 .

속성 설명

recursive : bool

레이어가 엔티티 하위 트리에도 적용되는지 여부를 지정합니다.

액세스 함수:

bool recursive() const
void setRecursive(bool recursive)

알림 신호:

void recursiveChanged()

멤버 함수 설명서

[explicit] QLayer::QLayer(Qt3DCore::QNode *parent = nullptr)

지정된 ` parent`를 사용하여 새로운 `QLayer`를 생성합니다.

© 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.