overlay_mask — ANNOTATE overlay op

• Datenarten: image2d × mask → image2d

• Aufruf: import fullseye as fs; fs.ledger.overlay_mask(img, mask, color='wrong', alpha=0.45, outline=0, outline_color=None, scheme='okabe_ito', style=None) (die Implementierung direkt: import annotate; annotate.overlay_mask(img, mask, color='wrong', alpha=0.45, outline=0, outline_color=None, scheme='okabe_ito', style=None); aus dem Register: opsannotate.get("overlay_mask"))

Verwendung

Überlagert eine Binärmaske mit Alpha. Exakt a*f + (1-a)*b.

Parameters

mask : (H,W)

Boolesche Werte in Bildgröße (oder Gewichte in [0,1]).

Abweichende Form ist eine Exception -- eine Verwechslung von (row,col) und (x,y) stirbt hier.

alpha : float

Gewicht der Maskenseite.

outline : int

Ist er größer als 0, wird die Kontur der Maske mit Stärke outline gezeichnet.

Raises

ValueError

Formen ungleich / alpha außerhalb von [0,1] / nicht endliche Werte in mask.

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie figure_annotation

Hintergrundwissen (Physik und Konventionen hinter diesem Operator)

• dataset_conventions — Konventionen für Trainingsdatensätze — COCO / YOLO / VOC und Fallstricke in der Sichtprüfung

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)

• annotate_gallery — py -3.11 examples/annotate_gallery.py

• poc_kendama — py -3.11 examples/poc_kendama.py

• poc_pv_thermal_survey — py -3.11 examples/poc_pv_thermal_survey.py

Typkompatible Folge-Operatoren (nehmen image2d als Eingabe)

text_box · arrow · leader_line · label_points · crosshair · legend_box · color_bar · scale_bar

Gleiche Kategorie (overlay)

overlay_labels · annotate_invert_visibility · annotate_invert · annotate_invert_path


*Provenance: annotate.py — ANNOTATE 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.