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
Zinc800ici, 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.
- →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.
É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,dstcorrespond à l'écran réel.Clearperce un trou à travers tout ce qui a déjà été peint en dessous dans l'image entière. - Avec
Offscreen,dstest le tampon privé propre à cette sous-arborescence, la photo et rien d'autre.Clearn'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
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
XorvsDifferencepour le chemin des coins.innerCircleest entièrement contenu dansfullRectici, doncPathOperation.XoretPathOperation.Differenceproduisent uncornerPathidentique.Xorse lit comme « ce qui se trouve dans exactement l'un de ces deux chemins »,Differencese lit comme « ceci moins cela », ce qui correspond plus directement à l'intention réelle (retirer le cercle du carré). PrivilégiezDifferencelorsqu'un chemin est toujours censé être un sous-ensemble strict de l'autre, et réservezXoraux cas où aucun des deux chemins ne contient entièrement l'autre.Offscreenn'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.
StatusIndicatorOuterRadiusmoinsStatusIndicatorInnerRadiusconstitue 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.



