學習
引擎類別
EditableMesh
無法建立

*此內容是使用 AI(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
返回
範例程式碼
可編輯網格:RaycastLocal()
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 是我們在美國及其他國家地區的部分註冊與未註冊商標。