UI 外观修饰符

通过利用 外观修饰符，您可以进一步自定义您的 GuiObjects 的外观。

• 为对象的背景应用 渐变。
• 为文本或边框应用 描边。
• 为对象设置 圆角。
• 增加对象边框之间的 内边距。
• 在对象后面添加 阴影。

渐变

UIGradient 对象将颜色和透明度渐变应用于其父 GuiObject。

您可以通过以下方式配置渐变：

• 通过渐变的 Color 属性中的 ColorSequence 设置其 颜色。
• 通过渐变的 Transparency 属性中的 NumberSequence 设置其 透明度。
• 通过 Type 属性选择渐变的 类型。
• 通过 Offset 属性选择渐变的 起始点（在父边界内或外）。
• 通过 Rotation 属性选择渐变的 角度。
• 通过 Scale 属性选择渐变的 缩放。
• 通过 TileMode 属性选择渐变的 边缘采样 行为。

颜色序列

要设置渐变的颜色序列：

1. 在 资源管理器 窗口中，选择 UIGradient。

2. 在 属性 窗口中，单击 Color 属性字段内，然后单击输入框右侧的 ⋯ 按钮。

   

3. 颜色序列底部轴上的每个三角形都是一个 关键点，确定该点的颜色值。

   

   1. 单击颜色序列中的关键点以选择或重新定位它，或通过单击图表上的任何位置添加另一个关键点。
   2. 单击 颜色 旁边的小方块以打开 颜色 弹出窗口，然后选择所需的关键点颜色。
   3. 如有需要，重复这些步骤以在图表上添加/调整颜色。

透明度

要调整渐变在其范围内的透明度：

1. 在 资源管理器 窗口中，选择 UIGradient。

2. 在 属性 窗口中，单击 Transparency 属性字段内，然后单击输入框右侧的 ⋯ 按钮。

   

3. 数字序列图表上的每个方块都是一个 关键点，确定该点的透明度值。

   

   1. 单击数字序列中的关键点以选择或重新定位它，或通过单击图表上的任何位置添加另一个关键点。
   2. 通过 时间 和 值 输入框输入特定的时间/值组合。
   3. 如有需要，重复这些步骤以在图表上添加/调整透明度级别。

类型

渐变的 Type 属性从 Linear、Radial 或 Conical 中设置其类型。

• Linear — 颜色/透明度序列在元素上以直线过渡。方向由其 旋转 控制，位置由其 偏移 控制。这是默认值。

• Radial — 颜色/透明度序列从元素的中心向外辐射，可能通过 Offset 进行偏移。半径由元素的宽度和高度的平均值除以二定义，实际上是 $\text{(width+height)/4}$。Rotation 对径向渐变没有影响。

• Conical — 颜色/透明度序列顺时针围绕元素的中心旋转，可能通过 Offset 进行偏移。Rotation 控制旋转的起始和结束角度。默认情况下，这个旋转从 0 到 360 度，但 Scale 小于 1 的值可以减少该角度。

偏移和旋转

Offset 和 Rotation 属性让您调整渐变的控制点及其角度。如以下图示所示，Offset 基于父对象的宽度或高度的 百分比，正值或负值均有效。

同样，当您旋转渐变时，控制点也会旋转：

缩放

渐变的 Scale 乘以渐变的范围，控制在元素内可见的颜色/透明度序列的多少。

• 当 Scale 小于 1 时，渐变的范围小于完整范围。剩余的颜色/透明度根据 TileMode 属性填充。

• 当 Scale 大于 1 时，渐变的范围大于完整范围，只有部分颜色/透明度是可见的。

瓦片模式

TileMode 属性设置当完整序列未完全覆盖父元素时，渐变如何重复。

• Clamp — 默认模式，其中序列开始和结束的颜色/透明度值无限延伸，因此开始值填充渐变之前的任何区域，结束值填充其后的任何区域。

• Repeat — 渐变通过无缝地从结束回到开始来重复颜色/透明度序列。如果序列中的第一个和最后一个颜色/透明度值不同，则可能会产生可见的接缝。

• Mirror — 渐变在每个边界处反射，因此颜色/透明度序列来回反弹。这会产生平滑的重复，没有接缝，因为方向在每个瓦片边缘处反转。

描边

UIStroke 实例为文本或边框应用轮廓。主要特性包括：

• 可调节的 颜色 和 厚度 的描边轮廓。
• 能够独立于父对象设置描边 透明度。
• 可自定义相对于父边框的 位置和/或偏移。
• 三种 角落样式（圆形、斜切或尖角）。
• 通过 UIGradient 实例支持描边 渐变。

厚度

您可以通过 Thickness 属性设置描边宽度，该宽度以像素为单位（默认）或相对于父对象缩放，具体取决于修饰符的 StrokeSizingMode。如果描边在文本上，并且 StrokeSizingMode 设置为 ScaledSize，则厚度相对于字体大小。

颜色或渐变

您可以通过 Color 属性设置描边颜色，也可以插入子 UIGradient 实例以创建渐变描边。

文本轮廓或边框

根据其父类型，UIStroke 作为 文本轮廓 或 边框 操作。当您将 UIStroke 作为文本对象（如 TextLabel）的父对象时，它应用于文本的轮廓；当您将 UIStroke 作为其他 GuiObjects 的父对象时，它应用于边框。

当应用于文本对象时，您可以通过 ApplyStrokeMode 属性覆盖默认的描边行为，让您可以将描边应用于对象的边界而不是文本本身。您甚至可以通过将两个 UIStroke 实例作为文本对象的父对象来独立控制文本轮廓和边框，一个设置为 上下文，另一个设置为 边框。

边框位置/偏移

BorderStrokePosition 设置描边相对于其父边框的位置，BorderOffset 让您指定描边位置的额外偏移。

透明度

Transparency 属性独立于父对象的 BackgroundTransparency 或 TextTransparency 设置描边透明度。这使您能够渲染“空心”的文本和边框（仅由轮廓组成）。

角落样式

LineJoinMode 属性让您控制角落的解释方式。它接受 Round、Bevel 或 Miter 的值。

分层

要在 GuiObject 上从前到后分层多个兄弟 UIStroke 实例，您可以利用 ZIndex 属性。具有较低 ZIndex 的实例在具有较高 ZIndex 的实例下（后面）渲染。

请注意，具有相同 ZIndex 的 UIStroke 实例的渲染顺序是未定义的。如果它们的渲染顺序很重要，请不要应用多个具有相同索引的 UIStroke 实例。

圆角

UICorner 实例对其父 GuiObject 的角落进行变形。您可以通过 CornerRadius 属性控制应用的半径，使用 Scale 或 Offset。

Scale 将角落圆化为基于父对象 最短 边的总长度的 百分比，这意味着 0.5 或更高的缩放会将父对象变形为“药丸”形状，无论其宽度或高度如何。Offset 将角落圆化为特定数量的 像素，无论父对象的宽度/高度如何。

您还可以通过 TopLeftRadius、TopRightRadius、BottomRightRadius 和 BottomLeftRadius 属性控制 单个角落。

内边距

UIPadding 对象为父 GuiObject 的内容应用上、下、左和/或右内边距。例如，您可以通过对修饰符的 PaddingBottom 属性应用偏移，将文本向下或向上移动。

阴影

UIShadow 对象在其父 UI 实例后面渲染一个阴影。主要特性包括：

• 调整阴影的 模糊度。
• 调整阴影的 颜色和透明度。
• 调整阴影的 偏移和扩展。
• 如果父对象通过 GuiObject.Rotation 旋转，阴影也会旋转。
• 如果父对象具有 圆角，阴影也会具有圆角。

模糊度

BlurRadius 属性决定阴影的模糊度。较大的值使阴影的边缘看起来更柔和。请注意，此 UDim 属性的 缩放 因子相对于父对象的宽度或高度，取较短者。

颜色和透明度

Color 属性决定阴影的颜色，而 Transparency 设置阴影的透明度，0 为完全不透明，1 为完全透明。

偏移和扩展

Offset 属性相对于父对象的位置移动阴影，而 Spread 则相对于父对象的大小扩展或缩小阴影。