Deneyim içi UI konteynerleri

Deneyim içi UI konteynerleri, deneyiminizin 3D dünyasında görüntülemek istediğiniz GuiObjects içerir.

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

Yüzey UI

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

Deneyim içindeki bir BasePart'a SurfaceGui uygulamak için, onu o parçaya bağlı olarak yerleştirin ve SurfaceGui.Face özelliğini ayarlayın. Çocuk UI nesneleri daha sonra ebeveyn parçanın o yüzeyinde görünür.

Alternatif olarak, SurfaceGui'yu StarterGui gibi bir konteynıra koyabilir ve ardından Adornee özelliğini herhangi bir BasePart'a ve hedef Face'e ayarlayabilirsiniz. Adornee ayarlamak, doğrudan ebeveyn ilişkisini geçersiz kılarak yerleştirmede daha fazla esneklik sağlar, çünkü bu özellik çalıştırma sırasında bir betik aracılığıyla ayarlanabilir.

Boyut ve konum

SurfaceGui'nun "tuvali", ebeveyn veya Adornee parçasının tüm Face yüzeyini kaplar. En iyi uygulama olarak, çocuk UI nesnelerinin boyut ve konum değerleri için ölçek değerleri kullanmanız önerilir. Ayrıca, SurfaceGui'nun ç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'nun 3D içeriğin üstünde mi yoksa altında mı render edileceğini belirler. Bu false (varsayılan) olarak ayarlandığında, SurfaceGui diğer 3D içeriği gibi render edilir ve diğer 3D nesneler tarafından engellenir. true olarak ayarlandığında ise, 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 özellikleri, çevresel ışığın SurfaceGui'nun UI içeriğini nasıl etkilediğini belirlemek için işbirliği yapar.

Brightness, yayılan ışığın 0 ile 1000 arasında ölçeklendiği faktörü belirler ve SurfaceGui'yu çevresiyle eşleştirmenize olanak tanır. Örneğin, bir video panosu, Brightness değerini 10 olarak artırarak karanlık bir odada parlak hale getirilebilir.

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

Mesafe görünürlüğü

MaxDistance özelliği, SurfaceGui'nun ne kadar uzakta kameraya görüntüleneceğini kontrol eder; bu mesafe aşıldığında render etmeyi durdurur. 0 değeri, sınırsız anlamına gelir ve sonsuz bir mesafede render edilecektir. Varsayılan değer 1000 çoğu durum için uygundur.

Açık havada görünen SurfaceGuis için, konteynerin UI'sinin ekran üzerinde yeterince küçük görünmesini sağlamak için MaxDistance'ın yeterince yüksek olması önerilir; bu, aniden girip çıkma etkisini en aza indirir.

Görüntü sırası

Eğer aynı yüzeyde birden fazla SurfaceGui konteyneri varsa, onları ZOffset özelliği ile Z-indeksi üzerinden katmanlayabilirsiniz (bu değişiklik, konteynerin yüzeyden görsel olarak "kaldırılması" veya "içeri çekilmesi" anlamına gelmez).

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, deneyim içindeki nesnelerin üzerinde sağlık göstergeleri veya oyuncu karakterlerinin üzerinde isimler gibi, ön yüze bakan bilgileri göstermek için faydalıdır; oyuncuları 3D dünyasındaki bir nesneye yönlendiren işaretleyiciler gibi.

Bir BillboardGui'yu deneyim içindeki bir BasePart veya Attachment ile bağlantılandırmak için, sadece onu o parça veya eklemeye bağlı yapın ve isterseniz boyut/konum ayarlarını yapın.

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

Boyut ve konum

Billboard boyutlandırması için, Size özelliğinin ölçek bileşenleri, billboardun 3D alandaki stud boyutunu ayarlar. Örneğin, ayar {10, 0},{2, 0} (UDim2.fromScale(10, 2)), kamera uzaklığına bağlı olarak daha büyük veya daha küçük ölçeklenebilen 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'nun 3D içeriğin üstünde mi yoksa altında mı render edileceğini belirler. Bu false (varsayılan) olarak ayarlandığında, BillboardGui diğer 3D içeriği gibi render edilir ve diğer 3D nesneler tarafından engellenir. true olarak ayarlandığında ise, 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 özellikleri, çevresel ışığın BillboardGui'nun UI içeriğini nasıl etkilediğini belirlemek için işbirliği yapar.

Brightness, yayılan ışığın 0 ile 1000 arasında ölçeklendiği faktörü belirler ve BillboardGui'yu çevresiyle eşleştirmenize olanak tanır. Örneğin, karanlık bir odada bir video panosunun parlaklığı Brightness değerini 10 olarak artırarak artırılabilir.

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

Mesafe görünürlüğü

MaxDistance özelliği, BillboardGui'nun ne kadar uzakta kameraya görüntüleneceğini kontrol eder; bu mesafe aşıldığında render etmeyi durdurur. 0 veya inf (varsayılan) değeri, sınırsız anlamına gelir ve sonsuz bir mesafede render edilecektir.