Wadah UI dalam pengalaman menyimpan GuiObjects yang ingin Anda tampilkan dalam dunia 3D pengalaman Anda.
- A SurfaceGui memungkinkan rendering objek UI ke permukaan bagian di dunia 3D sambil juga memungkinkan interaksi pengguna dasar terjadi.
- A BillboardGui adalah wadah untuk objek UI muncul di ruang 3D tetapi selalu menghadap kamera.
Antarmuka UI Permukaan
Mirip dengan dan , objek UI seperti dan diberikan ke arah yang sama dengan permukaan di mana mereka berada, dapat diedit melalui properti .
Untuk menerapkan SurfaceGui pada pengalaman dalam BasePart , cukup berikan ke bagian itu dan atur properti SurfaceGui.Face.Objek UI anak kemudian muncul di wajah bagian orang tua.
Alternatifnya, Anda dapat menempatkan SurfaceGui di dalam wadah seperti StarterGui dan kemudian mengatur properti Adornee nya ke BasePart , serta target Face .Pengaturan Adornee menggantikan asosiasi orang tua 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 diberikan kepada pemain PlayerGui , biasanya melalui penempatan SurfaceGui di dalam StarterGui seperti yang dicatat di atas.
Untuk membantu dalam memilih wajah yang benar untuk SurfaceGui , klik kanan bagian target dan pilih Tampilkan Indikator Orientasi .Ini menampilkan lingkaran biru dengan F dan garis yang terpasang pada wajah objek Front dan panah hijau yang menunjuk ke arah wajah objek Top.
Ukuran dan posisi
The "kanvas" dari SurfaceGui menduduki seluruh Face dari orang tua atau Adornee bagian.Sebagai praktik terbaik, disarankan agar Anda menggunakan nilai skala untuk ukuran dan posisi anak UI seperti .Anda juga dapat menerapkan UIAspectRatioConstraint pada anak-anak dari SurfaceGui untuk menjaga rasio aspek yang diinginkan terlepas dari ukuran wajah.
Mode penutupan
Properti AlwaysOnTop menentukan apakah SurfaceGui akan ditampilkan di atas konten 3D atau ditutup olehnya.Saat ditetapkan ke false ( default ), SurfaceGui menampilkan seperti konten 3D lain dan ditutup oleh objek 3D lain.Ketika diatur ke true , itu selalu menampilkan di atas konten 3D dan tidak dipengaruhi oleh kecerahan/cahaya di lingkungan 3D.
Pengaruh kecerahan dan cahaya
Brightness dan LightInfluence bekerja bersama untuk menentukan bagaimana cahaya lingkungan mempengaruhi konten UI dari SurfaceGui .
Brightness menentukan faktor di mana cahaya yang dipancarkan diukur dalam rentang 0 hingga 1000 , memungkinkan Anda untuk mencocokkan SurfaceGui dengan lingkungannya.Sebagai kejadian, billboard video dapat ditingkatkan di dalam ruangan gelap dengan meningkatkan Brightness ke 10.
LightInfluence mengontrol berapa banyak SurfaceGui dipengaruhi oleh pencahayaan di tempat, 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.
Perhatikan bahwa Brightness tidak dapat diakses di Studio dan tidak memiliki efek ketika LightInfluence adalah 1 atau AlwaysOnTop adalah true .
Jarak terlihatnya
MaxDistance 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.
Tampilkan urutan
Jika beberapa kontainer SurfaceGui berada di wajah yang sama, Anda dapat melapisi mereka dengan Z‑index melalui properti ZOffset mereka (mengubah ini tidak secara visual "angkat" atau "tenggelamkan" kontainer dari permukaan).
Antarmuka Billboard
Wadah BillboardGui menampilkan objek UI di ruang 3D tetapi, tidak seperti SurfaceGui , anak-anak dari sebuah BillboardGui selalu menghadap kamera.Wadah ini berguna untuk menampilkan informasi berhadap depan di atas objek dalam pengalaman seperti meteran kesehatan atau nama di atas karakter pemain, penanda untuk membimbing pemain ke objek di dunia 3D, dan banyak lagi.
Untuk menautkan ke pengalaman atau , cukup berikan ke bagian atau lampiran itu dan, jika diinginkan, sesuaikan ukuran/posisinya .
Alternatifnya, Anda dapat menempatkan BillboardGui di dalam wadah seperti StarterGui dan kemudian mengatur properti Adornee nya ke salah satu BasePart atau Attachment .Metode ini menawarkan lebih banyak fleksibilitas dalam penempatan karena Adornee dapat ditetapkan 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 diberikan kepada pemain PlayerGui , biasanya melalui penempatan BillboardGui di dalam StarterGui seperti yang dicatat di atas.
Ukuran dan posisi
Untuk ukuran billboard, komponen skala dari set properti Size mengatur ukuran stud billboard di ruang 3D.Sebagai contoh, pengaturan {10, 0},{2, 0}( UDim2.fromScale(10, 2) ) membentuk billboard dengan rasio aspek 10:2 yang skalanya lebih besar atau lebih kecil tergantung pada jaraknya dari kamera.
Untuk penempatan, properti StudsOffset menggeser kanvas billboard di sumbu X (kiri/kanan), Y sumbu (naik/bawah), dan Z sumbu (maju/mundur) relatif terhadap kamera.
Saat membuat skala ukuran BillboardGui yang berisi TextLabel , berguna untuk mengaktifkan properti label TextScaled sehingga teksnya skala bersama dengan kanvas billboard saat jarak kamera berubah.
Mode penutupan
Properti AlwaysOnTop menentukan apakah BillboardGui akan ditampilkan di atas konten 3D atau ditutup olehnya.Saat ditetapkan ke false ( default ), BillboardGui menampilkan seperti konten 3D lain dan ditutup oleh objek 3D lain.Ketika diatur ke true , itu selalu menampilkan di atas konten 3D dan tidak dipengaruhi oleh kecerahan/cahaya di lingkungan 3D.
Pengaruh kecerahan dan cahaya
Brightness dan LightInfluence bekerja bersama untuk menentukan bagaimana cahaya lingkungan mempengaruhi konten UI dari BillboardGui .
Brightness menentukan faktor di mana cahaya yang dipancarkan diukur dalam rentang 0 hingga 1000 , memungkinkan Anda untuk mencocokkan BillboardGui dengan lingkungannya.Sebagai kejadian, billboard video dapat ditingkatkan di dalam ruangan gelap dengan meningkatkan Brightness ke 10.
LightInfluence mengontrol berapa banyak BillboardGui dipengaruhi oleh pencahayaan di tempat, 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.
Perhatikan bahwa Brightness tidak dapat diakses di Studio dan tidak memiliki efek ketika LightInfluence adalah 1 atau AlwaysOnTop adalah true .
Jarak terlihatnya
MaxDistance mengontrol seberapa jauh dari kamera BillboardGui akan ditampilkan sebelum berhenti menyajikan.Nilai 0 atau inf ( default ) berarti tidak ada batas dan akan menampilkan jauh tanpa batas.