ViewportFrame
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
ViewportFrame sınırları içinde 3B nesneleri görüntülemenin bir yolunu sunan bir GuiObject dır, 3B nesneleri 2D alanda görüntülemenin bir yolunu sunan bir ScreenGui .Bu nesne şu uyarılara sahiptir:
Gölge veya post-izleme efektleri görüntülenmez.
Enum.Material.Neon ve Enum.Material.Glass malzemeler en düşük kalitede görüntülenir.
İç içe geçmiş GuiObjects desteklenmiyor.
Varsayılan olarak, bir ViewportFrame içindeki aydınlatma, Lighting.EnvironmentSpecularScale ve Lighting.EnvironmentDiffuseScale her ikisi de 0 olarak ayarlanmış gibi davranır, bu nedenle bu alanlara dayalı özellikler, örneğin SurfaceAppearance.MetalnessMap , farklı görünebilir.
Bu nesne, yansımalar için bir Sky çocuk kullanabilir, bu durumda sadece Sky nesnenin altı Skybox[…] özelliği kullanılır.Bu özelliklerin geçerli olduğu varsayılırsa, ViewportFrame içindeki aydınlatma, Lighting.EnvironmentSpecularScale ve Lighting.EnvironmentDiffuseScale her ikisi de 1 olarak ayarlanmışsa benzer şekilde davranır.Detaylar için, buraya bakın.
Kod Örnekleri
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()Özet
Özellikler
ViewportFrame içindeki alana uygulanan aydınlatma rengi.
Camera çocuk nesneleri görüntülemek için kullanılan.
Render edilmiş görüntü penceresinin nasıl renklendirileceğini belirler.
Rendelenmiş görüntü penceresinin transparanlığını belirler.
Yayılan ışığın rengi.
Işık kaynakyönünü temsil eden bir Vector3 .
Bu UI öğesinin girişi alıp almadığını belirler.
Bir GuiObject 'in mutlak boyutuna göre kaynağı noktasını belirler, mutlak boyutuna göre.
Yeniden boyutlandırmanın çocuk içeriğine dayalı olup olmadığını belirler.
GuiObject arka plan rengini belirler.
GuiObject arka planının ve sınırının saydamlığını belirler.
GuiObject sınırının rengini belirler.
GuiObject sınırının boyutlarına göre nasıl düzenleneceğini belirler.
GuiObject sınırının piksel genişliğini belirler.
Ebeveyn bir GUI öğesinin sınırlarının dışında olup olmadığına bakarak altının GuiObjects renderlanması gereip geremediğini belirler.
oyuncumouse'unun GuiObject üzerinde aktif olarak basılıp basılmadığını belirler.
GuiButton ile etkileşime girilebilir olup olmadığını veya GuiState 'nin değişip değişmediğini belirler, ya da GuiObject 'nin değişip değişmediği.
Bir GuiObject ile kullanıldığında UIGridStyleLayout sıralama düzenini kontrol eder.
Oyun kolu seçicisi aşağıya kaydırıldığında seçilecek GuiObject ayarını ayarlar
Oyun kolu seçicisinin sola taşındığında seçilecek GuiObject ayarını ayarlar
Oyun kolu seçicisinin sağa taşındığında seçilecek GuiObject ayarını ayarlar
Oyun kolu seçicisi yukarı taşındığında seçilecek GuiObject ayarını ayarlar
GuiObject 'nin piksel ve skalar konumunu belirler.
GuiObject döndürüldüğünde döndürülen derece sayısını belirler.
GuiObject bir oyun kolu tarafından seçilebilir olup olmadığını belirleyin.
Oyun konsolları için kullanılan varsayılan seçim aksesuarlarını değiştirir.
Oyun kumanda UI seçimi tarafından seçilen GuiObjects sırası.
GuiObject 'nin piksel ve skalar büyüklüğünü belirler.
Size eksenlerini ayarlar, üzerinde ebeveynin boyutuna göre yapılacak GuiObject , ebeveynin boyutuna göre yapılacak
BackgroundTransparency ve TextTransparency 'in karışık bir özelliği.
GuiObject ve onun soyundakilerin render edilecek olup olmadığını belirler.
Bir GuiObject'nin diğerlerine göre hangi sırayla görüntüleneceğini belirler.
Bir GuiBase2d öğesinin gerçek ekran konumunu, piksel olarak tanımlar.
Bir GuiBase2d öğesinin gerçek ekran dönüşünü derecelerle tanımlar.
Bir GuiBase2d öğesinin gerçek ekran boyutunu, piksel olarak tanımlar.
true olarak ayarlanırsa, yerelleştirme bu GuiBase2d ve onun soyundakilere uygulanacaktır.
Bu GuiBase2d ve onun soyundakilere otomatik yerelleştirme uygulamak için kullanılacak bir LocalizationTable.
Aşağı yönünde oyun kolu seçim davranışını özelleştirir.
Oyun kolu seçim davranışını sol yönde özelleştirir.
Oyun kolu seçim davranışını doğru yönde özelleştirir.
Oyun kolu seçim davranışını yukarı yönünde özelleştirir.
Oyun kolu seçim hareketinin özelleştirilmesine izin verir.
Yöntemler
Şuradan alınan Yöntemler: GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Bir GUI'yi yumuşakça yeni bir UDim2 'ye taşır.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Bir GuiObject 'yi yumuşak bir şekilde yeni bir UDim2 'ye yeniden boyutlandırır.
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Bir GUI'yi yumuşakça yeni bir boyuta ve konuma taşır.
Etkinlikler
Şuradan alınan Etkinlikler: GuiObjectBir kullanıcı, İnsan-Bilgisayar Arayüzü cihazı aracılığıyla etkileşime başladığında ateş edilir (Fare düğmesi aşağı, dokunma başlar, klavye düğmesi aşağı, vb.).
Bir kullanıcı, İnsan-Bilgisayar Arayüzü cihazı aracılığıyla nasıl etkileşime girdiğini değiştirdiğinde ateş edilir (Fare düğmesü aşağı, dokunma başlar, klavye düğmesi aşağı, vb.).
Bir kullanıcı, İnsan-Bilgisayar Arayüzü cihazı aracılığıyla etkileşime son verdiğinde ateş edilir (Mouse düğmes aşağı, dokunma başlar, klavye düğmesi aşağı, vb.).
Bir kullanıcının fareini bir GUI öğesine taşıdığında ateş eder.
Bir kullanıcı GUI öğesinden fareni taşıdığında ateş eder.
Bir kullanıcı bir GUI öğesinin içindeyken fareyi hareket ettirdiğinde herhangi bir zamanda ateş eder.
Bir kullanıcı, fare bir GUI öğesinin üzerinde olduğunda fare tekerleğini geri sürüklediğinde ateş eder.
Bir kullanıcı, fare işaretçisi bir GUI öğesinin üzerinde olduğunda fare tekerleğini ileriye doğru kaydırdığında ateş eder.
GuiObject, Gamepad seçicisi ile odaklanırken ateş edildi.
Oyun Konsolu seçicisi GuiObject'e odaklanmayı bıraktığında ateş edilir.
Oyuncu başladığında, devam ettiğinde ve uzun süre UI öğesine basmayı bıraktığında ateş eder.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Oyuncu UI öğesine parmağını hareket ettirdiğinde ateş eder.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Oyuncu, UI öğesinde iki parmağı kullanarak bir kıskaç veya çekme hareketi gerçekleştirdiğinde ateş eder.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Oyuncu, UI öğesinde iki parmağı kullanarak bir dönüş hareketi gerçekleştirdiğinde ateş eder.
Oyuncu UI öğesine kaydırma hareketi yaptığında ateş eder.
Oyuncu UI öğesine dokunma hareketi yaptığında ateş eder.
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Oyun kolu seçimi, hareket eder, değişir veya bağlantılı GuiBase2d veya herhangi bir altın içinde değişir, bağlantılı GuiObjects .
Özellikler
Ambient
Bu özellik, ViewportFrame içindeki alana uygulanan aydınlatma rengini belirler. Varsayılan değer
CurrentCamera
Camera çocuk nesneleri görüntülemek için kullanılan örnek. Varsayılan olarak nil .
The Camera nesnesi yeniden yapılmaz, bu yüzden ViewportFrame.CurrentCamera da yeniden yapılmaz.Bu özelliği ayarladığınızda, Camera.CFrame ve Camera.FieldOfView kaydedilecek ve içsel olarak ViewportFrame ile yeniden yapılacak, böylece müşteri çerçeveyi bir Camera nesnesi olmadan kullanabilir.
ImageColor3
Bu özellik, görüntülenen pencere resminin nasıl renklendirileceğini belirler, böylece görüntülenen nesneyi doğrudan değiştirmeden rengini değiştirebilirsiniz.Varsayılan renklandırma değeri, hiçbir renk değişikliği gerçekleşmeyen
Ayrıca bakın ImageTransparency çizilen görüntünün transparanlığını belirleyen.
ImageTransparency
Bu özellik, görüntülenen pencere görüntüsünün transparanlığını belirler ve görüntülenen nesneyi doğrudan değiştirmeden transparanlığı değiştirmenize izin verir.Bir değer 0 (Varsayılan) tamamen opaktır ve bir değer 1 tamamen şeffaftır (görünmez).
Ayrıca bakın ImageColor3 çizilen görüntünün nasıl renklendirileceğini belirleyen.
LightDirection
Bir Vector3 ışık kaynağının yönünü pozisyondan temsil eden