shape op• 資料種類:image2d → image2d
• 呼叫: import fullseye as fs; fs.ledger.rounded_rect(img, rect, radius=8, color='neutral', width=2, fill=False, alpha=1.0, scheme='okabe_ito')(要直接呼叫實作,import annotate; annotate.rounded_rect(img, rect, radius=8, color='neutral', width=2, fill=False, alpha=1.0, scheme='okabe_ito');從台帳取用則 opsannotate.get("rounded_rect"))
圓角矩形(`fill=True` 時填充)。用作襯底或外框。
> 以下的詳細說明為原文 —— 摘要與標題已翻譯。
Raises
------
ValueError
矩形が画像の外、radius が負か辺の半分を超える、alpha が [0,1] の外。
描画: 画素中心から「角を丸めた矩形」までの距離で内側判定し、`fill=False`
なら外周から `max(1, width)` px 幅の帯だけを載せる(距離判定の 1 段階、
アンチエイリアスは無し)。合成は `out = m*color + (1-m)*img に alpha` を
掛けたもの。
• `img: (H, W) / (H, W, 1|3|4)。float64 に変換し [0, 1]` にクリップした
複製を返す(入力は変えない)。NaN/Inf は `ValueError`。
• `rect: (x, y, w, h)、x = 列・y = 行。丸めて整数化し、w, h > 0`、
画像内に完全に収まること(はみ出しは切り詰めず `ValueError`)。
占める画素は `x .. x+w-1、y .. y+h-1`。
• `radius: 角の半径 [px]、0 <= radius <= min(w, h)/2`。0 で普通の矩形。
• `color: palette の役割名("neutral" 等、scheme` で解決)か
`[0, 1]` の RGB。グレー画像には RGB の平均を使う。
• 返り値: 入力と同形の float64。
`text_box の下敷きや annotate_legend` の囲みと同じ見た目を手で組むときに。
• dataset_conventions — 学習データセット規約の知識 — COCO / YOLO / VOC と外観検査での落とし穴
• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。
• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。
• 演算法的正典(作者・年份)與用途見上面的族使用指南。
• annotate_gallery — py -3.11 examples/annotate_gallery.py
• poc_machine_condition_fusion — py -3.11 examples/poc_machine_condition_fusion.py
image2d 作為輸入)text_box · arrow · leader_line · label_points · crosshair · legend_box · color_bar · scale_bar
shape)filled_polygon · arc · ellipse
*Provenance: annotate.py — ANNOTATE 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.