이 페이지에서

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.