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

端点がカメラの後ろ / 一致 / 両端とも画像の外、姿勢・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 未満)/ 姿勢・`K` の不正。

画像の外に出た端点はエラーにしない(`annotate.arrow` が枠外まで線を引く

だけ。片方が枠内なら見た目は途中で切れる)。

使いどころ: `render3d.render_mesh` の画像に「この頂点がこれ」を示す。長さを

数値で示すなら `annotate3d_measure、文字を添えるなら annotate3d_label`。

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

• annotate3d_figure — py -3.11 examples_3d/annotate3d_figure.py

타입이 이어지는 다음 연산자(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 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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