UIGradient

顯示已棄用項目

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡

UIGradient 對父級 GuiObject 渲染的 UI 元素應用顏色和透明度傾斜度。傾斜度的外觀可通過其 Color ( ColorSequence ), Transparency ( NumberSequence ), Offset ( Vector2 ), 和 Rotation (number) 來配置。

A UIGradient 將不適用於子孫或後代 GuiObjects 。為了應用相同的傾斜度到多個對象,您將需要多個傾斜度實例。

請參閱外觀修改器以獲得更多關於UIGradient和它們如何工作的信息。

支援的對象

您可以將渐變應用到 Frame , TextLabel , TextButton , ImageLabel , ImageButtonViewportFrame 。但是,ScrollingFrameTextBox 目前不支持。

性能考量

為了有效使用 UIGradient,請遵循以下原則:

  • 避免在 Color 順序上使用超過 6 個顏色停止。

  • 避免在任何應用文字輪廓的對象上使用 ,因為傾向將嘗試融合到線條和邊緣上,可能會導致性能問題。

  • 避免設置 ColorTransparency 過度頻繁:這會導致顏色順序經常重建,這是昂貴的。如果可能,只設置這些屬性一次,並嘗試動畫 OffsetRotation 屬性來達到類似效果。或者,您可以使用 、 或 等屬性來變更父級的顏色。

  • 當在 UI 元素上應用不變的渐變時,其狀態經常發生變化,會出現使用 UIGradient (處理時間) 和靜態渐變圖像 (記憶) 之間的平衡。

概要

屬性

屬性

平行讀取

此屬性描述要與提供的 ColorSequence 沿線融合的父UI元素的顏色。此屬性的工作方式類似於 Beam.ColorTrail.Color ,但它適用於由 OffsetRotation 決定的屏幕距離。

Enabled

平行讀取

是否啟用渐變或否。

Offset

平行讀取

此屬性決定從父輩 GuiObject 的中心轉換梯度的Scalar。它是線性翻譯,意味著實際像素偏移由父 AbsoluteSizeGuiObject 決定。因此,值 (1, 0) 將向右移動傾斜度,距離等於父對物件在畫面上的尺寸。根據 Rotation ,這可能會導致傾斜度部分可見或全部不可見。

請參閱Rotation,這也會影響應用的傾斜度的幾何形狀。

Rotation

平行讀取

這個屬性決定從左到右的 順時鐘旋轉 度數,開始於左到右的 UIGradient 旋轉。開始和結束控制點會抓住父GuiObject的邊緣,但保持提供的旋轉。

請參閱Offset,這也會影響應用的傾斜度的幾何形狀。

Transparency

平行讀取

此屬性描述父 UI 元素在提供的 NumberSequence 上會有多暗。這個屬性的工作方式類似於 Beam.TransparencyTrail.Transparency ,但它適用於由 OffsetRotation 決定的屏幕距離。

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

方法

活動