Recomposed
Draw

BlendMode vs CompositingStrategy: Não é uma Cerca, é uma Tela Diferente

Oct 11, 2026 · 6 min read

BlendMode vs CompositingStrategy: Não é uma Cerca, é uma Tela Diferente

A intuição

CompositingStrategy.Offscreen parece construir uma cerca em volta do seu blend mode, uma parede que impede seu efeito de vazar para pixels fora do seu componente.

  • Esse é o efeito certo, mas o mecanismo errado, e o mecanismo errado quebra no momento em que você faz uma pergunta mais afiada: o que o blend mode realmente lê como , e não apenas o que ele afeta?
  • BlendMode é a fórmula: out = f(src, dst). Multiply, Clear, DstOut são apenas f diferentes.
  • CompositingStrategy decide o que dst é: a tela real, já pintada, ou um buffer novo, privado e transparente no qual apenas a sua subárvore desenhou.

Sem isolamento, suas chamadas de desenho se misturam com o que já está na superfície real da tela, fundo, irmãos pintados antes, tudo isso. Com Offscreen, elas se misturam com um buffer que começa totalmente vazio, então não há nada "fora" para o blend ler ou tocar, porque esse buffer contém apenas o que sua subárvore desenhou.

Então o isolamento não restringe o alcance de uma operação depois do fato, ele entrega à operação um substrato diferente para funcionar desde o início. Pintar sem Offscreen é pintar diretamente na foto. Pintar com ele é pintar sobre uma folha de filme transparente, a mistura só acontece filme sobre filme, e só quando você termina é que coloca o filme finalizado sobre a foto.

Referência: blend modes comuns e suas fórmulas

BlendMode tem muito mais valores do que qualquer post precisaria, mas estes são os que você realmente vai usar. src é o pixel que você está desenhando, dst é o que já está ali, srcA/dstA são seus alfas:

Blend modeFórmulaO que faz
Clearout = 0Apaga dst onde src é desenhado, ignorando completamente a cor do próprio src.
Srcout = srcSubstitui dst por completo, como se nada estivesse ali antes.
Dstout = dstNo-op: mantém o que já estava ali, descarta src.
SrcOver (o padrão)out = src + dst·(1-srcA)Pintura comum: src por cima, dst aparecendo onde src é transparente.
DstOverout = dst + src·(1-dstA)O mesmo que SrcOver com os papéis trocados: dst pinta por cima de src.
SrcInout = src·dstAMantém src apenas onde dst já tinha algo, usando a forma de dst como máscara.
DstInout = dst·srcAMantém dst apenas onde src tem algo, "corta dst para a forma de src."
SrcOutout = src·(1-dstA)Mantém src apenas onde dst estava vazio, o inverso de SrcIn.
DstOutout = dst·(1-srcA)Apaga dst onde src é desenhado, "subtrai a forma de src de dst," o modo de texto vazado (knockout).
SrcAtopout = src·dstA + dst·(1-srcA)src só aparece dentro da forma já existente de dst; dst aparece por fora.
DstAtopout = dst·srcA + src·(1-dstA)dst só aparece dentro da forma de src; src aparece por fora.
Xorout = src·(1-dstA) + dst·(1-srcA)Mantém qualquer um entre src/dst que esteja presente, não os dois; a sobreposição desaparece.
Plusout = src + dst (com clamp)Aditivo: as cores se somam e clareiam, o modo por trás de efeitos de brilho e acúmulo de luz.
Multiplyout = src · dstEscurece: o resultado nunca é mais claro que qualquer uma das entradas, como sobrepor dois filtros de cor translúcidos.
Screenout = src + dst - src·dstClareia: o inverso de Multiply, o resultado nunca é mais escuro que qualquer uma das entradas.
Darkenout = min(src, dst)Mantém o que for mais escuro, canal a canal.
Lightenout = max(src, dst)Mantém o que for mais claro, canal a canal.
Differenceout = |src - dst|Diferença absoluta por canal, usada para efeitos de contraste/inversão.
OverlayMultiply ou Screen, escolhido por pixel conforme o valor de dstEscurece áreas escuras e clareia áreas claras de dst em uma única passada; contraste e tonalidade combinados.

Tudo isso está no eixo da fórmula. Nenhum desses diz nada sobre se dst é a tela real ou um buffer privado, esse é o outro eixo, e é sobre isso que trata o resto deste post.

A web tem um equivalente quase exato: o globalCompositeOperation do Canvas 2D é majoritariamente uma renomeação literal dessa mesma tabela (source-over, source-in, destination-out, multiply, screen, ...). Escolha um modo abaixo e veja tanto a chamada do Compose quanto a fórmula acontecerem em duas formas que se sobrepõem:

Canvas(Modifier.fillMaxSize()) {
    drawRect(Color.Blue, size = dstSize)  // dst
    drawCircle(Color.Red, blendMode = BlendMode.SrcOver)  // src
}

blue square = dst (drawn first), red circle = src (drawn under the selected mode)

out = src + dst·(1-srcA) — SrcOver: Ordinary painting: src on top, dst showing through wherever src is transparent.

Ordinary painting: src on top, dst showing through wherever src is transparent.

O bug que Auto silenciosamente corrige para você

Box(Modifier.graphicsLayer { alpha = 0.5f }) {
    Box(Modifier.background(Color.Red).size(80.dp))
    Box(Modifier.background(Color.Blue).size(80.dp).offset(40.dp, 40.dp))
}

Dois filhos sobrepostos e semi-transparentes, com o padrão compositingStrategy = Auto. O Compose detecta a sobreposição e silenciosamente promove esse grupo para Offscreen por você, e aqui está o motivo pelo qual precisa fazer isso:

  • Sem isolamento, cada filho se mistura individualmente com o fundo real, então a região de sobreposição é atingida duas vezes: uma vez por vermelho-sobre-fundo, depois novamente por azul-sobre-(vermelho-sobre-fundo). A costura fica visivelmente mais escura do que "desenhar os dois completamente, depois esmaecer o resultado uma única vez."
  • Com isolamento, ambas as caixas desenham totalmente opacas em seu próprio buffer vazio primeiro, então elas se compõem corretamente entre si, e só então o alfa 0.5f do grupo é aplicado uma única vez, ao resultado final e já achatado.

Auto está fazendo um favor aqui, detectando a sobreposição e recorrendo ao isolamento em seu nome. Ative e desative o isolamento abaixo, sobre as mesmas duas caixas sobrepostas, para ver a costura aparecer e desaparecer:

Each box faded individually: the overlap is visibly darker. No isolation: boxes each blended individually against the real canvas, producing a darker seam at the overlap.

O próximo caso é onde Auto não consegue ajudar de forma alguma.

Onde o isolamento não é opcional: blend modes que apagam

Modifier.graphicsLayer {
    compositingStrategy = CompositingStrategy.Offscreen   // required, not optional
}.drawWithContent {
    drawContent()
    drawCircle(Color.Black, radius = 60.dp.toPx(), blendMode = BlendMode.Clear)
}

BlendMode.Clear significa "apague dst aqui." Qual dst depende inteiramente de o isolamento ter sido executado antes:

  • Sem Offscreen, dst é a tela real, então isso abre um buraco através de tudo que já foi desenhado abaixo dele em todo o frame, outras partes da UI, o fundo da janela, tudo.
  • Com Offscreen, dst é o buffer privado dessa camada. Clear só apaga pixels que essa subárvore já desenhou, e o buffer com o buraco recortado então se compõe normalmente sobre a tela real. Essa é a técnica padrão de holofote / selo com recorte, e é também por isso que o texto vazado (knockout text) (um buraco em forma de texto recortado em uma foto, via DstOut) precisa da mesma configuração: isole a foto e o texto como um grupo primeiro, depois recorte o buraco no próprio buffer do grupo.

O fundamental

Mecanicamente, isolamento é o saveLayer do Skia (e de todo renderizador 2D): empurra um novo buffer offscreen, desenha nele, depois retorna compondo o buffer inteiro sobre o que já estava ali com uma única operação de pintura, alfa, blend mode ou filtro aplicado exatamente uma vez. CompositingStrategy.Offscreen é o graphicsLayer pedindo exatamente isso. Auto executa o mesmo mecanismo, só que apenas quando algo, alfa de grupo sobre filhos sobrepostos, um blend mode não padrão, certos RenderEffects, realmente precisa disso.

Em outros lugares: o mesmo fundamento, frameworks diferentes

  • CSS: isolation: isolate abre um novo contexto de empilhamento, então mix-blend-mode em elementos dentro dele deixa de alcançar elementos fora dele.
  • SwiftUI: .compositingGroup() achata uma subárvore em uma única camada antes que qualquer .blendMode() ou .opacity() acima dela seja aplicado.
  • Skia, o renderizador sobre o qual o Compose se apoia: canvas->saveLayer() / restore() é o primitivo literal para o qual ambos os casos acima são compilados.
  • Flutter: os widgets Opacity/ColorFiltered recebem uma camada offscreen implícita sempre que seu filho não é um único primitivo opaco.
  • Photoshop: um grupo de camadas com "atravessar" (pass through) desativado é a chave de isolamento. "Atravessar" (o padrão) deixa blend modes vazarem para camadas abaixo; desativá-lo isola o grupo primeiro, o análogo exato do Photoshop para Offscreen.
  • Canvas 2D: nenhum primitivo de isolamento embutido, cada chamada de desenho se compõe diretamente sobre o único bitmap visível. Simular saveLayer manualmente significa criar um segundo <canvas> em memória, desenhar nele, depois usar drawImage() para colocar o resultado finalizado sobre o visível com o alfa do grupo, exatamente o que a demo de alternância acima faz por baixo dos panos.

Caso extremo: ModulateAlpha apostando errado

CompositingStrategy.ModulateAlpha é uma otimização mais restrita do que Offscreen: em vez de alocar um buffer, ela multiplica o alfa do grupo no próprio alfa de cada filho enquanto desenha, pulando o isolamento por completo. Isso dá o mesmo resultado visual de Offscreen, mas apenas quando os filhos genuinamente não se sobrepõem.

Recorra a ela depois que o profiling mostrar que o buffer extra e a passada extra de composição do Offscreen realmente custam algo, não antes. Se uma mudança posterior adicionar um filho sobreposto, não há detecção para capturar isso da forma como Auto captura o caso de sobreposição, ModulateAlpha simplesmente mistura a sobreposição duas vezes em silêncio, reproduzindo a exata costura do primeiro exemplo, exceto que, nesse caso, nada o promove de volta para Offscreen por você. É uma otimização que você escolhe adotar depois de confirmar a suposição de não sobreposição, não um padrão ao qual você recorre por padrão.

Modelo mental para usar de fato

BlendMode decide a fórmula; CompositingStrategy decide o que dst sequer é, o isolamento não cerca essa fórmula, ele entrega a ela uma tela em branco para se misturar, em vez da tela real.

Keep reading

Related reads

Receba novos posts no seu e-mail