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

「Box offset」は、リフレクションプローブの位置を基準にボックスを移動させるために使用されます。プローブはその位置から環境をキャプチャするため、このプロパティを使用することで、プローブが環境をキャプチャする位置に影響を与えることなく、ボックスを移動させることができます。このプロパティは、「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

「品質」はキューブマップの解像度を決定します。

設定可能な値は以下の通りです：

デフォルト値はReflectionProbe.Low

refreshMode : enumeration

「リフレッシュモード」は、キューブマップをどのくらいの頻度で更新すべきかをランタイムに指定します。

設定可能な値は以下の通りです：

デフォルト値はReflectionProbe.EveryFrame

texture : CubeMapTexture [since 6.5]

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

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

「CubeMapTexture」も参照してください 。

timeSlicing : enumeration

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

設定可能な値は以下の通りです：

デフォルト値はReflectionProbe.None

メソッドのドキュメント

void scheduleUpdate()

ReflectionProbe::refreshMode がReflectionProbe.FirstFrame に設定されている状態で呼び出された場合、リフレクションプローブのレンダリングを更新します。