Oyun içi UI konteynerleri

Oyun içi UI konteynerleri, oyununuzun 3D dünyasında görüntülemek istediğiniz GuiObjects'leri tutar.

• SurfaceGui, UI nesnelerinin 3D dünyadaki bir parçanın yüzeyine render edilmesine olanak tanırken, aynı zamanda temel kullanıcı etkileşiminin gerçekleşmesine de izin verir.
• BillboardGui, UI nesnelerinin 3D alanda görünmesini sağlayan bir konteynerdir ancak her zaman kameraya bakar.

Yüzey UI

Decals ve Textures ile benzer şekilde, SurfaceGui'ya bağlı olan TextLabels ve ImageLabels gibi UI nesneleri, bulundukları yüzeyle aynı yöne bakar ve SurfaceGui.Face özelliği ile düzenlenebilir.

Oyun içindeki bir BasePart'a SurfaceGui uygulamak için, onu o parçaya bağlı hale getirin ve SurfaceGui.Face özelliğini ayarlayın. Çocuk UI nesneleri, ardından ana parçanın o yüzeyinde görünür.

Alternatif olarak, SurfaceGui'yı StarterGui gibi bir konteynerin içine yerleştirebilir ve ardından Adornee özelliğini herhangi bir BasePart'a ve hedef Face'e ayarlayabilirsiniz. Adornee'yi ayarlamak, doğrudan ebeveyn ilişkisini geçersiz kılarak, yerleştirmede daha fazla esneklik sağlar çünkü bu, çalışma zamanında bir betik aracılığıyla ayarlanabilir.

Boyut ve konum

Bir SurfaceGui'nın "tuvali", ana veya Adornee parçasının tüm Face'ini kaplar. En iyi uygulama olarak, ImageLabels gibi çocuk UI nesnelerinin boyut ve konum değerleri için ölçek değerleri kullanmanız önerilir. Ayrıca, SurfaceGui'nın çocuklarına, yüzeyin boyutuna bakılmaksızın istenen en boy oranını korumak için bir UIAspectRatioConstraint uygulayabilirsiniz.

Engelleme modu

AlwaysOnTop özelliği, SurfaceGui'nın 3D içeriğin üstünde mi yoksa onun tarafından mı engelleneceğini belirler. false (varsayılan) olarak ayarlandığında, SurfaceGui diğer 3D içerikler gibi render edilir ve diğer 3D nesneler tarafından engellenir. true olarak ayarlandığında, her zaman 3D içeriğin üstünde render edilir ve 3D ortamda parlaklık/ışık tarafından etkilenmez.

Parlaklık ve ışık etkisi

Brightness ve LightInfluence, çevresel ışığın SurfaceGui'nın UI içeriğini nasıl etkilediğini belirlemek için birlikte çalışır.

Brightness, yayılan ışığın 0 ile 1000 arasında bir aralıkta ölçeklendiği faktörü belirler ve SurfaceGui'yı çevresine uyumlu hale getirir. Örneğin, bir video billboard'u karanlık bir odada Brightness değerini 10 artırarak aydınlatılabilir.

LightInfluence, SurfaceGui'nın mekandaki aydınlatmadan ne kadar etkilendiğini kontrol eder, 0 ile 1 arasında bir aralıkta. Bunu 1 olarak ayarlamak, çevredeki aydınlatmanın görünüm üzerinde tam kontrolü olduğu anlamına gelirken, 0 olarak ayarlamak, aydınlatmanın hiçbir etkisi olmadığı anlamına gelir.

Mesafe görünürlüğü

MaxDistance, SurfaceGui'nın kameradan ne kadar uzakta görüntüleneceğini kontrol eder ve render etmeyi durdurur. 0 değeri, sınırsız olduğu anlamına gelir ve sonsuz uzakta render edilir. Varsayılan değer 1000, çoğu durum için uygundur.

Açık havada görünen SurfaceGuis için, konteynerin UI'sinin ekranda yeterince küçük görünmesini sağlamak için MaxDistance değerinin yeterince yüksek olması önerilir, bu da ani görünme/ortadan kaybolma etkisini minimize eder.

Görüntüleme sırası

Eğer aynı yüzeyde birden fazla SurfaceGui konteyneri varsa, bunları ZOffset özelliği aracılığıyla Z-indeksi ile katmanlayabilirsiniz (bunu değiştirmek, görsel olarak konteyneri yüzeyden "kaldırmaz" veya "batırmaz").

Billboard UI

BillboardGui konteyneri, UI nesnelerini 3D alanda görüntüler ancak SurfaceGui'dan farklı olarak, BillboardGui'nın çocukları her zaman kameraya bakar. Bu konteyner, oyun içi nesnelerin üzerinde sağlık göstergeleri veya oyuncu karakterlerinin isimleri gibi ön yüz bilgilerini görüntülemek için, 3D dünyada bir nesneye oyuncuları yönlendirmek için ve daha fazlası için kullanışlıdır.

Bir BillboardGui'yı oyun içindeki bir BasePart veya Attachment ile bağlamak için, onu o parçaya veya eklemeye bağlı hale getirin ve istenirse boyut/konum ayarlarını yapın.

Alternatif olarak, BillboardGui'yı StarterGui gibi bir konteynerin içine yerleştirebilir ve ardından Adornee özelliğini herhangi bir BasePart veya Attachment'a ayarlayabilirsiniz. Bu yöntem, Adornee'nin çalışma zamanında bir betik aracılığıyla ayarlanabilmesi nedeniyle yerleştirmede daha fazla esneklik sağlar; örneğin, çalışma zamanında oyuncu karakterlerinin başının üzerine bir BillboardGui yerleştirmek için.

Boyut ve konum

Billboard boyutlandırması için, Size özelliğinin ölçek bileşenleri, billboard'un 3D alandaki stud boyutunu ayarlar. Örneğin, {10, 0},{2, 0} (UDim2.fromScale(10, 2)) ayarı, kameradan uzaklığına bağlı olarak daha büyük veya daha küçük ölçeklenen 10:2 en boy oranına sahip bir billboard oluşturur.

Konumlandırma için, StudsOffset özelliği, billboard tuvalini kameraya göre X ekseninde (sol/sağ), Y ekseninde (yukarı/aşağı) ve Z ekseninde (ileri/geri) kaydırır.

Engelleme modu

AlwaysOnTop özelliği, BillboardGui'nın 3D içeriğin üstünde mi yoksa onun tarafından mı engelleneceğini belirler. false (varsayılan) olarak ayarlandığında, BillboardGui diğer 3D içerikler gibi render edilir ve diğer 3D nesneler tarafından engellenir. true olarak ayarlandığında, her zaman 3D içeriğin üstünde render edilir ve 3D ortamda parlaklık/ışık tarafından etkilenmez.

Parlaklık ve ışık etkisi

Brightness ve LightInfluence, çevresel ışığın BillboardGui'nın UI içeriğini nasıl etkilediğini belirlemek için birlikte çalışır.

Brightness, yayılan ışığın 0 ile 1000 arasında bir aralıkta ölçeklendiği faktörü belirler ve BillboardGui'yı çevresine uyumlu hale getirir. Örneğin, bir video billboard'u karanlık bir odada Brightness değerini 10 artırarak aydınlatılabilir.

LightInfluence, BillboardGui'nın mekandaki aydınlatmadan ne kadar etkilendiğini kontrol eder, 0 ile 1 arasında bir aralıkta. Bunu 1 olarak ayarlamak, çevredeki aydınlatmanın görünüm üzerinde tam kontrolü olduğu anlamına gelirken, 0 olarak ayarlamak, aydınlatmanın hiçbir etkisi olmadığı anlamına gelir.

Mesafe görünürlüğü

MaxDistance, BillboardGui'nın kameradan ne kadar uzakta görüntüleneceğini kontrol eder ve render etmeyi durdurur. 0 veya inf (varsayılan) değeri, sınırsız olduğu anlamına gelir ve sonsuz uzakta render edilir.