blend_mode — GFX2D composite op

Datenarten: rgb × rgbrgb

Aufruf: import gfx2d; gfx2d.blend_mode(base, top, mode='normal', opacity=1.0) (oder opsgfx2d.get("blend_mode"))

Verwendung

Mischt zwei undurchsichtige `rgb`-Bilder mit einem benannten Modus (W3C Level 1).

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

With an opaque backdrop the specification reduces to a lerp,

`Co = (1 - opacity)*Cb + opacity*B(Cb, Cs), so opacity=0` returns the

backdrop exactly and `mode="normal", opacity=1` returns the source

exactly. Both identities are checked bit-for-bit in the test suite.

Named `blend_mode and not blend because :func:imagemorph.blend`

already owns that name for a two-image cross-fade; two functions called

`blend` with different signatures is exactly the kind of collision this

library's naming test exists to prevent.

Raises ValueError: unknown mode, mismatched shapes, opacity outside

`[0, 1], values outside [0, 1]`.

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

gfx2d_scenepy -3.11 examples/gfx2d_scene.py

Typkompatible Folge-Operatoren (nehmen rgb als Eingabe)

srgb_to_linear · linear_to_srgb · light_mask · normal_map_decode · bloom · vignette · chromatic_aberration · film_grain

Gleiche Kategorie (composite)

premultiply · unpremultiply · alpha_composite · alpha_composite_premul · layer_stack


*Provenance: gfx2d.py — GFX2D Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.