BillboardGui
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
BillboardGui est un conteneur pour les objets d'interface utilisateur qui apparaissent dans l'espace 3D mais toujours face à la caméra.La position du conteneur est relative à la position du parent BasePart ou Attachment (ou du Adornee).Pour BaseParts , la propriété Position est utilisée, tandis que pour Attachments , la propriété WorldPosition est utilisée.

La propriété d'une affiche Size fonctionne légèrement différemment de GuiObject.Size .Bien que les composants de décalage offrent le même fonctionnement, les composants de l'échelle sont utilisés comme tailles de perçage dans l'espace 3D.
Lors de la création d'une taille à échelle BillboardGui qui contient un TextLabel , il est utile d'activer la propriété étiquette TextScaled de sorte que son texte s'adapte en même temps que la toile d'affichage lorsque la distance de la caméra change.
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.
Voir interface utilisateur en expérience pour un guide sur le travail avec BillboardGui conteneurs.
Comportement de mise en cache
Pour aider à améliorer les performances, l'apparence d'un BillboardGui est mise en cache jusqu'à ce que l'une des suivantes se produise, après quoi son apparence sera récalculée sur le prochain cadre de rendu.
- Un descendant est ajouté ou supprimé du BillboardGui.
- Une propriété d'un descendant des modifications de la BillboardGui .
- Une propriété de la BillboardGui elle-même change.
Résumé
Propriétés
Contrôle si les descendants recevront des événements d'entrée.
Définit la partie ou l'attache cible à laquelle la BillboardGui est positionnée par rapport.
Détermine si le BillboardGui sera toujours rendu au-dessus d'autres objets 3D.
Détermine le facteur par lequel la lumière du conteneur BillboardGui est scalaire lorsque LightInfluence est 0 .
Si des parties de GuiObjects qui tombent en dehors des bords de toile BillboardGui seront dessinées.
La distance actuelle en studs à partir de laquelle le BillboardGui est de la caméra du joueur.
Détermine la distance en studs à laquelle le BillboardGui cessera de s'étendre plus en taille.
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.
Détermine la distance en studs à laquelle le BillboardGui cessera de s'adapter à une taille plus petite.
Détermine comment le BillboardGui est décalé par rapport à son Adornee orientation, par rapport à l'orientation Camera du modèle, en unités d'une moitié des dimensions de la boîte de modélisationde bordure alignée sur le modèle de Camera.
Détermine comment le BillboardGui est décalé par rapport à son Adornee par rapport aux axes globaux, en unités d'une moitié des dimensions de la boîte de modélisationde bordure alignée sur l'axe du modèlisation.
Contrôle à quel point le BillboardGui est influencé par la lumière environnementale.
Contrôle à quelle distance le BillboardGui peut être affiché avant qu'il ne cesse de rendre.
Utilisé par les scripts pour masquer le BillboardGui de joueurs spécifiques.
Contrôle la taille que le BillboardGui aura sur l'écran.
Un décalage 2D en unités relatives à la taille qui agit comme un point d'ancrage.
Détermine comment le BillboardGui est décalé par rapport à son Adornee orientation en studs, par rapport à l'orientation Camera.
Détermine comment le BillboardGui est décalé par rapport à son Adornee en studs, par rapport aux axes globaux.
Bascule la visibilité de ce LayerCollector .
Détermine si les réinitialisations de LayerCollector (se supprime et se réclone dans le personnage du joueur de PlayerGui ) se produisent chaque fois que le personnage du joueur réapparaît.
Contrôle comment GuiObject.ZIndex se comporte sur tous les descendants de ce LayerCollector .
Décrit la position réelle d'un élément GuiBase2d sur l'écran, en pixels.
Décrit la rotation réelle de l'écran d'un élément GuiBase2d en degrés.
Décrit la taille réelle de l'écran d'un élément GuiBase2d, en pixels.
Lorsqu'il est défini à true, la localisation sera appliquée à ce GuiBase2d et à ses descendants.
Une référence à un LocalizationTable à utiliser pour appliquer une localisation automatisée à ce GuiBase2d et à ses descendants.
Personnalise le comportement de sélection du manette de jeu dans la direction descendante.
Personnalise le comportement de sélection du manette de jeu dans la direction de gauche.
Personnalise le comportement de sélection du gamepad dans la bonne direction.
Personnalise le comportement de sélection du gamepad dans la direction vers le haut.
Permet la personnalisation du mouvement de sélection du gamepad.
Évènements
Évènements hérités de GuiBase2d- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Se déclenche lorsque la sélection de la manette de jeu se déplace, quitte ou change dans le connecteur GuiBase2d ou dans n'importe quel descendant GuiObjects.
Propriétés
Active
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.
Adornee
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.
AlwaysOnTop
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.
Brightness
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 .
ClipsDescendants
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.
CurrentDistance
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.
DistanceLowerLimit
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.
DistanceStep
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 .
DistanceUpperLimit
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.
ExtentsOffset
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.
ExtentsOffsetWorldSpace
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 .
LightInfluence
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.
MaxDistance
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.
PlayerToHideFrom
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.
Size
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.
SizeOffset
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>
Déséquilibre de taille | Explication |
---|
Voir aussi StudsOffset , StudsOffsetWorldSpace , ExtentsOffset , et ExtentsOffsetWorldSpace qui sont des propriétés décalées qui fonctionnent dans l'espace 3D à la place.
StudsOffset
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.
StudsOffsetWorldSpace
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.