Qt3DRender::QEnvironmentLight Class

class Qt3DRender::QEnvironmentLight

Qt 3D のシーン内で、環境光オブジェクトをカプセル化します。詳細...

ヘッダー:	`#include <qenvironmentlight.h>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS 3drender)` `target_link_libraries(mytarget PRIVATE Qt6::3drender)`
qmake:	`QT += 3drender`
QML内:	EnvironmentLight
継承元:	Qt3DCore::QComponent
ステータス:	非推奨

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

継承されたメンバーを含むすべてのメンバーの一覧

プロパティ

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

パブリック関数

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

パブリックスロット

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

シグナル

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

詳細な説明

QEnvironmentLight は、キューブマップを使用して、物理ベースレンダリング（PBR）と組み合わせてよく使用される手法である、画像ベースライティング（IBL）を実装します。キューブマップは通常、ハイダイナミックレンジ（HDR）画像に基づいており、値の範囲の拡大に対応できる適切な OpenGL フォーマット（RGBA16F など）が使用されます。

QEnvironmentLight に必要なキューブマップを作成するために使用できるツールは多数あります。その例としては、次のようなものがあります。

HDRI Haven は、上記のツールの素材として使用できる、CC0 ライセンスの HDR 画像を多数提供しています。

プロパティのドキュメント

irradiance : Qt3DRender::QAbstractTexture*

現在の環境の放射照度マップテクスチャを保持します。

デフォルトでは、環境放射照度テクスチャはnullです。

注：このプロパティの正確な意味と使用方法は 、マテリアル実装によって異なります。

アクセス関数：

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

通知シグナル:

void	irradianceChanged(Qt3DRender::QAbstractTexture *environmentIrradiance)

specular : Qt3DRender::QAbstractTexture*

現在の環境スペキュラーマップテクスチャを保持します。

デフォルトでは、環境スペキュラーテクスチャはnullです。

注：このプロパティの正確な意味と 使用方法は 、マテリアルの実装に依存します。

アクセス関数：

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

通知シグナル：

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.