EditableMesh

EditableMesh 将应用的视觉网格更改为连接到 MeshPart 时，允许在 Studio 和体验中查询和修改网格。

启用发布体验

为了安全目的，默认情况下，使用 EditableMesh 对发布的体验失败。要启用使用，您必须年满 13 岁并身份验证通过。验证通过后，打开 Studio 的 游戏设置，选择 安全 ，然后启用 允许网格/图像 API 切换。

权限

为了防止滥用，AssetService:CreateEditableMeshAsync() 只允许您加载和编辑网格资产：

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

内存限制

可编辑的资产目前对内存使用成本很高。为了最大限度地减少对客户端性能的影响，EditableMesh 有严格的客户端内存预算，尽管服务器、Studio 和插件都使用无限内存。使用 FixedSize 可能会帮助您保持在内存预算内，在一些场景中，将一个 EditableMesh 链接到多个 MeshParts (多次引用) 可以帮助优化内存。

创建和显示

一个 EditableMesh 可以从现有的 Content 的 MeshPart 或网格 ID 使用 AssetService:CreateEditableMeshAsync() 或空白 EditableMesh 创建，或使用 AssetService:CreateEditableMesh() 可以创建一个空白 。然后可以显示、修改和更新其碰撞模型。不是所有步骤都是必要的；例如，你可能想创建一个 EditableMesh 仅用于射线投射，而不显示它。

local AssetService = game:GetService("AssetService")

-- 创建空可编辑的网格
local editableMesh = AssetService:CreateEditableMesh()

-- 从资产 ID 创建可编辑的网格
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID))
end)

-- 从另一个可编辑的网格中创建可编辑的网格
local editableMeshFromAnother = nil
local success, errorMessage = pcall(function()
	editableMeshFromAnother = AssetService:CreateEditableMeshAsync(Content.fromObject(OTHER_EDITABLE_MESH))
end)

-- 从网格部件中创建可编辑网格
local editableMeshFromMeshPart = nil
local success, errorMessage = pcall(function()
	editableMeshFromMeshPart = AssetService:CreateEditableMeshAsync(MESH_PART.MeshContent)
end)

当它链接到新的 EditableMesh 时，将显示一个 MeshPart ，通过 AssetService:CreateMeshPartAsync() 。您可以创建更多 引用相同 的实例，或通过 链接到现有的 。

local AssetService = game:GetService("AssetService")
local Workspace = game:GetService("Workspace")

-- 从资产 ID 创建可编辑的网格
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID))
end)

-- 创建新的网格部件，与可编辑网格连接
local newMeshPart = nil
local success, errorMessage = pcall(function()
	newMeshPart = AssetService:CreateMeshPartAsync(Content.fromObject(editableMeshFromAsset))
end)

-- 或者，将上面创建的新 MeshPart 链接到现有的 MeshPart
local existingMeshPart = Workspace:FindFirstChild("EXISTING_MESH_PART")
existingMeshPart:ApplyMesh(newMeshPart)

要重新计算编辑后的碰撞和流体几何图形，您可以再次调用 AssetService:CreateMeshPartAsync() 和 MeshPart:ApplyMesh() 来更新现有的 MeshPart 。一般建议在概念编辑结束后执行此操作，而不是在调用个别方法来操作几何图形之后。网格的视觉变化始终会立即反映在引擎上，无需调用 AssetService:CreateMeshPartAsync() 。

固定尺寸网格

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

local AssetService = game:GetService("AssetService")

-- 创建无固定尺寸默认的可编辑网格
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID), {FixedSize = false})
end)

稳定的垂直/面 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(editableMesh, vid0, vid1, vid2, vid3)
	local nid = editableMesh:AddNormal()  -- 这会创建一个正常 ID，它会自动计算

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

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

-- 使6边之间的边缘增加的立方体
local function makeSharpCube()
	local editableMesh = AssetService:CreateEditableMesh()

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

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

	editableMesh:RemoveUnused()
	return editableMesh
end

卷线

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

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

FACS 姿势

可动头使用面部动作编码系统（FACS）。查看 FACS 姿势参考 以获取使用 GetFacsPoses() 和类似方法时有用的信息。

每个 FACS 姿势由 Enum.FacsActionUnit 值确定。对于 FACS 姿势，虚拟骨头每个都可以有一个 CFrame 将骨头的初始 CFrame 在绑定姿势的网格中转换为该 FACS 操作单元的姿势的 CFrame 。所有骨头 CFrames 都在网格的本地空间。

这些 FACS 姿势在动画期间融合在一起。有时，基础姿势的混合产生了糟糕的结果。在这些情况下，您可以通过使用更令人满意的 纠正姿势 来覆盖特定基础姿势的混合。纠正姿势由 2 或 3 Enum.FacsActionUnit 值确定。像基础 FACS 姿势一样，为了纠正姿势，虚拟骨头每个都可以有一个 CFrame 将网格中的初始 CFrame 骨头转换为该 FACS 纠正的 CFrame 骨头。

限制

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