BillboardGui

Tampilkan yang Tidak Digunakan Lagi

*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.

BillboardGui with a TextLabel describing the screen console it floats above.

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.

Rangkuman

Properti

Properti diwarisi dari LayerCollectorProperti diwarisi dari GuiBase2d

Acara

Acara diwarisi dari GuiBase2d

Properti

Active

Baca Paralel

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

Baca Paralel

Tetapkan target atau yang posisinya relatif terhadap, menggantikan bagian atau lampiran orang tua.

AlwaysOnTop

Baca Paralel

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

Baca Paralel

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

Baca Paralel

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

Hanya Baca
Tidak Direplikasi
Baca Paralel

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

Baca Paralel

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

Baca Paralel

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

Baca Paralel

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

Baca Paralel

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

Baca Paralel

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

Baca Paralel

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

Baca Paralel

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

Baca Paralel

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

Baca Paralel

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

Baca Paralel

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 UkuranPenjelasan

Lihat juga StudsOffset , StudsOffsetWorldSpace , ExtentsOffset , dan ExtentsOffsetWorldSpace yang merupakan properti offset yang berfungsi di ruang 3D sebagai gantinya.

StudsOffset

Baca Paralel

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

Baca Paralel

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.

Metode

Acara