ReflectionProbe QML Type
シーン内の反射プローブを定義する。詳細...
| Import Statement: | import QtQuick3D |
| Inherits: |
プロパティ
- boxOffset : vector3d
- boxSize : vector3d
- clearColor : Color
- debugView : bool
(since 6.4) - parallaxCorrection : bool
- quality : enumeration
- refreshMode : enumeration
- texture : CubeMapTexture
(since 6.5) - timeSlicing : enumeration
メソッド
詳細説明
反射プローブは、現在のシーンの反射をオブジェクトに提供するために使用されます。プローブはランタイムにプロパティを提供し、そのプロパティはシーンをキューブマップにレンダリングするために使用されます。キューブマップは、反射オブジェクトの反射情報として使用されます。
Qt Quick 3D - 反射プローブの例」も参照してください 。
プロパティの説明
boxOffset : vector3d |
Box offset は、反射プローブの位置に対してボックスを相対的に移動するために使用します。プローブはその位置から環境をキャプチャするので、このプロパティを使用すると、プローブが環境をキャプチャする位置に影響を与えることなく、ボックスを移動させることができます。このプロパティは、ReflectionProbe::boxSize と共に、ボックス内に入るオブジェクトを決定するために使用されます。ReflectionProbe::parallaxCorrection をオンにすると、このプロパティを使用してボックスを配置し、より正確な反射を得ることができます。
parallaxCorrectionも参照してください 。
boxSize : vector3d |
ボックスのサイズは、どのオブジェクトがこのReflectionProbe から反射を得るかを決定するために使用されます。ボックスの内側にあるオブジェクトは、このReflectionProbe の影響下にあります。オブジェクトが同時に複数の反射プローブの内側にある場合、オブジェクトは最も近い反射プローブの内側にあるとみなされます。ReflectionProbe::parallaxCorrection をオンにすると、サイズは立方体マップの反射の距離の計算にも使われます。
parallaxCorrectionも参照してください 。
clearColor : Color |
Clear color は、シーンをレンダリングする前にキューブマップをクリアするために使用される色です。
debugView : bool |
このプロパティを true に設定すると、反射プローブボックスを視覚化するためにワイヤフレームがレンダリングされます。
このプロパティは Qt 6.4 で導入されました。
parallaxCorrection : bool |
デフォルトでは、反射プローブによって提供される反射は、スカイボックスと同様に無限の距離からであると仮定されます。これは、環境反射には問題なく機能しますが、狭い空間では反射にパースペクティブエラーが発生します。これを修正するには、視差補正をオンにします。反射の距離はReflectionProbe::boxSize プロパティで決まります。
boxSizeも参照してください 。
quality : enumeration |
Quality（品質） キューブマップの解像度を決定します。
設定可能な値は次のとおりです：
| 一定 | 説明 |
|---|---|
ReflectionProbe.VeryLow | 128x128 テクスチャを使用してリフレクション・マップをレンダリングします。 |
ReflectionProbe.Low | 256x256 テクスチャを使用して反射マップをレンダリングします。 |
ReflectionProbe.Medium | 512x512テクスチャを使用して反射マップをレンダリングします。 |
ReflectionProbe.High | 1024x1024テクスチャを使用して反射マップをレンダリングします。 |
ReflectionProbe.VeryHigh | 2048x2048テクスチャを使用して反射マップをレンダリングします。 |
デフォルト値はReflectionProbe.Low
refreshMode : enumeration |
Refresh mode は、キューブ・マップを更新する頻度をランタイムに指定します。
指定可能な値は次のとおりです：
| 定数 | 説明 |
|---|---|
ReflectionProbe.FirstFrame | 最初のフレームでシーンをレンダリングします。 |
ReflectionProbe.EveryFrame | フレームごとにシーンをレンダリングします。 |
デフォルト値はReflectionProbe.EveryFrame
注: パフォーマンスを向上させるには、ReflectionProbe.FirstFrame を使用してください。
texture : CubeMapTexture |
シーンをレンダリングする代わりに、このキューブマップテクスチャを使用して、この反射プローブの影響を受けるオブジェクトの反射を表示します。
このプロパティは Qt 6.5 で導入されました。
CubeMapTextureも参照してください 。
timeSlicing : enumeration |
Time slicing は、キューブマップのレンダリングのタイミングを決定します。
可能な値は次のとおりです：
| 定数 | 説明 |
|---|---|
ReflectionProbe.None | キューブマップのすべての面が1フレーム中にレンダリングされ、プリフィルタリングされる。 |
ReflectionProbe.AllFacesAtOnce | すべての面は1フレーム中にレンダリングされるが、プリフィルタリングは各ミップレベルがそれぞれのフレームで処理されるサブクエントフレームに分割される。したがって、粗い面の反射は6フレームごとにリフレッシュされ、滑らかな面の反射はフレームごとにリフレッシュされます。 |
ReflectionProbe.IndividualFaces | 各面は別々のフレームでレンダリングされ、プリフィルタリングされます。したがって、すべての反射は6フレームごとにリフレッシュされます。 |
デフォルト値はReflectionProbe.None
注意： パフォーマンスを上げるには、ReflectionProbe.AllFacesAtOnce またはReflectionProbe.IndividualFaces を使用してください。
メソッドのドキュメント
scheduleUpdate() |
ReflectionProbe::refreshMode がReflectionProbe.FirstFrame に設定されているときに呼び出されると、反射プローブのレンダーを更新します。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
