annotate3d_measure — 3D `annotate3d` op

• Datenarten: image2d → image2d

• Aufruf: import fullseye as fs; fs.ledger.annotate3d_measure(img, p0, p1, pose, K, unit='', depth=None, color='emphasis', width=1.5, tick=8.0, font_size=12, label_fmt='{:.3g}', box_alpha=0.6, text_color=None, occlusion_tol=0.01, scheme='okabe_ito', font_path=None) (die Implementierung direkt: import annotate3d; annotate3d.annotate3d_measure(img, p0, p1, pose, K, unit='', depth=None, color='emphasis', width=1.5, tick=8.0, font_size=12, label_fmt='{:.3g}', box_alpha=0.6, text_color=None, occlusion_tol=0.01, scheme='okabe_ito', font_path=None); aus dem Register: ops3d.get("annotate3d_measure"))

Verwendung

Liefert ein Bild (image2d): den Abstand zweier 3-D-Punkte (in Mesh-Einheiten), als projizierte Linie und Wert.

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

値は `|p1 - p0|`(3-D、閉形式)。画素上の長さは短縮しても値は変わらない。

Raises

------

ValueError

2 点が一致、端点がカメラの後ろ / 画像の外。

手順: `dist = |p1 - p0|`(object 座標のユークリッド距離、単位はメッシュ単位)を

計算し、`p0, p1 を射影(annotate3d_project` と同じ慣習)。両端の画素を

結ぶ線と両端の垂直な目盛(長さ `tick` px)、両端に半径 3 px の点を描き、線の

中点から画面上側へ `tick/2 + 4` px 離した位置に

`label_fmt.format(dist) + " " + unit` の文字箱を置く。

引数:

• `p0, p1: object 座標 (3,)`(有限、一致は拒否)。

• `unit: 文字列(空なら数値だけ)。label_fmt: str.format` 書式(既定

`"{:.3g}"`)。単位換算はしない — メッシュが mm ならそのまま mm。

• `width [px] >= 0.5、tick [px] >= 0、font_size / box_alpha` /

`text_color / font_path`: 文字箱の見た目。

• `depth`: 前方距離画像。両端とも隠れていれば線を破線に、隠れた端点の点を

白抜き(ring)にする。`occlusion_tol: [0, 1)`。

返り値: 描画済みの新しい画像(float64 `[0, 1]`)。

エラーになる条件: `|p1 - p0| < 1e-12 / どちらかの端点が z <= 1e-9` /

どちらかの端点が画像の外(`in_image を両端に要求) / 姿勢・K`・

`depth` の不正 / 文字箱が収まらない。

使いどころ: `fit_sphere3 の直径、smallest_box3` の辺、2 つの特徴点間の

距離を図の上に示す。値そのものは描画前に `np.linalg.norm(p1 - p0)` と同じ。

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.

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

• annotate3d_figure — py -3.11 examples_3d/annotate3d_figure.py

Typkompatible Folge-Operatoren (nehmen `image2d` als Eingabe)

fuse_to_voxel · fit_poly_surface · eval_poly_surface · surface_form_error · background_flatten · polar_unwrap · fit_zernike · matcap_shade

Gleiche Kategorie (`annotate3d`)

annotate3d_project · annotate3d_arrow · annotate3d_label · annotate3d_scale_bar · annotate3d_axes · annotate3d_bbox

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

annotate3d_measure — 3D annotate3d op