SurfaceGui

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.

SurfaceGui memungkinkan rendering objek UI ke permukaan bagian di dunia 3D sambil juga memungkinkan interaksi pengguna dasar terjadi.Mirip dengan dan , objek UI seperti dan diberikan ke arah yang sama dengan permukaan di mana mereka berada, dapat diedit melalui properti .

SurfaceGui on a 3D part in the place with an ImageLabel child to depict a screen console.

Perhatikan bahwa elemen UI interaktif seperti ImageButtons dan TextButtons di dalam SurfaceGui hanya akan menerima input pengguna jika mereka diberikan ke PlayerGui , biasanya melalui penempatan SurfaceGui di dalam StarterGui .Properti Adornee dapat digunakan untuk menargetkan bagian di dunia 3D sementara SurfaceGui sendiri tetap berada di PlayerGui .

Lihat UI dalam Pengalaman untuk panduan tentang bekerja dengan SurfaceGui wadah.

Perilaku Penyimpanan

Untuk membantu meningkatkan pelaksanaan, penampilan SurfaceGui tersimpan sampai salah satu berikut terjadi, setelah itu penampilannya akan dihitung ulang pada frame penyajian berikutnya.

  • Seorang keturunan ditambahkan ke atau dihapus dari SurfaceGui .
  • Properti dari keturunan dari perubahan SurfaceGui .
  • Properti dari SurfaceGui itu sendiri berubah.

Rangkuman

Properti

Properti diwarisi dari SurfaceGuiBaseProperti diwarisi dari LayerCollectorProperti diwarisi dari GuiBase2d

Acara

Acara diwarisi dari GuiBase2d

Properti

AlwaysOnTop

Baca Paralel

Properti ini menentukan apakah SurfaceGui akan selalu ditampilkan di atas objek 3D lainnya.

Saat ditetapkan ke false ( default ), SurfaceGui menampilkan seperti konten 3D lain dan ditutup oleh objek 3D lain.Ketika diatur ke true , SurfaceGui 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 SurfaceGui 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 SurfaceGui 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 .

CanvasSize

Baca Paralel

Ukuran "layar virtual" di "piksel virtual" yang membuat SurfaceGuis piksel-ke-piksel kompatibel dengan ScreenGuis .

ClipsDescendants

Baca Paralel

Ketika diatur ke true ( default ), bagian dari GuiObjects yang jatuh di luar batas kanvas SurfaceGui tidak akan ditarik.

Bahkan ketika properti ini adalah , yang berada di luar kanvas tidak akan ditampilkan.

LightInfluence

Baca Paralel

Mengontrol seberapa banyak SurfaceGui 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 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.

PixelsPerStud

Baca Paralel

Properti ini menentukan kepadatan piksel yang digunakan untuk setiap stud ruang dunia untuk menampilkan konten SurfaceGui .Nilai yang lebih tinggi akan menyebabkan berbagai GuiObjects di dalam muncul lebih kecil jika dipertahankan dengan ukuran yang sama.Sebaliknya, nilai yang lebih rendah akan menyebabkan objek tampak lebih besar.Namun, jika GuiObjects skala secara proporsional melalui penggunaan UIScale , GuiObject.Size , TextLabel.TextSize , atau serupa, properti ini memungkinkan untuk menggunakan definisi yang lebih tinggi.

Penting untuk memilih nilai berdasarkan seberapa jauh Anda mengharapkan pemain melihat SurfaceGui .Perhatikan juga bahwa densitas piksel besar dapat memengaruhi kinerja negatif jika wajah bagian yang dihias cukup besar.

Baca Paralel

Ketika diatur ke Enum.SurfaceGuiSizingMode.PixelsPerStud ( default ), SurfaceGui menampilkan dengan ukuran variabel berdasarkan PixelsPerStud dan ukuran permukaan dalam stud.

Ketika diatur ke Enum.SurfaceGuiSizingMode.FixedSize , SurfaceGui menampilkan dengan ukuran tetap yang ditetapkan melalui CanvasSize .

ToolPunchThroughDistance

Baca Paralel

Tetapkan jarak di mana klik kiri mulai bertindak pada SurfaceGui alih-alih untuk yang dipegang Tool .Jika karakter berada dalam jarak ini dari SurfaceGui, Tool tidak akan aktif saat diklik.

ZOffset

Baca Paralel

Tumpukan ini SurfaceGui dalam kaitannya dengan orang lain di wajah yang sama (mengubah ini tidak secara visual "angkat" atau "tenggelamkan" SurfaceGui dari permukaan).

Metode

Acara