wiki.appsalutecreator.com - Вклад участника [ru]

Обсуждение:HiddenList

2013-02-12T19:24:42Z

Steps:

Возможные расширения ([[Участник:Steps|Steps]] 20:22, 12 февраля 2013 (CET)):
* зеркальное отражение хидден-сцены вместе с объектами (режим НЛО в Mystery Manor).
* режим ночь - вся сцена затемнена и виден только луч фонаря (палец)

Обсуждение:HiddenList

2013-02-12T19:22:41Z

Steps: Новая страница: «Возможные расширения (~~~~): * зеркальное отражение хидден-сцены вместе с объектами (режим ...»

Возможные расширения ([[Участник:Steps|Steps]] 20:22, 12 февраля 2013 (CET)):
* зеркальное отражение хидден-сцены вместе с объектами (режим НЛО в Mystery Manor).

Книга жалоб и пожеланий

2013-01-25T11:17:48Z

Steps: /* Улучшение интерфейса */

Внимание !!
* Перед публикацией внимательно читать ВСЕ!
* Делаем при обсуждении отступы (двоеточие) и подписываемся (4 тильды).

== Улучшение интерфейса ==

* Возможность копирования состояний из машины в машину.--[[Участник:Oilich|Oilich]] 13:36, 24 января 2013 (CET)
* Поворачивать, масштабировать объекты прямо на сцене (как в любом граф.редакторе) [[Участник:Steps|Steps]] 14:11, 24 января 2013 (CET)
* Добавить горячие клавиши в состоянии машин. В выбранном состоянии машины, например если нажать "w" создается ф-я wait, "i"=if, "m" = move, "s" = set ну и так далее. --[[Участник:Igood|Igood]] 16:10, 24 января 2013 (CET)
:: С какой клавишей использовать CTRL +S сохранение + давайте уже весь список хоткеев. Проще разнести и реализовать.\

* Возможность копирования ф-й(set,wait...) из одного состояния машины в другую.--[[Участник:Igood|Igood]] 16:12, 24 января 2013 (CET)
:: В чем отличие от "Возможность копирования состояний из машины в машину.--[[Участник:Oilich|Oilich]] 13:36, 24 января 2013 (CET)"
::: В том что это не состояния а отдельные функции в состоянии.--[[Участник:Igood|Igood]] 08:53, 25 января 2013 (CET)
:::: я поддерживаю. мелочь, а приятно. [[Участник:Steps|Steps]] 12:13, 25 января 2013 (CET)

* Добавить событие кнопке, изм. состояния объекта если на нее нажали в состоянии disable.--[[Участник:Igood|Igood]] 16:18, 24 января 2013 (CET)

:: С точки зрения кнопки - Она "Кнопка" имеет два состояния, в состоянии disable кнопка не должна вообще воспринимать кликов. Но если всех это не запутает и нужно для космического корабля то ОК--[[Участник:Boyarin|Boyarin]] 21:45, 24 января 2013 (CET)
:: Стоит обсудить. Действительно, не очень логично считать дизейбл рабочим состоянием. [[Участник:Steps|Steps]] 12:16, 25 января 2013 (CET)

* Редактор ресурсов. При загрузке картинок в редактор ресурсов, хотелось бы иметь возможность видеть превью картинок.
[[Файл:Редактор ресурсов.JPG|120px]]
[[Файл:Предпросмотр.JPG‎|120px|]]

* По логике в списке сначала должен идти параметр, а потом его значение.--[[Участник:Avereskun|Avereskun]] 10:06, 25 января 2013 (CET)

[[Файл:Editor123.jpg]]

== Новые объекты и свойства==

* Добавить сплайн (кривая линия), который можно рисовать на сцене и передавать команде move [[Участник:Steps|Steps]] 14:11, 24 января 2013 (CET)
- изучение возможности
* Добавить в редактор генератор комиксов. Хорошим и простым примером является [http://1001mem.ru/create_comics генератор комиков] Это пожелания на будущее. --[[Участник:Dorl|Dorl]] 10:35, 25 января 2013 (CET)

== Баги ==
* Переместив картинку из редактора ресурсов на сцену, в свойствах она имеет по умолчанию тип '''image'''. Меняя тип '''image''' на '''machine''' иконка в дереве остается по-прежнему '''image''' до первого клика. Необходимо сделать мгновенную смену иконки в дереве. 
[[Файл:Машина.JPG‎ ]]

MEGEDIT-1102 - не срочно
 

== Реализовано ==

Книга жалоб и пожеланий

2013-01-25T11:16:49Z

Steps: /* Улучшение интерфейса */

Внимание !!
* Перед публикацией внимательно читать ВСЕ!
* Делаем при обсуждении отступы (двоеточие) и подписываемся (4 тильды).

== Улучшение интерфейса ==

* Возможность копирования состояний из машины в машину.--[[Участник:Oilich|Oilich]] 13:36, 24 января 2013 (CET)
* Поворачивать, масштабировать объекты прямо на сцене (как в любом граф.редакторе) [[Участник:Steps|Steps]] 14:11, 24 января 2013 (CET)
* Добавить горячие клавиши в состоянии машин. В выбранном состоянии машины, например если нажать "w" создается ф-я wait, "i"=if, "m" = move, "s" = set ну и так далее. --[[Участник:Igood|Igood]] 16:10, 24 января 2013 (CET)
:: С какой клавишей использовать CTRL +S сохранение + давайте уже весь список хоткеев. Проще разнести и реализовать.\

* Возможность копирования ф-й(set,wait...) из одного состояния машины в другую.--[[Участник:Igood|Igood]] 16:12, 24 января 2013 (CET)
:: В чем отличие от "Возможность копирования состояний из машины в машину.--[[Участник:Oilich|Oilich]] 13:36, 24 января 2013 (CET)"
::: В том что это не состояния а отдельные функции в состоянии.--[[Участник:Igood|Igood]] 08:53, 25 января 2013 (CET)
:::: я поддерживаю. мелочь, а приятно. [[Участник:Steps|Steps]] 12:13, 25 января 2013 (CET)

* Добавить событие кнопке, изм. состояния объекта если на нее нажали в состоянии disable.--[[Участник:Igood|Igood]] 16:18, 24 января 2013 (CET)

:: С точки зрения кнопки - Она "Кнопка" имеет два состояния, в состоянии disable кнопка не должна вообще воспринимать кликов. Но если всех это не запутает и нужно для космического корабля то ОК--[[Участник:Boyarin|Boyarin]] 21:45, 24 января 2013 (CET)
:: Стоит обсудить. Действительно, не очень логично считать дизейбл рабочим состоянием. [[Участник:Steps|Steps]] 12:16, 25 января 2013 (CET)

* Редактор ресурсов. При загрузке картинок в редактор ресурсов, хотелось бы иметь возможность видеть превью картинок.
[[Файл:Редактор ресурсов.JPG|120px|thumb|left|описание]]
[[Файл:Предпросмотр.JPG‎|120px|thumb|left|описание]]
 

* По логике в списке сначала должен идти параметр, а потом его значение.--[[Участник:Avereskun|Avereskun]] 10:06, 25 января 2013 (CET)

[[Файл:Editor123.jpg]]

== Новые объекты и свойства==

* Добавить сплайн (кривая линия), который можно рисовать на сцене и передавать команде move [[Участник:Steps|Steps]] 14:11, 24 января 2013 (CET)
- изучение возможности
* Добавить в редактор генератор комиксов. Хорошим и простым примером является [http://1001mem.ru/create_comics генератор комиков] Это пожелания на будущее. --[[Участник:Dorl|Dorl]] 10:35, 25 января 2013 (CET)

== Баги ==
* Переместив картинку из редактора ресурсов на сцену, в свойствах она имеет по умолчанию тип '''image'''. Меняя тип '''image''' на '''machine''' иконка в дереве остается по-прежнему '''image''' до первого клика. Необходимо сделать мгновенную смену иконки в дереве. 
[[Файл:Машина.JPG‎ ]]

MEGEDIT-1102 - не срочно
 

== Реализовано ==

Книга жалоб и пожеланий

2013-01-25T11:15:08Z

Steps:

Внимание !!
* Перед публикацией внимательно читать ВСЕ!
* Делаем при обсуждении отступы (двоеточие) и подписываемся (4 тильды).

== Улучшение интерфейса ==

* Возможность копирования состояний из машины в машину.--[[Участник:Oilich|Oilich]] 13:36, 24 января 2013 (CET)
* Поворачивать, масштабировать объекты прямо на сцене (как в любом граф.редакторе) [[Участник:Steps|Steps]] 14:11, 24 января 2013 (CET)
* Добавить горячие клавиши в состоянии машин. В выбранном состоянии машины, например если нажать "w" создается ф-я wait, "i"=if, "m" = move, "s" = set ну и так далее. --[[Участник:Igood|Igood]] 16:10, 24 января 2013 (CET)
:: С какой клавишей использовать CTRL +S сохранение + давайте уже весь список хоткеев. Проще разнести и реализовать.\

* Возможность копирования ф-й(set,wait...) из одного состояния машины в другую.--[[Участник:Igood|Igood]] 16:12, 24 января 2013 (CET)
:: В чем отличие от "Возможность копирования состояний из машины в машину.--[[Участник:Oilich|Oilich]] 13:36, 24 января 2013 (CET)"
::: В том что это не состояния а отдельные функции в состоянии.--[[Участник:Igood|Igood]] 08:53, 25 января 2013 (CET)
:::: я поддерживаю. мелочь, а приятно. [[Участник:Steps|Steps]] 12:13, 25 января 2013 (CET)

* Добавить событие кнопке, изм. состояния объекта если на нее нажали в состоянии disable.--[[Участник:Igood|Igood]] 16:18, 24 января 2013 (CET)

:: С точки зрения кнопки - Она "Кнопка" имеет два состояния, в состоянии disable кнопка не должна вообще воспринимать кликов. Но если всех это не запутает и нужно для космического корабля то ОК--[[Участник:Boyarin|Boyarin]] 21:45, 24 января 2013 (CET)

* Редактор ресурсов. При загрузке картинок в редактор ресурсов, хотелось бы иметь возможность видеть превью картинок.
[[Файл:Редактор ресурсов.JPG|120px|thumb|left|описание]]
[[Файл:Предпросмотр.JPG‎|120px|thumb|left|описание]]
 

* По логике в списке сначала должен идти параметр, а потом его значение.--[[Участник:Avereskun|Avereskun]] 10:06, 25 января 2013 (CET)

[[Файл:Editor123.jpg]]

== Новые объекты и свойства==

* Добавить сплайн (кривая линия), который можно рисовать на сцене и передавать команде move [[Участник:Steps|Steps]] 14:11, 24 января 2013 (CET)
- изучение возможности
* Добавить в редактор генератор комиксов. Хорошим и простым примером является [http://1001mem.ru/create_comics генератор комиков] Это пожелания на будущее. --[[Участник:Dorl|Dorl]] 10:35, 25 января 2013 (CET)

== Баги ==
* Переместив картинку из редактора ресурсов на сцену, в свойствах она имеет по умолчанию тип '''image'''. Меняя тип '''image''' на '''machine''' иконка в дереве остается по-прежнему '''image''' до первого клика. Необходимо сделать мгновенную смену иконки в дереве. 
[[Файл:Машина.JPG‎ ]]

MEGEDIT-1102 - не срочно
 

== Реализовано ==

Книга жалоб и пожеланий

2013-01-25T11:13:53Z

Steps: /* Улучшение интерфейса */

Внимание !!
Перед публикацией внимательно читать ВСЕ!

== Улучшение интерфейса ==

* Возможность копирования состояний из машины в машину.--[[Участник:Oilich|Oilich]] 13:36, 24 января 2013 (CET)
* Поворачивать, масштабировать объекты прямо на сцене (как в любом граф.редакторе) [[Участник:Steps|Steps]] 14:11, 24 января 2013 (CET)
* Добавить горячие клавиши в состоянии машин. В выбранном состоянии машины, например если нажать "w" создается ф-я wait, "i"=if, "m" = move, "s" = set ну и так далее. --[[Участник:Igood|Igood]] 16:10, 24 января 2013 (CET)
:: С какой клавишей использовать CTRL +S сохранение + давайте уже весь список хоткеев. Проще разнести и реализовать.\

* Возможность копирования ф-й(set,wait...) из одного состояния машины в другую.--[[Участник:Igood|Igood]] 16:12, 24 января 2013 (CET)
:: В чем отличие от "Возможность копирования состояний из машины в машину.--[[Участник:Oilich|Oilich]] 13:36, 24 января 2013 (CET)"
::: В том что это не состояния а отдельные функции в состоянии.--[[Участник:Igood|Igood]] 08:53, 25 января 2013 (CET)
:::: я поддерживаю. мелочь, а приятно. [[Участник:Steps|Steps]] 12:13, 25 января 2013 (CET)

* Добавить событие кнопке, изм. состояния объекта если на нее нажали в состоянии disable.--[[Участник:Igood|Igood]] 16:18, 24 января 2013 (CET)

:: С точки зрения кнопки - Она "Кнопка" имеет два состояния, в состоянии disable кнопка не должна вообще воспринимать кликов. Но если всех это не запутает и нужно для космического корабля то ОК--[[Участник:Boyarin|Boyarin]] 21:45, 24 января 2013 (CET)

* Редактор ресурсов. При загрузке картинок в редактор ресурсов, хотелось бы иметь возможность видеть превью картинок.
[[Файл:Редактор ресурсов.JPG|120px|thumb|left|описание]]
[[Файл:Предпросмотр.JPG‎|120px|thumb|left|описание]]
 

* По логике в списке сначала должен идти параметр, а потом его значение.--[[Участник:Avereskun|Avereskun]] 10:06, 25 января 2013 (CET)

[[Файл:Editor123.jpg]]

== Новые объекты и свойства==

* Добавить сплайн (кривая линия), который можно рисовать на сцене и передавать команде move [[Участник:Steps|Steps]] 14:11, 24 января 2013 (CET)
- изучение возможности
* Добавить в редактор генератор комиксов. Хорошим и простым примером является [http://1001mem.ru/create_comics генератор комиков] Это пожелания на будущее. --[[Участник:Dorl|Dorl]] 10:35, 25 января 2013 (CET)

== Баги ==
* Переместив картинку из редактора ресурсов на сцену, в свойствах она имеет по умолчанию тип '''image'''. Меняя тип '''image''' на '''machine''' иконка в дереве остается по-прежнему '''image''' до первого клика. Необходимо сделать мгновенную смену иконки в дереве. 
[[Файл:Машина.JPG‎ ]]

MEGEDIT-1102 - не срочно
 

== Реализовано ==

Книга жалоб и пожеланий

2013-01-25T11:13:09Z

Steps: /* Улучшение интерфейса */ форматирование. делаем отступы, подписываемся

Внимание !!
Перед публикацией внимательно читать ВСЕ!

== Улучшение интерфейса ==

* Возможность копирования состояний из машины в машину.--[[Участник:Oilich|Oilich]] 13:36, 24 января 2013 (CET)
* Поворачивать, масштабировать объекты прямо на сцене (как в любом граф.редакторе) [[Участник:Steps|Steps]] 14:11, 24 января 2013 (CET)
* Добавить горячие клавиши в состоянии машин. В выбранном состоянии машины, например если нажать "w" создается ф-я wait, "i"=if, "m" = move, "s" = set ну и так далее. --[[Участник:Igood|Igood]] 16:10, 24 января 2013 (CET)
:: С какой клавишей использовать CTRL +S сохранение + давайте уже весь список хоткеев. Проще разнести и реализовать.\

* Возможность копирования ф-й(set,wait...) из одного состояния машины в другую.--[[Участник:Igood|Igood]] 16:12, 24 января 2013 (CET)
:: В чем отличие от "Возможность копирования состояний из машины в машину.--[[Участник:Oilich|Oilich]] 13:36, 24 января 2013 (CET)"
::: В том что это не состояния а отдельные функции в состоянии.--[[Участник:Igood|Igood]] 08:53, 25 января 2013 (CET)
:::: я поддерживаю. мелочь, а приятно.

* Добавить событие кнопке, изм. состояния объекта если на нее нажали в состоянии disable.--[[Участник:Igood|Igood]] 16:18, 24 января 2013 (CET)

:: С точки зрения кнопки - Она "Кнопка" имеет два состояния, в состоянии disable кнопка не должна вообще воспринимать кликов. Но если всех это не запутает и нужно для космического корабля то ОК--[[Участник:Boyarin|Boyarin]] 21:45, 24 января 2013 (CET)

* Редактор ресурсов. При загрузке картинок в редактор ресурсов, хотелось бы иметь возможность видеть превью картинок.
[[Файл:Редактор ресурсов.JPG|120px|thumb|left|описание]]
[[Файл:Предпросмотр.JPG‎|120px|thumb|left|описание]]
 

* По логике в списке сначала должен идти параметр, а потом его значение.--[[Участник:Avereskun|Avereskun]] 10:06, 25 января 2013 (CET)

[[Файл:Editor123.jpg]]

== Новые объекты и свойства==

* Добавить сплайн (кривая линия), который можно рисовать на сцене и передавать команде move [[Участник:Steps|Steps]] 14:11, 24 января 2013 (CET)
- изучение возможности
* Добавить в редактор генератор комиксов. Хорошим и простым примером является [http://1001mem.ru/create_comics генератор комиков] Это пожелания на будущее. --[[Участник:Dorl|Dorl]] 10:35, 25 января 2013 (CET)

== Баги ==
* Переместив картинку из редактора ресурсов на сцену, в свойствах она имеет по умолчанию тип '''image'''. Меняя тип '''image''' на '''machine''' иконка в дереве остается по-прежнему '''image''' до первого клика. Необходимо сделать мгновенную смену иконки в дереве. 
[[Файл:Машина.JPG‎ ]]

MEGEDIT-1102 - не срочно
 

== Реализовано ==

Книга жалоб и пожеланий

2013-01-24T18:31:49Z

Steps: /* Улучшение интерфейса */

== Улучшение интерфейса ==

* Возможность копирования состояний из машины в машину.--[[Участник:Oilich|Oilich]] 13:36, 24 января 2013 (CET)
* Поворачивать, масштабировать объекты прямо на сцене (как в любом граф.редакторе) [[Участник:Steps|Steps]] 14:11, 24 января 2013 (CET)
* Добавить горячие клавиши в состоянии машин. В выбранном состоянии машины, например если нажать "w" создается ф-я wait, "i"=if, "m" = move, "s" = set ну и так далее. --[[Участник:Igood|Igood]] 16:10, 24 января 2013 (CET)
* Возможность копирования ф-й(set,wait...) из одного состояния машины в другую.--[[Участник:Igood|Igood]] 16:12, 24 января 2013 (CET)
* Добавить событие кнопке, изм. состояния объекта если на нее нажали в состоянии disable.--[[Участник:Igood|Igood]] 16:18, 24 января 2013 (CET)

== Новые объекты ==

* Добавить сплайн (кривая линия), который можно рисовать на сцене и передавать команде move [[Участник:Steps|Steps]] 14:11, 24 января 2013 (CET)

== Баги ==
* Переместив картинку из редактора ресурсов на сцену, в свойствах она имеет по умолчанию тип '''image'''. Меняя тип '''image''' на '''machine''' иконка в дереве остается по-прежнему '''image''' до первого клика. Необходимо сделать мгновенную смену иконки в дереве. 
[[Файл:Машина.JPG‎ ]]

 

== Реализовано ==

Книга жалоб и пожеланий

2013-01-24T13:13:42Z

Steps:

Книга жалоб и пожеланий

2013-01-24T13:11:29Z

Steps:

Пожелания:

* Возможность копирования состояний из машины в машину.--[[Участник:Oilich|Oilich]] 13:36, 24 января 2013 (CET)
* Поворачивать, масштабировать объекты прямо на сцене (как в любом граф.редакторе) [[Участник:Steps|Steps]] 14:11, 24 января 2013 (CET)
* Добавить сплайн (кривая линия), который можно рисовать на сцене и передавать команде move [[Участник:Steps|Steps]] 14:11, 24 января 2013 (CET)

Книга жалоб и пожеланий

2013-01-24T13:08:04Z

Steps:

Пожелания:

* Возможность копирования состояний из машины в машину.--[[Участник:Oilich|Oilich]] 13:36, 24 января 2013 (CET)

MediaWiki:Sidebar

2013-01-24T13:07:49Z

Steps:

Machine

2013-01-23T20:17:42Z

Steps: /* if */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''[[#Инициализация|Инициализация]]''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки.
* '''[[#Процессы|Процессы]]''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение.
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу. Для разных команд использование этого параметра несколько '''отличается'''!

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При попадании в состояние, сразу выполняются команды инициализации init, draw, set, buy, var. Если в этих командах нет параметра break, они все выполняются до запуска процессов. Параметр break (со значением 1) прерывает выполнение команд инициализации данного типа. Их можно перезапустить по окончанию команд процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов);
* '''f''' - начальный кадр;
* '''ft''' - длительность кадра в миллисекундах;
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз;
* '''go''' - перейти в состояние;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия перехода; можно использовать логические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).
Для работы loop '''необходимо''' чтобы в редакторе ресурсов в настройках анимации '''было отключено''' зацикливание(looped).

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды [[#if|if]] при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов);
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов);
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов);
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом;
*'''loop''' - зациклить звук (звуки);
*'''mus_stop''' - остановить текущую музыку;
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии;
*'''if''' - номер (начиная с нуля) условия перехода [[#if|if]].

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной;
*'''obj''' - объект, используемый далее;
*'''par''' - имя параметра, значение которого присваивается переменной;
*'''val''' - значение переменной, если отсутствуют obj и par.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

Если в команде процесса есть условие '''[[#if|if]]''', то после окончания работы команды она ждет пока это условие не выполнится. Только после этого переходит к следующей команде этого же типа
или в другое состояние (если есть параметр go).
Исключением является команда wait, которая '''не''' ждёт срабатывания '''[[#if|if]]'''. Если он по окончанию wait сработал, то происходит переходит в другое состояние, если есть параметр go.
Если параметра go нет, то в любом случае запускается следующий wait (т.е. if относится только к переходу go).

=== wait ===

Команда паузы (временной задержки). Если параметра '''t''' нет, то срабатывает сразу.
Может также использоваться для логических ветвлений, случайных переходов в другие состояния и т.д.

* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект;
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются); можно задавать смесь tx, dy или dx,ty;
* '''v''' - скороcть перемещения в пикселях в секунду; для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость;
* '''t''' - время перемещения (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду move, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта;
* '''da''' - на сколько надо повернуться (ta игнорируется);
* '''v''' - угловая скорость поворота в градусах в секунду;
* '''t''' - время поворота (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду rot, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду alpha, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду scale, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду phys, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]] разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

В состоянии может быть произвольное число команд if. Их номера (начиная с нуля) указываются
в параметре if других команд. Эти номера можно соединять при помощи логических связок:
* '''&''' - логическое '''и''' (вместо значка '''&''' можно использовать запятую ''',''');
* '''|''' - логическое '''или''';
* '''!''' - логическое '''не'''.
Пример записи логического выражения в поле if некоторой команды: '''(1&2)|(3&(!4))''',
что означает: выполняется if под номером 1 и под номером 2, или под номером 3 и не под номером 4.

Логические связки используются также как математической логике или любом языке программирования.
Так:
* A '''&''' B - истинно, если истинны оба условия A и B;
* A '''|''' B - истинно, если истинно хотя бы одно условие (или оба);
* '''!''' А - истинно, если условие A ложно.
Скобки в логическом выражении определяют приоритет (порядок) выполнения логических операций.
Отметим несколько тождеств, справедливых при формировании логических высказываний:
* !(A & B) = (!A) | (!B)
* !(A | B) = (!A) & (!B)
* !(!A) = A

Если при формировании условия (ниже) есть несколько проверок, то они соединены логическим '''и'''.
Т.е., если хотя бы одна из них не выполняется, то считается, что условие не выполнилось.

Параметры команды:
* '''obj''' - находится ли объект obj в состоянии st или имеет ли его параметр par значение val;
* '''st''' - имя состояния в котором может находиться объект obj;
* '''par''' - имя параметра объекта obj, значение которого сравнивается с полем val;
* '''val''' - значение параметра par, которое проверяется у объекта obj;
* '''op''' - операция сравнения par op val. Если опреации нет, то предполагается проверка на равенство par=val. Иначе используются операторы:
** '''<''' - меньше (par < val);
** '''>''' - больше (par > val);
** '''!=''' - не равно (par != val);
** '''<>''' - не равно (par <> val);
** '''>=''' - больше или равно (par >= val);
** '''<=''' - меньше или равно (par <= val);
* '''curScr''' - если текущий экран совпадает с этим, то условие выполнилось;
* '''prScr''' - если предыдущий экран совпадает с этим, то условие выполнилось;
* '''wasScr''' - если был (когда либо) этот экран, то условие выполнилось.
* '''buy''' - был ли куплен данный inn-app (проверяется флаг поля в объекте [[Options]]);
* '''url''' - валиден (правилен и может быть запущен) ли данный интернет-адрес;
* '''is_mus''' - играет ли сейчас музыка (значение 1);
* '''guest''' - объект который установил состояние (используется вместо параметра obj). Если указанный объект не менял состояние этой машины, то условие не срабатывает.

Если использовать obj, par, val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.
Если же использовать obj, par, op, val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записанного в поле val.

Machine

2013-01-23T20:11:53Z

Steps: /* if */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''[[#Инициализация|Инициализация]]''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки.
* '''[[#Процессы|Процессы]]''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение.
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу. Для разных команд использование этого параметра несколько '''отличается'''!

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При попадании в состояние, сразу выполняются команды инициализации init, draw, set, buy, var. Если в этих командах нет параметра break, они все выполняются до запуска процессов. Параметр break (со значением 1) прерывает выполнение команд инициализации данного типа. Их можно перезапустить по окончанию команд процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов);
* '''f''' - начальный кадр;
* '''ft''' - длительность кадра в миллисекундах;
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз;
* '''go''' - перейти в состояние;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия перехода; можно использовать логические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).
Для работы loop '''необходимо''' чтобы в редакторе ресурсов в настройках анимации '''было отключено''' зацикливание(looped).

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды [[#if|if]] при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов);
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов);
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов);
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом;
*'''loop''' - зациклить звук (звуки);
*'''mus_stop''' - остановить текущую музыку;
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии;
*'''if''' - номер (начиная с нуля) условия перехода [[#if|if]].

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной;
*'''obj''' - объект, используемый далее;
*'''par''' - имя параметра, значение которого присваивается переменной;
*'''val''' - значение переменной, если отсутствуют obj и par.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

Если в команде процесса есть условие '''[[#if|if]]''', то после окончания работы команды она ждет пока это условие не выполнится. Только после этого переходит к следующей команде этого же типа
или в другое состояние (если есть параметр go).
Исключением является команда wait, которая '''не''' ждёт срабатывания '''[[#if|if]]'''. Если он по окончанию wait сработал, то происходит переходит в другое состояние, если есть параметр go.
Если параметра go нет, то в любом случае запускается следующий wait (т.е. if относится только к переходу go).

=== wait ===

Команда паузы (временной задержки). Если параметра '''t''' нет, то срабатывает сразу.
Может также использоваться для логических ветвлений, случайных переходов в другие состояния и т.д.

* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект;
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются); можно задавать смесь tx, dy или dx,ty;
* '''v''' - скороcть перемещения в пикселях в секунду; для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость;
* '''t''' - время перемещения (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду move, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта;
* '''da''' - на сколько надо повернуться (ta игнорируется);
* '''v''' - угловая скорость поворота в градусах в секунду;
* '''t''' - время поворота (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду rot, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду alpha, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду scale, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду phys, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]] разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

В состоянии может быть произвольное число команд if. Их номера (начиная с нуля) указываются
в параметре if других команд. Эти номера можно соединять при помощи логических связок:
* '''&''' - логическое '''и''' (можно использовать запятую ''',''');
* '''|''' - логическое '''или''';
* '''!''' - логическое '''не'''.
Пример записи логического выражения в поле if некоторой команды: '''(1&2)|(3&(!4))''',
что означает: выполняется if под номером 1 и под номером 2, или под номером 3 и не под номером 4.

Логические связки используются также как математической логике или любом языке программирования.
Так:
* A '''&''' B - истинно, если истинны оба условия A и B;
* A '''|''' B - истинно, если истинно хотя бы одно условие (или оба);
* '''!''' А - истинно, если условие A ложно.
Скобки в логическом выражении определяют приоритет (порядок) выполнения логических операций.
Отметим несколько тождеств, справедливых при формировании логических высказываний:
* !(A & B) = (!A) | (!B)
* !(A | B) = (!A) & (!B)
* !(!A) = A

Если при формировании условия (ниже) есть несколько проверок, то они соединены логическим '''и'''.
Т.е., если хотя бы одна из них не выполняется, то считается, что условие не выполнилось.

Параметры команды:
* '''obj''' - находится ли объект obj в состоянии st или имеет ли его параметр par значение val;
* '''st''' - имя состояния в котором может находиться объект obj;
* '''par''' - имя параметра объекта obj, значение которого сравнивается с полем val;
* '''val''' - значение параметра par, которое проверяется у объекта obj;
* '''op''' - операция сравнения par op val. Если опреации нет, то предполагается проверка на равенство par=val. Иначе используются операторы:
** '''<''' - меньше (par < val)
** '''>''' - больше (par > val)
** '''!=''' - не равно (par != val)
** '''<>''' - не равно (par <> val)
** '''>=''' - больше или равно (par >= val)
** '''<=''' - меньше или равно (par <= val)
* '''curScr''' - если текущий экран совпадает с этим, то условие выполнилось;
* '''prScr''' - если предыдущий экран совпадает с этим, то условие выполнилось;
* '''wasScr''' - если был (когда либо) этот экран, то условие выполнилось.
* '''buy''' - был ли куплен данный inn-app (проверяется флаг поля в объекте [[Options]]);
* '''url''' - валиден (правилен и может быть запущен) ли данный интернет-адрес;
* '''is_mus''' - играет ли сейчас музыка (значение 1);
* '''guest''' - объект который установил состояние (используется вместо параметра obj). Если указанный объект не менял состояние этой машины, то условие не срабатывает.

Если использовать obj, par, val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj, par, op, val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записанного в поле val.

Обсуждение:Machine

2013-01-23T19:51:50Z

Steps: /* play */

Некоторые замечания по синтаксису машин состояний [[Участник:Steps|Steps]] 16:19, 23 января 2013 (CET):
=== draw ===
* Зачем параметр '''go''' в командах инициализации?
* Сейчас параметр '''if''' бестолково работает в команде '''draw'''. Хоть срабатывает условие, хоть нет, происходит переход к следующему draw. Можно if-ом только один раз перебить ресурс из свойств. Лучше, чтобы if работал также, как и в команде set (т.е. если if сработал, установить этот ресурс, иначе - нет; и затем в любом случае перейти к следующим командам draw).
* В анимации не работает '''loop''' и '''ft'''.

=== init ===
* Почему нет параметра if, аналогично команде set?
* Последние 7 параметров меняют другие машины, объекты и по-логике должны находиться к команде '''set'''.

=== play ===
* Непонятен параметр if (перехода нет). Его надо интерпретировать аналогично команде set?

=== buy ===
* Добавить параметр if, аналогично команде set.

=== wait ===
* Если есть только одна команда wait, то '''loop''' в ней не срабатывает.

=== if ===
* Добавить параметр '''go'''. Тогда можно переходы-ветвления делать не из wait, а не посредственно из if. Будет короче и понятнее.

Machine

2013-01-23T19:40:41Z

Steps: /* if */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''[[#Инициализация|Инициализация]]''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки.
* '''[[#Процессы|Процессы]]''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение.
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу. Для разных команд использование этого параметра несколько '''отличается'''!

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При попадании в состояние, сразу выполняются команды инициализации init, draw, set, buy, var. Если в этих командах нет параметра break, они все выполняются до запуска процессов. Параметр break (со значением 1) прерывает выполнение команд инициализации данного типа. Их можно перезапустить по окончанию команд процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов);
* '''f''' - начальный кадр;
* '''ft''' - длительность кадра в миллисекундах;
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз;
* '''go''' - перейти в состояние;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия перехода; можно использовать логические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).
Для работы loop '''необходимо''' чтобы в редакторе ресурсов в настройках анимации '''было отключено''' зацикливание(looped).

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды [[#if|if]] при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов);
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов);
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов);
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом;
*'''loop''' - зациклить звук (звуки);
*'''mus_stop''' - остановить текущую музыку;
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии;
*'''if''' - номер (начиная с нуля) условия перехода [[#if|if]].

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной;
*'''obj''' - объект, используемый далее;
*'''par''' - имя параметра, значение которого присваивается переменной;
*'''val''' - значение переменной, если отсутствуют obj и par.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

Если в команде процесса есть условие '''[[#if|if]]''', то после окончания работы команды она ждет пока это условие не выполнится. Только после этого переходит к следующей команде этого же типа
или в другое состояние (если есть параметр go).
Исключением является команда wait, которая '''не''' ждёт срабатывания '''[[#if|if]]'''. Если он по окончанию wait сработал, то происходит переходит в другое состояние, если есть параметр go.
Если параметра go нет, то в любом случае запускается следующий wait (т.е. if относится только к переходу go).

=== wait ===

Команда паузы (временной задержки). Если параметра '''t''' нет, то срабатывает сразу.
Может также использоваться для логических ветвлений, случайных переходов в другие состояния и т.д.

* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект;
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются); можно задавать смесь tx, dy или dx,ty;
* '''v''' - скороcть перемещения в пикселях в секунду; для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость;
* '''t''' - время перемещения (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду move, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта;
* '''da''' - на сколько надо повернуться (ta игнорируется);
* '''v''' - угловая скорость поворота в градусах в секунду;
* '''t''' - время поворота (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду rot, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду alpha, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду scale, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду phys, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]] разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

В состоянии может быть произвольное число команд if. Их номера (начиная с нуля) указываются
в параметре if других команд. Эти номера можно соединять при помощи логических связок:
* '''&''' - логическое '''и''' (можно использовать запятую ''',''');
* '''|''' - логическое '''или''';
* '''!''' - логическое '''не'''.
Пример записи логического выражения в поле if некоторой команды: '''(1&2)|(3&(!4))''',
что означает: выполняется if под номером 1 и под номером 2, или под номером 3 и не под номером 4.

Параметры команды:
* '''obj''' - находится ли объект obj в состоянии st или имеет ли его параметр par значение val;
* '''st''' - имя состояния в котором может находиться объект obj;
* '''par''' - имя параметра объекта obj, значение которого сравнивается с полем val;
* '''val''' - значение параметра par, которое проверяется у объекта obj;
* '''op''' - операция сравнения par op val. Если опреации нет, то предполагается проверка на равенство par=val. Иначе используются операторы:
** '''<''' - меньше (par < val)
** '''>''' - больше (par > val)
** '''!=''' - не равно (par != val)
** '''<>''' - не равно (par <> val)
** '''>=''' - больше или равно (par >= val)
** '''<=''' - меньше или равно (par <= val)
* '''curScr''' - если текущий экран совпадает с этим, то условие выполнилось;
* '''prScr''' - если предыдущий экран совпадает с этим, то условие выполнилось;
* '''wasScr''' - если был (когда либо) этот экран, то условие выполнилось.
* '''buy''' - совершена ли покупка;
* '''guest''' - объект который установил состояние;

Если использовать obj, par, val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj, par, op, val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записанного в поле val.

Machine

2013-01-23T19:37:09Z

Steps: /* if */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''[[#Инициализация|Инициализация]]''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки.
* '''[[#Процессы|Процессы]]''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение.
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу. Для разных команд использование этого параметра несколько '''отличается'''!

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При попадании в состояние, сразу выполняются команды инициализации init, draw, set, buy, var. Если в этих командах нет параметра break, они все выполняются до запуска процессов. Параметр break (со значением 1) прерывает выполнение команд инициализации данного типа. Их можно перезапустить по окончанию команд процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов);
* '''f''' - начальный кадр;
* '''ft''' - длительность кадра в миллисекундах;
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз;
* '''go''' - перейти в состояние;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия перехода; можно использовать логические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).
Для работы loop '''необходимо''' чтобы в редакторе ресурсов в настройках анимации '''было отключено''' зацикливание(looped).

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды [[#if|if]] при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов);
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов);
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов);
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом;
*'''loop''' - зациклить звук (звуки);
*'''mus_stop''' - остановить текущую музыку;
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии;
*'''if''' - номер (начиная с нуля) условия перехода [[#if|if]].

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной;
*'''obj''' - объект, используемый далее;
*'''par''' - имя параметра, значение которого присваивается переменной;
*'''val''' - значение переменной, если отсутствуют obj и par.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

Если в команде процесса есть условие '''[[#if|if]]''', то после окончания работы команды она ждет пока это условие не выполнится. Только после этого переходит к следующей команде этого же типа
или в другое состояние (если есть параметр go).
Исключением является команда wait, которая '''не''' ждёт срабатывания '''[[#if|if]]'''. Если он по окончанию wait сработал, то происходит переходит в другое состояние, если есть параметр go.
Если параметра go нет, то в любом случае запускается следующий wait (т.е. if относится только к переходу go).

=== wait ===

Команда паузы (временной задержки). Если параметра '''t''' нет, то срабатывает сразу.
Может также использоваться для логических ветвлений, случайных переходов в другие состояния и т.д.

* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект;
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются); можно задавать смесь tx, dy или dx,ty;
* '''v''' - скороcть перемещения в пикселях в секунду; для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость;
* '''t''' - время перемещения (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду move, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта;
* '''da''' - на сколько надо повернуться (ta игнорируется);
* '''v''' - угловая скорость поворота в градусах в секунду;
* '''t''' - время поворота (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду rot, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду alpha, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду scale, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду phys, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]] разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

В состоянии может быть произвольное число команд if. Их номера (начиная с нуля) указываются
в параметре if других команд. Эти номера можно соединять при помощи логических связок:
* '''&''' - логическое '''и''' (можно использовать запятую ''',''');
* '''|''' - логическое '''или''';
* '''!''' - логическое '''не'''.
Пример записи логического выражения в поле if некоторой команды: '''(1&2)|(3&(!4))''',
что означает: выполняется if под номером 1 и под номером 2, или под номером 3 и не под номером 4.

Параметры команды:
* '''obj''' - находится ли объект obj в состоянии st или имеет ли его параметр par значение val;
* '''st''' - имя состояния в котором может находиться объект obj;
* '''par''' - имя параметра объекта obj, значение которого сравнивается с полем val;
* '''val''' - значение параметра par, которое проверяется у объекта obj;
* '''op''' - операция сравнения par op val. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''curScr''' - если текущий экран совпадает с этим, то условие выполнилось;
* '''prScr''' - если предыдущий экран совпадает с этим, то условие выполнилось;
* '''wasScr''' - если был (когда либо) этот экран, то условие выполнилось.
* '''buy''' - совершена ли покупка;
* '''guest''' - объект который установил состояние;

Если использовать obj, par, val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj, par, op, val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записанного в поле val.

Machine

2013-01-23T19:23:26Z

Steps: /* Введение */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''[[#Инициализация|Инициализация]]''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки.
* '''[[#Процессы|Процессы]]''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение.
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу. Для разных команд использование этого параметра несколько '''отличается'''!

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При попадании в состояние, сразу выполняются команды инициализации init, draw, set, buy, var. Если в этих командах нет параметра break, они все выполняются до запуска процессов. Параметр break (со значением 1) прерывает выполнение команд инициализации данного типа. Их можно перезапустить по окончанию команд процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов);
* '''f''' - начальный кадр;
* '''ft''' - длительность кадра в миллисекундах;
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз;
* '''go''' - перейти в состояние;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия перехода; можно использовать логические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).
Для работы loop '''необходимо''' чтобы в редакторе ресурсов в настройках анимации '''было отключено''' зацикливание(looped).

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды [[#if|if]] при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов);
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов);
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов);
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом;
*'''loop''' - зациклить звук (звуки);
*'''mus_stop''' - остановить текущую музыку;
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии;
*'''if''' - номер (начиная с нуля) условия перехода [[#if|if]].

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной;
*'''obj''' - объект, используемый далее;
*'''par''' - имя параметра, значение которого присваивается переменной;
*'''val''' - значение переменной, если отсутствуют obj и par.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

Если в команде процесса есть условие '''[[#if|if]]''', то после окончания работы команды она ждет пока это условие не выполнится. Только после этого переходит к следующей команде этого же типа
или в другое состояние (если есть параметр go).
Исключением является команда wait, которая '''не''' ждёт срабатывания '''[[#if|if]]'''. Если он по окончанию wait сработал, то происходит переходит в другое состояние, если есть параметр go.
Если параметра go нет, то в любом случае запускается следующий wait (т.е. if относится только к переходу go).

=== wait ===

Команда паузы (временной задержки). Если параметра '''t''' нет, то срабатывает сразу.
Может также использоваться для логических ветвлений, случайных переходов в другие состояния и т.д.

* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект;
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются); можно задавать смесь tx, dy или dx,ty;
* '''v''' - скороcть перемещения в пикселях в секунду; для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость;
* '''t''' - время перемещения (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду move, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта;
* '''da''' - на сколько надо повернуться (ta игнорируется);
* '''v''' - угловая скорость поворота в градусах в секунду;
* '''t''' - время поворота (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду rot, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду alpha, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду scale, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду phys, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]] разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

В состоянии может быть произвольное число команд if. Их номера (начиная с нуля) указываются
в параметре if других команд. Эти номера можно соединять при помощи логических связок:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if некоторой команды: '''(1&2)|(3&(!4))''',
что означает: выполняется if под номером 1 и под номером 2, или под номером 3 и не под номером 4.

Параметры команды:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

Machine

2013-01-23T19:19:59Z

Steps: /* draw */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''[[#Инициализация|Инициализация]]''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки.
* '''[[#Процессы|Процессы]]''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение.
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При попадании в состояние, сразу выполняются команды инициализации init, draw, set, buy, var. Если в этих командах нет параметра break, они все выполняются до запуска процессов. Параметр break (со значением 1) прерывает выполнение команд инициализации данного типа. Их можно перезапустить по окончанию команд процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов);
* '''f''' - начальный кадр;
* '''ft''' - длительность кадра в миллисекундах;
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз;
* '''go''' - перейти в состояние;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия перехода; можно использовать логические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).
Для работы loop '''необходимо''' чтобы в редакторе ресурсов в настройках анимации '''было отключено''' зацикливание(looped).

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды [[#if|if]] при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов);
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов);
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов);
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом;
*'''loop''' - зациклить звук (звуки);
*'''mus_stop''' - остановить текущую музыку;
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии;
*'''if''' - номер (начиная с нуля) условия перехода [[#if|if]].

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной;
*'''obj''' - объект, используемый далее;
*'''par''' - имя параметра, значение которого присваивается переменной;
*'''val''' - значение переменной, если отсутствуют obj и par.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

Если в команде процесса есть условие '''[[#if|if]]''', то после окончания работы команды она ждет пока это условие не выполнится. Только после этого переходит к следующей команде этого же типа
или в другое состояние (если есть параметр go).
Исключением является команда wait, которая '''не''' ждёт срабатывания '''[[#if|if]]'''. Если он по окончанию wait сработал, то происходит переходит в другое состояние, если есть параметр go.
Если параметра go нет, то в любом случае запускается следующий wait (т.е. if относится только к переходу go).

=== wait ===

Команда паузы (временной задержки). Если параметра '''t''' нет, то срабатывает сразу.
Может также использоваться для логических ветвлений, случайных переходов в другие состояния и т.д.

* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект;
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются); можно задавать смесь tx, dy или dx,ty;
* '''v''' - скороcть перемещения в пикселях в секунду; для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость;
* '''t''' - время перемещения (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду move, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта;
* '''da''' - на сколько надо повернуться (ta игнорируется);
* '''v''' - угловая скорость поворота в градусах в секунду;
* '''t''' - время поворота (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду rot, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду alpha, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду scale, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду phys, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]] разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

В состоянии может быть произвольное число команд if. Их номера (начиная с нуля) указываются
в параметре if других команд. Эти номера можно соединять при помощи логических связок:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if некоторой команды: '''(1&2)|(3&(!4))''',
что означает: выполняется if под номером 1 и под номером 2, или под номером 3 и не под номером 4.

Параметры команды:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

Machine

2013-01-23T19:16:05Z

Steps: /* Процессы */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''[[#Инициализация|Инициализация]]''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки.
* '''[[#Процессы|Процессы]]''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение.
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При попадании в состояние, сразу выполняются команды инициализации init, draw, set, buy, var. Если в этих командах нет параметра break, они все выполняются до запуска процессов. Параметр break (со значением 1) прерывает выполнение команд инициализации данного типа. Их можно перезапустить по окончанию команд процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов);
* '''f''' - начальный кадр;
* '''ft''' - длительность кадра в миллисекундах;
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз;
* '''go''' - перейти в состояние;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия перехода; можно использовать лагические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).
Для работы loop '''необходимо''' чтобы в редакторе ресурсов в настройках анимации '''было отключено''' зацикливание(looped).

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды [[#if|if]] при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов);
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов);
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов);
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом;
*'''loop''' - зациклить звук (звуки);
*'''mus_stop''' - остановить текущую музыку;
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии;
*'''if''' - номер (начиная с нуля) условия перехода [[#if|if]].

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной;
*'''obj''' - объект, используемый далее;
*'''par''' - имя параметра, значение которого присваивается переменной;
*'''val''' - значение переменной, если отсутствуют obj и par.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

Если в команде процесса есть условие '''[[#if|if]]''', то после окончания работы команды она ждет пока это условие не выполнится. Только после этого переходит к следующей команде этого же типа
или в другое состояние (если есть параметр go).
Исключением является команда wait, которая '''не''' ждёт срабатывания '''[[#if|if]]'''. Если он по окончанию wait сработал, то происходит переходит в другое состояние, если есть параметр go.
Если параметра go нет, то в любом случае запускается следующий wait (т.е. if относится только к переходу go).

=== wait ===

Команда паузы (временной задержки). Если параметра '''t''' нет, то срабатывает сразу.
Может также использоваться для логических ветвлений, случайных переходов в другие состояния и т.д.

* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект;
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются); можно задавать смесь tx, dy или dx,ty;
* '''v''' - скороcть перемещения в пикселях в секунду; для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость;
* '''t''' - время перемещения (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду move, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта;
* '''da''' - на сколько надо повернуться (ta игнорируется);
* '''v''' - угловая скорость поворота в градусах в секунду;
* '''t''' - время поворота (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду rot, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду alpha, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду scale, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду phys, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]] разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

В состоянии может быть произвольное число команд if. Их номера (начиная с нуля) указываются
в параметре if других команд. Эти номера можно соединять при помощи логических связок:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if некоторой команды: '''(1&2)|(3&(!4))''',
что означает: выполняется if под номером 1 и под номером 2, или под номером 3 и не под номером 4.

Параметры команды:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

Machine

2013-01-23T18:57:14Z

Steps: /* wait */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''[[#Инициализация|Инициализация]]''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки.
* '''[[#Процессы|Процессы]]''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение.
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При попадании в состояние, сразу выполняются команды инициализации init, draw, set, buy, var. Если в этих командах нет параметра break, они все выполняются до запуска процессов. Параметр break (со значением 1) прерывает выполнение команд инициализации данного типа. Их можно перезапустить по окончанию команд процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов);
* '''f''' - начальный кадр;
* '''ft''' - длительность кадра в миллисекундах;
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз;
* '''go''' - перейти в состояние;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия перехода; можно использовать лагические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).
Для работы loop '''необходимо''' чтобы в редакторе ресурсов в настройках анимации '''было отключено''' зацикливание(looped).

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды [[#if|if]] при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов);
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов);
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов);
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом;
*'''loop''' - зациклить звук (звуки);
*'''mus_stop''' - остановить текущую музыку;
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии;
*'''if''' - номер (начиная с нуля) условия перехода [[#if|if]].

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной;
*'''obj''' - объект, используемый далее;
*'''par''' - имя параметра, значение которого присваивается переменной;
*'''val''' - значение переменной, если отсутствуют obj и par.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

=== wait ===

Команда паузы (временной задержки). Если параметра '''t''' нет, то срабатывает сразу.
Может также использоваться для логических ветвлений, случайных переходов в другие состояния и т.д.

* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]] разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

В состоянии может быть произвольное число команд if. Их номера (начиная с нуля) указываются
в параметре if других команд. Эти номера можно соединять при помощи логических связок:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if некоторой команды: '''(1&2)|(3&(!4))''',
что означает: выполняется if под номером 1 и под номером 2, или под номером 3 и не под номером 4.

Параметры команды:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

Обсуждение:Machine

2013-01-23T18:53:22Z

Steps: /* play */

Некоторые замечания по синтаксису машин состояний [[Участник:Steps|Steps]] 16:19, 23 января 2013 (CET):
=== draw ===
* Зачем параметр '''go''' в командах инициализации?
* Сейчас параметр '''if''' бестолково работает в команде '''draw'''. Хоть срабатывает условие, хоть нет, происходит переход к следующему draw. Можно if-ом только один раз перебить ресурс из свойств. Лучше, чтобы if работал также, как и в команде set (т.е. если if сработал, установить этот ресурс, иначе - нет; и затем в любом случае перейти к следующим командам draw).
* В анимации не работает '''loop''' и '''ft'''.

=== init ===
* Почему нет параметра if, аналогично команде set?
* Последние 7 параметров меняют другие машины, объекты и по-логике должны находиться к команде '''set'''.

=== play ===
* Непонятен параметр if (перехода нет). Он аналогичен set?

=== buy ===
* Добавить параметр if, аналогично команде set.

=== wait ===
* Если есть только одна команда wait, то '''loop''' в ней не срабатывает.

=== if ===
* Добавить параметр '''go'''. Тогда можно переходы-ветвления делать не из wait, а не посредственно из if. Будет короче и понятнее.

Обсуждение:Machine

2013-01-23T18:50:48Z

Steps: /* init */

Некоторые замечания по синтаксису машин состояний [[Участник:Steps|Steps]] 16:19, 23 января 2013 (CET):
=== draw ===
* Зачем параметр '''go''' в командах инициализации?
* Сейчас параметр '''if''' бестолково работает в команде '''draw'''. Хоть срабатывает условие, хоть нет, происходит переход к следующему draw. Можно if-ом только один раз перебить ресурс из свойств. Лучше, чтобы if работал также, как и в команде set (т.е. если if сработал, установить этот ресурс, иначе - нет; и затем в любом случае перейти к следующим командам draw).
* В анимации не работает '''loop''' и '''ft'''.

=== init ===
* Почему нет параметра if, аналогично команде set?
* Последние 7 параметров меняют другие машины, объекты и по-логике должны находиться к команде '''set'''.

=== play ===
* Непонятен параметр if (перехода нет). Он аналогичен set?

=== wait ===
* Если есть только одна команда wait, то '''loop''' в ней не срабатывает.

=== if ===
* Добавить параметр '''go'''. Тогда можно переходы-ветвления делать не из wait, а не посредственно из if. Будет короче и понятнее.

Обсуждение:Machine

2013-01-23T18:48:44Z

Steps: /* if */

Некоторые замечания по синтаксису машин состояний [[Участник:Steps|Steps]] 16:19, 23 января 2013 (CET):
=== draw ===
* Зачем параметр '''go''' в командах инициализации?
* Сейчас параметр '''if''' бестолково работает в команде '''draw'''. Хоть срабатывает условие, хоть нет, происходит переход к следующему draw. Можно if-ом только один раз перебить ресурс из свойств. Лучше, чтобы if работал также, как и в команде set (т.е. если if сработал, установить этот ресурс, иначе - нет; и затем в любом случае перейти к следующим командам draw).
* В анимации не работает '''loop''' и '''ft'''.

=== init ===
* Почему нет параметра if, аналогично команде set?
* Последние 7 параметров меняют другие машины, объекты и по-логике должны находиться к команде '''set'''.

=== wait ===
* Если есть только одна команда wait, то '''loop''' в ней не срабатывает.

=== if ===
* Добавить параметр '''go'''. Тогда можно переходы-ветвления делать не из wait, а не посредственно из if. Будет короче и понятнее.

Machine

2013-01-23T18:48:07Z

Steps: /* if */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''[[#Инициализация|Инициализация]]''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки.
* '''[[#Процессы|Процессы]]''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение.
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При попадании в состояние, сразу выполняются команды инициализации init, draw, set, buy, var. Если в этих командах нет параметра break, они все выполняются до запуска процессов. Параметр break (со значением 1) прерывает выполнение команд инициализации данного типа. Их можно перезапустить по окончанию команд процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов);
* '''f''' - начальный кадр;
* '''ft''' - длительность кадра в миллисекундах;
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз;
* '''go''' - перейти в состояние;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия перехода; можно использовать лагические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).
Для работы loop '''необходимо''' чтобы в редакторе ресурсов в настройках анимации '''было отключено''' зацикливание(looped).

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды [[#if|if]] при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов);
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов);
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов);
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом;
*'''loop''' - зациклить звук (звуки);
*'''mus_stop''' - остановить текущую музыку;
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии;
*'''if''' - номер (начиная с нуля) условия перехода [[#if|if]].

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной;
*'''obj''' - объект, используемый далее;
*'''par''' - имя параметра, значение которого присваивается переменной;
*'''val''' - значение переменной, если отсутствуют obj и par.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]] разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

В состоянии может быть произвольное число команд if. Их номера (начиная с нуля) указываются
в параметре if других команд. Эти номера можно соединять при помощи логических связок:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if некоторой команды: '''(1&2)|(3&(!4))''',
что означает: выполняется if под номером 1 и под номером 2, или под номером 3 и не под номером 4.

Параметры команды:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

Machine

2013-01-23T18:47:34Z

Steps: /* if */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''[[#Инициализация|Инициализация]]''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки.
* '''[[#Процессы|Процессы]]''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение.
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При попадании в состояние, сразу выполняются команды инициализации init, draw, set, buy, var. Если в этих командах нет параметра break, они все выполняются до запуска процессов. Параметр break (со значением 1) прерывает выполнение команд инициализации данного типа. Их можно перезапустить по окончанию команд процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов);
* '''f''' - начальный кадр;
* '''ft''' - длительность кадра в миллисекундах;
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз;
* '''go''' - перейти в состояние;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия перехода; можно использовать лагические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).
Для работы loop '''необходимо''' чтобы в редакторе ресурсов в настройках анимации '''было отключено''' зацикливание(looped).

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды [[#if|if]] при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов);
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов);
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов);
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом;
*'''loop''' - зациклить звук (звуки);
*'''mus_stop''' - остановить текущую музыку;
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии;
*'''if''' - номер (начиная с нуля) условия перехода [[#if|if]].

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной;
*'''obj''' - объект, используемый далее;
*'''par''' - имя параметра, значение которого присваивается переменной;
*'''val''' - значение переменной, если отсутствуют obj и par.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]] разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

В состоянии может быть произвольное число команд if. Их номера (начиная с нуля) указываются
в параметре if других команд. Эти номера можно соединять при помощи логических связок:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if некоторой команды: '''(1&2)|(3&(!4))''',
что означает: выполняется if под номером 1 и под номером 2, или под номером 3 и не под номером 4.

Параметры команды:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Machine

2013-01-23T18:43:30Z

Steps:

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''[[#Инициализация|Инициализация]]''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки.
* '''[[#Процессы|Процессы]]''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение.
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При попадании в состояние, сразу выполняются команды инициализации init, draw, set, buy, var. Если в этих командах нет параметра break, они все выполняются до запуска процессов. Параметр break (со значением 1) прерывает выполнение команд инициализации данного типа. Их можно перезапустить по окончанию команд процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов);
* '''f''' - начальный кадр;
* '''ft''' - длительность кадра в миллисекундах;
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз;
* '''go''' - перейти в состояние;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия перехода; можно использовать лагические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).
Для работы loop '''необходимо''' чтобы в редакторе ресурсов в настройках анимации '''было отключено''' зацикливание(looped).

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды [[#if|if]] при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов);
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов);
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов);
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом;
*'''loop''' - зациклить звук (звуки);
*'''mus_stop''' - остановить текущую музыку;
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии;
*'''if''' - номер (начиная с нуля) условия перехода [[#if|if]].

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной;
*'''obj''' - объект, используемый далее;
*'''par''' - имя параметра, значение которого присваивается переменной;
*'''val''' - значение переменной, если отсутствуют obj и par.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]], при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер (начиная с нуля) команды [[#if|if]] разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер (начиная с нуля) команды условия [[#if|if]] разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

Параметры:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T18:33:15Z

Steps: /* var */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''[[#Инициализация|Инициализация]]''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки.
* '''[[#Процессы|Процессы]]''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение.
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При попадании в состояние, сразу выполняются команды инициализации init, draw, set, buy, var. Если в этих командах нет параметра break, они все выполняются до запуска процессов. Параметр break (со значением 1) прерывает выполнение команд инициализации данного типа. Их можно перезапустить по окончанию команд процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).
Для работы loop '''необходимо''' чтобы в редакторе ресурсов в настройках анимации '''было отключено''' зацикливание(looped).

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов)
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов)
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом
*'''loop''' - зациклить звук (звуки)
*'''mus_stop''' - остановить текущую музыку
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии
*'''if''' - номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной
*'''obj''' - объект, используемый далее
*'''par''' - имя параметра, значение которого присваивается переменной
*'''val''' - значение переменной, если отсутствуют obj и par

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано;
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер команды разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер команды условия (начиная с нуля) разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

Параметры:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T18:32:39Z

Steps: /* Инициализация */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''[[#Инициализация|Инициализация]]''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки.
* '''[[#Процессы|Процессы]]''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение.
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При попадании в состояние, сразу выполняются команды инициализации init, draw, set, buy, var. Если в этих командах нет параметра break, они все выполняются до запуска процессов. Параметр break (со значением 1) прерывает выполнение команд инициализации данного типа. Их можно перезапустить по окончанию команд процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).
Для работы loop '''необходимо''' чтобы в редакторе ресурсов в настройках анимации '''было отключено''' зацикливание(looped).

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов)
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов)
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом
*'''loop''' - зациклить звук (звуки)
*'''mus_stop''' - остановить текущую музыку
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии
*'''if''' - номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано;
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер команды разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер команды условия (начиная с нуля) разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

Параметры:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T18:25:52Z

Steps: /* draw */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''[[#Инициализация|Инициализация]]''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки.
* '''[[#Процессы|Процессы]]''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение.
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При первом попадании в состояние, сразу выполняются команды инициализации init, draw и set. Если в этих командах нет параметра break, они все выполняются до запуска процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).
Для работы loop '''необходимо''' чтобы в редакторе ресурсов в настройках анимации '''было отключено''' зацикливание(looped).

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов)
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов)
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом
*'''loop''' - зациклить звук (звуки)
*'''mus_stop''' - остановить текущую музыку
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии
*'''if''' - номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано;
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер команды разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер команды условия (начиная с нуля) разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

Параметры:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T18:25:10Z

Steps: /* Введение */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''[[#Инициализация|Инициализация]]''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки.
* '''[[#Процессы|Процессы]]''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение.
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При первом попадании в состояние, сразу выполняются команды инициализации init, draw и set. Если в этих командах нет параметра break, они все выполняются до запуска процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).

'''Для работы loop необходимо чтобы в редакторе ресурсов в настройках анимации было отключено зацикливание(looped).
'''

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов)
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов)
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом
*'''loop''' - зациклить звук (звуки)
*'''mus_stop''' - остановить текущую музыку
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии
*'''if''' - номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано;
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер команды разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер команды условия (начиная с нуля) разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

Параметры:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T18:23:15Z

Steps:

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''Инициализации''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки.
* '''Процессов''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение.
* '''Воздействия''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#Условия_if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Инициализация ==

При первом попадании в состояние, сразу выполняются команды инициализации init, draw и set. Если в этих командах нет параметра break, они все выполняются до запуска процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).

'''Для работы loop необходимо чтобы в редакторе ресурсов в настройках анимации было отключено зацикливание(looped).
'''

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов)
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов)
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом
*'''loop''' - зациклить звук (звуки)
*'''mus_stop''' - остановить текущую музыку
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии
*'''if''' - номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Процессы ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано;
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их снова можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их снова можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Воздействия ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер команды разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер команды условия (начиная с нуля) разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия ==

=== if ===

Параметры:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T18:20:52Z

Steps: /* Введение */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''Инициализации''':
** '''[[#draw|draw]]''' - установка графического ресурса;
** '''[[#init|init]]''' - инициализация параметров машины (координаты и т.п.);
** '''[[#set|set]]''' - установка состояния другого объекта;
** '''[[#play|play]]''' - проиграть звук;
** '''[[#var|var]]''' - переменная, которой присваивается значение параметра объекта;
** '''[[#buy|buy]]''' - запуск процедуры in-app покупки.
* '''Процессов''':
** '''[[#wait|wait]]''' - задержка по времени;
** '''[[#move|move]]''' - равномерное движение;
** '''[[#rot|rot]]''' - вращение вокруг точки пивота;
** '''[[#alpha|alpha]]''' - изменение прозрачности;
** '''[[#scale|scale]]''' - изменение размера;
** '''[[#phys|phys]]''' - ускоренное движение.
* '''Воздействия''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''[[#Условия_if|if]]''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Команды инициализации ==

При первом попадании в состояние, сразу выполняются команды инициализации init, draw и set. Если в этих командах нет параметра break, они все выполняются до запуска процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).

'''Для работы loop необходимо чтобы в редакторе ресурсов в настройках анимации было отключено зацикливание(looped).
'''

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов)
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов)
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом
*'''loop''' - зациклить звук (звуки)
*'''mus_stop''' - остановить текущую музыку
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии
*'''if''' - номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Команды процессов ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано;
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их сново можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их сново можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их сново можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их сново можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их сново можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Команды воздействий ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер команды разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер команды условия (начиная с нуля) разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия if ==

Параметры:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T18:16:37Z

Steps: /* Введение */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''Инициализации''':
** '''[[#draw]]''' - установка графического ресурса;
** '''init''' - инициализация параметров машины (координаты и т.п.);
** '''set''' - установка состояния другого объекта;
** '''play''' - проиграть звук;
** '''var''' - переменная, которой присваивается значение параметра объекта;
** '''buy''' - запуск процедуры in-app покупки.
* '''Процессов''':
** '''wait''' - задержка по времени;
** '''move''' - равномерное движение;
** '''rot''' - вращение вокруг точки пивота;
** '''alpha''' - изменение прозрачности;
** '''scale''' - изменение размера;
** '''phys''' - ускоренное движение.
* '''Воздействия''':
** '''click''' - что делать при клике на машине;
** '''drop''' - на машине отпущена клавиша мыши;
** '''drag''' - машину схватили и тащат;
** '''throw''' - машину схватили и кинули;
** '''apply''' - сработает при пересечении машины с линией или объектом;
** '''touch_in''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''touch_out''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''mouse_in''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''mouse_out''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''if''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Команды инициализации ==

При первом попадании в состояние, сразу выполняются команды инициализации init, draw и set. Если в этих командах нет параметра break, они все выполняются до запуска процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).

'''Для работы loop необходимо чтобы в редакторе ресурсов в настройках анимации было отключено зацикливание(looped).
'''

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов)
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов)
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом
*'''loop''' - зациклить звук (звуки)
*'''mus_stop''' - остановить текущую музыку
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии
*'''if''' - номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Команды процессов ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано;
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их сново можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их сново можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их сново можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их сново можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их сново можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Команды воздействий ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер команды разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер команды условия (начиная с нуля) разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия if ==

Параметры:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T18:13:51Z

Steps:

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''Инициализации''':
** '''draw''' - установка графического ресурса;
** '''init''' - инициализация параметров машины (координаты и т.п.);
** '''set''' - установка состояния другого объекта;
** '''play''' - проиграть звук;
** '''var''' - переменная, которой присваивается значение параметра объекта;
** '''buy''' - запуск процедуры in-app покупки.
* '''Процессов''':
** '''wait''' - задержка по времени;
** '''move''' - равномерное движение;
** '''rot''' - вращение вокруг точки пивота;
** '''alpha''' - изменение прозрачности;
** '''scale''' - изменение размера;
** '''phys''' - ускоренное движение.
* '''Воздействия''':
** '''click''' - что делать при клике на машине;
** '''drop''' - на машине отпущена клавиша мыши;
** '''drag''' - машину схватили и тащат;
** '''throw''' - машину схватили и кинули;
** '''apply''' - сработает при пересечении машины с линией или объектом;
** '''touch_in''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''touch_out''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''mouse_in''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''mouse_out''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''if''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Команды инициализации ==

При первом попадании в состояние, сразу выполняются команды инициализации init, draw и set. Если в этих командах нет параметра break, они все выполняются до запуска процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).

'''Для работы loop необходимо чтобы в редакторе ресурсов в настройках анимации было отключено зацикливание(looped).
'''

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов)
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов)
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом
*'''loop''' - зациклить звук (звуки)
*'''mus_stop''' - остановить текущую музыку
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии
*'''if''' - номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Команды процессов ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано;
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их сново можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их сново можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их сново можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их сново можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их сново можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Команды воздействий ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер команды разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер команды условия (начиная с нуля) разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

== Условия if ==

Параметры:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T18:13:01Z

Steps: /* Введение */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''Инициализации''':
** '''draw''' - установка графического ресурса;
** '''init''' - инициализация параметров машины (координаты и т.п.);
** '''set''' - установка состояния другого объекта;
** '''play''' - проиграть звук;
** '''var''' - переменная, которой присваивается значение параметра объекта;
** '''buy''' - запуск процедуры in-app покупки.
* '''Процессов''':
** '''wait''' - задержка по времени;
** '''move''' - равномерное движение;
** '''rot''' - вращение вокруг точки пивота;
** '''alpha''' - изменение прозрачности;
** '''scale''' - изменение размера;
** '''phys''' - ускоренное движение.
* '''Воздействия''':
** '''click''' - что делать при клике на машине;
** '''drop''' - на машине отпущена клавиша мыши;
** '''drag''' - машину схватили и тащат;
** '''throw''' - машину схватили и кинули;
** '''apply''' - сработает при пересечении машины с линией или объектом;
** '''touch_in''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''touch_out''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''mouse_in''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''mouse_out''' - выведение мыши из машины даже если не нажата кнопка мыши.

Кроме этого, есть команда '''if''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Команды инициализации ==

При первом попадании в состояние, сразу выполняются команды инициализации init, draw и set. Если в этих командах нет параметра break, они все выполняются до запуска процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).

'''Для работы loop необходимо чтобы в редакторе ресурсов в настройках анимации было отключено зацикливание(looped).
'''

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Команды процессов ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано;
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их сново можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их сново можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их сново можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их сново можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их сново можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Команды воздействий ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер команды разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер команды условия (начиная с нуля) разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов)
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов)
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом
*'''loop''' - зациклить звук (звуки)
*'''mus_stop''' - остановить текущую музыку
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии
*'''if''' - номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

== Условия if ==

Параметры:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T18:05:18Z

Steps: /* Команды процессов */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''Инициализации''':
** '''draw''' - установка графического ресурса
** '''init''' - инициализация параметров машины (координаты и т.п.)
** '''set''' - установка состояния другого объекта
** '''buy''' - запуск процедуры in-app покупки
* '''Процессов''':
** '''wait''' - задержка по времени
** '''move''' - движение
** '''alpha''' - изменение прозрачности
** '''scale''' - изменение размера
** '''rot''' - вращение вокруг точки пивота
** '''phys''' - движение в силовом поле.
* '''Воздействия''':
** '''click''' - что делать при клике на машине
** '''drop''' - на машине отпущена клавиша мыши
** '''drag''' - машину схватили и тащат
** '''throw''' - машину схватили и кинули
** '''apply''' - сработает при пересечении машины с линией или объектом

Кроме этого, есть команда '''if''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Команды инициализации ==

При первом попадании в состояние, сразу выполняются команды инициализации init, draw и set. Если в этих командах нет параметра break, они все выполняются до запуска процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).

'''Для работы loop необходимо чтобы в редакторе ресурсов в настройках анимации было отключено зацикливание(looped).
'''

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Команды процессов ==

Все команды процессов, кроме параметров описанных ниже, могут содержать параметры, совпадающие с именами других команд. В этих параметрах указывается номер (начиная с нуля) команды, которую надо запустить на выполнение, после окончания действия данной команды процесса.

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано;
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их сново можно из команд процессов).

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их сново можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их сново можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их сново можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их сново можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Команды воздействий ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер команды разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер команды условия (начиная с нуля) разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов)
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов)
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом
*'''loop''' - зациклить звук (звуки)
*'''mus_stop''' - остановить текущую музыку
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии
*'''if''' - номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

== Условия if ==

Параметры:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Обсуждение:Machine

2013-01-23T18:00:17Z

Steps: /* init */

Некоторые замечания по синтаксису машин состояний [[Участник:Steps|Steps]] 16:19, 23 января 2013 (CET):
=== draw ===
* Зачем параметр '''go''' в командах инициализации?
* Сейчас параметр '''if''' бестолково работает в команде '''draw'''. Хоть срабатывает условие, хоть нет, происходит переход к следующему draw. Можно if-ом только один раз перебить ресурс из свойств. Лучше, чтобы if работал также, как и в команде set (т.е. если if сработал, установить этот ресурс, иначе - нет; и затем в любом случае перейти к следующим командам draw).
* В анимации не работает '''loop''' и '''ft'''.

=== init ===
* Почему нет параметра if, аналогично команде set?
* Последние 7 параметров меняют другие машины, объекты и по-логике должны находиться к команде '''set'''.

=== wait ===
* Если есть только одна команда wait, то '''loop''' в ней не срабатывает.

=== if ===
* Добавить параметр '''go'''. Тогда можно переходы-ветвления делать не из wait, а не посредственно из if. Будет короче и понятнее.
* Плохо описана команда в документации. Непонятно куда вставлять условия и т.п.

Обсуждение:Machine

2013-01-23T17:59:33Z

Steps: /* draw */

Некоторые замечания по синтаксису машин состояний [[Участник:Steps|Steps]] 16:19, 23 января 2013 (CET):
=== draw ===
* Зачем параметр '''go''' в командах инициализации?
* Сейчас параметр '''if''' бестолково работает в команде '''draw'''. Хоть срабатывает условие, хоть нет, происходит переход к следующему draw. Можно if-ом только один раз перебить ресурс из свойств. Лучше, чтобы if работал также, как и в команде set (т.е. если if сработал, установить этот ресурс, иначе - нет; и затем в любом случае перейти к следующим командам draw).
* В анимации не работает '''loop''' и '''ft'''.

=== init ===
* Последние 7 параметров меняют другие машины, объекты и по-логике должны находиться к команде '''set'''.

=== wait ===
* Если есть только одна команда wait, то '''loop''' в ней не срабатывает.

=== if ===
* Добавить параметр '''go'''. Тогда можно переходы-ветвления делать не из wait, а не посредственно из if. Будет короче и понятнее.
* Плохо описана команда в документации. Непонятно куда вставлять условия и т.п.

Обсуждение:Machine

2013-01-23T17:56:04Z

Steps: /* draw */

Некоторые замечания по синтаксису машин состояний [[Участник:Steps|Steps]] 16:19, 23 января 2013 (CET):
=== draw ===
* Зачем параметр '''go''' в командах инициализации?
* Сейчас параметр '''if''' бестолково работает в команде '''draw'''. Хоть срабатывает условие, хоть нет, происходит переход к следующему draw. Можно if-ом только один раз перебить ресурс из свойств. Стоит if либо убрать, либо сделать, чтобы она работала аналогично команде set (т.е. если if сработал установить этот ресурс, иначе - нет; и затем в любом случае перейти к следующим командам draw).
* В анимации не работает '''loop''' и '''ft'''.

=== init ===
* Последние 7 параметров меняют другие машины, объекты и по-логике должны находиться к команде '''set'''.

=== wait ===
* Если есть только одна команда wait, то '''loop''' в ней не срабатывает.

=== if ===
* Добавить параметр '''go'''. Тогда можно переходы-ветвления делать не из wait, а не посредственно из if. Будет короче и понятнее.
* Плохо описана команда в документации. Непонятно куда вставлять условия и т.п.

Обсуждение:Machine

2013-01-23T17:51:08Z

Steps: /* if */

Некоторые замечания по синтаксису машин состояний [[Участник:Steps|Steps]] 16:19, 23 января 2013 (CET):
=== draw ===
* Зачем параметр '''go''' в командах инициализации?
* Сейчас параметр '''if''' бестолково работает в команде '''draw'''. Хоть срабатывает условие, хоть нет, происходит переход к следующему draw. Можно if-ом только один раз перебить ресурс из свойств. Стоит if либо убрать, либо сделать его break-м (т.е. если if сработал установить этот ресурс и к следующим командам draw не переходить).
* В анимации не работает '''loop''' и '''ft'''.

=== init ===
* Последние 7 параметров меняют другие машины, объекты и по-логике должны находиться к команде '''set'''.

=== wait ===
* Если есть только одна команда wait, то '''loop''' в ней не срабатывает.

=== if ===
* Добавить параметр '''go'''. Тогда можно переходы-ветвления делать не из wait, а не посредственно из if. Будет короче и понятнее.
* Плохо описана команда в документации. Непонятно куда вставлять условия и т.п.

Machine

2013-01-23T17:48:16Z

Steps: /* wait */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''Инициализации''':
** '''draw''' - установка графического ресурса
** '''init''' - инициализация параметров машины (координаты и т.п.)
** '''set''' - установка состояния другого объекта
** '''buy''' - запуск процедуры in-app покупки
* '''Процессов''':
** '''wait''' - задержка по времени
** '''move''' - движение
** '''alpha''' - изменение прозрачности
** '''scale''' - изменение размера
** '''rot''' - вращение вокруг точки пивота
** '''phys''' - движение в силовом поле.
* '''Воздействия''':
** '''click''' - что делать при клике на машине
** '''drop''' - на машине отпущена клавиша мыши
** '''drag''' - машину схватили и тащат
** '''throw''' - машину схватили и кинули
** '''apply''' - сработает при пересечении машины с линией или объектом

Кроме этого, есть команда '''if''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Команды инициализации ==

При первом попадании в состояние, сразу выполняются команды инициализации init, draw и set. Если в этих командах нет параметра break, они все выполняются до запуска процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).

'''Для работы loop необходимо чтобы в редакторе ресурсов в настройках анимации было отключено зацикливание(looped).
'''

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Команды процессов ==

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms;
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае);
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано;
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их сново можно из команд процессов).

Кроме этих параметров, все команды процессов могут содержать параметры break, loop и параметры совпадающие с именами других процессов move,rot и т.д. Все эти параметры служат для управления циклами и прерываниями.

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их сново можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их сново можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их сново можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их сново можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Команды воздействий ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер команды разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер команды условия (начиная с нуля) разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов)
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов)
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом
*'''loop''' - зациклить звук (звуки)
*'''mus_stop''' - остановить текущую музыку
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии
*'''if''' - номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

== Условия if ==

Параметры:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T17:47:16Z

Steps: /* wait */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''Инициализации''':
** '''draw''' - установка графического ресурса
** '''init''' - инициализация параметров машины (координаты и т.п.)
** '''set''' - установка состояния другого объекта
** '''buy''' - запуск процедуры in-app покупки
* '''Процессов''':
** '''wait''' - задержка по времени
** '''move''' - движение
** '''alpha''' - изменение прозрачности
** '''scale''' - изменение размера
** '''rot''' - вращение вокруг точки пивота
** '''phys''' - движение в силовом поле.
* '''Воздействия''':
** '''click''' - что делать при клике на машине
** '''drop''' - на машине отпущена клавиша мыши
** '''drag''' - машину схватили и тащат
** '''throw''' - машину схватили и кинули
** '''apply''' - сработает при пересечении машины с линией или объектом

Кроме этого, есть команда '''if''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Команды инициализации ==

При первом попадании в состояние, сразу выполняются команды инициализации init, draw и set. Если в этих командах нет параметра break, они все выполняются до запуска процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).

'''Для работы loop необходимо чтобы в редакторе ресурсов в настройках анимации было отключено зацикливание(looped).
'''

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Команды процессов ==

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms
* '''dt''' - интервал от t-dt до t+dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае)
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go.
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды
* '''break''' - Прервать выполнение команд wait на этой команде (запустить их сново можно из команд процессов).

Кроме этих параметров, все команды процессов могут содержать параметры break, loop и параметры совпадающие с именами других процессов move,rot и т.д. Все эти параметры служат для управления циклами и прерываниями.

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их сново можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их сново можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их сново можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их сново можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Команды воздействий ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер команды разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер команды условия (начиная с нуля) разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов)
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов)
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом
*'''loop''' - зациклить звук (звуки)
*'''mus_stop''' - остановить текущую музыку
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии
*'''if''' - номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

== Условия if ==

Параметры:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T17:46:30Z

Steps: /* buy */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''Инициализации''':
** '''draw''' - установка графического ресурса
** '''init''' - инициализация параметров машины (координаты и т.п.)
** '''set''' - установка состояния другого объекта
** '''buy''' - запуск процедуры in-app покупки
* '''Процессов''':
** '''wait''' - задержка по времени
** '''move''' - движение
** '''alpha''' - изменение прозрачности
** '''scale''' - изменение размера
** '''rot''' - вращение вокруг точки пивота
** '''phys''' - движение в силовом поле.
* '''Воздействия''':
** '''click''' - что делать при клике на машине
** '''drop''' - на машине отпущена клавиша мыши
** '''drag''' - машину схватили и тащат
** '''throw''' - машину схватили и кинули
** '''apply''' - сработает при пересечении машины с линией или объектом

Кроме этого, есть команда '''if''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Команды инициализации ==

При первом попадании в состояние, сразу выполняются команды инициализации init, draw и set. Если в этих командах нет параметра break, они все выполняются до запуска процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).

'''Для работы loop необходимо чтобы в редакторе ресурсов в настройках анимации было отключено зацикливание(looped).
'''

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте [[Store]];
* '''объект(успех)''' - объект, которому сообщается об удачной покупке;
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки;
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке;
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки.

== Команды процессов ==

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms
* '''dt''' - интервал t+/- dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае)
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go.
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды
* '''break''' - Прервать выполнение команд wait на этой команде (запустить их сново можно из команд процессов).

Кроме этих параметров, все команды процессов могут содержать параметры break, loop и параметры совпадающие с именами других процессов move,rot и т.д. Все эти параметры служат для управления циклами и прерываниями.

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их сново можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их сново можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их сново можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их сново можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Команды воздействий ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер команды разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер команды условия (начиная с нуля) разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов)
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов)
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом
*'''loop''' - зациклить звук (звуки)
*'''mus_stop''' - остановить текущую музыку
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии
*'''if''' - номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

== Условия if ==

Параметры:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T17:31:54Z

Steps: /* play */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''Инициализации''':
** '''draw''' - установка графического ресурса
** '''init''' - инициализация параметров машины (координаты и т.п.)
** '''set''' - установка состояния другого объекта
** '''buy''' - запуск процедуры in-app покупки
* '''Процессов''':
** '''wait''' - задержка по времени
** '''move''' - движение
** '''alpha''' - изменение прозрачности
** '''scale''' - изменение размера
** '''rot''' - вращение вокруг точки пивота
** '''phys''' - движение в силовом поле.
* '''Воздействия''':
** '''click''' - что делать при клике на машине
** '''drop''' - на машине отпущена клавиша мыши
** '''drag''' - машину схватили и тащат
** '''throw''' - машину схватили и кинули
** '''apply''' - сработает при пересечении машины с линией или объектом

Кроме этого, есть команда '''if''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Команды инициализации ==

При первом попадании в состояние, сразу выполняются команды инициализации init, draw и set. Если в этих командах нет параметра break, они все выполняются до запуска процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).

'''Для работы loop необходимо чтобы в редакторе ресурсов в настройках анимации было отключено зацикливание(looped).
'''

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте store
* '''объект(успех)''' - объект, которому сообщается об удачной покупке
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки

== Команды процессов ==

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms
* '''dt''' - интервал t+/- dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае)
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go.
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды
* '''break''' - Прервать выполнение команд wait на этой команде (запустить их сново можно из команд процессов).

Кроме этих параметров, все команды процессов могут содержать параметры break, loop и параметры совпадающие с именами других процессов move,rot и т.д. Все эти параметры служат для управления циклами и прерываниями.

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их сново можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их сново можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их сново можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их сново можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Команды воздействий ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер команды разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер команды условия (начиная с нуля) разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

=== play ===

Проиграть звук.

*'''snd''' - короткий звук (перетаскивается из редактора ресурсов)
*'''voice''' - голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)
*'''mus''' - длинный звук (перетаскивается из редактора ресурсов)
*'''preload''' - указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом
*'''loop''' - зациклить звук (звуки)
*'''mus_stop''' - остановить текущую музыку
*'''volume''' - установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии
*'''if''' - номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

== Условия if ==

Параметры:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T17:30:56Z

Steps: /* Условия if */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''Инициализации''':
** '''draw''' - установка графического ресурса
** '''init''' - инициализация параметров машины (координаты и т.п.)
** '''set''' - установка состояния другого объекта
** '''buy''' - запуск процедуры in-app покупки
* '''Процессов''':
** '''wait''' - задержка по времени
** '''move''' - движение
** '''alpha''' - изменение прозрачности
** '''scale''' - изменение размера
** '''rot''' - вращение вокруг точки пивота
** '''phys''' - движение в силовом поле.
* '''Воздействия''':
** '''click''' - что делать при клике на машине
** '''drop''' - на машине отпущена клавиша мыши
** '''drag''' - машину схватили и тащат
** '''throw''' - машину схватили и кинули
** '''apply''' - сработает при пересечении машины с линией или объектом

Кроме этого, есть команда '''if''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Команды инициализации ==

При первом попадании в состояние, сразу выполняются команды инициализации init, draw и set. Если в этих командах нет параметра break, они все выполняются до запуска процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).

'''Для работы loop необходимо чтобы в редакторе ресурсов в настройках анимации было отключено зацикливание(looped).
'''

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте store
* '''объект(успех)''' - объект, которому сообщается об удачной покупке
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки

== Команды процессов ==

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms
* '''dt''' - интервал t+/- dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае)
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go.
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды
* '''break''' - Прервать выполнение команд wait на этой команде (запустить их сново можно из команд процессов).

Кроме этих параметров, все команды процессов могут содержать параметры break, loop и параметры совпадающие с именами других процессов move,rot и т.д. Все эти параметры служат для управления циклами и прерываниями.

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их сново можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их сново можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их сново можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их сново можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Команды воздействий ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер команды разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер команды условия (начиная с нуля) разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

=== play ===

play - проиграть звук

*'''snd''' - Короткий звук (перетаскивается из редактора ресурсов)

*'''voice''' - Голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)

*'''mus''' - Длинный звук (перетаскивается из редактора ресурсов)

*'''preload''' - Указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом

*'''loop''' - Зациклить звук (звуки)

*'''mus_stop''' - Остановить текущую музыку

*'''volume''' - Установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии

*'''if''' - Номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

== Условия if ==

Параметры:
* '''obj''' - объект
* '''st''' - объект находится в состоянии
* '''par''' - параметр объекта
* '''op''' - операция сравнения с заданным значением. Может быть:
** '''<''' - меньше
** '''>''' - больше
** '''!=''' - не равно
** '''<>''' - не равно
** '''>=''' - больше или равно
** '''<=''' - меньше или равно
* '''val''' - значение
* '''buy''' - совершена ли покупка
* '''Guest''' - объект который установил состояние
* '''curScr''' - если текущий экран
* '''prScr''' - если предыдущий экран
* '''wasScr''' - если был экран

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* ''',''' - и
* '''&''' - и
* '''|''' - или
* '''!''' - не
Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T17:27:58Z

Steps: /* apply */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''Инициализации''':
** '''draw''' - установка графического ресурса
** '''init''' - инициализация параметров машины (координаты и т.п.)
** '''set''' - установка состояния другого объекта
** '''buy''' - запуск процедуры in-app покупки
* '''Процессов''':
** '''wait''' - задержка по времени
** '''move''' - движение
** '''alpha''' - изменение прозрачности
** '''scale''' - изменение размера
** '''rot''' - вращение вокруг точки пивота
** '''phys''' - движение в силовом поле.
* '''Воздействия''':
** '''click''' - что делать при клике на машине
** '''drop''' - на машине отпущена клавиша мыши
** '''drag''' - машину схватили и тащат
** '''throw''' - машину схватили и кинули
** '''apply''' - сработает при пересечении машины с линией или объектом

Кроме этого, есть команда '''if''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Команды инициализации ==

При первом попадании в состояние, сразу выполняются команды инициализации init, draw и set. Если в этих командах нет параметра break, они все выполняются до запуска процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).

'''Для работы loop необходимо чтобы в редакторе ресурсов в настройках анимации было отключено зацикливание(looped).
'''

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте store
* '''объект(успех)''' - объект, которому сообщается об удачной покупке
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки

== Команды процессов ==

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms
* '''dt''' - интервал t+/- dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае)
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go.
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды
* '''break''' - Прервать выполнение команд wait на этой команде (запустить их сново можно из команд процессов).

Кроме этих параметров, все команды процессов могут содержать параметры break, loop и параметры совпадающие с именами других процессов move,rot и т.д. Все эти параметры служат для управления циклами и прерываниями.

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их сново можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их сново можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их сново можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их сново можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Команды воздействий ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер команды разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* '''obj''' - сработает , если пересеклись с этим объектом;
* '''x1''' - сработает, если центр объекта левее этого x-ка;
* '''x2''' - сработает, если центр объекта правее этого x-ка;
* '''y1''' - сработает, если центр объекта выше этого y-ка;
* '''y2''' - сработает, если центр объекта ниже этого y-ка;
* '''rm''' - радиус этой машины (если rm=0, то она считается прямоугольной)
* '''ro''' - радиус объекта obj (если ro=0, то он считается прямоугольным)
* '''st''' - состояние, в которое надо перевести объект obj
* '''go''' - состояние, в которое надо перейти при срабатывании;
* '''if''' - номер команды условия (начиная с нуля) разрешения применения команды apply.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

=== play ===

play - проиграть звук

*'''snd''' - Короткий звук (перетаскивается из редактора ресурсов)

*'''voice''' - Голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)

*'''mus''' - Длинный звук (перетаскивается из редактора ресурсов)

*'''preload''' - Указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом

*'''loop''' - Зациклить звук (звуки)

*'''mus_stop''' - Остановить текущую музыку

*'''volume''' - Установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии

*'''if''' - Номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

== Условия if ==

Параметры:
* Guest - объект который установил состояние
* curScr - если текущий экран
* prScr - если предидущий экран
* wasScr - если был экран
* obj - объект
* st - объект находится в состоянии
* par - параметр объекта
* op - операция сравнения с заданным значением. Может быть:
** < - меньше
** > - больше
** != - не равно
** <> - не равно
** >= - больше или равно
** <= - меньше или равно
* val - значение
* buy - совершена ли покупка

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* , - и
* & - и
* | - или
* ! - не

Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T17:26:34Z

Steps: /* throw */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''Инициализации''':
** '''draw''' - установка графического ресурса
** '''init''' - инициализация параметров машины (координаты и т.п.)
** '''set''' - установка состояния другого объекта
** '''buy''' - запуск процедуры in-app покупки
* '''Процессов''':
** '''wait''' - задержка по времени
** '''move''' - движение
** '''alpha''' - изменение прозрачности
** '''scale''' - изменение размера
** '''rot''' - вращение вокруг точки пивота
** '''phys''' - движение в силовом поле.
* '''Воздействия''':
** '''click''' - что делать при клике на машине
** '''drop''' - на машине отпущена клавиша мыши
** '''drag''' - машину схватили и тащат
** '''throw''' - машину схватили и кинули
** '''apply''' - сработает при пересечении машины с линией или объектом

Кроме этого, есть команда '''if''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Команды инициализации ==

При первом попадании в состояние, сразу выполняются команды инициализации init, draw и set. Если в этих командах нет параметра break, они все выполняются до запуска процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).

'''Для работы loop необходимо чтобы в редакторе ресурсов в настройках анимации было отключено зацикливание(looped).
'''

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте store
* '''объект(успех)''' - объект, которому сообщается об удачной покупке
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки

== Команды процессов ==

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms
* '''dt''' - интервал t+/- dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае)
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go.
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды
* '''break''' - Прервать выполнение команд wait на этой команде (запустить их сново можно из команд процессов).

Кроме этих параметров, все команды процессов могут содержать параметры break, loop и параметры совпадающие с именами других процессов move,rot и т.д. Все эти параметры служат для управления циклами и прерываниями.

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их сново можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их сново можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их сново можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их сново можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Команды воздействий ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* '''go''' - состояние, в которое, при клике, надо перейти;
* '''if''' - номер команды разрешения бросания;
* '''force''' - получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* obj - сработает , если пересеклись с этим объектом;
* x1 - сработает, если центр объекта левее этого x-ка;
* x2 - сработает, если центр объекта правее этого x-ка;
* y1 - сработает, если центр объекта выше этого y-ка;
* y2 - сработает, если центр объекта ниже этого y-ка;
* rm - радиус этой машины (если rm=0, то она считается прямоугольной)
* ro - радиус объекта obj (если ro=0, то он считается прямоугольным)
* st - состояние, в которое надо перевести объект obj
* go - состояние, в которое надо перейти при срабатывании;
* if - номер команды разрешения применения.
Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

=== play ===

play - проиграть звук

*'''snd''' - Короткий звук (перетаскивается из редактора ресурсов)

*'''voice''' - Голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)

*'''mus''' - Длинный звук (перетаскивается из редактора ресурсов)

*'''preload''' - Указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом

*'''loop''' - Зациклить звук (звуки)

*'''mus_stop''' - Остановить текущую музыку

*'''volume''' - Установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии

*'''if''' - Номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

== Условия if ==

Параметры:
* Guest - объект который установил состояние
* curScr - если текущий экран
* prScr - если предидущий экран
* wasScr - если был экран
* obj - объект
* st - объект находится в состоянии
* par - параметр объекта
* op - операция сравнения с заданным значением. Может быть:
** < - меньше
** > - больше
** != - не равно
** <> - не равно
** >= - больше или равно
** <= - меньше или равно
* val - значение
* buy - совершена ли покупка

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* , - и
* & - и
* | - или
* ! - не

Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T17:25:51Z

Steps: /* drop */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''Инициализации''':
** '''draw''' - установка графического ресурса
** '''init''' - инициализация параметров машины (координаты и т.п.)
** '''set''' - установка состояния другого объекта
** '''buy''' - запуск процедуры in-app покупки
* '''Процессов''':
** '''wait''' - задержка по времени
** '''move''' - движение
** '''alpha''' - изменение прозрачности
** '''scale''' - изменение размера
** '''rot''' - вращение вокруг точки пивота
** '''phys''' - движение в силовом поле.
* '''Воздействия''':
** '''click''' - что делать при клике на машине
** '''drop''' - на машине отпущена клавиша мыши
** '''drag''' - машину схватили и тащат
** '''throw''' - машину схватили и кинули
** '''apply''' - сработает при пересечении машины с линией или объектом

Кроме этого, есть команда '''if''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Команды инициализации ==

При первом попадании в состояние, сразу выполняются команды инициализации init, draw и set. Если в этих командах нет параметра break, они все выполняются до запуска процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).

'''Для работы loop необходимо чтобы в редакторе ресурсов в настройках анимации было отключено зацикливание(looped).
'''

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте store
* '''объект(успех)''' - объект, которому сообщается об удачной покупке
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки

== Команды процессов ==

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms
* '''dt''' - интервал t+/- dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае)
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go.
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды
* '''break''' - Прервать выполнение команд wait на этой команде (запустить их сново можно из команд процессов).

Кроме этих параметров, все команды процессов могут содержать параметры break, loop и параметры совпадающие с именами других процессов move,rot и т.д. Все эти параметры служат для управления циклами и прерываниями.

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их сново можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их сново можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их сново можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их сново можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Команды воздействий ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* '''obj''' - объект, на который надо уронить таскаемый объект;
* '''go''' - состояние в которое переходим при отпускании мышки;
* '''if''' - номер условия разрешения бросания.

Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* go - состояние, в которое, при клике, надо перейти.
* if - номер команды разрешения бросания.
* force - Получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* obj - сработает , если пересеклись с этим объектом;
* x1 - сработает, если центр объекта левее этого x-ка;
* x2 - сработает, если центр объекта правее этого x-ка;
* y1 - сработает, если центр объекта выше этого y-ка;
* y2 - сработает, если центр объекта ниже этого y-ка;
* rm - радиус этой машины (если rm=0, то она считается прямоугольной)
* ro - радиус объекта obj (если ro=0, то он считается прямоугольным)
* st - состояние, в которое надо перевести объект obj
* go - состояние, в которое надо перейти при срабатывании;
* if - номер команды разрешения применения.
Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

=== play ===

play - проиграть звук

*'''snd''' - Короткий звук (перетаскивается из редактора ресурсов)

*'''voice''' - Голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)

*'''mus''' - Длинный звук (перетаскивается из редактора ресурсов)

*'''preload''' - Указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом

*'''loop''' - Зациклить звук (звуки)

*'''mus_stop''' - Остановить текущую музыку

*'''volume''' - Установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии

*'''if''' - Номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

== Условия if ==

Параметры:
* Guest - объект который установил состояние
* curScr - если текущий экран
* prScr - если предидущий экран
* wasScr - если был экран
* obj - объект
* st - объект находится в состоянии
* par - параметр объекта
* op - операция сравнения с заданным значением. Может быть:
** < - меньше
** > - больше
** != - не равно
** <> - не равно
** >= - больше или равно
** <= - меньше или равно
* val - значение
* buy - совершена ли покупка

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* , - и
* & - и
* | - или
* ! - не

Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))

Machine

2013-01-23T17:25:23Z

Steps: /* drag */

{{TOC right}}
'''Машина состояний''' (state machine) позволяет описывать сложное поведение игровых объектов. Для машин с типовым набором состояний и поведений вводятся отдельные типы объектов. Например, кнопка, по своей сути, является машиной состояний.

== Введение ==

Логика поведения машины разбивается на отдельные узлы (состояния). Машина всегда находится строго в одном состоянии. Переход из одного состояния в другое происходит либо в результате внешнего воздействия на машину, либо в результате окончания некоторых процессов протекающих внутри неё

Любая машина состояний может быть изображена в виде графа с кружочками и стрелками. У машины всегда активно строго одно состояние (ниже это изображено на левом рисунке темным кружком):
<center>
[[Файл:def_states.png]]
</center>
Машина состояний не обладает памятью. Это означает, что для анализа того, что произойдет в данном состоянии, неважно как мы в него попали, и какова была предыстория переходов. Важно, только, что мы находимся в этом состоянии. Такое отсутствие памяти упрощает анализ логики машины, так как каждый раз мы концентрируемся на одном конкретном состоянии, а всю логику работы разбиваем на отдельные кирпичики-состояния.

Выше на правом рисунке изображено некоторое состояние. При входе в него, происходит инициализация состояния. Если на объект оказываются внешние воздействия, то он может покинуть состояние. Наконец, внутри состояния могут работать различные процессы.

Все команды состояния, разбиваются на три группы:
* '''Инициализации''':
** '''draw''' - установка графического ресурса
** '''init''' - инициализация параметров машины (координаты и т.п.)
** '''set''' - установка состояния другого объекта
** '''buy''' - запуск процедуры in-app покупки
* '''Процессов''':
** '''wait''' - задержка по времени
** '''move''' - движение
** '''alpha''' - изменение прозрачности
** '''scale''' - изменение размера
** '''rot''' - вращение вокруг точки пивота
** '''phys''' - движение в силовом поле.
* '''Воздействия''':
** '''click''' - что делать при клике на машине
** '''drop''' - на машине отпущена клавиша мыши
** '''drag''' - машину схватили и тащат
** '''throw''' - машину схватили и кинули
** '''apply''' - сработает при пересечении машины с линией или объектом

Кроме этого, есть команда '''if''', вызываемая другими командами. В ней описываются некоторые логические условия, выполнение которых говорит команде (которая вызвала этот '''if'''), что можно завершать работу.

Начальные понятия и методы работы с машинами состояний находятся в [[Learning|уроках]],
начиная с [[Checkbox как машина состояний|третьего]].

== Свойства ==

Общие для всех объектов свойства описаны в документе [[Object|Object]].
Дополнительные свойства:

* '''Состояние''' - Состояние в котором будет находиться машина при инициализации. Если ничего не указано - первое состояние в списке состояний.
* '''Хранить нажатость''' - нужно ли сбрасывать нажатость при изменении состояния.
* '''res''' - графический ресурс машины. Может отсутствовать. Перетягивается из редактора ресурсов(поле должно быть в состоянии редактирования).
* '''states''' - По двойному клику, или по нажатию на кнопку с тремя точками открывается список состояний.
* '''прокликиваемая''' - 0 - машина не пропускает клик, 1 - машина пропускает клик, 2 - машина обрабатывает клик и пропускает его дальше.

== Команды инициализации ==

При первом попадании в состояние, сразу выполняются команды инициализации init, draw и set. Если в этих командах нет параметра break, они все выполняются до запуска процессов.

=== draw ===

Команда определяет графический ресурс (картинку, которую надо рисовать в данном состоянии). Её параметры:

* '''res''' - ресурс картинки (перетаскивается из редактора ресурсов)
* '''f''' - начальный кадр
* '''ft''' - длительность кадра в миллисекундах
* '''loop''' - число повторов (зацикливаний анимации); если -1, то бесконечно; отсутствует или 0 - будет проигран одина раз
* '''go''' - перейти в состояние
* '''if''' - условие перехода
* '''break''' - прервать команды

Пустая команда draw (без параметров) "сбрасывает" текущую картинку и в этом состоянии ничего рисоваться не будет. Если в общих параметрах объекта (в базовой панеле свойств) задан ресурс рисования, и он во всех состояниях одинаков, то его можно в состоянии не задавать.

Если параметра loop нет, кадры анимации проиграются один раз. Чтобы зациклить их, необходимо установить loop=-1 или нужное число раз. Аналогично параметру loop других команд, первый раз draw выполняется в любом случае. Дальнейшие её повторы определяются значением loop. Однако, в отличие от других команд, loop повторяет только '''данную''' команду draw (даже если она не первая).

'''Для работы loop необходимо чтобы в редакторе ресурсов в настройках анимации было отключено зацикливание(looped).
'''

=== init ===

Инициализация параметров данной машины

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.

Так же, как и при инициализации картинки ('''draw'''), вызов команды ('''init''') переопределяет только те параметры, которые в ней указаны. Остальные параметры (заданные в других состояниях или в общих свойствах объекта) остаются без изменений

=== set ===

Перевод другого объекта в некоторое состояние или изменение его параметров.

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_obj''' - у какого экрана надо изменить состояние st либо параметры.
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется
* '''if''' - номер (начиная с нуля) команды if при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

Так как все объекты (не только машины) имеют состояния, то при помощи команды set можно их менять. Стоит обратить внимание на то, что когда в параметрах (любых команд) встречается st, речь идет о состоянии другого объекта, а если go, то данной машины состояний.

=== buy ===

При переходе в состояние, данная команда открывает системное окно с предложением совершить in-app покупку. В зависимости от действий игрока, покупка может произойти (успех) или не произойти (провал).

* '''id покупки''' - внутренний id покупки для приложения, указывается в объекте store
* '''объект(успех)''' - объект, которому сообщается об удачной покупке
* '''состояние(успех)''' - состояние в которое переводится выбранный объект в случае успешной покупки
* '''объект(провал)''' - объект, которому сообщается о неудачной покупке
* '''состояние(провал)''' - состояние в которое переводится объект в случае неудачной покупки

== Команды процессов ==

=== wait ===

Пауза имеет следующие параметры:
* '''t''' - длительность выполнения команды в ms
* '''dt''' - интервал t+/- dt, внутри которого команда может быть случайно прервана (при t>t+dt прерывается в любом случае)
* '''p''' - вероятность срабатывания перехода в состояние, указываемое параметром go.
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия if, если оно указано.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды
* '''break''' - Прервать выполнение команд wait на этой команде (запустить их сново можно из команд процессов).

Кроме этих параметров, все команды процессов могут содержать параметры break, loop и параметры совпадающие с именами других процессов move,rot и т.д. Все эти параметры служат для управления циклами и прерываниями.

Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются). Можно задавать смесь tx, dy или dx,ty
* '''v''' - скороcть перемещения в пикселях в секунду. Для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость.
* '''t''' - время перемещения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их сново можно из команд процессов).

В большинстве команд процессов, связанных с движением, величина изменения может быть задана в абсолютных или относительных величинах. Так, могут быть указаны целевые координаты tx, ty в которые надо переместиться, или смещение dx, dy относительно текущего положения объекта.

Аналогично, скорость перемещения регулируется, либо явным заданием времени выполнения команды t, либо скоростью v. Исходя из требуемого расстояния, по этой скорости вычисляется необходимое время. Скорость задается в пикселях за cекунду (а не миллисекунду!)

=== rot ===

Вращение объекта вокруг точки пивота с координатами px,py. Эти координаты задаются относительно верхнего левого угла объекта в общей секции описания параметров объекта или командой init в данном состоянии.
* '''ta''' - целевой угол поворота объекта
* '''da''' - на сколько надо повернуться (ta игнорируется)
* '''v''' - угловая скорость поворота в градусах в секунду
* '''t''' - время поворота (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд rot на этой команде (запустить их сново можно из команд процессов).

Угол отсчитывается от оси x. Если он положителен, то поворот происходит по часовой стрелке. Если отрицательный - против часовой.

=== alpha ===

Изменение прозрачности объекта. Меняется от 0 (полностью прозрачен) до 1 (непрозрачен)
* '''ta''' - целевая прозрачность
* '''da''' - на сколько надо изменить прозрачность от текущей (ta игнорируется)
* '''v''' - скорость изменения прозрачности (в долях единицы в ms)
* '''t''' - время изменения (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд alpha с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд alpha на этой команде (запустить их сново можно из команд процессов).

=== scale ===

Изменение размеров объекта
* '''tx''', '''ty''' - целевой масштаб по каждой оси
* '''dx''', '''dy''' - на сколько изменить масштаб по каждой оси
* '''v''' - скорость изменения масштаба (в долях единицы в сек.)
* '''t''' - длительность выполнения команды (v игнорируется)
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд scale с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд scale на этой команде (запустить их сново можно из команд процессов).

=== phys ===

Команда phys позволяет имитировать простую физику. В ней задается начальная скорость и действующая на объект сила (ускорение).

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер команды if (начиная с нуля), при выполнении которой происходит переход go.
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их сново можно из команд процессов).

Рассмотрим подпрыгивающий мячик, который при касании с землей деформируется (вертикально сплюскивается). Это можно сделать в 3 состояния (падаем, касаемся и взлетаем). Первоначально мячик находится в координте y=-100, и имеет высоту картинки w=60. Падает он до координаты ty=0. При касании с землёй, мяч сжимается на 20 процентов (sy=0.8). При этом его центр должен опуститься на dy=0.8*w/2 = 24.
<pre>

<st id="down"> // падаем
<phys vy="0" ay="20" ty="0" go="touch"/>
</st>

<st id="touch"> // касаемся земли
<move dy="24" t="300"/> // опускаем центр при сжатии
<scale ty="0.8" t="300"/> // сжимаемся
<move dy="-24" t="300"/> // поднимаем центр при разжатии
<scale ty="1" t="300" go="up"/> // разжимаемся
</st>

<st id="up"> // взлетаем
<phys vy="0" ty="-200" go="down"/>
</st>

</pre>
Напомним, что если объект имеет начальную скорость взлета, равную v=sqrt(2*ay*h), то он подпрыгнет на высоту h. Однако, в данном случае, вместо задания начальной скорости при взлете, мы задаем целевую координату (ty), до которой мяч должен подпрыгнуть.

== Команды воздействий ==

=== click ===

Команда вызывается, если на объект кликнули мышкой. Срабатывает на её нажатие.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_in ===

Наведение мыши/пальца на машину, если палец "тащат" по экрану.
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== touch_out ===
Выведение мыши/пальца из машины, если палец "тащат" по экрану.
* '''go''' - состояние в которое при клике надо перейти;
* '''if''' - номер команды условия, при котором срабатывает переход go.

=== mouse_in ===

Срабатывает при наведение мыши/пальца на машину даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== mouse_out ===
Срабатывает при выведение мыши/пальца из машины даже если не нажата кнопка мыши, работает на desktop-ных системах (OSX, Windows)
* '''go''' - состояние в которое при выполнении команды надо перейти (если if нет, то в любом случае);
* '''if''' - номер команды условия (начиная с нуля), при срабатывании которого, происходит переход go.

=== drag ===

Если на объект наступили мышкой, и не отпуская его, начали перемещать, то при наличии этой команды, объект "прилипнет" к мышке, и будет за ней таскаться. Можно ограничить разрешенную область таскания, за которую объект выпускаться не будет.
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у какоторого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''таскать за пивот''' - 1 - таскать объект за пивот, 0 - за ту точку, за которую схватили

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drop
* obj - объект, на который надо уронить таскаемый объект;
* go - состояние в которое переходим при отпускании мышки;
* if - номер условия разрешения бросания.
Рассмотрим совместное применение команд drag и drop на следующей задаче. Пусть есть ключ и ящик. Ключ можно взять мышкой и перетащить, бросив на ящик. Ящик при этом должен постепенно стать прозрачным, а ключ уменьшиться до нуля. Машина состояний для ключа выглядит следующим образом:
<pre>

<st id="drag">
<drag x1="-350" x2="350" y1="-250" y2="250"/>
<drop obj="box" go="open"/>
</st>

<st id="open">
<set obj="box" st="open"/>
<scale tx="0.01" ty="0.01" t="500" go="hide"/>
</st>

<st id="hide">
<init x="268" y="30"/>
<scale tx="1" ty="1" t="500" go="drag"/>
</st>

</pre>
Ящик:
<pre>

<st id="close"> // начальное состояние ящика
<init al="1"/> // если его кто-то сюда переведет - он появится.
</st>

<st id="open">
<alpha ta="0" t="500"/> // исчезает по прозрачности за 500 ms
</st>

</pre>

=== throw ===

Если на объект наступили мышкой, не отпуская кнопки, мышку оттащили и затем отпустили, вызывается команда throw со следующими параметрами:
* go - состояние, в которое, при клике, надо перейти.
* if - номер команды разрешения бросания.
* force - Получаемая скорость равна разнице пискелей от начала бросания (мышь нажата) до его конца (мышь отжата), умноженная на этот параметр. По умолчанию он равен 1.

Сработав, эта команда задает начальные значения скорости для команды phys, поэтому должна использоваться совместно с ней (см. ниже пример).

=== apply ===

Вызывается, если данная машина пересеклась с другой. Обычно используется в совокупности с throw, move, phys, drag.
* obj - сработает , если пересеклись с этим объектом;
* x1 - сработает, если центр объекта левее этого x-ка;
* x2 - сработает, если центр объекта правее этого x-ка;
* y1 - сработает, если центр объекта выше этого y-ка;
* y2 - сработает, если центр объекта ниже этого y-ка;
* rm - радиус этой машины (если rm=0, то она считается прямоугольной)
* ro - радиус объекта obj (если ro=0, то он считается прямоугольным)
* st - состояние, в которое надо перевести объект obj
* go - состояние, в которое надо перейти при срабатывании;
* if - номер команды разрешения применения.
Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<pre>

<st id="trow">
<init x="-350" y="150"/> // начальное положение
<throw go="fly"/> // бросаем
</st>

<st id="fly">
<phys ay="100"/> // летим
<apply y2="300" go="throw"/> // с землей
<apply obj="тыква" rm="8" ro="10" st="bang"/> // с тыквой
</st>

</pre>

=== play ===

play - проиграть звук

*'''snd''' - Короткий звук (перетаскивается из редактора ресурсов)

*'''voice''' - Голос (запускается как звук, но без цикла и с громкостью голоса) (перетаскивается из редактора ресурсов)

*'''mus''' - Длинный звук (перетаскивается из редактора ресурсов)

*'''preload''' - Указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом

*'''loop''' - Зациклить звук (звуки)

*'''mus_stop''' - Остановить текущую музыку

*'''volume''' - Установить громкость для всех звуком данной машины - тех что уже играют и тех, что будут запущены впоследствии

*'''if''' - Номер (начиная с нуля) условия перехода (команды if)

=== var ===

Переменная, которой присваивается значение параметра объекта

*'''name''' - имя переменной

*'''obj''' - объект, используемый далее

*'''par''' - Имя параметра, значение которого присваивается переменной

*'''val''' - Значение переменной, если отсутствуют obj и par

== Условия if ==

Параметры:
* Guest - объект который установил состояние
* curScr - если текущий экран
* prScr - если предидущий экран
* wasScr - если был экран
* obj - объект
* st - объект находится в состоянии
* par - параметр объекта
* op - операция сравнения с заданным значением. Может быть:
** < - меньше
** > - больше
** != - не равно
** <> - не равно
** >= - больше или равно
** <= - меньше или равно
* val - значение
* buy - совершена ли покупка

Если использовать obj-par-val, то будет происходить проверка на равенство значения параметра объекта и значения записаного в поле val.

Если использовать obj-par-op-val, то будет происходить проверка в соответствии с операцией сравнения значения параметра объекта и значения записаного в поле val.

По отдельноси каждый из if-ов возвращает значение true или false, далее с if-ами можно создавать логические выражения, в том числе со знаками приоритета(скобочками), например в set-aх.

Логические операции:
* , - и
* & - и
* | - или
* ! - не

Пример записи логического выражения в поле if set-a: (1&2)|(3&(!4))