ReflectionProbe QML Type

씬에서 반사 프로브를 정의합니다. 더 보기...

Import Statement:	`import QtQuick3D`
Inherits:	Node

상속된 멤버를 포함한 모든 멤버 목록

속성

boxOffset : vector3d
boxSize : vector3d
clearColor : Color
debugView : bool (since 6.4)
parallaxCorrection : bool
quality : enumeration
refreshMode : enumeration
texture : CubeMapTexture (since 6.5)
timeSlicing : enumeration

방법

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.VeryLow`	128x128 텍스처를 사용하여 반사 맵을 렌더링합니다.
`ReflectionProbe.Low`	256x256 텍스처를 사용하여 리플렉션 맵을 렌더링합니다.
`ReflectionProbe.Medium`	512x512 텍스처를 사용하여 리플렉션 맵을 렌더링합니다.
`ReflectionProbe.High`	1024x1024 텍스처를 사용하여 리플렉션 맵을 렌더링합니다.
`ReflectionProbe.VeryHigh`	2048x2048 텍스처를 사용하여 리플렉션 맵을 렌더링합니다.

기본값은 ReflectionProbe.Low

refreshMode : enumeration

새로 고침 모드는 큐브 맵을 업데이트할 빈도를 런타임에 알려줍니다.

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

Constant	설명
`ReflectionProbe.FirstFrame`	첫 번째 프레임에 씬을 렌더링합니다.
`ReflectionProbe.EveryFrame`	매 프레임마다 씬을 렌더링합니다.

기본값은 다음과 같습니다. ReflectionProbe.EveryFrame

참고: 성능 향상을 위해 ReflectionProbe.FirstFrame 을 사용합니다.

texture : CubeMapTexture [since 6.5]

이 큐브 맵 텍스처는 씬을 렌더링하는 대신 이 반사 프로브의 영향을 받는 오브젝트의 반사를 표시하는 데 사용됩니다.

이 속성은 Qt 6.5에 도입되었습니다.

CubeMapTexture 를참조하십시오 .

timeSlicing : enumeration

타임 슬라이싱은 큐브 맵 렌더링 시간을 결정하는 방식입니다.

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

Constant	설명
`ReflectionProbe.None`	큐브 맵의 모든 면이 한 프레임 동안 렌더링되고 사전 필터링됩니다.
`ReflectionProbe.AllFacesAtOnce`	모든 면이 한 프레임 동안 렌더링되지만 사전 필터링은 각 밉 레벨이 자체 프레임에서 처리되는 하위 프레임으로 나뉩니다. 따라서 거친 표면의 리플렉션은 6번째 프레임마다 새로 고쳐지는 반면 매끄러운 표면은 매 프레임마다 리플렉션이 새로 고쳐집니다.
`ReflectionProbe.IndividualFaces`	각 면은 별도의 프레임에서 렌더링되고 사전 필터링됩니다. 따라서 모든 리플렉션은 여섯 번째 프레임마다 새로 고쳐집니다.

기본값은 다음과 같습니다. ReflectionProbe.None

참고: 성능을 높이려면 ReflectionProbe.AllFacesAtOnce 또는 ReflectionProbe.IndividualFaces 을 사용하세요.

메서드 문서

scheduleUpdate()

ReflectionProbe::refreshMode 이 ReflectionProbe.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.