annotate3d_axes — 3D `annotate3d` op

• データ種: image2d → image2d

• 呼び出し: import fullseye as fs; fs.ledger.annotate3d_axes(img, pose, K, origin=(0.0, 0.0, 0.0), length=1.0, depth=None, labels=('X', 'Y', 'Z'), colors=('wrong', 'right', 'reference'), width=2, font_size=11, occlusion_tol=0.01, scheme='okabe_ito', font_path=None) (実装を直接呼ぶなら import annotate3d; annotate3d.annotate3d_axes(img, pose, K, origin=(0.0, 0.0, 0.0), length=1.0, depth=None, labels=('X', 'Y', 'Z'), colors=('wrong', 'right', 'reference'), width=2, font_size=11, occlusion_tol=0.01, scheme='okabe_ito', font_path=None)、台帳から引くなら ops3d.get("annotate3d_axes"))

使い方

画像(image2d)を返す: object 座標(pose の入力側)の 3 軸(gnomon)を origin から射影して描く。

Raises

ValueError

length が非正、原点や軸端がカメラの後ろ、labels/colors が 3 つでない、

軸の文字が画像に収まらない、原点と軸端がともに画像の外。

手順: origin と、そこから object 座標の +X / +Y / +Z 方向に length 進んだ 3 点を射影(annotate3d_project と同じ慣習)し、原点の画素から各軸端の画素へ annotate.arrow(矢じり 8x6 px)を描く。軸端の先 0.7 * font_size px の位置に labels[i] を背景なし(box_alpha=0)の文字で置く。

引数:

• origin (3,)(object 座標)、length: 軸の長さ(メッシュ単位、> 0)。

• labels: 3 つの文字列(既定 ("X", "Y", "Z"))。colors: 3 つの色(役割名か RGB。既定 ("wrong", "right", "reference") はパレットの役割名)。

• width: 線幅 [px]、1 以上の整数。font_size [px]。

• depth / occlusion_tol: 射影に渡すが、この op は隠れ表示(破線)をしない(判定は depth の形検査に使うだけ)。

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

エラーになる条件: length <= 0 / labels か colors の長さが 3 でない / 原点または軸端のいずれかが z <= 1e-9 / 姿勢・K・depth の不正 / 軸の文字が画像に収まらない / 原点と軸端がともに画像の外(annotate.arrow が拒否)。軸端だけが枠外なら描く(矢印は枠外へ向かって引く)。視線と一致して点に潰れた軸(画素長 1e-9 未満)は黙ってスキップする。

使いどころ: 図の姿勢の説明(gnomon)。render3d.look_at の pose をそのまま渡し、origin にメッシュの重心や bounds の角を置く。

座標系: origin も軸の向きも pose が写す元の座標系(object 座標)で解釈する。look_at の pose は world→camera なので、そのときは world の軸になる。物体の姿勢 M(object→world)を含む pose @ M を渡すと物体の軸が描かれる。

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

• サンプルデータカタログ(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_arrow · annotate3d_label · annotate3d_scale_bar · annotate3d_bbox · annotate3d_measure

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

annotate3d_axes — 3D annotate3d op

使い方