블룸
블룸은 밝은 HDR 신호에 대한 카메라/디스플레이 반응입니다. 작성된 장면 휘도에 의해 공급되는 하나의 노드-파이프라인 효과로 가르치되, 객체나 효과의 유일한 가시 형태로 사용하지 마십시오.
아키텍처 우선
프로덕션 경로는 최신 Three.js WebGPURenderer (three/webgpu), TSL (three/tsl), RenderPipeline, pass(), mrt({ output, emissive }) 및 bloom()의 BloomNode를 사용합니다.
장면 패스 MRT 이미시브 출력으로부터 선택적 블룸을 구축하십시오:
scene pass with MRT output + emissive
-> scene color texture node
-> emissive contribution texture node
-> bloom(emissive).setResolutionScale(...)
-> scene color + bloom
-> single renderOutput / outputColorTransform owner
이 스킬의 최상위 아키텍처입니다: 하나의 장면 렌더링, 직접 MRT-선택적 기여, 최종 출력 변환까지 HDR 신호 보존, 값비싼 블러 작업을 위한 패스별 해상도 스케일링.
r185 시대 WebGPU/TSL 스켈레톤, 기능 게이트, 품질 계층, 예산, 색상 규칙, 진단 및 교체 노트는 references/hdr-bloom-system.md를 참조하십시오.
표준 WebGPU/TSL 예제: examples/node-selective-bloom/.
워크플로
- 블룸이 더 큰 이미지 파이프라인의 일부인 경우
$threejs-choose-skills사전 점검을 실행하십시오. NodeMaterial재질로 이미시브 기여를 작성하고 MRTemissive로 라우팅하십시오.- 별도의 장면 렌더링이 아닌 이미시브 텍스처 노드에서
BloomNode를 공급하십시오. - 톤 매핑 전 HDR에서
strength,radius,threshold,smoothWidth및setResolutionScale()을 조정하십시오. - 정확히 하나의 톤 매핑 및 출력 변환 소유자를 유지하십시오.
- 데스크탑-개별, 데스크탑-통합 및 모바일 예산에서 베이스, 이미시브 기여, 블룸 전용 및 최종 출력 뷰를 검증하십시오.
기능 게이트
MRT 또는 스토리지 리소스를 사용하는 모든 구현은 렌더러 초기화 후 게이트해야 합니다:
await renderer.init();
if ( renderer.backend.isWebGPUBackend !== true ) {
throw new Error(
'WebGPU backend required for threejs-bloom. If the user explicitly asks how to apply fallback when WebGPU is unavailable, route to threejs-compatibility-fallbacks.'
);
}
// WebGPU 티어는 bloomScale, pixelRatioCap, 기여자 수를 줄이거나
// 읽을 수 있는 기본 장면을 유지하면서 블룸을 비활성화할 수 있습니다.
레거시 WebGL 구현 (더 이상 사용하지 않음, 확장 금지): 이 스킬 폴더에는 없음; 명시적 폴백 요청은 $threejs-compatibility-fallbacks로 라우팅됩니다.
실패 조건
- 블룸이 효과의 유일한 가시 형태를 만드는 경우;
- 일반 알베도 또는 조명된 표면이 이미시브 기여 대상으로 누출되는 경우;
- 모든 밝은 재질이 하나의 임의 방출 배율을 공유하는 경우;
- 임계값이 톤 매핑 또는 디스플레이 변환 후에 조정되는 경우;
- 여러 시스템이 톤 매핑 또는 출력 색상 변환을 소유하는 경우;
- 블룸 패스가 대역폭 제한 장치에서 기본적으로 전체 해상도로 실행되는 경우;
- 크기 조정 경로가
setSize()또는 해상도 스케일 검증을 생략하는 경우; - 블룸 전에 HDR 에너지가 클램핑되어 하이라이트가 회색이 되는 경우.
라우팅 경계
측광, 적응, 톤 매핑 및 LUT에는 $threejs-exposure-color-grading을 사용하십시오. 블룸이 깊이, 법선, AO, TAA 또는 기타 이미지 공간 리소스를 공유해야 하는 경우 $threejs-image-pipeline을 사용하십시오. 고정 뷰 패스 진단 및 GPU 타이밍 증거에는 $threejs-visual-validation을 사용하십시오.