BillboardGui

Contrôle si les descendants recevront des événements d'entrée.Si le contient un , ce bouton ne deviendra cliquable que si est réglé sur sur les boutons et .

Notez que les éléments d'interface utilisateur interactifs comme ImageButtons et TextButtons à l'intérieur d'un BillboardGui ne recevront l'entrée de l'utilisateur que si ils sont parentés au PlayerGui , généralement en plaçant le BillboardGui à l'intérieur de StarterGui .La propriété Adornee peut être utilisée pour cibler une partie ou une pièce dans le monde 3D tout en laissant la BillboardGui elle-même dans le PlayerGui.

Définit la cible BasePart ou Attachment à laquelle la partie BillboardGui est positionnée par rapport, en remplaçant la partie parentale ou l'point d'attache.

Cette propriété détermine si la BillboardGui rendra toujours au-dessus d'autres objets 3D.

Lorsqu'il est défini à false (par défaut), le BillboardGui se rend comme un autre contenu 3D et est occulté par d'autres objets 3D.Lorsqu'il est défini à true , le BillboardGui rend toujours au-dessus du contenu 3D et les modifications d'apparence sont significatives :

• Les couleurs correspondent à la façon dont elles apparaissent à l'intérieur d'un ScreenGui .
• Le texte peut apparaître plus net sur les appareils DPI élevés.
• LightInfluence est traité comme s'il était 0 .
• Brightness n'a aucun effet.

Cette propriété détermine le facteur par lequel la lumière du conteneur BillboardGui est scalaire lorsque LightInfluence est 0.Par défaut, cette propriété est 1 et peut être définie à n'importe quel nombre entre 0 et 1000.En modifiant cette propriété, l'éclairage apparent d'un BillboardGui peut être mieux adapté à son environnement.Par instance, un panneau vidéo peut être éclairé à l'intérieur d'une pièce sombre en augmentant Brightness à 10.

Notez que Brightness n'est pas accessible dans Studio et n'a aucun effet lorsque LightInfluence est 1 ou AlwaysOnTop est true .

Lorsqu'il est défini à true (par défaut), des parties de GuiObjects qui tombent en dehors des bords de la toile BillboardGui ne seront pas dessinées.

Même lorsque cette propriété est false , GuiObjects qui sont complètement en dehors de la toile ne seront pas rendus.

La distance actuelle en studs à partir de laquelle le BillboardGui est de la caméra du joueur.Un événement modifié ne se déclenche pas pour cette propriété à moins que DistanceStep ne soit plus de 0.

Détermine la distance en studs à laquelle le BillboardGui cessera de s'étendre plus grand par rapport à la caméra actuelle du joueur, avec une valeur par défaut de 0 .Si le CurrentDistance du BillboardGui est inférieur à cette valeur, il ne s'adaptera pas plus grand que ce qu'il serait à cette distance DistanceLowerLimit.

Détermine les augmentations et les diminutions de taille CurrentDistance en studs lorsque la caméra du joueur se déplace plus près et plus loin du BillboardGui.La propriété se définit par défaut sur 0 et ronde à partir de DistanceLowerLimit .

Détermine la distance en studs à laquelle le BillboardGui cessera de s'adapter plus petit en taille par rapport à la caméra actuelle du joueur.Si le CurrentDistance du BillboardGui est au-dessus de cette valeur, il ne sera pas réduit de plus petite taille qu'il ne le serait à cette distance DistanceUpperLimit.

Cette propriété est ignorée si la valeur est inférieure à 0. La valeur par défaut est -1, ce qui signifie que la propriété est ignorée par défaut.

Cette propriété détermine comment le BillboardGui est décalé par rapport à son Adornee , par rapport à l'orientation Camera , en unités d'une moitié des dimensions de la boîte de modélisationde bordure du modèlisationCamera alignée.

Voir aussi StudsOffset qui fonctionne de manière similaire mais utilise des unités de perçage, ou ExtentsOffsetWorldSpace qui fonctionne de manière similaire mais l'orientation de décalage est relative aux axes globaux.

Cette propriété détermine comment le BillboardGui est décalé par rapport à son Adornee , par rapport aux axes globaux, en unités d'une demi-dimension de la boîte de modélisationde bordure alignée sur l'axe du modèlisation.

Voir aussi StudsOffset qui fonctionne de manière similaire mais utilise des unités de perçage, ou ExtentsOffset qui fonctionne de manière similaire mais l'orientation de décalage est relative au Camera .

Contrôle à quel point le BillboardGui est influencé par l'éclairage environnemental, dans une plage allant de 0 à 1.Définir ceci à 1 signifie que l'éclairage environnant a un contrôle complet sur l'apparence, tandis que le définir à 0 signifie que l'éclairage n'a aucun effet.

Cette propriété contrôle à quelle distance de la caméra la BillboardGui sera affichée avant qu'elle ne cesse de rendre.Une valeur de 0 ou inf (par défaut) signifie qu'il n'y a pas de limite et qu'elle sera rendue à l'infini loin.

Pour BillboardGuis qui apparaissent à l'extérieur, il est recommandé que MaxDistance soit suffisamment élevé pour garantir que l'interface utilisateur du conteneur soit suffisamment petite sur l'écran lorsqu'elle apparaît ou disparaît, minimisant l'effet de pop-in/out soudain.

Utilisé par les scripts pour masquer le BillboardGui de joueurs spécifiques.

Pour masquer un BillboardGui de plus d'un joueur, placez-le dans StarterGui et utilisez un script pour définir la propriété Enabled selon si le LocalPlayer devrait être en mesure de le voir.La propriété Adornee peut être utilisée pour attacher le BillboardGui à un BasePart ou Attachment dans le Workspace, au lieu de le parenter.

Contrôle la taille que le BillboardGui aura sur l'écran.Contrairement à GuiObject.Size , les composants de la échelle de cette propriété définissent la taille des étagères de la banderole dans l'espace 3D.

Un décalage 2D en unités relatives à la taille qui agit comme un point d'ancrage.Cela peut être utilisé de manière similaire à la propriété GuiObject.AnchorPoint, mais les valeurs sont différentes.

<tbody>
  <tr>
    <td><code>0, 0</code></td>

    <td>La valeur par défaut dans laquelle l'interface utilisateur sera ancrée au centre.</td>
  </tr>

  <tr>
    <td><code>0.5, 0.5</code></td>

    <td>L'interface utilisateur s'ancrera en bas à gauche.</td>
  </tr>

  <tr>
    <td><code>0.5, -0.5</code></td>

    <td>L'interface utilisateur s'ancrera en haut à gauche.</td>
  </tr>

  <tr>
    <td><code>-0.5, 0.5</code></td>

    <td>L'interface utilisateur s'ancrera en haut à droite.</td>
  </tr>

  <tr>
    <td><code>-0.5, -0.5</code></td>

    <td>L'interface utilisateur s'ancrera en bas à droite.</td>
  </tr>
</tbody>

Voir aussi StudsOffset , StudsOffsetWorldSpace , ExtentsOffset , et ExtentsOffsetWorldSpace qui sont des propriétés décalées qui fonctionnent dans l'espace 3D à la place.

Cette propriété détermine comment le BillboardGui est décalé de son Adornee en studs, par rapport à l'orientation Camera.

Voir aussi StudsOffsetWorldSpace qui fonctionne de manière similaire, sauf que l'orientation de décalage est relative aux axes globaux.

Cette propriété détermine comment le BillboardGui est décalé de son Adornee en studs, par rapport aux axes globaux.

Voir aussi StudsOffset qui fonctionne de manière similaire, sauf que l'orientation de décalage est relative au Camera.