Kontainer UI dalam pengalaman menyimpan GuiObjects yang ingin Anda tampilkan dalam dunia 3D pengalaman Anda.
- SurfaceGui memungkinkan untuk merender objek UI pada permukaan bagian di dunia 3D sekaligus 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 yang mereka letakkan, dapat diedit melalui properti SurfaceGui.Face.
Untuk menerapkan SurfaceGui ke BasePart dalam pengalaman, cukup parent ke bagian itu dan atur properti SurfaceGui.Face. Objek UI child kemudian akan muncul di sisi tersebut dari bagian parent.
Sebagai alternatif, Anda dapat menempatkan SurfaceGui di dalam kontainer seperti StarterGui dan kemudian mengatur properti Adornee ke bagian BasePart apa pun, serta target Face. Menetapkan Adornee menggantikan asosiasi parent 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 melalui penempatan SurfaceGui di dalam StarterGui seperti yang disebutkan di atas. Selain itu, properti CanQuery dari bagian harus true untuk elemen UI interaktif agar menerima input.
Untuk membantu memilih wajah yang tepat untuk SurfaceGui, klik kanan pada bagian target dan pilih Tampilkan Indikator Orientasi. Ini menampilkan lingkaran biru dengan F dan garis yang terpasang ke wajah Front objek, dan panah hijau yang menunjuk ke arah wajah Top objek.
Ukuran dan posisi
"Kanvas" dari SurfaceGui menempati seluruh Face dari bagian parent atau Adornee. Sebagai praktik terbaik, disarankan untuk menggunakan nilai skala untuk ukuran dan posisi dari objek UI child seperti ImageLabels. Anda juga dapat menerapkan UIAspectRatioConstraint pada anak dari SurfaceGui untuk menjaga rasio aspek yang diinginkan terlepas dari ukuran wajah.
Mode Okklusi
Properti AlwaysOnTop menentukan apakah SurfaceGui akan dirender di atas konten 3D atau terhalangi olehnya. Ketika diatur ke false (default), SurfaceGui dirender seperti konten 3D lainnya dan terhalangi oleh objek 3D lainnya. Ketika diatur ke true, itu selalu dirender di atas konten 3D dan tidak dipengaruhi oleh kecerahan/cahaya di lingkungan 3D.
Kecerahan dan pengaruh 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 disesuaikan dalam rentang 0 hingga 1000, memungkinkan Anda menyesuaikan SurfaceGui dengan lingkungannya. Misalnya, billboard video dapat diterangi di dalam ruangan gelap dengan meningkatkan Brightness hingga 10.
LightInfluence mengontrol seberapa banyak SurfaceGui dipengaruhi oleh pencahayaan di tempat tersebut, dalam rentang dari 0 hingga 1. Menetapkan ini ke 1 berarti bahwa pencahayaan di sekitar memiliki kontrol penuh atas penampilan, sementara menetapkannya ke 0 berarti bahwa pencahayaan tidak memiliki efek.
Perlu dicatat bahwa Brightness tidak dapat diakses di Studio dan tidak memiliki efek ketika either 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 batasan dan akan merender tak terhingga jauh. Nilai default 1000 berfungsi baik untuk sebagian besar kasus.
Untuk SurfaceGuis yang muncul di luar ruangan, disarankan bahwa 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 melapisnya berdasarkan indeks-Z melalui properti ZOffset mereka (mengubah ini tidak "mengangkat" atau "menenggelamkan" kontainer secara visual dari permukaan).
UI Billboard
Kontainer BillboardGui menampilkan objek UI di ruang 3D tetapi, tidak seperti SurfaceGui, anak dari BillboardGui selalu menghadap kamera. Kontainer ini berguna untuk menampilkan informasi yang menghadap depan di atas objek dalam pengalaman seperti meter kesehatan atau nama di atas karakter pemain, penanda untuk memandu pemain ke objek di dunia 3D, dan lainnya.
Untuk menghubungkan BillboardGui ke BasePart dalam pengalaman atau Attachment, 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 melalui penempatan BillboardGui di dalam StarterGui seperti yang disebutkan di atas.
Ukuran dan posisi
Untuk ukuran billboard, komponen skala dari properti Size mengatur ukuran stu billboard di ruang 3D. Misalnya, pengaturan {10, 0},{2, 0} (UDim2.fromScale(10, 2)) membentuk billboard dengan rasio aspek 10:2 yang akan 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/mandek) relatif terhadap kamera.
Saat membuat BillboardGui yang disesuaikan ukurannya dan mengandung TextLabel, akan berguna untuk mengaktifkan properti TextScaled label tersebut sehingga teksnya menyesuaikan seiring dengan perubahan jarak kamera.
Mode Okklusi
Properti AlwaysOnTop menentukan apakah BillboardGui akan dirender di atas konten 3D atau terhalangi olehnya. Ketika diatur ke false (default), BillboardGui dirender seperti konten 3D lainnya dan terhalangi oleh objek 3D lain. Ketika diatur ke true, itu selalu dirender di atas konten 3D dan tidak dipengaruhi oleh kecerahan/cahaya di lingkungan 3D.
Kecerahan dan pengaruh cahaya
Brightness dan LightInfluence bekerja sama untuk menentukan seberapa banyak cahaya lingkungan mempengaruhi konten UI dari BillboardGui.
Brightness menentukan faktor di mana cahaya yang dipancarkan disesuaikan dalam rentang 0 hingga 1000, memungkinkan Anda menyesuaikan BillboardGui dengan lingkungannya. Misalnya, billboard video dapat diterangi di dalam ruangan gelap dengan meningkatkan Brightness hingga 10.
LightInfluence mengontrol seberapa banyak BillboardGui dipengaruhi oleh pencahayaan di tempat tersebut, dalam rentang dari 0 hingga 1. Menetapkan ini ke 1 berarti bahwa pencahayaan di sekitar memiliki kontrol penuh atas penampilan, sementara menetapkannya ke 0 berarti bahwa pencahayaan tidak memiliki efek.
Perlu dicatat bahwa Brightness tidak dapat diakses di Studio dan tidak memiliki efek ketika either 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 batasan dan akan merender tak terhingga jauh.