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

품질은 큐브 맵의 해상도를 결정합니다.

사용 가능한 값은 다음과 같습니다:

기본값은 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 로 설정된 상태에서 호출될 때, 리플렉션 프로브 렌더링을 업데이트합니다.