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 in seinem Bereich rendern kann, und bietet einen Weg, 3D-Objekte in einem 2D-Raum wie einem ScreenGui anzuzeigen. Dieses Objekt hat die folgenden Einschränkungen:
- Keine Schatten oder Post-Processing Effekte werden gerendert.
- Enum.Material.Neon und Enum.Material.Glass Materialien rendern mit der niedrigsten Qualität.
- Nested GuiObjects sind nicht unterstützt.
- Standardmäßig verhält sich die Beleuchtung in einem ViewportFrame so, als ob Lighting.EnvironmentSpecularScale und Lighting.EnvironmentDiffuseScale beide auf 0 eingestellt sind, so dass Eigenschaften, die auf diesen Feldern basieren, wie 1> Class.Surface1> , anders aussehen können.
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 Beleuchtungsstufe, die auf das Gebiet innerhalb des ViewportFrame angewendet wird.
Camera das verwendet wird, um Kinderobjekte zu rendern.
Bestimmt, wie eine gerendete Bild wird gefärbt.
Bestimmt die Transparenz des gerenderten Bildes.
Die Farbe des abgestrahlten Lichts.
Ein Vector3 , das die Richtung der Ausgangstextrepräsentiert.
Bestimmt, ob dieses UI-Element die Eingabe sinkt.
Bestimmt den Ursprungspunkt eines GuiObject , relativer zu seiner absoluten Größe.
Bestimmt, ob das Skalieren basierend auf Kindern Inhalt.
Bestimmt die Hintergrundfarbe des GuiObject.
Bestimmt die Transparenz der GuiObject -Hintergrund und -Rand.
Bestimmt die Farbe der GuiObject Grenze.
Bestimmt, in welcher Weise die GuiObject Kante relativ zu ihren Dimensionen platziert ist.
Bestimmt die Pixelbreite der GuiObject Grenze.
Bestimmt, ob der Nachkomme GuiObjects außerhalb der Grenzen eines Eltern-GUI-Elements rendernwerden soll.
Bestimmt, ob die Maus des Spieler:inauf dem GuiObject aktiviert wird oder nicht.
Bestimmt, ob das GuiButton mit oder ohne Interaktion möglich ist, oder ob das GuiState der GuiObject geändert wird oder nicht.
Steuert die Sortierungsordnung der GuiObject bei Verwendung mit einem UIGridStyleLayout.
Setzt das GuiObject, das ausgewählt wird, wenn der Gamepad-Auswahlhebel nach unten verschoben wird.
Setzt das GuiObject, das ausgewählt wird, wenn der Gamepad-Auswahl器 nach links verschoben wird.
Setzt das GuiObject, das ausgewählt wird, wenn der Gamepad-Auswahlheber rechts verschoben wird.
Setzt das GuiObject, das ausgewählt wird, wenn der Gamepad-Auswahlheber nach oben verschoben wird.
Bestimmt die Pixel- und SkalierungsPosition des GuiObject.
Bestimmt die Anzahl der Grad, in denen das GuiObject gedreht wird.
Bestimmen Sie, ob das GUI durch eine Gamepadausgewählt werden kann.
Überschreibt die Standard-Auswahlornamente für Gamepads.
Die Reihenfolge von GuiObjects , die von der Spielpad-Auswahl ausgewählt wurde.
Bestimmt die Pixel- und Skalierungsgröße des GuiObject.
Setzt die Size Achsen, auf denen die GuiObject basieren wird, relativ zur Größe ihres übergeordnetes Teil.
Eine gemischte Eigenschaft von BackgroundTransparency und TextTransparency.
Bestimmt, ob das GuiObject und seine Nachkommen gerendert werden.
Bestimmt die Reihenfolge, in der ein GuiObject relativo zu anderen rendert.
Beschreibt die tatsächliche Bildschirmposition eines UI-Elements in Pixeln.
Beschreibt die tatsächliche Bildschirmdrehung eines UI-Elements, in Grad.
Beschreibt die tatsächliche Bildschirmgröße eines UI-Elements in Pixel.
Wenn auf wahr gesetzt, wird die Lokalisierung auf diesen GuiBase2d und seinen Nachkommen angewendet.
Eine Verweisung auf eine LocalizationTable , die verwendet wird, um automatisierte Lokalisierung auf diesen GuiBase2d und seinen Nachkommen anzuwenden.
Benutzerdefiniert das Verhalten der Gamepad-Auswahl in Richtung unten.
Anpassen Sie das Gamepad-Auswahlverhalten in der linken Richtung.
Benutzerdefiniert das Verhalten der Spielpad-Auswahl in die richtige Richtung.
Benutzerdefiniert das Verhalten der Gamepad-Auswahl in Richtung nach oben.
Erlaubt die Anpassung der Gamepad-Auswahl.
Methoden
Methoden von GuiObject übernommen- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Bewegt eine GUI mühelos zu einem neuen UDim2.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Skaliert eine GUI makellos zu einer neuen UDim2 .
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Verschwindet ein GUI mühelos auf eine neue Größe und Position.
Ereignisse
Ereignisse von GuiObject übernommenAusgelöst, wenn ein Benutzer mit einem Human-Computer-Interface-Gerät (Maus-Button, Touch-Anfang, Tastatur-Button usw.) interagiert.
Ausgelöst, wenn ein Benutzer die Interaktion über ein Mensch-Computer-Schnittstelle-Gerät (Maus-Button nach unten, Touch-Anfang, Tastatur-Button nach unten usw.) ändert.
Ausgelöst, wenn ein Benutzer die Interaktion über ein Mensch-Computer-Schnittstelle (Maus-Button, Touch-Beginn, Tastatur-Button usw.) aufgibt.
Feuert, wenn ein Benutzer seine Maus in ein GUI-Element bewegt.
Feuert, wenn ein Benutzer seine Maus aus einem GUI-Element bewegt.
Feuert, wenn ein Benutzer seine Maus bewegt, während sie in einem GUI-Element ist.
Feuert, wenn ein Benutzer seine Maus zurück scrollt, wenn die Maus über ein GUI-Element ist.
Feuert, wenn ein Benutzer seine Maus auf ein GUI-Element bewegt, wenn die Maus über einem GUI-Element ist.
Feuern, wenn das GuiObject mit dem Gamepad-Auswahl器 konzentriert wird.
Feuern, wenn der Gamepad-Auswahlbereich auf das GuiObject aufhört, sich zu konzentrieren.
Feuert, wenn der Spieler startet, hält und stoppt das Drücken der UI.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Feuert, wenn der Spieler seinen Finger auf dem UI-Element bewegt.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Feuert, wenn der Spieler einen Pinch oder Ziehvorgang mit zwei Fingern auf der UI-Element ausführt.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Feuert, wenn der Spieler einen Rotierungs-Gestalt mit zwei Fingern auf dem UI-Element ausführt.
Feuert, wenn der Spieler eine Swipe-Geste auf dem UI-Element ausführt.
Feuert, wenn der Spieler eine Berührung auf dem UI-Element ausführt.
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Feuert, wenn die Gamepad-Auswahl bewegt wird, geht oder sich in der verbundenen GuiBase2d oder einem Nachfolge GuiObjekten ändert.
Eigenschaften
Ambient
Diese Eigenschaft bestimmt die Beleuchtungsstufe, die auf das Gebiet innerhalb des ViewportFrame angewendet wird. Standard sind Color3.fromRGB(200, 200, 200) (Ghost grey).
CurrentCamera
Camera Instanz, die verwendet wird, um Kinderobjekte zu rendern. Standardmäßig auf nil .
Das Camera-Objekt wird nicht dupliziert, sodass das ViewportFrame.CurrentCamera nicht dupliziert wird. Wenn Sie diese Eigenschafteneinstellen, werden Camera.CFrame und 2>Class.Camera.FieldOfView2> intern gespeichert und
ImageColor3
Diese Eigenschaft bestimmt, wie eine gerendete Bildfarbe aufge色彩される, so dass Sie die Bildfarbe ändern können, ohne das gerenderinge Objekt direkt zu modifizieren. Die Standardfarbung ist Color3.new(1, 1, 1) (weiß), bei der keine Farbmodifikationen auftreten.
Siehe auch ImageTransparency, die die Transparenz des gerenderten Bilds bestimmt.
ImageTransparency
Dieses Eigenschaft bestimmt die Transparenz der rendelten Bild, so dass Sie die Bildtransparenz ändern können, ohne das rendelte Objekt direkt zu modifizieren. Ein Wert von 0 (Standard) ist vollständig und ein Wert von 1 vollständig durchsichtig (unsichtbar).
Siehe auch ImageColor3, die bestimmt, wie eine gerendierte Bild wird gefärbt.
LightDirection
Ein Vector3 , der die Richtung der Lichtquelle aus Position Vector3.new(0, 0, 0) repräsentiert. Standards zu Vector3.new(-1, -1, -1) .