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)를 돌려줍니다: 세계 좌표의 세 축(gnomon)을 `origin` 에서 투영해 그립니다.

> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.

Raises

------

ValueError

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

軸の文字が画像に収まらない。

手順: `origin と、そこから世界座標の +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` の不正 / 軸の

文字が画像に収まらない。枠外の軸端はエラーにしない(矢印は枠外まで引く)。

視線と一致して点に潰れた軸(画素長 1e-9 未満)は黙ってスキップする。

使いどころ: 図の姿勢の説明(gnomon)。`render3d.look_at の pose` を

そのまま渡し、`origin にメッシュの重心や bounds` の角を置く。

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

• 샘플 데이터 카탈로그(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_arrow · annotate3d_label · annotate3d_scale_bar · annotate3d_bbox · annotate3d_measure

*Provenance: annotate3d.py — 3D 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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