Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
CSGMesh3D
繼承: CSGPrimitive3D < CSGShape3D < GeometryInstance3D < VisualInstance3D < Node3D < Node < Object
使用網格資源的 CSG 網格形狀。
說明
該 CSG 節點允許你將任何流形的網格資源用作 CSG 形狀。流形的形狀指的是閉合、不自相交、不包含內部面、沒有連接到兩個面以上的邊。將繪製的 2D 多邊形擠出用作 CSG 節點見 CSGPolygon3D。
注意:CSG 節點旨在用於關卡原型設計。與使用 PrimitiveMesh 建立 MeshInstance3D 相比,建立 CSG 節點具有顯著的 CPU 成本。在另一個 CSG 節點中移動 CSG 節點也會大量消耗 CPU,因此在遊戲過程中應該避免這種情況。
教學
屬性
屬性說明
用於繪製 CSG 形狀的 Material。
用作 CSG 形狀的 Mesh 資源。
注意:該屬性的型別提示中排除了 PlaneMesh、PointMesh、QuadMesh、RibbonTrailMesh 等 Mesh 型別,因為這些圖元非流形,與 CSG 算法不相容。
注意:使用 ArrayMesh 時,除 Mesh.ARRAY_VERTEX、Mesh.ARRAY_NORMAL 和 Mesh.ARRAY_TEX_UV 之外的所有頂點屬性均保持未被使用的狀態。只有 Mesh.ARRAY_VERTEX 和 Mesh.ARRAY_TEX_UV 會被傳遞到 GPU。
Mesh.ARRAY_NORMAL 僅被用於確定哪些面需要使用平直著色。預設情況下,CSGMesh 將忽略該網格的頂點法線,為每個頂點重新計算它們並使用一個平滑著色器。如果面需要平直著色器,請確保面的所有頂點法線大致相等。