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와 외관 검사의 함정

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL 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 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

measure_text — ANNOTATE text op

사용법