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 的物件會在具有較高 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 擴展或縮小陰影相對於父物件的大小。