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 , GuiObject olup, kısıtları içinde 3D nesneleri gösterebilen bir ScreenGui ızdır. Bu nesnin şu özellikleri vardır:
- Gölgeler veya post-Processing etkileri görüntülenmez.
- Enum.Material.Neon ve Enum.Material.Glass malzemeler en düşük kalitede görüntülenir.
- Nested GuiObjects are not supported.
- Varsayılan olarak, ışıklandırma bir ViewportFrame içine ışıklandırma işlevi, Lighting.EnvironmentSpecularScale ve Lighting.EnvironmentDiffuseScale ile birlikte 0 olarak ayarlandığından, bu alanlara bağımlı olan özellikler,
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
Aydınlatma renkleri ViewportFrame içindeki alana uygulandı.
Camera çocuk nesneleri render etmek için kullanılır.
Gerçekleştirilen bir görüntünün renklenmesini belirler.
Görüntülenen görüntünün görünürlüğünü belirler.
Yayılan ışığın rengi.
Işık kaynakyönünü temsil eden bir Vector3 .
Bu UI öğesi girişi batırır mı belirler.
GuiObject 'nin mutlak büyüklüğüne göre kaynağını belirler.
Çocuk içeriğine dayalı olarak yeniden boyutlandırma olup olmadığını belirler.
Class.GuiObject arka plan rengini belirler.
Class.GuiObject arka planı ve sınırının transparansını belirler.
GuiObject sınırının rengini belirler.
Class.GuiObject sınırının boyutlarına göre ne şekilde çizildiğini belirler.
GuiObject sınırının piksel genişliğini belirler.
Bir ebeveyn GUI öğesi dışındaki çizgi şu şekilde olmalıdır: GuiObjects
oyuncumouse'unun aktif olarak GuiObject üzerine basılı olup olmadığını belirler.
Class.GuiButton ile etkileşime geçilebilir mi yoksa değil, GuiState ile GuiObject arasındaki şekli değiştirilebilir mi yoksa değil.
Class.UIGridStyleLayout ile kullanıldığında UIGridStyleLayout 'in sıralama düzenini kontrol eder.
Oyun aracı seçici aşağıya hareket ettirildiğinde seçilecek GuiObject ı ayarlar.
Oyun aracı seçici sola hareket ettirildiğinde seçilecek GuiObject ayarlarını ayarlar.
Oyun aracı seçici sağa hareket ettirildiğinde seçilecek GuiObject ayarlarını ayarlar.
Oyun aracı seçici yukarı hareket ettirildiğinde seçilecek GuiObject ayarlarını ayarlar.
Class.GuiObject 'in piksel ve skalar pozisyonunu belirler.
Class.GuiObject döndürülmesinin oluğunu belirler.
Oyunpad tarafından seçilebilir GUI ile seçilebilir olup olmadığını belirleyin.
Oyunpadlar için kullanılan varsayılan seçim süslemesini geçersiz kılar.
Oyunpad seçiminin seçtiği GuiObjects sırası.
GuiObject 'in piksel ve skalar boyutlarını belirler.
Class.GuiObject ebeveyninin boyutuna göre GuiObject üzerine inşa edilecek Class.GuiObject.Size|Size eksenlerini ayarlar.
Class.GuiObject.BackgroundTransparency|BackgroundTransparency ile TextTransparency arasındaki karışık bir özellik.
Class.GuiObject ve onun çıplaklarının renderlenmesine izin verir.
Class.GuiObject ile ilgili diğerlerine göre şekillendirilen sırayı belirler.
Bir UI öğesinin gerçek ekran pozisyonunu, piksel olarak açıklar.
Bir UI öğesinin asıl ekran dönüşümünü, dereceler olarak açıklar.
Bir UI öğesi'nin aslındaki ekran büyüklüğünü,像 olarak tanımlar.
Açık olarak ayarlandığında, yerelleştirme bu GuiBase2d ve onun aşağıdaki soyundaki tüm benzerlerine uygulanacaktır.
Bu GuiBase2d ve onun aşağıdaki soyundaki otomatik yerelleştirmeyi uygulamak için kullanılan bir referans.
Aşağı yönlü gamepad seçimi davranışını özelleştirir.
Sol yönlü gamepad seçimi davranışını özelleştirir.
Oyun direği seçim davranışını özelleştirir.
Yukarı yönlendirme içinde oyun aracı seçim davranışını özelleştirir.
Oyun başlantısı seçimi hareketinin özelleştirilmesini sağlar.
Yöntemler
Şuradan alınan Yöntemler: GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Bir GUI'yu yeni bir UDim2 'a düzgün bir şekilde hareket ettirir.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Bir GUI'yu yeni bir UDim2 ile otomatik olarak yeniden boyutlandırır.
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Bir GUI'yu yeni bir boyuta ve konuma hızlıca hareket ettirir.
Etkinlikler
Şuradan alınan Etkinlikler: GuiObjectBir kullanıcı, Bir insan-bilgisayar arayüzü cihazı (Farenin aşağısına basma, dokunma başlangıcı, klavye düğmesine aşağı, vb) ile etkileşime geçmeye başladığında oluşturuldu.
Bir kullanıcı, bir Human-Computer Interface cihazı (Mouse button down, touch begin, keyboard button down, etc) aracılığıyla etkileşim kurarken ateşlenir.
Bir kullanıcı, Bir İnsan-Bilgisayar Arayüzü cihazı (Farenin aşağısına gitmesi, dokunma başlangıcı, klavye düğmesi vb.) kullanımını bıraktığında başlatıldı.
Bir kullanıcının mouse'ını bir GUI öğesine hareket ettirince ateş eder.
Bir kullanıcı, farelerini bir GUI öğesinden çıkarırsa ateş eder.
Bir kullanıcının fareini GUI elemanının içinde hareket ettirirken herhangi bir zaman ateş eder.
Bir kullanıcı, fare yüzdesi aştığında, fareyi GUI öğesi üzerinde olduğunda geri çevirir.
Bir kullanıcı, fareyi bir GUI öğesi üzerinde olduğunda ileriye çektiğinde ateş eder.
Gamepad seçici ile GuiObject'e odaklanıldığında yanıyor.
Gamepad seçici Gameui'yu odaklanmaktan vazgeçtiğinde yanıyor.
Oyuncu başladığında, devam ettiğinde ve UI öğesi üzerinde uzun basılı tutulduğunda ateşlenir.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Oyuncu parmaklarını UI elemanında hareket ettirirken ateş eder.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Oyuncu iki parmak kullanarak bir çıkarma veya çekme hareketini yaptığında ateş eder.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Oyuncu iki parmak kullanarak döndürme hareketi yaptığında ateş eder.
Oyuncu UI elementinde bir swipe hareketi yaptığında ateş eder.
Oyuncu UI elementinde bir dokunma hareketi yaptığında ateş eder.
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Gamepad seçimi hareket ettiğinde, ayrıldığında veya bağlı GuiBase2d'de veya ilgili herhangi bir GuiObjeleri değiştirdiğinde ateş eder.
Özellikler
Ambient
Bu özellik, ViewportFrame içindeki alan için uygulanan ışık renkini belirler.Varsayılan ışık renkleri ile şu anda Color3.fromRGB(200, 200, 200) (Hayalet gri).
CurrentCamera
Çocuk nesneleri render etmek için kullanılan Class.Camera instansı.Varsayılan nil .
Class.Camera nesnesi kopyalanmaz, bu yüzden ViewportFrame.CurrentCamera da kopyalanmaz. When you set this property, Camera.CFrame ve 1> Class.Camera.FieldOfView1> will be saved and
ImageColor3
Bu özellik, çekirdek nesneyi doğrudan değiştirmeden önce görüntü rengini nasıl değiştireceğini belirler, böylece görüntü rengini değiştirme işlemini doğrudan değiştirmeniz gerekmez.Varsayılan renk değiştirme değeri Color3.new(1, 1, 1) (beyaz) olarak belirlenmiştir.
Ayrıca bakın ImageTransparency , render edilen görüntünün görünürlüğünü belirleyen.
ImageTransparency
Bu özellik, çizimdeki görüntünün görünürlüğünü belirler, böylece çizim nesnelerini doğrudan değiştirmeden görüntünün görünürlüğünü değiştirebilirsiniz. Bir değer 0 (varsayılan) tamamen opaktır ve bir değer 1 tamamen透明 (görünmez)tir.
Ayrıca bakın ImageColor3 , bir görüntüyü renklemek için nasıl bir renkleyici olacağını belirleyen.