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,DstOutsão apenasfdiferentes.CompositingStrategydecide o quedsté: 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.
- →Recomposition, Layout, and DrawScope: One Idea, Three PhasesWhy compositingStrategy and drawWithContent belong to the draw phase specifically, and how that phase model determines what a draw call can read without triggering recomposition.
- →Modifier Order Matters: It's a Wrapper Chain, Not a Property BagThe same wrapper-chain mental model this post uses for compositingStrategy and blend modes, applied to where graphicsLayer sits in a modifier chain generally.
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 mode | Fórmula | O que faz |
|---|---|---|
Clear | out = 0 | Apaga dst onde src é desenhado, ignorando completamente a cor do próprio src. |
Src | out = src | Substitui dst por completo, como se nada estivesse ali antes. |
Dst | out = dst | No-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. |
DstOver | out = dst + src·(1-dstA) | O mesmo que SrcOver com os papéis trocados: dst pinta por cima de src. |
SrcIn | out = src·dstA | Mantém src apenas onde dst já tinha algo, usando a forma de dst como máscara. |
DstIn | out = dst·srcA | Mantém dst apenas onde src tem algo, "corta dst para a forma de src." |
SrcOut | out = src·(1-dstA) | Mantém src apenas onde dst estava vazio, o inverso de SrcIn. |
DstOut | out = dst·(1-srcA) | Apaga dst onde src é desenhado, "subtrai a forma de src de dst," o modo de texto vazado (knockout). |
SrcAtop | out = src·dstA + dst·(1-srcA) | src só aparece dentro da forma já existente de dst; dst aparece por fora. |
DstAtop | out = dst·srcA + src·(1-dstA) | dst só aparece dentro da forma de src; src aparece por fora. |
Xor | out = src·(1-dstA) + dst·(1-srcA) | Mantém qualquer um entre src/dst que esteja presente, não os dois; a sobreposição desaparece. |
Plus | out = 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. |
Multiply | out = src · dst | Escurece: o resultado nunca é mais claro que qualquer uma das entradas, como sobrepor dois filtros de cor translúcidos. |
Screen | out = src + dst - src·dst | Clareia: o inverso de Multiply, o resultado nunca é mais escuro que qualquer uma das entradas. |
Darken | out = min(src, dst) | Mantém o que for mais escuro, canal a canal. |
Lighten | out = max(src, dst) | Mantém o que for mais claro, canal a canal. |
Difference | out = |src - dst| | Diferença absoluta por canal, usada para efeitos de contraste/inversão. |
Overlay | Multiply ou Screen, escolhido por pixel conforme o valor de dst | Escurece á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.5fdo 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.Clearsó 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, viaDstOut) 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: isolateabre um novo contexto de empilhamento, entãomix-blend-modeem 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/ColorFilteredrecebem 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
saveLayermanualmente significa criar um segundo<canvas>em memória, desenhar nele, depois usardrawImage()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.



