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
に設定されているときに呼び出されると、反射プローブのレンダーを更新します。
© 2025 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.