Sur cette page

Qt3DRender::QLayer Class

class Qt3DRender::QLayer

La classe QLayer permet de filtrer les entités qui seront affichées. En savoir plus...

En-tête : #include <qlayer.h>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake : QT += 3drender
En QML : Layer
Hérite de : Qt3DCore::QComponent
Statut : Obsolète

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

Fonctions publiques

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

Signaux

Description détaillée

Qt3DRender::QLayer fonctionne en conjonction avec la méthode « Qt3DRender::QLayerFilter » dans le FrameGraph.

Un QLayer peut être appliqué à une sous-arborescence d'entités en définissant la propriété « recursive » sur « 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);

...

Voir également « Qt3DRender::QLayerFilter ».

Documentation sur les propriétés

recursive : bool

Indique si le calque s'applique également à la sous-arborescence de l'entité.

Fonctions d’accès :

bool recursive() const
void setRecursive(bool recursive)

Signal de notification :

void recursiveChanged()

Documentation des fonctions membres

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

Crée un nouvel objet QLayer avec l'parent spécifiée.

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