Aprenda
Classe do mecanismo
EditableMesh
Não criável

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.


Resumo
Propriedades
Métodos
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):()
Membros herdados

Referência API
Propriedades
FixedSize
Somente leitura
Não replicado
Segurança Roblox
Ler Parallel
Recursos: DynamicGeneration
EditableMesh.FixedSize:boolean

Métodos
AddBone
Recursos: DynamicGeneration
EditableMesh:AddBone(boneProperties:Dictionary):number
Parâmetros
boneProperties:Dictionary
Devolução

AddColor
Recursos: DynamicGeneration
EditableMesh:AddColor(
color:Color3, alpha:number
Parâmetros
color:Color3
alpha:number
Devolução

AddNormal
Recursos: DynamicGeneration
EditableMesh:AddNormal(normal:Vector3?):number
Parâmetros
normal:Vector3?
Devolução

AddTriangle
Recursos: DynamicGeneration
EditableMesh:AddTriangle(
vertexId0:number, vertexId1:number, vertexId2:number
Parâmetros
vertexId0:number
vertexId1:number
vertexId2:number
Devolução

AddUV
Recursos: DynamicGeneration
EditableMesh:AddUV(uv:Vector2):number
Parâmetros
Devolução

AddVertex
Recursos: DynamicGeneration
EditableMesh:AddVertex(p:Vector3):number
Parâmetros
Devolução

Destroy
Recursos: DynamicGeneration
EditableMesh:Destroy():()
Devolução
()

FindClosestPointOnSurface
Recursos: DynamicGeneration
EditableMesh:FindClosestPointOnSurface(point:Vector3):Tuple
Parâmetros
point:Vector3
Devolução

FindClosestVertex
Recursos: DynamicGeneration
EditableMesh:FindClosestVertex(toThisPoint:Vector3):number
Parâmetros
toThisPoint:Vector3
Devolução

FindVerticesWithinSphere
Recursos: DynamicGeneration
EditableMesh:FindVerticesWithinSphere(
center:Vector3, radius:number
Parâmetros
center:Vector3
radius:number
Devolução

GetAdjacentFaces
Recursos: DynamicGeneration
EditableMesh:GetAdjacentFaces(faceId:number):{any}
Parâmetros
faceId:number
Devolução

GetAdjacentVertices
Recursos: DynamicGeneration
EditableMesh:GetAdjacentVertices(vertexId:number):{any}
Parâmetros
vertexId:number
Devolução

GetBoneByName
Recursos: DynamicGeneration
EditableMesh:GetBoneByName(boneName:string):number
Parâmetros
boneName:string
Devolução

GetBoneCFrame
Recursos: DynamicGeneration
EditableMesh:GetBoneCFrame(boneId:number):CFrame
Parâmetros
boneId:number
Devolução

GetBoneIsVirtual
Recursos: DynamicGeneration
EditableMesh:GetBoneIsVirtual(boneId:number):boolean
Parâmetros
boneId:number
Devolução

GetBoneName
Recursos: DynamicGeneration
EditableMesh:GetBoneName(boneId:number):string
Parâmetros
boneId:number
Devolução

GetBoneParent
Recursos: DynamicGeneration
EditableMesh:GetBoneParent(boneId:number):number
Parâmetros
boneId:number
Devolução

GetBones
Recursos: DynamicGeneration
EditableMesh:GetBones():{any}
Devolução

GetCenter
Recursos: DynamicGeneration
EditableMesh:GetCenter():Vector3
Devolução

GetColor
Recursos: DynamicGeneration
EditableMesh:GetColor(colorId:number):Color3?
Parâmetros
colorId:number
Devolução

GetColorAlpha
Recursos: DynamicGeneration
EditableMesh:GetColorAlpha(colorId:number):number?
Parâmetros
colorId:number
Devolução

GetColors
Recursos: DynamicGeneration
EditableMesh:GetColors():{any}
Devolução

GetFaceColors
Recursos: DynamicGeneration
EditableMesh:GetFaceColors(faceId:number):{any}
Parâmetros
faceId:number
Devolução

GetFaceNormals
Recursos: DynamicGeneration
EditableMesh:GetFaceNormals(faceId:number):{any}
Parâmetros
faceId:number
Devolução

GetFaces
Recursos: DynamicGeneration
EditableMesh:GetFaces():{any}
Devolução

GetFacesWithAttribute
Obsoleto

GetFacesWithColor
Recursos: DynamicGeneration
EditableMesh:GetFacesWithColor(colorId:number):{any}
Parâmetros
colorId:number
Devolução

GetFacesWithNormal
Recursos: DynamicGeneration
EditableMesh:GetFacesWithNormal(normalId:number):{any}
Parâmetros
normalId:number
Devolução

GetFacesWithUV
Recursos: DynamicGeneration
EditableMesh:GetFacesWithUV(uvId:number):{any}
Parâmetros
uvId:number
Devolução

GetFaceUVs
Recursos: DynamicGeneration
EditableMesh:GetFaceUVs(faceId:number):{any}
Parâmetros
faceId:number
Devolução

GetFaceVertices
Recursos: DynamicGeneration
EditableMesh:GetFaceVertices(faceId:number):{any}
Parâmetros
faceId:number
Devolução

GetFacsCorrectivePose
Recursos: DynamicGeneration
EditableMesh:GetFacsCorrectivePose(actions:{any}):Tuple
Parâmetros
actions:{any}
Devolução

GetFacsCorrectivePoses
Recursos: DynamicGeneration
EditableMesh:GetFacsCorrectivePoses():{any}
Devolução

GetFacsPose
Recursos: DynamicGeneration
EditableMesh:GetFacsPose(action:Enum.FacsActionUnit):Tuple
Parâmetros
Devolução

GetFacsPoses
Recursos: DynamicGeneration
EditableMesh:GetFacsPoses():{any}
Devolução

GetNormal
Recursos: DynamicGeneration
EditableMesh:GetNormal(normalId:number):Vector3?
Parâmetros
normalId:number
Devolução

GetNormals
Recursos: DynamicGeneration
EditableMesh:GetNormals():{any}
Devolução

GetPosition
Recursos: DynamicGeneration
EditableMesh:GetPosition(vertexId:number):Vector3
Parâmetros
vertexId:number
Devolução

GetSize
Recursos: DynamicGeneration
EditableMesh:GetSize():Vector3
Devolução

GetUV
Recursos: DynamicGeneration
EditableMesh:GetUV(uvId:number):Vector2?
Parâmetros
uvId:number
Devolução

GetUVs
Recursos: DynamicGeneration
EditableMesh:GetUVs():{any}
Devolução

GetVertexBones
Recursos: DynamicGeneration
EditableMesh:GetVertexBones(vertexId:number):{any}
Parâmetros
vertexId:number
Devolução

GetVertexBoneWeights
Recursos: DynamicGeneration
EditableMesh:GetVertexBoneWeights(vertexId:number):{any}
Parâmetros
vertexId:number
Devolução

GetVertexColors
Recursos: DynamicGeneration
EditableMesh:GetVertexColors(vertexId:number):{any}
Parâmetros
vertexId:number
Devolução

GetVertexFaceColor
Recursos: DynamicGeneration
EditableMesh:GetVertexFaceColor(
vertexId:number, faceId:number
Parâmetros
vertexId:number
faceId:number
Devolução

GetVertexFaceNormal
Recursos: DynamicGeneration
EditableMesh:GetVertexFaceNormal(
vertexId:number, faceId:number
Parâmetros
vertexId:number
faceId:number
Devolução

GetVertexFaces
Recursos: DynamicGeneration
EditableMesh:GetVertexFaces(vertexId:number):{any}
Parâmetros
vertexId:number
Devolução

GetVertexFaceUV
Recursos: DynamicGeneration
EditableMesh:GetVertexFaceUV(
vertexId:number, faceId:number
Parâmetros
vertexId:number
faceId:number
Devolução

GetVertexNormals
Recursos: DynamicGeneration
EditableMesh:GetVertexNormals(vertexId:number):{any}
Parâmetros
vertexId:number
Devolução

GetVertexUVs
Recursos: DynamicGeneration
EditableMesh:GetVertexUVs(vertexId:number):{any}
Parâmetros
vertexId:number
Devolução

GetVertices
Recursos: DynamicGeneration
EditableMesh:GetVertices():{any}
Devolução

GetVerticesWithAttribute
Obsoleto

GetVerticesWithColor
Recursos: DynamicGeneration
EditableMesh:GetVerticesWithColor(colorId:number):{any}
Parâmetros
colorId:number
Devolução

GetVerticesWithNormal
Recursos: DynamicGeneration
EditableMesh:GetVerticesWithNormal(normalId:number):{any}
Parâmetros
normalId:number
Devolução

GetVerticesWithUV
Recursos: DynamicGeneration
EditableMesh:GetVerticesWithUV(uvId:number):{any}
Parâmetros
uvId:number
Devolução

IdDebugString
Recursos: DynamicGeneration
EditableMesh:IdDebugString(id:number):string
Parâmetros
Devolução

MergeVertices
Recursos: DynamicGeneration
EditableMesh:MergeVertices(mergeTolerance:number):Map
Parâmetros
mergeTolerance:number
Devolução
Map

RaycastLocal
Recursos: DynamicGeneration
EditableMesh:RaycastLocal(
origin:Vector3, direction:Vector3
Parâmetros
origin:Vector3
direction:Vector3
Devolução
Amostras de código
EditableMesh:RaycastLocal()
local AssetService = game:GetService("AssetService")
local Workspace = game:GetService("Workspace")
-- Inicializa EditableMesh no espaço
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
-- Função que irá lançar um raio do ponto dado, retornando o ponto no mundo do impacto e a coordenada UV
local function castRayFromCamera(meshPart: MeshPart, editableMesh: EditableMesh, viewportPoint: Vector3)
if not meshPart then
return
end
-- Calcula quanto o objeto está sendo escalado em cada dimensão
local renderScale = meshPart.Size / meshPart.MeshSize
-- Cria um raio a partir da câmera na direção do ponto clicado
local ray = Workspace.CurrentCamera:ViewportPointToRay(viewportPoint.X, viewportPoint.Y)
-- Converte para o espaço do objeto para usar com 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
-- Não acertou nenhuma face
return
end
-- Computa o ponto de impacto no espaço do mundo
local worldHitPoint = meshPart.CFrame:PointToWorldSpace(point * renderScale)
-- Obtém as UVs na face
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)
-- Interpola as UVs dentro da face com base na coordenada baricêntrica
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
Recursos: DynamicGeneration
EditableMesh:RemoveBone(boneId:number):()
Parâmetros
boneId:number
Devolução
()

RemoveFace
Recursos: DynamicGeneration
EditableMesh:RemoveFace(faceId:number):()
Parâmetros
faceId:number
Devolução
()

RemoveUnused
Recursos: DynamicGeneration
EditableMesh:RemoveUnused():{any}
Devolução

ResetNormal
Recursos: DynamicGeneration
EditableMesh:ResetNormal(normalId:number):()
Parâmetros
normalId:number
Devolução
()

SetBoneCFrame
Recursos: DynamicGeneration
EditableMesh:SetBoneCFrame(
boneId:number, cframe:CFrame
):()
Parâmetros
boneId:number
cframe:CFrame
Devolução
()

SetBoneIsVirtual
Recursos: DynamicGeneration
EditableMesh:SetBoneIsVirtual(
boneId:number, virtual:boolean
):()
Parâmetros
boneId:number
virtual:boolean
Devolução
()

SetBoneName
Recursos: DynamicGeneration
EditableMesh:SetBoneName(
boneId:number, name:string
):()
Parâmetros
boneId:number
name:string
Devolução
()

SetBoneParent
Recursos: DynamicGeneration
EditableMesh:SetBoneParent(
boneId:number, parentBoneId:number
):()
Parâmetros
boneId:number
parentBoneId:number
Devolução
()

SetColor
Recursos: DynamicGeneration
EditableMesh:SetColor(
colorId:number, color:Color3
):()
Parâmetros
colorId:number
color:Color3
Devolução
()

SetColorAlpha
Recursos: DynamicGeneration
EditableMesh:SetColorAlpha(
colorId:number, alpha:number
):()
Parâmetros
colorId:number
alpha:number
Devolução
()

SetFaceColors
Recursos: DynamicGeneration
EditableMesh:SetFaceColors(
faceId:number, ids:{any}
):()
Parâmetros
faceId:number
ids:{any}
Devolução
()

SetFaceNormals
Recursos: DynamicGeneration
EditableMesh:SetFaceNormals(
faceId:number, ids:{any}
):()
Parâmetros
faceId:number
ids:{any}
Devolução
()

SetFaceUVs
Recursos: DynamicGeneration
EditableMesh:SetFaceUVs(
faceId:number, ids:{any}
):()
Parâmetros
faceId:number
ids:{any}
Devolução
()

SetFaceVertices
Recursos: DynamicGeneration
EditableMesh:SetFaceVertices(
faceId:number, ids:{any}
):()
Parâmetros
faceId:number
ids:{any}
Devolução
()

SetFacsBonePose
Recursos: DynamicGeneration
EditableMesh:SetFacsBonePose(
action:Enum.FacsActionUnit, boneId:number, cframe:CFrame
):()
Parâmetros
boneId:number
cframe:CFrame
Devolução
()

SetFacsCorrectivePose
Recursos: DynamicGeneration
EditableMesh:SetFacsCorrectivePose(
actions:{any}, boneIds:{any}, cframes:{any}
):()
Parâmetros
actions:{any}
boneIds:{any}
cframes:{any}
Devolução
()

SetFacsPose
Recursos: DynamicGeneration
EditableMesh:SetFacsPose(
action:Enum.FacsActionUnit, boneIds:{any}, cframes:{any}
):()
Parâmetros
boneIds:{any}
cframes:{any}
Devolução
()

SetNormal
Recursos: DynamicGeneration
EditableMesh:SetNormal(
normalId:number, normal:Vector3
):()
Parâmetros
normalId:number
normal:Vector3
Devolução
()

SetPosition
Recursos: DynamicGeneration
EditableMesh:SetPosition(
vertexId:number, p:Vector3
):()
Parâmetros
vertexId:number
Devolução
()

SetUV
Recursos: DynamicGeneration
EditableMesh:SetUV(
uvId:number, uv:Vector2
):()
Parâmetros
uvId:number
Devolução
()

SetVertexBones
Recursos: DynamicGeneration
EditableMesh:SetVertexBones(
vertexId:number, boneIDs:{any}
):()
Parâmetros
vertexId:number
boneIDs:{any}
Devolução
()

SetVertexBoneWeights
Recursos: DynamicGeneration
EditableMesh:SetVertexBoneWeights(
vertexId:number, boneWeights:{any}
):()
Parâmetros
vertexId:number
boneWeights:{any}
Devolução
()

SetVertexFaceColor
Recursos: DynamicGeneration
EditableMesh:SetVertexFaceColor(
vertexId:number, faceId:number, colorId:number
):()
Parâmetros
vertexId:number
faceId:number
colorId:number
Devolução
()

SetVertexFaceNormal
Recursos: DynamicGeneration
EditableMesh:SetVertexFaceNormal(
vertexId:number, faceId:number, normalId:number
):()
Parâmetros
vertexId:number
faceId:number
normalId:number
Devolução
()

SetVertexFaceUV
Recursos: DynamicGeneration
EditableMesh:SetVertexFaceUV(
vertexId:number, faceId:number, uvId:number
):()
Parâmetros
vertexId:number
faceId:number
uvId:number
Devolução
()

Triangulate
Recursos: DynamicGeneration
EditableMesh:Triangulate():()
Devolução
()

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.