Bloom
Bloom é uma resposta da câmera/tela a um sinal HDR brilhante. Ensine-o como um efeito de pipeline de nó único, alimentado pela luminância da cena criada pelo autor, não como a única forma visível de um objeto ou efeito.
Arquitetura Primeiro
O caminho de produção é o WebGPURenderer mais recente do Three.js, de three/webgpu, TSL de three/tsl, RenderPipeline, pass(), mrt({ output, emissive }) e BloomNode de bloom().
Construa bloom seletivo a partir da saída MRT emissiva do passe de cena:
passe de cena com MRT output + emissive
-> nó de textura de cor da cena
-> nó de textura de contribuição emissiva
-> bloom(emissive).setResolutionScale(...)
-> cor da cena + bloom
-> único proprietário de renderOutput / outputColorTransform
Esta é a arquitetura de ponta para esta skill: uma renderização de cena, contribuição seletiva direta via MRT, sinal HDR preservado até a transformação final de saída e escalonamento de resolução por passe para o trabalho caro de desfoque.
Leia references/hdr-bloom-system.md para o esqueleto WebGPU/TSL da era r185, gate de capacidade, níveis de qualidade, orçamentos, regras de cor, diagnósticos e notas de substituição.
Exemplo canônico WebGPU/TSL: examples/node-selective-bloom/.
Fluxo de Trabalho
- Execute
$threejs-choose-skillscomo pré-verificação quando bloom fizer parte de um pipeline de imagem maior. - Crie a contribuição emissiva com materiais
NodeMateriale encaminhe-a para MRTemissive. - Alimente
BloomNodea partir do nó de textura emissiva, não de uma renderização de cena separada. - Ajuste
strength,radius,threshold,smoothWidthesetResolutionScale()em HDR pré-mapeamento de tom. - Mantenha exatamente um proprietário de mapeamento de tom e conversão de saída.
- Valide as visualizações de base, contribuição emissiva, bloom apenas e saída final nos orçamentos de desktop discreto, desktop integrado e móvel.
Gate de Capacidade
Qualquer implementação que use MRT ou recursos de armazenamento deve passar pelo gate após a inicialização do renderizador:
await renderer.init();
if ( renderer.backend.isWebGPUBackend !== true ) {
throw new Error(
'Backend WebGPU necessário para threejs-bloom. Se o usuário perguntar explicitamente como aplicar fallback quando WebGPU não estiver disponível, encaminhe para threejs-compatibility-fallbacks.'
);
}
// As camadas WebGPU podem reduzir bloomScale, pixelRatioCap, número de contribuidores ou
// desabilitar o bloom enquanto preservam uma cena base legível.
Implementação WebGL legada (obsoleta, não estenda): nenhuma nesta pasta de skill; solicitações explícitas de fallback devem ser encaminhadas para $threejs-compatibility-fallbacks.
Condições de Falha
- bloom cria a única forma visível de um efeito;
- albedo comum ou superfícies iluminadas vazam para o alvo de contribuição emissiva;
- todos os materiais brilhantes compartilham um multiplicador de emissão arbitrário;
- threshold é ajustado após o mapeamento de tom ou conversão de exibição;
- múltiplos sistemas são donos do mapeamento de tom ou conversão de cor de saída;
- o passe de bloom roda em resolução total por padrão em dispositivos com largura de banda limitada;
- caminhos de redimensionamento omitem
setSize()ou validação de escala de resolução; - realces se tornam cinza porque a energia HDR é limitada antes do bloom.
Limite de Roteamento
Use $threejs-exposure-color-grading para medição, adaptação, mapeamento de tom e LUTs. Use $threejs-image-pipeline quando o bloom precisar compartilhar profundidade, normais, oclusão de ambiente (AO), TAA ou outros recursos de espaço de imagem. Use $threejs-visual-validation para diagnósticos de passe de visão fixa e evidência de tempo de GPU.