annotate_text_path — ANNOTATE paper op

• Datenarten: image2d × text → image2d

• Aufruf: import fullseye as fs; fs.ledger.annotate_text_path(img, text, path, font_size=13, color='neutral', spacing=1.0, start=0.0, draw_path=False, width=1.0, scheme='okabe_ito', font_path=None, layout=None, anchor='start', offset=0.0, upright=False, line_spacing=1.15, bold=False, italic=False) (die Implementierung direkt: import annotate; annotate.annotate_text_path(img, text, path, font_size=13, color='neutral', spacing=1.0, start=0.0, draw_path=False, width=1.0, scheme='okabe_ito', font_path=None, layout=None, anchor='start', offset=0.0, upright=False, line_spacing=1.15, bold=False, italic=False); aus dem Register: opsannotate.get("annotate_text_path"))

Verwendung

Liefert ein Bild (image2d): Text entlang eines Linienzugs (jede Glyphe zum Tangentenwinkel gedreht).

Es wird keine Textunterlage gelegt (gedacht zum Auflegen auf den Pfad). Die Anordnung sowie die Bedeutung von anchor / offset / upright (senkrechte Schrift) / Zeilenumbrüchen per \n sind

in annotate_text_path_layout beschrieben.

Wird layout übergeben, wird es unverändert verwendet -- anchor usw. werden ignoriert, also nicht beides übergeben.

bold / italic sind synthetisch (_bold_px / _italic_tile). Je 1 Zeichen wird gerendert und dann gedreht, daher wirkt die Schräge relativ zur senkrechten Achse des Zeichens (auch wenn der Pfad schräg ist, wird die Kursive nicht in Pfadrichtung verzerrt).

Raises

ValueError

Wie annotate_text_path_layout + ein gedrehtes Zeichen ragt aus dem Bild.

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie figure_annotation

Hintergrundwissen (Physik und Konventionen hinter diesem Operator)

• dataset_conventions — Konventionen für Trainingsdatensätze — COCO / YOLO / VOC und Fallstricke in der Sichtprüfung

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• annotate_paper_tour — py -3.11 examples/annotate_paper_tour.py

• paper_figure — py -3.11 examples/paper_figure.py

Typkompatible Folge-Operatoren (nehmen image2d als Eingabe)

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

Gleiche Kategorie (paper)

annotate_leader_layout · annotate_leader · annotate_markers · annotate_legend · annotate_dimension_layout · annotate_dimension · annotate_angle_layout · annotate_angle


*Provenance: annotate.py — ANNOTATE Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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