BillboardGui
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
BillboardGuis adalah container untuk GuiObjects yang muncul di ruang 3D. BillboardGuis selalu menghadap kamera, dan dapat mengubah ukuran dengan jarak atau tetap ukuran yang sama di layar berdasarkan BillboardGui.Size property.
Posisi mereka relatif terhadap BillboardGui.Adornee. Jika tidak ada Adornee yang atur, maka orang tua BillboardGui akan digunakan sebagai adornee. Untuk BaseParts, property Class.BasePart.
Properti Size dari BillboardGui bekerja sedikit berbeda dari GuiObject.Size . Bagian Offset bekerja sama, tetapi bagian Scale digunakan sebagai ukuran dalam studs di ruang 3D.
Ukuran UDim2.fromScale(4, 5) adalah 4x5 studs, dan menyesuaikan UI lebih besar dan lebih kecil tergantung pada jarak dari kamera. Ukuran UDim2.fromOffset(200, 100) selalu 200x100 di
Saat membuat BillboardGuis ukuran skala, penting untuk memastikan semua objek UI dalam menggunakan Scale sizing dan semua teks memiliki TextLabel.TextScaled yang aktif, untuk menjamin skalasi yang benar.
Propiedad AbsolutePosition dari BillboardGui dan semua cucuannya relatif ke sudut atas kiri kanvasnya, dan begitu juga selalu 0, 0 untuk kejadianBillboardGui.
Menyimpan UI Statis untuk Kinerja
Penampilan Gui dicache sampai salah satu dari berikut peristiwa terjadi:
- Seorang turunan ditambahkan ke Gui.
- Sebuah turunan dihapus dari Gui.
- Properti dari turunan Gui.
- Propinsi dari Gui berubah.
Jika salah satu dari acara ini terjadi, tampilan Gui akan dihitung ulang di frame berikutnya yang dihasilkan.
Rangkuman
Properti
Mengontrol apakah cucu akan menerima acara input.
Tetapkan bagian atau lampiran target yang BillboardGui berada relatif terhadap.
Menentukan apakah BillboardGui akan rendah di depan konten 3D atau di belakangnya.
Mengukur faktor di mana cahaya GUI diubah ketika LightInfluence adalah 0.
Ketika diaktifkan ke benar, bagian dari GuiObjects yang jatuh di luar batas kanvas BillboardGui tidak akan ditunjukkan.
Jarak saat ini dalam studs bahwa BillboardGui berasal dari kamera pemain.
Mengukur jarak dalam studs bahwa BillboardGui akan berhenti skalasi lebih besar di ukuran pada.
Jarak akan dibulatkan menjadi peningkatan nilai ini.
Mengukur jarak dalam studs bahwa BillboardGui akan berhenti skalasi lebih kecil di ukuran.
Menentukan bagaimana BillboardGui berOffset dari Class.BillboardGui.Adornee|Adorne , relatif terhadap orientasi dan unit Class.Camera -terkait, setengah dari dimensi model's Class.Camera -berlokasi dan unit adalah.
Menentukan seberapa Offset BillboardGui dari Class.BillboardGui.Adornee|Adornee , relatif terhadap sumbu global dan unit adalah setengah dari dimensi sumbu model.
Mengontrol seberapa banyak BillboardGui terpengaruh oleh penerangan di lingkungan.
Mengatur jarak maksimum yang dapat ditunjukkan papan dari kamera dan masih bisa dibuat.
Digunakan oleh skrip untuk menyembunyikan BillboardGui dari pemain tertentu.
Mengontrol ukuran yang akan dimiliki BillboardGui di layar.
SebuahOffset 2D dalam unit-ukuran relatif yang bertindak seperti poin tancap.
Menentukan seberapa Offset BillboardGui dari Class.BillboardGui.Adornee|Adornee , relatif terhadap orientasi dan unit Class.Camera dalam studs.
Menentukan seberapa Offset BillboardGui dari Class.BillboardGui.Adornee|Adornee , relatif terhadap sumbu global dan unit dalam studs.
Mengubah kesichtasan dari item ini LayerCollector .
Menentukan apakah LayerCollector resets (menghapus diri dan mengklon kembali ke karakter pemain) setiap kali karakter pemain respawns.
Mengontrol cara GuiObject.ZIndex berperilaku terhadap semua cucu dari LayerCollector ini.
Menggambarkan posisi layar sebenarnya dari elemen UI, dalam pixel.
Menggambarkan rotasi layar sebenarnya dari elemen UI, dalam derajat.
Menggambarkan ukuran layar sebenarnya dari elemen UI, dalam pixel.
Ketika diatur ke benar, lokalisasi akan diterapkan ke GuiBase2d dan pendahulunya.
Sebuah referensi ke Class.LocalizationTable untuk digunakan untuk menerapkan lokalisasi otomatis ke GuiBase2d dan pendahulunya.
Mengubah perilaku pemilihan gamepad ke arah bawah.
Mengubah perilaku pemilihan gamepad di arah kiri.
Mengubah perilaku pemilihan gamepad ke arah yang benar.
Mengubah perilaku pemilihan gamepad ke arah atas.
Memungkinkan kustomisasi gerakan pemilihan gamepad.
Acara
Acara diwarisi dari GuiBase2d- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Dibakar saat pemilihan gamepad bergerak ke, pergi, atau berganti di dalam GuiBase2d atau GuiObjek Descendant apa pun.
Properti
Active
Mengontrol apakah cucu akan menerima acara masukan. Jika UI berisi GuiButton maka tombol itu hanya akan menjadi klikable jika Aktif di set ke benar di kedua BillboardGui dan tombol.
BillboardGuis hanya akan menerima input pengguna jika mereka berada dalam urutan kepada PlayerGui. Propiedad BillboardGui.Adornee dapat digunakan untuk menargetkan Bagian di ruang kerja sementara UI itu sendiri berada dalam PlayerGui .
Adornee
Tetapkan bagian atau lampiran target yang BillboardGui berada relatif terhadap. Jika tidak ada Adornee yang atur, maka Parent digunakan.
AlwaysOnTop
Menentukan apakah BillboardGui akan rending di atas konten 3D, atau diblokir olehnya.
Ketika diatur ke false, BillboardGui akan rendah seperti konten 3D lainnya, dan akan ditutup oleh objek 3D lainnya.
Ketika diatur ke benar, itu selalu rendah di atas konten 3D, dan perubahan penampilan signifikan:
- Warna cocok dengan cara mereka muncul di dalam ScreenGui .
- Teks mungkin tampak lebih tajam di perangkat DPI tinggi.
- BillboardGui.LightInfluence diperlakukan seolah-olah itu adalah 0.
- BillboardGui.Brightness tidak berpengaruh.
Brightness
Kecerahan menentukan faktor dengan mana cahaya yang dikeluarkan GUI diukur. Secara default, property ini adalah 1 dan dapat diatur ke nomor apa pun dalam rentang [0, 1000].
Dengan mengubah kecerahan ini, kecerahan matahari yang terang akan lebih baik dicocokkan dengan lingkungannya. kejadian, tanda video seperti yang ditemukan di Times Square dapat dibuat lebih terang untuk dilihat dengan jelas di hari yang cerah.
Elemen ini tidak akan menghasilkan efek apa pun dalam skenario berikut di mana GUI tidak menghasilkan cahaya.:
- Ketika AlwaysOnTop benar, warna setiap pixel adalah warna yang ditunjukkan di layar.
- Ketika LightInfluence adalah 1, semua cahaya dari GUI di refleksikan dari lingkungan sebagai bukan emisi.
ClipsDescendants
Ketika diaktifkan ke benar, bagian dari GuiObjects yang jatuh di luar batas kanvas BillboardGui tidak akan ditunjukkan.
Bahkan ketika property ini salah, objek yang sepenuhnya di luar kanvas BillboardGui tidak akan rendah.
CurrentDistance
Jarak saat ini dalam studs bahwa BillboardGui adalah dari kamera pemain. Acara berubah tidak mengeksekusi untuk properti ini kecuali jika gui's BillboardGui.DistanceStep lebih dari 0.
DistanceLowerLimit
Mengukur jarak dalam studs bahwa BillboardGui akan berhenti menyesuaikan ukuran lebih besar relatif terhadap kamera pemain saat ini. Jika jarak gui di bawah nilai ini, itu tidak akan di-scale lebih besar daripada yang akan di-scale di jarak ini.Nilai dari property ini bervariasi menjadi 0 studs.
DistanceStep
Mengukur ukuran BillboardGui.CurrentDistance meningkat dan menurun dalam studs saat kamera pemain bergerak lebih dekat dan lebih jauh dari BillboardGui . Propinsi bernilai 0 dan menyisakan ujung mulai dari BillboardGui.DistanceLowerLimit .
Misalnya, jika property ini di set ke 0,5 dan kamera pemain bergerak menjauh dari gui mulai dari 0 maka CurrentDistance akan meningkat 0 -> 0,5 -> 1 -> 1.5 -> ... dan seterusnya.
DistanceUpperLimit
Mengukur jarak dalam studs bahwa BillboardGui akan berhenti menyesuaikan ukuran lebih kecil relatif terhadap kamera pemain saat ini. Jika jarak gui di atas nilai ini, itu tidak akan diubah lebih kecil dari ukuran itu di jarak ini.
Propinsi ini diabaikan jika nilainya kurang dari 0.Nilai default adalah -1, yang berarti propinsi diabaikan secara default.
ExtentsOffset
ExtentsOffset menentukan seberapa BillboardGui berOffset dari Class.BillboardGui.Adornee|Adorne , relatif terhadap orientasi dan unit Class.Camera -berseberangan dan unit setengah dimensi dari model's Class.Camera -berseberangan box.
Lihat juga:
- ExtentsOffsetWorldSpace , yang berfungsi mirip dengan penyetelan orientasi penyetelan yang relatif terhadap sumbu global
- StudsOffset , yang berfungsi sama seperti kecuali unitnya adalah studs
ExtentsOffsetWorldSpace
ExtentsOffsetWorldSpace menentukan seberapa BillboardGui berkurang dari Adornee , relatif terhadap sumbu global dan unit adalah setengah dari dimensi sumbu model.
Lihat juga:
- ExtentsOffset , yang berfungsi secara serupa kecuali orientasiOffset relatif terhadap Camera
- StudsOffsetWorldSpace , yang berfungsi sama seperti kecuali unitnya adalah studs
LightInfluence
Mengontrol seberapa banyak BillboardGui terpengaruh oleh penerangan di lingkungan.
Ketika diatur ke 0, UI bersikap mirip dengan layar LCD, bertindak sebagai sumber cahaya sendiri dan muncul sama-sama terlepas dari lampu mengelilinginya.
Ketika diatur ke 1, UI berperilaku mirip dengan sepotong kertas, hanya mencerminkan cahaya dari sumber lain.
MaxDistance
Properti MaxDistance dari Class.BillboardGui menetapkan seberapa jauhnya bilboard dari kamera dan masih dapat dibuat. Jika kamera dan bilboard dipindahkan lebih jauh daripada jarak maksimum, maka bilboard tidak akan terlihat terlepas dari setiap elemen lain dari bilboard atau objek GUI apa pun yang dikandungnya.Nilai default dari property ini adalah nol.
Jika nilai ini diatur kurang dari atau sama dengan 0 maka jarak maksimum akan diperlakukan sebagai tidak terbatas dan iklan selalu dapat ditarik.
Contoh
-- Tunggu naskah kamera/kontrol default untuk loadtask.wait(5)-- Deklarasi dan inisialisasi objeklocal camera = workspace.CurrentCameralocal part = Instance.new("Part")local billboard = Instance.new("BillboardGui")local label = Instance.new("TextLabel")-- Tetapkan ketikkameracamera.CameraType = Enum.CameraType.Scriptable-- Tetapkan posisi bagian dan kilang di tempatpart.CFrame = CFrame.new(0, 10, 0)part.Anchored = true-- Set up iklanbillboard.MaxDistance = 10billboard.Adornee = partbillboard.AlwaysOnTop = truebillboard.Size = UDim2.fromOffset(50, 50)-- Buat labellabel.Size = UDim2.fromScale(1, 1)-- Tetapkan orang tua objeklabel.Parent = billboardbillboard.Parent = partpart.Parent = workspace-- Pindahkan kamera di dekat bagian. Tunggu sedikit dan kemudian pindahkan kameralocal cameraPosition0 = part.Position + Vector3.new(0, 0, 10)local cameraPosition1 = part.Position + Vector3.new(0, 0, 20)camera.CFrame = CFrame.lookAt(cameraPosition0, part.Position)-- Isi dari billboard akan terlihat di sinitask.wait(2)camera.CFrame = CFrame.lookAt(cameraPosition1, part.Position)-- Contents of billboard will no longer be visible (outside MaxDistance)
PlayerToHideFrom
Digunakan oleh skrip untuk menyembunyikan BillboardGui dari pemain tertentu.
Untuk menyembunyikan UI dari lebih dari satu pemain, letakkan BillboardGui ke dalam StarterGui dan gunakan script untuk menetapkan prop
Size
Mengontrol ukuran yang akan dimiliki BillboardGui di layar.
Komponen Scale dari Ukuran diartikan sebagai ukuran dalam studs, dan UI akan secara otomatis skala dengan jarak jika nilai Scale digunakan.
Bagian-bagian skala danOffset ditambahkan bersama-sama, dan dapat digunakan pada saat yang sama.
SizeOffset
Sebuah 2DOffset dalam unit-ukuran relatif yang bertindak seperti poin pemasangan. Ini dapat digunakan secara serupa dengan properti GuiObject.AnchorPoint, tetapi nilainya berbeda.
Nilai Umum
| SizeOffset | Penjelasan | | : | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Lihat juga:
- StudsOffset , StudsOffsetWorldSpace , ExtentsOffset , 0> Class.ToolbarGui.ExtentsOffsetWorldSpace|ExtensOffsetWorldSpace0> , yang semuanya adalah proprietari OFFSET lain yang bekerja di ruang
StudsOffset
StudsOffset menentukan seberapa Offset BillboardGui dari Adornee , relatif terhadap orientasi Camera dengan unit di studs.
Lihat juga:
- StudsOffsetWorldSpace , yang berfungsi mirip dengan penyetelan orientasi penyetelan yang relatif terhadap sumbu global
- ExtentsOffset , yang berfungsi mirip dengan kecuali unitnya setengah dari dimensi model Camera-aligned bounding box
StudsOffsetWorldSpace
StudsOffsetWorldSpace menentukan seberapa BillboardGui berkurang dari Adornee , relatif terhadap global axe dengan unit dalam studs.
Lihat juga:
- StudsOffset , yang berfungsi secara serupa kecuali orientasiOffset relatif terhadap Camera
- ExtentsOffsetWorldSpace , yang berfungsi mirip dengan kecuali unitnya setengah ukuran dari batas-batas dunia yang dibaliknya