このページでは

DepthOfFieldHQBlur QML Type

深度に基づくぼかし効果。詳細...

Import Statement: import QtQuick3D.Effects 6.12
Status: Deprecated since 6.5

このタイプは、QtQuick3D.Effects 6.5 以降で非推奨となっています。新しいコードでの使用は強く推奨しません。

プロパティ

詳細説明

代わりにExtendedSceneEnvironment を使用してください。

警告: `QtQuick3D.Effects`にあるすべての 既製のスタンドアロンエフェクトは、Qt 6.5 以降で非推奨となります。シーンに被写界深度エフェクトを適用するには、代わりに `ExtendedSceneEnvironment ` を使用してください。

被写界深度によるボケ効果を示すシーンの比較

DepthOfFieldHQBlur エフェクトは、カメラからの指定距離からのずれに基づいて、画像の特定の領域にグラデーションぼかしを適用します。

このエフェクトを適切に機能させるには、シーンのカメラの `clipFar ` および `clipNear ` プロパティを調整して、コンテンツをフレーム内に収める必要があります。理想的には、`clipNear ` の値を可能な限り大きくし、`clipFar` の値を可能な限り小さくします。次に、希望する結果が得られるよう、エフェクトのプロパティを調整します。

たとえば、focusDistance を100 、focusRange を20 に設定すると、カメラから90~110ユニットの距離にあるすべてのオブジェクトは完全にピントが合っており、 70~90ユニットおよび110~130ユニットの距離にある被写体には程度が異なるボケが生じ、70ユニットより近く、あるいは130ユニットより遠いものはすべて完全にぼやけてしまいます。

TiltShiftも参照してください 。

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

blurAmount : real

ピントが合っていないときのボケの強さ。適切な値は[1...10] の範囲内です。デフォルト値は4 です。

focusDistance : real

コンテンツが完全にピントの合った状態になるカメラからの距離。デフォルト値は600 です。

focusRange : real

focusDistance の周囲で、オブジェクトが完全にピントの合った範囲の距離です。この距離を境に、近方側と遠方側の両方で、ピントが徐々にぼやけていき、同じ距離分だけ完全にぼやけた状態になります。デフォルト値は100 です。

© 2026 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.