redacting

Author: AGulev

docs/pl/manuals/compute.md

@@ -80,7 +80,7 @@ Aby użyć programu compute, trzeba go najpierw powiązać z kontekstem renderow
 
 ```lua
 render.set_compute("my_compute")
--- Do compute work here, call render.set_compute() to unbind
+-- Tutaj wykonuj obliczenia compute; wywołaj render.set_compute(), aby odwiązać program
 render.set_compute()
 ```
 
@@ -95,8 +95,8 @@ Aby uruchomić program w ustalonej przez siebie przestrzeni roboczej, musisz go
 
 ```lua
 render.dispatch_compute(128, 128, 1)
--- dispatch_compute also accepts an options table as the last argument
--- you can use this argument table to pass in render constants to the dispatch call
+-- dispatch_compute przyjmuje też tabelę opcji jako ostatni argument
+-- tej tabeli możesz użyć do przekazania stałych renderowania do wywołania dispatch
 local constants = render.constant_buffer()
 constants.tint = vmath.vector4(1, 1, 1, 1)
 render.dispatch_compute(32, 32, 32, {constants = constants})
@@ -109,10 +109,10 @@ Obecnie generowanie dowolnego rodzaju danych wyjściowych z programu compute jes
 Aby utworzyć teksturę storage w Defold, musisz zrobić to ze zwykłego pliku `.script`. Skrypty do renderowania nie mają tej funkcjonalności, ponieważ tekstury dynamiczne trzeba tworzyć przez API zasobów, które jest dostępne tylko w zwykłych plikach `.script`.
 
 ```lua
--- In a .script file:
+-- W pliku .script:
 function init(self)
-    -- Create a texture resource like usual, but add the "storage" flag
-    -- so it can be used as the backing storage for compute programs
+    -- Utwórz zasób tekstury jak zwykle, ale dodaj flagę "storage",
+    -- aby można go było użyć jako tekstury bazowej dla programów compute
     local t_backing = resource.create_texture("/my_backing_texture.texturec", {
         type   = resource.TEXTURE_TYPE_IMAGE_2D,
         width  = 128,
@@ -121,10 +121,10 @@ function init(self)
         flags  = resource.TEXTURE_USAGE_FLAG_STORAGE + resource.TEXTURE_USAGE_FLAG_SAMPLE,
     })
 
-    -- get the texture handle from the resource
+    -- pobierz uchwyt tekstury z zasobu
     local t_backing_handle = resource.get_texture_info(t_backing).handle
 
-    -- notify the renderer of the backing texture, so it can be bound with render.enable_texture
+    -- powiadom renderer o teksturze bazowej, aby można było ją powiązać przez render.enable_texture
     msg.post("@render:", "set_backing_texture", { handle = t_backing_handle })
 end
 ```
@@ -134,46 +134,46 @@ end
 ### Program shadera
 
 ```glsl
-// compute.cp
+// plik: compute.cp
 #version 450
 
 layout (local_size_x = 1, local_size_y = 1, local_size_z = 1) in;
 
-// specify the input resources
+// określ zasoby wejściowe
 uniform vec4 color;
 uniform sampler2D texture_in;
 
-// specify the output image
+// określ obraz wyjściowy
 layout(rgba32f) uniform image2D texture_out;
 
 void main()
 {
-    // This isn't a particularly interesting shader, but it demonstrates
-    // how to read from a texture and constant buffer and write to a storage texture
+    // To nie jest szczególnie ciekawy shader, ale pokazuje,
+    // jak czytać z tekstury i bufora stałych oraz zapisywać do tekstury storage
 
     ivec2 tex_coord   = ivec2(gl_GlobalInvocationID.xy);
     vec4 output_value = vec4(0.0, 0.0, 0.0, 1.0);
     vec2 tex_coord_uv = vec2(float(tex_coord.x)/(gl_NumWorkGroups.x), float(tex_coord.y)/(gl_NumWorkGroups.y));
     vec4 input_value = texture(texture_in, tex_coord_uv);
     output_value.rgb = input_value.rgb * color.rgb;
 
-    // Write the output value to the storage texture
+    // Zapisz wartość wyjściową do tekstury storage
     imageStore(texture_out, tex_coord, output_value);
 }
 ```
 
 ### Komponent skryptu
 ```lua
--- In a .script file
+-- W pliku .script:
 
--- Here we specify the input texture that we later will bind to the
--- compute program. We can assign this texture to a model component,
--- or enable it to the render context in the render script.
+-- Tutaj określamy teksturę wejściową, którą później powiążemy
+-- z programem compute. Możemy przypisać tę teksturę do komponentu modelu
+-- albo włączyć ją w kontekście renderowania w skrypcie renderowania.
 go.property("texture_in", resource.texture())
 
 function init(self)
-    -- Create a texture resource like usual, but add the "storage" flag
-    -- so it can be used as the backing storage for compute programs
+    -- Utwórz zasób tekstury jak zwykle, ale dodaj flagę "storage",
+    -- aby można go było użyć jako tekstury bazowej dla programów compute
     local t_backing = resource.create_texture("/my_backing_texture.texturec", {
         type   = resource.TEXTURE_TYPE_IMAGE_2D,
         width  = 128,
@@ -187,15 +187,15 @@ function init(self)
         texture_out = resource.get_texture_info(t_backing).handle
     }
 
-    -- notify the renderer of the input and output textures
+    -- powiadom renderer o teksturach wejściowej i wyjściowej
     msg.post("@render:", "set_backing_texture", textures)
 end
 ```
 
 ### Skrypt do renderowania
 ```lua
--- respond to the message "set_backing_texture"
--- to set the backing texture for the compute program
+-- reaguj na wiadomość "set_backing_texture",
+-- aby ustawić teksturę bazową dla programu compute
 function on_message(self, message_id, message)
     if message_id == hash("set_backing_texture") then
         self.texture_in = message.texture_in
@@ -205,15 +205,15 @@ end
 
 function update(self)
     render.set_compute("compute")
-    -- We can bind textures to specific named constants
+    -- Możemy powiązać tekstury z konkretnymi nazwanymi stałymi
     render.enable_texture(self.texture_in, "texture_in")
     render.enable_texture(self.texture_out, "texture_out")
     render.set_constant("color", vmath.vector4(0.5, 0.5, 0.5, 1.0))
-    -- Dispatch the compute program as many times as we have pixels.
-    -- This constitutes our "working group". The shader will be invoked
+    -- Uruchom program compute tyle razy, ile mamy pikseli.
+    -- To stanowi naszą "grupę roboczą". Shader zostanie wywołany
     -- 128 x 128 x 1 times, or once per pixel.
     render.dispatch_compute(128, 128, 1)
-    -- when we are done with the compute program, we need to unbind it
+    -- gdy skończymy pracę z programem compute, musimy go odwiązać
     render.set_compute()
 end
 ```

docs/pl/manuals/editor-scripts-ui.md

@@ -137,31 +137,31 @@ Jeśli tworzysz statyczne UI, wystarczy zdefiniować callbacki, które po prostu
 
 Na przykład można tak utworzyć proste, statyczne okno dialogowe tworzenia nowego pliku:
 ```lua
--- initial file name, will be replaced by the dialog
+-- początkowa nazwa pliku, zostanie zastąpiona przez dialog
 local file_name = ""
 local create_file = editor.ui.show_dialog(editor.ui.dialog({
-    title = "Create New File",
+    title = "Utwórz nowy plik",
     content = editor.ui.horizontal({
         padding = editor.ui.PADDING.LARGE,
         spacing = editor.ui.SPACING.MEDIUM,
         children = {
             editor.ui.label({
-                text = "New File Name",
+                text = "Nazwa nowego pliku",
                 alignment = editor.ui.ALIGNMENT.CENTER
             }),
             editor.ui.string_field({
                 grow = true,
                 text = file_name,
-                -- Typing callback:
+                -- Callback wywoływany podczas wpisywania:
                 on_value_changed = function(new_text)
                     file_name = new_text
                 end
             })
         }
     }),
     buttons = {
-        editor.ui.dialog_button({ text = "Cancel", cancel = true, result = false }),
-        editor.ui.dialog_button({ text = "Create File", default = true, result = true })
+        editor.ui.dialog_button({ text = "Anuluj", cancel = true, result = false }),
+        editor.ui.dialog_button({ text = "Utwórz plik", default = true, result = true })
     }
 }))
 if create_file then
@@ -178,7 +178,7 @@ Oto lista wbudowanych komponentów wejściowych:
 
 Wszystkie komponenty poza przyciskami pozwalają ustawić pole `issue`, które wyświetla problem powiązany z komponentem (albo `editor.ui.ISSUE_SEVERITY.ERROR`, albo `editor.ui.ISSUE_SEVERITY.WARNING`), na przykład:
 ```lua
-issue = {severity = editor.ui.ISSUE_SEVERITY.WARNING, message = "This value is deprecated"}
+issue = {severity = editor.ui.ISSUE_SEVERITY.WARNING, message = "Ta wartość jest przestarzała"}
 ```
 Gdy `issue` jest określone, zmienia wygląd komponentu wejściowego i dodaje podpowiedź z komunikatem problemu.
 
@@ -213,9 +213,9 @@ Aby utworzyć komponent reaktywny, użyj funkcji `editor.ui.component()`.
 Spójrzmy na przykład: okno dialogowe tworzenia nowego pliku, które pozwala utworzyć plik tylko wtedy, gdy wpisana nazwa pliku nie jest pusta:
 
 ```lua
--- 1. dialog is a reactive component
+-- 1. dialog jest komponentem reaktywnym
 local dialog = editor.ui.component(function(props)
-    -- 2. the component defines a local state (file name) that defaults to empty string
+    -- 2. komponent definiuje stan lokalny (nazwę pliku), który domyślnie jest pustym łańcuchem
     local name, set_name = editor.ui.use_state("")
 
     return editor.ui.dialog({ 
@@ -225,30 +225,30 @@ local dialog = editor.ui.component(function(props)
             children = { 
                 editor.ui.string_field({ 
                     value = name,
-                    -- 3. typing + Enter updates the local state
+                    -- 3. wpisywanie + Enter aktualizują stan lokalny
                     on_value_changed = set_name 
                 }) 
             }
         }),
         buttons = {
             editor.ui.dialog_button({ 
-                text = "Cancel", 
+                text = "Anuluj", 
                 cancel = true 
             }),
             editor.ui.dialog_button({ 
-                text = "Create File",
-                -- 4. creation is enabled when the name exists
+                text = "Utwórz plik",
+                -- 4. tworzenie jest aktywne, gdy nazwa nie jest pusta
                 enabled = name ~= "",
                 default = true,
-                -- 5. result is the name
+                -- 5. wynikiem jest nazwa
                 result = name
             })
         }
     })
 end)
 
--- 6. show_dialog will either return non-empty file name or nil on cancel
-local file_name = editor.ui.show_dialog(dialog({ title = "New File Name" }))
+-- 6. show_dialog zwróci albo niepustą nazwę pliku, albo nil po anulowaniu
+local file_name = editor.ui.show_dialog(dialog({ title = "Nazwa nowego pliku" }))
 if file_name then 
     print("create " .. file_name)
 else
@@ -285,14 +285,14 @@ Edytor definiuje 2 haki: **`use_memo`** i **`use_state`**.
 
 Stan lokalny można utworzyć na 2 sposoby: z wartością domyślną albo z funkcją inicjalizującą:
 ```lua
--- default value
+-- wartość domyślna
 local enabled, set_enabled = editor.ui.use_state(true)
--- initializer function + args
+-- funkcja inicjalizująca + argumenty
 local id, set_id = editor.ui.use_state(string.lower, props.name)
 ```
 Podobnie setter można wywołać z nową wartością albo funkcją aktualizującą:
 ```lua
--- updater function
+-- funkcja aktualizująca
 local function increment_by(n, by)
     return n + by
 end
@@ -323,44 +323,44 @@ end)
 
 Na koniec: stan może zostać **zresetowany**. Dochodzi do tego, gdy zmieni się którykolwiek z argumentów przekazywanych do `editor.ui.use_state()`, sprawdzanych przez `==`. Z tego powodu nie wolno używać literałów tabel ani literałowych funkcji inicjalizujących jako argumentów haka `use_state`, bo spowoduje to reset stanu przy każdym ponownym renderowaniu. Dla zobrazowania:
 ```lua
--- ❌ BAD: literal table initializer causes state reset on every re-render
+-- ❌ ŹLE: literał tabeli w inicjalizatorze powoduje reset stanu przy każdym ponownym renderowaniu
 local user, set_user = editor.ui.use_state({ first_name = props.first_name, last_name = props.last_name})
 
--- ✅ GOOD: use initializer function outside of component function to create table state
+-- ✅ DOBRZE: użyj funkcji inicjalizującej poza funkcją komponentu, aby utworzyć stan tabeli
 local function create_user(first_name, last_name) 
     return { first_name = first_name, last_name = last_name}
 end
--- ...later, in component function:
+-- ...później, wewnątrz funkcji komponentu:
 local user, set_user = editor.ui.use_state(create_user, props.first_name, props.last_name)
 
 
--- ❌ BAD: literal initializer function causes state reset on every re-render
+-- ❌ ŹLE: literał funkcji inicjalizującej powoduje reset stanu przy każdym ponownym renderowaniu
 local id, set_id = editor.ui.use_state(function() return string.lower(props.name) end)
 
--- ✅ GOOD: use referenced initializer function to create the state
+-- ✅ DOBRZE: użyj referencji do funkcji inicjalizującej, aby utworzyć stan
 local id, set_id = editor.ui.use_state(string.lower, props.name)
 ```
 
 ### **`use_memo`**
 
 Możesz użyć haka `use_memo`, aby poprawić wydajność. W funkcjach renderujących często wykonuje się pewne obliczenia, na przykład sprawdzanie poprawności danych wejściowych użytkownika. Hak `use_memo` przydaje się wtedy, gdy sprawdzenie, czy argumenty funkcji obliczeniowej się zmieniły, jest tańsze niż samo wywołanie tej funkcji. Hak wywoła funkcję obliczeniową przy pierwszym renderowaniu i ponownie wykorzysta obliczoną wartość podczas kolejnych renderowań, jeśli wszystkie argumenty `use_memo` pozostaną bez zmian:
 ```lua
--- validation function outside of component function
+-- funkcja walidująca poza funkcją komponentu
 local function validate_password(password)
     if #password < 8 then
-        return false, "Password must be at least 8 characters long."
+        return false, "Hasło musi mieć co najmniej 8 znaków."
     elseif not password:match("%l") then
-        return false, "Password must include at least one lowercase letter."
+        return false, "Hasło musi zawierać co najmniej jedną małą literę."
     elseif not password:match("%u") then
-        return false, "Password must include at least one uppercase letter."
+        return false, "Hasło musi zawierać co najmniej jedną wielką literę."
     elseif not password:match("%d") then
-        return false, "Password must include at least one number."
+        return false, "Hasło musi zawierać co najmniej jedną cyfrę."
     else
-        return true, "Password is valid."
+        return true, "Hasło jest poprawne."
     end
 end
 
--- ...later, in component function
+-- ...później, wewnątrz funkcji komponentu
 local username, set_username = editor.ui.use_state('')
 local password, set_password = editor.ui.use_state('')
 local valid, message = editor.ui.use_memo(validate_password, password)

docs/pl/manuals/extensions-manifest-merge-tool.md

@@ -135,11 +135,11 @@ Manifest bazowy
         <key>REAL</key>
         <real>8.0</real>
 
-        <!-- Keep this value even if an extension manifest contains the same key -->
+        <!-- Zachowaj tę wartość, nawet jeśli manifest rozszerzenia zawiera ten sam klucz -->
         <key merge='keep'>BASE64</key>
         <data>SEVMTE8gV09STEQ=</data>
 
-        <!-- If an extension manifest also has an array with this key then any dictionary values will be merged with the first dictionary value of the base array -->
+        <!-- Jeśli manifest rozszerzenia również ma tablicę z tym kluczem, wartości słowników zostaną scalone z pierwszą wartością słownika w tablicy bazowej -->
         <key>Array1</key>
         <array>
             <dict>
@@ -150,7 +150,7 @@ Manifest bazowy
             </dict>
         </array>
 
-        <!-- Do not attempt to merge the values of this array, instead values from extension manifests should be added to the end of the array -->
+        <!-- Nie próbuj scalać wartości tej tablicy; zamiast tego dodaj wartości z manifestów rozszerzeń na końcu tablicy -->
         <key merge='keep'>Array2</key>
         <array>
             <dict>
@@ -187,7 +187,7 @@ Manifest rozszerzenia
         <key>INT</key>
         <integer>42</integer>
 
-        <!-- Replace the existing value in the base manifest -->
+        <!-- Zastąp istniejącą wartość w manifeście bazowym -->
         <key merge='replace'>REAL</key>
         <integer>16.0</integer>
 
@@ -223,7 +223,7 @@ Wynik:
     <?xml version='1.0'?>
     <!DOCTYPE plist SYSTEM 'file://localhost/System/Library/DTDs/PropertyList.dtd'>
     <plist version='1.0'>
-        <!-- Nested merge of dictionaries from base and extension manifests -->
+        <!-- Zagnieżdżone scalanie słowników z manifestu bazowego i manifestu rozszerzenia -->
         <dict>
             <key>NSAppTransportSecurity</key>
             <dict>
@@ -244,23 +244,23 @@ Wynik:
                 </dict>
             </dict>
 
-            <!-- From the base manifest -->
+            <!-- Z manifestu bazowego -->
             <key>INT</key>
             <integer>8</integer>
 
-            <!-- The value from the base manifest was replaced since the merge marker was set to "replace" in the extension manifest -->
+            <!-- Wartość z manifestu bazowego została zastąpiona, ponieważ w manifeście rozszerzenia ustawiono znacznik scalania na "replace" -->
             <key>REAL</key>
             <real>16.0</real>
 
-            <!-- The value from the base manifest was used since the merge marker was set to "keep" in the base manifest -->
+            <!-- Użyto wartości z manifestu bazowego, ponieważ w manifeście bazowym ustawiono znacznik scalania na "keep" -->
             <key>BASE64</key>
             <data>SEVMTE8gV09STEQ=</data>
 
-            <!-- The value from the extender manifest was added since no merge marker was specified -->
+            <!-- Dodano wartość z manifestu rozszerzenia, ponieważ nie określono znacznika scalania -->
             <key>INT</key>
             <integer>42</integer>
 
-            <!-- The dictionary values of the array were merged since the base manifest defaults to "merge" -->
+            <!-- Wartości słowników w tablicy zostały scalone, ponieważ domyślną wartością manifestu bazowego jest "merge" -->
             <key>Array1</key>
             <array>
                 <dict>
@@ -272,7 +272,7 @@ Wynik:
                 </dict>
             </array>
 
-            <!-- The dictionary values were added to the array since the base manifest used "keep" -->
+            <!-- Wartości słowników zostały dodane do tablicy, ponieważ manifest bazowy używał opcji "keep" -->
             <key>Array2</key>
             <array>
                 <dict>