annotate3d op• 데이터 종류: image2d × text → image2d
• 호출: import fullseye as fs; fs.ledger.annotate3d_label(img, text, anchor, pose, K, depth=None, offset=(26.0, -22.0), color='emphasis', width=1.5, cap_size=3.0, font_size=12, pad=4, box_alpha=0.72, text_color=None, occlusion_tol=0.01, scheme='okabe_ito', font_path=None)(구현을 직접 호출하려면 import annotate3d; annotate3d.annotate3d_label(img, text, anchor, pose, K, depth=None, offset=(26.0, -22.0), color='emphasis', width=1.5, cap_size=3.0, font_size=12, pad=4, box_alpha=0.72, text_color=None, occlusion_tol=0.01, scheme='okabe_ito', font_path=None), 원장에서 가져오려면 ops3d.get("annotate3d_label"))
이미지(image2d)를 돌려줍니다: 3-D 앵커에 지시선이 달린 글자를 붙입니다.
> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.
文字はアンカーの画素から `offset [px] ずらした位置(offset[0]` の符号で
左右のアンカーを選ぶ)。`depth` で隠れていると分かれば破線 + 白抜きの印。
Raises
------
ValueError
アンカーがカメラの後ろ / 画像の外、文字が収まらない、姿勢・K の不正。
手順: `anchor(object 座標 (3,))を annotate3d_project` と同じ射影で
画素 `(x, y) にし、(x, y) から (x + offset[0], y + offset[1])` へ
引き出し線(`annotate._aa_polyline、幅 width`)を引き、アンカー側に半径
`cap_size の点を打ち、線の先に annotate.text_box` で文字を置く。
文字箱の付け根(anchor)は `offset[0] > 0 なら左中、< 0` なら右中、
`== 0 なら offset[1] < 0` で下中央・それ以外で上中央。
引数:
• `offset: 画素単位 (dx, dy)(dy` は下向き正 = 行方向)。既定
`(26, -22)` は右上へ。
• `width: 線幅 [px]、>= 0.5 の実数。cap_size`: 点の半径 [px]、0 で
打たない。`pad / font_size / box_alpha / text_color` /
`font_path: 文字箱の見た目(font_size` 未満 9 までは自動縮小)。
• `depth`: 前方距離画像。隠れていれば線を破線、点を白抜き(ring)にする。
• `color: 役割名か RGB。occlusion_tol: [0, 1)`。
返り値: 描画済みの新しい画像(float64 `[0, 1]`、入力は変更しない)。
エラーになる条件(実装どおり): アンカーが `z <= 1e-9` / アンカーの画素が
`[0, W-1] x [0, H-1] の外 / 姿勢・K・depth` の不正 / 文字箱が縮小しても
画像に収まらない(`text_box 側)。offset` の先が枠外でも線は引く。
使いどころ: 図中の部位名・番号付け。複数の点を一括でラベル付けするときは
`annotate3d_project で可視判定を先に取り、visible` の点だけ呼ぶ。
• 샘플 데이터 카탈로그(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_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.