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.
BillboardGui 3B uzayda görünmek için UI nesneleri için bir konteynerdir, ancak daima kameraya bakar.Konteynerin konumu, ebeveyn ile ilişkilidir BasePart veya Attachment (veya Adornee ).For BaseParts için, Position özelliği kullanılırken, For Attachments için, WorldPosition özelliği kullanılır.

Bir reklam panosunun Size özelliği, GuiObject.Size 'den biraz farklı çalışır. ofset bileşenleri aynı çalışırken, ölçek bileşenleri 3B uzayda vida boyutları olarak kullanılır.
Bir boyut ölçekli BillboardGui oluştururken, bir TextLabel içeren etiketin TextScaled özelliğini etkinleştirmek, metninin kamera mesafesi değiştikçe billboard kanvasında ölçekleneceği için etiketin özelliğini etkinleştirmek yararlıdır.
Etkileşimli UI öğeleri örneğin ve içindeki bir , genellikle içine yerleştirilerek yalnızca kullanıcı girişi alacaktır.Adornee özelliği, 3B dünyada bir parçayı veya ekleri hedef almak için kullanılabilirken BillboardGui kendisi hala PlayerGui 'da kalır.
Deneyimsel UI üzerinde çalışma konusunda bir rehber için BillboardGui konteynerleri ile çalışın.
Kaydetme Davranışı
sözleşme imzalamaartırmaya yardımcı olmak için, bir BillboardGui 'nin görünümü, aşağıdakilerden biri gerçekleşene kadar geçici olarak depolanır ve ardından görünümü bir sonraki renderleme çerçevesinde yeniden hesaplanır.
- Bir alt seçenek BillboardGui 'ye eklenir veya kaldırılır.
- BillboardGui değişen bir altının özelliği. Bir özellik değişir.
- BillboardGui kendisinin bir özelliği değişir.
Özet
Özellikler
Varlıkların mirasçılarının giriş etkinliklerini alıp almayacağını kontrol eder.
Hedef parçayı veya ekleri BillboardGui nereye konumlandığına göre ayarlar.
BillboardGui ın daima diğer 3B nesnelerin üzerinde görüntülenip görüntülenmeyeceğini belirler.
BillboardGui konteynerin ışığının LightInfluence ölçeklendirildiği faktörü belirler, 0 olduğunda ışık ölçeklenir.
GuiObjects kanvas sınırlarının dışına düşen bölümlerin çizilecek olup olmadığı BillboardGui
BillboardGui ın mevcut mesafesi oyuncunun kamerasından geliyor.
BillboardGui'nin daha büyük boyutlara ölçek atlamasını durduracağı mesafe milimetrelerini belirler.
oyuncukamerasının CurrentDistance daha yakın ve BillboardGui daha uzak hareket etmesiyle birlikte artış ve azalma boyutunu belirler.
BillboardGui'nin daha küçük boyutlara ölçek atlamasını durduracağı mesafe milimetrelerini belirler.
BillboardGui 'nin modelin Adornee yönüne göre nasıl ofset edileceğini belirler, Camera yönüyle ilgili olarak, modelin Camera kenarlı sınır kutusunun yarı ölçeğinde bir birime.
'nin küresel eksenlere göre modelin eksen yönlü sınır kutusunun yarı ölçeğinde nasıl ofset edileceğini belirler, modelin eksen yönlü sınır kutusunun ölçeğinin yarısı bir birime eşit.
BillboardGui'nin çevresel aydınlatma tarafından ne kadar etkilendiğini kontrol eder.
Renderlemeyi durdurmadan önce BillboardGui ne kadar uzakta görüntülenebileceğini kontrol eder.
Senaryolar tarafından belirli bir oyuncudan BillboardGui gizlemek için kullanılır.
BillboardGui'nin ekranda sahip olacağı boyutu kontrol eder.
Bir ankraj noktası gibi davranan boyutla ilgili 2D ofset.
ın studlara göre nasıl ofset edileceğini belirler, yönüne göre.
BillboardGui ın küçültülmesinin küresel eksenlere göre nasıl gerçekleşeceğini belirler, Adornee ile ilgili.
Bu LayerCollector 'nin görünürlüğünü değiştirir.
Oyuncunun karakteri her yeniden doğduğunda sıfırlar (kendini sildi ve oyuncunun karakterini yeniden klonladı) ve oyuncunun karakteri her yeniden doğduğunda sıfırlar.
GuiObject.ZIndex nin bu LayerCollector 'nin tüm yan ürünlerinde nasıl davrandığını kontrol eder.
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.
Etkinlikler
Şuradan alınan Etkinlikler: GuiBase2d- 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
Active
Varlıkların mirasçılarının giriş etkinliklerini alıp almayacağını kontrol eder.Eğer içinde bir varsa, bu düğme yalnızca ve düğmelerin her ikisine de ayarlanırsa tıklanabilir olur.
Etkileşimli UI öğeleri örneğin ve içindeki bir , genellikle içine yerleştirilerek yalnızca kullanıcı girişi alacaktır.Adornee özelliği, 3B dünyada bir parçayı veya ekleri hedef almak için kullanılabilirken BillboardGui kendisi hala PlayerGui 'da kalır.
Adornee
Hedef BasePart veya Attachment ın BillboardGui konumlandığına ilişkin hedefi ayarlar, ebeveyn parçayı veya ekleri üzerinde geçersiz kılar.
AlwaysOnTop
Bu özellik, BillboardGui 'nin daima diğer 3B nesnelerin üzerinde görüntülenecek olup olmadığını belirler.
Varsayılan olarak false (öntanımlı) ayarlanırsa, BillboardGui diğer 3D içerikler gibi görüntülenir ve diğer 3D nesneler tarafından engellenir.true olarak ayarlanırken, BillboardGui daima 3B içeriğin üzerinde görünür ve görünüm önemli ölçüde değişir:
- Renkler bir ScreenGui içinde nasıl göründüğüne eşit olur.
- Metin, yüksek DPI cihazlarda daha keskin görünebilir.
- LightInfluence , sanki 0 olsaydı gibi ele alınır.
- Brightness hiçbir etkisi yoktur.
Brightness
Bu özellik, BillboardGui konteynerin ışığının LightInfluence ölçeklendirildiği faktörü belirler, 0 olduğunda.Varsayılan olarak, bu özellik ve ve arasındaki herhangi bir sayıya ayarlanabilir.Bu özelliği değiştirerek, bir 'in görünür parlaklığı çevresine daha iyi uyabilir.durum, bir video reklam karanlık bir odanın içinde aydınlatılabilir, çünkü 'i 'ya artırır.
Stüdyoda Brightness 'nin erişilemez olduğunu ve herhangi bir etkisi olmadığını unutmayın, çünkü LightInfluence ya da 1 ya da AlwaysOnTop ya da true olursa.
ClipsDescendants
Varsayılan olarak ayarlandığında, kanvas sınırlarının dışına düşen bölümler çizilmeyecektir.
Bu özellik false olduğunda bile, kanvasın dışında bulunan GuiObjects , tamamen renderlanmayacak.
CurrentDistance
BillboardGui ın mevcut mesafesi oyuncunun kamerasından geliyor.Değiştirilmiş bir olay bu özellik için ateş etmez, daha fazla olmadığı sürece.
DistanceLowerLimit
BillboardGui'nin oyuncunun mevcut kamerasına kıyasla daha büyük ölçekte artış yapmayı bırakacağı mesafeyi belirler, varsayılan olarak 0 .Eğer 'in değeri bu değerin altında ise, bu mesafede olduğundan daha büyük ölçeklenecek değil.
DistanceStep
oyuncukamerasının CurrentDistance daha yakın ve BillboardGui daha uzak hareket etmesiyle birlikte artış ve azalma boyutunu belirler.Özellik 0 olarak varsayılır ve DistanceLowerLimit 'dan başlayarak yuvarlanır.
DistanceUpperLimit
BillboardGui'nin oyuncunun mevcut kamerasına kıyasla daha küçük ölçekte durması gereken mesafeyi milimetre olarak belirler.Eğer ının bu değerden yukarıda olması durumunda, bu mesafede olduğundan daha küçük ölçeklenecek değil.
Bu özellik, değer 0 'den az ise göz ardı edilir.Varsayılan değer -1 , yani özellik varsayılan olarak göz ardı edilir.
ExtentsOffset
Bu özellik, BillboardGui 'nin modelin Adornee özelliklerine göre, Camera yönüyle, modelin Camera kenarlı sınır kutusunun yarı ölçeğinde nasıl ofset edileceğini belirler.
Ayrıca bakınız StudsOffset benzer çalışan ancak stüdyen birimleri kullanan veya ExtentsOffsetWorldSpace global eksenlere göre benzer çalışan ancak ofset yönü global eksenlere göre olanlar.
ExtentsOffsetWorldSpace
Bu özellik, 'nin küresel eksenlere göre modelin eksen yönlü sınır kutusunun yarı ölçeğinde nasıl ofset edileceğini belirler, modelin eksen yönlü sınır kutusunun boyutlarına ilişkin.
Ayrıca bakınız StudsOffset ki benzer şekilde çalışıyor ancak çalışma birimi kullanıyor veya ExtentsOffset ki ofset yönü Camera ile ilgili olması dışında benzer şekilde çalışıyor.
LightInfluence
BillboardGui ın çevresel aydınlatmadan ne kadar etkilendiğini, 0 ile 1 arasında bir menzilde kontrol eder.Bunu 1 olarak ayarlamak, çevreleyen aydınlatmanın görünüm üzerinde tam kontrole sahip olduğunu, 0 olarak ayarlamak ise aydınlatmanın hiçbir etkisi olmadığını ifade eder.
MaxDistance
Bu özellik, renderlemeyi durdurmadan önce BillboardGui'nin kameradan ne kadar uzakta görüntüleneceğini kontrol eder.0 veya inf (Varsayılan) değeri, sınırın olmadığı ve sonsuz derecede uzakta görüneceği anlamına gelir.
Dışarıda görünen BillboardGuis için, konteynerin UI'sinin ekranda göründüğünde veya kaybolduğunda yeterince küçük olduğundan emin olmak için MaxDistance yeterince yüksek olması önerilir, ani pop-in / out etkisini azaltarak.
PlayerToHideFrom
Senaryolar tarafından belirli bir oyuncudan BillboardGui gizlemek için kullanılır.
Bir oyuncudan daha fazlasını gizlemek için bir BillboardGui 'yi yerleştirin StarterGui ve bir Enabled özelliğini görüntüleyip görüntülemeyeceğine göre bir LocalPlayer özelliğini ayarlamak için bir senaryo kullanınAdornee özelliği, onu ebeveynleştirmek yerine BillboardGui 'e bağlamak için kullanılabilir BasePart veya Attachment 'e bağlanabilir Workspace , yerine.
Size
BillboardGui'nin ekranda sahip olacağı boyutu kontrol eder.Farklı olarak GuiObject.Size , bu özellikteki ölçek bileşenleri, reklam panosunun kalıp boyutunu 3B uzayda ayarlar.
SizeOffset
Bir ankraj noktası gibi davranan boyutla ilgili 2D ofset.Bu, GuiObject.AnchorPoint özelliğine benzer şekilde kullanılabilir, ancak değerler farklıdır.
<tbody><tr><td><code>0, 0</code></td><td>Arayüzün merkezine sabitleneceği varsayım. The default in which UI will be anchored at its center.</td></tr><tr><td><code>0.5, 0.5</code></td><td>Arayüz sol alt köşeye sabitlenecektir.</td></tr><tr><td><code>0.5, -0.5</code></td><td>Arayüz sol üstte sabitlenecektir.</td></tr><tr><td><code>-0.5, 0.5</code></td><td>Arayüz sağ üstte sabitlenecektir.</td></tr><tr><td><code>-0.5, -0.5</code></td><td>Arayüz sağ alt köşeye sabitlenecek.</td></tr></tbody>
Boyut Ofseti | Açıklama |
---|
Ayrıca bakın StudsOffset , StudsOffsetWorldSpace , ExtentsOffset ve ExtentsOffsetWorldSpace , 3B uzayda çalışan ofset özellikleri yerine.
StudsOffset
Bu özellik, BillboardGui 'nin çubuklara göre nasıl ofset edileceğini belirler Adornee , Camera yönüne göre.
Ayrıca bakın StudsOffsetWorldSpace , ofset yönü küresel eksenlere göre olması dışında benzer çalışan.
StudsOffsetWorldSpace
Bu özellik, BillboardGui ın küçültülmesinin küresel eksenlere göre nasıl olduğunu belirler, Adornee ile ilgili.
Ayrıca bakınız StudsOffset , ofset yönü Camera 'ye göre farklı olsa da benzer çalışır.