SurfaceGui
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
SurfaceGui memungkinkan rendering objek UI ke permukaan bagian di dunia 3D sambil juga memungkinkan interaksi pengguna dasar terjadi.Mirip dengan dan , objek UI seperti dan diberikan ke arah yang sama dengan permukaan di mana mereka berada, dapat diedit melalui properti .

Perhatikan bahwa elemen UI interaktif seperti ImageButtons dan TextButtons di dalam SurfaceGui hanya akan menerima input pengguna jika mereka diberikan ke PlayerGui , biasanya melalui penempatan SurfaceGui di dalam StarterGui .Properti Adornee dapat digunakan untuk menargetkan bagian di dunia 3D sementara SurfaceGui sendiri tetap berada di PlayerGui .
Lihat UI dalam Pengalaman untuk panduan tentang bekerja dengan SurfaceGui wadah.
Perilaku Penyimpanan
Untuk membantu meningkatkan pelaksanaan, penampilan SurfaceGui tersimpan sampai salah satu berikut terjadi, setelah itu penampilannya akan dihitung ulang pada frame penyajian berikutnya.
- Seorang keturunan ditambahkan ke atau dihapus dari SurfaceGui .
- Properti dari keturunan dari perubahan SurfaceGui .
- Properti dari SurfaceGui itu sendiri berubah.
Rangkuman
Properti
Menentukan apakah SurfaceGui akan selalu ditampilkan di atas objek 3D lainnya.
Menentukan faktor di mana cahaya kontainer SurfaceGui diukur ketika LightInfluence adalah 0 .
Ukuran "layar virtual" di "piksel virtual" yang membuat SurfaceGuis piksel-ke-piksel kompatibel dengan ScreenGuis .
Apakah bagian dari GuiObjects yang jatuh di luar batas kanvas SurfaceGui akan ditarik.
Mengontrol seberapa banyak SurfaceGui dipengaruhi oleh pencahayaan lingkungan.
Mengontrol seberapa jauh SurfaceGui dapat ditampilkan sebelum berhenti menyajikan.
Menentukan kepadatan piksel yang digunakan untuk setiap stud ruang dunia untuk menampilkan konten dari SurfaceGui .
Menentukan apakah SurfaceGui akan ditampilkan dengan ukuran atau skala tetap dengan ukurannya dalam stud.
Tetapkan jarak di mana klik kiri mulai bertindak pada SurfaceGui alih-alih untuk yang dipegang Tool .
Tumpukan ini SurfaceGui dalam kaitannya dengan yang lain SurfaceGuis di wajah yang sama.
BasePart pada mana untuk menerapkan SurfaceGui , menggantikan asosiasi orang tua default.
Enum.NormalId wajah di mana untuk menerapkan SurfaceGui .
Mengubah visibilitas ini LayerCollector .
Menentukan apakah LayerCollector mereset (menghapus sendiri dan mengkloning kembali ke karakter pemain PlayerGui ) setiap kali karakter pemain bereinkarnasi.
Mengontrol bagaimana GuiObject.ZIndex berperilaku pada semua keturunan dari ini LayerCollector .
Menggambarkan posisi layar aktual dari elemen GuiBase2d , dalam piksel.
Menggambarkan rotasi layar aktual dari elemen GuiBase2d , dalam derajat.
Menggambarkan ukuran layar aktual dari elemen GuiBase2d , dalam piksel.
Ketika diatur ke true , lokalisasi akan diterapkan ke GuiBase2d dan keturunannnya.
Referensi ke LocalizationTable untuk digunakan untuk menerapkan lokalisasi otomatis ke GuiBase2d dan keturunannnya.
Sesuaikan perilaku pemilihan gamepad dalam arah turun.
Sesuaikan perilaku pemilihan gamepad di arah kiri.
Sesuaikan perilaku pemilihan gamepad di arah yang benar.
Sesuaikan perilaku pemilihan gamepad dalam arah atas.
Memungkinkan kustomisasi gerakan seleksi gamepad.
Acara
Acara diwarisi dari GuiBase2d- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Memicu ketika pemilihan gamepad bergerak ke, meninggalkan, atau berubah di dalam terhubung GuiBase2d atau keturunan mana pun GuiObjects .
Properti
AlwaysOnTop
Properti ini menentukan apakah SurfaceGui akan selalu ditampilkan di atas objek 3D lainnya.
Saat ditetapkan ke false ( default ), SurfaceGui menampilkan seperti konten 3D lain dan ditutup oleh objek 3D lain.Ketika diatur ke true , SurfaceGui selalu ditampilkan di atas konten 3D dan perubahan penampilan signifikan:
- Warna cocok dengan bagaimana mereka muncul di dalam ScreenGui .
- Teks mungkin tampak lebih tajam di perangkat DPI tinggi.
- LightInfluence diperlakukan seolah-olah itu 0 .
- Brightness tidak memiliki efek.
Brightness
Properti ini menentukan faktor di mana cahaya kontainer SurfaceGui diukur ketika LightInfluence adalah 0.Secara default, properti ini adalah 1 dan dapat ditetapkan ke nomor berapa pun antara 0 dan 1000 .Dengan memodifikasi properti ini, tingkat kecerahan yang tampak dari SurfaceGui dapat lebih sesuai dengan lingkungannya.Sebagai kejadian, billboard video dapat ditingkatkan di dalam ruangan gelap dengan meningkatkan Brightness ke 10.
Perhatikan bahwa Brightness tidak dapat diakses di Studio dan tidak memiliki efek ketika LightInfluence adalah 1 atau AlwaysOnTop adalah true .
CanvasSize
Ukuran "layar virtual" di "piksel virtual" yang membuat SurfaceGuis piksel-ke-piksel kompatibel dengan ScreenGuis .
ClipsDescendants
Ketika diatur ke true ( default ), bagian dari GuiObjects yang jatuh di luar batas kanvas SurfaceGui tidak akan ditarik.
Bahkan ketika properti ini adalah , yang berada di luar kanvas tidak akan ditampilkan.
LightInfluence
Mengontrol seberapa banyak SurfaceGui dipengaruhi oleh pencahayaan lingkungan, dalam rentang dari 0 hingga 1 .Mengatur ini ke 1 berarti bahwa pencahayaan di sekitarnya memiliki kontrol penuh atas penampilan, sementara mengatur ke 0 berarti bahwa pencahayaan tidak berpengaruh.
MaxDistance
Properti ini mengontrol seberapa jauh dari kamera SurfaceGui akan ditampilkan sebelum berhenti menyajikan.Nilai 0 berarti tidak ada batas dan akan menampilkan jauh tanpa batas.Nilai default dari 1000 bekerja dengan baik untuk sebagian besar kasus.
Untuk SurfaceGuis yang muncul di luar, disarankan agar MaxDistance cukup tinggi untuk memastikan bahwa UI kontainer cukup kecil di layar saat muncul atau menghilang, mengurangi efek pop-in/out tiba-tiba.
PixelsPerStud
Properti ini menentukan kepadatan piksel yang digunakan untuk setiap stud ruang dunia untuk menampilkan konten SurfaceGui .Nilai yang lebih tinggi akan menyebabkan berbagai GuiObjects di dalam muncul lebih kecil jika dipertahankan dengan ukuran yang sama.Sebaliknya, nilai yang lebih rendah akan menyebabkan objek tampak lebih besar.Namun, jika GuiObjects skala secara proporsional melalui penggunaan UIScale , GuiObject.Size , TextLabel.TextSize , atau serupa, properti ini memungkinkan untuk menggunakan definisi yang lebih tinggi.
Penting untuk memilih nilai berdasarkan seberapa jauh Anda mengharapkan pemain melihat SurfaceGui .Perhatikan juga bahwa densitas piksel besar dapat memengaruhi kinerja negatif jika wajah bagian yang dihias cukup besar.
SizingMode
Ketika diatur ke Enum.SurfaceGuiSizingMode.PixelsPerStud ( default ), SurfaceGui menampilkan dengan ukuran variabel berdasarkan PixelsPerStud dan ukuran permukaan dalam stud.
Ketika diatur ke Enum.SurfaceGuiSizingMode.FixedSize , SurfaceGui menampilkan dengan ukuran tetap yang ditetapkan melalui CanvasSize .
ToolPunchThroughDistance
Tetapkan jarak di mana klik kiri mulai bertindak pada SurfaceGui alih-alih untuk yang dipegang Tool .Jika karakter berada dalam jarak ini dari SurfaceGui, Tool tidak akan aktif saat diklik.
ZOffset
Tumpukan ini SurfaceGui dalam kaitannya dengan orang lain di wajah yang sama (mengubah ini tidak secara visual "angkat" atau "tenggelamkan" SurfaceGui dari permukaan).