学习
引擎类
Decal

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


代码示例
更改贴花纹理
-- 创建部件
local part = Instance.new("Part")
part.Size = Vector3.new(5, 1, 5)
part.Position = Vector3.new(0, 0.5, 0)
part.Anchored = true
part.TopSurface = Enum.SurfaceType.Smooth
part.BrickColor = BrickColor.new("Toothpaste")
-- 创建贴花
local decal = Instance.new("Decal")
decal.Face = Enum.NormalId.Top
decal.Parent = part
-- 定义面
local happyFace = Content.fromUri("http://www.roblox.com/asset/?id=26424652")
local sadFace = Content.fromUri("http://www.roblox.com/asset/?id=147144198")
decal.ColorMapContent = happyFace
-- 碰撞事件
local cooldown = false
part.Touched:Connect(function(hit)
if not cooldown then
if hit and hit.Parent then
cooldown = true
sound:Play()
decal.ColorMapContent = sadFace
task.wait(1)
decal.ColorMapContent = happyFace
task.wait(0.2)
cooldown = false
end
end
end)
-- 添加到工作区
part.Parent = workspace
渐变贴图
local TweenService = game:GetService("TweenService")
local part = Instance.new("Part")
part.Size = Vector3.new(10, 10, 1)
part.Position = Vector3.new(0, 5, 0)
part.Anchored = true
part.Transparency = 1
local decal = Instance.new("Decal")
decal.Face = Enum.NormalId.Front
decal.ColorMapContent = Content.fromUri("http://www.roblox.com/asset/?id=699259085") -- roblox logo
decal.Parent = part
part.Parent = workspace
local tween = TweenService:Create(
decal,
TweenInfo.new(1, Enum.EasingStyle.Linear, Enum.EasingDirection.Out, -1, true),
{ Transparency = 1 }
)
tween:Play()

API 参考
属性
Color3
读取并联
功能: Basic
Decal.Color3:Color3
代码示例
贴图颜色
local TweenService = game:GetService("TweenService")
local part = Instance.new("Part")
part.Size = Vector3.new(10, 10, 1)
part.Position = Vector3.new(0, 5, 0)
part.Anchored = true
part.Transparency = 1
local decal = Instance.new("Decal")
decal.Face = Enum.NormalId.Front
decal.ColorMapContent = Content.fromUri("http://www.roblox.com/asset/?id=1145367640")
decal.Parent = part
part.Parent = workspace
local redTween = TweenService:Create(
decal,
TweenInfo.new(1, Enum.EasingStyle.Linear, Enum.EasingDirection.Out),
{ Color3 = Color3.new(1, 0, 0) }
)
local greenTween = TweenService:Create(
decal,
TweenInfo.new(1, Enum.EasingStyle.Linear, Enum.EasingDirection.Out),
{ Color3 = Color3.new(0, 1, 0) }
)
local blueTween = TweenService:Create(
decal,
TweenInfo.new(1, Enum.EasingStyle.Linear, Enum.EasingDirection.Out),
{ Color3 = Color3.new(0, 0, 1) }
)
while true do
redTween:Play()
redTween.Completed:Wait()
greenTween:Play()
greenTween.Completed:Wait()
blueTween:Play()
blueTween.Completed:Wait()
end

ColorMap
未复制
读取并联
功能: Basic
Decal.ColorMap:ContentId

ColorMapContent
未复制
读取并联
功能: Basic
Decal.ColorMapContent:Content

LocalTransparencyModifier
隐藏
未复制
读取并联
功能: Basic
Decal.LocalTransparencyModifier:number

MetalnessMap
隐藏
插件安全性
读取并联
功能: Basic
Decal.MetalnessMap:ContentId

MetalnessMapContent
插件安全性
读取并联
功能: Basic
Decal.MetalnessMapContent:Content

NormalMap
隐藏
插件安全性
读取并联
功能: Basic
Decal.NormalMap:ContentId

NormalMapContent
插件安全性
读取并联
功能: Basic
Decal.NormalMapContent:Content

Rotation
读取并联
功能: Basic
Decal.Rotation:number

RoughnessMap
隐藏
插件安全性
读取并联
功能: Basic
Decal.RoughnessMap:ContentId

RoughnessMapContent
插件安全性
读取并联
功能: Basic
Decal.RoughnessMapContent:Content

Shiny
已弃用

Specular
已弃用

Texture
已弃用

TextureContent
已弃用

TexturePack
Roblox 安全性
读取并联
功能: Basic
Decal.TexturePack:ContentId

Transparency
读取并联
功能: Basic
Decal.Transparency:number

UVOffset
读取并联
功能: Basic
Decal.UVOffset:Vector2

UVScale
读取并联
功能: Basic
Decal.UVScale:Vector2

ZIndex
读取并联
功能: Basic
Decal.ZIndex:number

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