annotate3d_bbox — 3D annotate3d op

数据种类:image2dimage2d

调用: 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 >= minmax == min` の潰れた箱は許す)。点群なら

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

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

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

`occlusion_tol: [0, 1)`。

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

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

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

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

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

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

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

`annotate` 線描画で結ぶ。

参考(示例数据・文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

可运行的示例(实际调用该算子并已验证的样例)

annotate3d_figurepy -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 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

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