Lighting
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
Layanan Lighting mengontrol pencahayaan global dalam pengalaman.Ini termasuk berbagai properti yang dapat disesuaikan yang dapat Anda gunakan untuk mengubah cara pencahayaan muncul dan berinteraksi dengan objek lain, seperti diringkas dalam Properti Pencahayaan.

Lighting mungkin juga berisi objek Atmosphere untuk menampilkan efek atmosfer realistis, termasuk konsentrasi partikel, kabut, silau, dan warna.Lihat Efek Atmosferik untuk rincian.

Selain itu, Lighting (bersama dengan Workspace.CurrentCamera) mungkin berisi efek post-processing seperti SunRaysEffect dan BlurEffect.
Rangkuman
Properti
Warna pencahayaan yang diterapkan pada area yang tertutup dari langit, seperti area dalam.
Intensitas pencahayaan di tempat.
Representasi numerik (dalam jam) dari waktu sekarang hari yang digunakan oleh Lighting .
Warna yang diwakili dalam cahaya tercermin di permukaan berlawanan dengan mereka yang menghadap matahari atau bulan.
Warna yang diwakili dalam cahaya yang dipantulkan dari permukaan yang menghadap matahari atau bulan.
Cahaya ambient yang diperoleh dari lingkungan.
Cahaya spektral yang berasal dari lingkungan.
Nilai kompensasi eksposur.
Sebuah nilai Color3 memberikan nuansa Lighting kabut.
Kedalaman dari Workspace.CurrentCamera , dalam stud, di mana kabut akan benar-benar buram.
Kedalaman dari Workspace.CurrentCamera , dalam stud, di mana kabut mulai tampilkandiri.
Latar geografis, dalam derajat, adegan, yang mempengaruhi hasil dari Lighting waktu pada posisi matahari dan bulan.
Aktifkan pencahayaan dinamis berbasis vokel untuk tempat.
Warna pencahayaan yang diterapkan pada area luar.
Mengontrol seberapa buram bayangannya.
Menentukan sistem pencahayaan untuk menampilkan dunia 3D. Tidak dapat disunting. .
Representasi string 24 jam dari waktu saat ini yang digunakan oleh Lighting .
Metode
Acara
Peristiwa ini terjadi ketika properti Lighting diubah atau Sky ditambahkan atau dihapus dari Lighting .
Properti
Ambient
Ambient adalah warna pencahayaan yang diterapkan pada area yang tertutup dari langit, seperti area dalam.
Ambient default ke [0, 0, 0] (hitam).Selama saluran merah, hijau, dan biru dari properti ini tidak melebihi saluran yang sesuai di OutdoorAmbient , perubahan warna akan disimpan untuk area yang tertutup dari matahari/bulan.
Perhatikan bahwa ketika GlobalShadows dinonaktifkan, tidak ada perbedaan antara area yang disembunyikan dari langit dan area yang tidak disembunyikan.Dalam kasus ini, OutdoorAmbient akan diabaikan dan warna dari properti Ambient akan diterapkan di mana-mana.
Brightness
Intensitas pencahayaan di tempat.
Mengubah nilai ini akan mempengaruhi dampak sumber cahaya (matahari atau bulan) pada pencahayaan tempat.Perhatikan bahwa Ambient dan OutdoorAmbient juga dapat digunakan untuk mempengaruhi seberapa terang sebuah tempat muncul.Sebagai contoh, mengatur OutdoorAmbient ke
ClockTime
Representasi numerik (dalam jam) dari waktu sekarang hari yang digunakan oleh Lighting .Perhatikan bahwa properti ini tidak sesuai dengan waktu sebenarnya hari itu dan tidak akan berubah selama permainan kecuali telah diubah oleh skrip.
Untuk ukuran Lighting waktu yang dibentuk sebagai string 24 jam, gunakan TimeOfDay .Mengubah TimeOfDay atau menggunakan SetMinutesAfterMidnight() juga akan mengubah properti ini.
ColorShift_Bottom
Warna yang diwakili dalam cahaya tercermin di permukaan berlawanan dengan mereka yang menghadap matahari atau bulan.
Permukaan dari BasePart dipengaruhi oleh ColorShift_Bottom tergantung pada posisi dan orientasi BasePart relatif terhadap posisi matahari atau bulan.Di mana matahari langsung di atas BasePart , pergeseran warna hanya akan berlaku pada permukaan bawah.
Efek ini dapat ditingkatkan atau dikurangi dengan mengubah Brightness.
Perhatikan bahwa ColorShift_Top dan ColorShift_Bottom akan berinteraksi dengan properti Ambient dan OutdoorAmbient jika mereka lebih besar dari
ColorShift_Top
Warna yang diwakili dalam cahaya yang dipantulkan dari permukaan yang menghadap matahari atau bulan.
Permukaan dari BasePart dipengaruhi oleh ColorShift_Top tergantung pada posisi dan orientasi BasePart relatif terhadap posisi matahari atau bulan.Di mana matahari langsung di atas BasePart , pergeseran warna hanya akan berlaku pada permukaan atas.
Efek ini dapat ditingkatkan atau dikurangi dengan mengubah Brightness.
Perhatikan bahwa ColorShift_Top dan ColorShift_Bottom akan berinteraksi dengan properti Ambient dan OutdoorAmbient jika mereka lebih besar dari
EnvironmentDiffuseScale
Cahaya ambient yang berasal dari lingkungan dengan default 0 .Properti ini mirip dengan Ambient dan OutdoorAmbient tetapi dinamis dan dapat berubah sesuai dengan langit dan waktu hari.Ketika properti ini meningkat, disarankan untuk mengurangi Ambient dan OutdoorAmbient sesuai.
EnvironmentSpecularScale
Cahaya spektral yang berasal dari lingkungan dengan default 0 .Properti ini akan membuat objek mulus mencerminkan lingkungan dan sangat penting untuk membuat logam terlihat lebih realistis.
ExposureCompensation
Properti ini menentukan jumlah kompensasi eksposur yang menerapkan bias pada tingkat eksposur adegan sebelum langkah tonemap.Default ke 0 (tidak ada kompensasi eksposur) dan memiliki rentang dari -5 ke 5 .Nilai 1 menunjukkan dua kali lebih banyak eksposur dan -1 berarti setengah eksposur.
FogColor
Nilai A Color3 memberikan nuansa Lighting kabut. Perhatikan bahwa properti kabut tersembunyi saat Lighting berisi objek Atmosphere.
FogEnd
Kedalaman dari Workspace.CurrentCamera , dalam stud, di mana kabut akan benar-benar buram.Perhatikan bahwa properti kabut tersembunyi saat Lighting berisi objek Atmosphere.
FogStart
Kedalaman dari Workspace.CurrentCamera , dalam stud, di mana kabut mulai tampilkandiri.Perhatikan bahwa properti kabut tersembunyi saat Lighting berisi objek Atmosphere.
GeographicLatitude
Latar geografis, dalam derajat, adegan, yang mempengaruhi hasil dari Lighting waktu pada posisi matahari dan bulan.Saat menghitung posisi matahari, kemiringan bumi juga akun.
Mengubah GeographicLatitude akan mengubah posisi matahari di setiap TimeOfDay .Jika Anda ingin mendapatkan posisi matahari atau bulan, gunakan GetSunDirection() atau GetMoonDirection() .
GlobalShadows
Aktifkan pencahayaan dinamis berbasis vokel di tempat itu.Ketika diatur ke true, bayangan dibuat di area terlindung tergantung pada posisi matahari dan bulan.Warna pencahayaan yang diterapkan pada area terlindung ini ditentukan oleh properti Ambient sementara warna pencahayaan di semua area lain ditentukan oleh properti OutdoorAmbient.
Ketika false , bayangan tidak ditarik dan tidak ada perbedaan antara area dalam dan luar.Sebagai hasilnya, properti Ambient menentukan warna pencahayaan dan OutdoorAmbient tidak akan melakukan apa-apa.
Bayangan dihitung menggunakan sistem voxel dan setiap voxel pencahayaan adalah 4×4×4 studs.Ini berarti objek harus lebih besar dari 4×4×4 studs untuk menampilkan bayangan realistis.Bayangan juga dihitung ulang saat BaseParts bergerak.
LightingStyle
OutdoorAmbient
OutdoorAmbient adalah warna pencahayaan yang diterapkan pada area luar.
OutdoorAmbient default ke [127, 127, 127] .Selama saluran merah, hijau, dan biru dari Ambient tidak melebihi saluran yang sesuai di OutdoorAmbient , warna cahaya di area luar akan ditentukan oleh properti ini.
Nilai efektif OutdoorAmbient yang dibatasi untuk lebih besar atau sama dengan Ambient di semua saluran, berarti bahwa jika saluran Ambient melebihi channelterkait OutdoorAmbient , warna Ambient akan mulai diterapkan pada area luar.
Perhatikan bahwa ketika GlobalShadows dinonaktifkan, tidak ada perbedaan antara area yang disembunyikan dari langit dan area yang tidak disembunyikan.Dalam kasus ini, OutdoorAmbient akan diabaikan dan warna dari properti Ambient akan diterapkan di mana-mana.
PrioritizeLightingQuality
ShadowSoftness
Mengontrol seberapa buram bayangan dengan default 0.2 .Properti ini hanya berfungsi ketika mode Technology mode adalah ShadowMap atau Future dan perangkat mampu menampilkan peta bayangan.
Technology
Menentukan sistem pencahayaan untuk menampilkan dunia 3D.Properti ini tidak dapat disunting dan hanya dapat diubah di Studio.Lihat Enum.Technology untuk opsi yang tersedia dan Teknologi Penerangan untuk deskripsi rinci dan efek visual setiap opsi.
TimeOfDay
Representasi string 24 jam dari waktu saat ini yang digunakan oleh Lighting .Perhatikan bahwa properti ini tidak sesuai dengan waktu sebenarnya hari itu dan tidak akan berubah selama permainan kecuali telah diubah oleh skrip.
Untuk ukuran numerik dari Lighting waktu, gunakan ClockTime . Mengubah ClockTime atau menggunakan SetMinutesAfterMidnight() juga akan mengubah properti ini.
Metode
GetMinutesAfterMidnight
Kembalikan jumlah menit yang telah berlalu setelah tengah malam untuk tujuan penerangan.Angka ini akan hampir identik dengan ClockTime dikalikan dengan 60 .
Perhatikan bahwa angka ini tidak akan selalu sama dengan nilai yang diberikan di SetMinutesAfterMidnight() karena kembali menit setelah tengah malam pada hari saat ini.
Memberikan nilai
Jumlah menit setelah tengah malam.
GetMoonDirection
Kembalikan Vector3 yang mewakili arah bulan dari posisi
GetSunDirection() adalah variasi dari metode ini untuk mendapatkan arah matahari.
Memberikan nilai
GetMoonPhase
Kembalikan fase saat ini bulan. Tidak ada cara untuk mengubah fase bulan sehingga ini akan selalu kembali 0.75 .
Memberikan nilai
GetSunDirection
Kembalikan Vector3 yang mewakili arah matahari dari posisi
GetMoonDirection() adalah variasi dari metode ini untuk mendapatkan arah bulan.
Memberikan nilai
SetMinutesAfterMidnight
Atur TimeOfDay dan ClockTime ke nomor menit yang diberikan setelah tengah malam.
Metode ini memungkinkan nilai numerik untuk digunakan, misalnya dalam siklus siang/malam Script , tanpa perlu dikonversi ke string dalam format yang diperlukan oleh TimeOfDay .Ini juga memungkinkan nilai lebih dari 24 jam diberikan yang sesuai dengan waktu di hari berikutnya.
Contoh kode berikut termasuk skrip siklus hari/malam sederhana.Kecepatan waktu dan waktu awal dapat diubah menggunakan parameter TIME_SPEED dan START_TIME.
local Lighting = game:GetService("Lighting")local TIME_SPEED = 60 -- 1 menit = 1 jamlocal START_TIME = 9 -- 9 AMlocal minutesAfterMidnight = START_TIME * 60local waitTime = 60 / TIME_SPEEDwhile true dominutesAfterMidnight = minutesAfterMidnight + 1Lighting:SetMinutesAfterMidnight(minutesAfterMidnight)task.wait(waitTime)end
Parameter
Jumlah menit setelah tengah malam.
Memberikan nilai
Acara
LightingChanged
Peristiwa ini terjadi ketika properti Lighting diubah atau Sky ditambahkan atau dihapus dari Lighting, dengan beberapa pengecualian:
- Mengubah GlobalShadows tidak akan menembakkan peristiwa ini.
Dalam kasus di mana perilaku ini tidak diinginkan, acara Object.Changed atau metode Object:GetPropertyChangedSignal() dapat digunakan.