UIGradient

显示已弃用

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

UIGradient 对父级 GuiObject 渲染的 UI 元素应用颜色和透明度渐变。渐变的外观可通过其 Color ( ColorSequence ), Transparency ( NumberSequence ), Offset ( Vector2 ), 和 Rotation (number) 来配置。

一个 UIGradient 不会适用于子孙或后代 GuiObjects 。为了将相同的渐变应用到多个对象,您需要多个渐变实例。

还请参阅外观修改器以获取有关UIGradient及其工作方式的更多信息。

支持的对象

你可以将渐变应用到 Frame , TextLabel , TextButton , ImageLabel , ImageButton , 和 ViewportFrame .然而, ScrollingFrameTextBox 目前不支持。

性能考虑

为了有效使用 UIGradient,请遵循以下原则:

  • 避免在 Color 顺序上使用超过 6 个颜色停止。

  • 避免在任何应用文本轮廓的对象上使用 ,因为渐变将尝试与线条和边界融合,可能会导致性能问题。

  • 避免设置 ColorTransparency 频繁:这会导致颜色序列经常重建,这很昂贵。如果可能,只设置这些属性一次,并尝试动画 OffsetRotation 属性来实现类似效果。或者,您可以使用 、 或 等属性来更改父级的颜色。

  • 当在 UI 元素上应用不改变的渐变时,其状态发生了大量变化,需要权衡使用 UIGradient (处理时间) 和静态渐变图像 (内存) 之间的关系。

概要

属性

属性

读取并联

此属性描述与提供的 ColorSequence 沿路融合的父级 UI 元素的颜色。该属性的工作方式类似于 Beam.ColorTrail.Color ,但它适用于由 OffsetRotation 决定的屏幕距离。

Enabled

读取并联

是否启用渐变或不。

Offset

读取并联

该属性决定从父辈 GuiObject 的中心转换渐变的乘积。它是一个单值转换,意味着实际像素偏移由父 AbsoluteSizeGuiObject 决定。因此,值 (1, 0) 将向右移动渐变的距离,等于父对象在屏幕上的尺寸。根据 Rotation ,这可能导致渐变部分可见或全部不可见。

还看到 Rotation 这也会影响应用的渐变的几何形状。

Rotation

读取并联

该属性决定从左到右开始的 顺时针旋转 度在度数上。开始和结束控制点捕捉到父GuiObject的边缘,但保持提供的旋转。

还看到 Offset 这也会影响应用的渐变的几何形状。

Transparency

读取并联

该属性描述了父UI元素在提供的NumberSequence中会有多不透明。该属性的工作方式类似于 Beam.TransparencyTrail.Transparency ,但它适用于由 OffsetRotation 决定的屏幕距离。

请注意, NumberSequenceKeypoints 的信封值被忽略。

方法

活动