BillboardGui

Artık kullanılmayanları göster

*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.

BillboardGui with a TextLabel describing the screen console it floats above.

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

Şuradan alınan Özellikler: LayerCollectorŞuradan alınan Özellikler: GuiBase2d

Etkinlikler

Şuradan alınan Etkinlikler: GuiBase2d

Özellikler

Active

Paralel oku

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

Paralel oku

Hedef BasePart veya Attachment ın BillboardGui konumlandığına ilişkin hedefi ayarlar, ebeveyn parçayı veya ekleri üzerinde geçersiz kılar.

AlwaysOnTop

Paralel oku

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

Paralel oku

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

Paralel oku

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

Salt Okunur
Çoğaltılmamış
Paralel oku

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

Paralel oku

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

Paralel oku

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

Paralel oku

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

Paralel oku

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

Paralel oku

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

Paralel oku

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

Paralel oku

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

Paralel oku

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

Paralel oku

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

Paralel oku

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 OfsetiAçıklama

Ayrıca bakın StudsOffset , StudsOffsetWorldSpace , ExtentsOffset ve ExtentsOffsetWorldSpace , 3B uzayda çalışan ofset özellikleri yerine.

StudsOffset

Paralel oku

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

Paralel oku

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.

Yöntemler

Etkinlikler