voxel_to_mesh — 3D 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` で計測。

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

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL 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 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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