transform op• 数据种类:voxel → mesh
• 调用: import fullseye as fs; fs.ledger.voxel_to_mesh(vol, iso=0.5)(要直接调用实现,import match3d; match3d.voxel_to_mesh(vol, iso=0.5);从台账取用则 ops3d.get("voxel_to_mesh"))
• 经台账调用的返回值: fullseye.ledger.voxel_to_mesh(...) 只返回**声明的 out 类型 mesh 的值**(底层函数还会返回辅助信息)。需要被丢弃的部分时,使用 fullseye.ledger.voxel_to_mesh.raw(...),或直接调用 match3d.voxel_to_mesh。
voxel → mesh(marching cubes,skimage)。返回 (verts, faces, normals)。voxel→mesh 转换。
> 以下的详细说明为原文 —— 摘要与标题已翻译。
`skimage.measure.marching_cubes(vol, level=iso)` の薄い包み(spacing 指定なし = 1 voxel
単位)。`verts (V,3) float は **voxel index 座標**で、列は入力の軸順(vol` が (D,H,W)
なら (z,y,x))。`faces (F,3) int は verts への index、normals` (V,3) は skimage が
勾配から与える頂点法線。4 番目の返り値(values)は捨てる。
• `iso`: 等値面のレベル。入力の値域の外だと skimage が ValueError を出す(全 0 の
volume で iso=0.5 など)。個数密度なら 0.5、SDF なら 0.0 を渡す。
• 境界に接する等値面は開いたまま(端で閉じない)。
• ★巻き順は内向き。そのまま `mesh_volume` に渡すと**普通の中身のある形でも
負**になる(実測: 1000 voxel の立方体で -985.67)。体積が欲しいだけなら
`abs()、向きを揃えたいなら faces[:, ::-1]` で巻き直す。
• skimage は呼び出し時 import(未導入なら ImportError)。
後段: `mesh_to_points で点群化、mesh_area / face_areas / mesh_volume` /
`boundary_vertices / mesh_edge_stats` で計測。
• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。
• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。
• mesh_smooth — py -3.11 examples_3d/mesh_smooth.py
mesh 作为输入)mesh_to_voxel · mesh_to_points · to_points · fuse_to_voxel · ambient_occlusion · cast_shadow · supersample_mesh · render_beauty
transform)points_to_voxel · gaussians_to_voxel · mesh_to_voxel · mesh_to_points · depth_to_points · voxel_to_mips · tsdf_from_depth · signed_distance_field
*Provenance: match3d.py — 3D 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.