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() 只允许您加载和编辑网格资产：

• 这些是由体验的创建者拥有的（如果体验由个人拥有）。
• 这些是由群组拥有的（如果体验由群组拥有）。
• 这些是由登录的 Studio 用户拥有的（如果地点文件尚未保存或发布到 Roblox）。

如果使用 API 来加载不满足上述条件的资产，它们将抛出错误。

固定尺寸网格

当从现有网格资产中创建一个 EditableMesh 时(通过 AssetService:CreateEditableMeshAsync() )，结果的可编辑网格默认为固定尺寸。固定尺寸的网格在内存方面更高效，但您无法更改边顶点、面或属性的数量。只能编辑顶点属性和位置的值。

稳定的垂直/面 ID

许多 EditableMesh 方法使用 vertex , normal , UV , color 和 face ID。这些在 Luau 中被视为整数，但需要一些特殊处理。主要区别是，ID 是稳定的，即使其他部分的网格发生变化，它们也是相同的。例如，如果一个 EditableMesh 有五个边顶 {1, 2, 3, 4, 5} ，如果你移除边顶 4 ，那么新的边顶将是 {1, 2, 3, 5} 。

请注意，ID 不保证是按顺序排列的，因此，当遍历垂直或面时，您应该遍历由 GetVertices() 或 GetFaces() 返回的表。

分割垂直面属性

一个 边角 是面的角落，并且可以将面连接在一起。顶点可以有几个属性：位置、正常、UV坐标、颜色和透明度。

有时对于所有接触顶点的面都有用使用相同的属性值，但有时你会想让不同的面使用不同的属性值在同一顶点上。例如，在光滑的球体上，每个边点只有一个正常。相反，在立方体的角落，顶点将有 3 个不同的正常（每个邻近面都有一个）。您还可以在 UV 坐标或顶点颜色上有缝隙或锋利的变化。

当创建面时，每个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

卷线

网格面有前面和后面。当绘制网格时，默认情况下只绘制面的前部，尽管您可以通过设置网格的 DoubleSided 属性为 true 来更改此情况。

面周围的边缘点的顺序决定你是否正在查看前部或后返回。当垂直向前时，面的前部可见，当垂直向后时，面的后部可见。

限制

EditableMesh 目前有 60,000 个边和 20,000 个三角形的限制。尝试添加太多边或三角形会导致错误。