actualization butch two

Author: AGulev

docs/pl/manuals/camera.md

@@ -1,74 +1,159 @@
 ---
-title: Kształty Kolizji
-brief: Ta instrukcja opisuje szczegóły działania kształtów kolizji silnika fizyki.
+title: Kształty kolizji
+brief: Komponent obiektu kolizji może używać kilku kształtów podstawowych albo jednego kształtu złożonego.
 ---
 
-# Kształty Kolizji
+# Kształty kolizji
 
-Komponent Obiektu Kolizji (Collision Object) może używać kilku kształtów podstawowych (ang. primitive shapes) lub pojedynczego kształtu złożonego.
+Komponent obiektu kolizji może używać kilku kształtów podstawowych albo jednego kształtu złożonego.
 
 ### Kształty podstawowe
 
-Podstawowe kształty to *box* - prostokąt, *sphere* - sfera i *capsule* - kapsuła. Aby dodać kształt podstawowy, <kbd>kliknij prawym przyciskiem myszy</kbd> obiekt kolizji, a następnie wybierz <kbd>Add Shape</kbd>:
+Kształty podstawowe to *box*, *sphere* i *capsule*. Aby dodać kształt podstawowy, <kbd>kliknij prawym przyciskiem myszy</kbd> obiekt kolizji i wybierz <kbd>Add Shape</kbd>:
 
 ![Add a primitive shape](images/physics/add_shape.png)
 
-## Kształt prostokątny
-Kształt prostokątny (box) posiada pozycję, rotację i wymiary (szerokość, wysokość i głębokość):
+## Kształt prostokątny (box)
 
-![Kształt prostokątny](images/physics/box.png)
+Kształt prostokątny (box) ma pozycję, obrót i wymiary: szerokość, wysokość oraz głębokość:
 
-## Kształt sfery
-Sfera (sphere) posiada pozycję, rotację i średnicę:
+![Box shape](images/physics/box.png)
 
-![Kształt sfery](images/physics/sphere.png)
+## Kształt sfery (sphere)
 
-## Kształt kapsuły
-Kapsuła posiada pozycję, rotację, średnicę i wysokość:
+Kształt sfery (sphere) ma pozycję, obrót i średnicę:
 
-![Kształt kapsuły](images/physics/capsule.png)
+![Sphere shape](images/physics/sphere.png)
+
+## Kształt kapsuły (capsule)
+
+Kształt kapsuły (capsule) ma pozycję, obrót, średnicę i wysokość:
+
+![Sphere shape](images/physics/capsule.png)
 
 ::: important
-Kształty kapsuły są obsługiwane tylko w przypadku korzystania z fizyki 3D (skonfigurowanej w sekcji *Physics* w pliku *game.project*).
+Kształty capsule są obsługiwane tylko przy korzystaniu z fizyki 3D, skonfigurowanej w sekcji *Physics* pliku *game.project*.
 :::
 
 ### Kształty złożone
-Kształty złożone (ang. complex shapes) można utworzyć z komponentu mapy kafelków lub z kształtu wypukłego (convex hull shape).
 
-## Kształt kolizji mapy kafelków
-Defold zawiera funkcję, która umożliwia łatwe generowanie kształtów fizyki dla Źródła Kafelków (Tile Source) używanego przez mapę kafelków. W [instrukcji Źródła Kafelków](/manuals/tilesource/#tile-source-collision-shapes) wyjaśniono, jak dodać grupy kolizji do źródła kafelków i przypisać kafelki do grup kolizji ([przykład](/examples/tilemap/collisions/)).
+Kształt złożony można utworzyć albo z komponentu Tile map (mapy kafelków), albo z kształtu convex hull.
+
+## Kształt kolizji Tile map
 
-Aby dodać kolizję do mapy kafelków:
+Defold zawiera funkcję, która pozwala łatwo generować kształty fizyki dla Tile source używanego przez Tile map. W [instrukcji Tile source](/manuals/tilesource/#tile-source-collision-shapes) wyjaśniono, jak dodawać grupy kolizji do Tile source i przypisywać kafelki do grup kolizji ([przykład](/examples/tilemap/collisions/)).
 
-1. Dodaj mapę kafelków do obiektu gry, <kbd>klikając go prawym przyciskiem myszy</kbd> i wybierając <kbd>Add Component File</kbd>. Wybierz plik mapy kafelków.
-2. Dodaj komponent obiektu kolizji do obiektu gry, <kbd>klikając go prawym przyciskiem myszy</kbd> i wybierając <kbd>Add Component ▸ Collision Object</kbd>.
-3. Zamiast dodawać kształty do komponentu, ustaw właściwość Kształt kolizji na plik mapa kafelków (*tilemap*).
-4. Skonfiguruj *Properties* komponentu obiektu kolizji.
+Aby dodać kolizję do Tile map:
 
-![Kształt kolizji mapy kafelków](images/physics/collision_tilemap.png)
+1. Dodaj Tile map do obiektu gry, <kbd>klikając prawym przyciskiem myszy</kbd> obiekt gry i wybierając <kbd>Add Component File</kbd>. Następnie wybierz plik Tile map.
+2. Dodaj komponent obiektu kolizji do obiektu gry, <kbd>klikając prawym przyciskiem myszy</kbd> obiekt gry i wybierając <kbd>Add Component ▸ Collision Object</kbd>.
+3. Zamiast dodawać kształty do komponentu, ustaw właściwość *Collision Shape* na plik *tilemap*.
+4. Skonfiguruj *Properties* komponentu obiektu kolizji jak zwykle.
+
+![Tilesource collision](images/physics/collision_tilemap.png)
 
 ::: important
-Należy zauważyć, że właściwość *Group* **nie** jest tutaj używana, ponieważ grupy kolizji są definiowane w źródle kafelków (tile source) mapy kafelków.
+Zwróć uwagę, że właściwość *Group* **nie** jest tutaj używana, ponieważ grupy kolizji są definiowane w Tile source mapy kafelków.
 :::
 
-## Kształt kolizji wypukłej
-Defold zawiera funkcję, która umożliwia tworzenie kształtu wypukłego (convex hull shape) z trzech lub więcej punktów. Możesz użyć zewnętrznego narzędzia, takiego jak [Defold Polygon Editor](/assets/defoldpolygoneditor/) lub [Physics Body Editor](https://selimanac.github.io/physics-body-editor/), aby utworzyć kształt wypukły.
+## Kształt wypukły (convex hull)
 
-1. Utwórz plik kształtu wypukłego (o rozszerzeniu pliku .`.convexshape`) za pomocą zewnętrznego edytora.
-2. Zamiast dodawać kształty do komponentu obiektu kolizji, ustaw właściwość *Collision Shape* na plik *convex shape*.
+Defold zawiera funkcję pozwalającą tworzyć kształt wypukły (convex hull) z trzech lub większej liczby punktów.
+
+1. Utwórz plik kształtu convex hull o rozszerzeniu `.convexshape` przy użyciu zewnętrznego edytora.
+2. Edytuj plik ręcznie w edytorze tekstu albo przy użyciu zewnętrznego narzędzia, opisanego poniżej.
+3. Zamiast dodawać kształty do komponentu obiektu kolizji, ustaw właściwość *Collision Shape* na plik *convex shape*.
+
+### Format pliku
+
+Format pliku convex hull używa tego samego formatu danych co pozostałe pliki Defold, czyli tekstowego formatu protobuf. Kształt convex hull definiuje punkty bryły. W fizyce 2D punkty powinny być podane w kolejności przeciwnej do ruchu wskazówek zegara. W trybie fizyki 3D używana jest abstrakcyjna chmura punktów. Przykład dla 2D:
+
+```
+shape_type: TYPE_HULL
+data: 200.000
+data: 100.000
+data: 0.0
+data: 400.000
+data: 100.000
+data: 0.0
+data: 400.000
+data: 300.000
+data: 0.0
+data: 200.000
+data: 300.000
+data: 0.0
+```
+
+Powyższy przykład definiuje cztery narożniki prostokąta:
+
+```
+ 200x300   400x300
+    4---------3
+    |         |
+    |         |
+    |         |
+    |         |
+    1---------2
+ 200x100   400x100
+```
+
+## Narzędzia zewnętrzne
+
+Istnieje kilka narzędzi zewnętrznych, których można użyć do tworzenia kształtów kolizji:
+
+* [Physics Editor](https://www.codeandweb.com/physicseditor/tutorials/how-to-create-physics-shapes-for-defold) od CodeAndWeb pozwala tworzyć obiekty gry ze sprite’ami i pasującymi do nich kształtami kolizji.
+* [Defold Polygon Editor](https://rossgrams.itch.io/defold-polygon-editor) można użyć do tworzenia kształtów convex hull.
+* [Physics Body Editor](https://selimanac.github.io/physics-body-editor/) również można użyć do tworzenia kształtów convex hull.
 
-::: sidenote
-Kształt taki nie będzie rysowany w Edytorze. Możesz włączyć [debugowanie fizyki](/manuals/debugging/#debugging-problems-with-physics) podczas działania programu, aby zobaczyć kształt.
-:::
 
 # Skalowanie kształtów kolizji
 
-Obiekt kolizji i jego kształty dziedziczą skalę obiektu gry. Aby wyłączyć to zachowanie, odznacz pole wyboru "[Allow Dynamic Transforms](/manuals/project-settings/#allow-dynamic-transforms)", czyli Zezwalaj na dynamiczne transformacje w sekcji *Physics* pliku *game.project*. Należy pamiętać, że obsługiwane jest tylko skalowanie jednolite (uniform), a jeśli skala nie jest jednolita, zostanie użyta najmniejsza wartość skali.
+Obiekt kolizji i jego kształty dziedziczą skalę obiektu gry. Aby wyłączyć to zachowanie, odznacz pole [Allow Dynamic Transforms](/manuals/project-settings/#allow-dynamic-transforms) w sekcji *Physics* pliku *game.project*. Zwróć uwagę, że obsługiwane jest tylko skalowanie jednolite, a jeśli skala nie jest jednolita, użyta zostanie najmniejsza wartość skali.
+
+# Zmienianie rozmiaru kształtów kolizji
+
+Rozmiar kształtów obiektu kolizji można zmieniać w czasie działania przy użyciu `physics.set_shape()`. Przykład:
+
+```lua
+-- ustaw dane kształtu capsule
+local capsule_data = {
+  type = physics.SHAPE_TYPE_CAPSULE,
+  diameter = 10,
+  height = 20,
+}
+physics.set_shape("#collisionobject", "my_capsule_shape", capsule_data)
+
+-- ustaw dane kształtu sphere
+local sphere_data = {
+  type = physics.SHAPE_TYPE_SPHERE,
+  diameter = 10,
+}
+physics.set_shape("#collisionobject", "my_sphere_shape", sphere_data)
+
+-- ustaw dane kształtu box
+local box_data = {
+  type = physics.SHAPE_TYPE_BOX,
+  dimensions = vmath.vector3(10, 10, 5),
+}
+physics.set_shape("#collisionobject", "my_box_shape", box_data)
+```
+
+::: sidenote
+Na obiekcie kolizji musi już istnieć kształt właściwego typu o podanym id.
+:::
 
 # Obracanie kształtów kolizji
 
 ## Obracanie kształtów kolizji w fizyce 3D
+
 Kształty kolizji w fizyce 3D można obracać wokół wszystkich osi.
 
+
 ## Obracanie kształtów kolizji w fizyce 2D
-Kształty kolizji w fizyce 2D można obracać tylko wokół osi Z. Obrót wokół osi X lub Y spowoduje nieprawidłowe wyniki i powinno się go unikać, nawet przy obracaniu o 180 stopni, aby efektywnie odwrócić kształt wzdłuż osi x lub y. Aby odwrócić kształt fizyczny, zaleca się korzystanie z [`physics.set_hlip(url, flip)`](/ref/stable/physics/?#physics.set_hflip:url-flip) i [`physics.set_vlip(url, flip)`](/ref/stable/physics/?#physics.set_vflip:url-flip).
+
+Kształty kolizji w fizyce 2D można obracać tylko wokół osi Z. Obracanie wokół osi X albo Y daje nieprawidłowe wyniki i należy go unikać, nawet przy obrocie o 180 stopni, który pozornie miałby tylko odwrócić kształt wzdłuż osi X albo Y. Do odwracania kształtu fizyki zaleca się używać [`physics.set_hlip(url, flip)`](/ref/stable/physics/?#physics.set_hflip:url-flip) oraz [`physics.set_vlip(url, flip)`](/ref/stable/physics/?#physics.set_vflip:url-flip).
+
+
+# Debugowanie
+
+Możesz [włączyć debugowanie fizyki](/manuals/debugging/#debugging-problems-with-physics), aby zobaczyć kształty kolizji w czasie działania.