Recomposed
Draw

BlendMode vs CompositingStrategy : ce n'est pas une clôture, c'est une toile différente

Oct 11, 2026 · 7 min read

BlendMode vs CompositingStrategy : ce n'est pas une clôture, c'est une toile différente

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 ?
  • BlendMode est la formule : out = f(src, dst). Multiply, Clear, DstOut ne sont que des f différents.
  • CompositingStrategy décide ce qu'est dst : 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.

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 fusionFormuleCe qu'il fait
Clearout = 0Efface dst partout où src est dessiné, en ignorant totalement la couleur propre de src.
Srcout = srcRemplace entièrement dst, comme s'il n'y avait rien eu avant.
Dstout = dstNe 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.
DstOverout = dst + src·(1-dstA)Identique à SrcOver avec les rôles inversés : dst se peint au-dessus de src.
SrcInout = src·dstAConserve src uniquement là où dst contenait déjà quelque chose, en utilisant la forme de dst comme masque.
DstInout = dst·srcAConserve dst uniquement là où src contient quelque chose, « découpe dst à la forme de src ».
SrcOutout = src·(1-dstA)Conserve src uniquement là où dst était vide, l'inverse de SrcIn.
DstOutout = dst·(1-srcA)Efface dst partout où src est dessiné, « soustrait la forme de src à dst », le mode du texte en négatif.
SrcAtopout = src·dstA + dst·(1-srcA)src n'apparaît qu'à l'intérieur de la forme existante de dst ; dst transparaît ailleurs.
DstAtopout = dst·srcA + src·(1-dstA)dst n'apparaît qu'à l'intérieur de la forme de src ; src transparaît ailleurs.
Xorout = src·(1-dstA) + dst·(1-srcA)Conserve celui de src/dst qui est présent, jamais les deux ; le chevauchement disparaît.
Plusout = 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.
Multiplyout = src · dstAssombrit : le résultat n'est jamais plus clair qu'aucune des deux entrées, comme empiler deux filtres de couleur translucides.
Screenout = src + dst - src·dstÉclaircit : l'inverse de Multiply, le résultat n'est jamais plus sombre qu'aucune des deux entrées.
Darkenout = min(src, dst)Conserve la valeur la plus sombre, canal par canal.
Lightenout = max(src, dst)Conserve la valeur la plus claire, canal par canal.
Differenceout = |src - dst|Différence absolue par canal, utilisée pour les effets de contraste ou d'inversion.
OverlayMultiply ou Screen, choisi pixel par pixel selon la valeur de dstAssombrit 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.5f du 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, dst est 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, dst est la mémoire tampon privée de cette couche. Clear n'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, via DstOut) 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: isolate ouvre un nouveau contexte d'empilement, si bien que mix-blend-mode sur 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/ColorFiltered reç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 à appliquer drawImage() 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.

Keep reading

Related reads

Recevez les nouveaux articles par e-mail