ViewportFrame
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
ViewportFrame est un GuiObject qui peut rendre des objets 3D à l'intérieur de ses limites, offrant une façon d'afficher des objets 3D dans un espace 2D comme un ScreenGui. Cet objet a les siguientes limites :
- Aucune ombre ou effets post-traitement n'est rendue.
- Enum.Material.Neon et Enum.Material.Glass matériaux rendus à la qualité la plus basse.
- Les nids GuiObjects ne sont pas pris en charge.
- Par défaut, l'éclairage à l'intérieur d'un ViewportFrame agit comme si Lighting.EnvironmentSpecularScale et Lighting.EnvironmentDiffuseScale étaient tous les deux réglés sur 0, donc les propriétés qui dépendent de ces champs, telles que 2>Class.Surface2>, peuvent sembler différentes.
Échantillons de code
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local playerGui = player:WaitForChild("PlayerGui")
local screenGui = Instance.new("ScreenGui")
screenGui.Parent = playerGui
local viewportFrame = Instance.new("ViewportFrame")
viewportFrame.Size = UDim2.new(0.3, 0, 0.4, 0)
viewportFrame.Position = UDim2.new(0, 15, 0, 15)
viewportFrame.BackgroundColor3 = Color3.new(0, 0, 0)
viewportFrame.BorderColor3 = Color3.new(0.6, 0.5, 0.4)
viewportFrame.BorderSizePixel = 2
viewportFrame.BackgroundTransparency = 0.25
viewportFrame.Parent = screenGui
local part = Instance.new("Part")
part.Material = Enum.Material.Concrete
part.Color = Color3.new(0.25, 0.75, 1)
part.Position = Vector3.new(0, 0, 0)
part.Parent = viewportFrame
local viewportCamera = Instance.new("Camera")
viewportFrame.CurrentCamera = viewportCamera
viewportCamera.Parent = viewportFrame
viewportCamera.CFrame = CFrame.new(Vector3.new(0, 2, 12), part.Position)local Players = game:GetService("Players")
local player = Players.LocalPlayer
local playerGui = player:WaitForChild("PlayerGui")
local screenGui = Instance.new("ScreenGui")
screenGui.Parent = playerGui
local TweenService = game:GetService("TweenService")
local viewportFrame = Instance.new("ViewportFrame")
viewportFrame.Size = UDim2.new(0.3, 0, 0.4, 0)
viewportFrame.Position = UDim2.new(0, 15, 0, 15)
viewportFrame.BackgroundColor3 = Color3.new(0, 0, 0)
viewportFrame.BorderColor3 = Color3.new(0.6, 0.5, 0.4)
viewportFrame.BorderSizePixel = 2
viewportFrame.BackgroundTransparency = 0.25
viewportFrame.Parent = screenGui
local part = Instance.new("Part")
part.Material = Enum.Material.Concrete
part.Color = Color3.new(0.25, 0.75, 1)
part.Position = Vector3.new(0, 0, 0)
part.Parent = viewportFrame
local viewportCamera = Instance.new("Camera")
viewportFrame.CurrentCamera = viewportCamera
viewportCamera.Parent = viewportFrame
viewportCamera.CFrame = CFrame.new(Vector3.new(0, 2, 12), part.Position)
task.wait(2)
local cameraGoal = {
CFrame = CFrame.new(Vector3.new(0, 6, 4), part.Position),
}
local tweenInfo = TweenInfo.new(2, Enum.EasingStyle.Quad, Enum.EasingDirection.Out)
local tween = TweenService:Create(viewportCamera, tweenInfo, cameraGoal)
tween:Play()Résumé
Propriétés
L'éclairage utilisé s'applique à la zone dans la ViewportFrame .
Camera qui est utilisé pour rendre des objets d'enfants.
Détermine la façon dont une image rendue sera colorée.
Détermine la transparence de l'image rendue.
La couleur de la lumière émise.
Un Vector3 représentant la direction de la source de lumière.
Détermine si cet élément de l'interface utilisateur coule l'entrée.
Détermine le point d'origine d'un GuiObject , par rapport à sa taille absolue.
Détermine si la redimensionnement se produit en fonction du contenu de l'enfant.
Détermine la couleur de l'arrière-plan GuiObject.
Détermine la transparence de l'arrière-plan et de la frontière de GuiObject.
Détermine la couleur de la GuiObject bordure.
Détermine la manière dont la GuiObject bordure est distribuée par rapport à ses dimensions.
Détermine la largeur de pixel de la GuiObject bordure.
Détermine si le descendant GuiObjects en dehors des limites d'un élément GUI parent doit rendu.
Détermine si la souris du joueur est activement pressée sur le GuiObject ou non.
Détermine si le GuiButton peut être interagi ou non, ou si le GuiState du GuiObject change ou non.
Contrôle l'ordre de tri du GuiObject lorsqu'il est utilisé avec un UIGridStyleLayout .
Définit le GuiObject qui sera sélectionné lorsque le sélecteur de gamepad sera déplacé vers le bas.
Définit le GuiObject qui sera sélectionné lorsque le sélecteur de gamepad sera déplacé à gauche.
Définit le GuiObject qui sera sélectionné lorsque le sélecteur de gamepad sera déplacé à droite.
Définit le GuiObject qui sera sélectionné lorsque le sélecteur de gamepad sera déplacé vers le haut.
Détermine la position pixel et vectorielle de l' GuiObject .
Détermine le nombre de degrés par lesquels le GuiObject est pivoté.
Déterminez si le GUI peut être sélectionné par une manette de jeu.
Surclasse l'ornement de sélection par défaut utilisé pour les gamepads.
L'ordre de GuiObjects sélectionné par la sélection de l'interface de jeu.
Détermine la taille de pixel et de taille vectorielle de GuiObject .
Définit les Size axes sur lesquels le GuiObject sera basé, par rapport à la taille de son parent.
Une propriété mixte de BackgroundTransparency et TextTransparency .
Détermine si le GuiObject et ses descendants seront rendus.
Détermine l'ordre dans lequel un GuiObject rendu par rapport aux autres.
Décrivez la position d'écran réelle d'un élément UI, en pixels.
Décrivez la rotation de l'écran réelle d'un élément UI, en degrés.
Décrivez la taille réelle de l'interface utilisateur, en pixels.
Lorsqu'il est réglé sur vrai, la localisation sera appliquée à ce GuiBase2d et à ses descendants.
Une référence à un LocalizationTable pour être utilisé pour appliquer la localisation automatisée à ce GuiBase2d et à ses descendants.
Personnalise le comportement de sélection du gamepad dans la direction vers le bas.
Personnalise le comportement de sélection du gamepad 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 de la sélection du gamepad.
Méthodes
Méthodes hérités de GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Déplace facilement une GUI vers un nouveau UDim2.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Redimensionne facilement une GUI en une nouvelle UDim2 .
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Déplace facilement une GUI dans une nouvelle taille et position.
Évènements
Évènements hérités de GuiObjectActivé lorsqu'un utilisateur commence à interagir via un appareil d'interface humain-ordinateur (bouton de souris, toucher de début, bouton de clavier, etc).
Activé lorsqu'un utilisateur change la façon dont ils interagissent via un appareil d'interface humain-ordinateur (bouton de souris, toucher le début, bouton de clavier, etc).
Activé lorsqu'un utilisateur arrête d'interagir via un appareil d'interface humain-ordinateur (bouton de souris, toucher début, bouton de clavier, etc).
Se déclenche lorsqu'un utilisateur déplace son curseur dans un élément GUI.
Se déclenche lorsqu'un utilisateur déplace sa souris à l'extérieur d'un élément GUI.
Se déclenche toujours lorsqu'un utilisateur déplace sa souris pendant qu'il est à l'intérieur d'un élément GUI.
Se déclenche lorsqu'un utilisateur fait glisser son roue de souris quand la souris est sur un élément de l'interface graphique.
Se déclenche lorsqu'un utilisateur fait glisser sa molette de souris vers l'avant lorsqu'il est au-dessus d'un élément GUI.
Activé lorsque l'objet Gui est focalisé avec le sélecteur Gamepad.
Activé lorsque le sélecteur Gamepad arrête de se concentrer sur GuiObject.
Démarre lorsque le joueur démarre, continue et s'arrête longuement sur la pression de l'API.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Se déclenche lorsque le joueur déplace son doigt sur l'élément de l'interface utilisateur.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Se déclenche lorsque le joueur effectue un geste de pince ou de tir à l'aide de deux doigts sur l'élément de l'interface utilisateur.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Se déclenche lorsque le joueur effectue une rotation à l'aide de deux doigts sur l'élément de l'interface utilisateur.
Se déclenche lorsque le joueur effectue un geste de ramassage sur l'élément de l'interface utilisateur.
Se déclenche lorsque le joueur effectue un geste de touche sur l'élément de l'interface.
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Se déclenche lorsque la sélection du gamepad se déplace, quitte ou change dans la GuiBase2d ou tout descendant GuiObjects connecté.
Propriétés
Ambient
Cette propriété détermine la teinte d'éclairage appliquée à la zone dans le ViewportFrame . Les valeurs par défaut sont Color3.fromRGB(200, 200, 200) (ghost grey).
CurrentCamera
Camera instance qui est utilisée pour rendre les objets enfants. Par défaut, nil .
L'objet Camera ne se réplique pas, de sorte que le ViewportFrame.CurrentCamera ne se répliquera pas non plus. Lorsque vous avez cette propriété, Camera.CFrame et 1> Class.Camera.FieldOfView</
ImageColor3
Cette propriété détermine comment une image rendue sera colorée, vous permettant de modifier la couleur de l'image sans modifier directement l'objet rendu. La valeur de coloration par défaut est Color3.new(1, 1, 1) (blanc) à laquelle aucune modification de couleur n'a lieu.
Voir également ImageTransparency qui détermine la transparence de l'image rendue.
ImageTransparency
Cette propriété détermine la transparence de l'image rendue, vous permettant de modifier la transparence de l'image sans modifier directement l'objet rendu. Une valeur de 0 (par défaut) est complètement opaque et une valeur de 1 est complètement transparente (invisible).
Voir également ImageColor3 qui détermine comment une image rendue sera colorée.
LightDirection
Un Vector3 représentant la direction de la source de lumière à partir de la position Vector3.new(0, 0, 0) . Les valeurs par défaut sont Vector3.new(-1, -1, -1) .