sdf_csg op• 데이터 종류: sdf → sdf
• 호출: import fullseye as fs; fs.ledger.sdf_offset(sdf, r)(구현을 직접 호출하려면 import sdf_ops; sdf_ops.sdf_offset(sdf, r), 원장에서 가져오려면 ops3d.get("sdf_offset"))
SDF 의 영등가면을 거리 r 만큼 법선 방향으로 이동 = sdf - r(r>0 팽창, r<0 수축).
새 영 집합은 이전 sdf == r 의 등위면. 모든 점에서 거리가 균일하게 r 만큼 이동하므로, 거리장으로서의 성질(기울기 노름 1)은 유지된다. 프리미티브의 두께 부여(둥근 셸)나 배관의간극 확보에 쓴다.
계산: np.asarray(sdf, float64) - float(r). r 은 스칼라만(배열을 넘기면 float() 에서 TypeError). 단위는 sdf 의 거리 단위와 같다. r = 0 은 항등. shape, NaN, inf 의 검사는 하지 않는다(inf - r = inf 로 계약대로 전파).
기하적 의미: 엄밀한 SDF 에 대해서는 Minkowski 합(r > 0 이면 반지름 r 의 구로팽창, r < 0 이면 수축)과 일치한다. sphere_sdf(g, c, R) 에 r 을 적용하면 sphere_sdf(g, c, R + r) 과 엄밀히 같다. box_sdf 의 팽창에서는 모서리가 둥글어진다(유클리드 팽창이므로 상자가 커지는 것이 아니라 모서리 R = r 의 둥근 상자가 된다).
주의:
• 수축(r < 0)에서 |r| 이 최소 내접 반지름을 넘으면 형태가 사라진다(모든 요소가 양). 오류는 아니다.
• sdf_union / sdf_intersect 의 안쪽은 참 거리의 하계이므로, 합성 후에 r < 0 으로 수축하면 겹침 영역에서 실제보다 많이 깎일 수 있다.
• 두께 t 의 셸: sdf_subtract(sdf, sdf_offset(sdf, -t)).
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• sfm_recon — py -3.11 examples_3d/sfm_recon.py
sdf 를 입력으로 받는 것)sdf_to_occupancy · fuse_to_voxel · integrate · extract_surface_points · query_distance · sdf_union · sdf_intersect · sdf_subtract
sdf_csg)grid_coords · sphere_sdf · box_sdf · plane_sdf · cylinder_sdf · torus_sdf · capsule_sdf · sdf_union
*Provenance: sdf_ops.py — 3D 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.