Qt3DRender::QEnvironmentLight Class

class Qt3DRender::QEnvironmentLight

Ein Umgebungslicht-Objekt in eine „ Qt 3D “-Szene einbinden. Mehr...

Kopfzeile:	`#include <qenvironmentlight.h>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS 3drender)` `target_link_libraries(mytarget PRIVATE Qt6::3drender)`
qmake:	`QT += 3drender`
In QML:	EnvironmentLight
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

irradiance : Qt3DRender::QAbstractTexture*
specular : Qt3DRender::QAbstractTexture*

Öffentliche Funktionen

Qt3DRender::QAbstractTexture *	irradiance() const
Qt3DRender::QAbstractTexture *	specular() const

Öffentliche Slots

void	setIrradiance(Qt3DRender::QAbstractTexture *irradiance)
void	setSpecular(Qt3DRender::QAbstractTexture *specular)

Signale

void	irradianceChanged(Qt3DRender::QAbstractTexture *environmentIrradiance)
void	specularChanged(Qt3DRender::QAbstractTexture *environmentSpecular)

Ausführliche Beschreibung

QEnvironmentLight verwendet Cubemaps zur Implementierung der bildbasierten Beleuchtung (IBL), einer Technik, die häufig in Verbindung mit physikalisch basiertem Rendering (PBR) eingesetzt wird. Die Cubemaps basieren in der Regel auf High-Dynamic-Range-Bildern (HDR) in einem geeigneten OpenGL-Format (z. B. RGBA16F), das den erweiterten Wertebereich verarbeiten kann.

Es gibt eine Vielzahl von Tools, mit denen die von QEnvironmentLight benötigten Cubemaps erstellt werden können. Einige Beispiele hierfür sind

HDRI Haven stellt zahlreiche CC0-lizenzierte HDR-Bilder zur Verfügung, die als Ausgangsmaterial für die oben genannten Tools verwendet werden können.

Dokumentation zu den Eigenschaften

irradiance : Qt3DRender::QAbstractTexture*

Enthält die aktuelle Textur der Umgebungsstrahlungskarte.

Standardmäßig ist die Umgebungsstrahlungstextur null.

Hinweis: Die genaue Bedeutung und Verwendung dieser Eigenschaft hängt von der Materialimplementierung ab.

Zugriffsfunktionen:

Qt3DRender::QAbstractTexture *	irradiance() const
void	setIrradiance(Qt3DRender::QAbstractTexture *irradiance)

Notifier-Signal:

void	irradianceChanged(Qt3DRender::QAbstractTexture *environmentIrradiance)

specular : Qt3DRender::QAbstractTexture*

Enthält die aktuelle Specular-Map-Textur der Umgebung.

Standardmäßig ist die Umgebungs-Spiegelungstextur null.

Hinweis: Die genaue Bedeutung und Verwendung dieser Eigenschaft hängt von der Materialimplementierung ab.

Zugriffsfunktionen:

Qt3DRender::QAbstractTexture *	specular() const
void	setSpecular(Qt3DRender::QAbstractTexture *specular)

Benachrichtigungssignal:

void	specularChanged(Qt3DRender::QAbstractTexture *environmentSpecular)

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