EditableMesh

EditableMesh 將變更應用的視覺網格，當連接到 MeshPart 時，可以在 Studio 和體驗中查詢和修改網格。

一個 EditableMesh 可以從現有的 Content 的 MeshPart 或網格ID使用 AssetService:CreateEditableMeshAsync() 或空白 EditableMesh 來創建，或使用 AssetService:CreateEditableMesh() 來創建空白 。然後可以顯示、修改和更新其碰撞模型。不是所有步驟都是必要的；例如，你可能想創建一個 EditableMesh 只是為了射線而不顯示它。

當它與新的 EditableMesh 鏈接時，會在 MeshPart 中顯示一個 AssetService:CreateMeshPartAsync() 。您可以創建更多 引用相同 的實例，或通過 鏈接到現有的 。

要重新計算碰撞和液體幾何圖形後編輯，您可以再次呼叫 AssetService:CreateMeshPartAsync() 和 MeshPart:ApplyMesh() 來更新現有的 MeshPart 。一般來說，在概念編輯結束之後執行此操作，而不是在個別調用操作方法來操作幾何圖形之後執行此操作。網格的視覺變化總是會立即反映在引擎上，無需呼叫 AssetService:CreateMeshPartAsync() 。

啟用已發布體驗的可編輯網格

為了安全目的，使用 EditableMesh 對發布的體驗會預設失敗。要啟用使用，EditableMesh，您必須年滿 13 歲且身份驗證。驗證通過後，開啟 Studio 的 遊戲設定，選擇 安全 ，並啟用 允許網格和圖像 API 切換。記得在啟用切換前查看 使用條款。

許可

為了防止濫用，AssetService:CreateEditableMeshAsync()只允許您載入和編輯網格資產：

• 這些是屬於體驗創作者的（如果體驗屬於個人）。
• 屬於群組所有的（如果體驗屬於群組）。
• 屬於登入的工作室用戶所擁有（如果位置檔案尚未儲存或發布到 Roblox）。

如果使用 API 載入不符合上述條件的資產，它們將發出錯誤。

固定尺寸網格

當從現有網格資產中創建 EditableMesh 時(通過 AssetService:CreateEditableMeshAsync() )，結果的可編輯網格的尺寸固定。固定尺寸的網格在記憶體效率上更高，但您無法更改垂直邊、面或屬性的數量。只能編輯vertex特性和位置的值。

穩定的vertex/面ID

許多 EditableMesh 方法使用 vertex , 正常 , UV , 顏色 和 面部 ID。這些在 Luau 中以整數形式表示，但需要一些特殊處理。主要差異是，ID 穩定且即使其他網格部分發生變更，它們也會保持相同。例如，如果 EditableMesh 有五個邊緣 {1, 2, 3, 4, 5} ，如果你移除邊緣 4 ，那麼新的邊緣將是 {1, 2, 3, 5} 。

請注意，ID 不保證會按順序排列，數字編號可能會出現空白，因此當遍巡垂直或面時，您應該遍巡由 GetVertices() 或 GetFaces() 返回的表。

分割頂點屬性

一個 邊緣 是臉部的角落，並且鏈接臉部在一起。邊緣可以擁有多個特性：位置、正常、紫外線座標、顏色和透明度。

有時候對於所有接觸頂點的面使用相同的特性值有用，但有時候你會想要不同的面使用相同的特性值在同一個頂點上。例如，在平滑球體上，每個vertex只會有一個正常。相反，在立方體的角落，頂點將有 3 種不同的正常 (每個鄰近面的一個)。你也可以在 UV 坐標中有縫紉或在vertex顏色上發生鋒利的變化。

當創建面時，每個vertex預設會擁有每個特性中的一個：一個正常、一個UV座標和一個顏色/透明度。如果您想創建縫，您應該創建新的屬性並將它們設置在面上。例如，這段代碼會創建一個鋒利的立方體：

local AssetService = game:GetService("AssetService")

-- 給予 4 個角度 ID，添加新的正常和 2 個三角形，製作鋒利的四角
local function addSharpQuad(eMesh, vid0, vid1, vid2, vid3)
	local nid = eMesh:AddNormal()  -- 這會創建一個正常的ID，它會自動計算

	local fid1 = eMesh:AddTriangle(vid0, vid1, vid2)
	eMesh:SetFaceNormals(fid1, {nid, nid, nid})

	local fid2 = eMesh:AddTriangle(vid0, vid2, vid3)
	eMesh:SetFaceNormals(fid2, {nid, nid, nid})
end

-- 在 6 側之間的增加邊緣的立方體
local function makeSharpCube()
	local eMesh = AssetService:CreateEditableMesh()

	local v1 = eMesh:AddVertex(Vector3.new(0, 0, 0))
	local v2 = eMesh:AddVertex(Vector3.new(1, 0, 0))
	local v3 = eMesh:AddVertex(Vector3.new(0, 1, 0))
	local v4 = eMesh:AddVertex(Vector3.new(1, 1, 0))
	local v5 = eMesh:AddVertex(Vector3.new(0, 0, 1))
	local v6 = eMesh:AddVertex(Vector3.new(1, 0, 1))
	local v7 = eMesh:AddVertex(Vector3.new(0, 1, 1))
	local v8 = eMesh:AddVertex(Vector3.new(1, 1, 1))

	addSharpQuad(eMesh, v5, v6, v8, v7)  -- 前
	addSharpQuad(eMesh, v1, v3, v4, v2)  -- 返回
	addSharpQuad(eMesh, v1, v5, v7, v3)  -- 左
	addSharpQuad(eMesh, v2, v4, v8, v6)  -- 右
	addSharpQuad(eMesh, v1, v2, v6, v5)  -- 底部
	addSharpQuad(eMesh, v3, v7, v8, v4)  -- 顶部

	eMesh:RemoveUnused()
	return eMesh
end

彎曲

網格面有前面和後面。當繪製網格時，只有面的前部被預設繪製，雖然您可以透過設置網格的 屬性變更此情況。

面周围的邊緣點的順序決定您是否正在查看前部或返回部。當邊緣以反時針方向繞過面時，面的前部可見。

限制

EditableMesh 目前有 60,000 個節點和 20,000 個三角形的限制。如果嘗試添加過多的節點或三角形，將發生錯誤。