Kontainer UI dalam permainan menyimpan GuiObjects yang ingin Anda tampilkan di dunia 3D permainan Anda.
- SurfaceGui memungkinkan rendering objek UI pada permukaan bagian di dunia 3D sambil juga memungkinkan interaksi pengguna dasar terjadi.
- BillboardGui adalah kontainer untuk objek UI yang muncul di ruang 3D tetapi selalu menghadap kamera.
UI Permukaan
Mirip dengan Decals dan Textures, objek UI seperti TextLabels dan ImageLabels yang diparent ke SurfaceGui menghadap ke arah yang sama dengan permukaan tempat mereka berada, dapat diedit melalui properti SurfaceGui.Face.
Untuk menerapkan SurfaceGui ke BasePart dalam permainan, cukup parent ke bagian tersebut dan atur properti SurfaceGui.Face. Objek UI anak kemudian muncul di sisi bagian induk tersebut.
Sebagai alternatif, Anda dapat menempatkan SurfaceGui di dalam kontainer seperti StarterGui dan kemudian mengatur properti Adornee ke bagian BasePart mana pun, serta target Face. Mengatur Adornee menggantikan asosiasi induk langsung, memungkinkan lebih banyak fleksibilitas dalam penempatan karena dapat diatur dari skrip selama runtime.
Elemen UI interaktif seperti ImageButtons dan TextButtons di dalam SurfaceGui hanya akan menerima input pengguna jika mereka diparent ke PlayerGui pemain, biasanya dengan menempatkan SurfaceGui di dalam StarterGui seperti yang disebutkan di atas. Selain itu, properti CanQuery bagian harus true agar elemen UI interaktif menerima input.
Untuk membantu memilih sisi yang benar untuk SurfaceGui, klik kanan bagian target dan pilih Tampilkan Indikator Orientasi. Ini menampilkan lingkaran biru dengan F dan garis yang terhubung ke sisi Front objek, dan panah hijau yang menunjuk ke arah sisi Top objek.
Ukuran dan posisi
"Kanvas" dari SurfaceGui menempati seluruh Face dari bagian induk atau bagian Adornee. Sebagai praktik terbaik, disarankan agar Anda menggunakan nilai skala untuk ukuran dan posisi objek UI anak seperti ImageLabels. Anda juga dapat menerapkan UIAspectRatioConstraint pada anak-anak dari SurfaceGui untuk mempertahankan rasio aspek yang diinginkan terlepas dari ukuran sisi.
Mode Occlusion
Properti AlwaysOnTop menentukan apakah SurfaceGui akan dirender di atas konten 3D atau terhalang olehnya. Ketika diatur ke false (default), SurfaceGui dirender seperti konten 3D lainnya dan terhalang oleh objek 3D lainnya. Ketika diatur ke true, ia selalu dirender di atas konten 3D dan tidak dipengaruhi oleh kecerahan/cahaya di lingkungan 3D.
Pengaruh Kecerahan dan Cahaya
Brightness dan LightInfluence bekerja bersama untuk menentukan seberapa banyak cahaya lingkungan mempengaruhi konten UI dari SurfaceGui.
Brightness menentukan faktor di mana cahaya yang dipancarkan diskalakan dalam rentang 0 hingga 1000, memungkinkan Anda mencocokkan SurfaceGui dengan lingkungannya. Misalnya, billboard video dapat diterangi di dalam ruangan gelap dengan meningkatkan Brightness menjadi 10.
LightInfluence mengontrol seberapa banyak SurfaceGui dipengaruhi oleh pencahayaan di tempat, dalam rentang dari 0 hingga 1. Mengatur ini ke 1 berarti bahwa pencahayaan di sekitar memiliki kontrol penuh atas penampilan, sementara mengatur ini ke 0 berarti bahwa pencahayaan tidak memiliki efek.
Perhatikan bahwa Brightness tidak dapat diakses di Studio dan tidak memiliki efek ketika LightInfluence adalah 1 atau AlwaysOnTop adalah true.
Jarak Visibilitas
MaxDistance mengontrol seberapa jauh dari kamera SurfaceGui akan ditampilkan sebelum berhenti merender. Nilai 0 berarti tidak ada batas dan akan dirender tanpa batas jauh. Nilai default 1000 bekerja dengan baik untuk sebagian besar kasus.
Untuk SurfaceGuis yang muncul di luar ruangan, disarankan agar MaxDistance cukup tinggi untuk memastikan bahwa UI kontainer cukup kecil di layar saat muncul atau menghilang, meminimalkan efek pop‑in/out yang tiba-tiba.
Urutan Tampilan
Jika beberapa kontainer SurfaceGui ada di sisi yang sama, Anda dapat melapiskannya berdasarkan indeks Z melalui properti ZOffset mereka (mengubah ini tidak secara visual "mengangkat" atau "menenggelamkan" kontainer dari permukaan).
UI Billboard
Kontainer BillboardGui menampilkan objek UI di ruang 3D tetapi, tidak seperti SurfaceGui, anak-anak dari BillboardGui selalu menghadap kamera. Kontainer ini berguna untuk menampilkan informasi yang menghadap depan di atas objek dalam permainan seperti meter kesehatan atau nama di atas karakter pemain, penanda untuk membimbing pemain ke objek di dunia 3D, dan lainnya.
Untuk menghubungkan BillboardGui ke BasePart atau Attachment dalam permainan, cukup parent ke bagian atau attachment tersebut dan, jika diinginkan, sesuaikan ukuran/posisi nya.
Sebagai alternatif, Anda dapat menempatkan BillboardGui di dalam kontainer seperti StarterGui dan kemudian mengatur properti Adornee ke bagian BasePart atau Attachment mana pun. Metode ini menawarkan lebih banyak fleksibilitas dalam penempatan karena Adornee dapat diatur dari skrip selama runtime, misalnya untuk menempatkan BillboardGui di atas kepala karakter pemain selama runtime.
Elemen UI interaktif seperti ImageButtons dan TextButtons di dalam BillboardGui hanya akan menerima input pengguna jika mereka diparent ke PlayerGui pemain, biasanya dengan menempatkan BillboardGui di dalam StarterGui seperti yang disebutkan di atas.
Ukuran dan posisi
Untuk ukuran billboard, komponen skala dari properti Size mengatur ukuran stud billboard di ruang 3D. Misalnya, pengaturan {10, 0},{2, 0} (UDim2.fromScale(10, 2)) membentuk billboard dengan rasio aspek 10:2 yang skala lebih besar atau lebih kecil tergantung pada jaraknya dari kamera.
Untuk penempatan, properti StudsOffset menggeser kanvas billboard pada sumbu X (kiri/kanan), sumbu Y (atas/bawah), dan sumbu Z (maju/mundur) relatif terhadap kamera.
Saat membuat BillboardGui yang diskalakan ukuran yang berisi TextLabel, berguna untuk mengaktifkan properti TextScaled label sehingga teksnya diskalakan bersama dengan kanvas billboard saat jarak kamera berubah.
Mode Occlusion
Properti AlwaysOnTop menentukan apakah BillboardGui akan dirender di atas konten 3D atau terhalang olehnya. Ketika diatur ke false (default), BillboardGui dirender seperti konten 3D lainnya dan terhalang oleh objek 3D lainnya. Ketika diatur ke true, ia selalu dirender di atas konten 3D dan tidak dipengaruhi oleh kecerahan/cahaya di lingkungan 3D.
Pengaruh Kecerahan dan Cahaya
Brightness dan LightInfluence bekerja bersama untuk menentukan seberapa banyak cahaya lingkungan mempengaruhi konten UI dari BillboardGui.
Brightness menentukan faktor di mana cahaya yang dipancarkan diskalakan dalam rentang 0 hingga 1000, memungkinkan Anda mencocokkan BillboardGui dengan lingkungannya. Misalnya, billboard video dapat diterangi di dalam ruangan gelap dengan meningkatkan Brightness menjadi 10.
LightInfluence mengontrol seberapa banyak BillboardGui dipengaruhi oleh pencahayaan di tempat, dalam rentang dari 0 hingga 1. Mengatur ini ke 1 berarti bahwa pencahayaan di sekitar memiliki kontrol penuh atas penampilan, sementara mengatur ini ke 0 berarti bahwa pencahayaan tidak memiliki efek.
Perhatikan bahwa Brightness tidak dapat diakses di Studio dan tidak memiliki efek ketika LightInfluence adalah 1 atau AlwaysOnTop adalah true.
Jarak Visibilitas
MaxDistance mengontrol seberapa jauh dari kamera BillboardGui akan ditampilkan sebelum berhenti merender. Nilai 0 atau inf (default) berarti tidak ada batas dan akan dirender tanpa batas jauh.