rounded_rect — ANNOTATE shape op

• Datenarten: image2d → image2d

• Aufruf: import fullseye as fs; fs.ledger.rounded_rect(img, rect, radius=8, color='neutral', width=2, fill=False, alpha=1.0, scheme='okabe_ito') (die Implementierung direkt: import annotate; annotate.rounded_rect(img, rect, radius=8, color='neutral', width=2, fill=False, alpha=1.0, scheme='okabe_ito'); aus dem Register: opsannotate.get("rounded_rect"))

Verwendung

Ein abgerundetes Rechteck (mit fill=True gefüllt). Für Hinterlegungen und Umrandungen.

Raises

ValueError

Rechteck außerhalb des Bilds, radius negativ oder größer als die halbe Seite, alpha außerhalb von [0,1].

Zeichnen: Innen/außen wird über den Abstand vom Pixelzentrum zum "Rechteck mit abgerundeten Ecken" entschieden; bei fill=False wird nur ein Band von max(1, width) px Breite ab dem äußeren Rand aufgetragen (1 Stufe Abstandstest, kein Anti-Aliasing). Zusammengesetzt wird out = m*color + (1-m)*img, multipliziert mit alpha.

• img: (H, W) / (H, W, 1|3|4). Gibt eine nach float64 konvertierte und auf [0, 1] begrenzte Kopie zurück (die Eingabe bleibt unverändert). NaN/Inf ergibt ValueError.

• rect: (x, y, w, h), x = Spalte, y = Zeile. Wird auf Ganzzahlen gerundet; w, h > 0, und es muss vollständig im Bild liegen (Überstand wird nicht gekürzt, sondern ValueError). Belegte Pixel sind x .. x+w-1, y .. y+h-1.

• radius: Eckradius [px], 0 <= radius <= min(w, h)/2. 0 ergibt ein gewöhnliches Rechteck.

• color: ein palette-Rollenname ("neutral" usw., aufgelöst über scheme) oder RGB in [0, 1]. Für Graubilder wird der Mittelwert des RGB verwendet.

• Rückgabewert: float64 in derselben Form wie die Eingabe.

Für den Fall, dass man dasselbe Aussehen wie die Unterlage von text_box oder den Rahmen von annotate_legend von Hand baut.

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_gallery — py -3.11 examples/annotate_gallery.py

• poc_machine_condition_fusion — py -3.11 examples/poc_machine_condition_fusion.py

Typkompatible Folge-Operatoren (nehmen image2d als Eingabe)

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

Gleiche Kategorie (shape)

filled_polygon · arc · ellipse


*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.