`ViewportCamera` adalah `Class.Camera` yang ditujukan untuk kamera yang Anda atur pada
 waktu desain, seperti kamera yang ditugaskan ke `Class.ViewportFrame.CurrentCamera`
 atau `ThumbnailCamera` di dalam `Class.Model`. Ini memiliki properti yang sama,
 metode, dan peristiwa seperti `Class.Camera`, tetapi tidak seperti `Class.Camera` itu
 mereplikasi, sehingga berfungsi seperti yang diharapkan dalam Team Create dan saat direplikasi dari
 server ke klien.

Gunakan `Class.Camera` untuk kamera yang merender dunia 3D, yang dapat diakses
 melalui `Class.Workspace.CurrentCamera`. Gunakan `ViewportCamera` untuk kamera lain
 yang Anda buat dan ingin disimpan dengan tempat tersebut.

#### Perilaku Autoupgrade

Ketika Anda menempelkan konten yang disalin yang berisi `Class.Camera` di Studio, setiap
 `Class.Camera` secara otomatis diubah menjadi `ViewportCamera` dengan
 properti yang sama. Ini untuk memfasilitasi alur kerja umum dalam mengatur
 kamera dengan memposisikan kamera workspace utama dan kemudian menyalin dan menempelkan
 kamera tersebut.


ViewportCamera

Sebuah `Class.Camera` yang mereplikasi dan disimpan sebagai konten yang dibuat, untuk digunakan
 dengan `Class.ViewportFrame|ViewportFrames` atau sebagai ThumbnailCamera.


Objek `Camera` mendefinisikan pandangan dunia 3D. Dalam pengalaman yang berjalan,
setiap klien memiliki objek `Camera` sendiri yang berada di `Class.Workspace` lokal
klien tersebut, yang dapat diakses melalui properti `Class.Workspace.CurrentCamera`.

Properti kamera yang paling penting adalah:

- `Class.Camera.CFrame|CFrame` yang mewakili posisi dan orientasi
  kamera.

- `Class.Camera.CameraType|CameraType` yang dibaca oleh skrip kamera
  pengalaman dan menentukan bagaimana kamera harus diperbarui setiap frame.

- `Class.Camera.CameraSubject|CameraSubject` yang dibaca oleh skrip kamera
  pengalaman dan menentukan objek apa yang harus diikuti oleh kamera.

- `Class.Camera.FieldOfView|FieldOfView` yang mewakili jangkauan yang terlihat
  dari dunia yang dapat diamati.

- `Class.Camera.Focus|Focus` yang mewakili titik yang dilihat kamera.
  Penting untuk mengatur properti ini, karena visual tertentu akan lebih
  detail dan akan diperbarui lebih sering tergantung pada seberapa dekat mereka
  dengan titik fokus.

Lihat [Menyesuaikan Kamera](/workspace/camera) untuk lebih
informasi tentang cara menyesuaikan dan mengubah perilaku kamera.

#### Menyimpan Beberapa Kamera

Perhatikan bahwa ketika mengubah `Class.Workspace.CurrentCamera` ke
`Class.Camera` baru, semua `Class.Camera|Cameras` lain yang langsung
menurun dari `Class.Workspace` akan dihancurkan. Jika Anda perlu menyimpan
beberapa kamera dan beralih di antara mereka sesuai permintaan, disarankan
agar Anda menyimpannya dalam `Class.Folder` atau `Class.Model` di bawah
`Class.Workspace`, di mana mereka akan tetap ada bahkan ketika
`Class.Workspace.CurrentCamera|CurrentCamera` diubah.

Event ini dipicu ketika `Class.Camera` telah selesai menganimasikan menggunakan
metode `Class.Camera:Interpolate()`. Ini tidak akan dipicu jika tween terputus
karena `Class.Camera:Interpolate()` dipanggil lagi.

Anda disarankan untuk menggunakan `Class.TweenService` untuk menganimasikan
`Class.Camera` sebagai gantinya, karena lebih dapat diandalkan dan menyediakan lebih banyak opsi untuk gaya easing.

Camera.InterpolationFinished

Dipicu ketika `Class.Camera` telah selesai menganimasikan
menggunakan `Class.Camera:Interpolate()|Interpolate()`.

Metode ini digunakan oleh `PopperCam` dalam skrip kamera default untuk memastikan
halangan tidak muncul antara `Class.Camera` dan subjeknya.

Metode ini akan memeriksa semua `Class.BasePart|BaseParts` dan `Class.Terrain`
di `Class.Workspace` dengan pengecualian berikut:

- Setiap `Class.Instance` yang ditentukan dalam `ignoreList` (termasuk
  keturunannya) akan diabaikan
- `Class.BasePart|BaseParts` dengan `Class.BasePart.CanCollide` diatur ke false
  diabaikan
- `Class.BasePart|BaseParts` dengan `Class.BasePart.Transparency` lebih besar
  dari 0.95 akan diabaikan. Air `Class.Terrain` diabaikan

Perhatikan, karena metode ini memerlukan `ignoreList` untuk dijalankan,
Anda harus mengoper tabel kosong ketika tidak ada yang diperlukan.

Camera:GetLargestCutoffDistance

ignoreList

Sebuah array dari `Class.Instance|Instances` untuk diabaikan. Keturunan dari
instansi ini juga akan diabaikan.

Jarak, dalam stud, yang perlu didorong `Class.Camera` menuju
`Class.Camera.Focus|Focus` untuk memastikan tidak ada
halangan antara `Class.Camera.Focus|Focus` dan
`Class.Camera.CFrame|CFrame` dari `Class.Camera`.

Mengembalikan seberapa banyak `Class.Camera` perlu didorong menuju
`Class.Camera.Focus|Focus` untuk memastikan tidak ada halangan
antara `Class.Camera.Focus|Focus` dan `Class.Camera.CFrame|CFrame`.

Metode ini rusak dan tidak boleh digunakan.

Metode ini mengembalikan kecepatan pan saat ini dari `Class.Camera`.

Kecepatan pan dari `Class.Camera` menggambarkan kecepatan di mana
`Class.Camera` berputar di sekitar `Class.Camera.Focus|Focus` di sekitar
sumbu **Y**.

Camera:GetPanSpeed

Kecepatan di mana `Class.Camera` berputar di sekitar
`Class.Camera.Focus|Focus` pada sumbu **Y**.

Mengembalikan kecepatan 'pan' saat ini dari `Class.Camera`.

Metode ini mengembalikan array dari `Class.BasePart|BaseParts` yang
menghalangi garis pandang antara `Class.Camera.CFrame|CFrame` kamera dan
posisi `Datatype.Vector3` dalam array `castPoints`. Setiap `Class.Instance|Instances`
yang termasuk dalam array `ignoreList` akan diabaikan, bersama dengan
keturunannya.

Parameter `castPoints` diberikan sebagai array posisi `Datatype.Vector3`.
Perhatikan bahwa array `Class.BasePart|BaseParts` yang dikembalikan berada
dalam urutan sembarangan, dan tidak ada data raycast tambahan yang diberikan.
Jika Anda memerlukan data seperti posisi hit, material hit, atau normal permukaan,
Anda harus memilih metode `Class.WorldRoot:Raycast()`.

```lua
local camera = workspace.CurrentCamera

local castPoints = {
	Vector3.new(0, 10, 0),
	Vector3.new(0, 15, 0)
}
local ignoreList = {}

local partsObscuringTarget = camera:GetPartsObscuringTarget(castPoints, ignoreList)
```
Jika `Class.Terrain` menghalangi titik cast, `Class.BasePart|BaseParts`
yang menghalangi titik cast antara `Class.Terrain` yang menghalangi dan
`titik cast` tidak akan dikembalikan.

Camera:GetPartsObscuringTarget

castPoints

Sebuah array dari posisi `Datatype.Vector3` titik cast.

Sebuah array dari `Class.Instance|Instances` yang harus diabaikan, bersama
dengan keturunannya.

Sebuah array dari `Class.BasePart|BaseParts` yang menghalangi garis pandang
antara `Class.Camera.CFrame|CFrame` kamera dan
`titik cast`.

Mengembalikan array dari `Class.BasePart|BaseParts` yang menghalangi
garis pandang antara `Class.Camera.CFrame|CFrame` kamera dan titik-titik
cast.

Metode ini mengembalikan `Datatype.CFrame` aktual dari `Class.Camera` saat
ia dirender, termasuk dampak dari VR (transformasi kepala VR tidak diterapkan
pada properti `Class.Camera.CFrame|CFrame`, jadi merupakan praktik terbaik
untuk menggunakan `Class.Camera:GetRenderCFrame()|GetRenderCFrame()` untuk
mendapatkan `Datatype.CFrame` "yang sebenarnya" dari tampilan pemain).

Sebagai contoh, saat menggunakan VR, `Class.Camera` sebenarnya dirender di
`Datatype.CFrame` berikut:

```lua
local UserInputService = game:GetService("UserInputService")

local camera = workspace.CurrentCamera

local headCFrame = UserInputService:GetUserCFrame(Enum.UserCFrame.Head)
headCFrame = headCFrame.Rotation + headCFrame.Position * camera.HeadScale
renderCFrame = camera.CFrame * headCFrame
```

`Datatype.CFrame` render kamera hanya akan diubah untuk memperhitungkan
kepala ketika properti `Class.Camera.HeadLocked|HeadLocked` adalah true.

Camera:GetRenderCFrame

`Datatype.CFrame` di mana `Class.Camera` sedang dirender.

Mengembalikan `Datatype.CFrame` aktual di mana `Class.Camera` sedang
dirender, memperhitungkan setiap roll yang diterapkan dan dampak dari perangkat VR.

Contoh ini, ketika digunakan dalam `Class.LocalScript`, akan mengambil
roll kamera saat ini dalam derajat. Kemudian, jika sudut roll kamera tidak 20
derajat, sudut roll kamera diatur menjadi 20 derajat.


Demonstrasikan `Class.Camera:GetRoll()`.


Metode ini mengembalikan, dalam radian, roll saat ini yang diterapkan pada
`Class.Camera` menggunakan `Class.Camera:SetRoll()|SetRoll()`. Roll didefinisikan
sebagai rotasi di sekitar sumbu Z kamera.

Metode ini hanya mengembalikan roll yang diterapkan menggunakan
`Class.Camera:SetRoll()|SetRoll()`. Roll yang diterapkan secara manual pada
`Class.Camera.CFrame|CFrame` tidak diperhitungkan. Untuk mendapatkan roll
aktual dari `Class.Camera`, termasuk roll yang diterapkan secara manual,
Anda dapat menggunakan potongan berikut:

Camera:GetRoll

Roll saat ini yang diterapkan oleh `Class.Camera:SetRoll()|SetRoll()`, dalam
radian.

Mengembalikan dalam radian roll saat ini, atau rotasi di sekitar sumbu Z kamera,
yang diterapkan pada `Class.Camera` menggunakan
`Class.Camera:SetRoll()|SetRoll()`.

Metode ini rusak dan tidak boleh digunakan.

Metode ini mengembalikan kecepatan tilt saat ini dari `Class.Camera`.

Kecepatan tilt dari `Class.Camera` menggambarkan kecepatan di mana
`Class.Camera` berputar di sekitar `Class.Camera.Focus|Focus` di sekitar
sumbu **X** kamera.

Camera:GetTiltSpeed

Kecepatan di mana `Class.Camera` berputar di sekitar
`Class.Camera.Focus|Focus` di sekitar sumbu **X** kamera.

Mengembalikan kecepatan tilt saat ini dari `Class.Camera`.

Metode ini menganimasikan `Class.Camera` secara linier menuju `Class.Camera.CFrame|CFrame` baru dan
`Class.Camera.Focus|Focus` selama durasi tertentu, misalnya:

```lua
local camera = workspace.CurrentCamera
camera.CameraType = Enum.CameraType.Scriptable

camera:Interpolate(
	CFrame.new(0, 10, 100),
	CFrame.new(0, 0, 100),
	5
)
```
Sepanjang tween, `Class.Camera.CFrame|CFrame` kamera akan diorientasikan
menuju `Class.Camera.Focus|Focus` kamera.

Ketika tween telah selesai, event `Class.Camera.InterpolationFinished|InterpolationFinished`
kamera akan dipicu.

Jika metode ini dipanggil saat `Class.Camera` sudah dalam proses tweening,
tween yang lebih lama akan dihentikan (tanpa memicu
`Class.Camera.InterpolationFinished|InterpolationFinished`) dan digantikan
oleh tween baru.

Interpolate hanya dapat digunakan jika `Class.Camera.CameraType|CameraType`
yang saat ini adalah `Scriptable`, terlepas dari apakah skrip kamera default
sedang digunakan. Jika digunakan dengan jenis kamera lain, akan muncul
kesalahan.

Anda disarankan untuk menggunakan `Class.TweenService` untuk menganimasikan
`Class.Camera` sebagai gantinya karena lebih dapat diandalkan dan menawarkan
berbagai gaya easing. Lihat di bawah untuk contoh:

```lua
local TweenService = game:GetService("TweenService")

local camera = workspace.CurrentCamera
camera.CameraType = Enum.CameraType.Scriptable

local tween = TweenService:Create(
	camera,
	TweenInfo.new(5, Enum.EasingStyle.Quad, Enum.EasingDirection.Out),
	{
		CFrame = CFrame.new(0, 10, 100),
		Focus = CFrame.new(0, 0, 100)
	}
)

tween:Play()
```

Camera:Interpolate

endPos

`Datatype.CFrame` untuk `Class.Camera` yang akan dianimasikan.

endFocus

`Datatype.CFrame` untuk `Class.Camera.Focus|Focus` kamera yang akan dianimasikan.

duration

Menganimasikan `Class.Camera` secara linier menuju `Class.Camera.CFrame|CFrame` baru dan
`Class.Camera.Focus|Focus` selama durasi tertentu.

Metode ini menggerakkan `Class.Camera` di sekitar `Class.Camera.Focus|Focus`
dalam inkremen 45 derajat di sekitar sumbu **Y**.

Rotasi diterapkan pada properti `Class.Camera.CFrame|CFrame` kamera.

Metode ini menggerakkan `Class.Camera` dalam inkremen 45 derajat, misalnya:

```lua
workspace.CurrentCamera:PanUnits(1) -- 45 derajat
workspace.CurrentCamera:PanUnits(-2) -- -90 derajat
```
PanUnits tidak memerlukan `Class.Camera.CameraType|CameraType` untuk
`Scriptable`.

Camera:PanUnits

units

Jumlah inkremen 45 derajat untuk menggerakkan `Class.Camera`.

Menggerakkan `Class.Camera` di sekitar `Class.Camera.Focus|Focus` dalam
inkremen 45 derajat di sekitar sumbu **Y**.

Metode ini membuat `Datatype.Ray` unit dari posisi 2D di layar
(didefinisikan dalam piksel), dengan memperhitungkan inset GUI. `Datatype.Ray`
berasal dari `Datatype.Vector3` yang setara dengan posisi 2D di
dunia pada kedalaman tertentu (dalam stud) dari `Class.Camera`.

Karena metode ini memperhitungkan inset GUI, offset yang diterapkan pada elemen GUI
(seperti dari bilah atas) diperhitungkan. Ini berarti posisi layar yang ditentukan
akan dimulai dari sudut kiri atas di bawah bilah atas. Untuk metode yang
identik yang tidak memperhitungkan offset GUI, gunakan `Class.Camera:ViewportPointToRay()|ViewportPointToRay()`.

Karena `Datatype.Ray` yang dibuat adalah ray unit, panjangnya hanya satu stud. Untuk
membuat ray yang lebih panjang, Anda dapat melakukan hal berikut:

```lua
local camera = workspace.CurrentCamera
local length = 500
local unitRay = camera:ScreenPointToRay(100, 100)
local extendedRay = Ray.new(unitRay.Origin, unitRay.Direction * length)
```
Metode ini hanya berfungsi untuk kamera `Class.Workspace` saat ini. Kamera lain,
seperti yang Anda buat untuk `Class.ViewportFrame`, memiliki ukuran viewport awal
`(1, 1)` dan hanya diperbarui setelah Anda mengaturnya ke
`Class.Workspace.CurrentCamera`. Ketidakcocokan dalam ukuran viewport menyebabkan
kamera mengembalikan ray dengan `Datatype.Ray.Direction` yang tidak benar.

Camera:ScreenPointToRay

Posisi pada sumbu **X**, dalam piksel, dari titik layar di mana
`Datatype.Ray` akan berasal. Posisi ini memperhitungkan inset GUI.

Posisi pada sumbu **Y**, dalam piksel, dari titik layar di mana
`Datatype.Ray` akan berasal. Posisi ini memperhitungkan inset GUI.

depth

Kedalaman dari `Class.Camera`, dalam stud, dari mana untuk mengoffset
asal `Datatype.Ray`.

Sebuah unit `Datatype.Ray`, yang berasal dari posisi dunia
`Datatype.Vector3` yang setara dengan koordinat layar yang diberikan pada
kedalaman tertentu dari `Class.Camera`. Ray ini terorientasi
ke arah `Class.Camera`.

Membuat `Datatype.Ray` unit dari posisi di layar (dalam piksel),\pada kedalaman tertentu dari `Class.Camera` yang terorientasi dalam arah kamera.
Memperhitungkan inset GUI.

Metode ini mengatur `Enum.CameraPanMode` yang akan digunakan oleh `Class.Camera`
pada perangkat mobile.

Ketika mode `EdgeBump` `Enum.CameraPanMode` digunakan, geser untuk pan dinonaktifkan
dan kontrol kamera edge bump diaktifkan.

SetCameraPan mode tidak berpengaruh pada pengguna Windows atau Mac.

Camera:SetCameraPanMode

mode

`Enum.CameraPanMode` untuk mengatur `Class.Camera`.

Mengatur `Enum.CameraPanMode` yang akan digunakan oleh `Class.Camera` pada perangkat
mobile.

Metode ini sudah ketinggalan zaman dan tidak lagi dianggap sebagai praktik terbaik.

Metode ini mengatur roll saat ini, dalam radian, dari `Class.Camera`. Roll
 diterapkan setelah `Class.Camera.CFrame|CFrame` dan mewakili rotasi di
sekeliling sumbu Z kamera.

Sebagai contoh, berikut ini akan membalikkan `Class.Camera`:

```lua
workspace.CurrentCamera:SetRoll(math.pi) -- math.pi radian = 180 derajat
```
SetRoll tidak berpengaruh pada roll yang diterapkan menggunakan
properti `Class.Camera.CFrame|CFrame`. Roll yang diterapkan menggunakan SetRoll
 tidak tercermin dalam properti `Class.Camera.CFrame|CFrame` tetapi tercermin dalam
`Datatype.CFrame` yang dikembalikan
oleh`Class.Camera:GetRenderCFrame()|GetRenderCFrame()`.

Metode ini hanya dapat digunakan ketika `Class.Camera.CameraType|CameraType`
diatur ke `Scriptable`, terlepas dari apakah skrip kamera default
sedang digunakan. Jika digunakan dengan jenis kamera lain, akan muncul
peringatan di output.

Setiap roll yang diterapkan menggunakan metode ini akan hilang ketika
`Class.Camera.CameraType|CameraType` diubah dari `Scriptable`.

Untuk mendapatkan roll yang diatur menggunakan metode ini, gunakan
`Class.Camera:GetRoll()|GetRoll()`.

Karena metode ini sudah ketinggalan zaman, Anda disarankan untuk menerapkan
roll pada `Class.Camera` menggunakan properti `Class.Camera.CFrame|CFrame`. Sebagai
contoh:

```lua
local currentCFrame = workspace.CurrentCamera.CFrame
local rollCFrame = CFrame.Angles(0, 0, roll)
workspace.CurrentCamera.CFrame = currentCFrame * rollCFrame
```

Camera:SetRoll

rollAngle

Sudut roll, dalam radian, yang akan diterapkan pada `Class.Camera`.

Mengatur rotasi saat ini yang diterapkan di sekitar sumbu Z kamera.

Metode ini memiringkan `Class.Camera` dengan memutarnya di sekitar
`Class.Camera.Focus|Focus` di sekitar sumbu **X** kamera dengan kelipatan
10 derajat yang diberikan.

Rotasi diterapkan pada properti `Class.Camera.CFrame|CFrame` kamera dan dibatasi
antara `-81.05` dan `81.05` derajat.

Camera:TiltUnits

Jumlah unit 10 derajat untuk memiringkan `Class.Camera`.

Apakah kemiringan `Class.Camera` yang diterapkan dibatasi.

Miringkan `Class.Camera` di sekitar `Class.Camera.Focus|Focus` dalam
inkremen 10 derajat di sekitar sumbu **X** kamera.

Metode ini membuat `Datatype.Ray` unit dari posisi 2D dalam koordinat viewport aman perangkat,
yang didefinisikan dalam piksel. Ray berasal dari `Datatype.Vector3` yang
setara dengan posisi 2D di dunia pada kedalaman tertentu (dalam stud)
dari `Class.Camera`.

Seperti yang diilustrasikan di bawah, `(0, 0)` sesuai dengan titik kiri atas
bilah atas Roblox. Ini berarti bahwa posisi 2D input tidak memperhitungkan
inset `Enum.ScreenInsets|CoreUISafeInsets`, tetapi memperhitungkan
inset `Enum.ScreenInsets|DeviceSafeInsets`.

<img src="../../../assets/engine-api/classes/Camera/ViewportPointToRayOrigin.png" width="840" alt="Diagram menunjukkan asal sistem koordinat viewport area aman perangkat." />

Perhatikan bahwa instansi UI menggunakan sistem koordinat yang berbeda
(`Class.GuiObject.AbsolutePosition` menggunakan sistem koordinat viewport
`Enum.ScreenInsets|CoreUISafeInsets` sementara metode ini menggunakan sistem koordinat viewport
`Enum.ScreenInsets|DeviceSafeInsets`). Jika Anda ingin menentukan posisi dalam
koordinat UI inti, silakan gunakan `Class.Camera:ScreenPointToRay()|ScreenPointToRay()`.

Juga perhatikan bahwa metode ini hanya berfungsi untuk kamera
`Class.Workspace.CurrentCamera`. Kamera lain, seperti yang Anda buat untuk
`Class.ViewportFrame`, memiliki ukuran viewport awal
`(1, 1)` dan hanya diperbarui setelah Anda mengaturnya ke
`Class.Workspace.CurrentCamera|CurrentCamera`. Ketidakcocokan dalam ukuran viewport
menyebabkan kamera mengembalikan ray dengan `Datatype.Ray.Direction` yang tidak benar.

Metode ini dapat digunakan bersamaan dengan properti
`Class.Camera.ViewportSize|ViewportSize` untuk membuat ray dari
pusat layar, misalnya:

```lua
local camera = workspace.CurrentCamera

local viewportPoint = camera.ViewportSize / 2
local unitRay = camera:ViewportPointToRay(viewportPoint.X, viewportPoint.Y, 0)
```
Karena `Datatype.Ray` yang dibuat adalah ray unit, panjangnya hanya satu stud. Untuk
membuat ray yang lebih panjang, Anda dapat melakukan hal berikut:

```lua
local camera = workspace.CurrentCamera

local length = 500
local viewportPoint = camera.ViewportSize / 2
local unitRay = camera:ViewportPointToRay(viewportPoint.X, viewportPoint.Y, 0)
local extendedRay = Ray.new(unitRay.Origin, unitRay.Direction * length)
```

Camera:ViewportPointToRay

Posisi pada sumbu **X**, dalam piksel, dari titik viewport di mana
`Datatype.Ray` akan berasal, dalam koordinat area aman perangkat.

Posisi pada sumbu **Y**, dalam piksel, dari titik viewport di mana
`Datatype.Ray` akan berasal, dalam koordinat area aman perangkat.

Sebuah unit `Datatype.Ray`, yang berasal dari posisi dunia
`Datatype.Vector3` yang setara dengan koordinat viewport yang diberikan pada
kedalaman tertentu dari `Class.Camera`. Ray ini terorientasi
ke arah `Class.Camera`.

Membuat `Datatype.Ray` unit dari posisi di viewport (dalam piksel),
dari kedalaman tertentu dari `Class.Camera`, terorientasi dalam arah kamera. Tidak
memperhitungkan inset `Enum.ScreenInsets|CoreUISafeInsets`.

Metode ini mengembalikan lokasi layar dan kedalaman dari `Datatype.Vector3`
`worldPoint` dan apakah titik ini berada dalam batas layar.

Metode ini memperhitungkan inset GUI saat ini, seperti ruang
yang ditempati oleh bilah atas, yang berarti bahwa posisi 2D yang dikembalikan
berada dalam istilah yang sama dengan posisi GUI dan dapat digunakan untuk
menempatkan elemen GUI. Untuk metode yang identik yang mengabaikan
inset GUI, lihat `Class.Camera:WorldToViewportPoint()|WorldToViewportPoint()`.

```lua
local camera = workspace.CurrentCamera

local worldPoint = Vector3.new(0, 10, 0)
local vector, onScreen = camera:WorldToScreenPoint(worldPoint)

local screenPoint = Vector2.new(vector.X, vector.Y)
local depth = vector.Z
```
Perhatikan bahwa metode ini tidak melakukan raycasting dan boolean
yang menunjukkan apakah `worldPoint` berada dalam batas layar akan
`true` terlepas dari apakah titik tersebut terhalang oleh
`Class.BasePart|BaseParts` atau `Class.Terrain`.

Camera:WorldToScreenPoint

worldPoint

Sebuah tuple yang berisi, dalam urutan:

- Sebuah `Datatype.Vector3` yang komponen **X** dan **Y**-nya mewakili
  offset dari `worldPoint` dari sudut kiri atas layar,
  dalam piksel. Komponen **Z** dari `Datatype.Vector3` mewakili
  kedalaman dari `worldPoint` dari layar (dalam stud).

- Sebuah boolean yang menunjukkan apakah `worldPoint` berada dalam batas
  layar.

Mengembalikan lokasi layar dan kedalaman dari `Datatype.Vector3` `worldPoint`
dan apakah titik ini berada dalam batas layar. Memperhitungkan
inset GUI.

Metode ini mengembalikan lokasi layar dan kedalaman dari `Datatype.Vector3`
`worldPoint` dan apakah titik ini berada dalam batas layar.

Metode ini tidak memperhitungkan inset GUI saat ini, seperti ruang
yang ditempati oleh bilah atas, yang berarti bahwa posisi 2D yang dikembalikan
diambil dari sudut kiri atas viewport. Kecuali Anda menggunakan
`Class.ScreenGui.IgnoreGuiInset`, posisi ini tidak sesuai untuk
menempatkan elemen GUI.

Untuk metode yang identik yang memperhitungkan inset GUI, lihat
`Class.Camera:WorldToScreenPoint()|WorldToScreenPoint()`.

```lua
local camera = workspace.CurrentCamera

local worldPoint = Vector3.new(0, 10, 0)
local vector, onScreen = camera:WorldToViewportPoint(worldPoint)

local viewportPoint = Vector2.new(vector.X, vector.Y)
local depth = vector.Z
```
Perhatikan bahwa metode ini tidak melakukan raycasting dan boolean
yang menunjukkan apakah `worldPoint` berada dalam batas layar akan
`true` terlepas dari apakah titik tersebut terhalang oleh
`Class.BasePart|BaseParts` atau `Class.Terrain`.

##### Kamera ViewportFrame

Hanya `Class.Workspace.CurrentCamera` yang memiliki dimensi viewport internalnya
perbarui oleh mesin setiap frame. Kamera yang digunakan di dalam
`Class.ViewportFrame` tidak menerima pembaruan viewport, jadi komponen X dan Y
yang dikembalikan oleh metode ini akan berada dalam rentang [0, 1] daripada
piksel. Dalam praktiknya, ini berarti nilai yang dikembalikan dapat digunakan sebagai
koordinat skala (misalnya,
`Datatype.UDim2|UDim2.fromScale(vector.X, vector.Y)`) untuk menempatkan elemen GUI
relatif terhadap ViewportFrame.

Camera:WorldToViewportPoint

Sebuah tuple yang berisi, dalam urutan:

- Sebuah `Datatype.Vector3` yang komponen **X** dan **Y**-nya mewakili
  offset dari `worldPoint` dari sudut kiri atas viewport,
  dalam piksel untuk `Class.Workspace.CurrentCamera`. Untuk kamera di dalam
  `Class.ViewportFrame`, nilai-nilai dinormalisasi ke [0, 1]. Komponen **Z**
dari `Datatype.Vector3` mewakili kedalaman dari `worldPoint` dari layar
(dalam stud).

- Sebuah boolean yang menunjukkan apakah `worldPoint` berada dalam batas
  layar.

Mengembalikan lokasi layar dan kedalaman dari `Datatype.Vector3` `worldPoint`
dan apakah titik ini berada dalam batas layar. Tidak
memperhitungkan inset GUI.

Menunjukkan `Class.Camera:ZoomToExtents()`.


Metode ini menyesuaikan `Class.Camera.CFrame|CFrame` sehingga kotak batas yang ditentukan
sepenuhnya terlihat dalam viewport kamera, tanpa memotong bagian mana pun dari
kotak tersebut.

Kotak batas didefinisikan oleh pusat dan orientasinya
(`boundingBoxCFrame`) dan ukurannya (`boundingBoxSize`).

Ini dapat digunakan untuk memfokuskan kamera pada objek 3D atau model, seperti saat
mengatur konten dalam `Class.ViewportFrame`, mengambil tangkapan layar, atau
bertransisi dengan halus kamera untuk menyoroti konten tertentu.

Metode ini secara otomatis memperhitungkan bidang pandang kamera dan
rasio aspek viewport untuk memastikan seluruh kotak batas muat.

Camera:ZoomToExtents

boundingBoxCFrame

`Datatype.CFrame` yang mewakili pusat dan orientasi dari
kotak batas yang akan dimuat ke dalam viewport.

boundingBoxSize

`Datatype.Vector3` ukuran kotak batas yang akan dimuat ke dalam
viewport.

Menyesuaikan `Class.Camera.CFrame|CFrame` sehingga kotak batas yang ditentukan
sepenuhnya terlihat dalam viewport kamera.

Camera

Demonstrasi `Class.Camera.CameraSubject`.


`CameraSubject` menerima berbagai `Class.Instance|Instances`. Skrip kamera
default merespons secara berbeda terhadap pengaturan yang tersedia:

- Secara default, skrip kamera mengikuti `Class.Humanoid` karakter lokal,
  mempertimbangkan keadaan humanoid saat ini dan
  `Class.Humanoid.CameraOffset`.

- Ketika diatur ke `Class.BasePart`, skrip kamera mengikuti posisinya,
  dengan offset vertikal dalam kasus `Class.VehicleSeat|VehicleSeats`.

`CameraSubject` tidak dapat diatur ke `nil`. Mencoba melakukannya akan
mengembalikannya ke nilai sebelumnya.

Untuk mengembalikan `CameraSubject` ke nilai defaultnya, atur ke
`Class.Humanoid` karakter lokal:

Camera.CameraSubject

`Class.Humanoid` atau `Class.BasePart` yang menjadi subjek `Class.Camera`.

Skrip kamera default Roblox memiliki beberapa perilaku bawaan. Mengatur
properti ini beralih antara berbagai perilaku `Enum.CameraType`.
Perhatikan bahwa beberapa jenis kamera memerlukan `Class.Camera.CameraSubject|CameraSubject`
yang valid untuk berfungsi dengan benar.

Skrip kamera default tidak akan memindahkan atau memperbarui kamera jika
`CameraType` diatur ke `Enum.CameraType.Scriptable`. Untuk informasi lebih
lanjut tentang penempatan dan orientasi kamera secara manual, lihat
`Class.Camera.CFrame|CFrame`.

Untuk semua pengaturan `CameraType` **kecuali** `Enum.CameraType.Scriptable`,
properti `Class.Camera.CameraSubject|CameraSubject` mewakili objek
yang posisinya menjadi fokus `Class.Camera.Focus|Focus`.

Camera.CameraType

Menentukan `Enum.CameraType` yang akan dibaca oleh skrip kamera.

Properti ini adalah `Datatype.CFrame` dari `Class.Camera`, mendefinisikan
posisi dan orientasinya di dunia 3D. Perhatikan bahwa beberapa transformasi,
seperti rotasi kepala saat menggunakan perangkat VR, tidak tercermin
pada properti ini, jadi Anda harus menggunakan
`Class.Camera:GetRenderCFrame()|GetRenderCFrame()` untuk mendapatkan "yang sebenarnya"
`Datatype.CFrame` dari kamera.

Anda dapat memindahkan kamera dengan mengatur properti ini. Namun, skrip
kamera default juga mengaturnya, jadi Anda harus:

- Mengatur `Class.Camera.CameraType|CameraType` kamera ke
  `Enum.CameraType.Scriptable` sehingga skrip kamera default tidak
  akan memperbarui `Datatype.CFrame` kamera. Metode ini adalah yang paling
  sederhana dan disarankan dalam kebanyakan kasus.

- Sepenuhnya mengganti skrip kamera default dengan alternatif. Pendekatan
  ini hanya disarankan jika Anda tidak memerlukan fungsionalitas kamera
  default.

Cara yang paling intuitif untuk memposisikan dan mengorientasikan
`Class.Camera` adalah dengan menggunakan konstruktor `Datatype.CFrame.lookAt()`.
Dalam contoh berikut, `Class.Camera` diposisikan di
`Datatype.Vector3.new(0, 10, 0)` dan diorientasikan untuk melihat ke
`Datatype.Vector3.new(10, 0, 0)`.

```lua
local camera = workspace.CurrentCamera
camera.CameraType = Enum.CameraType.Scriptable

local pos = Vector3.new(0, 10, 0)
local lookAtPos = Vector3.new(10, 0, 0)

camera.CFrame = CFrame.lookAt(pos, lookAtPos)
```
Meskipun kamera dapat ditempatkan dengan cara yang ditunjukkan di atas,
Anda mungkin ingin menganimasikannya untuk bergerak dengan halus dari satu
`Datatype.CFrame` ke yang lain. Untuk ini, Anda dapat:

- Mengatur posisi/orientasi kamera setiap frame dengan
  `Class.RunService:BindToRenderStep()` dan metode `Datatype.CFrame:Lerp()`.
- Membuat dan memutar `Class.Tween` yang menganimasikan posisi/orientasi
  kamera:

  
```lua
local Players = game:GetService("Players")
  local TweenService = game:GetService("TweenService")

  local camera = workspace.CurrentCamera
  camera.CameraType = Enum.CameraType.Scriptable

  local player = Players.LocalPlayer
  local character = player.Character
  if not character or character.Parent == nil then
  	character = player.CharacterAdded:Wait()
  end

  local pos = camera.CFrame * Vector3.new(0, 20, 0)
  local lookAtPos = character.PrimaryPart.Position
  local targetCFrame = CFrame.lookAt(pos, lookAtPos)

  local tween = TweenService:Create(camera, TweenInfo.new(2), {CFrame = targetCFrame})

  tween:Play()
```

Camera.CFrame

`Datatype.CFrame` dari `Class.Camera`, mendefinisikan posisi dan
orientasinya di dunia 3D.

Versi lama dari properti `Class.Camera.CFrame|CFrame` yang
berfungsi identik dengannya.

Item ini harus digunakan dalam `Class.LocalScript` agar berfungsi
seperti yang diharapkan secara online.

Camera.CoordinateFrame

Mengatur berapa derajat dalam arah diagonal (dari satu sudut
viewport ke sudut yang berlawanan) yang dapat dilihat kamera. Lihat
`Class.Camera.FieldOfView|FieldOfView` untuk penjelasan yang lebih umum
mengenai bidang pandang.

Perhatikan bahwa `DiagonalFieldOfView` mewakili bidang pandang yang
terlihat oleh `Class.Camera` yang merender ke area layar penuh yang mungkin
terhalang oleh notch atau potongan layar pada beberapa perangkat. Lihat
`Class.Camera.ViewportSize|ViewportSize` untuk informasi lebih lanjut.

Camera.DiagonalFieldOfView

Mengatur sudut bidang pandang diagonal kamera.

Properti `FieldOfView` (FOV) mengatur berapa derajat dalam arah vertikal
yang dapat dilihat kamera. Properti ini dibatasi antara `1` dan
`120` derajat dan defaultnya adalah `70`. Bidang pandang yang sangat rendah
atau sangat tinggi tidak disarankan karena dapat membuat pemain merasa
kebingungan.

Perhatikan bahwa skala seragam diterapkan, yang berarti bidang pandang
vertikal dan horizontal selalu terkait dengan rasio aspek layar.

Penggunaan yang disarankan untuk `FieldOfView` meliputi:

- Mengurangi FOV untuk memberikan kesan pembesaran, misalnya saat
  menggunakan teropong.
- Meningkatkan FOV saat pemain "berlari" untuk memberikan kesan
  kurangnya kontrol.

Perhatikan bahwa `FieldOfView` mewakili bidang pandang yang terlihat oleh
`Class.Camera` yang merender ke area layar penuh yang mungkin terhalang
oleh notch atau potongan layar pada beberapa perangkat. Lihat
`Class.Camera.ViewportSize|ViewportSize` untuk informasi lebih lanjut.

Camera.FieldOfView

Mengatur sudut bidang pandang vertikal kamera.

Properti `Class.Camera.FieldOfView|FieldOfView` (FOV) kamera harus diperbarui
untuk mencerminkan perubahan `Class.Camera.ViewportSize|ViewportSize`. Nilai
`FieldOfViewMode` menentukan nilai FOV mana yang akan tetap konstan.

Sebagai contoh, ketika properti ini diatur ke `Enum.FieldOfViewMode.Vertical`,
FOV horizontal diperbarui saat viewport diubah ukurannya, tetapi FOV
vertikal tetap konstan. Jika properti ini diatur ke
`Enum.FieldOfViewMode.Diagonal`, baik FOV horizontal maupun vertikal
mungkin diubah untuk menjaga FOV diagonal tetap konstan.

Camera.FieldOfViewMode

Menentukan nilai FOV dari `Class.Camera` yang tidak berubah saat
ukuran viewport berubah.

Operasi grafis tertentu yang dilakukan mesin, seperti memperbarui
pencahayaan, dapat memakan waktu atau usaha komputasi untuk diselesaikan.
Properti `Focus` kamera memberi tahu mesin area mana di ruang 3D yang
harus diprioritaskan saat melakukan operasi tersebut. Misalnya, pencahayaan dinamis
dari objek seperti `Class.PointLight|PointLights` mungkin tidak dirender pada jarak
jauh dari fokus.

Skrip kamera default Roblox secara otomatis mengatur `Focus` untuk mengikuti
`Class.Camera.CameraSubject|CameraSubject` (biasanya `Class.Humanoid`).
Namun, `Focus` **tidak** akan diperbarui secara otomatis ketika
`Class.Camera.CameraType|CameraType` diatur ke
`Enum.CameraType.Scriptable` atau ketika skrip kamera default tidak
sedang digunakan. Dalam kasus ini, Anda harus memperbarui `Focus` setiap
frame, menggunakan metode `Class.RunService:BindToRenderStep()` pada
prioritas `Enum.RenderPriority.Camera`.

`Focus` tidak mempengaruhi posisi atau orientasi kamera; lihat
`Class.Camera.CFrame|CFrame` untuk ini.

Camera.Focus

Mengatur area di ruang 3D yang diprioritaskan oleh sistem grafis Roblox.

Camera.focus

Mengalihkan apakah kamera akan secara otomatis melacak gerakan kepala pemain yang
menggunakan perangkat VR. Ketika `true` (default), mesin menggabungkan
`Class.Camera.CFrame|CFrame` dengan `Enum.UserCFrame` dari kepala pengguna
untuk merender tampilan pemain dengan pelacakan kepala yang diperhitungkan. Tampilan akan
render pada `Datatype.CFrame` berikut:

```lua
local UserInputService = game:GetService("UserInputService")

local camera = workspace.CurrentCamera

local headCFrame = UserInputService:GetUserCFrame(Enum.UserCFrame.Head)
headCFrame = headCFrame.Rotation + headCFrame.Position * camera.HeadScale

-- Ini akan setara dengan Camera:GetRenderCFrame()
local renderCFrame = camera.CFrame * headCFrame
```
Disarankan untuk **tidak** menonaktifkan properti ini karena alasan berikut:

- Pemain mungkin mengalami mual jika solusi pelacakan kepala yang setara
  tidak ditambahkan.
- Mesin Roblox melakukan optimasi latensi ketika `HeadLocked` adalah
  true.

##### Lihat Juga

- `Class.VRService:GetUserCFrame()` yang dapat digunakan untuk mendapatkan
  `Datatype.CFrame` dari kepala.
- `Class.VRService:RecenterUserHeadCFrame()` yang digunakan untuk mengatur ulang
  kepala ke posisi dan orientasi saat ini dari perangkat VR.
- Metode `Class.Camera:GetRenderCFrame()|GetRenderCFrame()` yang
  mengembalikan `Class.Camera.CFrame|CFrame` yang digabungkan dengan
  `Datatype.CFrame` dari kepala pengguna.

Camera.HeadLocked

Mengalihkan apakah kamera akan secara otomatis melacak gerakan kepala pemain yang
menggunakan perangkat VR.

`HeadScale` adalah skala perspektif pengguna terhadap dunia saat menggunakan
VR.

Ukuran 1 stud dalam VR adalah `0.3 meter / HeadScale`, yang berarti bahwa nilai
`HeadScale` yang lebih besar membuat dunia terlihat lebih kecil dari perspektif
pengguna saat menggunakan perangkat VR. Misalnya, sebuah bagian yang setinggi 1 stud
terlihat setinggi 0.6 meter bagi pemain VR dengan `HeadScale` sebesar `0.5`.

Properti ini secara otomatis dikendalikan oleh
`Class.VRService.AutomaticScaling` untuk menyelaraskan perspektif pemain dengan
ukuran avatar mereka. Jika Anda berniat untuk mengontrol `HeadScale` sendiri atau
menggunakan karakter kustom, alihkan `Class.VRService.AutomaticScaling` ke
`Enum.VRScaling.Off`.

Properti ini tidak boleh disamakan dengan `Class.Humanoid.HeadScale` yang
merupakan `Class.NumberValue` yang diparent ke `Class.Humanoid` untuk mengontrol
skala.

Camera.HeadScale

Mengatur skala perspektif pengguna terhadap dunia saat menggunakan VR.

Properti `MaxAxisFieldOfView` mengatur berapa derajat sepanjang sumbu viewport terpanjang
yang dapat dilihat kamera.

Ketika sumbu terpanjang adalah sumbu vertikal, properti ini akan berperilaku
mirip dengan properti `Class.Camera.FieldOfView|FieldOfView`. Ini biasanya
terjadi ketika perangkat dalam orientasi potret. Dalam orientasi lanskap,
sumbu terpanjang akan menjadi sumbu horizontal; dalam hal ini, properti ini
menggambarkan bidang pandang horizontal dari `Class.Camera`.

Camera.MaxAxisFieldOfView

Mengatur sudut bidang pandang kamera sepanjang sumbu viewport terpanjang.

Properti `NearPlaneZ` mendeskripsikan seberapa jauh bidang pemotongan dekat
kamera, dalam stud. Bidang pemotongan dekat adalah bidang geometris
yang berada di depan `Class.Camera.CFrame|CFrame` kamera. Apa pun
antara bidang ini dan kamera tidak akan dirender, menciptakan tampilan potongan
ketika melihat objek pada jarak yang sangat dekat. Nilai `NearPlaneZ`
bervariasi di berbagai platform dan saat ini selalu berada di antara `-0.1`
dan `-0.5`.

<img src="/assets/engine-api/classes/Camera/NearPlaneZ.jpg" width="720" alt="Diagram menunjukkan bagaimana NearPlaneZ memotong (tidak merender) konten 3D antara bidang dan kamera." />

Camera.NearPlaneZ

Mendeskripsikan offset negatif **Z**, dalam stud, dari bidang pemotongan dekat
kamera.

Menentukan aspek mana dari `Class.Camera.ViewportSize|ViewportSize` yang dikendalikan oleh `Class.Camera.OrthographicSize|OrthographicSize`.

Sebagai contoh, ketika properti ini diatur ke `Enum.OrthographicMode.Vertical`, proyeksi ortografis diskalakan sehingga dimensi vertikal mencakup tepat `Class.Camera.OrthographicSize|OrthographicSize` studs, dan dimensi horizontal mencakup berapa pun studs yang diperlukan untuk mencocokkan.

Camera.OrthographicMode

Menentukan sumbu layar mana `Class.Camera.OrthographicSize|OrthographicSize` diterapkan.

`Class.Camera.OrthographicMode|OrthographicMode` memilih dimensi dari viewport yang ingin Anda kendalikan.
`Class.Camera.OrthographicSize|OrthographicSize` menetapkan ukuran dalam studs yang dicakup oleh dimensi viewport tersebut.

Sebagai contoh, jika `Class.Camera.OrthographicMode|OrthographicMode` diatur ke `Enum.OrthographicMode.MaxAxis`, maka dimensi yang lebih besar dari viewport akan mencakup `Class.Camera.OrthographicSize|OrthographicSize` studs.

Camera.OrthographicSize

Menentukan ukuran dalam studs dari dimensi yang dipilih oleh `Class.Camera.OrthographicMode|OrthographicMode`.

Diatur ke `Enum.ProjectionType.Perspective` (default) untuk menggunakan kamera perspektif, di mana garis paralel dalam 3D bertemu di layar dan objek menjadi lebih kecil di kejauhan. Diatur ke `Enum.ProjectionType.Orthographic` untuk menggunakan kamera ortografis, di mana garis paralel tetap paralel dan objek memiliki ukuran yang sama pada jarak berapa pun. Ini berguna untuk hal-hal seperti permainan 2D, permainan isometrik, dan minimap.

Camera.ProjectionType

Memilih antara kamera perspektif dan ortografis.

`ViewportSize` mengembalikan dimensi area aman perangkat di layar saat ini. Area ini adalah persegi panjang yang mencakup area bilah atas Roblox tetapi tidak mencakup notch perangkat atau potongan layar. Satuan dari `ViewportSize` adalah unit offset UI Roblox yang mungkin berbeda dari piksel tampilan asli.

<img src="../../../assets/engine-api/classes/Camera/DeviceSafeAreaVsFullscreen.png" width="840" alt="Layar perangkat seluler dengan potongan yang menunjukkan area aman perangkat." />

Seperti yang disebutkan di atas, `ViewportSize` tidak sama dengan ukuran area layar penuh pada tampilan dengan potongan atau notch. Untuk mendapatkan ukuran area layar penuh di semua tampilan, Anda dapat menanyakan properti `Class.ScreenGui.AbsoluteSize|AbsoluteSize` dari `Class.ScreenGui` dengan `Class.ScreenGui.ScreenInsets|ScreenInsets` diatur ke `Enum.ScreenInsets.None|None`. Lihat `Enum.ScreenInsets` untuk informasi lebih lanjut tentang bagaimana area layar didefinisikan.

Akhirnya, perlu dicatat bahwa `ViewportSize` bukan ukuran viewport sebenarnya yang digunakan kamera untuk merender (kamera merender di area layar penuh). Juga, properti `Class.Camera.FieldOfView|FieldOfView` dan `Class.Camera.DiagonalFieldOfView|DiagonalFieldOfView` didasarkan pada area layar penuh, bukan `ViewportSize`.

##### Pembaruan Kamera

Hanya `Class.Camera` yang saat ini dirujuk oleh `Class.Workspace.CurrentCamera` yang memiliki `ViewportSize` diperbarui setiap frame selama langkah `Class.RunService.PreRender|PreRender`. `ViewportSize` dari semua kamera lain dalam pengalaman Anda tidak akan diperbarui, termasuk yang digunakan untuk `Class.ViewportFrame|ViewportFrames`.

Camera.ViewportSize

Dimensi area aman perangkat di klien Roblox.

Bidang pandang dan ukuran ortografis ditentukan untuk satu sumbu viewport, baik horizontal atau vertikal. Normalnya, sumbu lainnya secara otomatis menyesuaikan diri untuk menjaga piksel tetap persegi. Ini memungkinkan Anda untuk meregangkan sumbu lainnya sehingga piksel tidak persegi, dengan rasio hingga 2:1. Ini dapat dianimasikan untuk membuat tampilan terasa tidak tepat, seperti saat terkejut.

Ini bekerja untuk kamera ortografis dan perspektif.

Camera.ViewStretch

Mengubah sumbu tampilan yang tidak dipasang oleh `Class.Camera.FieldOfViewMode|FieldOfViewMode` atau `Class.Camera.OrthographicMode|OrthographicMode` saat ini.

Properti ini mengalihkan apakah akan menerapkan kemiringan dan gulungan dari properti `Class.Camera.CFrame|CFrame` saat pemain menggunakan perangkat VR.

Untuk mencegah mabuk perjalanan, horizon harus tetap level. Miringkan dan gulungkan tampilan pemain saat menggunakan perangkat VR dapat menyebabkan ketidakcocokan antara ruang fisik pemain dan ruang virtual yang mereka lihat. Mengubah arah ke bawah yang tampak dapat menyebabkan pemain kehilangan keseimbangan atau mengalami pusing.

Untuk alasan ini, umumnya disarankan untuk membiarkan properti ini dinonaktifkan, kecuali Anda telah menguji pengalaman Anda secara menyeluruh untuk efek ini. Bahkan dengan kemiringan dan gulungan diaktifkan, Anda mungkin ingin memastikan pemain selalu memiliki kerangka referensi yang stabil, seperti interior kendaraan atau lantai yang dapat membantu pemain menginjakkan diri di ruang fisik mereka.

Camera.VRTiltAndRollEnabled

Mengalihkan apakah akan menerapkan kemiringan dan gulungan dari properti `Class.Camera.CFrame|CFrame` saat pemain menggunakan perangkat VR.

Sebuah kelas yang mendefinisikan tampilan dunia 3D.

Sebuah `Class.PVInstance` adalah kelas abstrak yang tidak dapat dibuat. Ini adalah
dasar untuk semua objek yang memiliki lokasi fisik di dunia.

Contoh kode ini adalah skrip teleportasi sederhana yang memindahkan karakter Anda
10&nbsp;stud ke depan dalam arah yang Anda hadapi saat Anda menekan
kunci <kbd>F</kbd>. Ini dilakukan dengan mendapatkan pivot saat ini dengan
`Class.PVInstance:GetPivot()` dan memanggil `PVInstance|PivotTo` untuk memindahkan
karakter ke depan.

Fungsi ini mendapatkan pivot dari sebuah `Class.PVInstance`. Ini sering digunakan
bersama `Class.PVInstance:PivotTo()` untuk memindahkan sebuah model.

`Class.Model|Models` dan `Class.BasePart|BaseParts` keduanya adalah
`Class.PVInstance|PVInstances` ("Posisi Kecepatan Instance") dan jadi keduanya
memiliki fungsi ini.

PVInstance:GetPivot

`Datatype.CFrame` ruang dunia dari pivot instance.


Mendapatkan pivot dari sebuah `Class.PVInstance`.

Mengubah `Class.PVInstance` bersama dengan semua `Class.PVInstance|PVInstances`
keturunannya sehingga pivot sekarang terletak di `Datatype.CFrame` yang
ditetapkan. Ini adalah fungsi utama yang seharusnya
 DIGUNAKAN untuk memindahkan `Class.Model|Models` melalui skrip.

`Class.BasePart|BaseParts` dipindahkan dengan cara ini dengan
transformasi `Datatype.CFrame` mereka menggunakan offset yang diperlukan.
`Class.Model|Models` dipindahkan dengan cara ini dengan
transformasi `Class.Model.WorldPivot` mereka menggunakan offset yang diperlukan.

Perhatikan bahwa demi efisiensi, acara `Class.Object.Changed` tidak
dipicu untuk `Class.BasePart.Position|Position` dan
`Class.BasePart.Orientation|Orientation` dari `Class.BasePart|BaseParts`
yang dipindahkan dengan cara ini; mereka hanya dipicu untuk `Datatype.CFrame`.

Saat memanggil `Class.PVInstance:PivotTo()|PivotTo` pada `Class.Model|Models`,
offset dari bagian dan model keturunan disimpan, sehingga
panggilan berikutnya ke `Class.PVInstance:PivotTo()|PivotTo` pada model yang sama
tidak mengakumulasi drifting floating point antara bagian-bagian yang
membentuk model.

`Class.Model|Models` dan `Class.BasePart|BaseParts` keduanya adalah
`Class.PVInstance|PVInstances` ("Posisi Kecepatan Instances") dan sehingga keduanya
memiliki fungsi ini.

PVInstance:PivotTo

targetCFrame

`Datatype.CFrame` yang seharusnya sama dengan pivot `Class.PVInstance`
setelah dipindahkan.

Mengubah `Class.PVInstance` bersama dengan semua `Class.PVInstance|PVInstances`
keturunannya sehingga pivot sekarang terletak di `Datatype.CFrame` yang
ditentukan.

PVInstance

Properti hanya untuk editor, ditampilkan di jendela Properti Studio sebagai **Posisi
Asal** dan **Orientasi Asal** di bawah **Transformasi**. Nilainya adalah
`Datatype.CFrame` ruang dunia dari pivot instance; membacanya
mengembalikan `Datatype.CFrame` yang sama seperti `Class.PVInstance:GetPivot()`. Ini
tidak memiliki nilai yang disimpan sendiri dan selalu mencerminkan pivot saat ini.

Mengaturnya dari jendela Properti memindahkan seluruh instance sehingga
pivotnya berada di `Datatype.CFrame` baru, mirip dengan
`Class.PVInstance:PivotTo()`. Mengedit melalui jendela Properti
temporer menonaktifkan `Class.WeldConstraint|WeldConstraints` ke objek lain untuk
pergerakan; `PivotTo` tidak memodifikasi sambungan.

Tidak tersedia untuk skrip; gunakan `Class.PVInstance:GetPivot()` dan
`Class.PVInstance:PivotTo()` saat runtime sebagai gantinya.


PVInstance.Origin

Properti hanya untuk editor yang membaca dan mengatur `Datatype.CFrame` dunia dari
pivot `Class.PVInstance`, memindahkan seluruh instance saat diubah
melalui jendela Properti Studio.


Properti hanya untuk editor, ditampilkan di jendela Properti Studio sebagai **Posisi
Pivot** dan **Orientasi Pivot** di bawah **Pivot**. Ini adalah
`Datatype.CFrame` dari pivot relatif terhadap bingkai instance itu sendiri.

Mengubahnya dari jendela Properti memindahkan pivot relatif terhadap
instance sambil membiarkan instance di tempat, tidak seperti `Asal`, yang memindahkan
seluruh instance. Untuk `Class.BasePart`, offset secara default adalah
`Datatype.CFrame` identitas, sehingga pivot bertepatan dengan pusat bagian.
Untuk `Class.Model`, properti ini hanya muncul ketika model memiliki
`Class.Model.PrimaryPart|PrimaryPart`; kemudian mencerminkan dan mengedit
`Class.BasePart.PivotOffset|PivotOffset` bagian tersebut, dan
`Class.Model:GetPivot()` adalah alias dari pivot bagian utama.

Tidak tersedia untuk skrip; skrip membaca dan menulis yang setara melalui
kelas konkret, seperti `Class.BasePart.PivotOffset`.


PVInstance.Pivot Offset

Properti hanya untuk editor yang menampilkan dan mengedit `Datatype.CFrame`
pivot relatif terhadap instance, hanya memindahkan pivot dan membiarkan instance
di tempat.


Kelas abstrak untuk semua objek yang memiliki lokasi fisik di dunia.

`Instance` adalah kelas dasar untuk semua kelas dalam hierarki kelas Roblox
yang dapat menjadi bagian dari pohon `Class.DataModel`.

Tidak mungkin untuk secara langsung membuat objek `Instance` root, tetapi
konstruktor khusus `Datatype.Instance.new()` membuat objek melalui kode,
mengambil nama kelas sebagai parameter dan mengembalikan objek yang dibuat.


Menunjukkan cara mendeteksi perubahan pada leluhur sebuah instance dengan menghubungkan ke
`Class.Instance.AncestryChanged` event.

Parent dari ChangingPart diatur ke nilai yang berbeda seiring waktu. Parent dari
part adalah leluhur part, jadi event `Class.Instance.AncestryChanged`
akan dipicu setiap kali terjadi perubahan.

Ditembak saat instance ini dipindahkan atau saat salah satu nenek moyangnya
dipindahkan.

Anda dapat menggunakan peristiwa ini untuk melacak penghapusan instance di Studio,
seperti penghapusan manual di Explorer atau melalui plugin. Jika Anda perlu
deteksi saat instance dihancurkan menggunakan `Class.Instance:Destroy()`,
gunakan peristiwa `Class.Instance.Destroying` sebagai gantinya.


Instance.AncestryChanged

child

Instance yang properti `Class.Instance.Parent|Parent`-nya diubah,
yang bisa jadi instance ini atau nenek moyang yang lebih jauh, **bukan**
harus instance yang terhubung ke handler.


parent

Ditembak saat properti `Class.Instance.Parent` dari objek ini atau salah satu
nenek moyangnya diubah.


Peristiwa ini ditembak setiap kali atribut diubah pada instance,
termasuk saat atribut diatur ke `nil`. Nama atribut yang diubah
akan diteruskan ke fungsi yang terhubung.

Misalnya, cuplikan kode berikut menghubungkan fungsi `attributeChanged()`
untuk ditembak setiap kali salah satu atribut bagian berubah:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "berubah")
end

part.AttributeChanged:Connect(attributeChanged)
```
Lihat juga `Class.Instance:GetAttributeChangedSignal()` yang mengembalikan
peristiwa yang ditembak saat atribut tertentu diubah.


Instance.AttributeChanged

attribute

Ditembak setiap kali atribut diubah pada `Class.Instance`.


Cuplikan ini mencetak nama objek saat mereka ditambahkan ke Workspace:

Ditembak setelah objek dipindahkan ke `Class.Instance` ini.

Catatan, saat menggunakan metode ini di klien untuk mendeteksi objek yang dibuat oleh
server, perlu menggunakan `Class.Instance:WaitForChild()` saat
mengindeks keturunan objek ini. Ini karena objek dan keturunannya tidak
jaminan untuk direplikasi dari server ke klien secara bersamaan. Misalnya:

```
local Workspace = game:GetService("Workspace")

Workspace.ChildAdded:Connect(function(child)
	-- Gunakan WaitForChild() karena keturunan mungkin belum direplikasi
	local head = child:WaitForChild("Head")
end)
```
Catatan, peristiwa ini hanya beroperasi untuk anak langsung dari
`Class.Instance`. Untuk peristiwa yang menangkap semua keturunan, gunakan
`Class.Instance.DescendantAdded`.

Lihat juga `Class.Instance.ChildRemoved`.


Instance.ChildAdded

`Class.Instance` yang telah ditambahkan.


Ditembak setelah objek dipindahkan ke `Class.Instance` ini.


Instance.childAdded

Potongan ini mencetak nama objek saat mereka dihapus dari Workspace:

Ditembak setelah anak dihapus dari `Class.Instance` ini.

Dihapus mengacu pada saat induk objek diubah dari `Class.Instance` ini
ke sesuatu selain `Class.Instance` ini. Catatan, peristiwa ini juga
akan ditembak saat anak dihancurkan (menggunakan
`Class.Instance:Destroy()`) karena fungsi hancur mengatur induk objek
ke `nil`.

Peristiwa ini hanya beroperasi untuk anak langsung dari `Class.Instance`.
Untuk peristiwa yang menangkap semua keturunan, gunakan
`Class.Instance.DescendantRemoving`.

Lihat juga `Class.Instance.ChildAdded`.


Instance.ChildRemoved

Ditembak setelah anak dihapus dari `Class.Instance` ini.


Contoh berikut akan mencetak nama objek apa pun yang ditambahkan ke
Workspace:

Peristiwa ini ditembak setelah keturunan ditambahkan ke `Class.Instance`.

Karena ini ditembak untuk setiap keturunan, memindahkan objek ke
`Class.Instance` akan menembakkan peristiwa untuk objek ini dan semua
keturunannya secara individu.

Jika Anda hanya peduli dengan **anak langsung** dari
`Class.Instance`, gunakan `Class.Instance.ChildAdded` sebagai gantinya.

Lihat juga `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

descendant

Ditembak setelah keturunan ditambahkan ke `Class.Instance`.


Contoh berikut mencetak nama dari setiap keturunan saat sedang dihapus
 dari Workspace:

Peristiwa ini ditembak **segera sebelum** induk `Class.Instance`
berubah sehingga instance **keturunan** tidak lagi menjadi
keturunan. `Class.Instance:Destroy()|Destroy()` mengubah `Class.Instance.Parent|Parent`
sehingga menjadi `nil`, jadi memanggil metode itu pada keturunan induk
akan menyebabkan peristiwa ini ditembak.

Karena peristiwa ini ditembak **sebelum** penghapusan keturunan, induk dari
keturunan tidak akan berubah pada saat peristiwa ini ditembak. Jika keturunan
juga merupakan **anak langsung** dari induk, peristiwa ini akan ditembak
sebelum `Class.Instance.ChildRemoved`.

Jika keturunan memiliki anak, peristiwa ini ditembak dengan keturunan terlebih dahulu,
dilanjutkan dengan keturunannya.

#### Peringatan

Peristiwa ini ditembak dengan objek keturunan yang sedang dihapus.
Mencoba mengatur `Class.Instance.Parent|Parent` dari keturunan ke
sesuatu yang lain akan gagal. Berikut adalah contoh yang menunjukkan hal ini:

```
local Workspace = game:GetService("Workspace")

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Jangan manipulasi induk keturunan dalam fungsi ini!
	-- Peristiwa ini ditembak KARENA induk dimanipulasi, dan perubahan belum terjadi
	-- Oleh karena itu, problematik untuk mengubah induk seperti ini:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Lihat juga `Class.Instance.DescendantAdded|DescendantAdded`.


Instance.DescendantRemoving

Ditembak segera sebelum keturunan dari `Class.Instance` dihapus.


Instance

`Instance` adalah kelas dasar untuk semua kelas dalam hierarki kelas Roblox
yang dapat menjadi bagian dari pohon `Class.DataModel`.


/reference/engine/classes/ViewportCamera.yaml

Ringkasan