voxel_to_mesh — 3D transform op

Data kinds: voxelmesh

Call: import fullseye as fs; fs.ledger.voxel_to_mesh(vol, iso=0.5) (to call the implementation directly, import match3d; match3d.voxel_to_mesh(vol, iso=0.5); from the registry, ops3d.get("voxel_to_mesh"))

Return value through the ledger: fullseye.ledger.voxel_to_mesh(...) returns **only the declared out type mesh** (the underlying function also returns auxiliary values). When you need what was dropped, use fullseye.ledger.voxel_to_mesh.raw(...) or call match3d.voxel_to_mesh directly.

Usage

Voxel → mesh (marching cubes, skimage). Returns (verts, faces, normals). The voxel → mesh conversion.

> The detailed description below is the original text — the summary and the headings are translated.

`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` で計測。

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

Runnable examples (verified samples that actually call this op)

mesh_smoothpy -3.11 examples_3d/mesh_smooth.py

Ops the type connects to (they accept mesh as input)

mesh_to_voxel · mesh_to_points · to_points · fuse_to_voxel · ambient_occlusion · cast_shadow · supersample_mesh · render_beauty

Same category (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 operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

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