annotate_invert_path — ANNOTATE `overlay` op

• 数据种类:image2d × pairs → image2d

• 调用: 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')(要直接调用实现,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');从台账取用则 opsannotate.get("annotate_invert_path"))

用法

用反色绘制折线(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

虚线的步长(像素)。与 _dash_pieces 规则相同。

mode, alpha, min_contrast, on_invisible :

与 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

详细使用指南

• figure_annotation 族使用指南

背景知识指南(该算子背后的物理与约定)

• dataset_conventions — 训练数据集规范知识 —— COCO / YOLO / VOC 及外观检测中的陷阱

参考(示例数据、文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

• 算法的正典(作者、年份)与用途见上面的族使用指南。

可运行的示例(实际调用该算子并已验证的样例)

• annotate_paper_tour — py -3.11 examples/annotate_paper_tour.py

类型可衔接的下一个算子(可接受 `image2d` 作为输入)

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

同类别(`overlay`)

overlay_mask · overlay_labels · annotate_invert_visibility · annotate_invert

*Provenance: annotate.py — ANNOTATE 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

annotate_invert_path — ANNOTATE overlay op

用法