Recomposed
Draw

Draw: O Indicador de Status do Perfil de Usuário do Discord

Oct 15, 2026 · 5 min read

Draw: O Indicador de Status do Perfil de Usuário do Discord

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 Zinc800 aqui, 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.

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. O Clear abre 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. O Clear apaga 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

FIG. 01
Três Animatables, acionados em sequência: o círculo da foto cresce primeiro, depois o anel do selo, depois o ponto.
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

  • Xor vs Difference para o caminho dos cantos. innerCircle está totalmente contido dentro de fullRect aqui, então PathOperation.Xor e PathOperation.Difference produzem um cornerPath idêntico. Xor se lê como "o que estiver em exatamente um desses", Difference se lê como "este menos aquele", o que corresponde mais diretamente à intenção real (remover o círculo do quadrado). Use Difference quando um caminho sempre for um subconjunto estrito do outro, e reserve Xor para os casos em que nenhum dos caminhos contém totalmente o outro.
  • Offscreen nã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. StatusIndicatorOuterRadius menos StatusIndicatorInnerRadius é 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.
Keep reading

Related reads

Receba novos posts no seu e-mail