`ViewportCamera` to `Class.Camera` przeznaczony dla kamer, które ustawiasz w
takcie projektowania, takich jak kamera przypisana do `Class.ViewportFrame.CurrentCamera`
lub `ThumbnailCamera` wewnątrz `Class.Model`. Ma te same właściwości,
metody i zdarzenia co `Class.Camera`, ale w przeciwieństwie do `Class.Camera` 
replikuje, więc działa zgodnie z oczekiwaniami w Team Create i gdy jest replikowany z
serwera do klientów.

Użyj `Class.Camera` dla kamery, która renderuje świat 3D, dostępnej
przez `Class.Workspace.CurrentCamera`. Użyj `ViewportCamera` dla każdej innej
kamery, którą tworzysz i chcesz zapisać z miejscem.

#### Zachowanie automatycznej aktualizacji

Gdy wklejasz skopiowaną treść zawierającą `Class.Camera` w Studio, każda
`Class.Camera` jest automatycznie konwertowana na `ViewportCamera` z tymi
samymi właściwościami. Ma to na celu ułatwienie powszechnego przepływu pracy
przy ustawianiu kamery poprzez pozycjonowanie głównej kamery roboczej, a następnie
kopiowanie i wklejanie tej kamery.


ViewportCamera

`Class.Camera`, który replikuje i jest zapisywany jako treść stworzona przez autora, do użycia
z `Class.ViewportFrame|ViewportFrames` lub jako ThumbnailCamera.


Obiekt `Camera` definiuje widok 3D świata. W działającym doświadczeniu,
każdy klient ma swój własny obiekt `Camera`, który znajduje się w lokalnym
`Class.Workspace` tego klienta, dostępny przez właściwość `Class.Workspace.CurrentCamera`.

Najważniejsze właściwości kamery to:

- `Class.Camera.CFrame|CFrame`, która reprezentuje pozycję i orientację
  kamery.

- `Class.Camera.CameraType|CameraType`, która jest odczytywana przez skrypty
  kamery doświadczenia i określa, jak kamera powinna aktualizować się w każdej klatce.

- `Class.Camera.CameraSubject|CameraSubject`, która jest odczytywana przez skrypty
  kamery doświadczenia i określa, jaki obiekt kamera powinna śledzić.

- `Class.Camera.FieldOfView|FieldOfView`, która reprezentuje widoczny zasięg
  obserwowalnego świata.

- `Class.Camera.Focus|Focus`, która reprezentuje punkt, na który kamera patrzy.
  Ważne jest, aby ta właściwość była ustawiona, ponieważ niektóre wizualizacje będą
  bardziej szczegółowe i będą aktualizowane częściej w zależności od tego, jak blisko
  są do punktu skupienia.

Zobacz [Dostosowywanie Kamery](/workspace/camera) po więcej
informacji na temat dostosowywania zachowania kamery.

#### Przechowywanie Wiele Kamer

Zauważ, że przy zmianie `Class.Workspace.CurrentCamera` na nową
`Class.Camera`, wszystkie inne `Class.Camera|Cameras` bezpośrednio pochodzące od
`Class.Workspace` zostaną zniszczone. Jeśli potrzebujesz przechowywać wiele kamer i
przełączać się między nimi na żądanie, zaleca się przechowywanie ich w
`Class.Folder` lub `Class.Model` pod `Class.Workspace`, w którym pozostaną nawet
przy zmianie `Class.Workspace.CurrentCamera|CurrentCamera`.

To zdarzenie jest wywoływane, gdy `Class.Camera` zakończy interpolację
używając metody `Class.Camera:Interpolate()`. Nie zostanie wywołane, jeśli tween
zostanie przerwany z powodu ponownego wywołania `Class.Camera:Interpolate()`.

Zaleca się użycie `Class.TweenService`, aby animować `Class.Camera`
zamiast tego, ponieważ jest to bardziej niezawodne i oferuje więcej opcji
stylów łagodzenia.

Camera.InterpolationFinished

Wywoływane, gdy `Class.Camera` zakończy interpolację
używając `Class.Camera:Interpolate()|Interpolate()`.

Ta metoda jest używana przez `PopperCam` w domyślnych skryptach kamery, aby upewnić
się, że przeszkody nie znajdują się między `Class.Camera` a jej obiektem.

Ta metoda sprawdzi wszystkie `Class.BasePart|BaseParts` i `Class.Terrain`
w `Class.Workspace` z następującymi wyjątkami:

- Każda `Class.Instance` określona w `ignoreList` (w tym jej
  potomkowie) będzie ignorowana
- `Class.BasePart|BaseParts` z `Class.BasePart.CanCollide` ustawionym na false
  są ignorowane
- `Class.BasePart|BaseParts` z `Class.BasePart.Transparency` większym
  niż 0.95 będą ignorowane. Woda `Class.Terrain` jest ignorowana.

Zauważ, że ta metoda wymaga `ignoreList`, aby działać, więc powinieneś
przekazać pustą tabelę, gdy nie jest wymagana.

Camera:GetLargestCutoffDistance

ignoreList

Tablica `Class.Instance|Instances`, które należy zignorować. Potomkowie tych
instancji również będą ignorowani.

Odległość, w studach, o którą `Class.Camera` musi być przesunięta
w kierunku `Class.Camera.Focus|Focus`, aby upewnić się, że nie ma
przeszkód między `Class.Camera.Focus|Focus` a
`Class.Camera.CFrame|CFrame` kamery.

Zwraca, jak bardzo `Class.Camera` musi być przesunięta w kierunku
`Class.Camera.Focus|Focus`, aby upewnić się, że nie ma przeszkód
między `Class.Camera.Focus|Focus` a `Class.Camera.CFrame|CFrame`.

Ta metoda jest uszkodzona i nie powinna być używana.

Ta metoda zwraca aktualną prędkość pan kamery `Class.Camera`.

Prędkość pan kamery `Class.Camera` opisuje prędkość, z jaką
`Class.Camera` obraca się wokół swojego `Class.Camera.Focus|Focus` wokół
osi **Y**.

Camera:GetPanSpeed

Prędkość, z jaką `Class.Camera` obraca się wokół swojego
`Class.Camera.Focus|Focus` na osi **Y**.

Zwraca aktualną prędkość 'pan' kamery `Class.Camera`.

Ta metoda zwraca tablicę `Class.BasePart|BaseParts`, które zasłaniają
linie widzenia między `Class.Camera.CFrame|CFrame` kamery a pozycjami
`Datatype.Vector3` w tablicy `castPoints`. Każda `Class.Instance|Instances`
uwzględniona w tablicy `ignoreList` będzie ignorowana, wraz z jej potomkami.

Parametr `castPoints` jest podawany jako tablica pozycji `Datatype.Vector3`.
Zauważ, że tablica `Class.BasePart|BaseParts` zwrócona jest w dowolnej kolejności,
a żadne dodatkowe dane o promieniach nie są dostarczane. Jeśli potrzebujesz danych,
takich jak pozycja trafienia, materiał trafienia lub normalna powierzchnia, powinieneś
wybrać metodę `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)
```
Jeśli `Class.Terrain` zasłania punkt rzucania, `Class.BasePart|BaseParts`
zasłaniające punkt rzucania między zasłaniającym `Class.Terrain` a
punktem rzucania nie będą zwracane.

Camera:GetPartsObscuringTarget

castPoints

Tablica pozycji `Datatype.Vector3` punktów rzucania.

Tablica `Class.Instance|Instances`, które powinny być ignorowane, wraz
z ich potomkami.

Tablica `Class.BasePart|BaseParts`, które zasłaniają linie widzenia
między `Class.Camera.CFrame|CFrame` kamery a
`castPoints`.

Zwraca tablicę `Class.BasePart|BaseParts`, które zasłaniają
linie widzenia między `Class.Camera.CFrame|CFrame` kamery a punktami
rzucania.

Ta metoda zwraca rzeczywisty `Datatype.CFrame` kamery `Class.Camera`,
jak jest renderowana, w tym wpływ VR (transformacje głowy VR nie są
zastosowane do właściwości `Class.Camera.CFrame|CFrame`, więc najlepszą praktyką
jest użycie `Class.Camera:GetRenderCFrame()|GetRenderCFrame()`, aby
uzyskać "prawdziwe" `Datatype.CFrame` widoku gracza).

Na przykład, podczas korzystania z VR, `Class.Camera` jest faktycznie renderowana
w następującym `Datatype.CFrame`:

```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
```
Renderowane `Datatype.CFrame` kamery będzie zmieniane tylko w celu uwzględnienia
głowy, gdy właściwość `Class.Camera.HeadLocked|HeadLocked` jest ustawiona na true.

Camera:GetRenderCFrame

`Datatype.CFrame`, w którym `Class.Camera` jest renderowana.

Zwraca rzeczywisty `Datatype.CFrame`, w którym `Class.Camera` jest renderowana,
uwzględniając wszelkie zastosowane obroty i wpływ urządzeń VR.

Ten przykład, używany w `Class.LocalScript`, pobierze aktualny
kąt obrotu kamery w stopniach. Następnie, jeśli kąt obrotu kamery nie wynosi 20
stopni, kąt obrotu kamery zostanie ustawiony na 20 stopni.


Ta metoda zwraca, w radianach, aktualny obrót zastosowany do
`Class.Camera` za pomocą `Class.Camera:SetRoll()|SetRoll()`. Obrót definiuje
się jako rotację wokół osi Z kamery.

Ta metoda zwraca tylko obrót zastosowany za pomocą metody
`Class.Camera:SetRoll()|SetRoll()`. Obrót ręcznie zastosowany do
`Class.Camera.CFrame|CFrame` nie jest uwzględniany. Aby uzyskać
rzeczywisty obrót `Class.Camera`, w tym obrót ręcznie zastosowany, możesz
użyć następującego fragmentu:

Camera:GetRoll

Aktualny obrót zastosowany przez `Class.Camera:SetRoll()|SetRoll()`, w
radianach.

Zwraca w radianach aktualny obrót, lub rotację wokół osi Z kamery,
zastosowaną do `Class.Camera` za pomocą
`Class.Camera:SetRoll()|SetRoll()`.

Ta metoda jest uszkodzona i nie powinna być używana.

Ta metoda zwraca aktualną prędkość przechylenia kamery `Class.Camera`.

Prędkość przechylenia kamery `Class.Camera` opisuje prędkość, z jaką
`Class.Camera` obraca się wokół swojego `Class.Camera.Focus|Focus` wokół
osi **X**.

Camera:GetTiltSpeed

Prędkość, z jaką `Class.Camera` obraca się wokół swojego
`Class.Camera.Focus|Focus` wokół osi **X**.

Zwraca aktualną prędkość przechylenia kamery `Class.Camera`.

Ta metoda tweenuje `Class.Camera` w sposób liniowy w kierunku nowego
`Class.Camera.CFrame|CFrame` i `Class.Camera.Focus|Focus` przez dany
czas, na przykład:

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

camera:Interpolate(
	CFrame.new(0, 10, 100),
	CFrame.new(0, 0, 100),
	5
)
```
W trakcie tweenowania `Class.Camera.CFrame|CFrame` kamery będzie
ukierunkowane w stronę `Class.Camera.Focus|Focus` kamery.

Gdy tweenowanie zostanie zakończone, zdarzenie
`Class.Camera.InterpolationFinished|InterpolationFinished` kamery
zostanie wywołane.

Jeśli ta metoda zostanie wywołana, gdy `Class.Camera` już jest tweenowane,
starsze tweenowanie zostanie zatrzymane (bez wywoływania
`Class.Camera.InterpolationFinished|InterpolationFinished`) i zastąpione
nowym tweenowaniem.

Interpolate można używać tylko wtedy, gdy aktualny
`Class.Camera.CameraType|CameraType` jest `Scriptable`, niezależnie od
tego, czy używane są domyślne skrypty kamery. Jeśli jest używane z jakimkolwiek
innym `Class.Camera.CameraType|CameraType`, zostanie zgłoszony błąd.

Zaleca się użycie `Class.TweenService`, aby tweenować `Class.Camera`
zamiast tego, ponieważ jest to bardziej niezawodne i oferuje różnorodne style
łagodzenia. Zobacz poniżej przykład:

```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

Właściwość `Datatype.CFrame`, do której ma tweenować `Class.Camera`.

endFocus

Właściwość `Datatype.CFrame`, do której ma tweenować `Class.Camera.Focus|Focus`.

duration

Tweenuje `Class.Camera` w sposób liniowy w kierunku nowego
`Class.Camera.CFrame|CFrame` i `Class.Camera.Focus|Focus` przez dany
czas.

Ta metoda prowadzi `Class.Camera` wokół `Class.Camera.Focus|Focus`
w 45-stopniowych przyrostach wokół osi **Y**.

Rotacja jest stosowana do właściwości `Class.Camera.CFrame|CFrame` kamery.

Ta metoda prowadzi `Class.Camera` w 45-stopniowych przyrostach, na przykład:

```lua
workspace.CurrentCamera:PanUnits(1) -- 45 stopni
workspace.CurrentCamera:PanUnits(-2) -- -90 stopni
```
PanUnits nie wymaga, aby `Class.Camera.CameraType|CameraType` było
`Scriptable`.

Camera:PanUnits

units

Liczba 45-stopniowych przyrostów, o które należy przesunąć `Class.Camera`.

Prowadzi `Class.Camera` wokół `Class.Camera.Focus|Focus` w 45-stopniowych
przyrostach wokół osi **Y**.

Ta metoda tworzy jednostkowy `Datatype.Ray` z 2D pozycji na ekranie
(zdefiniowanej w pikselach), uwzględniając wcięcie GUI. `Datatype.Ray`
pochodzi z `Datatype.Vector3` odpowiadającego 2D pozycji w
świecie na danej głębokości (w studach) od `Class.Camera`.

Ponieważ ta metoda uwzględnia wcięcie GUI, przesunięcie zastosowane do elementów GUI
(jak z górnego paska) jest uwzględniane. Oznacza to, że określona pozycja ekranu
rozpocznie się w lewym górnym rogu poniżej górnego paska. Dla identycznej metody,
która nie uwzględnia przesunięcia GUI, użyj `Class.Camera:ViewportPointToRay()|ViewportPointToRay()`.

Ponieważ stworzony `Datatype.Ray` jest jednostkowym promieniem, ma tylko jednego
studa długości. Aby stworzyć dłuższy promień, możesz zrobić to w następujący sposób:

```lua
local camera = workspace.CurrentCamera
local length = 500
local unitRay = camera:ScreenPointToRay(100, 100)
local extendedRay = Ray.new(unitRay.Origin, unitRay.Direction * length)
```
Ta metoda działa tylko dla aktualnej kamery `Class.Workspace`. Inne
kamery, takie jak te, które tworzysz dla `Class.ViewportFrame`, mają
początkowy rozmiar widoku <Typography noWrap>`(1, 1)`</Typography> i są
aktualizowane tylko po ustawieniu ich na `Class.Workspace.CurrentCamera`. Niezgodność
w rozmiarze widoku powoduje, że kamera zwraca promień z
niepoprawnym `Datatype.Ray.Direction`.

Camera:ScreenPointToRay

Pozycja na osi **X**, w pikselach, punktu ekranu, z którego ma
pochodzić `Datatype.Ray`. Ta pozycja uwzględnia wcięcie GUI.

Pozycja na osi **Y**, w pikselach, punktu ekranu, z którego ma
pochodzić `Datatype.Ray`. Ta pozycja uwzględnia wcięcie GUI.

depth

Głębokość od `Class.Camera`, w studach, z której ma być przesunięta
początkowa pozycja `Datatype.Ray`.

Jednostkowy `Datatype.Ray`, pochodzący z odpowiadającej
`Datatype.Vector3` pozycji świata podanych współrzędnych ekranu na
danej głębokości od `Class.Camera`. Ten promień jest skierowany
w kierunku `Class.Camera`.

Tworzy jednostkowy `Datatype.Ray` z pozycji na ekranie (w pikselach),
na określonej głębokości od `Class.Camera`, skierowany w kierunku kamery.
Uwzględnia wcięcie GUI.

Ta metoda ustawia `Enum.CameraPanMode`, który ma być używany przez `Class.Camera`
na urządzeniach mobilnych.

Gdy używany jest tryb `EdgeBump` `Enum.CameraPanMode`, przesuwanie za pomocą
przeciągania jest wyłączone, a włączone są kontrolki kamery z krawędzi.

Ustawienie trybu kamery nie ma wpływu na użytkowników systemu Windows ani Mac.

Camera:SetCameraPanMode

mode

Enum `CameraPanMode`, aby ustawić `Class.Camera`.

Ustawia `Enum.CameraPanMode`, który ma być używany przez `Class.Camera`
na urządzeniach mobilnych.

Ta metoda jest przestarzała i nie jest już uważana za najlepszą praktykę.

Ta metoda ustawia aktualny obrót, w radianach, kamery `Class.Camera`. Obrót
jest stosowany po `Class.Camera.CFrame|CFrame` i reprezentuje rotację wokół
osi Z kamery.

Na przykład, poniższe polecenie odwróci `Class.Camera`:

```lua
workspace.CurrentCamera:SetRoll(math.pi) -- math.pi radianów = 180 stopni
```
Ustawienie obrotu nie ma wpływu na żaden obrót zastosowany za pomocą
właściwości `Class.Camera.CFrame|CFrame`. Obrót zastosowany za pomocą SetRoll
nie jest odzwierciedlany w właściwości `Class.Camera.CFrame|CFrame`, ale jest
odzwierciedlany w `Datatype.CFrame` zwróconym przez
`Class.Camera:GetRenderCFrame()|GetRenderCFrame()`.

Ta metoda może być używana tylko wtedy, gdy `Class.Camera.CameraType|CameraType`
jest ustawione na `Scriptable`, niezależnie od tego, czy używane są domyślne
skrypty kamery. Jeśli jest używane z jakimkolwiek innym
`Class.Camera.CameraType|CameraType`, w wyjściu zostanie wyświetlony komunikat o
ostrzeżeniu.

Każdy obrót zastosowany za pomocą tej metody zostanie utracony, gdy
`Class.Camera.CameraType|CameraType` zostanie zmienione z `Scriptable`.

Aby uzyskać obrót ustawiony za pomocą tej metody, użyj
`Class.Camera:GetRoll()|GetRoll()`.

Ponieważ ta metoda jest przestarzała, zaleca się zamiast tego stosować obrót do
`Class.Camera` za pomocą właściwości `Class.Camera.CFrame|CFrame`. Na przykład:

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

Camera:SetRoll

rollAngle

Kąt obrotu, w radianach, który ma być zastosowany do `Class.Camera`.

Ustawia aktualny obrót zastosowany wokół osi Z kamery.

Ta metoda przechyla `Class.Camera`, obracając ją wokół
`Class.Camera.Focus|Focus` wokół osi **X** kamery o dany
wielokrotność 10 stopni.

Rotacja jest stosowana do właściwości `Class.Camera.CFrame|CFrame` kamery i
jest ograniczona między `-81.05` a `81.05` stopni.

Camera:TiltUnits

Liczba jednostek 10-stopniowych, o które należy przechylić `Class.Camera`.

Czy zastosowany przechył `Class.Camera` był ograniczony.

Przechyla `Class.Camera` wokół `Class.Camera.Focus|Focus` w 10-stopniowych
przyrostach wokół osi **X**.

Ta metoda tworzy jednostkowy `Datatype.Ray` z 2D pozycji w bezpiecznych
współrzędnych widoku urządzenia, zdefiniowanej w pikselach. Promień pochodzi z
`Datatype.Vector3` odpowiadającego 2D pozycji w świecie na danej
głębokości (w studach) od `Class.Camera`.

Jak pokazano poniżej, `(0, 0)` odpowiada lewemu górnemu punktowi
górnego paska Roblox. Oznacza to, że podana 2D pozycja **nie** uwzględnia
wcięcia `Enum.ScreenInsets|CoreUISafeInsets`, ale uwzględnia wszelkie
`Enum.ScreenInsets|DeviceSafeInsets`.

<img src="../../../assets/engine-api/classes/Camera/ViewportPointToRayOrigin.png" width="840" alt="Diagram pokazujący pochodzenie układu współrzędnych widoku obszaru bezpiecznego urządzenia." />

Zauważ, że instancje UI używają innego układu współrzędnych
(`Class.GuiObject.AbsolutePosition` używa układu współrzędnych widoku
`Enum.ScreenInsets|CoreUISafeInsets`, podczas gdy ta metoda używa układu
współrzędnych widoku `Enum.ScreenInsets|DeviceSafeInsets`). Jeśli chcesz
określić pozycję w współrzędnych UI, użyj `Class.Camera:ScreenPointToRay()|ScreenPointToRay()`.

Zauważ również, że ta metoda działa tylko dla
kamery `Class.Workspace.CurrentCamera`. Inne kamery, takie jak te, które
stworzysz dla `Class.ViewportFrame`, mają początkowy rozmiar widoku
`(1, 1)` i są aktualizowane tylko po ustawieniu ich na
`Class.Workspace.CurrentCamera|CurrentCamera`. Niezgodność w rozmiarze
widoku powoduje, że kamera zwraca promień z
niepoprawnym `Datatype.Ray.Direction`.

Ta metoda może być używana w połączeniu z właściwością
`Class.Camera.ViewportSize|ViewportSize`, aby stworzyć promień z
centrum ekranu, na przykład:

```lua
local camera = workspace.CurrentCamera

local viewportPoint = camera.ViewportSize / 2
local unitRay = camera:ViewportPointToRay(viewportPoint.X, viewportPoint.Y, 0)
```
Ponieważ stworzony `Datatype.Ray` jest jednostkowym promieniem, ma tylko jednego
studa długości. Aby stworzyć dłuższy promień, możesz zrobić to w następujący sposób:

```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

Pozycja na osi **X**, w pikselach, punktu widoku, z którego ma
pochodzić `Datatype.Ray`, w współrzędnych obszaru bezpiecznego urządzenia.

Pozycja na osi **Y**, w pikselach, punktu widoku, z którego ma
pochodzić `Datatype.Ray`, w współrzędnych obszaru bezpiecznego urządzenia.

Jednostkowy `Datatype.Ray`, pochodzący z odpowiadającej
`Datatype.Vector3` pozycji świata podanych współrzędnych widoku na
danej głębokości od `Class.Camera`. Ten promień jest skierowany
w kierunku `Class.Camera`.

Tworzy jednostkowy `Datatype.Ray` z pozycji na widoku (w pikselach),
na danej głębokości od `Class.Camera`, skierowany w kierunku kamery. Nie
uwzględnia wcięcia `Enum.ScreenInsets|CoreUISafeInsets`.

Ta metoda zwraca lokalizację ekranu i głębokość `Datatype.Vector3`
`worldPoint` i czy ten punkt znajduje się w granicach ekranu.

Ta metoda uwzględnia aktualne wcięcie GUI, takie jak przestrzeń
zajmowana przez górny pasek, co oznacza, że zwrócona pozycja 2D
jest w tych samych terminach, co pozycje GUI i może być używana do
umieszczania elementów GUI. Dla identycznej metody, która ignoruje
wcięcie GUI, zobacz `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
```
Zauważ, że ta metoda nie wykonuje żadnego raycastingu, a wartość logiczna
określająca, czy `worldPoint` znajduje się w granicach ekranu, będzie
`true`, niezależnie od tego, czy punkt jest zasłonięty przez
`Class.BasePart|BaseParts` lub `Class.Terrain`.

Camera:WorldToScreenPoint

worldPoint

Krotka zawierająca, w kolejności:

- `Datatype.Vector3`, którego komponenty **X** i **Y** reprezentują
  przesunięcie `worldPoint` od lewego górnego rogu ekranu,
  w pikselach. Komponent **Z** `Datatype.Vector3` reprezentuje
  głębokość `worldPoint` od ekranu (w studach).

- Wartość logiczna wskazująca, czy `worldPoint` znajduje się w granicach
  ekranu.

Zwraca lokalizację ekranu i głębokość `Datatype.Vector3` `worldPoint`
i czy ten punkt znajduje się w granicach ekranu. Uwzględnia
wcięcie GUI.

Ta metoda zwraca lokalizację ekranu i głębokość `Datatype.Vector3`
`worldPoint` i czy ten punkt znajduje się w granicach ekranu.

Ta metoda nie uwzględnia aktualnego wcięcia GUI, takiego jak
przestrzeń zajmowana przez górny pasek, co oznacza, że zwrócona
pozycja 2D pochodzi z lewego górnego rogu widoku. Chyba że używasz
`Class.ScreenGui.IgnoreGuiInset`, ta pozycja nie jest odpowiednia do
umieszczania elementów GUI.

Dla identycznej metody, która uwzględnia wcięcie GUI, zobacz
`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
```
Zauważ, że ta metoda nie wykonuje żadnego raycastingu, a wartość logiczna
określająca, czy `worldPoint` znajduje się w granicach ekranu, będzie
`true`, niezależnie od tego, czy punkt jest zasłonięty przez
`Class.BasePart|BaseParts` lub `Class.Terrain`.

##### Kamery ViewportFrame

Tylko `Class.Workspace.CurrentCamera` ma swoje wewnętrzne wymiary widoku
aktualizowane przez silnik w każdej klatce. Kamery używane wewnątrz
`Class.ViewportFrame` nie otrzymują aktualizacji widoku, więc komponenty X i Y
zwracane przez tę metodę będą w zakresie [0, 1], a nie w pikselach. W praktyce oznacza to,
że zwrócone wartości mogą być używane jako współrzędne skali (na przykład,
`Datatype.UDim2|UDim2.fromScale(vector.X, vector.Y)`) do umieszczania elementów GUI
względem ViewportFrame.

Camera:WorldToViewportPoint

Krotka zawierająca, w kolejności:

- `Datatype.Vector3`, którego komponenty **X** i **Y** reprezentują
  przesunięcie `worldPoint` od lewego górnego rogu widoku,
  w pikselach dla `Class.Workspace.CurrentCamera`. Dla kamer wewnątrz
  `Class.ViewportFrame`, wartości są znormalizowane do [0, 1]. Komponent
  **Z** `Datatype.Vector3` reprezentuje głębokość `worldPoint` od ekranu
  (w studach).

- Wartość logiczna wskazująca, czy `worldPoint` znajduje się w granicach
  ekranu.

Zwraca lokalizację ekranu i głębokość `Datatype.Vector3` `worldPoint`
i czy ten punkt znajduje się w granicach ekranu. Nie
uwzględnia wcięcia GUI.

Demonstruje `Class.Camera:ZoomToExtents()`.


Ta metoda dostosowuje `Class.Camera.CFrame|CFrame`, aby określona
ramka ograniczająca była w pełni widoczna w obszarze widoku kamery,
bez przycinania jakiejkolwiek części ramki.

Ramka ograniczająca jest definiowana przez jej środek i orientację
(`boundingBoxCFrame`) oraz jej rozmiar (`boundingBoxSize`).

Można to wykorzystać do skupienia kamery na obiekcie 3D lub modelu, na przykład
przy kadrowaniu treści w `Class.ViewportFrame`, robieniu zrzutów ekranu lub
płynnej zmianie pozycji kamery, aby podkreślić konkretne treści.

Metoda automatycznie uwzględnia kąt widzenia kamery oraz
proporcje obszaru widoku, aby zapewnić, że cała ramka ograniczająca się zmieści.

Camera:ZoomToExtents

boundingBoxCFrame

`Datatype.CFrame` reprezentujący środek i orientację ramki
ograniczającej, która ma się zmieścić w obszarze widoku.

boundingBoxSize

Rozmiar ramki ograniczającej w `Datatype.Vector3`, która ma się
zmieścić w obszarze widoku.

Dostosowuje `Class.Camera.CFrame|CFrame`, aby określona ramka ograniczająca
była w pełni widoczna w widoku kamery.

Camera

Demonstruje `Class.Camera.CameraSubject`.


`CameraSubject` akceptuje różnorodne `Class.Instance|Instances`. Domyślne skrypty
kamery reagują różnie na dostępne ustawienia:

- Domyślnie skrypty kamery śledzą lokalnego bohatera `Class.Humanoid`, uwzględniając
  aktualny stan humanoida i `Class.Humanoid.CameraOffset`.

- Gdy ustawione na `Class.BasePart`, skrypty kamery śledzą jego pozycję,
  z pionowym przesunięciem w przypadku `Class.VehicleSeat|VehicleSeats`.

`CameraSubject` nie może być ustawione na `nil`. Próba ustawienia go na `nil`
spowoduje powrót do poprzedniej wartości.

Aby przywrócić `CameraSubject` do domyślnej wartości, ustaw go na lokalnego
bohatera `Class.Humanoid`:

Camera.CameraSubject

Obiekt `Class.Humanoid` lub `Class.BasePart`, który jest obiektem `Class.Camera`.

Domyślne skrypty kamery Roblox mają kilka wbudowanych zachowań. Ustawienie
tej właściwości przełącza między różnymi zachowaniami `Enum.CameraType`.
Zauważ, że niektóre typy kamer wymagają ważnego
`Class.Camera.CameraSubject|CameraSubject`, aby działać poprawnie.

Domyślne skrypty kamery nie będą poruszać ani aktualizować kamery, jeśli
`CameraType` jest ustawione na `Enum.CameraType.Scriptable`. Aby uzyskać więcej informacji
na temat ręcznego ustawiania pozycji i orientacji kamery, zobacz
`Class.Camera.CFrame|CFrame`.

Dla wszystkich ustawień `CameraType` **oprócz** `Enum.CameraType.Scriptable`,
właściwość `Class.Camera.CameraSubject|CameraSubject` reprezentuje obiekt,
którego pozycja jest ustawiana na `Class.Camera.Focus|Focus` kamery.

Camera.CameraType

Określa `Enum.CameraType`, który będzie odczytywany przez skrypty kamery.

Ta właściwość to `Datatype.CFrame` kamery `Class.Camera`, definiująca jej
pozycję i orientację w 3D świecie. Zauważ, że niektóre transformacje,
jak obrót głowy podczas korzystania z urządzeń VR, nie są odzwierciedlane
w tej właściwości, więc powinieneś użyć
`Class.Camera:GetRenderCFrame()|GetRenderCFrame()`, aby uzyskać "prawdziwe"
`Datatype.CFrame` kamery.

Możesz przesunąć kamerę, ustawiając tę właściwość. Jednak domyślne
skrypty kamery również ją ustawiają, więc powinieneś:

- Ustawić typ kamery `Class.Camera.CameraType|CameraType` na
  `Enum.CameraType.Scriptable`, aby domyślne skrypty kamery nie
  aktualizowały `Datatype.CFrame` kamery. Ta metoda jest najprostsza i
  zalecana w większości przypadków.

- Całkowicie zastąpić domyślne skrypty kamery alternatywami. To
  podejście jest zalecane tylko, jeśli nie potrzebujesz żadnej domyślnej
  funkcjonalności kamery.

Najbardziej intuicyjny sposób na ustawienie pozycji i orientacji `Class.Camera`
jest użycie konstruktora `Datatype.CFrame.lookAt()`. W poniższym
przykładzie `Class.Camera` jest ustawiona na
`Datatype.Vector3.new(0, 10, 0)` i jest skierowana w stronę
`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)
```
Chociaż kamerę można umieścić w sposób pokazany powyżej, możesz chcieć
animować ją, aby płynnie przechodziła z jednego `Datatype.CFrame` do
innego. W tym celu możesz:

- Ustawić pozycję/orientację kamery w każdej klatce za pomocą
  `Class.RunService:BindToRenderStep()` i metody `Datatype.CFrame:Lerp()`.
- Utworzyć i odtworzyć `Class.Tween`, który animuje pozycję/orientację
  kamery:

  
```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 kamery `Class.Camera`, definiujący jej pozycję i
orientację w 3D świecie.

Stara wersja właściwości `Class.Camera.CFrame|CFrame`, która
funkcjonuje identycznie jak ona.

Ten element powinien być używany w `Class.LocalScript`, aby działał zgodnie z
oczekiwaniami w trybie online.

Camera.CoordinateFrame

Ustawia, ile stopni w kierunku przekątnej (od jednego rogu
widoku do przeciwległego rogu) kamera może widzieć. Zobacz
`Class.Camera.FieldOfView|FieldOfView`, aby uzyskać bardziej ogólne wyjaśnienie
pola widzenia.

Zauważ, że `DiagonalFieldOfView` reprezentuje pole widzenia, które jest
widoczne przez kamerę `Class.Camera`, renderując w obszarze pełnoekranowym,
który może być zasłonięty przez wcięcia lub wycięcia ekranu na niektórych urządzeniach. Zobacz
`Class.Camera.ViewportSize|ViewportSize`, aby uzyskać więcej informacji.

Camera.DiagonalFieldOfView

Ustawia kąt przekątnej pola widzenia kamery.

Właściwość `FieldOfView` (FOV) ustawia, ile stopni w kierunku pionowym
kamera może widzieć. Ta właściwość jest ograniczona między `1` a
`120` stopni i domyślnie wynosi `70`. Bardzo niskie lub bardzo wysokie pola widzenia
nie są zalecane, ponieważ mogą powodować dezorientację u graczy.

Zauważ, że wymuszane jest jednolite skalowanie, co oznacza, że pionowe i poziome
pole widzenia zawsze są związane z proporcją ekranu.

Zalecane zastosowania dla `FieldOfView` obejmują:

- Zmniejszenie FOV, aby dać wrażenie powiększenia, na przykład podczas
  korzystania z lornetek.
- Zwiększenie FOV, gdy gracz "biegnie", aby dać wrażenie
  braku kontroli.

Zauważ, że `FieldOfView` reprezentuje pole widzenia, które jest widoczne przez
kamerę `Class.Camera`, renderując w obszarze pełnoekranowym, które może być
zasłonięte przez wcięcia lub wycięcia ekranu na niektórych urządzeniach. Zobacz
`Class.Camera.ViewportSize|ViewportSize`, aby uzyskać więcej informacji.

Camera.FieldOfView

Ustawia kąt pionowego pola widzenia kamery.

Właściwość `Class.Camera.FieldOfView|FieldOfView` (FOV) musi być aktualizowana,
aby odzwierciedlać zmiany `Class.Camera.ViewportSize|ViewportSize`. Wartość
`FieldOfViewMode` określa, która wartość FOV będzie utrzymywana w stałej
wartości.

Na przykład, gdy ta właściwość jest ustawiona na `Enum.FieldOfViewMode.Vertical`,
horyzontalne FOV jest aktualizowane, gdy rozmiar widoku jest zmieniany, ale
pionowe FOV pozostaje stałe. Jeśli ta właściwość jest ustawiona na
`Enum.FieldOfViewMode.Diagonal`, zarówno horyzontalne, jak i pionowe FOV mogą być
zmieniane, aby utrzymać stałe przekątne FOV.

Camera.FieldOfViewMode

Określa wartość FOV kamery `Class.Camera`, która jest niezmienna przy
zmianach rozmiaru widoku.

Niektóre operacje graficzne, które wykonuje silnik, takie jak aktualizacja
oswietlenia, mogą wymagać czasu lub wysiłku obliczeniowego, aby się zakończyć. Właściwość
`Focus` kamery informuje silnik, który obszar w przestrzeni 3D należy
priorytetowo traktować podczas wykonywania takich operacji. Na przykład, dynamiczne
oswietlenie z obiektów takich jak `Class.PointLight|PointLights` może nie renderować
się na dużych odległościach od punktu skupienia.

Domyślne skrypty kamery Roblox automatycznie ustawiają `Focus`, aby śledzić
`Class.Camera.CameraSubject|CameraSubject` (zwykle `Class.Humanoid`).
Jednak `Focus` **nie** będzie automatycznie aktualizowane, gdy
`Class.Camera.CameraType|CameraType` jest ustawione na
`Enum.CameraType.Scriptable` lub gdy domyślne skrypty kamery nie są
używane. W takich przypadkach powinieneś aktualizować `Focus` w każdej klatce,
korzystając z metody `Class.RunService:BindToRenderStep()` z priorytetem
`Enum.RenderPriority.Camera`.

`Focus` nie ma wpływu na pozycję ani orientację kamery; zobacz
`Class.Camera.CFrame|CFrame` w tej kwestii.

Camera.Focus

Ustawia obszar w przestrzeni 3D, który jest priorytetowy dla graficznych
systemów Roblox.

Camera.focus

Przełącza, czy kamera automatycznie będzie śledzić ruch głowy gracza
korzystającego z urządzenia VR. Gdy `true` (domyślnie), silnik łączy
`Class.Camera.CFrame|CFrame` z `Enum.UserCFrame` głowy użytkownika,
aby renderować widok gracza z uwzględnieniem śledzenia głowy. Widok będzie
renderowany w następującym `Datatype.CFrame`:

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

local camera = workspace.CurrentCamera

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

-- To będzie równoważne Camera:GetRenderCFrame()
local renderCFrame = camera.CFrame * headCFrame
```
Zaleca się **nie** wyłączać tej właściwości z następujących powodów:

- Gracze mogą doświadczyć choroby lokomocyjnej, jeśli nie zostanie dodane
  odpowiednie rozwiązanie do śledzenia głowy.
- Silnik Roblox wykonuje optymalizacje opóźnienia, gdy `HeadLocked` jest
  ustawione na true.

##### Zobacz także

- `Class.VRService:GetUserCFrame()`, które można wykorzystać do uzyskania
  `Datatype.CFrame` głowy.
- `Class.VRService:RecenterUserHeadCFrame()`, które służy do
  wyśrodkowania głowy na aktualnej pozycji i orientacji urządzenia VR.
- Metoda `Class.Camera:GetRenderCFrame()|GetRenderCFrame()`, która
  zwraca `Class.Camera.CFrame|CFrame` połączone z
  `Datatype.CFrame` głowy użytkownika.

Camera.HeadLocked

Przełącza, czy kamera automatycznie będzie śledzić ruch głowy gracza
korzystającego z urządzenia VR.

`HeadScale` to skala perspektywy użytkownika w świecie podczas korzystania
z VR.

Rozmiar 1 studa w VR to `0.3 metra / HeadScale`, co oznacza, że większe
wartości `HeadScale` sprawiają, że świat wygląda na mniejszy z perspektywy
użytkownika podczas korzystania z urządzeń VR. Na przykład, część, która ma 1
stud wysokości, wydaje się mieć 0.6 metra wysokości dla gracza VR z `HeadScale`
wynoszącym `0.5`.

Ta właściwość jest automatycznie kontrolowana przez
`Class.VRService.AutomaticScaling`, aby dostosować perspektywę gracza do
rozmiaru jego awatara. Jeśli zamierzasz kontrolować `HeadScale` samodzielnie lub
używać niestandardowych postaci, przełącz `Class.VRService.AutomaticScaling` na
`Enum.VRScaling.Off`.

Ta właściwość nie powinna być mylona z `Class.Humanoid.HeadScale`, która
jest `Class.NumberValue` powiązaną z `Class.Humanoid`, aby kontrolować jego
skalowanie.

Camera.HeadScale

Ustawia skalę perspektywy użytkownika w świecie podczas korzystania z VR.

Właściwość `MaxAxisFieldOfView` ustawia, ile stopni wzdłuż najdłuższej
osi widoku kamera może widzieć.

Gdy najdłuższa oś to oś pionowa, ta właściwość będzie działać
podobnie do właściwości `Class.Camera.FieldOfView|FieldOfView`. Zwykle jest
tak, gdy urządzenie jest w orientacji portretowej. W orientacji poziomej,
najdłuższa oś będzie osią poziomą; w tym przypadku właściwość opisuje
poziome pole widzenia `Class.Camera`.

Camera.MaxAxisFieldOfView

Ustawia kąt pola widzenia kamery wzdłuż najdłuższej osi widoku.

Właściwość `NearPlaneZ` opisuje, jak daleko znajduje się płaszczyzna
przycinania bliskiego kamery, w studach. Płaszczyzna przycinania bliskiego
jest płaszczyzną geometryczną, która znajduje się przed `Class.Camera.CFrame|CFrame` kamery.
Cokolwiek znajduje się między tą płaszczyzną a kamerą nie będzie renderowane,
co tworzy widok wycięcia podczas oglądania obiektów z bardzo małych odległości. Wartość
`NearPlaneZ` różni się w zależności od platformy i obecnie zawsze mieści się
między `-0.1` a `-0.5`.

<img src="/assets/engine-api/classes/Camera/NearPlaneZ.jpg" width="720" alt="Diagram pokazujący, jak NearPlaneZ przycina (nie renderuje) treści 3D między płaszczyzną a kamerą." />

Camera.NearPlaneZ

Opisuje negatywny offset **Z** płaszczyzny przycinania bliskiego kamery.

Określa, który aspekt `Class.Camera.ViewportSize|ViewportSize` jest
kontrolowany przez `Class.Camera.OrthographicSize|OrthographicSize`.

Na przykład, gdy ta właściwość jest ustawiona na
`Enum.OrthographicMode.Vertical`, projekcja ortograficzna jest skalowana
w taki sposób, że wymiar pionowy zajmuje dokładnie
`Class.Camera.OrthographicSize|OrthographicSize` studów, a wymiar poziomy
zajmuje tyle studów, ile jest potrzebne, aby dopasować.

Camera.OrthographicMode

Ustala, na którą oś ekranu `Class.Camera.OrthographicSize|OrthographicSize` jest
zastosowane.

`Class.Camera.OrthographicMode|OrthographicMode` wybiera wymiar
widoku, który chcesz kontrolować.
`Class.Camera.OrthographicSize|OrthographicSize` ustala zasięg w studach
zajmowany przez ten wymiar widoku.

Na przykład, jeśli `Class.Camera.OrthographicMode|OrthographicMode` jest ustawione na
`Enum.OrthographicMode.MaxAxis`, to większy wymiar widoku
będzie zajmował `Class.Camera.OrthographicSize|OrthographicSize` studów.

Camera.OrthographicSize

Ustala zasięg w studach wymiaru wybranego przez
`Class.Camera.OrthographicMode|OrthographicMode`.

Ustaw na `Enum.ProjectionType.Perspective` (domyślnie), aby użyć kamery
perspektywicznej, w której równoległe linie w 3D zbiegają się na ekranie,
a obiekty stają się mniejsze w oddali. Ustaw na `Enum.ProjectionType.Orthographic`, aby użyć
kamery ortograficznej, w której równoległe linie pozostają równoległe, a obiekty mają
taką samą wielkość na każdą odległość. Jest to przydatne w przypadku gier 2D,
gier izometrycznych i minimap.

Camera.ProjectionType

Wybiera między kamerami perspektywicznymi a ortograficznymi.

`ViewportSize` zwraca wymiary bezpiecznego obszaru urządzenia na
bieżącym ekranie. Ten obszar to prostokąt, który obejmuje górny pasek
Roblox, ale nie obejmuje żadnych wcięć urządzenia ani wycięć ekranu. Jednostki
`ViewportSize` to jednostki przesunięcia UI Roblox, które mogą różnić się od
pikseli wyświetlacza.

<img src="../../../assets/engine-api/classes/Camera/DeviceSafeAreaVsFullscreen.png" width="840" alt="Ekran urządzenia mobilnego z wycięciem pokazującym bezpieczny obszar urządzenia." />

Jak wspomniano powyżej, `ViewportSize` nie jest równe rozmiarowi obszaru pełnoekranowego na
displayach z wycięciami lub wcięciami. Aby uzyskać rozmiar obszaru pełnoekranowego na
wszystkich wyświetlaczach, możesz zapytać o
`Class.ScreenGui.AbsoluteSize|AbsoluteSize` właściwość `Class.ScreenGui` z `Class.ScreenGui.ScreenInsets|ScreenInsets` ustawionym na
`Enum.ScreenInsets.None|None`. Zobacz `Enum.ScreenInsets`, aby uzyskać więcej
informacji na temat tego, jak definiowane są obszary ekranu.

Na koniec, zauważ, że `ViewportSize` nie jest rzeczywistym rozmiarem widoku, który
kamera używa do renderowania (kamera renderuje w obszarze pełnoekranowym).
Również właściwości `Class.Camera.FieldOfView|FieldOfView` i
`Class.Camera.DiagonalFieldOfView|DiagonalFieldOfView` są
oparte na obszarze pełnoekranowym, a nie na `ViewportSize`.

##### Aktualizacje kamery

Tylko `Class.Camera`, do którego obecnie odnosi się
`Class.Workspace.CurrentCamera`, ma swoje `ViewportSize` aktualizowane w każdej klatce
podczas kroku `Class.RunService.PreRender|PreRender`. `ViewportSize`
wszystkich innych kamer w twoim doświadczeniu nie będzie aktualizowane, w tym tych
używanych do `Class.ViewportFrame|ViewportFrames`.

Camera.ViewportSize

Wymiary bezpiecznego obszaru urządzenia na kliencie Roblox.

Kąt widzenia i rozmiar ortograficzny są określone dla jednej osi
widoku, albo poziomej, albo pionowej. Zwykle druga oś
automatycznie dostosowuje się, aby utrzymać piksele w kwadracie. To pozwala na rozciągnięcie
innej osi, aby piksele nie były kwadratowe, w stosunku do 2:1.
Można to animować, aby sprawić, że widok będzie wydawał się nieco niewłaściwy, na przykład gdy
jest się oszołomionym.

Działa to zarówno dla kamer ortograficznych, jak i perspektywicznych.

Camera.ViewStretch

Rozciąga oś widoku, która nie jest przypięta przez aktualny
`Class.Camera.FieldOfViewMode|FieldOfViewMode` lub
`Class.Camera.OrthographicMode|OrthographicMode`.

Ta właściwość przełącza, czy stosować przechylenie i obrót z
`Class.Camera.CFrame|CFrame` podczas korzystania przez gracza z urządzenia VR.

Aby zapobiec chorobie lokomocyjnej, horyzont powinien pozostać na poziomie. Przechylanie i
obracanie widoku gracza podczas korzystania z urządzenia VR może powodować rozłączenie
między fizyczną przestrzenią gracza a wirtualną przestrzenią, którą obserwuje. Zmiana
widocznego kierunku w dół może spowodować, że gracze stracą równowagę lub doświadczą zawrotów głowy.

Z tych powodów ogólnie zaleca się pozostawienie tej właściwości
disabled, chyba że dokładnie przetestowałeś swoje doświadczenie pod kątem tych
efektów. Nawet przy włączonym przechyleniu i obrocie, możesz chcieć upewnić się, że
gracz zawsze ma stabilny punkt odniesienia, taki jak wnętrze
pojazdu lub podłoga, która może pomóc graczowi ugruntować się w swojej
fizycznej przestrzeni.

Camera.VRTiltAndRollEnabled

Przełącza, czy stosować przechylenie i obrót z
`Class.Camera.CFrame|CFrame` podczas korzystania przez gracza z urządzenia VR.

Klasa, która definiuje widok 3D świata.

`Class.PVInstance` to klasa abstrakcyjna, która nie może być tworzona. Jest to
podstawa dla wszystkich obiektów, które mają fizyczną lokalizację w świecie.

Ten przykład kodu to prosty skrypt teleportujący, który przemieszcza twoją postać
10&nbsp;studów do przodu w kierunku, w którym aktualnie patrzysz, gdy naciśniesz
tuż <kbd>F</kbd>. Działa to poprzez uzyskanie bieżącego pivotu za pomocą
`Class.PVInstance:GetPivot()` i wywołanie `PVInstance|PivotTo`, aby przesunąć
postać do przodu.

Ta funkcja pobiera pivot `Class.PVInstance`. Często używa się jej
wraz z `Class.PVInstance:PivotTo()`, aby przesunąć model.

`Class.Model|Models` oraz `Class.BasePart|BaseParts` to oba
`Class.PVInstance|PVInstances` ("Przypadki Prędkości Pozycji") i zatem oba
posiadają tę funkcję.

PVInstance:GetPivot

Światowy `Datatype.CFrame` pivotu instancji.


Przesuwa `Class.PVInstance` wraz ze wszystkimi jego dziedzicznymi
`Class.PVInstance|PVInstances`, tak aby pivot znajdował się teraz w
określonym `Datatype.CFrame`. Jest to podstawowa funkcja, która powinna być
używana do przesuwania `Class.Model|Models` za pomocą skryptów.

`Class.BasePart|BaseParts` są przesuwane w ten sposób, poprzez przekształcenie ich
`Datatype.CFrame` za pomocą niezbędnego przesunięcia.
`Class.Model|Models` są przesuwane w ten sposób, ponieważ ich
`Class.Model.WorldPivot` jest przekształcany za pomocą niezbędnego przesunięcia.

Zauważ, że dla celów wydajnościowych, zdarzenia `Class.Object.Changed` nie są
wyzwalane dla `Class.BasePart.Position|Position` i
`Class.BasePart.Orientation|Orientation` `Class.BasePart|BaseParts`
przesuwanych w ten sposób; są one wyzwalane tylko dla `Datatype.CFrame`.

Podczas wywoływania `Class.PVInstance:PivotTo()|PivotTo` na `Class.Model|Models`,
przesunięcia części dziedzicznych i modeli są buforowane, w ten sposób
kolejne wywołania `Class.PVInstance:PivotTo()|PivotTo` na tym samym modelu
nie gromadzą dryfu zmiennoprzecinkowego między częściami, które składają się na
model.

`Class.Model|Models` oraz `Class.BasePart|BaseParts` to oba
`Class.PVInstance|PVInstances` ("Przypadki Prędkości Pozycji") i zatem oba
posiadają tę funkcję.

PVInstance:PivotTo

targetCFrame

`Datatype.CFrame`, który powinien odpowiadać pivotowi `Class.PVInstance`
potem, gdy zostanie przesunięty.

Przesuwa `Class.PVInstance` wraz ze wszystkimi jego dziedzicznymi
`Class.PVInstance|PVInstances`, tak aby pivot znajdował się teraz w
określonym `Datatype.CFrame`.

PVInstance

Właściwość tylko dla edytora, wyświetlana w oknie właściwości Studio jako **Pozycja Początkowa** i **Orientacja Początkowa** w sekcji **Transformacja**. Jej wartość to światowy `Datatype.CFrame` pivotu instancji; odczytanie jej zwraca ten sam `Datatype.CFrame` co `Class.PVInstance:GetPivot()`. Nie ma własnej przechowywanej wartości i zawsze odzwierciedla aktualny pivot.

Ustawienie jej z okna właściwości przesuwa całą instancję, aby jej pivot znajdował się w nowym `Datatype.CFrame`, podobnie jak `Class.PVInstance:PivotTo()`. Edytowanie przez okno właściwości tymczasowo wyłącza `Class.WeldConstraint|WeldConstraints` do innych obiektów na czas przesunięcia; `PivotTo` nie modyfikuje stawów.

Niedostępne dla skryptów; użyj `Class.PVInstance:GetPivot()` i `Class.PVInstance:PivotTo()` w czasie wykonywania zamiast tego.


PVInstance.Origin

Właściwość tylko dla edytora, która odczytuje i ustawia światowy `Datatype.CFrame` pivotu `Class.PVInstance`, przesuwając całą instancję, gdy zmienia się z okna właściwości Studio.


Właściwość tylko dla edytora, wyświetlana w oknie właściwości Studio jako **Pozycja Pivotu** i **Orientacja Pivotu** w sekcji **Pivot**. Jest to `Datatype.CFrame` pivotu w odniesieniu do własnej ramki instancji.

Zmiana jej z okna właściwości przesuwa pivot w odniesieniu do instancji, pozostawiając instancję na miejscu, w przeciwieństwie do `Origin`, który przesuwa całą instancję. Dla `Class.BasePart` przesunięcie domyślnie wynosi tożsamościowy `Datatype.CFrame`, więc pivot pokrywa się z centrum części. Dla `Class.Model` ta właściwość pojawia się tylko wtedy, gdy model ma `Class.Model.PrimaryPart|PrimaryPart`; wtedy odzwierciedla i edytuje `Class.BasePart.PivotOffset|PivotOffset` tej części, a `Class.Model:GetPivot()` jest aliasem pivotu części głównej.

Niedostępne dla skryptów; skrypty odczytują i zapisują równoważne przez konkretną klasę, taką jak `Class.BasePart.PivotOffset`.


PVInstance.Pivot Offset

Właściwość tylko dla edytora, która wyświetla i edytuje `Datatype.CFrame` pivotu w odniesieniu do instancji, przesuwając tylko pivot i pozostawiając instancję na miejscu.


Abstrakcyjna klasa dla wszystkich obiektów, które mają fizyczną lokalizację w świecie.

`Instance` jest klasą bazową dla wszystkich klas w hierarchii klas Roblox
które mogą być częścią drzewa `Class.DataModel`.

Nie jest możliwe bezpośrednie tworzenie obiektów `Instance` jako korzeni, ale specjalny
konstruktor `Datatype.Instance.new()` tworzy obiekty za pomocą kodu, przyjmując
nazwę klasy jako parametr i zwracając utworzony obiekt.


Demonstruje wykrywanie zmian w przodkach instancji przez podłączenie do
`Class.Instance.AncestryChanged` event.

Rodzic ChangingPart jest ustawiany na różne wartości w czasie. Rodzicem
tej części jest przodek części, więc event `Class.Instance.AncestryChanged`
wyzwoli się za każdym razem, gdy się zmieni.

Wywołuje się, gdy ta instancja jest przenoszona lub gdy którykolwiek z jej przodków jest przenoszony.

Możesz użyć tego zdarzenia, aby śledzić usunięcie instancji w Studio, na przykład ręczne usunięcie w Eksploratorze lub za pomocą wtyczki. Jeśli musisz wykryć, kiedy instancja jest niszczona za pomocą `Class.Instance:Destroy()`, użyj zdarzenia `Class.Instance.Destroying` zamiast tego.


Instance.AncestryChanged

child

Instancja, której właściwość `Class.Instance.Parent|Parent` została zmieniona, która może być tą instancją lub bardziej odległym przodkiem, **nie**koniecznie instancją, do której podłączony jest handler.


parent

Wywołuje się, gdy właściwość `Class.Instance.Parent` tego obiektu lub jednego z jego przodków zostaje zmieniona.


To zdarzenie wywołuje się, gdy jakikolwiek atrybut jest zmieniany na instancji, w tym gdy atrybut jest ustawiany na `nil`. Nazwa zmienionego atrybutu jest przekazywana do podłączonej funkcji.

Na przykład, poniższy fragment kodu łączy funkcję `attributeChanged()` do wywołania, gdy zmienia się jeden z atrybutów części:

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

local part = Workspace.Part

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

part.AttributeChanged:Connect(attributeChanged)
```
Zobacz także `Class.Instance:GetAttributeChangedSignal()`, które zwraca zdarzenie, które wywołuje się, gdy zmienia się dany atrybut.


Instance.AttributeChanged

attribute

Nazwa atrybutu, który został zmieniony.


Wywołuje się, gdy atrybut jest zmieniany na `Class.Instance`.


Ten fragment kodu wypisuje nazwy obiektów, które są dodawane do Workspace:

Wywołuje się po dodaniu obiektu do tego `Class.Instance`.

Uwaga, podczas używania tej metody na kliencie do wykrywania obiektów tworzonych przez serwer, konieczne jest użycie `Class.Instance:WaitForChild()`, gdy indeksujesz potomków tych obiektów. Dzieje się tak, ponieważ obiekt i jego potomkowie nie są gwarantowani do replikacji z serwera do klienta jednocześnie. Na przykład:

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

Workspace.ChildAdded:Connect(function(child)
	-- Użyj WaitForChild(), ponieważ potomkowie mogą jeszcze nie zostać zreplikowani
	local head = child:WaitForChild("Head")
end)
```
Uwaga, to zdarzenie działa tylko dla bezpośrednich dzieci `Class.Instance`. Aby uzyskać zdarzenie, które uchwyci wszystkie potomków, użyj `Class.Instance.DescendantAdded`.

Zobacz także `Class.Instance.ChildRemoved`.


Instance.ChildAdded

Instancja `Class.Instance`, która została dodana.


Wywołuje się po dodaniu obiektu do tego `Class.Instance`.


Instance.childAdded

Ten fragment kodu drukuje nazwy obiektów, gdy są one usuwane z
Workspace:

Wywołuje się po usunięciu dziecka z tego `Class.Instance`.

Usunięcie odnosi się do sytuacji, gdy rodzic obiektu zmienia się z tego `Class.Instance` na coś innego niż ten `Class.Instance`. Uwaga, to zdarzenie również wywoła się, gdy dziecko zostanie zniszczone (używając `Class.Instance:Destroy()`), ponieważ funkcja zniszczenia ustawia rodzica obiektu na `nil`.

To zdarzenie działa tylko dla bezpośrednich dzieci `Class.Instance`. Aby uzyskać zdarzenie, które uchwyci wszystkich potomków, użyj `Class.Instance.DescendantRemoving`.

Zobacz także `Class.Instance.ChildAdded`.


Instance.ChildRemoved

Instancja `Class.Instance`, która została usunięta.


Wywołuje się po usunięciu dziecka z tego `Class.Instance`.


Ten przykład wydrukuje nazwę obiektu, który zostanie dodany do
Workspace:

To zdarzenie wywołuje się po dodaniu potomka do `Class.Instance`.

Ponieważ wywołuje się dla każdego potomka, dodanie obiektu do `Class.Instance` wywoła zdarzenie dla tego obiektu i wszystkich jego potomków indywidualnie.

Jeśli interesują cię tylko **bezpośrednie dzieci** `Class.Instance`, użyj `Class.Instance.ChildAdded` zamiast tego.

Zobacz także `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

descendant

Wywołuje się po dodaniu potomka do `Class.Instance`.


Poniższy przykład wypisuje nazwę każdego potomka w momencie, gdy jest usuwany
z Workspace:

To zdarzenie wywołuje się **natychmiast przed** zmianą rodzica `Class.Instance`, tak że instancja **potomka** nie będzie już potomkiem. `Class.Instance:Destroy()|Destroy()` zmienia `Class.Instance.Parent|Parent` instancji na `nil`, więc wywołanie tej metody na potomku rodzica spowoduje wywołanie tego zdarzenia.

Ponieważ to zdarzenie wywołuje się **przed** usunięciem potomka, rodzic potomka pozostanie niezmieniony w momencie wywołania tego zdarzenia. Jeśli potomek jest również **bezpośrednim dzieckiem** rodzica, to zdarzenie wywoła się przed `Class.Instance.ChildRemoved`.

Jeśli potomek ma dzieci, to zdarzenie wywoła się najpierw dla potomka, a następnie dla jego potomków.

#### Ostrzeżenie

To zdarzenie wywołuje się z obiektem potomka, który jest usuwany. Próba ustawienia `Class.Instance.Parent|Parent` potomka na coś innego zakończy się niepowodzeniem. Poniżej znajduje się przykład, który to demonstruje:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Nie manipuluj rodzicem potomka w tej funkcji!
	-- To zdarzenie wywołuje się, ponieważ rodzic został zmieniony, a zmiana jeszcze się nie wydarzyła
	-- Dlatego problematyczne jest zmienianie rodzica w ten sposób:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Zobacz także `Class.Instance.DescendantAdded|DescendantAdded`.


Instance.DescendantRemoving

Wywołuje się natychmiast przed usunięciem potomka `Class.Instance`.


Instance

`Instance` jest klasą bazową dla wszystkich klas w hierarchii klas Roblox
które mogą być częścią drzewa `Class.DataModel`.


/reference/engine/classes/ViewportCamera.yaml

Podsumowanie