L'intuition
CompositingStrategy.Offscreen donne l'impression de construire une clôture
autour de votre mode de fusion, un mur qui empêche son effet de déborder sur
les pixels situés hors de votre composant.
- C'est le bon effet, mais le mauvais mécanisme, et ce mauvais mécanisme s'effondre dès qu'on pose une question plus précise : que lit vraiment le mode de fusion en tant que , et pas seulement ce qu'il affecte ?
BlendModeest la formule :out = f(src, dst).Multiply,Clear,DstOutne sont que desfdifférents.CompositingStrategydécide ce qu'estdst: le véritable écran déjà peint, ou une mémoire tampon neuve, privée et transparente dans laquelle seule votre sous-arborescence a dessiné.
Sans isolation, vos appels de dessin se fusionnent avec tout ce qui se trouve
déjà sur la véritable surface d'écran, l'arrière-plan, les frères et sœurs
peints plus tôt, tout cela. Avec Offscreen, ils se fusionnent avec une
mémoire tampon qui démarre entièrement vide, si bien qu'il n'y a rien
« d'extérieur » que la fusion puisse lire ou toucher, puisque cette mémoire
tampon ne contient que ce que votre sous-arborescence a dessiné.
Ainsi, l'isolation ne restreint pas la portée d'une opération après coup,
elle lui fournit d'emblée un substrat différent sur lequel s'exécuter. Peindre
sans Offscreen, c'est peindre directement sur la photo. Peindre avec, c'est
peindre sur une feuille de film transparent : la fusion ne se produit jamais
qu'entre films, et ce n'est qu'une fois terminé que vous posez le film fini
sur la photo.
- →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.
Référence : modes de fusion courants et leurs formules
BlendMode comporte bien plus de valeurs qu'un seul article n'en nécessite,
mais voici celles que vous utiliserez réellement. src est le pixel que vous
dessinez, dst est ce qui est déjà présent, srcA/dstA sont leurs alphas
respectifs :
| Mode de fusion | Formule | Ce qu'il fait |
|---|---|---|
Clear | out = 0 | Efface dst partout où src est dessiné, en ignorant totalement la couleur propre de src. |
Src | out = src | Remplace entièrement dst, comme s'il n'y avait rien eu avant. |
Dst | out = dst | Ne fait rien : conserve ce qui était déjà là, écarte src. |
SrcOver (le défaut) | out = src + dst·(1-srcA) | Peinture ordinaire : src au-dessus, dst transparaissant partout où src est transparent. |
DstOver | out = dst + src·(1-dstA) | Identique à SrcOver avec les rôles inversés : dst se peint au-dessus de src. |
SrcIn | out = src·dstA | Conserve src uniquement là où dst contenait déjà quelque chose, en utilisant la forme de dst comme masque. |
DstIn | out = dst·srcA | Conserve dst uniquement là où src contient quelque chose, « découpe dst à la forme de src ». |
SrcOut | out = src·(1-dstA) | Conserve src uniquement là où dst était vide, l'inverse de SrcIn. |
DstOut | out = dst·(1-srcA) | Efface dst partout où src est dessiné, « soustrait la forme de src à dst », le mode du texte en négatif. |
SrcAtop | out = src·dstA + dst·(1-srcA) | src n'apparaît qu'à l'intérieur de la forme existante de dst ; dst transparaît ailleurs. |
DstAtop | out = dst·srcA + src·(1-dstA) | dst n'apparaît qu'à l'intérieur de la forme de src ; src transparaît ailleurs. |
Xor | out = src·(1-dstA) + dst·(1-srcA) | Conserve celui de src/dst qui est présent, jamais les deux ; le chevauchement disparaît. |
Plus | out = src + dst (plafonné) | Additif : les couleurs s'accumulent et s'éclaircissent, le mode derrière les effets de lueur et d'empilement de lumière. |
Multiply | out = src · dst | Assombrit : le résultat n'est jamais plus clair qu'aucune des deux entrées, comme empiler deux filtres de couleur translucides. |
Screen | out = src + dst - src·dst | Éclaircit : l'inverse de Multiply, le résultat n'est jamais plus sombre qu'aucune des deux entrées. |
Darken | out = min(src, dst) | Conserve la valeur la plus sombre, canal par canal. |
Lighten | out = max(src, dst) | Conserve la valeur la plus claire, canal par canal. |
Difference | out = |src - dst| | Différence absolue par canal, utilisée pour les effets de contraste ou d'inversion. |
Overlay | Multiply ou Screen, choisi pixel par pixel selon la valeur de dst | Assombrit les zones sombres et éclaircit les zones claires de dst en une seule passe ; combine contraste et teinte. |
Tout cela relève de l'axe de la formule. Rien ici ne dit si dst est le
véritable écran ou une mémoire tampon privée, c'est l'autre axe, et c'est le
sujet du reste de cet article.
Le web a un équivalent quasi exact : globalCompositeOperation du Canvas 2D
reprend presque littéralement cette même table (source-over, source-in,
destination-out, multiply, screen, ...). Choisissez un mode ci-dessous
et observez à la fois l'appel Compose et la formule se dérouler sur deux
formes qui se chevauchent :
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.
Le bug que Auto corrige discrètement pour vous
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))
}Deux enfants semi-transparents qui se chevauchent, avec le
compositingStrategy = Auto par défaut. Compose détecte le chevauchement et
promeut silencieusement ce groupe vers Offscreen pour vous, et voici
pourquoi c'est nécessaire :
- Sans isolation, chaque enfant se fusionne individuellement avec le véritable arrière-plan, si bien que la zone de chevauchement est touchée deux fois : une première fois par rouge-sur-arrière-plan, puis à nouveau par bleu-sur-(rouge-sur-arrière-plan). La jointure est visiblement plus sombre que « dessiner les deux entièrement, puis atténuer le résultat une seule fois ».
- Avec isolation, les deux boîtes se dessinent d'abord entièrement
opaques dans leur propre mémoire tampon vide, elles se composent donc
correctement l'une avec l'autre, et ce n'est qu'ensuite que l'alpha de
0.5fdu groupe est appliqué une seule fois, sur le résultat final aplati.
Auto vous rend ici service, en détectant le chevauchement et en recourant
à l'isolation à votre place. Basculez l'isolation entre activée et désactivée
ci-dessous, sur ces deux mêmes boîtes qui se chevauchent, pour voir la
jointure apparaître et disparaître :
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.
Le cas suivant est celui où Auto ne peut rien faire du tout.
Là où l'isolation n'est pas optionnelle : les modes de fusion qui effacent
Modifier.graphicsLayer {
compositingStrategy = CompositingStrategy.Offscreen // required, not optional
}.drawWithContent {
drawContent()
drawCircle(Color.Black, radius = 60.dp.toPx(), blendMode = BlendMode.Clear)
}BlendMode.Clear signifie « effacer dst ici ». Mais quel dst, cela
dépend entièrement du fait que l'isolation ait eu lieu avant ou non :
- Sans
Offscreen,dstest le véritable écran, donc ceci perce un trou à travers tout ce qui a déjà été dessiné en dessous dans l'image entière, les autres éléments d'UI, l'arrière-plan de la fenêtre, tout. - Avec
Offscreen,dstest la mémoire tampon privée de cette couche.Clearn'efface que les pixels que cette sous-arborescence a déjà dessinés, et la mémoire tampon ainsi perforée se compose ensuite normalement avec le véritable écran. C'est la technique classique du spot lumineux / badge découpé, et c'est aussi pourquoi le texte en négatif (un trou en forme de texte percé dans une photo, viaDstOut) nécessite la même configuration : isoler d'abord la photo et le texte en tant que groupe, puis percer le trou dans la mémoire tampon propre au groupe.
Le fondamental
Mécaniquement, l'isolation correspond au saveLayer de Skia (et de
tout moteur de rendu 2D) : empiler une nouvelle mémoire tampon hors
écran, y dessiner, puis la dépiler en composant l'intégralité de la
mémoire tampon sur ce qui s'y trouvait déjà avec une seule opération de
peinture, alpha, mode de fusion ou filtre appliqué exactement une fois.
CompositingStrategy.Offscreen est graphicsLayer qui demande
exactement cela. Auto exécute le même mécanisme, mais seulement
lorsque quelque chose, un alpha de groupe sur des enfants qui se
chevauchent, un mode de fusion non par défaut, certains RenderEffect,
en a réellement besoin.
Ailleurs : même fondamental, framework différent
- CSS :
isolation: isolateouvre un nouveau contexte d'empilement, si bien quemix-blend-modesur les éléments à l'intérieur cesse d'atteindre les éléments extérieurs. - SwiftUI :
.compositingGroup()aplatit une sous-arborescence en une seule couche avant que tout.blendMode()ou.opacity()au-dessus ne soit appliqué. - Skia, le moteur de rendu sur lequel repose Compose :
canvas->saveLayer()/restore()est la primitive littérale vers laquelle les deux éléments ci-dessus se compilent. - Flutter : les widgets
Opacity/ColorFilteredreçoivent une couche hors écran implicite dès que leur enfant n'est pas une seule primitive opaque. - Photoshop : un groupe de calques avec le mode « transparent »
désactivé constitue l'interrupteur d'isolation. Le mode « transparent »
(le défaut) laisse les modes de fusion déborder vers les calques
inférieurs ; le désactiver isole d'abord le groupe, l'exact équivalent
Photoshop d'
Offscreen. - Canvas 2D : aucune primitive d'isolation intégrée, chaque appel de
dessin se compose directement sur l'unique bitmap visible. Simuler
saveLayerà la main revient à créer un second<canvas>en mémoire, à y dessiner, puis à appliquerdrawImage()du résultat final sur le canvas visible avec l'alpha du groupe, exactement ce que fait la démo de bascule ci-dessus en coulisses.
Cas particulier : quand ModulateAlpha se trompe de pari
CompositingStrategy.ModulateAlpha est une optimisation plus étroite
qu'Offscreen : au lieu d'allouer une mémoire tampon, elle multiplie
l'alpha du groupe dans l'alpha propre de chaque enfant au moment du
dessin, en évitant entièrement l'isolation. Cela donne le même résultat
visuel qu'Offscreen, mais uniquement lorsque les enfants ne se
chevauchent véritablement pas.
N'y recourez qu'après qu'un profilage ait montré que la mémoire tampon
supplémentaire et la passe de composition supplémentaire d'Offscreen
vous coûtent réellement quelque chose, pas avant. Si un changement
ultérieur ajoute un enfant qui chevauche un autre, aucune détection ne
vient l'intercepter comme le fait Auto pour le cas de chevauchement,
ModulateAlpha se contente de fusionner silencieusement deux fois la
zone de chevauchement, reproduisant exactement la jointure du premier
exemple, sauf que cette fois rien ne la repromeut vers Offscreen pour
vous. C'est une optimisation que l'on choisit une fois l'hypothèse
d'absence de chevauchement confirmée, pas un comportement par défaut sur
lequel se replier.
Le modèle mental à retenir
BlendMode décide de la formule ; CompositingStrategy décide de ce
qu'est dst, l'isolation ne clôture pas cette formule, elle lui fournit
une toile vierge sur laquelle se fusionner au lieu du véritable écran.



