Recomposed
Draw

Draw : L'indicateur de statut de profil utilisateur de Discord

Oct 15, 2026 · 6 min read

Draw : L'indicateur de statut de profil utilisateur de Discord

Ce que nous allons construire

Une photo de profil circulaire avec un point coloré dans le coin. Assez simple à imiter avec Modifier.clip(CircleShape) et une Box superposée par-dessus. La partie que cette imitation ne peut pas atteindre, c'est le fin anneau d'arrière-plan visible autour du point, entre celui-ci et le bord de la photo, car cet anneau doit montrer ce qui se trouve réellement derrière l'avatar, pas une couleur codée en dur.

Code source complet : DiscordAvatarScreen.kt.

L'intuition

  • Arrondir la photo et la badger avec un point de statut sont habituellement traités comme deux problèmes distincts : l'un relève du clipping, l'autre consiste à « dessiner un cercle par-dessus ». Il s'agit en réalité de la même opération appliquée deux fois : effacer des pixels de la photo, pas les peindre par-dessus.
  • Un cercle plein dessiné par-dessus la photo la masquerait, certes, mais uniquement avec la couleur plate propre au cercle. L'espace autour du point de Discord n'est pas une couleur, c'est un trou, laissant transparaître sans altération l'arrière-plan réel de la carte (une boîte Zinc800 ici, n'importe quoi dans l'application réelle).
  • Obtenir un trou plutôt qu'une zone colorée implique que l'arrondissement des coins et le découpage du badge passent tous deux par le même mécanisme : effacer, composer correctement, puis repeindre le point dans le trou.

Étape 1 : Arrondir la photo sans 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) arrondirait la photo en une seule ligne, et c'est normalement le bon choix. Ce n'est pas faux ici non plus, c'est juste incomplet : le clipping ne gère que les coins.

Le trou du badge a quand même besoin de son propre BlendMode.Clear à l'intérieur d'une couche Offscreen, quelle que soit la façon dont les coins sont arrondis. Le pochoir de la pile de canvas d'un clip n'a aucun moyen de révéler ce qui se trouve réellement derrière l'avatar, seul Clear le peut.

Construire cornerPath comme une forme explicite permet à une seule couche Offscreen et à une série d'appels Clear de gérer les deux exclusions, coins et badge. L'alternative, associer clip() pour les coins à une seconde passe offscreen pour le badge, met en place deux fois la même mécanique offscreen.

PathOperation.Xor conserve ce qui se trouve dans exactement l'un des deux chemins. Puisque innerCircle se trouve entièrement à l'intérieur de fullRect, il ne reste que les quatre coins, le carré moins le cercle.

Il s'agit d'une opération booléenne sur des chemins, combinant deux formes en une nouvelle. Ce n'est pas la formule de pixels BlendMode.Xor de l'article sur les fondamentaux ci-dessus, même nom, mais niveau d'API différent.

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 efface partout où src est dessiné. La couleur passée en paramètre n'a aucune importance, elle est totalement ignorée.

Ce que dst désigne réellement dépend de l'endroit où ce code s'exécute :

  • Sans CompositingStrategy.Offscreen, dst correspond à l'écran réel. Clear perce un trou à travers tout ce qui a déjà été peint en dessous dans l'image entière.
  • Avec Offscreen, dst est le tampon privé propre à cette sous-arborescence, la photo et rien d'autre. Clear n'efface que les pixels que la photo elle-même a dessinés.

Étape 2 : Percer le trou du badge, pas le peindre par-dessus

// 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()))
}

Même raisonnement que pour les coins : un Clear de dessin supplémentaire, dans le même tampon offscreen, cette fois un cercle dimensionné au rayon extérieur (badge plus espace).

Réutiliser le tampon est important. Ce qui transparaît par ce trou correspond à ce que l'application réelle dessine derrière l'avatar à l'exécution, un conteneur thématisé, une ligne de liste, n'importe quoi. Un cercle opaque dessiné par-dessus ne pourrait pas faire cela, il ne montrerait jamais que sa propre couleur de remplissage, figée au moment du dessin, indépendamment de ce qui se trouve réellement derrière.

Ordre à l'intérieur du tampon

Les deux dessins Clear et le dessin du point ci-dessous se produisent tous à l'intérieur du même bloc onDrawWithContent, donc ils s'exécutent dans l'ordre des appels : la photo d'abord, puis les coins effacés, puis le trou du badge effacé, puis le point repeint. Réordonner le dessin du point avant l'effacement du trou effacerait le point avec tout le reste.

Étape 3 : Redessiner le point dans le trou

// 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)
}

Le point utilise le rayon intérieur, plus petit que le trou dans lequel il se trouve. Cet écart entre les deux rayons est exactement ce qui laisse apparaître l'anneau visible d'arrière-plan réel entre le point et le bord de la photo.

status.color provient d'une classe scellée Status (Online, Away, Offline). La couleur du point n'est qu'un dessin normal, sans mode de fusion nécessaire, c'est simplement une peinture opaque qui atterrit sur un trou déjà transparent.

Étape 4 : Orchestrer la révélation avec trois Animatable

FIG. 01
Trois Animatables, enchaînés en séquence : le cercle de la photo apparaît d'abord, puis l'anneau du badge, puis le point.
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())
}

Chacun de ces trois rayons, le propre cercle de clipping de la photo, le trou du badge, le point, alimente directement les mêmes chemins construits dans les étapes précédentes. Seules les valeurs changent, passant de constantes fixes à des valeurs animées.

Enchaîner trois Animatable distincts en appelant animateTo l'un après l'autre fonctionne parce que chaque appel suspend l'exécution jusqu'à ce que son ressort se stabilise. La ligne suivante ne commence à s'animer qu'une fois la précédente terminée. Pas de Transition, pas de calcul manuel de délai entre les étapes, juste de simples appels suspendus séquentiels.

Variantes et compromis

  • Xor vs Difference pour le chemin des coins. innerCircle est entièrement contenu dans fullRect ici, donc PathOperation.Xor et PathOperation.Difference produisent un cornerPath identique. Xor se lit comme « ce qui se trouve dans exactement l'un de ces deux chemins », Difference se lit comme « ceci moins cela », ce qui correspond plus directement à l'intention réelle (retirer le cercle du carré). Privilégiez Difference lorsqu'un chemin est toujours censé être un sous-ensemble strict de l'autre, et réservez Xor aux cas où aucun des deux chemins ne contient entièrement l'autre.
  • Offscreen n'est pas gratuit. Chaque avatar utilisant cette technique alloue son propre tampon offscreen. Acceptable pour un simple en-tête de profil, mais à vérifier si cela finit par se retrouver dans une longue liste d'avatars, où des dizaines de tampons offscreen par image représentent un profil de coût différent de celui d'un seul.
  • L'anneau d'espacement n'est qu'une différence de rayons. StatusIndicatorOuterRadius moins StatusIndicatorInnerRadius constitue tout l'espace. Élargir ou supprimer cet anneau, par exemple pour correspondre à un design sans aucun espace visible, est un changement d'une seule ligne sur ces deux constantes, rien dans le mécanisme d'effacement/dessin lui-même ne change.
Keep reading

Related reads

Recevez les nouveaux articles par e-mail