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.

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

  • Paralel oku

    Yaşaltsızların giriş etkinliklerini alıp almayacağını kontrol eder.

  • Paralel oku

    BillboardGui'nin yerleştirileceği hedef parçasını veya bağlantısını ayarlar.

  • Paralel oku

    BillboardGui'nin 3D içeriğinin önünde veya arkasında görüntülenip görüntülenmeyeceğini belirler.

  • Paralel oku

    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.

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

    BillboardGui ın oyuncunun kamerasından geldiği mevcut mesafe.

  • Class.BillboardGui büyük ölçeklenmeyi durduracak mesafeyi belirler.

  • Paralel oku

    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.

  • Paralel oku

    Bir afişin kameradan hala çekilebilir olabileceği maksimum mesafeyi ayarlar.

  • Belirli bir oyuncudan BillboardGui'yi gizlemek için kullanılır.

  • Paralel oku

    BillboardGui'nin ekranda ne kadar büyük olacağını kontrol eder.

  • Paralel oku

    Bir anka noktası gibi davranan 2D bir bozma noktası.

  • Paralel oku

    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.

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

Etkinlikler

Şuradan alınan Etkinlikler: GuiBase2d

Özellikler

Active

Paralel oku

Ç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

Paralel oku

BillboardGui'nin yerleştirildiği hedef parçasını veya bağlantıyı ayarlar. Eğer bir Adornee ayarlanmazsa, Parent kullanılır.

AlwaysOnTop

Paralel oku

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:

Brightness

Paralel oku

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

Paralel oku

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

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

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

Paralel oku

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

Paralel oku

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

Paralel oku

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

Paralel oku

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

Paralel oku

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:

LightInfluence

Paralel oku

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

Paralel oku

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 bekleyin
task.wait(5)
-- Nesneleri ilan et ve başlat
local camera = workspace.CurrentCamera
local part = Instance.new("Part")
local billboard = Instance.new("BillboardGui")
local label = Instance.new("TextLabel")
-- Kamera yazayarla
camera.CameraType = Enum.CameraType.Scriptable
-- Parçanın konumunu ayarla ve kilit dünya
part.CFrame = CFrame.new(0, 10, 0)
part.Anchored = true
-- Billboard oluştur
billboard.MaxDistance = 10
billboard.Adornee = part
billboard.AlwaysOnTop = true
billboard.Size = UDim2.fromOffset(50, 50)
-- Etiket kuruldu
label.Size = UDim2.fromScale(1, 1)
-- Nesnelerin ebeveynlerini ayarlar
label.Parent = billboard
billboard.Parent = part
part.Parent = workspace
-- Kamerayı parçanın yanına hareket ettir. Biraz bekle ve sonra kamerayı hareket ettir
local 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ülenir
task.wait(2)
camera.CFrame = CFrame.lookAt(cameraPosition1, part.Position)
-- Contents of billboard will no longer be visible (outside MaxDistance)

PlayerToHideFrom

Paralel oku

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

Paralel oku

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

Paralel oku

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

Paralel oku

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

Paralel oku

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

Yöntemler

Etkinlikler