BillboardGui
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
BillboardGui は、3D 空間にUIオブジェクトが表示されるコンテナですが、常にカメラに向かっています。コンテナの位置は、親 BasePart または Attachment (または Adornee)に対するものです。For BaseParts 、Position プロパティが使用され、For Attachments 、WorldPosition プロパティが使用されます。

ビルボードの Size プロパティは、GuiObject.Size とは少し異なる動作をします。 オフセット コンポーネントは同じですが、 スケール コンポーネントは 3D 空間でスタッドサイズとして使用されます。
サイズスケールの BillboardGui を作成し、TextLabel を含むとき、カメラ距離が変更されるとビルボードキャンバスのテキストがスケールするように、ラベルの TextScaled プロパティを有効にすると便利です。
対話形式の UI 要素 ( や 内の) は、通常、 内に配置することで親になり、 を通じてユーザーの入力を受け取るだけです。Adornee プロパティを使用して、BillboardGui 自体が PlayerGui に残りながら、3D世界のパーツまたは付属物をターゲットにできます。
体験中の UI を参照して、 コンテナーを使用する方法のガイド を見てください。
キャッシュ行動
パフォーマンスを向上させるために、BillboardGui の外観は、次のいずれかが発生するまでキャッシュされ、次のレンダリングフレームで再計算されます。
- 子孫が BillboardGui に追加されたり削除されたりします。
- BillboardGui の子孫のプロパティが変更されます。
- BillboardGui 自体のプロパティが変更されます。
概要
プロパティ
子孫が入力イベントを受信するかどうかを制御します。
BillboardGui が位置付けられているターゲットパーツまたは添付ファイルを設定します。
BillboardGui が常に他の 3D オブジェクトの上にレンダリングされるかどうかを決定します。
Determines the factor by which the BillboardGui コンテナのライトがスケールするときに LightInfluence が 0 になるようにします。
キャンバスボーダーの外にある部分が描かれるかどうか。
BillboardGui からプレイヤーのカメラまでの現在の距離(スタッド)。
BillboardGui が大きさを拡大するのをやめる距離をスタッドで決定します。
プレイヤーのカメラが に近づいたり、遠ざかったりすると、スタッドの増加量と減少量を決定します。
BillboardGui がサイズが小さくなるスケーリングを停止する距離をスタッドで決定します。
モデルの Camera アラインメントボックスの半分の尺寸のユニットで、Adornee オリエンテーションに対して、Camera から BillboardGui がオフセットされる方法を決定します。
モデルの軸に沿ったバウンディングボックスの半分の尺寸のグローバル軸に対して、 がオフセットされる方法を決定します。これは、モデルの軸に沿ったバウンディングボックスの尺寸の半分のユニットです。
BillboardGui が環境光にどれほど影響を受けるかを制御します。
レンダリングを停止する前に、BillboardGui が表示される距離を制御します。
スクリプトによって特定のプレイヤーから BillboardGui を非表示にするために使用されます。
BillboardGui が画面上に持つサイズを制御します。
サイズ関連のユニットの 2Dオフセットで、アンカーポイントとして機能します。
がどのようにスタッドでオフセットされ、 オリエンテーションに対してどのように偏りますかを決定します。
BillboardGui がグローバルな軸に対してどのようにオフセットされるかを決定します。スタッドでAdornee から。
この LayerCollector の表示を切り替えます。
プレイヤーのキャラクターが再スポーンするたびに、 がリセットされるかどうかを決定します。
GuiObject.ZIndex がこの LayerCollector のすべての子孫でどのように振る舞うかを制御します。
ピクセルで、GuiBase2d 要素の実際の画面位置を説明します。
GuiBase2d 要素の実際のスクリーン回転を度数で説明します。
ピクセルで、GuiBase2d 要素の実際の画面サイズを説明します。
true に設定すると、ローカライゼーションがこの GuiBase2d とその子孫に適用されます。
この LocalizationTable とその子孫に自動翻訳を適用するために使用する GuiBase2d の参照。
下方向のゲームパッド選択動作をカスタマイズします。
左方向でゲームパッドの選択動作をカスタマイズします。
右向きにゲームパッドの選択動作をカスタマイズします。
上向きのゲームパッド選択動作をカスタマイズします。
ゲームパッドの選択動作をカスタマイズできます。
イベント
GuiBase2d から継承した イベント- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
ゲームパッドの選択が移動し、離れ、または接続された またはその子孫の中で変更されると、炎が発生します。
プロパティ
Active
子孫が入力イベントを受信するかどうかを制御します。If the に含まれる が、そのボタンをクリックできるようにするには、 が両方の と ボタンに設定されている場合、そのボタンがクリック可能になります。
対話形式の UI 要素 ( や 内の) は、通常、 内に配置することで親になり、 を通じてユーザーの入力を受け取るだけです。Adornee プロパティを使用して、BillboardGui 自体が PlayerGui に残りながら、3D世界のパーツまたは付属物をターゲットにできます。
Adornee
ターゲット BasePart または Attachment を設定し、BillboardGui が親部品または添付ファイルに対して位置付けられるように、親部品または添付ファイルを上書きします。
AlwaysOnTop
このプロパティは、BillboardGui が常に他の 3D オブジェクトの上にレンダリングされるかどうかを決定します。
デフォルトの false に設定すると、BillboardGui は他の 3D コンテンツと同じようにレンダリングされ、他の 3D オブジェクトによって隠されます。true に設定すると、BillboardGui は常に 3D コンテンツの上にレンダリングされ、外観が大幅に変更されます:
- 色は、ScreenGui 内でどのように表示されるかと一致します。
- テキストは、高DPIデバイスでより鋭く表示される可能性があります。
- LightInfluence は、0 として扱われます。
- Brightness は効果がありません。
Brightness
このプロパティは、BillboardGui コンテナのライトが LightInfluence にスケールするときに、0 による要因を決定します。デフォルトでは、このプロパティは 1 であり、0 から 1000 までの任意の数に設定できます。このプロパティを変更することで、BillboardGui の明らかな明るさが環境により良く一致するようになります。たとえば、ビデオビルボードは、Brightness を 10 に増加することで、暗い部屋内で明るくすることができます。
Note that は Studio でアクセスできませんであり、 または が であるか、 が であるときに効果がありません。
ClipsDescendants
デフォルトの に設定すると、 キャンバスボーダーの外にある部分が描かれない。
このプロパティが であっても、キャンバスの外側にある はレンダリングされません。
CurrentDistance
BillboardGui からプレイヤーのカメラまでの現在の距離(スタッド)。変更されたイベントは、DistanceStep が 0 よりも大きい場合、このプロパティに対して発射しません。
DistanceLowerLimit
BillboardGui がプレイヤーの現在のカメラに対して大きさが大幅に増加するのをやめる距離をスタッドで決定し、デフォルトは 0 です。If the of the がこの値より低い場合、この距離でより大きくスケールすることはありません。
DistanceStep
プレイヤーのカメラが に近づいたり、遠ざかったりすると、スタッドの増加量と減少量を決定します。プロパティはデフォルトで 0 に設定され、DistanceLowerLimit からラウンドアップします。
DistanceUpperLimit
BillboardGui がプレイヤーの現在のカメラに対してサイズが小さくなるのをやめる距離をスタッドで決定します。If the of the がこの値より上にある場合、この距離でより小さくスケールすることはありません。
このプロパティは、値が 0 より小さい場合は無視されます。デフォルト値は -1 で、プロパティはデフォルトで無視されます。
ExtentsOffset
このプロパティは、BillboardGui がモデルの Adornee に対してどのようにオフセットされるかを決定し、Camera オリエンテーションに関連して、モデルの Camera 対応バインディングボックスの半分の尺寸でユニットが決定します。
同様の動作をするが、スタッドユニットを使用する StudsOffset 、またはオフセット方向がグローバルな軸に対して相対的である ExtentsOffsetWorldSpace も参照してください。
ExtentsOffsetWorldSpace
このプロパティは、 がモデルの軸に一致するバウンディングボックスの半分の尺寸でグローバル軸に対してオフセットされる方法を決定します。
参照してください:StudsOffset は同様に機能しますが、スタッドユニットを使用し、または ExtentsOffset は、オフセット方向が Camera に相対することを除いて、同様に機能します。
LightInfluence
コントロールは、 から までの範囲で、環境光にどれほど影響を受けるかを決定します。これを 1 に設定すると、周囲の照明が外外見に完全に制御を持っていることになり、 0 に設定すると、照明に効果がないことになります。
MaxDistance
このプロパティは、レンダリングを停止する前にカメラから BillboardGui が表示される距離を制御します。値 0 または inf (デフォルト)は、制限がないことを意味し、無限遠にレンダリングされます。
屋外に表示される場合は、BillboardGuis が十分に高いことを確認するために、MaxDistance が画面に表示されるときにコンテナの UI が十分に小さくなるようにすることをお勧めします。これにより、突然のポップアウト効果が最小限に抑えられます。
PlayerToHideFrom
スクリプトによって特定のプレイヤーから BillboardGui を非表示にするために使用されます。
1つ以上のプレイヤーからBillboardGuiを非表示にするには、それをStarterGuiに置き、スクリプトを使用してEnabledプロパティを設定し、LocalPlayerがそれを見ることができるかどうかに応じて設定します。Adornee プロパティを使用して、BillboardGui を親に付けるのではなく、BasePart または Attachment にWorkspace を付けることができます。
Size
BillboardGui が画面上に持つサイズを制御します。GuiObject.Size とは異なり、このプロパティの スケール コンポーネントは、ビルボードのスタッドサイズを 3D 空間に設定します。
SizeOffset
サイズ関連のユニットの 2Dオフセットで、アンカーポイントとして機能します。これは GuiObject.AnchorPoint プロパティと同様に使用できますが、値が異なります。
<tbody><tr><td><code>0, 0</code></td><td>UI がその中心に固定されるデフォルト。</td></tr><tr><td><code>0.5, 0.5</code></td><td>UI は左下に固定されます。</td></tr><tr><td><code>0.5, -0.5</code></td><td>UI は左上に固定されます。</td></tr><tr><td><code>-0.5, 0.5</code></td><td>UI は右上に固定されます。</td></tr><tr><td><code>-0.5, -0.5</code></td><td>UI は右下に固定されます。</td></tr></tbody>
サイズオフセット | 説明 |
---|
また、StudsOffset 、StudsOffsetWorldSpace 、ExtentsOffset 、およびExtentsOffsetWorldSpace は、3D 空間ではなく、オフセットプロパティで動作するものです。
StudsOffset
このプロパティは、 がどのようにスタッドでオフセットされ、 オリエンテーションに対してどのようにオフセットされるかを決定します。
また、オフセット方向がグローバルな軸に対して相対的であるのを除いて、同様の動作をする StudsOffsetWorldSpace も参照してください。
StudsOffsetWorldSpace
このプロパティは、BillboardGui がグローバルな軸に対してどのようにオフセットされるかを決定します。スタッドで、Adornee に対して。
また、オフセット方向が Camera に相対するのを除いて、同様の動作をする StudsOffset も参照してください。