EditableMesh

EditableMesh 改變鏈接到 MeshPart 的視覺網格，讓您可以在 Studio 和體驗中兩者的網格進行查詢和修改。

Class.EditableMesh 可以從 Content 的 MeshPart 或網格 ID 使用

Class.EditableMesh 會顯示在通過 MeshPart 連接到新 AssetService:CreateMeshPartAsync() 的鏈接上。 您可以通過 1>Class.EditableMesh1> 更多例子，或

要重新計算衝突和流體 геометria後，您可以再次呼叫 AssetService:CreateMeshPartAsync() 和 MeshPart:ApplyMesh() 來更新現有 MeshPart 。 一般來說，建議您在

啟用已發佈的體驗編輯網格

為了安全目的，使用 EditableMesh 對發佈的體驗會因預設而失敗。若要啟用使用，請 EditableMesh 必須是 13+ 歲，並且身份驗ID 驗證。在您被��

許可

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

• 那些是擁有體驗的創作者的 (如果體驗屬於個人).
• 那些是由群組所擁有的 (如果體驗屬於群組)。
• 那些是由已登入的 Studio 使用者擁有的（如果該位置檔案尚未儲存或發佈到 Roblox）。

使用 APIs 載入資產，不符合上述條件，將會發生錯誤。

固定尺寸網格

從現有網格資產( via EditableMesh )創建新的 AssetService:CreateEditableMeshAsync() 時，結果的編輯網格會以預設大小固定。 編輯網格的大小會在記憶體上更有效率，但您無法編輯特徵、面或屬性。 僅能編輯值的網格屬性和位置。

穩定的頂點/面 ID

很多 EditableMesh 方法會取

注意，ID 不能保證是順序，因此當你在垂直或面上移動時，你應該在 GetVertices() 或 GetFaces() 的表中移動時，你應該移動到表。

分割垂直領域屬性

vertex 是面的角，並且上下文結合面。vertex 可以有多個屬性：位置、正常、uv坐標、顏色和2>透明度2>。

有時候會有用於所有接觸樹角的面使用相同的屬性值，但有時候您可能想要不同的面使用不同的屬性值在同一個樹角上。例如，在平滑球上，每個樹角只會有一個普通。 與此相反，在方塊角的角落，樹角將有 3 個不同的普通值 (一個為每個鄰近面)。

當創建面時，每個邊緣將預設有一個屬性：一個正常，一個 UV 坐標和一個顏色/透明度。如果您想要創建一個縫隙，您應該創建新屬性並將它設置在面上。例如，此代碼將創建一個鋒利的方塊：

local AssetService = game:GetService("AssetService")

-- 提供 4 個邊緣 ID，並且增加 2 個三角形，以形成銳利的四角形
local function addSharpQuad(eMesh, vid0, vid1, vid2, vid3)
	local nid = eMesh:AddNormal()  -- 這會創建一個正常的 ID，該 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

結束

網格面有前面和後面。當畫網格時，只有面的前部分被預設畫畫，雖然您可以通過設置網格的 DoubleSided 屬性將其變更為 true。

臉周圍的垂直排列是否表示您正在查看前方或返回方。臉前方的垂直排列會顯示，當垂直排列的角度向前或向後移動。

限制

EditableMesh 目前有 60,000 個邊緣和 20,000 個三角形的限制。嘗試添加太多邊緣或三角形會導致錯誤。