XREstimatedLight은 WebXR의 빛 추정 기능을 사용하여 광도계(light probe), 방향광(directional light) 그리고 (선택적으로) 환경 맵(environment
map)을 생성하여 사용자의 현실 세계의 환경과 조명을 모델링합니다.
WebXR가 빛과 환경 추정을 업데이트할 때, XREstimatedLight는 자동으로 광도계, 방향광, 그리고 환경 맵을 업데이트합니다.
WebXR 세션을 생성할 때 `light-estimation`을 선택적 또는 필수 기능으로 지정하는 것이 중요합니다. 그렇지 않으면 빛 추정 기능은 작동하지 않습니다.
브라우저 호환성 정보는 여기를 참조하십시오. 이는 아직 WebXR의 실험적 기능입니다. 여기
이를 사용하려면, /examples 디렉토리 내의 모든 파일과 마찬가지로, HTML에 별도로 파일을 포함해야 합니다.
[name]은 애드온이므로 명시적으로 가져와야 합니다. [link:#manual/introduction/Installation 설치 / 애드온]을 참조하십시오.
import { XREstimatedLight } from 'three/addons/webxr/XREstimatedLight.js';
renderer.xr.enabled = true;
// XREstimatedLight를 초기 시점에 장면에 추가하지 마세요.
// AR 세션이 시작할 때까지 추정된 조명값이 없기 때문입니다.
const xrLight = new XREstimatedLight( renderer );
xrLight.addEventListener( 'estimationstart' , () => {
scene.add( xrLight );
if ( xrLight.environment ) {
scene.environment = xrLight.environment;
}
} );
xrLight.addEventListener( 'estimationend', () => {
scene.remove( xrLight );
scene.environment = null;
} );
// 조명 추정 기능을 작동하도록 하려면 'light-estimation'을 선택적 또는 필수 기능으로 포함해야 합니다.
document.body.appendChild( XRButton.createButton( renderer, {
optionalFeatures: [ 'light-estimation' ]
} ) );
[example:webxr_ar_lighting webxr / light estimation]
[page:WebGLRenderer renderer]: (필수) 장면을 렌더링하는 렌더러. 주로 WebXRManager와 상호작용하는 데 사용됩니다.
environmentEstimation: `true`로 설정하면 WebXR을 사용하여 환경 맵을 추정합니다.
추정된 조명값이 업데이트 시작할 때 발생합니다.
추정된 조명값이 업데이트 중지할 때 발생합니다.
WebXR에 의해 추정된 환경 맵입니다. 이는 environmentEstimation이 `true`로 설정된 경우에만 사용할 수 있습니다.
이는 [page:Scene.environment], [page:MeshStandardMaterial.envMap], 또는 [page:Scene.background]로 사용할 수 있습니다.
[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/webxr/XREstimatedLight.js examples/jsm/webxr/XREstimatedLight.js]