SpecialMesh

显示已弃用

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

Class.SpecialMesh 对象将网格应用到一个 BasePart 依赖于 MeshType 属性。有多个选项可用。

砖块 - 块状形，相当于一个 BlockMesh
气缸 - 一个气缸，与 Part 的一个 Part.Shape 的“气缸”相同
文件网格 - 用户上传了网格，相当于 FileMesh ，可以应用到使用 FileMesh.TextureId 属性的材质
头 - 角色头形
球体 - 一个球体形状，与 Part 类似，但可以在所有轴上自由缩放
楔子 - 楔子形状，与 WedgePart 相同
躯干 - 有斜面的方块，由于其将被弃用

注意，使用 DataModelMesh.Scale 时，每个 DataModelMesh.Scale 的大小都会随着使用 1> Class.DataModelMesh.Scale1> 而变化，有关更多信息，请参阅4> Class.DataModelMesh.Scale4> 页面。对于特殊网格对象，还会暴露7> Class.DataModelMesh.Offset7> 属性

要记住，使用特殊网格时，只有部件的外观发生变更。网格的碰撞模型将保持不变。例如，一个角色将无法正确地走过网格，因为网格的几何学不会被考帐户。

SpecialMesh vs MeshPart

目前有两种使用开发者创建网格的方法。他们使用一个特殊网格，其中 SpecialMesh.FileType 设置为 "FileMesh"，或使用 MeshPart 。尽管如此，在整个开发者创建网格上， MeshPart 对象有一些差异，开发者应该注意到。

BasePart.Material 在使用 MeshPart 和不使用特殊网格时正确显示在网格上
MeshParts 包括MeshPart.CollisionFidelity 属性，意味着MeshPart 的碰撞模型可以设置为与网格相似。但是，特殊网格对象通过对父对象0> Class.BasePart|BaseParts0> 的碰撞模型来使用
Class.MeshPart 的网格在所有轴上依赖于 Size 属性，MeshPart 的网格是 1>SpecialMesh1> 的网格，不是 4>Class.MeshPart4> 的网格
特殊网格对象包括 Offset 和 Scale 属性，而 MeshParts 不
Class.FileMesh.MeshId|MeshId 属性的 SpecialMesh 可以通过在执行时间时更改 Script 或 1>Class.LocalScript1> 来改变。4>Class.MeshPart.MeshId|MeshId4> 属性的 7>Class.MeshPart7> 无法。

代码示例

In this code sample a BasePart is instanced with a SpecialMesh. The DataModelMesh.Scale and DataModelMesh.Offset properties of the SpecialMesh are then animated using TweenService.

Mesh Offset and Scale

local TweenService = game:GetService("TweenService")

-- instance a part and a mesh
local part = Instance.new("Part")
part.Size = Vector3.new(4, 8, 4)
part.Position = Vector3.new(0, 4, 0)
part.Anchored = true
part.CanCollide = false

local mesh = Instance.new("SpecialMesh")
mesh.MeshType = Enum.MeshType.FileMesh
mesh.MeshId = "rbxassetid://1086413449"
mesh.TextureId = "rbxassetid://1461576423"
mesh.Offset = Vector3.new(0, 0, 0)
mesh.Scale = Vector3.new(4, 4, 4)
mesh.Parent = part

-- selection box to show part extents
local box = Instance.new("SelectionBox")
box.Adornee = part
box.Parent = part

-- parent part to workspace
part.Parent = workspace

-- animate offset and scale with a tween
local tween = TweenService:Create(
	mesh,
	TweenInfo.new(1, Enum.EasingStyle.Linear, Enum.EasingDirection.Out, -1, true, 0),
	{ Scale = Vector3.new(1, 1, 1), Offset = Vector3.new(0, 3, 0) }
)

tween:Play()

In this code sample a BasePart is instanced with a SpecialMesh. The DataModelMesh.VertexColor property of the SpecialMesh is then animated using TweenService.

Mesh VertexColor

local TweenService = game:GetService("TweenService")

-- instance a part and a mesh
local part = Instance.new("Part")
part.Size = Vector3.new(4, 8, 4)
part.Position = Vector3.new(0, 4, 0)
part.Anchored = true
part.CanCollide = false

local mesh = Instance.new("SpecialMesh")
mesh.MeshType = Enum.MeshType.FileMesh
mesh.MeshId = "rbxassetid://1086413449"
mesh.TextureId = "rbxassetid://1461576423"
mesh.Offset = Vector3.new(0, 0, 0)
mesh.Scale = Vector3.new(4, 4, 4)
mesh.VertexColor = Vector3.new(1, 1, 1)
mesh.Parent = part

-- parent part to workspace
part.Parent = workspace

-- create tweens
local tweenInfo = TweenInfo.new(1, Enum.EasingStyle.Linear, Enum.EasingDirection.Out)
local blackTween = TweenService:Create(mesh, tweenInfo, { VertexColor = Vector3.new(0, 0, 0) })
local redTween = TweenService:Create(mesh, tweenInfo, { VertexColor = Vector3.new(1, 0, 0) })
local greenTween = TweenService:Create(mesh, tweenInfo, { VertexColor = Vector3.new(0, 1, 0) })
local blueTween = TweenService:Create(mesh, tweenInfo, { VertexColor = Vector3.new(0, 0, 1) })
local resetTween = TweenService:Create(mesh, tweenInfo, { VertexColor = Vector3.new(1, 1, 1) })

-- animate
while true do
	blackTween:Play()
	blackTween.Completed:Wait()
	redTween:Play()
	redTween.Completed:Wait()
	greenTween:Play()
	greenTween.Completed:Wait()
	blueTween:Play()
	blueTween.Completed:Wait()
	resetTween:Play()
	resetTween.Completed:Wait()
	task.wait()
end

概要

属性

MeshType:Enum.MeshType
读取并联
确定类型的网格将被应用到 BasePart 的 SpecialMesh 是父级。

继承自FileMesh的属性

MeshId:ContentId
读取并联
MeshId 是要显示的网格内容的 ID。
TextureId:ContentId
读取并联
TexturereId 是要应用到网格的材质的内容 ID。

继承自DataModelMesh的属性

Offset:Vector3
读取并联
网格的 Offset 决定了网格在 BasePart.Position 的 BasePart 上显示的相对位置。
Scale:Vector3
读取并联
网格的尺寸由网格的原始尺寸决定。
VertexColor:Vector3
读取并联
改变网格的材质的纹理，用于 FileMesh.TextureId 。

查看继承自 Instance 的全部

查看继承自 Object 的全部

方法

查看继承自 Instance 的全部

查看继承自 Object 的全部

活动

查看继承自 Instance 的全部

查看继承自 Object 的全部

属性

MeshType

Enum.MeshType

读取并联

Class.SpecialMesh 对象应用到 BasePart 的网格取决于 MeshType 属性。有一些选项可用。

砖块 - 块状形，相当于一个 BlockMesh
气缸 - 一个气缸，与 Part 的一个 Part.Shape 的“气缸”相同
文件网格 - 用户上传了网格，相当于 FileMesh ，可以应用到使用 FileMesh.TextureId 属性的材质
头 - 角色头形
球体 - 一个球体形状，与 Part 类似，但可以在所有轴上自由缩放
楔子 - 楔子形状，与 WedgePart 相同
躯干 - 有斜面的方块，由于其将被弃用

注意，使用 DataModelMesh.Scale 时，每个 MeshType 的大小都会随着使用情况而略有不同，有关更多信息，请参阅 DataModelMesh.Scale 页面。

代码示例

In this code sample a BasePart is instanced with a SpecialMesh. The DataModelMesh.VertexColor property of the SpecialMesh is then animated using TweenService.

Mesh VertexColor

local TweenService = game:GetService("TweenService")

-- instance a part and a mesh
local part = Instance.new("Part")
part.Size = Vector3.new(4, 8, 4)
part.Position = Vector3.new(0, 4, 0)
part.Anchored = true
part.CanCollide = false

local mesh = Instance.new("SpecialMesh")
mesh.MeshType = Enum.MeshType.FileMesh
mesh.MeshId = "rbxassetid://1086413449"
mesh.TextureId = "rbxassetid://1461576423"
mesh.Offset = Vector3.new(0, 0, 0)
mesh.Scale = Vector3.new(4, 4, 4)
mesh.VertexColor = Vector3.new(1, 1, 1)
mesh.Parent = part

-- parent part to workspace
part.Parent = workspace

-- create tweens
local tweenInfo = TweenInfo.new(1, Enum.EasingStyle.Linear, Enum.EasingDirection.Out)
local blackTween = TweenService:Create(mesh, tweenInfo, { VertexColor = Vector3.new(0, 0, 0) })
local redTween = TweenService:Create(mesh, tweenInfo, { VertexColor = Vector3.new(1, 0, 0) })
local greenTween = TweenService:Create(mesh, tweenInfo, { VertexColor = Vector3.new(0, 1, 0) })
local blueTween = TweenService:Create(mesh, tweenInfo, { VertexColor = Vector3.new(0, 0, 1) })
local resetTween = TweenService:Create(mesh, tweenInfo, { VertexColor = Vector3.new(1, 1, 1) })

-- animate
while true do
	blackTween:Play()
	blackTween.Completed:Wait()
	redTween:Play()
	redTween.Completed:Wait()
	greenTween:Play()
	greenTween.Completed:Wait()
	blueTween:Play()
	blueTween.Completed:Wait()
	resetTween:Play()
	resetTween.Completed:Wait()
	task.wait()
end