O que vamos construir
Uma foto de perfil circular com um ponto colorido no canto. Simples o
suficiente para simular com Modifier.clip(CircleShape) e uma Box
empilhada por cima. A parte que a simulação não alcança é o fino anel de
fundo visível ao redor do ponto, entre ele e a borda da foto, porque
esse anel precisa mostrar o que está realmente atrás do avatar, não uma
cor fixa.
Código-fonte completo: DiscordAvatarScreen.kt.
A intuição
- Arredondar a foto e marcá-la com um ponto de status costumam ser tratados como dois problemas separados: um é recorte, o outro é "desenhar um círculo por cima". Na verdade são a mesma operação aplicada duas vezes: apagar pixels da foto, não pintar por cima deles.
- Um círculo sólido desenhado por cima da foto certamente a esconderia,
mas apenas com a cor fixa do próprio círculo. A lacuna ao redor do
ponto do Discord não é uma cor, é um buraco, o fundo real do cartão
(uma caixa
Zinc800aqui, qualquer coisa no app de verdade) aparecendo intacto. - Obter um buraco em vez de uma mancha colorida significa que tanto o arredondamento dos cantos quanto o recorte do selo precisam passar pelo mesmo mecanismo: apagar, compor corretamente, depois pintar o ponto de volta no buraco.
- →BlendMode vs CompositingStrategy: It's Not a Fence, It's a Different CanvasThe isolation + BlendMode.Clear mechanism this post's cutout badge runs on, including the exact 'spotlight / cutout-badge' case this post builds.
- →animate*AsState vs Animatable: Animation Is Just an Interpolated ValueWhy calling Animatable.animateTo directly, instead of animate*AsState, is what lets Step 4's three radii stage in sequence: each call is a suspend function you can await.
Passo 1: Arredondando a foto sem clip()
val fullRect = Path().apply {
addRect(Rect(topLeft = Offset(0f, 0f), bottomRight = Offset(size.width, size.height)))
}
val innerCircle = Path().apply {
addOval(Rect(center = Offset(size.width / 2f, size.height / 2f), radius = size.minDimension / 2))
}
// XOR of the full square and the inner circle leaves just the four
// corners outside the circle, which get cleared below to round the image.
val cornerPath = Path.combine(
operation = PathOperation.Xor,
path1 = fullRect,
path2 = innerCircle
)Modifier.clip(CircleShape) arredondaria a foto em uma linha, e
normalmente essa é a escolha certa. Também não está errado aqui, só está
incompleto: o recorte só cuida dos cantos.
O buraco do selo ainda precisa do seu próprio BlendMode.Clear dentro
de uma camada Offscreen, independentemente de como os cantos são
arredondados. O stencil da pilha de canvas de um clip não tem como
revelar o que está realmente atrás do avatar, só o Clear consegue
fazer isso.
Construir cornerPath como uma forma explícita significa que uma camada
Offscreen e uma série de chamadas Clear cuidam das duas exclusões,
cantos e selo. A alternativa, combinar clip() para os cantos com uma
segunda passagem offscreen para o selo, monta a mesma engrenagem
offscreen duas vezes.
PathOperation.Xor mantém o que estiver em exatamente um dos dois
caminhos. Como innerCircle está inteiramente dentro de fullRect,
sobram apenas os quatro cantos, o quadrado menos o círculo.
Essa é uma operação booleana de caminhos, combinando duas formas em uma
nova. Não é a fórmula de pixel BlendMode.Xor do post de fundamentos
acima, mesmo nome, camada diferente da API.
AsyncImage(
modifier = Modifier
.fillMaxSize()
.graphicsLayer {
compositingStrategy = CompositingStrategy.Offscreen
}
.drawWithCache {
// ...cornerPath built here, see above...
onDrawWithContent {
drawContent()
drawPath(path = cornerPath, color = Color.Transparent, blendMode = BlendMode.Clear)
}
},
model = "...",
contentDescription = "User profile photo",
contentScale = ContentScale.Crop,
)BlendMode.Clear apaga o onde quer que
src seja desenhado. A cor passada não importa, ela é totalmente
ignorada.
O que dst realmente significa depende de onde esse código roda:
- Sem
CompositingStrategy.Offscreen,dsté a tela real. OClearabre um buraco em tudo que já foi pintado abaixo dela no quadro inteiro. - Com
Offscreen,dsté o buffer privado dessa própria subárvore, a foto e nada mais. OClearapaga apenas pixels que a própria foto desenhou.
Passo 2: Abrindo o buraco do selo, em vez de pintar por cima
// Bottom-right corner, where the status badge sits.
val indicatorCenterOffset = Offset(
x = size.width - StatusIndicatorOuterRadius.toPx(),
y = size.height - StatusIndicatorOuterRadius.toPx()
)
// Punches a hole in the avatar so the badge isn't drawn over the photo.
val indicatorCutoutCircle = Path().apply {
addOval(Rect(center = indicatorCenterOffset, radius = StatusIndicatorOuterRadius.toPx()))
}Mesmo raciocínio dos cantos: mais um desenho Clear, no mesmo buffer
offscreen, dessa vez um círculo do tamanho do raio externo (selo mais
a lacuna).
Reutilizar o buffer importa. O que aparece através desse buraco é o que o app de verdade desenha atrás do avatar em tempo de execução, um contêiner com tema, uma linha de lista, qualquer coisa. Um círculo opaco desenhado por cima não conseguiria fazer isso, ele só mostraria a própria cor de preenchimento, fixada no momento do desenho, independentemente do que realmente está atrás.
Ordem dentro do buffer
Tanto os desenhos Clear quanto o desenho do ponto abaixo acontecem
dentro do mesmo bloco onDrawWithContent, então rodam na ordem de
chamada: foto primeiro, depois os cantos apagados, depois o buraco do
selo apagado, depois o ponto pintado de volta. Reordenar o desenho do
ponto antes do clear do buraco apagaria o ponto junto com tudo o mais.
Passo 3: Desenhando o ponto de volta no buraco
// The visible status badge, drawn inside the cutout hole.
val indicatorDotCircle = Path().apply {
addOval(Rect(center = indicatorCenterOffset, radius = StatusIndicatorInnerRadius.toPx()))
}
onDrawWithContent {
drawContent()
drawPath(path = cornerPath, color = Color.Transparent, blendMode = BlendMode.Clear)
drawPath(path = indicatorCutoutCircle, color = Color.Transparent, blendMode = BlendMode.Clear)
drawPath(path = indicatorDotCircle, color = status.color)
}O ponto usa o raio interno, menor que o buraco em que está. Essa diferença entre os dois raios é exatamente o que deixa visível o anel de fundo real entre o ponto e a borda da foto.
status.color vem de uma classe Status selada (Online, Away,
Offline). A cor do ponto é só um desenho normal, sem precisar de blend
mode, é tinta opaca pousando em um buraco já transparente.
Passo 4: Encenando a revelação com três Animatables
val avatarAnimatable = remember { Animatable(0f) }
val bigRadiusAnimatable = remember { Animatable(0f) }
val smallRadiusAnimatable = remember { Animatable(0f) }
LaunchedEffect(avatarSize) {
if (avatarSize == Size.Unspecified) return@LaunchedEffect
delay(1200.milliseconds)
// Reset so re-entering this LaunchedEffect (avatarSize changing again) replays cleanly.
avatarAnimatable.snapTo(0f)
bigRadiusAnimatable.snapTo(0f)
smallRadiusAnimatable.snapTo(0f)
avatarAnimatable.animateTo(avatarSize.minDimension / 2, animationSpec = spring())
bigRadiusAnimatable.animateTo(StatusIndicatorOuterRadius.toPx(), animationSpec = spring())
smallRadiusAnimatable.animateTo(StatusIndicatorInnerRadius.toPx(), animationSpec = spring())
}Cada um desses três raios, o próprio círculo de recorte da foto, o buraco do selo, o ponto, alimenta diretamente os mesmos caminhos construídos nos passos anteriores. Só os valores mudam, de constantes fixas para valores animados.
Sequenciar três Animatables separados chamando animateTo um após o
outro funciona porque cada chamada suspende até sua mola se estabilizar.
A próxima linha só começa a animar depois que a anterior termina.
Nenhum Transition, nenhum cálculo manual de delay entre os estágios,
apenas chamadas suspensas sequenciais simples.
Variações e compensações
XorvsDifferencepara o caminho dos cantos.innerCircleestá totalmente contido dentro defullRectaqui, entãoPathOperation.XorePathOperation.Differenceproduzem umcornerPathidêntico.Xorse lê como "o que estiver em exatamente um desses",Differencese lê como "este menos aquele", o que corresponde mais diretamente à intenção real (remover o círculo do quadrado). UseDifferencequando um caminho sempre for um subconjunto estrito do outro, e reserveXorpara os casos em que nenhum dos caminhos contém totalmente o outro.Offscreennão é gratuito. Todo avatar que usa essa técnica aloca seu próprio buffer offscreen. Tudo bem para um único cabeçalho de perfil, vale a pena verificar se isso algum dia acaba dentro de uma lista longa de avatares, onde dezenas de buffers offscreen por quadro têm um custo bem diferente de apenas um.- O anel da lacuna é só uma diferença de raio.
StatusIndicatorOuterRadiusmenosStatusIndicatorInnerRadiusé toda a lacuna. Alargar ou remover esse anel, digamos, para combinar com um design sem lacuna visível nenhuma, é uma mudança de uma linha nessas duas constantes, nada no mecanismo de clear/desenho em si muda.



