SurfaceGui
*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
SurfaceGui は、3D ワールドでパーツの表面に UI オブジェクトのレンダリングを許可しつつ、基本的なユーザーインタラクションが発生することを許可します。Decals と Textures に似て、TextLabels や ImageLabels のような UI オブジェクトは、SurfaceGui プロパティを通じて同じ方向に向かっており、編集可能な面は Face プロパティです。
対話形式の UI 要素 ( や 内の) は、通常、 内に配置することで親になり、 を通じてユーザーの入力を受け取るだけです。Adornee プロパティを使用して、SurfaceGui 自体が PlayerGui に残りながら、3D世界のパーツをターゲットにできます。
体験中の UI を参照して、 コンテナーを使用する方法のガイド を見てください。
キャッシュ行動
パフォーマンスを向上させるために、SurfaceGui の外観は、次のいずれかが発生するまでキャッシュされ、次のレンダリングフレームで再計算されます。
- 子孫が SurfaceGui に追加されたり削除されたりします。
- SurfaceGui の子孫のプロパティが変更されます。
- SurfaceGui 自体のプロパティが変更されます。
概要
プロパティ
SurfaceGui が常に他の 3D オブジェクトの上にレンダリングされるかどうかを決定します。
Determines the factor by which the SurfaceGui コンテナのライトがスケールするときに LightInfluence が 0 になるようにします。
「仮想ピクセル」内の「仮想画面」のサイズは、SurfaceGuis ピクセル対ピクセルが ScreenGuis に互換可能になる。
キャンバスボーダーの外にある部分が描かれるかどうか。
SurfaceGui が環境光にどれほど影響を受けるかを制御します。
レンダリングを停止する前に、SurfaceGui が表示される距離を制御します。
各ワールドスペーススタッドでレンダリングするピクセルの密度を決定し、SurfaceGui のコンテンツを表示します。
SurfaceGui がスタッドのサイズで固定サイズまたはスケールでレンダリングされるかどうかを決定します。
左クリックが起動する距離を SurfaceGui ではなく、持続した Tool に対してアクションを開始する距離を設定します。
この SurfaceGui を他の SurfaceGuis と同じ顔にレイヤーします。
BasePart に、SurfaceGui を適用し、デフォルトの親団体を上書きする
Enum.NormalId 顔に、SurfaceGui を適用する。
この LayerCollector の表示を切り替えます。
プレイヤーのキャラクターが再スポーンするたびに、 がリセットされるかどうかを決定します。
GuiObject.ZIndex がこの LayerCollector のすべての子孫でどのように振る舞うかを制御します。
ピクセルで、GuiBase2d 要素の実際の画面位置を説明します。
GuiBase2d 要素の実際のスクリーン回転を度数で説明します。
ピクセルで、GuiBase2d 要素の実際の画面サイズを説明します。
true に設定すると、ローカライゼーションがこの GuiBase2d とその子孫に適用されます。
この LocalizationTable とその子孫に自動翻訳を適用するために使用する GuiBase2d の参照。
下方向のゲームパッド選択動作をカスタマイズします。
左方向でゲームパッドの選択動作をカスタマイズします。
右向きにゲームパッドの選択動作をカスタマイズします。
上向きのゲームパッド選択動作をカスタマイズします。
ゲームパッドの選択動作をカスタマイズできます。
イベント
GuiBase2d から継承した イベント- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
ゲームパッドの選択が移動し、離れ、または接続された またはその子孫の中で変更されると、炎が発生します。
プロパティ
AlwaysOnTop
このプロパティは、SurfaceGui が常に他の 3D オブジェクトの上にレンダリングされるかどうかを決定します。
デフォルトの false に設定すると、SurfaceGui は他の 3D コンテンツと同じようにレンダリングされ、他の 3D オブジェクトによって隠されます。true に設定すると、SurfaceGui は常に 3D コンテンツの上にレンダリングされ、外観が大幅に変更されます：
- 色は、ScreenGui 内でどのように表示されるかと一致します。
- テキストは、高DPIデバイスでより鋭く表示される可能性があります。
- LightInfluence は、0 として扱われます。
- Brightness は効果がありません。
Brightness
このプロパティは、SurfaceGui コンテナのライトが LightInfluence にスケールするときに、0 による要因を決定します。デフォルトでは、このプロパティは 1 であり、0 から 1000 までの任意の数に設定できます。このプロパティを変更することで、SurfaceGui の明らかな明るさが環境により良く一致するようになります。たとえば、ビデオビルボードは、Brightness を 10 に増加することで、暗い部屋内で明るくすることができます。
Note that は Studio でアクセスできませんであり、 または が であるか、 が であるときに効果がありません。
ClipsDescendants
デフォルトの に設定すると、 キャンバスボーダーの外にある部分が描かれない。
このプロパティが であっても、キャンバスの外側にある はレンダリングされません。
LightInfluence
コントロールは、 から までの範囲で、環境光にどれほど影響を受けるかを決定します。これを 1 に設定すると、周囲の照明が外外見に完全に制御を持っていることになり、 0 に設定すると、照明に効果がないことになります。
MaxDistance
このプロパティは、レンダリングを停止する前にカメラから SurfaceGui が表示される距離を制御します。値 0 は制限がないことを意味し、無限遠にレンダリングされます。デフォルト値の 1000 は、ほとんどの場合にうまく機能します。
屋外に表示される場合は、SurfaceGuis が十分に高いことを確認するために、MaxDistance が画面に表示されるときにコンテナの UI が十分に小さくなるようにすることをお勧めします。これにより、突然のポップアウト効果が最小限に抑えられます。
PixelsPerStud
このプロパティは、各ワールドスペーススタッドで使用されるピクセルの密度を決定し、SurfaceGui のコンテンツをレンダリングします。より高い値は、同じサイズで保持されると、内部の各種 GuiObjects が小さくなる可能性があります。逆に、低い値はオブジェクトが大きく見えるようにします。しかし、GuiObjects が UIScale 、GuiObject.Size 、TextLabel.TextSize などを使用して比例してスケールする場合、このプロパティはより高い定義を使用できるようになります。
プレイヤーが SurfaceGui を見る距離に基づいて値を選択することが重要です。また、大きなピクセル密度が装飾部の面が十分に大きい場合、パフォーマンスに悪影響を及ぼす可能性があることに注意してください。
SizingMode
デフォルトの Enum.SurfaceGuiSizingMode.PixelsPerStud に設定すると、SurfaceGui は PixelsPerStud に基づいて変数サイズでレンダリングし、スタッドでサーフェスのサイズが表示されます。
Enum.SurfaceGuiSizingMode.FixedSize に設定すると、SurfaceGui は CanvasSize を介して固定サイズが設定されてレンダリングされます。
ToolPunchThroughDistance
左クリックが起動する距離を SurfaceGui ではなく、持続した Tool に対してアクションを開始する距離を設定します。キャラクターが SurfaceGui の距離内にある場合、Tool はクリックで有効になりません。