Qt3DRender::QEnvironmentLight Class

class Qt3DRender::QEnvironmentLight

Intégrer un objet « lumière d'ambiance » dans une scène d'Qt 3D. En savoir plus...

En-tête :	`#include <qenvironmentlight.h>`

CMake :	`find_package(Qt6 REQUIRED COMPONENTS 3drender)` `target_link_libraries(mytarget PRIVATE Qt6::3drender)`
qmake :	`QT += 3drender`
En QML :	EnvironmentLight
Hérite de :	Qt3DCore::QComponent
Statut :	Obsolète

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

Liste de tous les membres, y compris les membres hérités

Propriétés

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

Fonctions publiques

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

Emplacements publics

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

Signaux

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

Description détaillée

QEnvironmentLight utilise des cubemaps pour mettre en œuvre l'éclairage basé sur l'image (IBL), une technique souvent utilisée en association avec le rendu basé sur la physique (PBR). Les cubemaps doivent généralement être basés sur des images à plage dynamique élevée (HDR), dans un format OpenGL adapté (tel que RGBA16F) capable de gérer cette plage de valeurs étendue.

Il existe divers outils permettant de générer les cubemaps requis par QEnvironmentLight. En voici quelques exemples :

HDRI Haven propose de nombreuses images HDR sous licence CC0 pouvant servir de matériel source pour les outils mentionnés ci-dessus.

Documentation sur les propriétés

irradiance : Qt3DRender::QAbstractTexture*

Contient la texture de la carte d'irradiance de l'environnement actuel.

Par défaut, la texture d'irradiance de l'environnement est nulle.

Remarque : la signification exacte et l'utilisation de cette propriété dépendent de l'implémentation du matériau.

Fonctions d'accès :

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

Signal de notification :

void	irradianceChanged(Qt3DRender::QAbstractTexture *environmentIrradiance)

specular : Qt3DRender::QAbstractTexture*

Contient la texture de la carte spéculaire de l'environnement actuel.

Par défaut, la texture spéculaire de l'environnement est nulle.

Remarque : la signification et l'utilisation exactes de cette propriété dépendent de l'implémentation du matériau.

Fonctions d'accès :

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

Signal de notification :

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.