From 3e0ef334d40f0515c1db8dea0ce4ba2237340599 Mon Sep 17 00:00:00 2001 From: MihailRis Date: Mon, 5 Jan 2026 15:55:47 +0300 Subject: [PATCH] update doc/*/vcm.md --- doc/ru/vcm.md | 21 +++++++++++++++++++-- 1 file changed, 19 insertions(+), 2 deletions(-) diff --git a/doc/ru/vcm.md b/doc/ru/vcm.md index 379e0328d..2a86fc990 100644 --- a/doc/ru/vcm.md +++ b/doc/ru/vcm.md @@ -20,15 +20,28 @@ В отличие от XML в корне может находиться несколько элементов. -На данный момент существует два вида примитивов: box и rect, а также, part (описывает часть примитива, такую как, например, сторона куба). +На данный момент существует три вида примитивов: tri, box и rect, а также, part (описывает часть примитива, такую как, например, сторона куба). > [!NOTE] > По-умолчанию текстурные координаты определяются размерами примитивов. > При размерах более 1.0 результат не определён и может измениться в последующих обновлениях. > Используйте `region` или `region-scale` для ручной настройки. +### Свойства `tri` + +Примитив описывает треугольник. + +- `a` - точка A. Пример: `a (0,0,0)` +- `b` - точка B. Пример: `b (1,0,0)` +- `c` - точка С. Пример: `c (1,1,0)` +- `uv` - нормализованные текстурные координаты точек (6 чисел, по 2 на точку). Пример: `uv (0,0, 1,0, 1,1)` +- `texture` - отображаемая текстура. По-умолчанию: `$0`. Пример: `texture "blocks:sand"` +- `shading` определяет возможность затенения на примитиве. Пример: `shading off` + ### Свойства `rect` +Примитив описывает параллелограмм через векторы right и up. + - `from` - точка начала примитива. Пример: `from (0,0.5,0.125)` - `right` - вектор X, также определяющий ширину примитива. Пример: `right (1,0,0)` - `up` - вектор Y, также определяющий высоту примитива. Пример: `up (0,1,0)` @@ -40,6 +53,8 @@ ### Свойства `box` +Примитив описывает прямоугольный параллелепипед. + - `from` - точка начала примитива. Пример: `from (0,0,0)` - `to` - противоположная от начала точка. Пример: `to (1,1,1)` - `origin` - точка, относительно которой будет применено вращение. По-умолчанию: центр примитива. Пример: `origin (0.5,0.5,0.5)` @@ -48,7 +63,9 @@ - `shading` определяет возможность затенения на примитиве. Пример: `shading off` - `delete` удаляет стороны по именам (top, bottom, east, west, north, south) -### Свойства `part` (в `box`) +### Свойства `part` (вложен в `box`) + +Примитив описывает свойства сторон прямоугольного параллелепипеда с указанными тегами (top/bottom/north/south/east/west). - `tags` - определяет то, на какаие из сторон будут применены свойства. Пример: `tags (top,bottom)` - `texture` - отображаемая текстура. По-умолчанию: `$индекс_стороны`.