ReflectionProbe QML Type

シーン内の反射プローブを定義する。詳細...

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

• boxOffset : vector3d
• boxSize : vector3d
• clearColor : Color
• debugView : bool (since 6.4)
• parallaxCorrection : bool
• quality : enumeration
• refreshMode : enumeration
• texture : CubeMapTexture (since 6.5)
• timeSlicing : enumeration

方法

• void scheduleUpdate()

詳細説明

反射プローブは、現在のシーンの反射をオブジェクトに提供するために使用されます。このプローブはランタイムにプロパティを提供し、そのプロパティを使用してシーンをキューブマップにレンダリングします。キューブマップは、反射オブジェクトの反射情報として使用されます。

Qt Quick 3D - 反射プローブの例も参照してください 。

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

boxOffset : vector3d

ボックスオフセットは、反射プローブの位置に対してボックスを移動するために使用される。プローブはその位置から環境をキャプチャするので、このプロパティを使用すると、プローブが環境をキャプチャする位置に影響を与えることなく、ボックスを移動させることができます。このプロパティは、ReflectionProbe::boxSize と共に、ボックス内に入るオブジェクトを決定するために使用されます。ReflectionProbe::parallaxCorrection をオンにすると、このプロパティを使用してボックスを配置し、より正確な反射を得ることができます。

parallaxCorrectionも参照してください 。

boxSize : vector3d

ボックスのサイズは、どのオブジェクトがこのReflectionProbe からの反射を得るかを決定するために使用される。ボックスの内側にあるオブジェクトは、このReflectionProbe の影響下にある。オブジェクトが同時に複数の反射プローブの内側にある場合、そのオブジェクトは最も近い反射プローブの内側にあるとみなされます。ReflectionProbe::parallaxCorrection をオンにすると、サイズは立方体マップの反射の距離の計算にも使われます。

parallaxCorrectionも参照してください 。

clearColor : Color

クリアカラーは、シーンをレンダリングする前にキューブマップをクリアするために使用される色です。

debugView : bool [since 6.4]

このプロパティを true に設定すると、反射プローブボックスを視覚化するためにワイヤフレームがレンダリングされます。

このプロパティは Qt 6.4 で導入されました。

parallaxCorrection : bool

デフォルトでは、反射プローブによって提供される反射は、スカイボックスと同様に無限距離からの反射であると仮定されます。これは環境反射には問題なく機能しますが、狭い空間では反射にパースペクティブエラーが発生します。これを修正するには、視差補正をオンにします。反射の距離はReflectionProbe::boxSize プロパティで決まります。

boxSizeも参照して ください。

quality : enumeration

Quality は、キューブ・マップの解像度を決定します。

指定可能な値は以下のとおりです：

デフォルト値はReflectionProbe.Low

refreshMode : enumeration

Refresh mode は、キューブ・マップの更新頻度をランタイムに指定します。

指定可能な値は以下のとおりです：

デフォルト値はReflectionProbe.EveryFrame

texture : CubeMapTexture [since 6.5]

シーンをレンダリングする代わりに、この反射プローブの影響を受けるオブジェクトの反射を表示するために、このキューブマップテクスチャが使用されます。

このプロパティは Qt 6.5 で導入されました。

CubeMapTextureも参照してください 。

timeSlicing : enumeration

タイムスライスは、キューブマップのレンダリングのタイミングを決定します。

設定可能な値は次のとおりです：

デフォルト値はReflectionProbe.None

メソッドのドキュメント

void scheduleUpdate()

ReflectionProbe::refreshMode がReflectionProbe.FirstFrame に設定されているときに呼び出されると、反射プローブレンダーを更新します。