BillboardGui
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
BillboardGui adalah wadah untuk objek UI muncul di ruang 3D tetapi selalu menghadap kamera.Posisi wadah relatif terhadap orangtua BasePart atau Attachment (atau Adornee ).Untuk BaseParts , properti Position digunakan, sementara untuk Attachments , properti WorldPosition digunakan.

Properti billboard Size bekerja sedikit berbeda dari GuiObject.Size .Sementara komponen offset bekerja sama, komponen skala digunakan sebagai ukuran stud di ruang 3D.
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.
Perhatikan bahwa elemen UI interaktif seperti ImageButtons dan TextButtons di dalam BillboardGui hanya akan menerima input pengguna jika mereka diberikan ke PlayerGui , biasanya melalui penempatan BillboardGui di dalam StarterGui .Properti Adornee dapat digunakan untuk menargetkan bagian atau lampiran di dunia 3D sementara BillboardGui sendiri tetap berada di PlayerGui .
Lihat UI dalam Pengalaman untuk panduan tentang bekerja dengan BillboardGui wadah.
Perilaku Penyimpanan
Untuk membantu meningkatkan pelaksanaan, penampilan BillboardGui tersimpan sampai salah satu berikut terjadi, setelah itu penampilannya akan dihitung ulang pada frame penyajian berikutnya.
- Seorang keturunan ditambahkan ke atau dihapus dari BillboardGui .
- Properti dari keturunan dari perubahan BillboardGui .
- Properti dari BillboardGui itu sendiri berubah.
Rangkuman
Properti
Mengontrol apakah keturunan akan menerima peristiwa input.
Tetapkan bagian atau lampiran target yang dituju oleh BillboardGui .
Menentukan apakah BillboardGui akan selalu ditampilkan di atas objek 3D lainnya.
Menentukan faktor di mana cahaya kontainer BillboardGui diukur ketika LightInfluence adalah 0 .
Apakah bagian dari GuiObjects yang jatuh di luar batas kanvas BillboardGui akan ditarik.
Jarak saat ini dalam studs bahwa BillboardGui berasal dari kamera pemain.
Menentukan jarak dalam stud di mana BillboardGui akan berhenti membesar dalam ukuran.
Menentukan peningkatan dan penurunan ukuran CurrentDistance dalam stud saat kamera pemain bergerak lebih dekat dan lebih jauh dari BillboardGui.
Menentukan jarak dalam stud di mana BillboardGui akan berhenti membesarkan ukuran yang lebih kecil.
Menentukan bagaimana BillboardGui diimbangkan dari Adornee , relatif terhadap orientasi Camera , dalam unit setengah dimensi kotak pengikat model Camera -terikat.
Menentukan bagaimana BillboardGui diimbangkan dari Adornee , relatif terhadap sumbu global, dalam unit setengah dimensi kotak batas model yang diarahkan ke sumbu model.
Mengontrol seberapa banyak BillboardGui dipengaruhi oleh pencahayaan lingkungan.
Mengontrol seberapa jauh BillboardGui dapat ditampilkan sebelum berhenti menyajikan.
Digunakan oleh skrip untuk menyembunyikan BillboardGui dari pemain tertentu.
Mengontrol ukuran yang akan dimiliki BillboardGui di layar.
Offset 2D dalam unit berukuran relatif yang bertindak seperti titik pengait.
Menentukan bagaimana BillboardGui dihapus dari Adornee dalam stud, relatif terhadap orientasi Camera.
Menentukan bagaimana BillboardGui dikurangkan dari Adornee dalam stud, relatif terhadap sumbu global.
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
Active
Mengontrol apakah keturunan akan menerima peristiwa input.Jika BillboardGui berisi GuiButton , tombol itu hanya akan menjadi klikable jika Active diatur ke true pada kedua BillboardGui dan tombol.
Perhatikan bahwa elemen UI interaktif seperti ImageButtons dan TextButtons di dalam BillboardGui hanya akan menerima input pengguna jika mereka diberikan ke PlayerGui , biasanya melalui penempatan BillboardGui di dalam StarterGui .Properti Adornee dapat digunakan untuk menargetkan bagian atau lampiran di dunia 3D sementara BillboardGui sendiri tetap berada di PlayerGui .
Adornee
Tetapkan target atau yang posisinya relatif terhadap, menggantikan bagian atau lampiran orang tua.
AlwaysOnTop
Properti ini menentukan apakah BillboardGui akan selalu ditampilkan di atas objek 3D lainnya.
Saat ditetapkan ke false ( default ), BillboardGui menampilkan seperti konten 3D lain dan ditutup oleh objek 3D lain.Ketika diatur ke true , BillboardGui 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 BillboardGui 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 BillboardGui 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 .
ClipsDescendants
Ketika diatur ke true ( default ), bagian dari GuiObjects yang jatuh di luar batas kanvas BillboardGui tidak akan ditarik.
Bahkan ketika properti ini adalah , yang berada di luar kanvas tidak akan ditampilkan.
CurrentDistance
Jarak saat ini dalam studs bahwa BillboardGui berasal dari kamera pemain.Peristiwa yang diubah tidak menembak untuk properti ini kecuali DistanceStep lebih dari 0.
DistanceLowerLimit
Menentukan jarak dalam stud di mana BillboardGui akan berhenti membesar dalam ukuran relatif terhadap kamera saat ini pemain, dengan default 0 .Jika CurrentDistance dari BillboardGui berada di bawah nilai ini, itu tidak akan meningkat lebih besar dari yang akan terjadi pada jarak ini DistanceLowerLimit .
DistanceStep
Menentukan peningkatan dan penurunan ukuran CurrentDistance dalam stud saat kamera pemain bergerak lebih dekat dan lebih jauh dari BillboardGui.Properti default ke 0 dan bulat mulai dari DistanceLowerLimit .
DistanceUpperLimit
Menentukan jarak dalam stud di mana BillboardGui akan berhenti memperkecil ukuran relatif terhadap kamera saat ini pemain.Jika CurrentDistance dari BillboardGui adalah di atas nilai ini, itu tidak akan menyusut lebih kecil dari yang akan terjadi pada jarak ini DistanceUpperLimit .
Properti ini diabaikan jika nilainya kurang dari 0 . Nilai default adalah -1 , artinya properti diabaikan secara default.
ExtentsOffset
Properti ini menentukan bagaimana BillboardGui dihapus dari Adornee , relatif terhadap orientasi Camera , dalam unit setengah dimensi kotak pengikat model Camera -terikat.
Lihat juga StudsOffset yang berfungsi serupa tetapi menggunakan unit stud, atau ExtentsOffsetWorldSpace yang berfungsi serupa kecuali orientasi offset adalah relatif terhadap sumbu global.
ExtentsOffsetWorldSpace
Properti ini menentukan bagaimana BillboardGui dikurangkan dari Adornee , relatif terhadap sumbu global, dalam unit setengah dimensi kotak batas model yang disesuaikan.
Lihat juga StudsOffset yang berfungsi serupa tetapi menggunakan unit stud, atau ExtentsOffset yang berfungsi serupa kecuali orientasi offset adalah relatif terhadap Camera.
LightInfluence
Mengontrol seberapa banyak BillboardGui 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 BillboardGui akan ditampilkan sebelum berhenti menyajikan.Nilai 0 atau inf ( default ) berarti tidak ada batas dan akan menampilkan jauh tanpa batas.
Untuk BillboardGuis 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.
PlayerToHideFrom
Digunakan oleh skrip untuk menyembunyikan BillboardGui dari pemain tertentu.
Untuk menyembunyikan BillboardGui dari lebih dari satu pemain, letakkan di StarterGui dan gunakan skrip untuk mengatur properti Enabled sesuai dengan apakah LocalPlayer harus dapat melihatnya.Properti Adornee dapat digunakan untuk menempelkan BillboardGui ke BasePart atau Attachment di Workspace , bukan membesarkannya.
Size
Mengontrol ukuran yang akan dimiliki BillboardGui di layar.Tidak seperti GuiObject.Size , komponen skala dari set properti ini menetapkan ukuran stud billboard di ruang 3D.
SizeOffset
Offset 2D dalam unit berukuran relatif yang bertindak seperti titik pengait.Ini dapat digunakan secara serupa dengan properti GuiObject.AnchorPoint, tetapi nilainya berbeda.
<tbody><tr><td><code>0, 0</code></td><td>Default di mana UI akan diberikan di pusatnya.</td></tr><tr><td><code>0.5, 0.5</code></td><td>UI akan diberi pijakan di bagian bawah kiri.</td></tr><tr><td><code>0.5, -0.5</code></td><td>UI akan diberi pijakan di bagian atas kiri.</td></tr><tr><td><code>-0.5, 0.5</code></td><td>UI akan diberi pijakan di bagian atas kanan.</td></tr><tr><td><code>-0.5, -0.5</code></td><td>UI akan mendarat di bagian kanan bawah.</td></tr></tbody>
Penyesuaian Ukuran | Penjelasan |
---|
Lihat juga StudsOffset , StudsOffsetWorldSpace , ExtentsOffset , dan ExtentsOffsetWorldSpace yang merupakan properti offset yang berfungsi di ruang 3D sebagai gantinya.
StudsOffset
Properti ini menentukan bagaimana BillboardGui dihapus dari Adornee dalam stud, relatif terhadap orientasi Camera.
Lihat juga StudsOffsetWorldSpace yang berfungsi serupa kecuali orientasi offset adalah relatif terhadap sumbu global.
StudsOffsetWorldSpace
Properti ini menentukan bagaimana BillboardGui dihapus dari Adornee dalam stud, relatif terhadap sumbu global.
Lihat juga StudsOffset yang berfungsi serupa kecuali orientasi offset adalah relatif terhadap Camera.