ViewportFrame
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
ViewportFrame è un GuiObject che può rendere oggetti 3D all'interno dei suoi limiti, offrendo un modo per visualizzare gli oggetti 3D in uno spazio 2D come un ScreenGui . Questo oggetto ha i seguenti difetti:
- Nessun ombra o post-processing effetti sono renduti.
- Enum.Material.Neon e Enum.Material.Glass materiali rendono al minimo la qualità.
- Nested GuiObjects non sono supportati.
- Per impostazione predefinita, l'illuminazione all'interno di un ViewportFrame agisce come se Lighting.EnvironmentSpecularScale e Lighting.EnvironmentDiffuseScale fossero entrambi impostati su 0, quindi le proprietà che si basano su questi campi, come 1> Class.Surface1> , possono sembrare diverse.
Campioni di codice
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()Sommario
Proprietà
L'illuminazione applicata all'area all'interno del ViewportFrame .
Camera che è usato per rendere oggetti figli.
Determina il modo in cui verrà colorata un'immagine renduta.
Determina la trasparenza dell'immagine renduta.
Il colore della luce emessa.
Un Vector3 che rappresenta la direzione della Sorgentedi luce.
Determina se questo elemento UI affonda l'input.
Determina il punto di origine di un GuiObject , rispetto alla sua dimensione assoluta.
Determina se la ridimensionamento avviene in base al contenuto figlio.
Determina il colore di sfondo GuiObject .
Determina la trasparenza di sfondo e di GuiObject .
Determina il colore del GuiObject bordura.
Determina in che modo il GuiObject confine è distribuito rispetto alle sue dimensioni.
Determina la larghezza del pixel del confine GuiObject .
Determina se il discendente GuiObjects al di fuori dei confini di un elemento GUI padre dovrebbe essere Renderizzare.
Determina se il mouse del Giocatoreviene attivamente premuto sul GuiObject o no.
Determina se il GuiButton può essere interattato o no, o se il GuiState del GuiObject sta cambiando o no.
Controlla l'ordine di sorta del GuiObject quando viene utilizzato con un UIGridStyleLayout .
Imposta il GuiObject che verrà selezionato quando il pulsante di selezione del gamepad verrà spostato verso il basso.
Imposta il GuiObject che verrà selezionato quando il pulsante di selezione del gamepad sarà spostato a sinistra.
Imposta il GuiObject che verrà selezionato quando il pulsante di selezione del gamepad sarà spostato a destra.
Imposta il GuiObject che verrà selezionato quando il pulsante di selezione del gamepad verrà spostato verso l'alto.
Determina la posizione pixel e scalare del GuiObject .
Determina il numero di gradi con cui il GuiObject è ruotato.
Determine se il GUI può essere selezionato da un gamepad.
Sovrascrivi l'ornamento di selezione predefinito utilizzato per i gamepad.
L'ordine di GuiObjects selezionato dalla selezione della barra di gioco.
Determina la dimensione pixel e scalare del GuiObject .
Imposta gli assi Size su cui sarà basato il GuiObject parent.
Una proprietà mistura di BackgroundTransparency e TextTransparency .
Determina se il GuiObject e i suoi discendenti saranno renduti.
Determina l'ordine in cui un GuiObject rende rispetto agli altri.
Descrive la posizione reale dello schermo di un elemento UI, in pixel.
Descrive la rotazione dell'interfaccia utente reale, in gradi.
Descrive la dimensione reale dello schermo di un elemento UI, in pixel.
Quando impostato su true, la localizzazione sarà applicata a questo GuiBase2d e ai suoi discendenti.
Un riferimento a un LocalizationTable per essere utilizzato per applicare la localizzazione automatica a questo GuiBase2d e ai suoi discendenti.
Personalizza il comportamento della selezione del gamepad nella direzione in cui si muove verso il basso.
Personalizza il comportamento di selezione del gamepad nella direzione di sinistra.
Personalizza il comportamento della selezione del gamepad nella direzione giusta.
Personalizza il comportamento della selezione del gamepad nell'area di direzione up.
Consente la personalizzazione della selezione del gamepad.
Metodi
Metodi provenienti da GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Smoothly moves a GUI to a new UDim2 .
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Ridimensiona rapidamente una GUI in una nuova UDim2 .
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Smoothly sposta una GUI a una nuova dimensione e posizione.
Eventi
Eventi provenienti da GuiObjectSi attiva quando un utente inizia a interagire con un dispositivo dell'interfaccia utente-computer (tasto del mouse, inizio del tocco, pulsante della tastiera, ecc).
Si attiva quando un utente cambia il modo in cui interagisce con un dispositivo dell'interfaccia utente-computer (tasto del mouse, inizio del tocco, pulsante del tastiera, ecc).
Si esegue quando un utente smette di interagire tramite un dispositivo di interfaccia uomo-corrispettore (tasto del mouse, inizio del tocco, pulsante del tastiera, ecc).
Si attiva quando un utente muove il mouse in un elemento GUI.
Si attiva quando un utente muove il mouse da un elemento GUI.
Si attiva ogni volta che un utente muove il mouse quando è all'interno di un elemento GUI.
Si attiva quando un utente fa scorrere la rotella del mouse quando il mouse è su un elemento GUI.
Si attiva quando un utente fa clic con il mouse sulla ruota del mouse quando il mouse è su un elemento GUI.
Fired quando l'oggetto GuiObject viene focalizzato con il Gamepad Selector.
Si è spento quando il Gamepad Selector ha smesso di concentrarsi sull'oggetto Gui.
Si attiva quando il giocatore inizia, continua e si ferma quando viene premuto a lungo sull'elemento UI.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Si attiva quando il giocatore muove il dito sull'elemento UI.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Si attiva quando il giocatore esegue un gesto di pizzico o di trazione utilizzando due dita sull'elemento UI.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Si attiva quando il giocatore esegue una rotazione utilizzando due dita sull'elemento UI.
Si attiva quando il giocatore esegue una manovra di swipe sull'elemento UI.
Si attiva quando il giocatore esegue un gesto di tocco sull'elemento UI.
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Si attiva quando la selezione del gamepad si muove, si lascia o cambia all'interno della GuiBase2d connessa o di qualsiasi altro GuiObjects.
Proprietà
Ambient
Questa proprietà determina il tono di illuminazione applicato all'area all'interno del ViewportFrame . Le predefinizioni per Color3.fromRGB(200, 200, 200) (grigio fantasma) sono predefinite.
CurrentCamera
Camera istanza che viene utilizzata per rendere oggetti figli. Predefinito a nil .
L'oggetto Camera non si replica, quindi il ViewportFrame.CurrentCamera non si replica. Quando si imposta questa Proprietà, Camera.CFrame e 1>Class.Camera.FieldOfView1> vengono salvati e replicati internamente in modo
ImageColor3
Questa proprietà determina il modo in cui verrà colorata un'immagine renduta, consentendoti di cambiare il colore dell'immagine senza modificare direttamente l'oggetto renduto. Il valore di colorazione predefinito è Color3.new(1, 1, 1) (bianco) al quale non si verifica alcuna modifica del colore.
Vedi anche ImageTransparency che determina la trasparenza dell'immagine renduta.
ImageTransparency
Questa proprietà determina la trasparenza dell'immagine renduta, consentendoti di cambiare la trasparenza dell'immagine senza modificare direttamente l'oggetto renduto. Un valore di 0 (predefinito) è completamente opaco e un valore di 1 è completamente trasparente (invisibile).
Vedi anche ImageColor3 che determina il modo in cui un'immagine generata sarà colorata.
LightDirection
Un Vector3 rappresentante la direzione della fonte di luce dalla posizione Vector3.new(0, 0, 0) . Le predefinizioni per Vector3.new(-1, -1, -1) .