Light QML Type
すべてのライトのための、作成不可能な抽象ベース型。詳細...
| Import Statement: | import QtQuick3D |
| Inherits: | |
| Inherited By: |
プロパティ
- ambientColor : color
- bakeMode : enumeration
- brightness : real
- castsShadow : bool
- color : color
- pcfFactor : real
(since 6.8) - scope : Node
- shadowBias : real
- shadowFactor : real
- shadowMapFar : real
- shadowMapQuality : enumeration
- softShadowQuality : enumeration
(since 6.8) - use32BitShadowmap : bool
(since 6.9)
詳細説明
ライト自体は、すべてのサブタイプのための作成不可能なベースである。サブタイプは、ライトのスタイルを決定するための複数のオプションを提供します。
使用例については、Qt Quick 3D - ライトの例 を参照してください。
DirectionalLight およびPointLightも参照して ください。
プロパティのドキュメント
ambientColor : color
このプロパティは、このライトで照らされる前にマテリアルに適用されるアンビエントカラーを定義します。デフォルト値は黒、rgb(0, 0, 0)です。
bakeMode : enumeration
このプロパティは、ライトマップを生成するときなど、ベイクド・ライティングでライトがアクティブかどうかを制御します。
| 定数 | 説明 |
|---|---|
Light.BakeModeDisabled | このライトはベイクされたライティングでは使用されません。 |
Light.BakeModeIndirect | 間接照明の寄与（グローバルイルミネーション）は、このライトに対してベイクされます。ダイレクトライティング（ディフューズ、スペキュラ、リアルタイムシャドウマッピング）は、実行時にライトに対して通常通り計算されます。実行時に、ベイクモードでない場合、レンダラーはライトマップをサンプリングして間接照明データを取得し、リアルタイム計算の結果と組み合わせようとします。 |
Light.BakeModeAll | このライトでは、直接照明（ディフューズ、シャドウ）と間接照明の両方がベイクされます。このライトはスペキュラの寄与を持たず、リアルタイムのシャドウマップを生成しませんが、常にベイクされたシャドウを持ちます。実行時、ベイクモードでない場合、レンダラーはディフューズライティングとシャドウマッピングの標準的なリアルタイム計算の代わりにライトマップのサンプリングを試みます。 |
デフォルト値はLight.BakeModeDisabled
注意: Model::usedInBakedLighting と同様に、デザイナーや開発者は、そのライトがベイクド・ライティングに適しているかどうかを常にライトごとに評価する必要があります。
警告 警告: 動的に変化するプロパティ、たとえば、位置、回転、その他のプロパティを持つライトは、ベイクド・ライティングに参加するのに適していません。
このプロパティは、ベイク時とライトマップ使用時の両方に関係します。ベイクの実行と、生成されたデータを使用する後続の実行の間で、一貫した状態が不可欠です。ただし、エンジンのレンダリング動作はプロパティの現在の値に従います。
ライトマップをベイクする方法の詳細については、ライトマップとグローバルイルミネーションを参照してください。
Model::usedInBakedLighting 、Model::bakedLightmap 、Lightmapper 、「ライトマップとグローバル イルミネーション」も参照して ください。
brightness : real
このプロパティは、このライトの効果の全体的な乗数を定義します。デフォルト値は 1 です。
castsShadow : bool
このプロパティを有効にすると、ライトは（リアルタイムの）影を落とします。デフォルト値は false です。
注意: bakeMode が Light.BakeModeAll に設定されている場合、このプロパティは影響しません。完全にベイクされたライトは、常にベイクされたシャドウを持ちますが、リアルタイムのシャドウマッピングに参加することはありません。
color : color
このプロパティは、このライトによって照らされるモデルに適用される色を定義します。デフォルト値は白で、rgb(255, 255, 255)です。
pcfFactor : real [since 6.8]
このプロパティは、PCF（パーセンテージ・クローザー・フィルタリング）係数を制御する。この値は、ワールド空間でのPCFフィルタリングの半径を近似しようとします。
注意： このプロパティが効果を発揮するには、PCFがsoftShadowQuality で設定されている必要があります。
デフォルト値：2.0
このプロパティは Qt 6.8 で導入されました。
Light::softShadowQualityも参照して ください。
scope : Node
このプロパティは、シーン内のノードを選択することができます。このライトの影響を受けるのは、そのノードとその子ノードだけです。デフォルトでは値は NULL で、スコープが選択されていないことを示します。
つまり、スコープが設定されたライトは、castsShadow を true に設定してはいけません。ただし、bakeMode が Light.BakeModeAll に設定されている場合は、ベイクされたシャドウを生成できます。
shadowBias : real
このプロパティは、オブジェクトがそれ自体に影を落とすときのシャドウイング効果を調整するために使用します。この値はワールド空間でのオフセットを近似しようとするため、シーンのサイズに応じて調整する必要があります。
デフォルト値は10
shadowFactor : real
このプロパティは、キャストシャドウの暗さを決定します。値の範囲は [0, 100] で、0 は影がないことを意味し、100 はライトに完全に影があることを意味します。
デフォルト値は75 です。
shadowMapFar : real
このプロパティは、シャドウマップの最大距離を決定します。値が小さいほど、マップの精度と効果が向上します。デフォルト値は5000です。単位はローカル座標空間のポイントです。
shadowMapQuality : enumeration
このプロパティは、シャドウレンダリング用に作成されるシャドウマップの品質を設定します。品質が低いほど使用するリソースは少なくなりますが、品質の低いシャドウが生成され、品質が高いほど使用するリソースは多くなりますが、品質の高いシャドウが生成されます。
サポートされている品質値は次のとおりです：
| 定数 | 説明 |
|---|---|
Light.ShadowMapQualityLow | 256x256 テクスチャを使用してシャドウマップをレンダリングします。 |
Light.ShadowMapQualityMedium | 512x512 テクスチャを使用してシャドウマップをレンダリングします。 |
Light.ShadowMapQualityHigh | 1024x1024 テクスチャを使用してシャドウマップをレンダリングします。 |
Light.ShadowMapQualityVeryHigh | 2048x2048テクスチャを使用してシャドウマップをレンダリングします。 |
Light.ShadowMapQualityUltra | 4096x4096テクスチャを使用してシャドウマップをレンダリングする。 |
デフォルト値はLight.ShadowMapQualityLow
softShadowQuality : enumeration [since 6.8]
このプロパティは、シャドウが有効になっているときに使用されるべきソフトシャドウの品質を提案します。シャドウをレンダリングするときに使用される実際のサンプル数は、マテリアルで使用されるライトによって設定される最高品質によって決定されます。
| 定数 | 説明 |
|---|---|
Light.Hard | ソフトシャドウなし。 |
Light.PCF4 | パーセント クローズ フィルタリング ソフト シャドウ 4 サンプル。 |
Light.PCF8 | ソフトシャドウを8サンプルでフィルタリングする割合。 |
Light.PCF16 | ソフトシャドウを 16 サンプルでフィルタリングする割合。 |
Light.PCF32 | パーセント・クローザー・フィルタリング：ソフトシャドウを 32 サンプルでフィルタリングする。 |
Light.PCF64 | 64サンプルでソフトシャドウをフィルタリングする割合（Percentage-closer）。 |
デフォルト値：Light.PCF4
注意: 現在、16 サンプルより大きな値は 16 サンプルとして扱われます。
このプロパティは Qt 6.8 で導入されました。
Light::pcfFactor およびLight::shadowFilterも参照してください 。
use32BitShadowmap : bool [since 6.9]
このプロパティは、ライトに32ビットシャドウマップ深度バッファを使用するかどうかを制御します。
デフォルト値です：false
このプロパティは Qt 6.9 で導入されました。
Light::castsShadowも参照してください 。
© 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.
