BillboardGui
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
BillboardGuis, 3D alanında görünen GuiObjects için kutu taşıyıcılarıdır. BillboardGuis her zaman kameraya bakar ve mesafeyle büyüklüğü değiştirebilir veya BillboardGui.Size.
Onların pozisyonu BillboardGui.Adornee ile ilgilidir. Eğer bir Adornee ayarla, BillboardGui'nin ebeveyni kullanılır. BaseParts için, BillboardGui'nin <
Bir BillboardGui'nin özelliklerinden biri Size . Offset bölümü aynı şekilde çalışır, ancak Scale bölümü 3D alanındaki bir ölçek olarak kullanılır.
Bir boyut UDim2.fromScale(4, 5) 4x5 studs'dir ve menzil kamera'dan bağımsız olarak UI'yi daha büyük veya daha küçük ölçekler. Bir boyut UDim2.fromOffset(200, 100) 200
Size ölçeklenmiş BillboardGuis oluştururken, tüm UI nesnelerinin Boyutlandırma kullanıyor olduğundan emin olmak önemlidir, böylece doğru boyutlandırma garantisi için tüm metni TextLabel.TextScaled etkinleştirin.
Bir BillboardGui'nin ve tüm yol çizgilerinin üst kısmındaki AbsolutePosition özelliği, onun kanvasının üst kısmına göreli olduğundan, bu nedenle BillboardGui'nin durumiçin daima 0, 0'dir.
Performans için Statik UI'yu Geçici Olarak Kullanımda Bulundurma
Bir Gui'nin görünümü, aşağıdaki olaylardan biri gerçekleşene kadar önbelleğe kaydedilir:
- Bir soyundan Gui'ye eklenir.
- Bir soyundan Gui'den kaldırılır.
- GUI'nin bir soyundan gelme
- Gui'nin bir özelliği değiştirilir.
Bu olaylardan herhangi biri meydana gel, Gui'nin görünümü, çektiği bir sonraki karede yeniden hesaplanacaktır.
Özet
Özellikler
Yaşaltsızların giriş etkinliklerini alıp almayacağını kontrol eder.
BillboardGui'nin yerleştirileceği hedef parçasını veya bağlantısını ayarlar.
BillboardGui'nin 3D içeriğinin önünde veya arkasında görüntülenip görüntülenmeyeceğini belirler.
Class.BillboardGui.LightInfluence|LightInfluence 0 olduğunda GUI'nin ışığının büyüklüğünü belirleyen faktörü belirler.
Açık olarak ayarlandığında, BillboardGui'nin kanvas sınırları dışındaki GuiObjects bölümleri çizilmez.
BillboardGui ın oyuncunun kamerasından geldiği mevcut mesafe.
Class.BillboardGui büyük ölçeklenmeyi durduracak mesafeyi belirler.
Menzil, bu değerin artışlarına arttırılır.
Class.BillboardGui 'in boyutunu küçültmesine izin veren mesafeyi belirler.
BillboardGui'nin Adornee ile ilgili olarak Camera modelinin -yönlendirme ve birimleriyle ilgili olarak yarım boyutları modelinin Camera -yönlendirme kutusundaki kutusundaki kutusundaki kutusundaki kutusundaki kutusundaki kutusundaki kutusundaki kutusundaki kutusundaki kutusund
BillboardGui'nin küresel eksenler ve birimleriyle ilgili olarak Adornee 'sırasından kaçış değeriyle kaçış değerini belirler.
BillboardGui'nin çevre ışığının çevresindeki ışığa ne kadar etkilendiğini kontrol eder.
Bir afişin kameradan hala çekilebilir olabileceği maksimum mesafeyi ayarlar.
Belirli bir oyuncudan BillboardGui'yi gizlemek için kullanılır.
BillboardGui'nin ekranda ne kadar büyük olacağını kontrol eder.
Bir anka noktası gibi davranan 2D bir bozma noktası.
BillboardGui'nin Adornee 'i ile ilgili Camera yön ve birimleri üzerindeki uzaklığını belirler.
BillboardGui'nin global eksenleri ve birimleri ile ilgili Adornee 'sırasındaki ofsetini belirler.
Bu LayerCollector 'in görünürlüğünü değiştirir.
Oyuncunun karakterinin her yeniden doğduğunda LayerCollector sıfırlanıp kendini siler ve oyuncunun PlayerGui 'ine yeniden klonlanır.
Class.GuiObject.ZIndex ile bu LayerCollector ın tüm soyundan nasıl davranacağını kontrol eder.
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.
Etkinlikler
Şuradan alınan Etkinlikler: GuiBase2d- 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
Active
Çocukların giriş etkinliklerini alıp almayacağını kontrol eder. Eğer UI'nin bir GuiButton içeriyorsa, o düğme sadece giriş aktif olarak ayarlandığında tıklanabilir hale gelir.
BillboardGuis sadece PlayerGui'ye bağlantılıysa kullanıcı girdisini alacaktır. BillboardGui.Adornee özelliği, UI'nin kendisi ile PlayerGui arasındaki bir Parça'yı hedef alabilir.
Adornee
BillboardGui'nin yerleştirildiği hedef parçasını veya bağlantıyı ayarlar. Eğer bir Adornee ayarlanmazsa, Parent kullanılır.
AlwaysOnTop
BillboardGui'nin 3D içeriğinin üzerinde görünmesini veya gizlenmesini belirler.
Yanlış olarak ayarlandığında BillboardGui diğer 3D içerikleri gibi görüntülenir ve diğer 3D nesneler tarafından kapatılır.
Açık olarak ayarlanırsa, 3D içeriğinin üstünde her zaman görünür ve görünüm değiştirilir:
- Renkler, ScreenGui içinde göründüğü gibi eşleşir.
- Yüksek DPI cihazlarında metin daha keskin görünebilir.
- BillboardGui.LightInfluence tedavi edilirken 0 gibi davranılır.
- BillboardGui.Brightness hiçbir etkisi yoktur.
Brightness
Parlaklık GUI'nin emittiği ışığın ölçeğini belirler.Varsayılan olarak, bu özellik 1'dir ve menzil [0, 1000] arasında herhangi bir sayıya ayarlanabilir.
Bu özellik modifiye edilerek, bir GUI'nin görünüm açısından görünüm açısından çevreye daha iyi uyum sağlanabilir. durum, Times Square'da bulunan bir video afişi parlak bir günde açıkça görünür hale getirilebilir.
Bu özellik, GUI'nin ışığı üretmediği aşağıdaki senaryolarda herhangi bir etki üretmez:
- Class.BillboardGui.AlwaysOnTop|AlwaysOnTop doğruysa, her pikselin rengi ekranda gösterilen renk olur.
- Class.BillboardGui.LightInfluence|LightInfluence 1 olduğunda, GUI'den gelen tüm ışık ortamdan yansıtılır, yayılmak yerine.
ClipsDescendants
Açık olarak ayarlandığında, BillboardGui'nin kanvas sınırları dışındaki GuiObjects bölümleri çizilmez.
Bu özellik yanlışken bile, BillboardGui'nin kanvasının dışındaki nesneler render edilmez.
CurrentDistance
Class.BillboardGui ın oyuncunun kamerasındaki mevcut mesafe. Değiştirilmiş bir etkinlik, bu özellik için gui'nin BillboardGui.DistanceStep 'den fazla olması durumunda ateşlenmez.
DistanceLowerLimit
BillboardGui 'nin boyutu, oyuncunun mevcut kamerasına göre artık daha büyük ölçeklenmesi için kullanılan mesafe belirleyicidir. Guis'in boyutu bu değerin altındaysa, bu değerin üstünden daha büyük ölçeklenmeyecektir. Bu özelliğin değeri varsayılan olarak 0 stud'dur.
DistanceStep
oyuncukamerasının BillboardGui.CurrentDistance 'den daha yakın ve daha uzak hareket etmesiyle oluğu büyüklüğünü belirler. Özellik, BillboardGui 'den başlayan ve arttıkça düşen BillboardGui.DistanceLowerLimit değerine ayarlanır. Özellik varsayılır olarak 0'dur ve 1> Class.Billboard
Örneğin, bu özellik 0.5 olarak ayarlandı ve oyuncunun kamerası 0'dan başlayan gui'den ayrılıyorsa, CurrentDistance 0 -> 0.5 -> 1 -> 1.5 -> ... ve öylece devam eder.
DistanceUpperLimit
Bir BillboardGui ın boyutu, oyuncunun mevcut kamerasına göre daha küçük ölçeklenmesi için belirli mesafe belirler. Guis'in uzaklığı bu değerin üzerindeyse, bu uzaklıkta daha küçük ölçeklenmeyecektir.
Değer 0'dan daha düşükse bu özellik görülmez.Varsayılan değer -1, özellik normalde görülmez.
ExtentsOffset
BillboardGui'nin bir Class.BillboardGui.Adornee|Adorne 'den Class.Camera' eğilimi ve birimleri modelinin Class.Camera -alınlandırma kutusunun yarım boyutlarına eşdeğer olarak belirleyen bir Boşluk Offsetu olarak etkisi altındadır.
Ayrıca bakınız:
- ExtentsOffsetWorldSpace , która działa podobnie, z wyjątkiem tego, że ofset yönü globalnymi osi
- StudsOffset , ünite olarak çalışır, ancak ünite olarak değil
ExtentsOffsetWorldSpace
BillboardGui'nin küresel eksenleri ve birimleriyle ilgili olarak küresel eksenlerin bağlayıcı kutusunun boyutlarının yarısı kadar küçük olduğunu belirler. Bu, küresel eksenlerin bağlayıcı kutusunun boyutlarının yarısı kadar küçük olduğunu belirler. ExtentsOffsetWorldSpace
Ayrıca bakınız:
- ExtentsOffset , bu, ofset yönlendirmesi Camera ile ilgili olarak kullanılabilir
- StudsOffsetWorldSpace , ünite olarak çalışır, ancak ünite olarak değil
LightInfluence
BillboardGui'nin çevre ışığının çevresindeki ışığa ne kadar etkilendiğini kontrol eder.
0'a ayarlandığında, UI bir LCD ekranı gibi davranır, kendi ışık kaynağı olarak görünür ve çevre ışığına bağlı olarak aynı görünür.
1'e ayarlandığında, UI başka bir kağıt parçası gibi davranır, sadece ışığı başka bir kaynaktan yansıtır.
MaxDistance
Class.BillboardGui의 MaxDistance özelliği, afişin kameradan ne kadar uzakta olabileceğini ve hala çizilebilir olmasını sağlar. Kameranın ve afişin kuşak uzaklığı maksimum mesafeden daha uzaksa, afiş hala görünmez olur. Bu özellikteki varsayılan değer, afişin veya kutunun içindeki herhangi bir özellik ve
Bu değer 0'dan daha az veya eşit olarak düzenlenmişse, maksimum mesafe sonsuz olarak ele alınır ve afiş her zaman çekilebilir.
Örnek
-- Varsayılan kamerası/kontrol skriptlerinin yüklenmesini bekleyintask.wait(5)-- Nesneleri ilan et ve başlatlocal camera = workspace.CurrentCameralocal part = Instance.new("Part")local billboard = Instance.new("BillboardGui")local label = Instance.new("TextLabel")-- Kamera yazayarlacamera.CameraType = Enum.CameraType.Scriptable-- Parçanın konumunu ayarla ve kilit dünyapart.CFrame = CFrame.new(0, 10, 0)part.Anchored = true-- Billboard oluşturbillboard.MaxDistance = 10billboard.Adornee = partbillboard.AlwaysOnTop = truebillboard.Size = UDim2.fromOffset(50, 50)-- Etiket kuruldulabel.Size = UDim2.fromScale(1, 1)-- Nesnelerin ebeveynlerini ayarlarlabel.Parent = billboardbillboard.Parent = partpart.Parent = workspace-- Kamerayı parçanın yanına hareket ettir. Biraz bekle ve sonra kamerayı hareket ettirlocal cameraPosition0 = part.Position + Vector3.new(0, 0, 10)local cameraPosition1 = part.Position + Vector3.new(0, 0, 20)camera.CFrame = CFrame.lookAt(cameraPosition0, part.Position)-- Billboard'ın içeriği burada görüntülenirtask.wait(2)camera.CFrame = CFrame.lookAt(cameraPosition1, part.Position)-- Contents of billboard will no longer be visible (outside MaxDistance)
PlayerToHideFrom
Belirli bir oyuncudan BillboardGui'yi gizlemek için kullanılır.
Arayüz'ü birden fazla oyuncudan gizlemek için, BillboardGui'yi StarterGui içine yerleştir ve bir script kullanar
Size
BillboardGui'nin ekranda ne kadar büyük olacağını kontrol eder.
Büyüklük'ün Boyutu bileşeninin Scale öğesi, Scale değerleri kullanıldığında bir büyüklük olarak yorumlanır ve UI, Scale değerleri kullanıldığında mesafe ile otomatik olarak ölçeklenir.
Büyüklüğün boyutunun büyüklüği ve ofseti birbiriyle birleştirilir ve aynı anda kullanılabilir.
SizeOffset
Bir 2D yer ileti olarak hizmet veren 2D birimi. Bu, GuiObject.AnchorPoint özelliğine benzer, ancak değerler farklıdır.
Sıradan Değerler
| Boyutlandırma | Açıklama | | | | | | | | 0.0, 0.0 |Varsayılan. UI'nin merkezine bağlanacaktır. | | 0.5, 0.5 | UI'nin merkezine bağlanacaktır. | | 0
Ayrıca bakınız:
- StudsOffset , StudsOffsetWorldSpace , ExtentsOffset , 0> Class.ToolbarGui.ExtentsOffsetWorldSpace|ExtentsOffset0> , which are all other offset properties that work in 3D space instead
StudsOffset
StudsOffset BillboardGui'nin kaydının Adornee 'i ile ilgili olarak Camera yönlendirimi ile ne kadar ofset alacağını belirler.
Ayrıca bakınız:
- StudsOffsetWorldSpace , bu, ofset yönlendirmesi global eksenlere göre değilse çalışır
- ExtentsOffset , ünite olarak modellerin Kamerasının alan sınırının yarısından daha az çalışır
StudsOffsetWorldSpace
StudsOffsetWorldSpace BillboardGui'nin küresel eksenleri ile ilgili küresel eksenler arasındaki ofsetini belirler.
Ayrıca bakınız:
- StudsOffset , bu da ofsayt yönlendirmesi Camera ile ilgili olarak çalışır
- ExtentsOffsetWorldSpace , ünite olarak aynı şekilde çalışır, ancak ünite modellerinin eksenleriyle ilgili olarak yarım boyutlarında kalır