Qt3DRender::QLayer Class

class Qt3DRender::QLayer

Die Klasse „QLayer“ bietet eine Möglichkeit, zu filtern, welche Elemente gerendert werden sollen. Mehr...

Kopfzeile:	`#include <qlayer.h>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS 3drender)` `target_link_libraries(mytarget PRIVATE Qt6::3drender)`
qmake:	`QT += 3drender`
In QML:	Layer
Erbt von:	Qt3DCore::QComponent
Status:	Veraltet

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

recursive : bool

Öffentliche Funktionen

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

Signale

void	recursiveChanged()

Detaillierte Beschreibung

Qt3DRender::QLayer Arbeitet in Verbindung mit der Funktion „ Qt3DRender::QLayerFilter “ im FrameGraph.

Ein QLayer kann auf einen Teilbaum von Entitäten angewendet werden, indem die Eigenschaft „recursive“ auf „true“ gesetzt wird.

 #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);

...

Siehe auch „ Qt3DRender::QLayerFilter “.

Eigenschaftsdokumentation

recursive : bool

Gibt an, ob die Ebene auch auf den Objektunterbaum angewendet wird.

Zugriffsfunktionen:

bool	recursive() const
void	setRecursive(bool recursive)

Benachrichtigungssignal:

void	recursiveChanged()

Dokumentation der Mitgliedsfunktionen

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

Erstellt eine neue `QLayer`-Instanz mit dem angegebenen ` parent`.

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