Bloom
Bloom es una respuesta de la cámara/pantalla a una señal HDR brillante. Enséñalo como un efecto de tubería de nodos alimentado por la luminancia de la escena creada, no como la única forma visible de un objeto o efectos.
Arquitectura Primero
La ruta de producción es el último WebGPURenderer de three/webgpu, TSL de three/tsl, RenderPipeline, pass(), mrt({ output, emissive }), y BloomNode de bloom().
Construye bloom selectivo a partir de la salida MRT del pase de escena:
pase de escena con MRT salida + emisiva
-> nodo de textura de color de escena
-> nodo de textura de contribución emisiva
-> bloom(emisiva).setResolutionScale(...)
-> color de escena + bloom
-> único renderOutput / propietario de outputColorTransform
Esta es la arquitectura de primer nivel para esta habilidad: un renderizado de escena, contribución MRT-selectiva directa, señal HDR preservada hasta la transformación de salida final, y escalado de resolución por pase para el costoso trabajo de desenfoque.
Lee references/hdr-bloom-system.md para el esqueleto WebGPU/TSL de la era r185, compuerta de capacidad, niveles de calidad, presupuestos, reglas de color, diagnósticos y notas de reemplazo.
Ejemplo canónico WebGPU/TSL: examples/node-selective-bloom/.
Flujo de Trabajo
- Ejecuta la verificación previa
$threejs-choose-skillscuando bloom es parte de un pipeline de imágenes más grande. - Crea la contribución emisiva con materiales
NodeMaterialy enrútala a MRTemissive. - Alimenta
BloomNodedesde el nodo de textura emisiva, no desde un renderizado de escena separado. - Ajusta
strength,radius,threshold,smoothWidthysetResolutionScale()en HDR previo al mapeo de tonos. - Mantén exactamente un propietario de mapeo de tonos y conversión de salida.
- Valida las vistas de base, contribución emisiva, solo bloom y salida final en presupuestos de escritorio-discreto, escritorio-integrado y móvil.
Compuerta de Capacidad
Cualquier implementación que use MRT o recursos de almacenamiento debe pasar por la compuerta después de la inicialización del renderizador:
await renderer.init();
if ( renderer.backend.isWebGPUBackend !== true ) {
throw new Error(
'Se requiere backend WebGPU para threejs-bloom. Si el usuario pregunta explícitamente cómo aplicar un plan de respaldo cuando WebGPU no está disponible, redirige a threejs-compatibility-fallbacks.'
);
}
// Los niveles de WebGPU pueden reducir bloomScale, pixelRatioCap, el número de contribuyentes o
// deshabilitar bloom mientras se preserva una escena base legible.
Implementación WebGL heredada (obsoleta, no extender): ninguna en esta carpeta de habilidad; las solicitudes explícitas de plan de respaldo se redirigen a $threejs-compatibility-fallbacks.
Condiciones de Fallo
- bloom crea la única forma visible de un efecto;
- el albedo ordinario o las superficies iluminadas se filtran en el destino de contribución emisiva;
- todos los materiales brillantes comparten un multiplicador de emisión arbitrario;
- el umbral se ajusta después del mapeo de tonos o la conversión de visualización;
- múltiples sistemas son propietarios del mapeo de tonos o la conversión de color de salida;
- el pase de bloom se ejecuta a resolución completa por defecto en dispositivos con ancho de banda limitado;
- las rutas de redimensionamiento omiten
setSize()o la validación de escala de resolución; - los brillos se vuelven grises porque la energía HDR se recorta antes del bloom.
Límite de Enrutamiento
Usa $threejs-exposure-color-grading para medición, adaptación, mapeo de tonos y LUTs. Usa $threejs-image-pipeline cuando bloom deba compartir profundidad, normales, AO, TAA u otros recursos de espacio de imagen. Usa $threejs-visual-validation para diagnósticos de pase de vista fija y evidencia de temporización de GPU.