Merge bfc15a2a39 into dacebf94bc

doc/en/scripting/ui.md

@@ -231,6 +231,25 @@ Properties:
 | value   | string | yes  | yes   | Selected value                                   |
 | options | table  | yes  | yes   | List of options (tables `{value=..., text=...}`) |
 
+## Progress bar (progressbar)
+
+Properties:
+
+| Name         | Type   | Read | Write | Description                                                   |
+|--------------|--------|------|-------|---------------------------------------------------------------|
+| value        | float  | yes  | yes   | current value                                                 |
+| min          | float  | yes  | yes   | minimum value                                                 |
+| max          | float  | yes  | yes   | maximum value                                                 |
+| progress     | float  | yes  | no    | progress 0..1                                                 |
+| displayValue | float  | yes  | no    | displayed (animated) value                                    |
+| color        | rgba   | yes  | yes   | color of the filled part                                      |
+| bgColor      | rgba   | yes  | yes   | background color (empty part)                                 |
+| textColor    | rgba   | yes  | yes   | text color                                                    |
+| text         | string | yes  | yes   | text centered in the bar                                      |
+| smooth       | bool   | yes  | yes   | smooth value change                                           |
+| smoothSpeed  | number | yes  | yes   | smooth transition speed in units per second                   |
+| orientation  | string | yes  | yes   | fill direction: "horizontal" / "vertical"                     |
+
 ## Inventory
 
 Properties:

doc/en/xml-ui-layouts.md

@@ -198,6 +198,21 @@ Example of list description:
     - `select` - default mode.
     - `button` - button mode: the text is not replaced with the selected option; the element rendered as a regular button.
 
+## Progress bar - *progressbar*
+
+Non-interactive element for displaying progress. Draws a background and a filled part.
+
+- `min` - minimal value. Type: number. Default: 0
+- `max` - maximal value. Type: number. Default: 100
+- `value` - initial value. Type: number. Default: 0
+- `color` - color of the filled part. Type: RGBA color. Default: blue `#3399FFCC`
+- `bg-color` - background color (empty part). Type: RGBA color. Default: semi-transparent black `#00000066`
+- `orientation` - fill direction: `horizontal` / `vertical`
+- `smooth` - smooth value change on updates. Type: boolean. Default: false
+- `smooth-speed` - smooth transition speed in units per second. Type: number. Default: 120
+- `text-color` - text color. Type: RGBA color. Default: white `#FFFFFFFF`
+- `font` - font name. Type: string. Default: "normal"
+
 ## *bindbox*
 
 An element for displaying and editing key or mouse button bindings.

doc/ru/scripting/ui.md

@@ -231,6 +231,25 @@ Canvas.decode(data: Bytearray, format: str) -> Canvas
 | value    | string | да     | да     | Выбранное значение                                             |
 | options  | table  | да     | да     | Список опций (таблиц `{value=..., text=...}`)                  |
 
+## Прогресс-бар (progressbar)
+
+Свойства:
+
+| Название     | Тип    | Чтение | Запись | Описание                                                               |
+|--------------|--------|--------|--------|------------------------------------------------------------------------|
+| value        | float  | да     | да     | текущее значение                                                       |
+| min          | float  | да     | да     | минимальное значение                                                   |
+| max          | float  | да     | да     | максимальное значение                                                  |
+| progress     | float  | да     | нет    | прогресс 0..1                                                          |
+| displayValue | float  | да     | нет    | отображаемое (анимированное) значение                                  |
+| color        | rgba   | да     | да     | цвет заполненной части                                                 |
+| bgColor      | rgba   | да     | да     | цвет фона (пустой части)                                               |
+| textColor    | rgba   | да     | да     | цвет текста                                                            |
+| text         | string | да     | да     | текст по центру бара                                                   |
+| smooth       | bool   | да     | да     | плавное изменение значения                                             |
+| smoothSpeed  | number | да     | да     | скорость плавного перехода в единицах в секунду                        |
+| orientation  | string | да     | да     | направление заполнения: "horizontal" / "vertical"                      |
+
 ## Инвентарь (inventory)
 
 Свойства:

doc/ru/xml-ui-layouts.md

@@ -199,6 +199,21 @@
     - `select` - режим по-умолчанию.
     - `button` - режим кнопки: текст не заменяется на выбранную опцию, а элемент выглядит как обычная кнопка.
 
+## Прогресс-бар - *progressbar*
+
+Неинтерактивный элемент для отображения прогресса. Рисует фон и заполненную часть.
+
+- `min` — минимальное значение. Тип: число. По-умолчанию: 0
+- `max` — максимальное значение. Тип: число. По-умолчанию: 100
+- `value` — начальное значение. Тип: число. По-умолчанию: 0
+- `color` — цвет заполненной части. Тип: RGBA цвет. По-умолчанию: синий `#3399FFCC`
+- `bg-color` — цвет фона (пустой части). Тип: RGBA цвет. По-умолчанию: чёрный полупрозрачный `#00000066`
+- `orientation` — направление заполнения: `horizontal` / `vertical`
+- `smooth` — плавное изменение значения при обновлениях. Тип: логический. По-умолчанию: false
+- `smooth-speed` — скорость плавного перехода в единицах в секунду. Тип: число. По-умолчанию: 120
+- `text-color` — цвет текста. Тип: RGBA цвет. По-умолчанию: белый `#FFFFFFFF`
+- `font` — имя шрифта. Тип: строка. По-умолчанию: "normal"
+
 ## Привязка ввода - *bindbox*
 
 Элемент для отображения и изменения привязки клавиш или кнопок мыши.