annotate3d_bbox — 3D annotate3d op

• 데이터 종류: image2d → image2d

• 호출: import fullseye as fs; fs.ledger.annotate3d_bbox(img, bounds, pose, K, depth=None, color='emphasis', width=1.5, occlusion_tol=0.01, scheme='okabe_ito')(구현을 직접 호출하려면 import annotate3d; annotate3d.annotate3d_bbox(img, bounds, pose, K, depth=None, color='emphasis', width=1.5, occlusion_tol=0.01, scheme='okabe_ito'), 원장에서 가져오려면 ops3d.get("annotate3d_bbox"))

사용법

이미지(image2d)를 돌려줍니다: 축 평행 3-D 상자 `((xmin,ymin,zmin),(xmax,ymax,zmax))` 의 12 모서리를 투영해 그립니다.

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

`depth` を渡すと、両端が隠れている辺を破線にする。

Raises

------

ValueError

bounds の形 / min > max、角がカメラの後ろ。

手順: `bounds から 8 つの角 (x_i, y_j, z_k)`(i, j, k ∈ {min, max})を作り、

まとめて射影(`annotate3d_project` と同じ慣習)。12 辺を

`annotate._aa_polyline で描く。辺の両端が hidden` なら破線、片端だけなら

実線。

引数:

• `bounds: ((xmin, ymin, zmin), (xmax, ymax, zmax)) の (2, 3)`(object

座標、有限、各軸で `max >= min。max == min` の潰れた箱は許す)。点群なら

`points.min(0) / points.max(0)、メッシュなら V` から作る。

• `width: 線幅 [px]、>= 0.5 の実数。color`: 役割名か RGB。

• `depth: 前方距離画像(render3d.render_mesh の depth`)。

`occlusion_tol: [0, 1)`。

返り値: 描画済みの新しい画像(float64 `[0, 1]`、入力は変更しない)。

エラーになる条件: `bounds が (2, 3) でない・非有限・max < min` の軸が

ある / 8 角のいずれかが `z <= 1e-9`(カメラ面上か後ろ。箱が視点を囲む場合は

描けない) / 姿勢・`K・depth` の不正。角が画像の外に出るのはエラーに

しない(線は枠外まで引かれ、見た目は切れる)。

注意: 軸平行(世界座標に沿った)箱のみ。回転した箱(`smallest_box3` の

`corners)を描くには、8 角を自分で射影(annotate3d_project`)して 2-D の

`annotate` 線描画で結ぶ。

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

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

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

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