sdf_csg op• 資料種類:coordgrid → sdf
• 呼叫: import fullseye as fs; fs.ledger.plane_sdf(grid, point, normal)(要直接呼叫實作,import sdf_ops; sdf_ops.plane_sdf(grid, point, normal);從台帳取用則 ops3d.get("plane_sdf"))
半空間(被平面切出的一側)的精確有號距離場(內側為負、外側為正)。
sdf(p) = (p - point) · n̂。法線 n̂ 所指的一側為外側（正），相反一側為內側。用於倒角、切割、「只保留基板以上部分」這類只保留一側的運算。疊加 sdf_intersect 可建構任意凸多面體。但 以 max 求交在角的外側並不嚴格:以 6 個平面建構長方體時，佔用(<= 0)與內側的值和 box_sdf 完全一致，但外側在角附近最多會低估 2.1（半邊長 2 的盒子、網格 0.25 實測）—— 這是 CSG 的標準性質，若需要距離本身，請使用 box_sdf。
嚴格性：平面在全空間梯度範數為 1，因此此值在任何地方都是真正的有號距離 （不需要像 box_sdf 那樣在角處切換的分情況處理）。
參數與驗證(ValueError)：
• grid：最後一軸為 3 的 float 陣列 (..., 3)（grid_coords 的輸出或點列）。
• point：平面上的 1 個點（元素數 3）。
• normal：平面的法線（元素數 3,拒絕零向量與 NaN）。長度自動正規化為 1, 因此大小不影響結果（只有方向有意義）。
回傳值：grid.shape[:-1] 的 float64。法線一側為正，相反一側為負，平面上為 0。
用法：sdf_subtract(part, plane_sdf(g, p, n)) 即「削去該平面法線一側的部分」。想反轉方向時，將 normal 的符號反轉（-sdf 也相同）。
• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。
• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。
• sdf_csg — py -3.11 examples_3d/sdf_csg.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 · cylinder_sdf · torus_sdf · capsule_sdf · sdf_union · sdf_intersect
*Provenance: sdf_ops.py — 3D 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.