update doc/ru structure & update docs (ru)

2024-06-13 18:41:38 +03:00
parent 607d30fd33
commit dbe98959d1
18 changed files with 55 additions and 16 deletions
@@ -0,0 +1,54 @@
+# Предзагрузка ассетов (файл *preload.json*)
+
+Для загрузки ассетов, не загружаемых автоматически, такие как звуки, дополнительные текстуры, используется файл `preload.json`, создающийся в папке контент-пака.
+
+Ассеты в файле разделяются на категории:
+- fonts - шрифты
+- shaders - шейдеры
+- textures - текстуры
+- sounds - звуки
+
+> [!NOTE]
+> При загрузке звука подгружаются все его вариации, по шаблону:
+> (звук: sound_name) -> *sound_name.ogg, sound_name_1.ogg, sound_name_2.ogg, ...*
+> или *sound_name_0.ogg, sound_name_1.ogg, sound_name_2.ogg, ...*
+
+Добавление звука `пак:sounds/events/explosion.ogg` со всеми его вариантами:
+```json
+{
+    "sounds": [
+        "events/explosion"
+    ]
+}
+```
+Будет доступен под именем: "events/explosion"
+
+В случае, если нужно будет работать с PCM данными звука (сейчас не доступно из скриптинга), требуется указать параметр `keep-pcm`:
+```json
+{
+    "sounds": [
+        {
+            "name": "events/explosion",
+            "keep-pcm": true
+        }
+    ]
+}
+```
+
+
+Пример файла из пакета `core:` (`res/preload.json`):
+```json
+{
+    "shaders": [
+        "ui3d",
+        "screen",
+        "background",
+        "skybox_gen"
+    ],
+    "textures": [
+        "misc/moon",
+        "misc/sun",
+        "gui/crosshair"
+    ]
+}
+```