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.

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

  • Baca Paralel

    Mengontrol apakah cucu akan menerima acara input.

  • Baca Paralel

    Tetapkan bagian atau lampiran target yang BillboardGui berada relatif terhadap.

  • Baca Paralel

    Menentukan apakah BillboardGui akan rendah di depan konten 3D atau di belakangnya.

  • Baca Paralel

    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.

  • Hanya Baca
    Tidak Direplikasi
    Baca Paralel

    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.

  • Baca Paralel

    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.

  • Baca Paralel

    Mengatur jarak maksimum yang dapat ditunjukkan papan dari kamera dan masih bisa dibuat.

  • Digunakan oleh skrip untuk menyembunyikan BillboardGui dari pemain tertentu.

  • Baca Paralel

    Mengontrol ukuran yang akan dimiliki BillboardGui di layar.

  • Baca Paralel

    SebuahOffset 2D dalam unit-ukuran relatif yang bertindak seperti poin tancap.

  • Baca Paralel

    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.

Properti diwarisi dari LayerCollectorProperti diwarisi dari GuiBase2d

Acara

Acara diwarisi dari GuiBase2d

Properti

Active

Baca Paralel

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

Baca Paralel

Tetapkan bagian atau lampiran target yang BillboardGui berada relatif terhadap. Jika tidak ada Adornee yang atur, maka Parent digunakan.

AlwaysOnTop

Baca Paralel

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:

Brightness

Baca Paralel

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

Baca Paralel

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

Hanya Baca
Tidak Direplikasi
Baca Paralel

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

Baca Paralel

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

Baca Paralel

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

Baca Paralel

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

Baca Paralel

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

Baca Paralel

ExtentsOffsetWorldSpace menentukan seberapa BillboardGui berkurang dari Adornee , relatif terhadap sumbu global dan unit adalah setengah dari dimensi sumbu model.

Lihat juga:

LightInfluence

Baca Paralel

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

Baca Paralel

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 load
task.wait(5)
-- Deklarasi dan inisialisasi objek
local camera = workspace.CurrentCamera
local part = Instance.new("Part")
local billboard = Instance.new("BillboardGui")
local label = Instance.new("TextLabel")
-- Tetapkan ketikkamera
camera.CameraType = Enum.CameraType.Scriptable
-- Tetapkan posisi bagian dan kilang di tempat
part.CFrame = CFrame.new(0, 10, 0)
part.Anchored = true
-- Set up iklan
billboard.MaxDistance = 10
billboard.Adornee = part
billboard.AlwaysOnTop = true
billboard.Size = UDim2.fromOffset(50, 50)
-- Buat label
label.Size = UDim2.fromScale(1, 1)
-- Tetapkan orang tua objek
label.Parent = billboard
billboard.Parent = part
part.Parent = workspace
-- Pindahkan kamera di dekat bagian. Tunggu sedikit dan kemudian pindahkan kamera
local 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 sini
task.wait(2)
camera.CFrame = CFrame.lookAt(cameraPosition1, part.Position)
-- Contents of billboard will no longer be visible (outside MaxDistance)

PlayerToHideFrom

Baca Paralel

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

Baca Paralel

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

Baca Paralel

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

Baca Paralel

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

Baca Paralel

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

Metode

Acara