学习
引擎类
EditableMesh
无法创建

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处


概要
方法
AddBone(boneProperties: Dictionary):number
AddColor(color: Color3,alpha: number):number
AddTriangle(vertexId0: number,vertexId1: number,vertexId2: number):number
Destroy():()
GetVertexFaceUV(vertexId: number,faceId: number):number
MergeVertices(mergeTolerance: number):Map
RaycastLocal(origin: Vector3,direction: Vector3):Tuple
RemoveBone(boneId: number):()
RemoveFace(faceId: number):()
ResetNormal(normalId: number):()
SetBoneCFrame(boneId: number,cframe: CFrame):()
SetBoneIsVirtual(boneId: number,virtual: boolean):()
SetBoneName(boneId: number,name: string):()
SetBoneParent(boneId: number,parentBoneId: number):()
SetColor(colorId: number,color: Color3):()
SetColorAlpha(colorId: number,alpha: number):()
SetFaceColors(faceId: number,ids: {any}):()
SetFaceNormals(faceId: number,ids: {any}):()
SetFaceUVs(faceId: number,ids: {any}):()
SetFaceVertices(faceId: number,ids: {any}):()
SetFacsBonePose(action: Enum.FacsActionUnit,boneId: number,cframe: CFrame):()
SetFacsCorrectivePose(actions: {any},boneIds: {any},cframes: {any}):()
SetFacsPose(action: Enum.FacsActionUnit,boneIds: {any},cframes: {any}):()
SetNormal(normalId: number,normal: Vector3):()
SetPosition(vertexId: number,p: Vector3):()
SetUV(uvId: number,uv: Vector2):()
SetVertexBones(vertexId: number,boneIDs: {any}):()
SetVertexBoneWeights(vertexId: number,boneWeights: {any}):()
SetVertexFaceColor(vertexId: number,faceId: number,colorId: number):()
SetVertexFaceNormal(vertexId: number,faceId: number,normalId: number):()
SetVertexFaceUV(vertexId: number,faceId: number,uvId: number):()
继承成员

API 参考
属性
FixedSize
只读
未复制
Roblox 安全性
读取并联
功能: DynamicGeneration
EditableMesh.FixedSize:boolean

方法
AddBone
功能: DynamicGeneration
EditableMesh:AddBone(boneProperties:Dictionary):number
参数
boneProperties:Dictionary
返回

AddColor
功能: DynamicGeneration
EditableMesh:AddColor(
color:Color3, alpha:number
参数
color:Color3
alpha:number
返回

AddNormal
功能: DynamicGeneration
EditableMesh:AddNormal(normal:Vector3?):number
参数
normal:Vector3?
返回

AddTriangle
功能: DynamicGeneration
EditableMesh:AddTriangle(
vertexId0:number, vertexId1:number, vertexId2:number
参数
vertexId0:number
vertexId1:number
vertexId2:number
返回

AddUV
功能: DynamicGeneration
EditableMesh:AddUV(uv:Vector2):number
参数
返回

AddVertex
功能: DynamicGeneration
EditableMesh:AddVertex(p:Vector3):number
参数
返回

Destroy
功能: DynamicGeneration
EditableMesh:Destroy():()
返回
()

FindClosestPointOnSurface
功能: DynamicGeneration
EditableMesh:FindClosestPointOnSurface(point:Vector3):Tuple
参数
point:Vector3
返回

FindClosestVertex
功能: DynamicGeneration
EditableMesh:FindClosestVertex(toThisPoint:Vector3):number
参数
toThisPoint:Vector3
返回

FindVerticesWithinSphere
功能: DynamicGeneration
EditableMesh:FindVerticesWithinSphere(
center:Vector3, radius:number
参数
center:Vector3
radius:number
返回

GetAdjacentFaces
功能: DynamicGeneration
EditableMesh:GetAdjacentFaces(faceId:number):{any}
参数
faceId:number
返回

GetAdjacentVertices
功能: DynamicGeneration
EditableMesh:GetAdjacentVertices(vertexId:number):{any}
参数
vertexId:number
返回

GetBoneByName
功能: DynamicGeneration
EditableMesh:GetBoneByName(boneName:string):number
参数
boneName:string
返回

GetBoneCFrame
功能: DynamicGeneration
EditableMesh:GetBoneCFrame(boneId:number):CFrame
参数
boneId:number
返回

GetBoneIsVirtual
功能: DynamicGeneration
EditableMesh:GetBoneIsVirtual(boneId:number):boolean
参数
boneId:number
返回

GetBoneName
功能: DynamicGeneration
EditableMesh:GetBoneName(boneId:number):string
参数
boneId:number
返回

GetBoneParent
功能: DynamicGeneration
EditableMesh:GetBoneParent(boneId:number):number
参数
boneId:number
返回

GetBones
功能: DynamicGeneration
EditableMesh:GetBones():{any}
返回

GetCenter
功能: DynamicGeneration
EditableMesh:GetCenter():Vector3
返回

GetColor
功能: DynamicGeneration
EditableMesh:GetColor(colorId:number):Color3?
参数
colorId:number
返回

GetColorAlpha
功能: DynamicGeneration
EditableMesh:GetColorAlpha(colorId:number):number?
参数
colorId:number
返回

GetColors
功能: DynamicGeneration
EditableMesh:GetColors():{any}
返回

GetFaceColors
功能: DynamicGeneration
EditableMesh:GetFaceColors(faceId:number):{any}
参数
faceId:number
返回

GetFaceNormals
功能: DynamicGeneration
EditableMesh:GetFaceNormals(faceId:number):{any}
参数
faceId:number
返回

GetFaces
功能: DynamicGeneration
EditableMesh:GetFaces():{any}
返回

GetFacesWithAttribute
已弃用

GetFacesWithColor
功能: DynamicGeneration
EditableMesh:GetFacesWithColor(colorId:number):{any}
参数
colorId:number
返回

GetFacesWithNormal
功能: DynamicGeneration
EditableMesh:GetFacesWithNormal(normalId:number):{any}
参数
normalId:number
返回

GetFacesWithUV
功能: DynamicGeneration
EditableMesh:GetFacesWithUV(uvId:number):{any}
参数
uvId:number
返回

GetFaceUVs
功能: DynamicGeneration
EditableMesh:GetFaceUVs(faceId:number):{any}
参数
faceId:number
返回

GetFaceVertices
功能: DynamicGeneration
EditableMesh:GetFaceVertices(faceId:number):{any}
参数
faceId:number
返回

GetFacsCorrectivePose
功能: DynamicGeneration
EditableMesh:GetFacsCorrectivePose(actions:{any}):Tuple
参数
actions:{any}
返回

GetFacsCorrectivePoses
功能: DynamicGeneration
EditableMesh:GetFacsCorrectivePoses():{any}
返回

GetFacsPose
功能: DynamicGeneration
EditableMesh:GetFacsPose(action:Enum.FacsActionUnit):Tuple
参数
返回

GetFacsPoses
功能: DynamicGeneration
EditableMesh:GetFacsPoses():{any}
返回

GetNormal
功能: DynamicGeneration
EditableMesh:GetNormal(normalId:number):Vector3?
参数
normalId:number
返回

GetNormals
功能: DynamicGeneration
EditableMesh:GetNormals():{any}
返回

GetPosition
功能: DynamicGeneration
EditableMesh:GetPosition(vertexId:number):Vector3
参数
vertexId:number
返回

GetSize
功能: DynamicGeneration
EditableMesh:GetSize():Vector3
返回

GetUV
功能: DynamicGeneration
EditableMesh:GetUV(uvId:number):Vector2?
参数
uvId:number
返回

GetUVs
功能: DynamicGeneration
EditableMesh:GetUVs():{any}
返回

GetVertexBones
功能: DynamicGeneration
EditableMesh:GetVertexBones(vertexId:number):{any}
参数
vertexId:number
返回

GetVertexBoneWeights
功能: DynamicGeneration
EditableMesh:GetVertexBoneWeights(vertexId:number):{any}
参数
vertexId:number
返回

GetVertexColors
功能: DynamicGeneration
EditableMesh:GetVertexColors(vertexId:number):{any}
参数
vertexId:number
返回

GetVertexFaceColor
功能: DynamicGeneration
EditableMesh:GetVertexFaceColor(
vertexId:number, faceId:number
参数
vertexId:number
faceId:number
返回

GetVertexFaceNormal
功能: DynamicGeneration
EditableMesh:GetVertexFaceNormal(
vertexId:number, faceId:number
参数
vertexId:number
faceId:number
返回

GetVertexFaces
功能: DynamicGeneration
EditableMesh:GetVertexFaces(vertexId:number):{any}
参数
vertexId:number
返回

GetVertexFaceUV
功能: DynamicGeneration
EditableMesh:GetVertexFaceUV(
vertexId:number, faceId:number
参数
vertexId:number
faceId:number
返回

GetVertexNormals
功能: DynamicGeneration
EditableMesh:GetVertexNormals(vertexId:number):{any}
参数
vertexId:number
返回

GetVertexUVs
功能: DynamicGeneration
EditableMesh:GetVertexUVs(vertexId:number):{any}
参数
vertexId:number
返回

GetVertices
功能: DynamicGeneration
EditableMesh:GetVertices():{any}
返回

GetVerticesWithAttribute
已弃用

GetVerticesWithColor
功能: DynamicGeneration
EditableMesh:GetVerticesWithColor(colorId:number):{any}
参数
colorId:number
返回

GetVerticesWithNormal
功能: DynamicGeneration
EditableMesh:GetVerticesWithNormal(normalId:number):{any}
参数
normalId:number
返回

GetVerticesWithUV
功能: DynamicGeneration
EditableMesh:GetVerticesWithUV(uvId:number):{any}
参数
uvId:number
返回

IdDebugString
功能: DynamicGeneration
EditableMesh:IdDebugString(id:number):string
参数
返回

MergeVertices
功能: DynamicGeneration
EditableMesh:MergeVertices(mergeTolerance:number):Map
参数
mergeTolerance:number
返回
Map

RaycastLocal
功能: DynamicGeneration
EditableMesh:RaycastLocal(
origin:Vector3, direction:Vector3
参数
origin:Vector3
direction:Vector3
返回
代码示例
可编辑网格:射线局部()
local AssetService = game:GetService("AssetService")
local Workspace = game:GetService("Workspace")
-- 在空间中初始化可编辑网格
local editableMesh = nil
local success, errorMsg = pcall(function()
editableMesh = AssetService:CreateEditableMeshAsync(Content.fromUri("rbxassetid://ASSET_ID"))
end)
local meshPart = nil
if success and editableMesh then
meshPart = AssetService:CreateMeshPartAsync(
Content.fromObject(editableMesh),
{ CollisionFidelity = Enum.CollisionFidelity.Hull }
)
meshPart.Parent = Workspace
else
warn(errorMsg)
end
-- 该函数将从给定点发射一条射线,返回命中的世界点和UV坐标
local function castRayFromCamera(meshPart: MeshPart, editableMesh: EditableMesh, viewportPoint: Vector3)
if not meshPart then
return
end
-- 计算对象在每个维度上的缩放比例
local renderScale = meshPart.Size / meshPart.MeshSize
-- 从相机创建一条射线,方向指向点击的点
local ray = Workspace.CurrentCamera:ViewportPointToRay(viewportPoint.X, viewportPoint.Y)
-- 转换为对象空间以与RaycastLocal()一起使用
local relativeOrigin = meshPart.CFrame:PointToObjectSpace(ray.Origin) / renderScale
local relativeTarget = meshPart.CFrame:PointToObjectSpace(ray.Origin + ray.Direction * 100) / renderScale
local relativeDirection = relativeTarget - relativeOrigin
local faceId, point, barycentricCoordinate, vertId1, vertId2, vertId3 =
editableMesh:RaycastLocal(relativeOrigin, relativeDirection)
if not faceId then
-- 未命中任何面
return
end
-- 计算世界空间中的命中点
local worldHitPoint = meshPart.CFrame:PointToWorldSpace(point * renderScale)
-- 获取面上的UV
local uvId1 = editableMesh:GetVertexFaceUV(vertId1, faceId)
local uvId2 = editableMesh:GetVertexFaceUV(vertId2, faceId)
local uvId3 = editableMesh:GetVertexFaceUV(vertId3, faceId)
local uv1 = editableMesh:GetUV(uvId1)
local uv2 = editableMesh:GetUV(uvId2)
local uv3 = editableMesh:GetUV(uvId3)
-- 根据重心坐标在面内插值UV
local u = (barycentricCoordinate.x * uv1.x) + (barycentricCoordinate.y * uv2.x) + (barycentricCoordinate.z * uv3.x)
local v = (barycentricCoordinate.x * uv1.y) + (barycentricCoordinate.y * uv2.y) + (barycentricCoordinate.z * uv3.y)
return worldHitPoint, Vector2.new(u, v)
end

RemoveBone
功能: DynamicGeneration
EditableMesh:RemoveBone(boneId:number):()
参数
boneId:number
返回
()

RemoveFace
功能: DynamicGeneration
EditableMesh:RemoveFace(faceId:number):()
参数
faceId:number
返回
()

RemoveUnused
功能: DynamicGeneration
EditableMesh:RemoveUnused():{any}
返回

ResetNormal
功能: DynamicGeneration
EditableMesh:ResetNormal(normalId:number):()
参数
normalId:number
返回
()

SetBoneCFrame
功能: DynamicGeneration
EditableMesh:SetBoneCFrame(
boneId:number, cframe:CFrame
):()
参数
boneId:number
cframe:CFrame
返回
()

SetBoneIsVirtual
功能: DynamicGeneration
EditableMesh:SetBoneIsVirtual(
boneId:number, virtual:boolean
):()
参数
boneId:number
virtual:boolean
返回
()

SetBoneName
功能: DynamicGeneration
EditableMesh:SetBoneName(
boneId:number, name:string
):()
参数
boneId:number
name:string
返回
()

SetBoneParent
功能: DynamicGeneration
EditableMesh:SetBoneParent(
boneId:number, parentBoneId:number
):()
参数
boneId:number
parentBoneId:number
返回
()

SetColor
功能: DynamicGeneration
EditableMesh:SetColor(
colorId:number, color:Color3
):()
参数
colorId:number
color:Color3
返回
()

SetColorAlpha
功能: DynamicGeneration
EditableMesh:SetColorAlpha(
colorId:number, alpha:number
):()
参数
colorId:number
alpha:number
返回
()

SetFaceColors
功能: DynamicGeneration
EditableMesh:SetFaceColors(
faceId:number, ids:{any}
):()
参数
faceId:number
ids:{any}
返回
()

SetFaceNormals
功能: DynamicGeneration
EditableMesh:SetFaceNormals(
faceId:number, ids:{any}
):()
参数
faceId:number
ids:{any}
返回
()

SetFaceUVs
功能: DynamicGeneration
EditableMesh:SetFaceUVs(
faceId:number, ids:{any}
):()
参数
faceId:number
ids:{any}
返回
()

SetFaceVertices
功能: DynamicGeneration
EditableMesh:SetFaceVertices(
faceId:number, ids:{any}
):()
参数
faceId:number
ids:{any}
返回
()

SetFacsBonePose
功能: DynamicGeneration
EditableMesh:SetFacsBonePose(
action:Enum.FacsActionUnit, boneId:number, cframe:CFrame
):()
参数
boneId:number
cframe:CFrame
返回
()

SetFacsCorrectivePose
功能: DynamicGeneration
EditableMesh:SetFacsCorrectivePose(
actions:{any}, boneIds:{any}, cframes:{any}
):()
参数
actions:{any}
boneIds:{any}
cframes:{any}
返回
()

SetFacsPose
功能: DynamicGeneration
EditableMesh:SetFacsPose(
action:Enum.FacsActionUnit, boneIds:{any}, cframes:{any}
):()
参数
boneIds:{any}
cframes:{any}
返回
()

SetNormal
功能: DynamicGeneration
EditableMesh:SetNormal(
normalId:number, normal:Vector3
):()
参数
normalId:number
normal:Vector3
返回
()

SetPosition
功能: DynamicGeneration
EditableMesh:SetPosition(
vertexId:number, p:Vector3
):()
参数
vertexId:number
返回
()

SetUV
功能: DynamicGeneration
EditableMesh:SetUV(
uvId:number, uv:Vector2
):()
参数
uvId:number
返回
()

SetVertexBones
功能: DynamicGeneration
EditableMesh:SetVertexBones(
vertexId:number, boneIDs:{any}
):()
参数
vertexId:number
boneIDs:{any}
返回
()

SetVertexBoneWeights
功能: DynamicGeneration
EditableMesh:SetVertexBoneWeights(
vertexId:number, boneWeights:{any}
):()
参数
vertexId:number
boneWeights:{any}
返回
()

SetVertexFaceColor
功能: DynamicGeneration
EditableMesh:SetVertexFaceColor(
vertexId:number, faceId:number, colorId:number
):()
参数
vertexId:number
faceId:number
colorId:number
返回
()

SetVertexFaceNormal
功能: DynamicGeneration
EditableMesh:SetVertexFaceNormal(
vertexId:number, faceId:number, normalId:number
):()
参数
vertexId:number
faceId:number
normalId:number
返回
()

SetVertexFaceUV
功能: DynamicGeneration
EditableMesh:SetVertexFaceUV(
vertexId:number, faceId:number, uvId:number
):()
参数
vertexId:number
faceId:number
uvId:number
返回
()

Triangulate
功能: DynamicGeneration
EditableMesh:Triangulate():()
返回
()

©2026 Roblox Corporation、Roblox、Roblox 标志及 Powering Imagination 是我们在美国及其他国家或地区的注册与未注册商标。