SurfaceGui
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
SurfaceGui 3B dünyada bir parçanın yüzeyine UI nesnelerinin görüntülenmesine izin verirken temel kullanıcı etkileşiminin meydana gelde izin verir.Decals ve Textures ile benzer şekilde, TextLabels ve ImageLabels gibi arayüz nesneleri, SurfaceGui özellikleri aracılığıyla yüzeyleriyle aynı yönde karşı karşıya gelir ve Face özellikleri aracılığıyla düzenlenebilir.
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ı hedef almak için kullanılabilirken SurfaceGui kendisi hala PlayerGui 'da kalır.
Deneyimsel UI üzerinde çalışma konusunda bir rehber için SurfaceGui konteynerleri ile çalışın.
Kaydetme Davranışı
sözleşme imzalamaartırmaya yardımcı olmak için, bir SurfaceGui '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 SurfaceGui 'ye eklenir veya kaldırılır.
- SurfaceGui değişen bir altının özelliği. Bir özellik değişir.
- SurfaceGui kendisinin bir özelliği değişir.
Özet
Özellikler
SurfaceGui ın daima diğer 3B nesnelerin üzerinde görüntülenip görüntülenmeyeceğini belirler.
SurfaceGui konteynerin ışığının LightInfluence ölçeklendirildiği faktörü belirler, 0 olduğunda ışık ölçeklenir.
piksel-piksel uyumlu hale getiren "sanal piksel" içindeki "sanal ekran"ın boyutu, ile uyumlu.
GuiObjects kanvas sınırlarının dışına düşen bölümlerin çizilecek olup olmadığı SurfaceGui
SurfaceGui'nin çevresel aydınlatma tarafından ne kadar etkilendiğini kontrol eder.
Renderlemeyi durdurmadan önce SurfaceGui ne kadar uzakta görüntülenebileceğini kontrol eder.
Her dünya uzayının içeriğini göstermek için kullanılan piksel sayısını belirler SurfaceGui .
SurfaceGui 'nin sabit bir boyutta veya çubuk büyüklüğünde bir ölçekle görüntülenecek olup olmadığını belirler.
Sol tıklamanın etkileşime geçmeye başladığı mesafeyi ayarlar SurfaceGui yerine tutulan Tool için yerine.
Bu SurfaceGui katmanlarını aynı yüze ilişkin diğer SurfaceGuis katmanlarla birleştirin.
BasePart üzerine SurfaceGui uygulanacak, varsayılan ebeveyn ilişkisini geçersiz kılacak
Enum.NormalId yüze, SurfaceGui uygulanacak.
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
AlwaysOnTop
Bu özellik, SurfaceGui 'nin daima diğer 3B nesnelerin üzerinde görüntülenecek olup olmadığını belirler.
Varsayılan olarak false (öntanımlı) ayarlanırsa, SurfaceGui diğer 3D içerikler gibi görüntülenir ve diğer 3D nesneler tarafından engellenir.true olarak ayarlanırken, SurfaceGui 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, SurfaceGui 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.
CanvasSize
piksel-piksel uyumlu hale getiren "sanal piksel" içindeki "sanal ekran"ın boyutu, ile uyumlu.
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.
LightInfluence
SurfaceGui ı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 SurfaceGui'nin kameradan ne kadar uzakta görüntüleneceğini kontrol eder.Bir değer 0 sınır yok demektir ve sonsuz uzakta görünecektir.Varsayılan değer 1000 çoğu durum için iyi çalışır.
Dışarıda görünen SurfaceGuis 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.
PixelsPerStud
Bu özellik, her dünya uzayının içeriğini göstermek için kullanılan piksel sayısını belirler SurfaceGui .Daha yüksek değerler, aynı boyutta tutulduklarında çeşitli GuiObjects içinde daha küçük görünmesine neden olacaktır.Tersine, daha düşük değerler nesnelerin daha büyük görünmesine neden olacaktır.Ancak, eğer GuiObjects ile UIScale , GuiObject.Size , TextLabel.TextSize veya benzeri ile orantısal olarak ölçeklendirilirse, bu özellik daha yüksek tanımın kullanılmasına izin verir.
Bir oyuncunun SurfaceGui 'yi görmesini beklediğiniz uzaklığa göre bir değer seçmek önemlidir.Ayrıca, büyük bir piksel yoğunluğunun donatılan parçanın yüzü yeterince büyükse performansı olumsuz etkileyebileceğini unutmayın.
SizingMode
Varsayılan olarak Enum.SurfaceGuiSizingMode.PixelsPerStud (öntanımlı) ayarlandığında, SurfaceGui değişken boyutta görüntüler ve yüzeyin boyutu üzerinde çalışır PixelsPerStud.
Enum.SurfaceGuiSizingMode.FixedSize olarak ayarlanırken, SurfaceGui sabit bir boyutla görüntülenir CanvasSize aracılığıyla.
ToolPunchThroughDistance
Sol tıklamanın etkileşime geçmeye başladığı mesafeyi ayarlar SurfaceGui yerine tutulan Tool için yerine.Bir karakter SurfaceGui 'in bu mesafesindeyse, Tool tıkladığında etkinleşmeyecektir.
ZOffset
Aynı yüzeydeki diğerlerine ilişkin olarak bunu SurfaceGui çizin (bunu değiştirmek görsel olarak yüzeyden "kaldırmıyor" veya "sokmuyor" SurfaceGui ).