UIGradient

非推奨を表示

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

UIGradient は、親 GuiObject によってレンダリングされたUI要素に色と透明度のグラデーションを適用します。グラデーションの外観は、その Color ( ColorSequence ), Transparency ( NumberSequence ), Offset ( Vector2 ), そして Rotation (number) を通じて構成可能です。

A UIGradient は子や孫に適用されません GuiObjects .複数のオブジェクトに同じグラデーションを適用するには、グラデーションインスタンスが複数必要になります。

詳細については、外観修正者 を参照してください。オブジェクトとその動作についての詳細は、UIGradient をご覧ください。

サポートされるオブジェクト

グラデーションを Frame , TextLabel , TextButton , ImageLabel , ImageButton , そして ViewportFrame に適用できます。しかし、ScrollingFrameTextBox は現在サポートされていません。

性能の考慮事項

効率的に UIGradient を使用するには、次の原則に従ってください:

  • Color シーケンスで 6色以上の停止を使用しないでください。

  • グラデーションがストロークやボーダーと融合しようとし、パフォーマンスの問題を引き起こす可能性があるため、テキストストロークを適用するオブジェクトに を使用しないでください。

  • ColorTransparency を頻繁に設定しないでください:これにより、色のシーケンスが頻繁に再構築され、コストがかかります。可能であれば、これらのプロパティを一度だけ設定し、Offset または Rotation プロパティをアニメートして、同様の効果を達成してください。代わりに、親の色を 、 、または のようなプロパティを使用して変更できます。

  • 状態が大幅に変化する UI 要素に変更可能なグラデーションを適用するとき、UIGradient (処理時間) と静的グラデーション画像 (メモリ) の間でバランスが取られます。

概要

プロパティ

  • 並列読み取り

    グラデーションの長さ沿いで親の GuiObject とブレンドされた色を決定します。

  • 並列読み取り

    グラデーションが有効かどうか。

  • 並列読み取り

    親の GuiObject の中心からグラデーションの線形翻訳を決定します。

  • 並列読み取り

    左から右へのグラデーションの度数で時計回りの回転を決定します。

  • 並列読み取り

    親の GuiObject がグラデーションの長さにわたってどの程度見えるかを決定します。

プロパティ

並列読み取り

このプロパティは、提供された ColorSequence 沿いで親UI要素とブレンドする色を説明します。このプロパティは、Beam.Color または Trail.Color と同様の方法で機能し、Offset および Rotation によって決定される画面距離に適用されます。

Enabled

並列読み取り

グラデーションが有効かどうか。

Offset

並列読み取り

このプロパティは、親の GuiObject の中心からのグラデーションのスカラー翻訳を決定します。それはスカラー翻訳であり、実際のピクセルオフセットは親の によって決定されます。たとえば、値 (1, 0) は、親オブジェクトの画面サイズと同じ距離で、傾きを横向きに移動します。Rotation によって、グラデーションが部分的に見えたり、見えなかったりする可能性があります。

また、Rotation にも注意してください、これは適用されたグラデーションの幾何学にも影響します。

Rotation

並列読み取り

このプロパティは、左から右への 時計回り 回転を度数で決定します。始まりは左から右への UIGradient 回転です。開始と終了制御ポイントは、親の GuiObject の端にスナップしますが、提供された回転を維持します。

また、Offset にも注意してください、これは適用されたグラデーションの幾何学にも影響します。

Transparency

並列読み取り

このプロパティは、提供された NumberSequence 沿いで親 UI 要素がどれほど不透明になるかを説明します。このプロパティは、Beam.Transparency または Trail.Transparency と同様の方法で機能し、Offset および Rotation によって決定される画面距離に適用されます。

NumberSequenceKeypoints の封筒値は無視されます。

方法

イベント