Sebuah ViewportFrame menggunakan kamera untuk merender objek 3D ke dalam tampilan 2D. Kasus penggunaan ideal mencakup:
- Sebuah minimap dari pengalaman Anda langsung di sudut layar pengguna.
- Model 3D dari item dalam menu inventaris.
- Objek yang berputar yang dilengkapi oleh karakter.
Konfigurasi Viewport
Objek 3D yang dilihat pengguna melalui ViewportFrame dapat bergerak dengan kamera mereka, tetap statis, atau berputar di dalam ViewportFrame. Objek ini juga dapat menyertakan anak Sky sebagai cubemap untuk refleksi.
Jika Anda ingin objek 3D bergerak dengan kamera:
Tempatkan tampilan kamera Anda dalam pengalaman sehingga objek yang ingin Anda lihat dalam bingkai terlihat.
Tambahkan ViewportFrame baru ke layar dan pastikan itu dipilih di Explorer.
Di jendela Properties, tetapkan properti CurrentCamera ke kamera:
- Pilih properti CurrentCamera. Kursor Anda berubah.
- Di jendela Explorer, klik pada objek Camera tingkat atas.
Jadikan objek 3D yang diinginkan sebagai anak dari ViewportFrame yang baru. Perhatikan bahwa jika Anda masih ingin melihat objek tersebut dalam pengalaman Anda, Anda harus menduplikatnya di Workspace dan kemudian menjadikannya sebagai anak dari objek duplikat di ViewportFrame.
Saat Anda menggerakkan kamera Anda, objek juga akan bergerak di dalam ViewportFrame.
Ketika Anda ingin memperbarui tampilan ViewportFrame Anda, pastikan untuk memperbarui kamera, bukan objek di dalam tampilan.
Pencahayaan dan penampilan
Pencahayaan di dalam ViewportFrame dikendalikan melalui tiga properti:
| Properti | Deskripsi |
|---|---|
| Ambient | Menentukan hue pencahayaan keseluruhan yang diterapkan di area dalam bingkai viewport. Default adalah Color3.fromRGB(200, 200, 200) (abu hantu). |
| LightDirection | Sebuah Vector3 yang mewakili arah sumber cahaya dari posisi (0, 0, 0). Default adalah (-1, -1, -1). |
| LightColor | Warna cahaya arah. Default adalah Color3.fromRGB(140, 140, 140) (perak). |
Selain itu, Anda dapat menyesuaikan penampilan keseluruhan yang dirender dari viewport melalui properti berikut:
| Properti | Deskripsi |
|---|---|
| ImageColor3 | Mengubah warna/tint gambar tanpa memodifikasi objek yang dirender. Nilai pewarnaan default adalah Color3.new(1, 1, 1) (putih) di mana tidak ada modifikasi warna yang terjadi. |
| ImageTransparency | Mengubah transparansi gambar tanpa memodifikasi objek yang dirender. Nilai 0 (default) sepenuhnya tidak transparan dan nilai 1 sepenuhnya transparan (tidak terlihat). |