UIGradient 对父级 GuiObject 渲染的 UI 元素应用颜色和透明度渐变。渐变的外观可通过其 Color ( ColorSequence ), Transparency ( NumberSequence ), Offset ( Vector2 ), 和 Rotation (number) 来配置。
一个 UIGradient 不会适用于子孙或后代 GuiObjects 。为了将相同的渐变应用到多个对象,您需要多个渐变实例。
还请参阅外观修改器以获取有关UIGradient及其工作方式的更多信息。
支持的对象
你可以将渐变应用到 Frame , TextLabel , TextButton , ImageLabel , ImageButton , 和 ViewportFrame .然而, ScrollingFrame 和 TextBox 目前不支持。
性能考虑
为了有效使用 UIGradient,请遵循以下原则:
避免在 Color 顺序上使用超过 6 个颜色停止。
避免在任何应用文本轮廓的对象上使用 ,因为渐变将尝试与线条和边界融合,可能会导致性能问题。
避免设置 Color 和 Transparency 频繁:这会导致颜色序列经常重建,这很昂贵。如果可能,只设置这些属性一次,并尝试动画 Offset 或 Rotation 属性来实现类似效果。或者,您可以使用 、 或 等属性来更改父级的颜色。
当在 UI 元素上应用不改变的渐变时,其状态发生了大量变化,需要权衡使用 UIGradient (处理时间) 和静态渐变图像 (内存) 之间的关系。
概要
属性
决定渐变长度上与父级 GuiObject 混合的颜色。
是否启用渐变或不。
决定从父 GuiObject 中心的渐变翻译。
确定从左到右开始的渐变的时钟旋转度。
决定父级 GuiObject 在渐变长度上可以被看到的程度。
属性
Color
此属性描述与提供的 ColorSequence 沿路融合的父级 UI 元素的颜色。该属性的工作方式类似于 Beam.Color 或 Trail.Color ,但它适用于由 Offset 和 Rotation 决定的屏幕距离。
Offset
该属性决定从父辈 GuiObject 的中心转换渐变的乘积。它是一个单值转换,意味着实际像素偏移由父 AbsoluteSize 的 GuiObject 决定。因此,值 (1, 0) 将向右移动渐变的距离,等于父对象在屏幕上的尺寸。根据 Rotation ,这可能导致渐变部分可见或全部不可见。
还看到 Rotation 这也会影响应用的渐变的几何形状。
Transparency
该属性描述了父UI元素在提供的NumberSequence中会有多不透明。该属性的工作方式类似于 Beam.Transparency 或 Trail.Transparency ,但它适用于由 Offset 和 Rotation 决定的屏幕距离。
请注意, NumberSequenceKeypoints 的信封值被忽略。