Update.

Author: Dmitriy Zayceff

Geometry.md

@@ -0,0 +1,45 @@
+# Geometry
+
+- **class** `Geometry` (`action\Geometry`)
+```php
+use action\Geometry;
+```
+
+Утилитный класс только со статичными методами, для работы с простыми геометрическими фигурами.
+
+> У класса приватный конструктор, невозможно создать объект данного класса.
+
+---
+
+#### Статичные методы
+
+- `Geometry ::`[`hasPoint()`](#haspoint)
+- `Geometry ::`[`intersect()`](#intersect)
+
+---
+
+### `hasPoint()`
+```php
+hasPoint(object $what, double $x, double $y): bool
+```
+Метод возвращает `true`, если точка `$x, $y` входит внутрь фигуры объекта `$what`. Объектом может выступать абсолютно любой объект php, у которого есть свойства `x, y, width и height`.
+
+```php
+if (Geometry::hasPoint($button, 100, 300)) {
+   alert("Точка (x: 100, y: 300) находится внутри кнопки");
+}
+```
+
+---
+
+### `intersect()`
+```php
+intersect(object $one, object $two): bool
+```
+Возвращает `true`, если два прямоугольника объекта `$one` и `$two` пересекаются. В качестве объекта могут быть любые объекты php, у которых есть свойства `x, y, width и height`.
+
+```php
+if (Geometry::intersect($button1, $button2)) {
+   // кнопки button1 и button2 пересекаются.
+}
+```

Media.md

@@ -0,0 +1,39 @@
+# Media
+
+- **class** `Media` (`action\Media`)
+```php
+use action\Media;
+```
+
+Утилитный класс только со статичными методами, для упрощенной работы с медиа-контентом (аудио и видео).
+
+> У класса приватный конструктор, невозможно создать объект данного класса.
+
+---
+
+#### Статичные методы
+
+- `Media ::`[`open()`](#open)
+- `Media ::`[`isStatus()`](#isstatus)
+- `Media ::`[`stop()`](#stop)
+- `Media ::`[`pause()`](#pause)
+- `Media ::`[`play()`](#play)
+
+---
+
+### `open()`
+```php
+open(string $file, bool $autoPlay = true, string | MediaPlayerScript $id = 'general')
+```
+Загружает медиа-файл из `$file` и начинает его играть если включена опция `$autoPlay`. В качестве плеера `$id` можно указать символьный код или объект класса [MediaPlayerScript](MediaPlayerScript). У каждого такого плеера свой поток воспроизведения, если вы хотите проигрывать несколько звуков параллельно, то используйте разные плееры `$id`.
+
+```php
+// проигрываем музыку в отдельном плеере 'background_sound'
+Media::open('path/to/music.mp3', true, 'background_sound');
+
+// проигрываем стартовый звук.
+Media::open('path/to/start.wav');
+
+// можно указать объект плеера - модульный компонент.
+Media::open('path/to/file.mp3', true, $this->player);
+```

Score.md

@@ -0,0 +1,58 @@
+# Score
+
+- **class** `Score` (`action\Score`)
+```php
+use action\Score;
+```
+
+Утилитный класс только со статичными методами, для более удобного управления счетом в играх и не только. Очень часто возникает необходимость сделать подсчет бонусов и жизней в играх, это могут быть монетки, которые добавляют очки, одновременно необходимо считать и жизни персонажа в игре. Все это позволяет сделать данный класс.
+
+> У класса приватный конструктор, невозможно создать объект данного класса.
+
+---
+
+#### Статичные методы
+
+- `Score ::`[`set()`](#set)
+- `Score ::`[`get()`](#get)
+- `Score ::`[`inc()`](#inc)
+
+---
+
+### `set()`
+```php
+set(string $name, int $value)
+```
+Устанавливает новое значение счету, под названием `$name`. У каждого счета всегда должно быть название в виде символьного кода.
+
+```php
+// установили money (деньги) в размере 2000.
+Score::set('money', 2000);
+```
+
+---
+
+### `get()`
+```php
+get(string $name): int
+```
+Метод возвращает значение счета `$name`, оно всегда возвращается в виде целого числа.
+
+```php
+$this->moneyLabel->text = Score::get('money');
+```
+
+---
+
+### `inc()`
+```php
+inc(string $name, int $value = 1)
+```
+Метод увеличивает счет `$name` на `1` или переданное значение `$value`. Для того, чтобы уменьшить значение, вы можете использовать этот же метод, достаточно передать `$value` в виде отрицательного числа, например `-1`.
+
+```php
+Score::inc('money'); // добавить 1
+Score::inc('money', 100); // добавить 100
+Score::inc('money', -1); // уменьшить на 1
+Score::inc('money', -100); // уменьшить на 100
+```

UXButton.md

@@ -0,0 +1,35 @@
+# UXButton
+
+- **class** <img src="https://cloud.githubusercontent.com/assets/1113915/22550186/fbd17720-e95f-11e6-8786-eb48ef061916.png" align="top" /> `UXButton` (`php\gui\UXButton`) **extends** [`UXButtonBase`](UXButtonBase).
+```php
+use php\gui\UXButton;
+```
+
+Класс компонента для отображения кнопок.
+
+> Изображение компонента:
+
+> ![image](https://cloud.githubusercontent.com/assets/1113915/22550278/5cfa9a68-e960-11e6-9aa7-65eab286db91.png)
+
+---
+
+#### Свойства
+- См. у класса родителя [`UXButtonBase`](UXButtonBase).
+
+#### Методы
+- [Конструктор (`new`)](#__construct) `__construct`
+- См. у класса родителя [`UXButtonBase`](UXButtonBase).
+
+---
+
+## Методы
+
+### `__construct()`
+```php
+__construct([string $text = ''])
+```
+Конструктор кнопки.
+
+```php
+$button = new UXButton('Привет, Мир!');
+```

UXButtonBase.md

@@ -0,0 +1,17 @@
+# UXButtonBase
+
+- abstract **class** `UXButtonBase` (`php\gui\UXButtonBase`) **extends** [`UXLabeled`](UXLabeled).
+
+> Классы наследники:
+
+> [`UXButton`](UXButton), [`UXFlatButton`](UXFlatButton), [`UXToggleButton`](UXToggleButton).
+
+Базовый абстрактный класс всех кнопок.
+
+---
+
+#### Свойства
+- См. у класса родителя [`UXLabeled`](UXLabeled).
+
+#### Методы
+- См. у класса родителя [`UXLabeled`](UXLabeled).

UXControl.md

@@ -0,0 +1,43 @@
+# UXControl
+
+- abstract **class** `UXControl` (`php\gui\UXControl`) **extends** [`UXRegion`](UXRegion).
+
+Абстрактый класс компонентов, у которых может быть всплывающая подсказка и контекстное меню.
+
+> Классы наследники:
+
+> [`UXHTMLEditor`](UXHTMLEditor), [`UXLabeled`](UXLabeled), [`UXListView`](UXListView), [`UXMenuBar`](UXMenuBar), [`UXProgressIndicator`](UXProgressIndicator), [`UXScrollPane`](UXScrollPane), [`UXSeparator`](UXSeparator), [`UXSlider`](UXSlider), [`UXSpinner`](UXSpinner), [`UXSplitPane`](UXSplitPane), [`UXTableView`](UXTableView), [`UXTabPane`](UXTabPane), [`UXTextInputControl`](UXTextInputControl), [`UXTreeView`](UXTreeView).
+
+---
+
+#### Свойства
+- `->`[`tooltip`](#tooltip-uxtooltip) - _подсказка_
+- `->`[`tooltipText`](#tooltipText) - _текст подсказки_
+- `->`[`contextMenu`](#contextmenu) - _контекстное меню_
+- См. у класса родителя [`UXRegion`](UXRegion).
+
+#### Методы
+- См. у класса родителя [`UXRegion`](UXRegion).
+
+---
+
+## Свойства
+
+### `tooltip` ([UXTooltip](UXTooltip))
+Всплывающая подсказка для компонента, объект класса `UXTooltip`, по-умолчанию `null`, что означает отсутствие подсказки.
+```php
+$button->tooltip = new UXTooltip('Подсказка');
+```
+
+---
+
+### `tooltipText` (string)
+Всплывающая подсказка только в виде текста (строки).
+```php
+$button->tooltipText = 'Подсказка';
+```
+
+---
+
+### `contextMenu` ([UXContextMenu](UXContextMenu))
+Контекстное меню компонента, обычно показывается при клике на компонент правой кнопки мыши. По-умолчанию `null`, но не у всех компонентов, у некоторых есть системное контекстное меню.

UXFlatButton.md

@@ -0,0 +1,47 @@
+# UXFlatButton
+
+- **class** <img src="https://cloud.githubusercontent.com/assets/1113915/22552153/c51aa54a-e968-11e6-9157-4153014038fd.png" align="top" /> `UXFlatButton` (`php\gui\UXFlatButton`) **extends** [`UXButtonBase`](UXButtonBase).
+```php
+use php\gui\UXFlatButton;
+```
+
+Класс компонента для отображения плоских кнопок.
+
+> Изображение компонента:
+
+> ![image](https://cloud.githubusercontent.com/assets/1113915/22552238/1ad0109c-e969-11e6-9083-1493cd4a3e01.png)
+
+---
+
+#### Свойства
+- `->`[`color`](#color-uxcolor)
+- `->`[`hoverColor`](#hovercolor-uxcolor)
+- `->`[`clickColor`](#clickcolor-uxcolor)
+- `->`[`borderRadius`](#borderradius-double)
+- См. у класса родителя [`UXButtonBase`](UXButtonBase).
+
+#### Методы
+- [Конструктор (`new`)](#__construct) `__construct`
+- См. у класса родителя [`UXButtonBase`](UXButtonBase).
+
+---
+
+## Свойства
+
+### `color` ([UXColor](UXColor))
+Основной цвет кнопки.
+
+--
+
+### `hoverColor` ([UXColor](UXColor))
+Цвет кнопки при наведении курсора на неё.
+
+--
+
+### `clickColor` ([UXColor](UXColor))
+Цвет кнопки при клике на неё.
+
+--
+
+### `borderRadius` (double)
+Радиус закругления углов у кнопки, по-умолчанию `0`, что означает отсутствие закруглений.

UXHyperlink.md

@@ -0,0 +1,43 @@
+# UXHyperlink
+
+- **class** <img src="https://cloud.githubusercontent.com/assets/1113915/23369179/8d17bd96-fd21-11e6-8115-54e6a64c63df.png" align="top" /> `UXHyperlink` (`php\gui\UXHyperlink`) **extends** [`UXButtonBase`](UXButtonBase).
+```php
+use php\gui\UXHyperlink;
+```
+
+Класс компонента для отображения ссылок, без форматирования.
+
+> Изображение компонента:
+
+> ![image](https://cloud.githubusercontent.com/assets/1113915/23369290/ea1f13f4-fd21-11e6-9b38-9aaf28adb256.png)
+
+---
+
+#### Свойства
+- `->`[`visited`](#visited-bool).
+- См. у класса родителя [`UXButtonBase`](UXButtonBase).
+
+#### Методы
+- [Конструктор (`new`)](#__construct) `__construct`
+- См. у класса родителя [`UXButtonBase`](UXButtonBase).
+
+---
+
+### `visited` (bool)
+Свойство возвращает `true`, если на ссылку уже кликали.
+
+---
+
+## Методы
+
+### `__construct()`
+```php
+__construct(string $text = '', UXNode $graphic = null)
+```
+
+```php
+$link = new UXHyperlink("Go to google.com");
+$link->on('action', function () {
+    browse('http://google.com');
+}); 
+```

UXLabel.md

@@ -0,0 +1,51 @@
+# UXLabel
+
+- **class** <img src="https://cloud.githubusercontent.com/assets/1113915/22618547/46438f0a-eaf0-11e6-8e88-689f576cb5b6.png" align="top" /> `UXLabel` (`php\gui\UXLabel`) **extends** [`UXLabeled`](UXLabeled).
+```php
+use php\gui\UXLabel;
+```
+
+Класс компонента для отображения обычных текстов, без форматирования, с возможностью выбрать шрифт и иконку для текста. У класса есть потомок `UXLabelEx`, который добавляет функцию авторазмера.
+
+> Изображение компонента:
+
+> ![image](https://cloud.githubusercontent.com/assets/1113915/22618557/ac634d7a-eaf0-11e6-815d-ceaf89a07515.png)
+
+---
+
+#### Свойства
+- `->`[`labelFor`](#labelfor-uxnode)
+- `->`[`autosize`](#autosize-bool) (только у потомка `UXLabelEx`).
+- См. у класса родителя [`UXLabeled`](UXLabeled).
+
+#### Методы
+- [Конструктор (`new`)](#__construct) `__construct`
+- См. у класса родителя [`UXLabeled`](UXLabeled).
+
+---
+
+## Свойства
+
+### `labelFor` ([UXNode](UXNode))
+Привязка текста к определенному визуальному компоненту интерфейса. По-умолчанию `null`.
+
+---
+
+### `autosize` (bool)
+> Только у класса `UXLabelEx`.
+
+Авторазмер текста, если включен, то ширина и высота компонента будут рассчитываться в зависимости от [текста](UXLabeled#text-string) компонента.
+
+---
+
+## Методы
+
+### `_construct`
+```php
+__construct([$text = '', UXNode $graphic = null]) {}
+```
+Конструктор класса UXLabel.
+```php
+$icon = new UXImageView(new UXImage('path/to/image.png'));
+$label = new UXLabel('Текст компонента', $icon);
+```