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.

CSGMesh3D

繼承: CSGPrimitive3D < CSGShape3D < GeometryInstance3D < VisualInstance3D < Node3D < Node < Object

使用網格資源的 CSG 網格形狀。

說明

該 CSG 節點允許你將任何流形的網格資源用作 CSG 形狀。流形的形狀指的是閉合、不自相交、不包含內部面、沒有連接到兩個面以上的邊。將繪製的 2D 多邊形擠出用作 CSG 節點見 CSGPolygon3D。

注意:CSG 節點旨在用於關卡原型設計。與使用 PrimitiveMesh 建立 MeshInstance3D 相比,建立 CSG 節點具有顯著的 CPU 成本。在另一個 CSG 節點中移動 CSG 節點也會大量消耗 CPU,因此在遊戲過程中應該避免這種情況。

教學

屬性

Material

material

Mesh

mesh


屬性說明

Material material 🔗

用於繪製 CSG 形狀的 Material。


Mesh mesh 🔗

  • void set_mesh(value: Mesh)

  • Mesh get_mesh()

用作 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 將忽略該網格的頂點法線,為每個頂點重新計算它們並使用一個平滑著色器。如果面需要平直著色器,請確保面的所有頂點法線大致相等。