Communitygithub.com

Bloom – Conjunto completo de habilidades Three.js

25 habilidades de agente experto para escenas ambiciosas de Three.js WebGPU/TSL: océanos procedurales, nubes, planetas, óptica de agua, pipelines de imágenes y validación visual con capturas de pantalla. Para Claude Code, Codex, Cursor y cualquier agente consciente de habilidades.

¿Qué es Bloom – Conjunto completo de habilidades Three.js?

Esta habilidad especializada equipa a los agentes de IA—como Claude Code, Codex y Cursor—con un flujo de trabajo de Bloom de alta fidelidad para Three.js WebGPU/TSL. Está diseñada para la arquitectura de producción más reciente: WebGPURenderer desde 'three/webgpu', TSL desde 'three/tsl', canalizaciones de renderizado, paso MRT con salida y emisiva, y el nodo BloomNode de la función bloom(). En lugar de aplicar Bloom a la escena completa, la habilidad promueve el uso de la contribución emisiva selectiva MRT: la escena se renderiza una vez con MRT que produce texturas de color y emisivas; luego bloom() se aplica solo a la textura emisiva, se mezcla con el color de la escena, y finalmente se aplica una transformación de salida con tone-mapping único. Este enfoque preserva la señal HDR, evita fugas de iluminación difusa o albedo en la emisiva, y permite escalar la resolución del pase de Bloom para ahorrar ancho de banda. La habilidad incluye un control de capacidad (verificar el backend WebGPU), condiciones de fallo detalladas (por ejemplo, no tune el umbral después del mapeo de tonos, no tenga múltiples propietarios de tone-mapping) y límites de enrutamiento a otras habilidades (exposición/color-grading, pipeline de imágenes, validación visual). También se proporciona un esqueleto de referencia (r185) y un ejemplo canónico de nodos selectivos.

Compatible con✓Claude Code✓Codex CLI✓Cursor
npx skills add linegel/threejs-complete-set-of-skill

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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

  1. Ejecuta la verificación previa $threejs-choose-skills cuando bloom es parte de un pipeline de imágenes más grande.
  2. Crea la contribución emisiva con materiales NodeMaterial y enrútala a MRT emissive.
  3. Alimenta BloomNode desde el nodo de textura emisiva, no desde un renderizado de escena separado.
  4. Ajusta strength, radius, threshold, smoothWidth y setResolutionScale() en HDR previo al mapeo de tonos.
  5. Mantén exactamente un propietario de mapeo de tonos y conversión de salida.
  6. 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.

Skills relacionados