Merge branch 'main' into release-0.32

doc/en/vca.md

@@ -86,6 +86,16 @@ For the `texture` directive, it is simpler. Example:
 > Here, `entities/tireman` is the name of the texture atlas containing `face_*` textures.
 > The texture does not necessarily have to be in an atlas.
 
+If you do not wish to limit the animation duration via `configure` but want to loop the keyframe animation for a specific line, you can use the `period` parameter to specify the animation's repetition period in frames. Example:
+
+```vcd
+@move by y curve linear period 24 {
+    @key frame 0 value 0
+    @key frame 12 value 1
+    @key frame 24 value 0
+}
+```
+
 ## Expression curves
 
 The attribute describes a function `f(t) = x`, where t is time in seconds.

doc/en/vcm.md

@@ -42,6 +42,7 @@ This primitive describes a triangle.
 - `region-scale` - multiplier vector for the UV region. Example: `region-scale (0.5,1)`
 - `shading` - determines whether shading is enabled on the primitive. Example: `shading off`
 - `normal` - overrides normal vector. Example: `normal (0,1,0)`
+- `cull-face` - determines which side will be culled. Example: `cull-face front` or `cull-face off` (disables face culling)
 
 By default, texture coordinates are not affected by shape or size, unlike other primitives.
 
@@ -58,6 +59,7 @@ This primitive describes a parallelogram using the right and up vectors.
 - `shading` - determines whether shading is enabled on the primitive. Example: `shading off`
 - `flip` - flips the UV region horizontally or vertically. Example: `flip v`
 - `normal` - overrides normal vector. Example: `normal (0,1,0)`
+- `cull-face` - determines which side will be culled. Example: `cull-face front` or `cull-face off` (disables face culling)
 
 ### `box` Properties
 

doc/ru/vca.md

@@ -86,6 +86,16 @@ VCA файл состоит из набора директив, порядок
 > entities/tireman здесь - имя текстурного атласа, в котором находятся face_\* текстуры.
 > Текстура не обязательно должна находиться в атласе.
 
+Если вы не хотите ограничивать длительность анимации через `configure`, но хотите зациклить анимацию по ключевым кадрам для конкретной линии, то можно использовать параметр `period` для указания периода повторения анимации в кадрах. Пример:
+
+```vcd
+@move by y curve linear period 24 {
+    @key frame 0 value 0
+    @key frame 12 value 1
+    @key frame 24 value 0
+}
+```
+
 ## Кривые через выражения
 
 Через атрибут описывается функция `f(t) = x` где t - время в секундах.

doc/ru/vcm.md

@@ -42,6 +42,7 @@
 - `region-scale` вектор-множитель для UV региона. Пример: `region-scale (0.5,1)`
 - `shading` определяет возможность затенения на примитиве. Пример: `shading off`
 - `normal` переопределяет вектор нормали. Пример: `normal (0,1,0)`
+- `cull-face` - определяет, какая сторона будет отсечена. Пример: `cull-face front` или `cull-face off` (отлючает отсечение сторон)
 
 Текстурные координаты по-умолчанию не зависят от формы из размера, в отличие от других примитивов.
 
@@ -58,6 +59,7 @@
 - `shading` - определяет возможность затенения на примитиве. Пример: `shading off`
 - `flip` - отражает UV регион по горизонтали или вертикали. Пример: `flip v`
 - `normal` -  переопределяет вектор нормали. Пример: `normal (0,1,0)`
+- `cull-face` - определяет, какая сторона будет отсечена. Пример: `cull-face front` или `cull-face off` (отлючает отсечение сторон)
 
 ### Свойства `box`