annotate3d_arrow — 3D `annotate3d` op

• データ種: image2d → image2d

• 呼び出し: import fullseye as fs; fs.ledger.annotate3d_arrow(img, p0, p1, pose, K, depth=None, color='emphasis', width=2, head_len=12.0, head_width=9.0, occlusion_tol=0.01, scheme='okabe_ito') (実装を直接呼ぶなら import annotate3d; annotate3d.annotate3d_arrow(img, p0, p1, pose, K, depth=None, color='emphasis', width=2, head_len=12.0, head_width=9.0, occlusion_tol=0.01, scheme='okabe_ito')、台帳から引くなら ops3d.get("annotate3d_arrow"))

使い方

画像(image2d)を返す: 3-D の p0 から p1 へ、射影した矢印を描く。

depth を渡し両端とも隠れているなら破線で描く(矢じりは半透明)。

Raises

ValueError

端点がカメラの後ろ / 2 点が同じ画素に射影される / 両端とも画像の外、姿勢・K の不正。

手順: img を float64 [0, 1] の複製にし((H, W) / (H, W, C)、C は 1/3/4。非有限・空は ValueError)、p0, p1 を annotate3d_project と同じ射影で画素にして、annotate.arrow で p0 の画素から p1 の画素へ矢印を描く。矢じりは p1 側。

引数:

• p0, p1: object 座標 (3,)(有限)。pose は 4x4 object→camera か (R, t)、K は 3x3(-Z を見る render3d 慣習)。

• depth: (H, W) 前方距離画像(render3d.render_mesh の depth)。画像と同じ形でなければ ValueError。

• color: 役割名("emphasis" など、scheme のパレットで解決)か RGB。

• width: 線幅 [px]、1 以上の整数(1.5 は拒否)。

• head_len / head_width: 矢じりの長さ・幅 [px]。隠れ描画では矢印長の 80 % を超えないよう縮める。

• occlusion_tol: [0, 1)。

返り値: 描画済みの新しい画像(float64、入力と同じ形。入力は変更しない)。

エラーになる条件(実装どおり): どちらかの端点が z <= 1e-9(カメラ面上/後ろ)/ 2 点が同じ画素に射影される(視線上に並ぶ、長さ 1e-9 px 未満)/ 両端とも画像の外 (annotate.arrow が拒否する。枠に貼り付いた誤った線を描かないため)/ 姿勢・K の不正。片方だけ画像の外なら描く(線は枠外へ向かって引かれ、見た目は枠で切れる)。

使いどころ: render3d.render_mesh の画像に「この頂点がこれ」を示す。長さを数値で示すなら annotate3d_measure、文字を添えるなら annotate3d_label。

参考(サンプルデータ・文献)

• サンプルデータカタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。

• 演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。

実行できる例(この op を実際に呼ぶ検証済みサンプル)

• annotate3d_figure — py -3.11 examples_3d/annotate3d_figure.py

型が繋がる次の op(`image2d` を入力に取れる)

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

同カテゴリ(`annotate3d`)

annotate3d_project · annotate3d_label · annotate3d_scale_bar · annotate3d_axes · annotate3d_bbox · annotate3d_measure

*Provenance: annotate3d.py — 3D operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。*

annotate3d_arrow — 3D annotate3d op

使い方