legend_box — ANNOTATE furniture op

• 資料種類:image2d × entries → image2d

• 呼叫: import fullseye as fs; fs.ledger.legend_box(img, entries, xy, anchor='lt', swatch=14, row_gap=4, pad=8, font_size=13, box_color=None, box_alpha=0.72, markers=False, scheme='okabe_ito', font_path=None, min_font_size=9, style=None, border=1, border_color='neutral')(要直接呼叫實作,import annotate; annotate.legend_box(img, entries, xy, anchor='lt', swatch=14, row_gap=4, pad=8, font_size=13, box_color=None, box_alpha=0.72, markers=False, scheme='okabe_ito', font_path=None, min_font_size=9, style=None, border=1, border_color='neutral');從台帳取用則 opsannotate.get("legend_box"))

用法

顏色 × 說明的圖例。框高由條目數以閉合式確定。

height = 2*pad + n*row_h + (n-1)*row_gap (row_h = max(swatch, 文字高度))。

Parameters

entries : sequence

(color, text) 的序列。color 可以是角色名稱也可以是 RGB。

markers : bool

True 時在說明前加上與角色名稱對應的 palette.ROLE_MARKERS 符號

(為了不只用顏色承載含義)。不是角色名稱的

元素沒有符號,所以不加。

Returns

ndarray

Raises

ValueError

entries 為空 / 形式不是 (color, text) / 框超出影像 /

未知的角色名稱。

詳細使用指南

• figure_annotation 族使用指南

背景知識指南(該運算子背後的物理與規範)

• 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_driving_decisions — py -3.11 examples/poc_driving_decisions.py

• poc_measurement_system_analysis — py -3.11 examples/poc_measurement_system_analysis.py

• poc_pxrd_phase_peel — py -3.11 examples/poc_pxrd_phase_peel.py

型別可銜接的下一個運算子(可接受 image2d 作為輸入)

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

同類別(furniture)

color_bar · scale_bar


*Provenance: annotate.py — ANNOTATE 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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