UI 外观修饰符

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

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

渐变

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

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

• 通过渐变的 Color 属性中的 ColorSequence 设置其 颜色。
• 通过渐变的 Transparency 属性中的 NumberSequence 设置其 透明度。
• 通过 Offset 属性选择渐变的起点（在父对象的边界内部或外部）。
• 通过 Rotation 属性选择渐变的角度。

颜色序列

要设置渐变的颜色序列：

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

2. 在 属性 窗口中，单击 Color 属性字段内，然后单击输入框右侧的 ⋯ 按钮。颜色序列弹出窗口显示。

   

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

   

3. 单击颜色序列中的一个关键点，然后单击 颜色 旁边的小方块以打开 颜色 弹出窗口。

4. 选择该关键点的所需颜色。

   

5. 如有需要，您可以：

   • 通过单击图形上的任何位置添加另一个关键点。
   • 拖动现有关键点到新位置，或选择关键点并通过 时间 输入框输入特定的时间值。
   • 通过选择关键点并单击 删除 按钮删除关键点。
   • 通过单击 重置 按钮重置序列。

透明度

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

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

2. 在 属性 窗口中，单击 Transparency 属性字段内，然后单击输入框右侧的 ⋯ 按钮。数字序列弹出窗口显示。

   

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

   

3. 点击并拖动任何关键点，或选择关键点并通过 时间 和 值 输入框输入特定的时间/值组合。

   

4. 如有需要，您可以：

   • 通过单击图形上的任何位置添加另一个关键点。
   • 通过选择关键点并单击 删除 按钮删除关键点。
   • 通过单击 重置 按钮重置序列。

偏移和旋转

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

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

描边

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 值较低的将在值较高的下方（后面）渲染。

请注意，对于 UIStroke 实例相同的 ZIndex，渲染顺序是未定义的。如果它们的渲染顺序很重要，请不要应用多个具有相同索引的 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 则相对于父对象的大小扩展或缩小影子。