SurfaceGui
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
Memungkinkan untuk menampilkan elemen GUI di permukaan bagian dalam dunia 3D, sementara memungkinkan untuk terjadinya interaksi pengguna dasar. SurfaceGuis harus menjadi turunan dari PlayerGui untuk mengetahui pemain mana yang berinteraksi dengannya.
Menyimpan UI statis untuk meningkatkan kinerja
Penampilan Gui dicache sampai salah satu dari berikut peristiwa terjadi:
- Seorang turunan ditambahkan ke Gui.
- Sebuah turunan dihapus dari Gui.
- Properti dari turunan Gui.
- Propinsi dari Gui berubah.
Jika salah satu dari acara ini terjadi, tampilan Gui akan dihitung ulang di frame berikutnya yang dihasilkan.
Rangkuman
Properti
Menentukan apakah SurfaceGui akan selalu rendah di atas 3D lainnya.
Mengukur faktor di mana cahaya GUI diubah ketika LightInfluence adalah 0.
Ukuran 'layar virtual', dalam 'Pixel virtual', yang membuat SurfaceGuis pixel-to-pixel kompatibel dengan ScreenGuis.
Setel ke benar, bagian dari GuiObjek yang jatuh di luar batas kanvas SurfaceGui tidak akan ditunjukkan.
Mengontrol seberapa banyak SurfaceGui terpengaruh oleh penerangan di dunia game.
Mengontrol seberapa jauh SurfaceGui dapat ditampilkan sebelum berhenti rendah.
Mengukur jumlah pixel ruang layar per ruang dunia yang digunakan untuk menyajikan konten SurfaceGui.
Menentukan apakah SurfaceGui akan rendah dengan ukuran tetap atau skala dengan ukurannya di studs.
Tetapkan jarak yang tersisa dari klik mulai bertindak di permukaan gui alih-alih alat yang dipegang.
Menghapus SurfaceGui relatif terhadap permukaan yang dianggap normal.
Mengubah kesichtasan dari item ini LayerCollector .
Menentukan apakah LayerCollector resets (menghapus diri dan mengklon kembali ke karakter pemain) setiap kali karakter pemain respawns.
Mengontrol cara GuiObject.ZIndex berperilaku terhadap semua cucu dari LayerCollector ini.
Menggambarkan posisi layar sebenarnya dari elemen UI, dalam pixel.
Menggambarkan rotasi layar sebenarnya dari elemen UI, dalam derajat.
Menggambarkan ukuran layar sebenarnya dari elemen UI, dalam pixel.
Ketika diatur ke benar, lokalisasi akan diterapkan ke GuiBase2d dan pendahulunya.
Sebuah referensi ke Class.LocalizationTable untuk digunakan untuk menerapkan lokalisasi otomatis ke GuiBase2d dan pendahulunya.
Mengubah perilaku pemilihan gamepad ke arah bawah.
Mengubah perilaku pemilihan gamepad di arah kiri.
Mengubah perilaku pemilihan gamepad ke arah yang benar.
Mengubah perilaku pemilihan gamepad ke arah atas.
Memungkinkan kustomisasi gerakan pemilihan gamepad.
Acara
Acara diwarisi dari GuiBase2d- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Dibakar saat pemilihan gamepad bergerak ke, pergi, atau berganti di dalam GuiBase2d atau GuiObjek Descendant apa pun.
Properti
AlwaysOnTop
Menentukan apakah SurfaceGui akan rending di atas konten 3D, atau diblokir olehnya.
Ketika diatur ke false, SurfaceGui akan rending seperti konten 3D lainnya, dan akan ditutup oleh objek 3D lainnya.
Ketika diatur ke benar, itu selalu rendah di atas konten 3D, dan perubahan penampilan signifikan:
- Warna cocok dengan cara mereka muncul di dalam ScreenGui .
- Teks mungkin tampak lebih tajam di perangkat DPI tinggi.
- SurfaceGui.LightInfluence diperlakukan seolah-olah itu adalah 0.
- SurfaceGui.Brightness tidak berpengaruh.
Brightness
Kecerahan menentukan faktor dengan mana cahaya yang dikeluarkan GUI diukur. Secara default, property ini adalah 1 dan dapat diatur ke nomor apa pun dalam rentang [0, 1000].
Dengan mengubah kecerahan ini, kecerahan matahari yang terang akan lebih baik dicocokkan dengan lingkungannya. kejadian, tanda video seperti yang ditemukan di Times Square dapat dibuat lebih terang untuk dilihat dengan jelas di hari yang cerah.
Elemen ini tidak akan menghasilkan efek apa pun dalam skenario berikut di mana GUI tidak menghasilkan cahaya.:
- Ketika AlwaysOnTop benar, warna setiap pixel adalah warna yang ditunjukkan di layar.
- Ketika LightInfluence adalah 1, semua cahaya dari GUI di refleksikan dari lingkungan sebagai bukan emisi.
CanvasSize
Ukuran 'layar virtual', dalam 'Pixel virtual', yang membuat SurfaceGuis pixel-to-pixel kompatibel dengan ScreenGuis.
ClipsDescendants
Setel ke benar, bagian dari GuiObjek yang jatuh di luar batas kanvas SurfaceGui tidak akan ditunjukkan.
Bahkan ketika property ini salah, objek yang sepenuhnya di luar kanvas SurfaceGui tidak akan rendah.
LightInfluence
Mengontrol seberapa banyak SurfaceGui terpengaruh oleh penerangan di dunia game.
MaxDistance
Mengontrol seberapa jauh SurfaceGui dapat ditampilkan sebelum berhenti rendah.Nilai 0 berarti tidak ada batas, dan itu akan rendah tanpa batas.
Untuk pengalaman dengan banyak SurfaceGuis, disarankan untuk menetapkan nilai ini ke nilai yang sesuai untuk setiap SurfaceGui.Nilai default saat menyisipkan SurfaceGui ke Studio adalah 1000, yang seharusnya baik-baik saja untuk kebanyakan penggunaan.
Untuk UI yang berada di luar, Anda harus menetapkan Jarak Maksimum sejauh yang cukup jauh sehingga UI kecil di layar saat pop-out, sekitar 10 pixel di sekitar. Ini menjadikannya kurang terlihat saat pop-out.
Anda dapat mengurangi pop-up secara efektif bahkan lebih dengan menambahkan decal yang terlihat mirip di bawah SurfaceGui, atau dengan mengubah warna bagian untuk mencocokkan warna latar belakang UI Anda.
Untuk ruangan dalam, MaxDistance seharusnya diatur sedikit lebih besar dari ukuran ruangan, sehingga UI tidak akan rendah ketika pemain berada di ruangan yang berbeda.
PixelsPerStud
PixelsPerStud menentukan kedensitas pixel yang digunakan untuk setiap stud ruang dunia untuk menyajikan konten dari SurfaceGui.
Nilai yang lebih tinggi akan menyebabkan berbagai GuiObject dalam untuk tampak lebih kecil jika
SizingMode
Ketika diatur ke Enum.SurfaceGuiSizingMode.FixedSize, SurfaceGui menyajikan dengan ukuran tetap yang diatur menggunakan SurfaceGui.CanvasSize.
Ketika diatur ke Enum.SurfaceGuiSizingMode.PixelsPerStud, SurfaceGui menyajikan dengan ukuran variabel berdasarkan SurfaceGui.PixelsPerStud dan ukuran SurfaceGui dalam studs.
ToolPunchThroughDistance
Tetapkan jarak yang tersisa dari klik dimulai bertindak di permukaan gui alih-alih alat yang dipegang. Jika karakter berada dalam jarak ini dari gui permukaan, maka alat tidak akan aktif saat klik.