annotate_invert_path — ANNOTATE overlay op

Datenarten: image2d × pairsimage2d

Aufruf: import fullseye as fs; fs.ledger.annotate_invert_path(img, points, width=1.5, closed=False, dash=None, mode='complement', alpha=1.0, bits=128, min_contrast=1.5, on_invisible='warn') (die Implementierung direkt: import annotate; annotate.annotate_invert_path(img, points, width=1.5, closed=False, dash=None, mode='complement', alpha=1.0, bits=128, min_contrast=1.5, on_invisible='warn'); aus dem Register: opsannotate.get("annotate_invert_path"))

Verwendung

> Für diesen Operator gibt es noch keine Übersetzung. Es folgt der Originaltext unverändert.

折れ線(line)を反転色で描く。アンチエイリアスつき。

線は領域より不利で、そこがこの op を分けている理由 —— 太さ 1.5 画素の

線は端の画素の被覆率が 0.3 程度しかないため、**反転しても被覆の分しか

動かない**。中間調の地では領域よりさらに先に消える。判定は「被覆率

0.5 以上の画素」で行う(それ未満は元から半透明なので、見えなくても

それは反転のせいではない)。

Parameters

----------

points : (N,2)

折れ線の頂点 `(x, y)`(画素座標)。

width : float

線の太さ(画素、0.5 以上)。

closed : bool

真なら最後の点と最初の点を結ぶ。

dash : (on, off) or None

破線の刻み(画素)。:func:_dash_pieces と同じ規則。

mode, alpha, min_contrast, on_invisible :

:func:annotate_invert と同じ。

Returns

-------

(H,W[,C]) float64

反転を乗せた複製。

Examples

--------

>>> import numpy as np, annotate

>>> img = np.zeros((16, 32))

>>> out = annotate.annotate_invert_path(img, [(2, 8), (29, 8)], width=3)

>>> float(out[8, 15]) # 黒地の上なので白い線になる

1.0

>>> float(out[2, 15]) # 線から離れたところは元のまま

0.0

Ausführlicher Anwendungsleitfaden

Leitfaden zur Familie figure_annotation

Hintergrundwissen (Physik und Konventionen hinter diesem Operator)

dataset_conventions — 学習データセット規約の知識 — COCO / YOLO / VOC と外観検査での落とし穴

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_paper_tourpy -3.11 examples/annotate_paper_tour.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_mask · overlay_labels · annotate_invert_visibility · annotate_invert


*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.