measure_text — ANNOTATE `text` op

• 数据种类:text → table

• 调用: import fullseye as fs; fs.ledger.measure_text(text, font_size=14, font_path=None, max_width=None, min_font_size=9, line_spacing=1.15, wrap=True, bold=False, italic=False)(要直接调用实现,import annotate; annotate.measure_text(text, font_size=14, font_path=None, max_width=None, min_font_size=9, line_spacing=1.15, wrap=True, bold=False, italic=False);从台账取用则 opsannotate.get("measure_text"))

用法

在画之前先测量文字。放不下就折行或缩小,再不行就抛异常。

Parameters

text : str

要测量的字符串(用 \n 换行)。

font_size : int

期望的字号。若放不进 max_width,则每次缩小 1pt。

font_path : str or None

显式指定后,跨机器也能得到相同结果。None 时按固定顺序

搜索 FONT_CANDIDATES。

max_width : int or None

想要放入的宽度[px]。None 时既不缩小也不折行。

min_font_size : int

缩到这里仍放不进则 ValueError(不会悄悄截断)。

line_spacing : float

行距系数。

bold, italic : bool or int

合成的粗体、斜体(_bold_px / _italic_tile)。并非真正的

Bold / Italic 字体,所以字形不同 —— 需要真正的字体时,

请把该字体的文件传给 font_path。给 bold 传整数,

可直接指定叠印次数。粗细和倾斜所增加的部分计入 width,

因此底板和表格的栏宽会相应变宽(叠印只在横向变粗,所以

height 不变)。

wrap : bool

True(默认)时在 max_width 处折行。False 时不折行,

而是不增加行数、缩小字体来放入(用于像网格标签那样,变成 2 行

就会破坏版面的地方 —— 与 exhibit_tile._fit_label 同样的做法)。

无论哪种,缩到 min_font_size 仍放不进就抛出异常。

\n 换行与 max_width 有无、wrap 取值如何无关,始终生效

(不会发生“不给宽度就压成 1 行”的事故)。

Returns

dict

{"lines", "font", "font_size", "width", "height", "line_height"}。

width/height 为实测值[px]。

Raises

ValueError

max_width 非正 / 缩到 min_font_size 仍放不进 1 行。

详细使用指南

• 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

• annotate_paper_tour — py -3.11 examples/annotate_paper_tour.py

• poc_diabolo_model_and_vision — py -3.11 examples/poc_diabolo_model_and_vision.py

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

—

同类别(`text`)

text_box

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

measure_text — ANNOTATE text op

用法