ViewportFrame
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
ViewportFrame ist ein GuiObject, das 3D-Objekte innerhalb seiner Grenzen rendert und eine Möglichkeit bietet, 3D-Objekte in einem 2D-Raum wie ein ScreenGui anzuzeigen.Dieses Objekt hat die folgenden Einschränkungen:
Es werden keine Schatten oder Post-Processing-Effekte gerendert.
Enum.Material.Neon und Enum.Material.Glass materialien werden mit der niedrigsten qualität gerendert.
Verschachtelte GuiObjects werden nicht unterstützt.
Standardmäßig wird die Beleuchtung innerhalb eines ViewportFrame aktiv, als wären Lighting.EnvironmentSpecularScale und Lighting.EnvironmentDiffuseScale beide auf 0 eingestellt, sodass Eigenschaften, die auf diese Felder angewiesen sind, wie z. B. SurfaceAppearance.MetalnessMap, möglicherweise anders aussehen.
Dieses Objekt kann ein Sky -Kind als Kubenkarte für Reflexionen verwenden, in dem nur die sechs Sky -Eigenschaften des Skybox[…] -Objekts verwendet werden.Angenommen, diese Eigenschaften sind gültig, beleuchtet innerhalb von ViewportFrame handelt ähnlich, als wenn Lighting.EnvironmentSpecularScale und Lighting.EnvironmentDiffuseScale beide auf 1 festgelegt sind.Für Details siehe hier.
Code-Beispiele
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()Zusammenfassung
Eigenschaften
Die Beleuchtungsfarbe, die auf den Bereich innerhalb von ViewportFrame angewendet wird.
Camera das wird verwendet, um kinderobjekte zu rendern.
Bestimmt, wie das gerendete Ansichtsfensterbild koloriert wird.
Bestimmt die Transparenz des rendierten Ansichtsfensterbildes.
Die Farbe des emittierten Lichts.
Ein Vector3 repräsentiert die Richtung der Ausgangstext.
Bestimmt, ob dieses UI-Element Eingabe sinkt.
Legt den Ursprungspunkt eines GuiObject fest, bezogen auf seine absolute Größe.
Bestimmt, ob die Größenänderung basierend auf dem Inhalt des Kindes erfolgt.
Bestimmt die GuiObject Hintergrundfarbe.
Bestimmt die Transparenz des Hintergrunds und der Grenze GuiObject.
Bestimmt die Farbe des GuiObject-Randes.
Bestimmt, auf welche Weise die GuiObject Grenze in Bezug auf ihre Dimensionen angeordnet wird.
Bestimmt die Pixelf宽te des GuiObject Randes.
Bestimmt, ob ein Nachkomme GuiObjects außerhalb der Grenzen eines Eltern-GUI-Elements rendernwerden soll.
Bestimmt, ob die Maus des Spieler:inaktiv auf der GuiObject gedrückt wird oder nicht.
Bestimmt, ob die GuiButton mit dem Interagieren kann oder nicht, oder ob sich die GuiState des GuiObject ändert oder nicht.
Steuert die Sortierreihenfolge der GuiObject, wenn sie mit einem UIGridStyleLayout verwendet wird.
Legt das GuiObject, was ausgewählt wird, wenn der Gamepad-Auswahlknopf nach unten verschoben wird.
Legt das GuiObject, was ausgewählt wird, wenn der Gamepad-Auswahlsteller nach links verschoben wird.
Setzt das GuiObject, das ausgewählt wird, wenn der Gamepad-Auswahlbereich nach rechts verschoben wird.
Legt das GuiObject, was ausgewählt wird, wenn der Gamepad-Auswahlsteller nach oben verschoben wird.
Bestimmt die Pixel- und Skalarposition des GuiObject.
Bestimmt die Anzahl der Grad, um die sich der GuiObject dreht.
Bestimmen, ob die GuiObject von einem Gamepad ausgewählt werden kann.
Übernimmt die Standardauswahlverzierung, die für Gamepads verwendet wird.
Die Reihenfolge von GuiObjects, die vom Gamepad-UI-Auswahl angezeigt wird.
Bestimmt die Pixelform und Skalierung der GuiObject .
Legt die Size-Achsen fest, auf denen die GuiObject basieren wird, im Verhältnis zur Größe ihres übergeordnetes Teil.
Eine gemischte Eigenschaft von BackgroundTransparency und TextTransparency.
Bestimmt, ob die GuiObject und ihre Nachkommen gerendert werden.
Bestimmt die Reihenfolge, in der ein GuiObject in Bezug auf andere gerendert wird.
Beschreibt die tatsächliche Bildschirmposition eines GuiBase2d Elements, in Pixeln.
Beschreibt die tatsächliche Bildschirm rotation eines GuiBase2d Elements, in Grad.
Beschreibt die tatsächliche Bildschirmgröße eines GuiBase2d Elements, in Pixeln.
Wenn es auf true gesetzt wird, wird die Lokalisierung auf dieses GuiBase2d und seine Nachkommen angewendet.
Eine Referenz auf ein LocalizationTable , das verwendet werden soll, um automatisierte Lokalisierung auf dieses GuiBase2d und seine Nachkommen anzuwenden.
Passt das Spielpadauswahlverhalten in die Down-Richtung an.
Passt das Spielpadauswahlverhalten in die linke Richtung an.
Passt das Spielpadauswahlverhalten in die richtige Richtung an.
Passt das Spielpadauswahlverhalten in die Richtung oben an.
Ermöglicht die Anpassung der Gamepad-Auswahlbewegung.
Methoden
Methoden von GuiObject übernommen- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Bewegt eine GUI reibungslos zu einem neuen UDim2.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Bewegt eine GUI reibungslos zu einer neuen Größe und Position.
Ereignisse
Ereignisse von GuiObject übernommenFeuert, wenn ein Benutzer beginnt, über ein Mensch-Computer-Schnittstellen-Gerät zu interagieren (Mausknopf unten, Berührung beginnen, Tastaturknopf unten usw.).
Feuert, wenn ein Benutzer ändert, wie er über ein Mensch-Computer-Schnittstellen-Gerät interagiert (Mausknopf unten, Berührung beginnen, Tastaturknopf unten usw.).
Feuert, wenn ein Benutzer die Interaktion über ein Mensch-Computer-Schnittstellen-Gerät (Mausknopf unten, Berührung beginnen, Tastaturknopf unten usw.) beendet.
Feuert, wenn ein Benutzer seine Maus in ein GUI-Element bewegt.
Feuert, wenn ein Benutzer seine Maus aus einem GUI-Element heraus bewegt.
Feuert immer dann, wenn ein Benutzer seine Maus bewegt, während sie sich innerhalb eines GUI-Elements befindet.
Feuert, wenn ein Benutzer das Mobilrad zurück scrollt, wenn die Maus über ein GUI-Element ist.
Feuert, wenn ein Benutzer sein Mausrad nach vorne scrollt, wenn die Maus über ein GUI-Element ist.
Feuert ab, wenn das GuiObject mit dem Gamepad-Auswahlgerät fokussiert wird.
Feuert, wenn der Gamepad-Auswahlstoppt sich auf das GuiObject zu konzentrieren.
Feuert, wenn der Spieler startet, fortsetzt und lange auf das UI-Element drückt.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Feuert, wenn der Spieler seinen Finger auf das UI-Element bewegt.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Feuert, wenn der Spieler eine Pinch- oder Pull-Geste ausführt, indem er zwei Finger auf das UI-Element legt.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Feuert, wenn der Spieler eine Rotationsgeste mit zwei Fingern auf dem UI-Element ausführt.
Feuert, wenn der Spieler eine Wischgeste auf dem UI-Element ausführt.
Feuert, wenn der Spieler eine Tap-Geste auf dem UI-Element ausführt.
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Feuert, wenn die Auswahl des Gamepads sich auf, verlässt oder ändert innerhalb der verbundenen GuiBase2d oder eines Nachkommens GuiObjects.
Eigenschaften
Ambient
Diese Eigenschaft legt die Beleuchtungsfarbe fest, die auf den Bereich innerhalb von ViewportFrame angewendet wird. Standard ist
CurrentCamera
Camera Instanz, die verwendet wird, um Kinderobjekte zu rendern. Standard ist nil .
Das Camera Objekt repliziert sich nicht, so dass sich auch die ViewportFrame.CurrentCamera nicht replizieren wird.Wenn du diese Eigenschaftenfestlegst, Camera.CFrame und Camera.FieldOfView werden gespeichert und repliziert mit der ViewportFrame intern, so dass der Client die Rahmen ohne ein Camera Objekt rendern kann.
ImageColor3
Diese Eigenschaft legt fest, wie das gerendete Ansichtsbild koloriert wird, so dass du die Farbe ändern kannst, ohne das gerendete Objekt direkt zu modifizieren.Der Standard-Farbierungswert ist
Siehe auch ImageTransparency, das die Transparenz des rendierten Bildes bestimmt.
ImageTransparency
Diese Eigenschaft legt die Transparenz des gerenderten Ansichtsfensterbildes fest, so dass Sie die Transparenz ändern können, ohne das gerendete Objekt direkt zu modifizieren.Ein Wert von 0 (Standard) ist vollständig undurchsichtig und ein Wert von 1 ist vollständig transparent (unsichtbar).
Siehe auch ImageColor3, das bestimmt, wie das gerendete Bild koloriert wird.
LightDirection
Ein Vector3 repräsentiert die Richtung der Lichtquelle aus der Position