cad_visible_faces — CADMAP visibility op

• 資料種類:mesh → indices

• 呼叫: import fullseye as fs; fs.ledger.cad_visible_faces(mesh, K=None, R=None, t=None, width=64, height=64, cull_backfaces=True, strict=True)(要直接呼叫實作,import cadmap; cadmap.cad_visible_faces(mesh, K=None, R=None, t=None, width=64, height=64, cull_backfaces=True, strict=True);從台帳取用則 opscadmap.get("cad_visible_faces"))

用法

從該相機實際可見的面 ID(升冪,indices sort)。

向影像網格(width x height,像素中心在整數座標)發射光線,收集最靠前的面。背面(法線不朝向相機)以及完全被前方的面遮住的面不包括在內。直接回傳檢測涵蓋率 —— 「從這個視點看,CAD 的哪些面算是看過了」—— 的量,與 mesh_area 組合即可得到「未檢測的面積」。

在影像中小於網格解析度的面會被漏掉(因為是取樣,理所當然)。為了不把遺漏說成「被遮住」,回傳的是「看到的面」,而不是「看不到的面的補集」。

★只有這裡 strict 的預設值是 True(其他 3 個是 False)。回傳值是裸的索引陣列,所以沒有地方記載修正了繞向這一事實, 要避免「悄悄修正」,這裡只能拒絕。在 cull_backfaces=True 不變的情況下傳入向內繞的封閉網格(mesh)會拋出 ValueError。想要自動修正時,請在呼叫端明確指定 strict=False —— 那時是使用者要求了修正,所以即使不出現在回傳值中,也不算悄悄進行。cull_backfaces=False 時繞向不影響結果,因此也不做檢查。

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者、年份)與用途見上面的族使用指南。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• defect_to_cad — py -3.11 examples/defect_to_cad.py

型別可銜接的下一個運算子(可接受 indices 作為輸入)

—

同類別(visibility)

—

*Provenance: cadmap.py — CADMAP 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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