UIGradient 對父級 GuiObject 渲染的 UI 元素應用顏色和透明度傾斜度。傾斜度的外觀可通過其 Color ( ColorSequence ), Transparency ( NumberSequence ), Offset ( Vector2 ), 和 Rotation (number) 來配置。
A 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 的中心轉換梯度的Scalar。它是線性翻譯,意味著實際像素偏移由父 AbsoluteSize 的 GuiObject 決定。因此,值 (1, 0) 將向右移動傾斜度,距離等於父對物件在畫面上的尺寸。根據 Rotation ,這可能會導致傾斜度部分可見或全部不可見。
請參閱Rotation,這也會影響應用的傾斜度的幾何形狀。
Rotation
這個屬性決定從左到右的 順時鐘旋轉 度數,開始於左到右的 UIGradient 旋轉。開始和結束控制點會抓住父GuiObject的邊緣,但保持提供的旋轉。
請參閱Offset,這也會影響應用的傾斜度的幾何形狀。
Transparency
此屬性描述父 UI 元素在提供的 NumberSequence 上會有多暗。這個屬性的工作方式類似於 Beam.Transparency 或 Trail.Transparency ,但它適用於由 Offset 和 Rotation 決定的屏幕距離。
請注意, NumberSequenceKeypoints 的信封值被忽略。