annotate_invert_path — ANNOTATE overlay op

Data kinds: image2d × pairsimage2d

Call: 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') (to call the implementation directly, 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'); from the registry, opsannotate.get("annotate_invert_path"))

Usage

> This operator's description has not been translated yet. The original text follows as it is.

折れ線(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

Detailed usage guide

figure_annotation family guide

Background guides (the physics and conventions behind this op)

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

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

• The canonical algorithm (author, year) and its uses are named in the family usage guide above.

Runnable examples (verified samples that actually call this op)

annotate_paper_tourpy -3.11 examples/annotate_paper_tour.py

Ops the type connects to (they accept image2d as input)

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

Same category (overlay)

overlay_mask · overlay_labels · annotate_invert_visibility · annotate_invert


*Provenance: annotate.py — ANNOTATE operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

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