ReflectionProbe QML Type

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

Import Statement: import QtQuick3D
Inherits:

Node

プロパティ

方法

詳細説明

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

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 [since 6.4]

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

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


parallaxCorrection : bool

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

boxSizeも参照してください


quality : enumeration

Quality(品質) キューブマップの解像度を決定します。

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

一定説明
ReflectionProbe.VeryLow128x128 テクスチャを使用してリフレクション・マップをレンダリングします。
ReflectionProbe.Low256x256 テクスチャを使用して反射マップをレンダリングします。
ReflectionProbe.Medium512x512テクスチャを使用して反射マップをレンダリングします。
ReflectionProbe.High1024x1024テクスチャを使用して反射マップをレンダリングします。
ReflectionProbe.VeryHigh2048x2048テクスチャを使用して反射マップをレンダリングします。

デフォルト値はReflectionProbe.Low


refreshMode : enumeration

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

指定可能な値は次のとおりです:

定数説明
ReflectionProbe.FirstFrame最初のフレームでシーンをレンダリングします。
ReflectionProbe.EveryFrameフレームごとにシーンをレンダリングします。

デフォルト値はReflectionProbe.EveryFrame

注: パフォーマンスを向上させるには、ReflectionProbe.FirstFrame を使用してください。


texture : CubeMapTexture [since 6.5]

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

このプロパティは 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::refreshModeReflectionProbe.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.