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

Table

2016-06-13T06:33:27Z

Epahomov: /* Основные параметры таблицы */

{{TOC right}}
'''Общие параметры'''

Таблица имеет набор стандартных параметров (см. описание параметров [[Object|Object]]).

[[Файл:Tabletext.png]]

Таблица (Тable) является универсальным объектом. Она может использоваться как:

- самостоятельный элемент включая в себя различные элементы ([[Image|Image]], [[Text|Text]], [[Button|Button]], [[Machine|Machine]] и пр.);

- дополнение к таким объектам как [[Patchwork|Patchwork]], [[HiddenList|HiddenList]], [[Invetory|Invetory]] и др. Выступая в роли «поля» для отображения их элементов.

[[Файл:Table4.png|right]]

[[Файл:Table5.png]]

[[Файл:Table6.png]]

Для того чтобы поместить объекты в таблицу, необходимо внести их в группу таблицы в дереве проекта.
Заполнение таблицы происходит по столбцам. Если в таблице число видимых колонок/строчек меньше общего количества колонок/строчек, то, в таком случае, таблицу можно листать в нужном направлении.

== Основные параметры таблицы ==

[[Файл:Table new1.png|300px|right]]
'''Группа - таблица'''

''(Курсивом в скобках указан id параметра, или состояния)''
*'''подложка объект''' ''(bgobj)'' - Объект картинка на которой выводится таблица. Задумывалась картинка, которая будет тайлиться до размеров таблицы. В дереве не важно где хранить этот объект.
*'''колонок''' ''(cols)'' - Максимальное число колонок (ячейки должны поместиться).
*'''колонок видно''' ''(cShw)'' - Количество колонок, видимых в области вывода таблицы (если включен флаг: ширина фиксированная).
*'''строчек''' ''(rows)'' - Максимальное число строчек (ячейки должны поместиться).
*'''строчек видно''' ''(rShw)'' - Количество строчек, видимых в области вывода таблицы (если включен флаг: высота фиксированная).
*'''скорость листания''' ''(vel)'' - Скорость листания страниц (точек/секунду).
*'''отсечение''' ''(cut)'' - "ширина и высота" - обрезать графику таблицы по ширине и высоте; "ширина" - обрезать графику таблицы по ширине; "высота" - обрезать графику таблицы по высоте; "нет" - не обрезать.
*'''добавлять по строкам''' ''(bystr)'' - 1 - добавлять по строкам; 0 - добавлять по столбцам.
*'''центрировать''' ''(cntr)'' - "нет" - не центрировать (ячейки заполняются начиная от левого края таблицы); "растянуть" - если количество заполненных ячеек меньше видимых, то они равномерно растягиваются по длине таблицы (при этом только увеличивается расстояние между ячейками); "прижать к центру" - если количество заполненных ячеек меньше видимых, то эти ячейки располагаются по центру таблицы (при этом расстояния между ячейками не увеличиваются).
*'''добавлять только видимые''' - добавлять только видимые объекты таблицы (vis=1)

'''Группа - бордюры таблицы'''

*'''бордюр X''' ''(dx)'' - Ширина бордюра по x (отступ во внутрь слева и справа) от подложки или от ширины объекта для отображения видимых ячеек.
*'''бордюр Y''' ''(dy)'' - Ширина бордюра по y (отступ во внутрь сверху и снизу) от подложки или от высоты объекта для отображения видимых ячеек.
*'''отступ X''' ''(dxC)'' - Отступ по x во внутрь (слева и справа) в ячейке, чтобы содержимое соседних ячеек не сливалось.
*'''отступ Y''' ''(dyC)'' - Отступ по y во внутрь (сверху и снизу) в ячейке, чтобы содержимое соседних ячеек не сливалось.

'''Группа - смещение'''

*'''смещ. X''' - Смещение по x объекта в ячейке.
*'''смещ. Y''' - Смещение по y объекта в ячейке.
*'''фон X''' - Смещение по x фона в ячейке.
*'''фон Y''' - Смещение по y фона в ячейке.
*'''зачеркивания X''' - Смещение по x ресурса зачеркивания ячейки.
*'''зачеркивания Y''' - Смещение по y ресурса зачеркивания ячейки.

'''Группа - размеры ячеек'''

*'''фон''' - Графический ресурс фона ячейки. Перетаскивается мышкой из редактора ресурсов. Может отсутствовать.
*'''ширина фиксированная''' - Если равно 1, то ширины колонок будут фиксированные и определяются полем: колонок видно.
*'''высота фиксированная''' - Если равно 1, то высоты строчек будут фиксированные и определяются полем: строчек видно.
*'''сжимать''' - Если равно 1, то будет сжимать картинки без искажения пропорций, чтобы они помещались в ячейке.
*'''текущая колонка''' - Номер первой видимой колонки, начиная с 0-ля.
*'''текущая строка''' - Номер первой видимой строки, начиная с 0-ля.

'''Группа - параметры текста'''

*'''текстID''' ''(tTxtID)'' - Текст (id из редактора текста), отображаемый построчно в таблице.
*'''текст''' ''(tTxt)'' - Cтрока, отображаемая в таблице.
*'''имя''' ''(fn)'' - Номер шрифта - целое число, начиная с 0 (порядковый номер шрифта).
*'''размер''' ''(fs)'' - Размер шрифта в поинтах.
*'''цвет 1''' ''(fc1)'' - Цвет текста обычного вида.
*'''цвет 2''' ''(fc2)'' - Цвет текста помеченной ячейки.
*'''alpha2''' ''(al2)'' - Прозрачность картинки в помеченной ячейке.
*'''поз. гориз.''' ''(cellAlHor)'' - Горизонтальное выравнивание текста (0 - нет выравнивания; 1 - прижать к левому краю; 2 - центр; 3 - к правому).
*'''поз. верт.''' ''(cellAlVer)'' - Вертикальное выравнивание текста (0 - нет выравнивания; 1 - прижать к верхнему краю; 2 - центр; 3 - к нижнему).
*'''цвет зачеркивания 1''' ''(str_c1)'' - Цвет зачеркивания текста обычного вида.
*'''цвет зачеркивания 2''' ''(str_c2)'' - Цвет зачеркивания текста помеченной ячейки.
*'''ресурс зачеркивания''' ''(crRes)'' - Графический ресурс зачеркивания ячейки. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Может отсутствовать.
*'''толщина зачеркивания''' ''(str_s)'' - Толщина зачеркивания в пикселях.
*'''отступ''' ''(skip)'' - Вертикальное расстояние в пикселях в одной ячейке между словами в словосочетании (например в словосочетании Морская звезда, если оно не помещается горизонтально в одну ячейку - это вертикальное расстояние между Морская и звезда).

== Дополнительные параметры ==
'''Группа - Управление'''

[[Файл:Table new2.png|300px|right]]

Когда таблица листаемая, можно отображать индикаторы страниц. У каждого индикатора два состояния: вкл - если соответствующая страница видна на экране и выкл в противоположном случае. Нажав на соответствующий индикатор, таблица перемещается со скоростью, указанной в параметре "скорость листания"
на необходимую страницу.

*'''индикатор ВКЛ''' - Картинка включенного индикатора.
*'''индикатор ВЫКЛ''' - Картинка выключенного индикатора.
*'''левая кнопка''' - Кнопка для листания списка влево.
*'''правая кнопка''' - Кнопка для листания списка вправо.
*'''верхняя кнопка'''- Кнопка для листания списка вверх.
*'''нижняя кнопка''' - Кнопка для листания списка вниз.
*'''отступ X''' - Отступ по x от таблицы.
*'''отступ Y''' - Отступ по y от таблицы.
*'''отступ W''' - Отступ между ячейками таблицы индексов.

'''Группа - листание'''

*'''тип листания''' - Тип листания таблицы: 0 - по страницам; 1 - в зависимости от скорости (IOS).
*'''листать как книгу''' - да - при нечетном колличестве добавляемых страниц будут добавляться пустые ячейки; нет - листание по колличеству видимых ячеек.
*'''старт листания''' - Смещение в точках, начиная с которого скролим таблицу.
*'''гориз. листание''' - Горизонтальное листание таблицы: 0 - выключено; 1 - включено.
*'''вертик. листание''' - Вертикальное листание таблицы: 0 - выключено; 1 - включено.
*'''цикл. листание''' - Циклическое листание таблицы: 0 - выключено; 1 - включено.
*'''листание 360 градусов''' - Разрешено листание в двух направлениях: 0 - выключено; 1 - включено.
*'''затухание''' - Затухание скорости листания таблицы: 0 - выключено; 1 - включено.

== Добавляемые параметры ==
[[Файл:Table2_1.PNG|right]]
Открывается при нажатии правой кнопки мыши в поле параметров таблицы.

[[Файл:+.png]] '''ширина настраиваемая'''
*'''ширина колонок''' - Через точку с запятой указываем ширину колонок по-порядку.
[[Файл:+.png]] '''высота настраиваемая'''
*'''высота строчек''' - Через точку с запятой указываем высоту строчек по-порядку.
[[Файл:+.png]] '''добавить ячейку в таблицу'''
*'''текстID''' - Строка (id из редактора строк), отображаемая в ячейке.
*'''текст''' - Строка, отображаемая в ячейке.
*'''картинка''' - Картинка, рисуемая в ячейке (строки игнорируются).

[[Файл:+.png]] '''изменить состояние объекта''' - при тапе
*'''объект''' - Строка которого мы меняем.
*'''состояние''' - Значение нового состояния.

[[Файл:+.png]] '''при листании влево - изменить состояние объекта'''
*'''объект''' - При смене текущей страницы в таблице перевести объект в состояние из следующего поля.
*'''состояние''' - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''при листании влево - изменить параметр (свойство) объекта'''
*'''объект''' - При смене текущей страницы в таблице этот объект меняет свой параметр.
*'''свойство''' - Параметр, который мы изменяем.
*'''значение''' - Новое значение параметра.

[[Файл:+.png]] '''при листании вправо - изменить состояние объекта'''
*'''объект''' - При смене текущей страницы в таблице перевести объект в состояние из следующего поля.
*'''состояние''' - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''при листании вправо - изменить параметр (свойство) объекта'''
*'''объект''' - При смене текущей страницы в таблице этот объект меняет свой параметр.
*'''свойство''' - Параметр, который мы изменяем.
*'''значение''' - Новое значение параметра.

[[Файл:+.png]] '''при листании вниз - изменить состояние объекта'''
*'''объект''' - При смене текущей страницы в таблице перевести объект в состояние из следующего поля.
*'''состояние''' - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''при листании вниз - изменить параметр (свойство) объекта'''
*'''объект''' - При смене текущей страницы в таблице этот объект меняет свой параметр.
*'''свойство''' - Параметр, который мы изменяем.
*'''значение''' - Новое значение параметра.

[[Файл:+.png]] '''при листании вверх - изменить состояние объекта'''
*'''объект''' - При смене текущей страницы в таблице перевести объект в состояние из следующего поля.
*'''состояние''' - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''при листании вверх - изменить параметр (свойство) объекта'''
*'''объект''' - При смене текущей страницы в таблице этот объект меняет свой параметр.
*'''свойство''' - Параметр, который мы изменяем.
*'''значение''' - Новое значение параметра.

== Состояния таблицы ==
Так же мы можем управлять таблицей изменяя ее состояния.

*'''first''' - Перелистнуть на первую страницу таблицы.
*'''last''' - Перелистнуть на последнюю страницу таблицы.
*'''prev''' - Перелистнуть на предыдущую страницу таблицы (влево по горизонтали).
*'''next''' - Перелистнуть на следующую страницу таблицы (вправо по горизонтали).
*'''up''' - Перелистнуть на следующую страницу таблицы (вверх по вертикали).
*'''down''' - Перелистнуть на предыдущую страницу таблицы (вниз по вертикали).
*'''refresh''' - Обновить таблицу.
*'''reload''' - перезаполнить таблицу. Необходимо в случае, когда объекты в таблицу добавляются путем установки таблицы в качестве родителя (передаём сразу при смене родителя, после каждой смены родителя).
*'''flyto''' - Таблица плавно приедет к значению curRow и curCol, если они были изменены.
*'''maxRow''' - Количество заполненных строк.
*'''maxCol''' - Количество заполненных колонок.
*'''curRow''' - Текущая строка.
*'''curCol''' - Текущая колонка.
Если изменить таблице значение параметра (текущего рядка или столбика), то после необходимо передать таблице состояние refresh или flyto, чтобы увидеть изменения. При refresh рядок или столбец поменяется мгновенно, при flyto таблица "приплывет" к нужному рядку или столбцу.

== Использование таблицы для анимации ==

=== Использование состояния flyto ===

Иногда нужно получить анимацию выезда (или другого движения) некоторого объекта (окна, рисунка и тд) на экран. Это можно сделать с помощью таблицы. Ниже приведен пример для движения вниз (с постепенным пропаданием объекта из видимости). Делаем следующее: создаем таблицу(ее параметры приведены на рисунке) нужного размера(как минимум, чтобы поместился нужный объект). В нее помещаем 2 объекта: пустой рисунок(при движении он заменит собой движущийся объект) и объект-родитель(image размером 0*0 ), в котором находится объект, который будет двигаться.

'''Важно!''' Для корректного отображения объекта в таблице, нужно:
* Создать таблицу и разместить ее нужным образом,.
* Разместить объект родитель посередине движущегося объекта
* Поместить движущийся объект в родителя
* Поместить родителя в таблицу

Если нужно подкорректировать положение объекта в таблице, то нужно изменять именно его координаты. Изменение координат родителя не приведет к смещению объекта на экране вьювера.

Для запуска анимации таблице нужно изменить значение текущей строки (столбца, при горизонтальном движении), после чего передать ей состояние
flyto. Скорость анимации можно настроить изменяя параметр таблицы - скорость листания.

[[Файл:Tblanimmove.png|250px|Расположение в дереве проекта]] [[Файл:Animmovestate.png|250px|Машина, запускающая анимацию]] [[Файл:Tableanimmove.png|250px|Параметры таблицы]]

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

В данном случае нужно движение по вертикали вниз. Для этого таблица имеет следующие параметры: 1 столбец, 2 строки, нелистаемая( тк не нужно взаимодействовать с объектами ). Принцип работы прост ячейка (1,0) заменяется на (0,0).

=== Передвижение предмета под границу окна ===

Такой же эффект можно достичь, если использовать ректангл. Помещаем окно в ректангл и задаем ему параметр отсечение.
Использование ректангла потребляет меньше ресурсов.

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

Для этого помещаем наше окно в родительский объект(до помещения окна в родителя, родитель должен находится в центре окна). После создаем таблицу по размеру окна, и располагаем ее на сцене нужным образом. Потом помещаем в нее объект-родитель. Теперь таблица является границами видимости окошка и его элементов. Всё, что будет за границами таблицы будет невидимо. После этого, желательно, поместить таблицу в image 0*0.

[[Файл:Wndtable.png|250px|Расположение в дереве проекта]][[Файл:Parwndtabl.png|250px|Параметры таблицы]]

В данном случае у таблицы 1 столбец, 1 строка и 1 ячейка, в которой находится наше окошко. Листаться объекты в таблице не должны, но с ними нужно взаимодействовать. Если отключить листание вообще, то объекты не реагируют на воздействие. Для того, чтобы объекты вели себя корректно, делаем следующее: включаем листание 360 градусов (по горизонтали и вертикали) и выставляем большое значение в параметра "старт листание(чтобы клик по окошку таблица не воспринимала как попытку листания)".

== Пример ==

[http://fs5.absolutist.com/files/wikisample/Table.rar Download]

[[Category:Main objects]]

Planet

2016-04-15T12:52:35Z

Epahomov: /* Состояния объекта */

{{TOC right}}
'''Planet''' - встроенный объект редактора, который реализует механику игры. Игра представляет собой бесконечную "тапалку" и завершается в случае промаха мимо планеты.

== Основные параметры ==
[[Файл:Planet_settigs.png|thumb|right|822|Основные параметры]]
Кроме базовых параметров [[Object|объекта]], имеет ряд специализированных параметров.

'''Размер экрана''' - Размер игрового поля за пределами которого планеты не будут рисоваться.
*'''Ширина''' ''(ws)'' - Размер поля по оси X.
*'''Высота''' ''(hs)'' - Размер поля по оси Y.
'''Положение первой планет''' - Расстояние от стартовой планеты, с которой игрок начинает игру до первой планеты на которую он может приземлиться.
*'''x''' ''(fplx)'' - Координаты первой планеты по оси X.
*'''y''' ''(fply)'' - Координаты первой планеты по оси Y.
'''Расстояние между планетами''' - Диапазоны расстояний между планетами (не учитывается первая).
*'''min x''' ''(minx)'' - Минимальное расстояние между планетами по оси X.
*'''max x''' ''(maxx)'' - Максимальное расстояние между планетами по оси X.
*'''min y''' ''(miny)'' - Минимальное расстояние между планетами по оси Y.
*'''max y''' ''(maxy)'' - Максимальное расстояние между планетами по оси Y.
'''Звуки игры''' - Расстояние от стартовой планеты, с которой игрок начинает игру до первой планеты на которую он может приземлиться.
*'''Прыжок''' ''(sndJ)'' - Звук, который воспроизводится при прыжке.
*'''Приземление''' ''(sndG)'' - Звук удачного приземления на планету
*'''Улетел''' ''(sndB)'' - Звук, когда астронавт улетел за пределы игрового экрана/попал на солнце
'''Времена игры'''
*'''Перемещение камеры''' ''(tmMovCam)'' - Время за которое перемещается камера за астронавтом.
'''Скорости игры'''
*'''Вращения''' ''(planetSpeed)'' - Средняя скорость вращения планеты.
*'''Разброс скорости вращения''' ''(planetSpeedDISP)'' - Дисперсия значений скорости вращения планеты.
*'''Прыжка''' ''(vjump)'' - Скорость прыжка совершаемого игроком.
'''Игрок-астронавт'''
*'''Графика''' ''(playerClip)'' - Графический ресурс игрового персонажа. Перетаскивается из базы ресурсов.
*'''Масса''' ''(playerw)'' - Масса астронавта.
'''Эффекты'''
*'''Приземление''' ''(eff_d)'' - Воспроизводится во время "приземления" астронавта на планету. Должен иметь состояние 'beg'.
*'''Прыжок''' ''(eff_u)'' - Звук удачного приземления на планету
*'''Полет''' ''(eff_f)'' - Воспроизводится во время "отталкивания" астронавта от планеты. Должен иметь состояние 'beg'.
'''Игровые очки'''
*'''Объект score''' ''(score)'' - Объект типа "каунтер". Счетчик очков
*'''кол-во за прыжок''' ''(sc_jp)' - Кол-во очков, которые начисляются за каждое успешное приземление на планету.
*'''кол-во за монету''' ''(sc_cn)' - Кол-во очков, которые начисляются за каждую подобранную монету.
'''Бонусные монеты'''
*'''Графика''' ''(coinClip)'' - Графический ресурс/анимация монет, которые вращаются вокруг планет и указывают правильный маршрут. Перетаскивается из базы ресурсов.
'''Монеты-путь'''
*'''кол-во монет''' ''(coinNum)'' - Количество монет, которые указывают правильный маршрут между планетами.
*'''Равномерно расставлять''' ''(cbCoin)'' - Чекбокс, который определяет как размещать звезды между планетами. "Да" - равномерно. "Нет" - использовать параметр "coinDist".
*'''Расстояние между монетами''' ''(coinDist)'' - Расстояние между монетами.
'''Монеты-планеты'''
*'''вероятность монет''' ''(coinProb)'' - Количество монет, которые указывают правильный маршрут между планетами.
*'''Кол-во монет вокруг планет''' ''(coinNumPl)'' - Чекбокс, который определяет как размещать звезды между планетами. "Да" - равномерно. "Нет" - использовать параметр "coinDist".
*'''Расстояние от планет''' ''(coinDistPl)'' - Расстояние между монетами.
*'''Радиус разворота''' ''(radOfRot)'' - Расстояние до планеты, приближаясь к которой, астронавт будет переворачиваться ногами вниз.
== Добавляемые параметры ==
[[Файл:Add_attribute.png|thumb|right|500|Добавляемые свойства]]
'''Добавить планету'''
*'''Графика''' ''(pl_gr)''- Графика планет. Добавляется из редактора ресурсов. В качестве ресурса может использоваться анимация.
*'''Эффект''' ''(eff_pl)''- Эффект, который рисует под планетой. Так же может быть и анимацией.
*'''Масса''' ''(pl_wg)''- Масса планеты
*'''Радиус''' ''(pl_rd)''- Радиус планеты в px. Если == 0, то используется размер графики
'''Добавить Солнце'''
*'''Графика''' ''(bh_gr)''- Графика "солнца". Добавляется из редактора ресурсов. В качестве ресурса может использоваться анимация.
*'''Эффект''' ''(eff_bh)''- Эффект, который рисует под "солнцем". Так же может быть и анимацией.
*'''Масса''' ''(bh_wg)''- Масса планеты
*'''Радиус''' ''(bh_rd)''- Радиус "солнца" в px. Если == 0, то используется размер графики
'''Добавить звук монеты''' - позволяет последовательно воспроизводить звуки подбора монет. Если задано больше 1-го звука, то первая монетка во время "подбора" воспроизведет 1-й звук, вторая - 2-й звук, и т.д.
*'''Звук''' ''(sndM)''- Звук при подборе монеты. Добавляется из редактора ресурсов.
== Состояния объекта ==
*'''reborn''' - Используется для "последнего шанса". В случае, если игрок промахнулся мимо планеты, у него должна быть возможность вернуться на крайнюю планету на которой он находился. При вызове этого состояния персонаж перемещается на планету с которой совершал прыжок.
*'''init''' - состояние с весьма ожидаемой реакцией. Объект начинает свою работу с самого начала. С первой планеты и полностью обнуляются заработанные монеты

Planet

2016-04-15T12:46:58Z

Epahomov:

{{TOC right}}
'''Planet''' - встроенный объект редактора, который реализует механику игры. Игра представляет собой бесконечную "тапалку" и завершается в случае промаха мимо планеты.

== Основные параметры ==
[[Файл:Planet_settigs.png|thumb|right|822|Основные параметры]]
Кроме базовых параметров [[Object|объекта]], имеет ряд специализированных параметров.

'''Размер экрана''' - Размер игрового поля за пределами которого планеты не будут рисоваться.
*'''Ширина''' ''(ws)'' - Размер поля по оси X.
*'''Высота''' ''(hs)'' - Размер поля по оси Y.
'''Положение первой планет''' - Расстояние от стартовой планеты, с которой игрок начинает игру до первой планеты на которую он может приземлиться.
*'''x''' ''(fplx)'' - Координаты первой планеты по оси X.
*'''y''' ''(fply)'' - Координаты первой планеты по оси Y.
'''Расстояние между планетами''' - Диапазоны расстояний между планетами (не учитывается первая).
*'''min x''' ''(minx)'' - Минимальное расстояние между планетами по оси X.
*'''max x''' ''(maxx)'' - Максимальное расстояние между планетами по оси X.
*'''min y''' ''(miny)'' - Минимальное расстояние между планетами по оси Y.
*'''max y''' ''(maxy)'' - Максимальное расстояние между планетами по оси Y.
'''Звуки игры''' - Расстояние от стартовой планеты, с которой игрок начинает игру до первой планеты на которую он может приземлиться.
*'''Прыжок''' ''(sndJ)'' - Звук, который воспроизводится при прыжке.
*'''Приземление''' ''(sndG)'' - Звук удачного приземления на планету
*'''Улетел''' ''(sndB)'' - Звук, когда астронавт улетел за пределы игрового экрана/попал на солнце
'''Времена игры'''
*'''Перемещение камеры''' ''(tmMovCam)'' - Время за которое перемещается камера за астронавтом.
'''Скорости игры'''
*'''Вращения''' ''(planetSpeed)'' - Средняя скорость вращения планеты.
*'''Разброс скорости вращения''' ''(planetSpeedDISP)'' - Дисперсия значений скорости вращения планеты.
*'''Прыжка''' ''(vjump)'' - Скорость прыжка совершаемого игроком.
'''Игрок-астронавт'''
*'''Графика''' ''(playerClip)'' - Графический ресурс игрового персонажа. Перетаскивается из базы ресурсов.
*'''Масса''' ''(playerw)'' - Масса астронавта.
'''Эффекты'''
*'''Приземление''' ''(eff_d)'' - Воспроизводится во время "приземления" астронавта на планету. Должен иметь состояние 'beg'.
*'''Прыжок''' ''(eff_u)'' - Звук удачного приземления на планету
*'''Полет''' ''(eff_f)'' - Воспроизводится во время "отталкивания" астронавта от планеты. Должен иметь состояние 'beg'.
'''Игровые очки'''
*'''Объект score''' ''(score)'' - Объект типа "каунтер". Счетчик очков
*'''кол-во за прыжок''' ''(sc_jp)' - Кол-во очков, которые начисляются за каждое успешное приземление на планету.
*'''кол-во за монету''' ''(sc_cn)' - Кол-во очков, которые начисляются за каждую подобранную монету.
'''Бонусные монеты'''
*'''Графика''' ''(coinClip)'' - Графический ресурс/анимация монет, которые вращаются вокруг планет и указывают правильный маршрут. Перетаскивается из базы ресурсов.
'''Монеты-путь'''
*'''кол-во монет''' ''(coinNum)'' - Количество монет, которые указывают правильный маршрут между планетами.
*'''Равномерно расставлять''' ''(cbCoin)'' - Чекбокс, который определяет как размещать звезды между планетами. "Да" - равномерно. "Нет" - использовать параметр "coinDist".
*'''Расстояние между монетами''' ''(coinDist)'' - Расстояние между монетами.
'''Монеты-планеты'''
*'''вероятность монет''' ''(coinProb)'' - Количество монет, которые указывают правильный маршрут между планетами.
*'''Кол-во монет вокруг планет''' ''(coinNumPl)'' - Чекбокс, который определяет как размещать звезды между планетами. "Да" - равномерно. "Нет" - использовать параметр "coinDist".
*'''Расстояние от планет''' ''(coinDistPl)'' - Расстояние между монетами.
*'''Радиус разворота''' ''(radOfRot)'' - Расстояние до планеты, приближаясь к которой, астронавт будет переворачиваться ногами вниз.
== Добавляемые параметры ==
[[Файл:Add_attribute.png|thumb|right|500|Добавляемые свойства]]
'''Добавить планету'''
*'''Графика''' ''(pl_gr)''- Графика планет. Добавляется из редактора ресурсов. В качестве ресурса может использоваться анимация.
*'''Эффект''' ''(eff_pl)''- Эффект, который рисует под планетой. Так же может быть и анимацией.
*'''Масса''' ''(pl_wg)''- Масса планеты
*'''Радиус''' ''(pl_rd)''- Радиус планеты в px. Если == 0, то используется размер графики
'''Добавить Солнце'''
*'''Графика''' ''(bh_gr)''- Графика "солнца". Добавляется из редактора ресурсов. В качестве ресурса может использоваться анимация.
*'''Эффект''' ''(eff_bh)''- Эффект, который рисует под "солнцем". Так же может быть и анимацией.
*'''Масса''' ''(bh_wg)''- Масса планеты
*'''Радиус''' ''(bh_rd)''- Радиус "солнца" в px. Если == 0, то используется размер графики
'''Добавить звук монеты''' - позволяет последовательно воспроизводить звуки подбора монет. Если задано больше 1-го звука, то первая монетка во время "подбора" воспроизведет 1-й звук, вторая - 2-й звук, и т.д.
*'''Звук''' ''(sndM)''- Звук при подборе монеты. Добавляется из редактора ресурсов.
== Состояния объекта ==
*'''reborn''' - единственное полезное состояние, которое мы можем вызывать извне. Используется для "последнего шанса". В случае, если игрок промахнулся мимо планеты, у него должна быть возможность вернуться на крайнюю планету на которой он находился. При вызове этого состояния персонаж перемещается на планету с которой совершал прыжок.

Файл:Planet settigs.png

2016-04-15T12:45:49Z

Epahomov:

Planet

2016-04-15T12:43:28Z

Epahomov:

{{TOC right}}
'''Planet''' - встроенный объект редактора, который реализует механику игры. Игра представляет собой бесконечную "тапалку" и завершается в случае промаха мимо планеты.

== Основные параметры ==
Кроме базовых параметров [[Object|объекта]], имеет ряд специализированных параметров.

'''Размер экрана''' - Размер игрового поля за пределами которого планеты не будут рисоваться.
*'''Ширина''' ''(ws)'' - Размер поля по оси X.
*'''Высота''' ''(hs)'' - Размер поля по оси Y.
'''Положение первой планет''' - Расстояние от стартовой планеты, с которой игрок начинает игру до первой планеты на которую он может приземлиться.
*'''x''' ''(fplx)'' - Координаты первой планеты по оси X.
*'''y''' ''(fply)'' - Координаты первой планеты по оси Y.
'''Расстояние между планетами''' - Диапазоны расстояний между планетами (не учитывается первая).
*'''min x''' ''(minx)'' - Минимальное расстояние между планетами по оси X.
*'''max x''' ''(maxx)'' - Максимальное расстояние между планетами по оси X.
*'''min y''' ''(miny)'' - Минимальное расстояние между планетами по оси Y.
*'''max y''' ''(maxy)'' - Максимальное расстояние между планетами по оси Y.
'''Звуки игры''' - Расстояние от стартовой планеты, с которой игрок начинает игру до первой планеты на которую он может приземлиться.
*'''Прыжок''' ''(sndJ)'' - Звук, который воспроизводится при прыжке.
*'''Приземление''' ''(sndG)'' - Звук удачного приземления на планету
*'''Улетел''' ''(sndB)'' - Звук, когда астронавт улетел за пределы игрового экрана/попал на солнце
'''Времена игры'''
*'''Перемещение камеры''' ''(tmMovCam)'' - Время за которое перемещается камера за астронавтом.
'''Скорости игры'''
*'''Вращения''' ''(planetSpeed)'' - Средняя скорость вращения планеты.
*'''Разброс скорости вращения''' ''(planetSpeedDISP)'' - Дисперсия значений скорости вращения планеты.
*'''Прыжка''' ''(vjump)'' - Скорость прыжка совершаемого игроком.
'''Игрок-астронавт'''
*'''Графика''' ''(playerClip)'' - Графический ресурс игрового персонажа. Перетаскивается из базы ресурсов.
*'''Масса''' ''(playerw)'' - Масса астронавта.
'''Эффекты'''
*'''Приземление''' ''(eff_d)'' - Воспроизводится во время "приземления" астронавта на планету. Должен иметь состояние 'beg'.
*'''Прыжок''' ''(eff_u)'' - Звук удачного приземления на планету
*'''Полет''' ''(eff_f)'' - Воспроизводится во время "отталкивания" астронавта от планеты. Должен иметь состояние 'beg'.
'''Игровые очки'''
*'''Объект score''' ''(score)'' - Объект типа "каунтер". Счетчик очков
*'''кол-во за прыжок''' ''(sc_jp)' - Кол-во очков, которые начисляются за каждое успешное приземление на планету.
*'''кол-во за монету''' ''(sc_cn)' - Кол-во очков, которые начисляются за каждую подобранную монету.
'''Бонусные монеты'''
*'''Графика''' ''(coinClip)'' - Графический ресурс/анимация монет, которые вращаются вокруг планет и указывают правильный маршрут. Перетаскивается из базы ресурсов.
'''Монеты-путь'''
*'''кол-во монет''' ''(coinNum)'' - Количество монет, которые указывают правильный маршрут между планетами.
*'''Равномерно расставлять''' ''(cbCoin)'' - Чекбокс, который определяет как размещать звезды между планетами. "Да" - равномерно. "Нет" - использовать параметр "coinDist".
*'''Расстояние между монетами''' ''(coinDist)'' - Расстояние между монетами.
'''Монеты-планеты'''
*'''вероятность монет''' ''(coinProb)'' - Количество монет, которые указывают правильный маршрут между планетами.
*'''Кол-во монет вокруг планет''' ''(coinNumPl)'' - Чекбокс, который определяет как размещать звезды между планетами. "Да" - равномерно. "Нет" - использовать параметр "coinDist".
*'''Расстояние от планет''' ''(coinDistPl)'' - Расстояние между монетами.
*'''Радиус разворота''' ''(radOfRot)'' - Расстояние до планеты, приближаясь к которой, астронавт будет переворачиваться ногами вниз.
== Добавляемые параметры ==
[[Файл:Add_attribute.png|thumb|right|500|Добавляемые свойства]]
'''Добавить планету'''
*'''Графика''' ''(pl_gr)''- Графика планет. Добавляется из редактора ресурсов. В качестве ресурса может использоваться анимация.
*'''Эффект''' ''(eff_pl)''- Эффект, который рисует под планетой. Так же может быть и анимацией.
*'''Масса''' ''(pl_wg)''- Масса планеты
*'''Радиус''' ''(pl_rd)''- Радиус планеты в px. Если == 0, то используется размер графики
'''Добавить Солнце'''
*'''Графика''' ''(bh_gr)''- Графика "солнца". Добавляется из редактора ресурсов. В качестве ресурса может использоваться анимация.
*'''Эффект''' ''(eff_bh)''- Эффект, который рисует под "солнцем". Так же может быть и анимацией.
*'''Масса''' ''(bh_wg)''- Масса планеты
*'''Радиус''' ''(bh_rd)''- Радиус "солнца" в px. Если == 0, то используется размер графики
'''Добавить звук монеты''' - позволяет последовательно воспроизводить звуки подбора монет. Если задано больше 1-го звука, то первая монетка во время "подбора" воспроизведет 1-й звук, вторая - 2-й звук, и т.д.
*'''Звук''' ''(sndM)''- Звук при подборе монеты. Добавляется из редактора ресурсов.
== Состояния объекта ==
*'''reborn''' - единственное полезное состояние, которое мы можем вызывать извне. Используется для "последнего шанса". В случае, если игрок промахнулся мимо планеты, у него должна быть возможность вернуться на крайнюю планету на которой он находился. При вызове этого состояния персонаж перемещается на планету с которой совершал прыжок.

Planet

2016-04-15T12:28:26Z

Epahomov: Новая страница: «{{TOC right}} '''Planet''' - встроенный объект редактора, который реализует механику игры. Игра пред…»

{{TOC right}}
'''Planet''' - встроенный объект редактора, который реализует механику игры. Игра представляет собой бесконечную "тапалку" и завершается в случае промаха мимо планеты.

== Основные параметры ==
Кроме базовых параметров [[Object|объекта]], имеет ряд специализированных параметров.

'''Размер экрана''' - Размер игрового поля за пределами которого планеты не будут рисоваться.
*'''Ширина''' ''(ws)'' - Размер поля по оси X.
*'''Высота''' ''(hs)'' - Размер поля по оси Y.
'''Положение первой планет''' - Расстояние от стартовой планеты, с которой игрок начинает игру до первой планеты на которую он может приземлиться.
*'''x''' ''(fplx)'' - Координаты первой планеты по оси X.
*'''y''' ''(fply)'' - Координаты первой планеты по оси Y.
'''Расстояние между планетами''' - Диапазоны расстояний между планетами (не учитывается первая).
*'''min x''' ''(minx)'' - Минимальное расстояние между планетами по оси X.
*'''max x''' ''(maxx)'' - Максимальное расстояние между планетами по оси X.
*'''min y''' ''(miny)'' - Минимальное расстояние между планетами по оси Y.
*'''max y''' ''(maxy)'' - Максимальное расстояние между планетами по оси Y.
'''Звуки игры''' - Расстояние от стартовой планеты, с которой игрок начинает игру до первой планеты на которую он может приземлиться.
*'''Прыжок''' ''(sndJ)'' - Звук, который воспроизводится при прыжке.
*'''Приземление''' ''(sndG)'' - Звук удачного приземления на планету
*'''Улетел''' ''(sndB)'' - Звук, когда астронавт улетел за пределы игрового экрана/попал на солнце
'''Времена игры'''
*'''Перемещение камеры''' ''(tmMovCam)'' - Время за которое перемещается камера за астронавтом.
'''Скорости игры'''
*'''Вращения''' ''(planetSpeed)'' - Средняя скорость вращения планеты.
*'''Разброс скорости вращения''' ''(planetSpeedDISP)'' - Дисперсия значений скорости вращения планеты.
*'''Прыжка''' ''(vjump)'' - Скорость прыжка совершаемого игроком.
'''Игрок-астронавт'''
*'''Графика''' ''(playerClip)'' - Графический ресурс игрового персонажа. Перетаскивается из базы ресурсов.
*'''Масса''' ''(playerw)'' - Масса астронавта.
'''Эффекты'''
*'''Приземление''' ''(eff_d)'' - Воспроизводится во время "приземления" астронавта на планету. Должен иметь состояние 'beg'.
*'''Прыжок''' ''(eff_u)'' - Звук удачного приземления на планету
*'''Полет''' ''(eff_f)'' - Воспроизводится во время "отталкивания" астронавта от планеты. Должен иметь состояние 'beg'.
'''Игровые очки'''
*'''Объект score''' ''(score)'' - Объект типа "каунтер". Счетчик очков
*'''кол-во за прыжок''' ''(sc_jp)' - Кол-во очков, которые начисляются за каждое успешное приземление на планету.
*'''кол-во за монету''' ''(sc_cn)' - Кол-во очков, которые начисляются за каждую подобранную монету.
'''Бонусные монеты'''
*'''Графика''' ''(coinClip)'' - Графический ресурс/анимация монет, которые вращаются вокруг планет и указывают правильный маршрут. Перетаскивается из базы ресурсов.
'''Монеты-путь'''
*'''кол-во монет''' ''(coinNum)'' - Количество монет, которые указывают правильный маршрут между планетами.
*'''Равномерно расставлять''' ''(cbCoin)'' - Чекбокс, который определяет как размещать звезды между планетами. "Да" - равномерно. "Нет" - использовать параметр "coinDist".
*'''Расстояние между монетами''' ''(coinDist)'' - Расстояние между монетами.
'''Монеты-планеты'''
*'''вероятность монет''' ''(coinProb)'' - Количество монет, которые указывают правильный маршрут между планетами.
*'''Кол-во монет вокруг планет''' ''(coinNumPl)'' - Чекбокс, который определяет как размещать звезды между планетами. "Да" - равномерно. "Нет" - использовать параметр "coinDist".
*'''Расстояние от планет''' ''(coinDistPl)'' - Расстояние между монетами.
*'''Радиус разворота''' ''(radOfRot)'' - Расстояние до планеты, приближаясь к которой, астронавт будет переворачиваться ногами вниз.
== Добавляемые параметры ==
[[Файл:Add_attribute.png|thumb|right|500|Добавляемые свойства]]
'''Добавить планету'''
*'''Графика''' ''(pl_gr)''- Графика планет. Добавляется из редактора ресурсов. В качестве ресурса может использоваться анимация.
*'''Эффект''' ''(eff_pl)''- Эффект, который рисует под планетой. Так же может быть и анимацией.
*'''Масса''' ''(pl_wg)''- Масса планеты
*'''Радиус''' ''(pl_rd)''- Радиус планеты в px. Если == 0, то используется размер графики
'''Добавить Солнце'''
*'''Графика''' ''(bh_gr)''- Графика "солнца". Добавляется из редактора ресурсов. В качестве ресурса может использоваться анимация.
*'''Эффект''' ''(eff_bh)''- Эффект, который рисует под "солнцем". Так же может быть и анимацией.
*'''Масса''' ''(bh_wg)''- Масса планеты
*'''Радиус''' ''(bh_rd)''- Радиус "солнца" в px. Если == 0, то используется размер графики
'''Добавить звук монеты''' - позволяет последовательно воспроизводить звуки подбора монет. Если задано больше 1-го звука, то первая монетка во время "подбора" воспроизведет 1-й звук, вторая - 2-й звук, и т.д.
*'''Звук''' ''(sndM)''- Звук при подборе монеты. Добавляется из редактора ресурсов.

2014-03-17T10:22:09Z

Epahomov:

{{TOC right}}
Настройка глобальных параметров для мини-игр.
=MatchBattle Setup=
*'''match''' - объект типа match, bejewelled, bubbleshooter - для активации бонусов
*'''economics''' - объект типа economics, для монеток. Если не указать, то работать будет все, кроме монет.
*'''режим''' - режим игры. Блиц - игра на время, Стратегия - на ходы, Битва - условная баталия с "противником"
=Визуальная часть=
*'''Щиты игрока (Бар)''' - объект, который будет отображать щит игрока.
*'''Щиты игрока (Каунтер)''' - объект, который будет отображать щит игрока.
*'''Щиты игрока (Макс)''' - объект, который будет отображать щит игрока.
*'''Жизни игрока (Бар)''' - объект, который будет отображать жизни игрока.
*'''Жизни игрока (Каунтер)''' - объект, который будет отображать жизни игрока.
*'''Жизни игрока (Макс)''' - объект, который будет отображать жизни игрока.
*'''Щиты врага(Бар)''' - объект, который будет отображать щит врага.
*'''Щиты врага(Каунтер)''' - объект, который будет отображать щит врага.
*'''Щиты врага(Макс)''' - объект, который будет отображать щит врага.
*'''Жизни врага (Бар)''' - объект, который будет отображать жизни врага.
*'''Жизни врага (Каунтер)''' - объект, который будет отображать жизни врага.
*'''Жизни врага (Макс)''' - объект, который будет отображать жизни врага.
*'''очки''' - счетчик, в который будут записываться набранные очки.
=Типы фишек=
*'''щит''' - номер фишки соответствующий щиту.
*'''здоровье''' - номер фишки соответствующий здоровью.
*'''молния(урон1)''' - номер фишки соответствующий молнии.
*'''магия(урон2)''' - номер фишки соответствующий магии.
*'''Урон3''' - номер фишки соответствующий молнии.
*'''Урон4''' - номер фишки соответствующий молнии.
*'''Урон5''' - номер фишки соответствующий молнии.
*'''Урон6''' - номер фишки соответствующий молнии.
*'''Уклонение''' - номер фишки соответствующий уклонению.
*'''монета''' - номер фишки соответствующий монете.
=Настройки=
*'''Очки молния''' - очки за матч. В них измеряются жизни, атака, защита. Числа через запятую -за match 3,4,5
*'''Очки магия''' - очки за матч. В них измеряются жизни, атака, защита. Числа через запятую -за match 3,4,5
*'''Очки урон3''' - очки за матч. В них измеряются жизни, атака, защита. Числа через запятую -за match 3,4,5
*'''Очки урон4''' - очки за матч. В них измеряются жизни, атака, защита. Числа через запятую -за match 3,4,5
*'''Очки урон5''' - очки за матч. В них измеряются жизни, атака, защита. Числа через запятую -за match 3,4,5
*'''Очки урон6''' - очки за матч. В них измеряются жизни, атака, защита. Числа через запятую -за match 3,4,5
*'''Очки монетки''' - очки за матч. В них измеряются жизни, атака, защита. Числа через запятую -за match 3,4,5
*'''Цена монетки''' - цена монетки в реальном ресурсе1 в экономике.
*'''Удар врага''' - очки, на которые враг пробивает каждый ход.
*'''Щиты врага''' - значение вражеского щита.
*'''Жизни врага''' - значение вражеских жизней.
*'''Щиты игрока''' - значение щита игрока.
*'''Жизни игрока''' - значение жизней игрока.
*'''Регенерация врага''' -

Файл:17-03-2014 11-44-11.png

2014-03-17T09:46:57Z

Epahomov:

Файл:17-03-2014 11-44-36.png

2014-03-17T09:46:48Z

Epahomov:

2014-03-17T09:11:48Z

Epahomov: загружена новая версия «Файл:17-03-2014 11-09-06.png»

Esocial

2014-03-17T09:10:12Z

Epahomov:

Файл:17-03-2014 11-09-06.png

2014-03-17T09:10:01Z

Epahomov:

Machine

2014-03-14T15:40:48Z

Epahomov: /* set */

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

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

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

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

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

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

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

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

=== init ===

====Параметры объекта====

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''al''' - Прозрачность: от 0 (прозрачен) до 1 (не прозрачен);
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима), если vis = 0, это равноценно что отключить объект и редакторе;
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше;

====Параметры движения====

* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys

====Системные действия====

* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга.
Если на девайсе была нажата кнопка "отрейтинговать", то в опции запишется параметр rating значение 1, если нажата кнопка "позже" - rating 2, "никогда" - rating 3.
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто.
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут.
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран.
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние.
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.
* '''id внешней ссылки в текстовой базе''' - Ссыслка будет взята из текстовой базы в соответствии с текущим маркетом.
* '''clone''' - Значение 1 означает, что в текущем местоположении машины будет создана ее копия

====Переходы и параметры выполнения====

* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия выполнения; можно использовать логические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

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

=== set ===

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

* '''obj''' - изменяемый объект (выбирается из списка объектов). В значении объекта можно указать this, это значит что машина сама себе пропишет какой то параметр или состояние.
* '''scr_param''' - глобальный либо текущий экран, параметры которого меняем.
* '''scr_state''' - экран, состояние которого меняем.
* '''parent''' - Объект, который будет установлен в качестве родителя объекту из obj. Объект obj будет оторван от текущего своего родителя и добавлен в детей объекта parent. 
* '''st''' - состояние в которое переводится объект. 
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr,val_vid,val_res,val_node.
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par(параметр для текстов "txtID")
* '''val_vid''' - id video, будет записано в par(параметр для видео "video" - RGB, "videoA" - Alpha)
* '''val_scr''' - id экрана, будет записано в в par
* '''val_res''' - Новое значение графического ресурса (перетаскивается из редактора ресурсов). (пока не работает)
* '''val_node''' - Новое нода графа (выбирается из списка, при заданном объекте)
* '''val''' - значение параметра объекта для установки
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''round''' - округлить значение, записываемое в val 
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется 
* '''if''' - номер (начиная с нуля) команды [[#if|if]] при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

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

=== play ===

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

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

Особенности примененияния:

*Короткий звук (''snd'') нельзя запустить в первом (инитном) состоянии машины. Для того, чтобы запустить звук сразу при загрузке экрана, нужно в первом состоянии машины записать мгновенный переход во второе состояние мамашины (например, команда ''wait'', поле ''go'', в поле выбрать второе состояние), а во втором состоянии уже запустить звук. Если звук нужно зациклить и проигрывать какое-то количество раз (''loop=1,2,3,..,n'') или бесконечно (''loop=-1''), то нужно проследить чтобы состояние, в котором запускается звук, не вызывалось повторно во время проигрывания звука, иначе возникнет наложение звуков. Если во время проигрывания звука машина меняет свое состояние, звук продолжает играть. Если в одной машине почти одновременно воспроизводится несколько звуков, то они прерывают друг друга. Если каждый звук воспроизводится в отдельной машине, то они звучат параллельно.
*Длинный звук (''mus'')- музыка. На экране не может воспроизводится несколько длинных звуков одновременно. Любой запуск длинного звука независимо от того, в какой машине он осуществляется, будет прекращать проигрывание предыдущего звука. Музыка, которая проигрывается на глобальном экране, проигрывается на всех экранах проекта.

=== var ===

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

*'''name''' - имя переменной;
*'''obj''' - объект, используемый далее;
*'''par''' - имя параметра, значение которого присваивается переменной;
*'''val''' - значение переменной, если отсутствуют obj и par;
*'''user''' - если стоит "1", то будет считываться с текущего профиля в опциях
*'''func''' - в выпадающем списке можно выбрать функцию:
**'''random''' - использует arg1 и arg2, возвращает случайное целое число в диапазоне arg1 .. arg2.
**'''conc''' - объединяет 4 строки arg1,arg2,arg3,arg4. Возвращает строку, в которой соединены все строки
**'''exp''' - экспонента от аргумента arg1.
**'''ln''' - натуральный логарифм аргумента arg1.
*'''arg1''' - аргумент функции
*'''arg2''' - аргумент функции
*'''arg3''' - аргумент функции
*'''arg4''' - аргумент функции

Обозначенная переменная существует (может использоваться) только в текущем состоянии. Переменная может определятся в одном состоянии только один раз. Если созданной переменной нужно изменить значение в рамках состояния, это можно сделать через другую переменную или через параметр опций ([[Options]]). Если ее значение нужно использовать в другом состоянии, то оно присваивается параметру опций, а затем заново считывается в новом состоянии. Переменные можно указывать в поле ''val'' с другими математическими действиями и цифрами, при этом каждое действие заключать в скобки. Если в поле ''val'' указать имя переменной ''А'' без скобок - воспримется строка ''А'', если указать в скобках - воспримется значение переменной.

=== buy ===

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

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

=== download ===

При переходе в состояние будет совершена попытку закачать контент.
* '''url''' - ссылка на zip архив с контентом в интернете.
* '''объект успех''' - объект, которому в случае успешной закачки будет задаваться указанное состояние.
* '''состояние (успех)''' - состояние, которое будет устанавливаться выше указанному объекту, в случае успешной закачки.
* '''объект (провал)''' -объект, которому, в случае неудачи закачки, будет устанавливаться указанное состояние.
* '''состояние (провал)''' - состояние, которое, в случае неудачи закачки,будет устанавливаться выше указанному объекту.
* '''счетчик прогресса''' - объект, типа счетчик, который отображает прогресс закачки контента. Крайне желательно, что бы он измерялся в диапазоне от 0 до 100.

Существует несколько причин при которых вызывается состояние "провал". Для того что бы сообщить пользователю, по какой именно причине возник провал закачки, следует идентифицировать причины провала. Это возможно сделать с помощью параметра
<pre>
downloadErrCode
</pre>
Ниже приведены значение параметра которые помогут вывести нужное текстовое сообщение :
<pre>
GCUSTOM_ERROR_CODE_ERROR_UNKNOWN = 1, //!< ошибка неклассифицирована
GCUSTOM_ERROR_CODE_WIFI_DISABLED = 2, //!< отключен WIFI
GCUSTOM_ERROR_CODE_SDCARD_UNAVAILABLE = 3, //!< SD-карта недоступна
GCUSTOM_ERROR_CODE_SDCARD_FULL = 4, //!< SD-карта переполнена перед закачкой
GCUSTOM_ERROR_CODE_UNZIP_FAIL = 5 //!< ошибка при распаковки пака (скорее всего на SD-карте не хватает места для распаковки
</pre>

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

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

Если в команде процесса есть условие '''[[#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''' - целевые координаты в пикселях, к которым должен переместиться объект. Можно указывать переменные заданные с помощью [http://ge.absolutist.com/index.php/Machine#var_2 переменной var];
* '''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 на этой команде (запустить их снова можно из команд процессов).

Если у объекта прозрачность ''al=0.00'', то он невидим для всякого взаимодействия. Если у объекта прозрачность ''al=0.01'', то он видим для клика, но невидим для дропа(команда drop на объект не видит объект с прозрачностью ''0.01''). Если у объекта ''al=0.02'', то он видим и для клика, и для дропа.

=== 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), до которой мяч должен подпрыгнуть.

=== spline ===

Сплайн позволяет перемещать машину по заранее заданной траектории.

====Параметры====

*'''key''' - точки сплайна по которым движется
*'''t''' - время движения по траектории
*'''go''' - по окончанию переход в состояние
*'''if''' - условие перехода
*'''loop''' - количество повторений
*'''break''' - прервать команды на этой
*'''wait''' - номер запускаемого действия
*'''init''' - номер запускаемого действия
*'''alpha''' - номер запускаемого действия
*'''rot''' - номер запускаемого действия
*'''move''' - номер запускаемого действия
*'''set''' - номер запускаемого действия
*'''phys''' - номер запускаемого действия

====Построение сплайна====

# в состоянии машины добавляем правой кнопкой мыши действие "spline"
# добавляем минимально необходимые параметры: '''key''' и '''t''', указываем время движения в '''t'''
# выделяем для редактирования поле '''key'''
# записываем координаты точек через запятую, сначала x потом y, например: -211,-248,-151,-248,-91,-247,59,-246,60,101,60,159,1,190
Если записали все координаты вручную, то можно сохранить и проверять.
Или можно в окне списка состояний нажимаем на кнопку "build spline" (справа вверху).
[[Файл:Btn spline.jpg|500px]]

Окно с списком состояний закроется, появится дополнительная панель с настройками сплайна и появится возможность указывать мышкой по экрану точки для сплайна.

[[Файл:Spline panel.jpg|500px]]

Точки сплайна указываются кликом левой кнопки мыши по экрану.

Возможности редактирования:

'''режимы:'''
*'''add''' - по нажатию левой кнопкой мыши по экрану - будет добавлена новая точка, которая соеденится с предидущей
*'''select''' - по нажатию левой кнопкой мыши по точке сплайна появится возможность отредактировать её положение перетащив её или поменяв её координаты в полях x и у
*'''delete''' - по нажатию левой кнопкой мыши по точке сплайна точка удалится

Чтобы удалить все точки сплайна необходимо нажать на кнопку "'''delete all knots'''"

Сохранить сплайн можно нажав на кнопку "'''Save spline'''"

====Дополнительные сведения====

* Время движения между двумя соседними точками всегда одинаково, то есть чем дальше друг от друга соседние точки, тем быстрее будет двигаться объект, чем ближе - тем медленней.

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

=== click ===

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

По клику машина записывает координаты клика в параметры: clickX, clickY.

=== touch_in ===

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

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

=== touch_up ===

Отжатие мыши от машины

* '''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 ===

Данная команда позволяет "таскать" объект по сцене нажав и удерживая клавишу мишки или (палец в случае сенсорного устройства) на нем.Так же есть возможность ограничить разрешенную область таскания, за пределы которой объект вытащить невозможно. [[Файл:drag.jpg|right]]
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у которого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''за пивот''' - "да" - таскать объект за пивот, "нет" - за ту точку, за которую схватили

=== dragRot ===

Данная команда позволяет вращать объект вокруг точки пивота. Нажав и удерживая клавишу мишки или палец (в случае сенсорного устройства) на нем, мы можем вращать его по часовой либо против часовой стрелки. При многократном вращении вокруг своей оси значение его угла не накапливается, а обнуляется выходя за границы [360 ; -360] градусов. [[Файл:dragRot.jpg|right]]
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у которого надо изменить состояние;
* '''st''' - новое состояние объекта obj;

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drag
* '''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.

[[Файл:Апплай.png|500px]]

Блок схема работы '''apply'''

[[Файл:Блок схема apply.png|500px]]

* Сначала у нас проверяется координаты '''x1''', '''x2''', '''y1''', '''y2'''.
* Далее проверяет если '''obj'''
* Если '''obj''' нет, то идёт проверку, и выдаёт результат
(если при этом если '''x1''', '''x2''', '''y1''', '''y2''' нет, то они считаются по ширине и высоте всего экрана.)
* Если есть '''obj''', то проверяет есть ли радиусы '''rm''', '''ro'''.
* Если он есть, то значит у нас '''apply''' по кругам
* Если нет, то проверяем наличие '''x1''', '''x2''', '''y1''', '''y2'''.
* Если они есть, то проверка и результат.
* Если их нет, то проверка идёт по шейпам объектов, и выдаётся результат/
Если не будет стоять ни каких галочек, то проверка будет идти по шейпам объектов.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<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. В этом поле можно указать this, это значит что if будет проводить проверку текущего объекта. Добавлено это вместе с параметром clone. Клоны рождаются и умирают в рамках одного экрана и при рождении имеют id такой же как у объекта оригинала. Для различия клонов между собой машина имеет уникальный параметр "clone_num" у оригинала = -1, у клонов от 0 до N, собственно с помощью this машина может сама себя проверить клон ли она и если да то какой у нее номер;
* '''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.

Для проверки текущего значения прозрачности у объекта можно воспользоваться параметром ''cur_al''

== Математика ==
Математика в appsalute creator представлена 4-мя основными операциями: (плюс), (минус), (умножить), (поделить) 
Организована благодаря совместному использованию '''[[#var|var]]''' и '''[[#set|set]]'''.
=== var ===
Благодаря использованию '''[[#var|var]]''' существует возможность cчитать любой числовой параметр любого объекта. Например: x - координату какой-то машины, текущее значение любого объекта counter или timer и конечно же считывание значения любого параметра из опций! Каким образом это устроено? Рассмотрим подробнее '''[[#var|var]]''': 
[[Файл:VAR.png|right]]
*'''name''' - здесь выбираем имя для нашей будущей переменной, которой будем оперировать далее
*'''obj''' - выбирается объект, параметры которого мы хотим считать
*'''par''' - параметр, который нужно вычитать из объекта, указанного выше
*'''val''' - указывается числовое значение, которое будет установлено по умолчанию в случае отсутствия obj и par
*'''user''' - если стоит "1", то будет считываться с текущего профиля в опциях
На изображении справа можно наблюдать каким образом организован '''[[#var|var]]'''. В данном случае объявлена переменная x_cor, которая cчитывает x-координату объекта actor_1, при этом cчитывание переменной происходит из текущего профиля, так, как в поле user установлено значение равное "1".

=== set ===
[[Файл:SET.png|right]]
Использование '''[[#var|var]]''' без '''[[#set|set]]''' не имеет смысла. Так, как переменная создается, но не используется дальше. Рассмотрим следующий пример, где вычитаем x - координату из одного объекта и сохраним ее в опции, предварительно увеличив ее на 50 единиц (в данном случае 50 пикселей).
На рисунке справа можно наблюдать, каким образом это сделано. В состоянии '''init''' объявляется переменная '''x_cor''', которая cчитывает координату '''x''' из объекта '''actor_1''', таким образом в переменную '''x_cor''' запишется положение по '''x''' объекта '''actor_1'''. Поле '''user''' в данном случае в '''1''' не обязательно устанавливать, так как работа ведется с машинами, а не с опциями. Если бы на месте '''actor_1''' оказался объект '''options''', то это было бы просто необходимо, иначе программа считает значение не из профиля. Далее в '''[[#set|set]]''' выбран объект '''options''', в параметр '''x_position''' которого будет сохранятся значение переменной '''x_cor''' увеличенной на 50. В поле '''round''' идет округление вычисляемого значения, если оно установлено в 1. Поле '''user ''' установлено в 1, это значит, что параметр '''x_position''' будет сохранен в профиль. После это выполняется сохранение опций путем задания объекту '''options''' состояния '''save'''. 
! ! !ВАЖНО: чтобы выполнить какие-то действия с '''[[#var|var]]''' его обязательно нужно указывать в поле '''val''' в '''set''', при этом, если он используется, то все выражение должно стоять в скобках. Если в поле '''val''' не используется переменная, то скобки необязательны.
 
 
 
 
Существует также возможность использовать '''[[#var|var]]''' совместно с '''[[#if|if]]''', а также '''[[#var|var]]''' с '''[[#move|move]]'''
 
 
 
Так же добавилась возможность записывать значение переменной в состояние "st", что значительно уменьшает необходимость в записи 1000 if-ов. При этом, тип переменно в '''[[#var|var]]''' должен быть "строка".
И добавилась возможность записи переменной boolean: ((a)==(b)). true = 1, false = 0. Довольно полезная вещь, если не хотите забивать "память" ненужной математикой.

=== var и if ===
[[Файл:IF.png|right]]
При подробном рассмотрении '''[[#if|if]]''' можно заметить, что в нем есть поле '''val''', соответственно в этом поле можно указать переменную. Таким образом в поле '''val''' необязательно указывать константу, а можно указать какую-то переменную, которая может постоянно изменяться. Например, существует два объекта, один находится состоянии покоя, а другой находится в движении. При этом первый объект (тот, который в состоянии покоя) постоянно опрашивает положение второго объекта, и в случае, если у объекта, который движется, '''х''' координата равна '''х''' координате первого объекта, то первый объект входит в состояние, где он начинает свое движение. На рисунке показан объект, который находится в состоянии покоя, рассмотрим его состояния: 
В данном объекте существует два состояния: '''init''' и '''move'''. В '''init''' объект опрашивает другой объект и в случае, когда условие срабатывает, то переходит в состояние '''move''', где начинает свое движение.
В '''init''' создаем переменную, в которую записываем положение по '''x''' объекта '''actor_2''', в '''if''' проверяется условие на соответствие координат объектов '''actor_1''' и '''actor_2''', в данном случае координата объекта '''actor_2''' представлена в виде переменной '''x_cor'''. Если условие выполняется, то происходит переход в состояние '''move''', если нет, то заново проходим состояние '''init''' и повторяем вышеописанную последовательность действий.
 
 
 
 

=== var и move ===
Также с помощью '''[[#var|var]]''' есть возможность указать целевые координаты в '''[[#move|move]]'''. То есть, не обязательно указывать целевые координаты в виде констант, их можно указать теперь с помощью переменных. При использовании '''[[#var|var]]''' и '''[[#move|move]]''' можно организовать обмен двух объектов местами с анимацией движения. Для этого необходимо определять какой объект нажат первым, а какой вторым, сохранять их координаты через объект '''options''' и только потом менять их местами. На рисунке можно увидет, как это организовано.
[[Файл:var_move.png|1000px|thumb|center|]]
Рассмотрим подробнее состояние данной машины:
 
* '''init''' 
В этом состоянии ожидаем клик на объект и обнуляем параметр, который отвечает за то, какой по счету объект сейчас нажат. Так, как при обмене объектов, если мы делаем это по клику, важно знать, по какому кликнули нажали первым, а по какому вторым.
* '''check''' 
Проверяется параметр '''number''', если он равен '''0''', то это значит, что еще ничего не кликали и мы переходим в состояние, где в опции записываются координаты этого объекта, который считается нажатым первым. Если не равен '''0''', то считается, что этот объект нажат вторым и переходит в состояние, где в опции записываются координаты этого объекта, который считается нажатым вторым по счету.
* '''first_object''' 
В этом состоянии записываются координаты объекта в опции. Чтобы записать координаты в опции используются '''[[#var|var]]''' и '''[[#set|set]]''' упоминаемые выше. В опции координаты первого нажатого объекта сохраняются под параметрами '''x_first''' и '''y_first'''. В конце параметру '''number''' присваиваем значение '''1''', чтобы указать, что следующий нажатый объект будет вторым по счету.
* '''second_object''' 
В этом состоянии объект будет в том случае, если он будет нажатым вторым по счету, то есть после состояния '''check''' объект попадет в это состояние, где он запишет свои текущие координаты под параметрами '''x_second''' и '''y_second'''. Запись координат происходит таким же самым образом, что и в состоянии '''first_object'''. После этого он автоматически переходит в следующее состояние.
* '''move_first''' 
В этом состоянии объект будет в том случае, если он был нажат первым, поэтому он будет двигаться на место второго нажатого объекта, который сохранил свои координты в параметры'''x_second''' и '''y_second'''. Движение происходит следующим образом: сперва в переменную вычитываем координаты второго объекта, а потом в '''move''' вместо целевых координат записываем переменные, которые обязательно должны быть взяты в скобки.
* '''move_second''' 
В этом состоянии объект будет в том случае, если он был нажат вторым, поэтому он будет двигаться на место первого нажатого объекта, который сохранил свои координты в параметры '''x_first''' и '''y_first'''. Движение происходит следующим образом: сперва в переменную вычитываем координаты первого объекта, а потом в '''move''' вместо целевых координат записываем переменные, которые обязательно должны быть взяты в скобки.

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

=== Важно знать ===
* Переменная действует в рамках одного состояния, если нужно, чтобы она была глобальной, нужно сохранить ее в опции и потом в нужный момент считывать ее из опций.
* Если складываем два числа, то в поле '''val''' они должны быть записаны в скобках: (5+3).
* Если возникает необходимость написать какое-то более сложное арифметическое вычисление, то следует помнить, что на одно действие приходятся одни скобки. Например: (((5+3)\2)*2).
* Количество открывающих и закрывающих скобок должно быть одинаковым.
* В скобках можно писать переменную, если она была объявлена выше: (5+a).
* Переменная может состоять из цифр и букв и знака нижнего подчеркивания.
* Иногда бывает необходимым использование '''round''' в '''set''', так например, если какой-то параметр получен с помощью арифметических вычислений и потом используется его в каком-то условии, и условие проверяет параметр, как целочисленное значение, то могут возникнуть ошибки. Так, как число будет записано в следующем виде 123.0000 и программа будет считать, что оно не целочисленное, а дробное. И чтобы избавится от лишних нулей в дробной части следует округлять число.
* Действия, которые требуют времени, такие как move, rot, wait и другие перестают работать для уменьшения вычислительной нагрузки на устройство.
* Действия, которые не требуют времени, такие как set, init и другие продолжают функционировать.

<pre>
Если с помощью переменной менять объекту любой параметр, например, координату X, то она запомнится (запишется как значение по умолчанию).
Тогда при повторном попадании на экран считается не тот X, который указан в свойствах, а тот, который установлен через переменную.
Если нужно при ините экрана возвращать начальные значения параметров, то можно сделать это двумя способами:
- не использовать переменную;
- создать отдельное состояние, которое будет "вручную" устанавливать начальные значения параметрам при ините экрана.
Если координата (или другой параметр) меняется другим способом, то будут автоматически при ините экрана подтягиваться значения из свойств объекта.
</pre>

=== Примеры применений ===
С помощью математики можно организовать следующее:
* динамические опции (изменение звука и музыки с помощью ползунка);
* анимацию каунтера в играх (по окончанию уровня можно наблюдать, как изменяются очки);
* подсчет очков (гибкая система подсчета очков);
* обмен объектов местами (использование var и move)
* увеличение z-координаты любого объекта (когда необходимо, чтобы нажатый или таскаемый объект был выше других по z);
* простейший калькулятор;
* и много других.

== Копирование машины состояния с сохранением ссылки на себя ==
Довольно часто бывает, что машина состояний ссылается только на глобальные объекты и на саму себя. При этом, если мы просто скопируем объект, он будет ссылаться на свою предыдущую копию. Этого можно избежать, сделав 3 шага:
1. Переместить объект в отдельную сцену
2. Скопировать данную сцену(имеется в виду обычное копирование, без ссылки)
3. Перенести объект и его копию обратно, в нужную сцену
4. Созданые сцены можно удалить :)

== Guest ==

'''Guest (гость)''' - объект, который перевел машину в текущее состояние. Пример: кнопка ''btn1'' по клику переводит машину ''mch1'' в состояние ''st1'', в этом состоянии у машины ''mch1'' гостем является кнопка ''btn1''. Гостем может быть объект любого типа, если он может менять состояние другому объекту (например: хидден-объект по нахождению может менять состояние объекту, кнопка, машина, пэчворк и т.д.)

В машине состояний можно считывать (проверять) и передавать параметры и состояния гостя. Любое поле ''obj'' в выпадающем списке содержит строку ''guest'', что позволяет работать с гостем, как с любым другим объектом.

=== Пример использования ===

[[Файл:Guest1.jpg|left]]
Пускай экран содержит 3 кнопки (''btn1'', ''btn2'' и ''btn3'') и одну машину ''mch1''. Нужно сделать так, чтобы по клику на любую из кнопок машина перемещалась в ее координаты и переводила кнопку в состояние ''disable''. Так же по клику на кнопку ''btn2'', машина должна перейти в состояние ''bonus''. 
Всем трем кнопкам по клику пропишем передавать объекту ''mch1'' состояние ''check''. 
Создадим в машине три состояния: ''init'' - состояние в котором машина будет находиться по умолчанию, ''check'' - состояние, которое будет вызываться тремя кнопками, в этом состоянии у машины ''mch1'' одна из трех кнопок будет гостем, ''bonus'' - последнее состояние. 
Две команды ''var'' считывают у гостя координаты, т.к. мы не знаем, какая именно кнопка перевела машину ''mch1'' в состояние ''check'', то обращаемся к гостю, а не к кнопкам. За ними следует две команды ''set'', которые передают координаты гостя машине. Еще один ''set'' переводит гостя в состояние ''disable''. И через ''wait'' осуществляется переход в состояние ''bonus'', если гость ''btn2''.

<pre>
При смене состояния гость сохраняется, т.е. в состоянии bonus гостем останется btn2.
</pre>
<pre>
Если машина изначально сама себе меняет состояния, то у нее нет гостя.
</pre>

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

== Массив (Array) ==

В данном объекте реализован массив, имеющий максимальную длинну в 20 элементов.

=== Свойства объекта массив: ===

len - длинна массива. Длинна массива может как считываться, так и записываться. Влияет на количество сохраняемых объектов в Options.

index1 - индекс элемента. (данный массив можно расширить до многомерного и использовать несколько индексов)

val - значение элемента массива, с индексом index1

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

=== Состояния объекта массив: ===

get - при вызове этого состояния во внутреннюю переменную val записывается значение элемента с индексом index1

set - при вызове этого состояния во внутреннюю переменную a1..a20, соответствующую индексу index1 записывается значение val

load - загрузить значения массива из xml.

save - сохранить элементы массива от 1 до len

=== Как использовать? ===

1. Загружаем массив, переводя объект array в состояние load

2. Записываем значения массива

а). Задаём значение свойству index1 объекта array (устанавливаем индекс ячейки, в которую будет заноситься число)
б). Задаём значение свойству val объекта array (устанавливаем значение, которое будет заноситься в ячейку с индексом index1)
в). Переводим объект array в состояние set

3. Считываем значения массива
а). Задаём значение свойству index1 объекта array (устанавливаем индекс ячейки, из которой будет считываться число)
б). Переводим объект array в состояние get
в). Считываем значение из свойства val объекта array

4. Сохраняем массив, переводя объект array в состояние save. Если хотите изменить количество сохраняемых эелментов - предварительно измените параметр len.

=== Копирование объекта ===

При копировании, необходимо заменить в состояниях load и save array.имя_параметра на другое имя. Например, array2.имя_параметра. Копировать следует через использование доп. сцены (см. выше)

=== Достоинства ===

Позволяет избежать необходимости каждый раз создавать большое количество if-ов и set-ов, если необходимо работать с нумерованным списком. Можно один раз создать структуру и копировать её неограниченное количество раз

=== Недостатки ===

Данный объект содержит довольно большое количество кода, поэтому при большом их обилии/длинне может занизить скорость работы сцены и скорость загрузки сцены.

=== Исходный XML код===
Прим. id="369" - идентификатор объекта Options, сохраняющего все переменные приложения. id="7845" - идентификатор объекта

<pre>
<obj id="7845" type="machine" nm="array" sync="1" w="1" h="1">
<st id="init"/>
<st id="get">
<var nm="a1" obj="7845" par="a1"/>
<var nm="a2" obj="7845" par="a2"/>
<var nm="a3" obj="7845" par="a3"/>
<var nm="a4" obj="7845" par="a4"/>
<var nm="a5" obj="7845" par="a5"/>
<var nm="a6" obj="7845" par="a6"/>
<var nm="a7" obj="7845" par="a7"/>
<var nm="a8" obj="7845" par="a8"/>
<var nm="a9" obj="7845" par="a9"/>
<var nm="a10" obj="7845" par="a10"/>
<var nm="a11" obj="7845" par="a11"/>
<var nm="a12" obj="7845" par="a12"/>
<var nm="a13" obj="7845" par="a13"/>
<var nm="a14" obj="7845" par="a14"/>
<var nm="a15" obj="7845" par="a15"/>
<var nm="a16" obj="7845" par="a16"/>
<var nm="a17" obj="7845" par="a17"/>
<var nm="a18" obj="7845" par="a18"/>
<var nm="a19" obj="7845" par="a19"/>
<var nm="a20" obj="7845" par="a20"/>
<set obj="7845" par="val" val="(a1)" round="1" if="0"/>
<set obj="7845" par="val" val="(a2)" round="1" if="1"/>
<set obj="7845" par="val" val="(a3)" round="1" if="2"/>
<set obj="7845" par="val" val="(a4)" round="1" if="3"/>
<set obj="7845" par="val" val="(a5)" round="1" if="4"/>
<set obj="7845" par="val" val="(a6)" round="1" if="5"/>
<set obj="7845" par="val" val="(a7)" round="1" if="6"/>
<set obj="7845" par="val" val="(a8)" round="1" if="7"/>
<set obj="7845" par="val" val="(a9)" round="1" if="8"/>
<set obj="7845" par="val" val="(a10)" round="1" if="9"/>
<set obj="7845" par="val" val="(a11)" round="1" if="10"/>
<set obj="7845" par="val" val="(a12)" round="1" if="11"/>
<set obj="7845" par="val" val="(a13)" round="1" if="12"/>
<set obj="7845" par="val" val="(a14)" round="1" if="13"/>
<set obj="7845" par="val" val="(a15)" round="1" if="14"/>
<set obj="7845" par="val" val="(a16)" round="1" if="15"/>
<set obj="7845" par="val" val="(a17)" round="1" if="16"/>
<set obj="7845" par="val" val="(a18)" round="1" if="17"/>
<set obj="7845" par="val" val="(a19)" round="1" if="18"/>
<set obj="7845" par="val" val="(a20)" round="1" if="19"/>
<if obj="7845" par="index1" val="1"/>
<if obj="7845" par="index1" val="2"/>
<if obj="7845" par="index1" val="3"/>
<if obj="7845" par="index1" val="4"/>
<if obj="7845" par="index1" val="5"/>
<if obj="7845" par="index1" val="6"/>
<if obj="7845" par="index1" val="7"/>
<if obj="7845" par="index1" val="8"/>
<if obj="7845" par="index1" val="9"/>
<if obj="7845" par="index1" val="10"/>
<if obj="7845" par="index1" val="11"/>
<if obj="7845" par="index1" val="12"/>
<if obj="7845" par="index1" val="13"/>
<if obj="7845" par="index1" val="14"/>
<if obj="7845" par="index1" val="15"/>
<if obj="7845" par="index1" val="16"/>
<if obj="7845" par="index1" val="17"/>
<if obj="7845" par="index1" val="18"/>
<if obj="7845" par="index1" val="19"/>
<if obj="7845" par="index1" val="20"/>
</st>
<st id="set">
<var nm="val" obj="7845" par="val"/>
<set obj="7845" par="a1" val="(val)" round="1" if="0"/>
<set obj="7845" par="a2" val="(val)" round="1" if="1"/>
<set obj="7845" par="a3" val="(val)" round="1" if="2"/>
<set obj="7845" par="a4" val="(val)" round="1" if="3"/>
<set obj="7845" par="a5" val="(val)" round="1" if="4"/>
<set obj="7845" par="a6" val="(val)" round="1" if="5"/>
<set obj="7845" par="a7" val="(val)" round="1" if="6"/>
<set obj="7845" par="a8" val="(val)" round="1" if="7"/>
<set obj="7845" par="a9" val="(val)" round="1" if="8"/>
<set obj="7845" par="a10" val="(val)" round="1" if="9"/>
<set obj="7845" par="a11" val="(val)" round="1" if="10"/>
<set obj="7845" par="a12" val="(val)" round="1" if="11"/>
<set obj="7845" par="a13" val="(val)" round="1" if="12"/>
<set obj="7845" par="a14" val="(val)" round="1" if="13"/>
<set obj="7845" par="a15" val="(val)" round="1" if="14"/>
<set obj="7845" par="a16" val="(val)" round="1" if="15"/>
<set obj="7845" par="a17" val="(val)" round="1" if="16"/>
<set obj="7845" par="a18" val="(val)" round="1" if="17"/>
<set obj="7845" par="a19" val="(val)" round="1" if="18"/>
<set obj="7845" par="a20" val="(val)" round="1" if="19"/>
<if obj="7845" par="index1" val="1"/>
<if obj="7845" par="index1" val="2"/>
<if obj="7845" par="index1" val="3"/>
<if obj="7845" par="index1" val="4"/>
<if obj="7845" par="index1" val="5"/>
<if obj="7845" par="index1" val="6"/>
<if obj="7845" par="index1" val="7"/>
<if obj="7845" par="index1" val="8"/>
<if obj="7845" par="index1" val="9"/>
<if obj="7845" par="index1" val="10"/>
<if obj="7845" par="index1" val="11"/>
<if obj="7845" par="index1" val="12"/>
<if obj="7845" par="index1" val="13"/>
<if obj="7845" par="index1" val="14"/>
<if obj="7845" par="index1" val="15"/>
<if obj="7845" par="index1" val="16"/>
<if obj="7845" par="index1" val="17"/>
<if obj="7845" par="index1" val="18"/>
<if obj="7845" par="index1" val="19"/>
<if obj="7845" par="index1" val="20"/>
</st>
<st id="load">
<var nm="a1" obj="369" par="array.a1" user="1"/>
<var nm="a2" obj="369" par="array.a2" user="1"/>
<var nm="a3" obj="369" par="array.a3" user="1"/>
<var nm="a4" obj="369" par="array.a4" user="1"/>
<var nm="a5" obj="369" par="array.a5" user="1"/>
<var nm="a6" obj="369" par="array.a6" user="1"/>
<var nm="a7" obj="369" par="array.a7" user="1"/>
<var nm="a8" obj="369" par="array.a8" user="1"/>
<var nm="a9" obj="369" par="array.a9" user="1"/>
<var nm="a10" obj="369" par="array.a10" user="1"/>
<var nm="a11" obj="369" par="array.a11" user="1"/>
<var nm="a12" obj="369" par="array.a12" user="1"/>
<var nm="a13" obj="369" par="array.a13" user="1"/>
<var nm="a14" obj="369" par="array.a14" user="1"/>
<var nm="a15" obj="369" par="array.a15" user="1"/>
<var nm="a16" obj="369" par="array.a16" user="1"/>
<var nm="a17" obj="369" par="array.a17" user="1"/>
<var nm="a18" obj="369" par="array.a18" user="1"/>
<var nm="a19" obj="369" par="array.a19" user="1"/>
<var nm="a20" obj="369" par="array.a20" user="1"/>
<set obj="7845" par="a1" val="(a1)" round="1" if="0"/>
<set obj="7845" par="a2" val="(a2)" round="1" if="1"/>
<set obj="7845" par="a3" val="(a3)" round="1" if="2"/>
<set obj="7845" par="a4" val="(a4)" round="1" if="3"/>
<set obj="7845" par="a5" val="(a5)" round="1" if="4"/>
<set obj="7845" par="a6" val="(a6)" round="1" if="5"/>
<set obj="7845" par="a7" val="(a7)" round="1" if="6"/>
<set obj="7845" par="a8" val="(a8)" round="1" if="7"/>
<set obj="7845" par="a9" val="(a9)" round="1" if="8"/>
<set obj="7845" par="a10" val="(a10)" round="1" if="9"/>
<set obj="7845" par="a11" val="(a11)" round="1" if="10"/>
<set obj="7845" par="a12" val="(a12)" round="1" if="11"/>
<set obj="7845" par="a13" val="(a13)" round="1" if="12"/>
<set obj="7845" par="a14" val="(a14)" round="1" if="13"/>
<set obj="7845" par="a15" val="(a15)" round="1" if="14"/>
<set obj="7845" par="a16" val="(a16)" round="1" if="15"/>
<set obj="7845" par="a17" val="(a17)" round="1" if="16"/>
<set obj="7845" par="a18" val="(a18)" round="1" if="17"/>
<set obj="7845" par="a19" val="(a19)" round="1" if="18"/>
<set obj="7845" par="a20" val="(a20)" round="1" if="19"/>
<if obj="7845" par="len" op=">" val="0"/>
<if obj="7845" par="len" op=">" val="1"/>
<if obj="7845" par="len" op=">" val="2"/>
<if obj="7845" par="len" op=">" val="3"/>
<if obj="7845" par="len" op=">" val="4"/>
<if obj="7845" par="len" op=">" val="5"/>
<if obj="7845" par="len" op=">" val="6"/>
<if obj="7845" par="len" op=">" val="7"/>
<if obj="7845" par="len" op=">" val="8"/>
<if obj="7845" par="len" op=">" val="9"/>
<if obj="7845" par="len" op=">" val="10"/>
<if obj="7845" par="len" op=">" val="11"/>
<if obj="7845" par="len" op=">" val="12"/>
<if obj="7845" par="len" op=">" val="13"/>
<if obj="7845" par="len" op=">" val="14"/>
<if obj="7845" par="len" op=">" val="15"/>
<if obj="7845" par="len" op=">" val="16"/>
<if obj="7845" par="len" op=">" val="17"/>
<if obj="7845" par="len" op=">" val="18"/>
<if obj="7845" par="len" op=">" val="19"/>
</st>
<st id="save">
<var nm="len" obj="7845" par="len"/>
<var nm="a1" obj="7845" par="a1"/>
<var nm="a2" obj="7845" par="a2"/>
<var nm="a3" obj="7845" par="a3"/>
<var nm="a4" obj="7845" par="a4"/>
<var nm="a5" obj="7845" par="a5"/>
<var nm="a6" obj="7845" par="a6"/>
<var nm="a7" obj="7845" par="a7"/>
<var nm="a8" obj="7845" par="a8"/>
<var nm="a9" obj="7845" par="a9"/>
<var nm="a10" obj="7845" par="a10"/>
<var nm="a11" obj="7845" par="a11"/>
<var nm="a12" obj="7845" par="a12"/>
<var nm="a13" obj="7845" par="a13"/>
<var nm="a14" obj="7845" par="a14"/>
<var nm="a15" obj="7845" par="a15"/>
<var nm="a16" obj="7845" par="a16"/>
<var nm="a17" obj="7845" par="a17"/>
<var nm="a18" obj="7845" par="a18"/>
<var nm="a19" obj="7845" par="a19"/>
<var nm="a20" obj="7845" par="a20"/>
<set obj="369" par="array.a1" val="(a1)" round="1" user="1" if="0"/>
<set obj="369" par="array.a2" val="(a2)" round="1" user="1" if="1"/>
<set obj="369" par="array.a3" val="(a3)" round="1" user="1" if="2"/>
<set obj="369" par="array.a4" val="(a4)" round="1" user="1" if="3"/>
<set obj="369" par="array.a5" val="(a5)" round="1" user="1" if="4"/>
<set obj="369" par="array.a6" val="(a6)" round="1" user="1" if="5"/>
<set obj="369" par="array.a7" val="(a7)" round="1" user="1" if="6"/>
<set obj="369" par="array.a8" val="(a8)" round="1" user="1" if="7"/>
<set obj="369" par="array.a9" val="(a9)" round="1" user="1" if="8"/>
<set obj="369" par="array.a10" val="(a10)" round="1" user="1" if="9"/>
<set obj="369" par="array.a11" val="(a11)" round="1" user="1" if="10"/>
<set obj="369" par="array.a12" val="(a12)" round="1" user="1" if="11"/>
<set obj="369" par="array.a13" val="(a13)" round="1" user="1" if="12"/>
<set obj="369" par="array.a14" val="(a14)" round="1" user="1" if="13"/>
<set obj="369" par="array.a15" val="(a15)" round="1" user="1" if="14"/>
<set obj="369" par="array.a16" val="(a16)" round="1" user="1" if="15"/>
<set obj="369" par="array.a17" val="(a17)" round="1" user="1" if="16"/>
<set obj="369" par="array.a18" val="(a18)" round="1" user="1" if="17"/>
<set obj="369" par="array.a19" val="(a19)" round="1" user="1" if="18"/>
<set obj="369" par="array.a20" val="(a20)" round="1" user="1" if="19"/>
<set obj="369" par="array.len" val="(len)" round="1" user="1"/>
<if obj="7845" par="len" op=">" val="0"/>
<if obj="7845" par="len" op=">" val="1"/>
<if obj="7845" par="len" op=">" val="2"/>
<if obj="7845" par="len" op=">" val="3"/>
<if obj="7845" par="len" op=">" val="4"/>
<if obj="7845" par="len" op=">" val="5"/>
<if obj="7845" par="len" op=">" val="6"/>
<if obj="7845" par="len" op=">" val="7"/>
<if obj="7845" par="len" op=">" val="8"/>
<if obj="7845" par="len" op=">" val="9"/>
<if obj="7845" par="len" op=">" val="10"/>
<if obj="7845" par="len" op=">" val="11"/>
<if obj="7845" par="len" op=">" val="12"/>
<if obj="7845" par="len" op=">" val="13"/>
<if obj="7845" par="len" op=">" val="14"/>
<if obj="7845" par="len" op=">" val="15"/>
<if obj="7845" par="len" op=">" val="16"/>
<if obj="7845" par="len" op=">" val="17"/>
<if obj="7845" par="len" op=">" val="18"/>
<if obj="7845" par="len" op=">" val="19"/>
</st>
</obj>
</pre>

=== Машина состояний объекта ===
[[Файл:array.jpg]]

==Пример использования==

[http://fs5.absolutist.com/files/wikisample/machine.rar Download]

Machine

2014-03-14T15:35:14Z

Epahomov: /* set */

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

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

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

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

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

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

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

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

=== init ===

====Параметры объекта====

* '''x''','''y''' - координата точки пивота относительно сцены или родительского объекта;
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''al''' - Прозрачность: от 0 (прозрачен) до 1 (не прозрачен);
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима), если vis = 0, это равноценно что отключить объект и редакторе;
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше;

====Параметры движения====

* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys

====Системные действия====

* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга.
Если на девайсе была нажата кнопка "отрейтинговать", то в опции запишется параметр rating значение 1, если нажата кнопка "позже" - rating 2, "никогда" - rating 3.
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто.
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут.
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран.
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние.
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.
* '''id внешней ссылки в текстовой базе''' - Ссыслка будет взята из текстовой базы в соответствии с текущим маркетом.
* '''clone''' - Значение 1 означает, что в текущем местоположении машины будет создана ее копия

====Переходы и параметры выполнения====

* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия выполнения; можно использовать логические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

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

=== set ===

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

* '''obj''' - изменяемый объект (выбирается из списка объектов). В значении объекта можно указать this, это значит что машина сама себе пропишет какой то параметр или состояние.
* '''scr_param''' - глобальный либо текущий экран, параметры которого меняем.
* '''scr_state''' - экран, состояние которого меняем.
* '''parent''' - Объект, который будет установлен в качестве родителя объекту из obj. Объект obj будет оторван от текущего своего родителя и добавлен в детей объекта parent. 
* '''st''' - состояние в которое переводится объект. 
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr,val_vid,val_res,val_node.
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par(параметр для текстов "txtID")
* '''val_vid''' - id video, будет записано в par(параметр для видео "video" - RGB, "videoA" - Alpha)
* '''val_scr''' - id экрана, будет записано в в par
* '''val_res''' - Новое значение графического ресурса (перетаскивается из редактора ресурсов). (пока не работает)
* '''val_node''' - Новое нода графа (выбирается из списка, при заданном объекте)
* '''val''' - значение параметра объекта для установки
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''round''' - округлить значение, записываемое в val 
* '''scr''' - экран на который мы хотим перейти
* '''user''' - 1 - сохранять значения для текущего пользователя. Для всех типов объектов кроме options этот флаг игнорируется 
* '''if''' - номер (начиная с нуля) команды [[#if|if]] при выполнении которого происходит отработка команды set.
* '''break''' - прервать выполнение команд set на этой команде (запустить их снова можно из команд процессов).

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

=== play ===

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

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

Особенности примененияния:

*Короткий звук (''snd'') нельзя запустить в первом (инитном) состоянии машины. Для того, чтобы запустить звук сразу при загрузке экрана, нужно в первом состоянии машины записать мгновенный переход во второе состояние мамашины (например, команда ''wait'', поле ''go'', в поле выбрать второе состояние), а во втором состоянии уже запустить звук. Если звук нужно зациклить и проигрывать какое-то количество раз (''loop=1,2,3,..,n'') или бесконечно (''loop=-1''), то нужно проследить чтобы состояние, в котором запускается звук, не вызывалось повторно во время проигрывания звука, иначе возникнет наложение звуков. Если во время проигрывания звука машина меняет свое состояние, звук продолжает играть. Если в одной машине почти одновременно воспроизводится несколько звуков, то они прерывают друг друга. Если каждый звук воспроизводится в отдельной машине, то они звучат параллельно.
*Длинный звук (''mus'')- музыка. На экране не может воспроизводится несколько длинных звуков одновременно. Любой запуск длинного звука независимо от того, в какой машине он осуществляется, будет прекращать проигрывание предыдущего звука. Музыка, которая проигрывается на глобальном экране, проигрывается на всех экранах проекта.

=== var ===

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

*'''name''' - имя переменной;
*'''obj''' - объект, используемый далее;
*'''par''' - имя параметра, значение которого присваивается переменной;
*'''val''' - значение переменной, если отсутствуют obj и par;
*'''user''' - если стоит "1", то будет считываться с текущего профиля в опциях
*'''func''' - в выпадающем списке можно выбрать функцию:
**'''random''' - использует arg1 и arg2, возвращает случайное целое число в диапазоне arg1 .. arg2.
**'''conc''' - объединяет 4 строки arg1,arg2,arg3,arg4. Возвращает строку, в которой соединены все строки
**'''exp''' - экспонента от аргумента arg1.
**'''ln''' - натуральный логарифм аргумента arg1.
*'''arg1''' - аргумент функции
*'''arg2''' - аргумент функции
*'''arg3''' - аргумент функции
*'''arg4''' - аргумент функции

Обозначенная переменная существует (может использоваться) только в текущем состоянии. Переменная может определятся в одном состоянии только один раз. Если созданной переменной нужно изменить значение в рамках состояния, это можно сделать через другую переменную или через параметр опций ([[Options]]). Если ее значение нужно использовать в другом состоянии, то оно присваивается параметру опций, а затем заново считывается в новом состоянии. Переменные можно указывать в поле ''val'' с другими математическими действиями и цифрами, при этом каждое действие заключать в скобки. Если в поле ''val'' указать имя переменной ''А'' без скобок - воспримется строка ''А'', если указать в скобках - воспримется значение переменной.

=== buy ===

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

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

=== download ===

При переходе в состояние будет совершена попытку закачать контент.
* '''url''' - ссылка на zip архив с контентом в интернете.
* '''объект успех''' - объект, которому в случае успешной закачки будет задаваться указанное состояние.
* '''состояние (успех)''' - состояние, которое будет устанавливаться выше указанному объекту, в случае успешной закачки.
* '''объект (провал)''' -объект, которому, в случае неудачи закачки, будет устанавливаться указанное состояние.
* '''состояние (провал)''' - состояние, которое, в случае неудачи закачки,будет устанавливаться выше указанному объекту.
* '''счетчик прогресса''' - объект, типа счетчик, который отображает прогресс закачки контента. Крайне желательно, что бы он измерялся в диапазоне от 0 до 100.

Существует несколько причин при которых вызывается состояние "провал". Для того что бы сообщить пользователю, по какой именно причине возник провал закачки, следует идентифицировать причины провала. Это возможно сделать с помощью параметра
<pre>
downloadErrCode
</pre>
Ниже приведены значение параметра которые помогут вывести нужное текстовое сообщение :
<pre>
GCUSTOM_ERROR_CODE_ERROR_UNKNOWN = 1, //!< ошибка неклассифицирована
GCUSTOM_ERROR_CODE_WIFI_DISABLED = 2, //!< отключен WIFI
GCUSTOM_ERROR_CODE_SDCARD_UNAVAILABLE = 3, //!< SD-карта недоступна
GCUSTOM_ERROR_CODE_SDCARD_FULL = 4, //!< SD-карта переполнена перед закачкой
GCUSTOM_ERROR_CODE_UNZIP_FAIL = 5 //!< ошибка при распаковки пака (скорее всего на SD-карте не хватает места для распаковки
</pre>

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

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

Если в команде процесса есть условие '''[[#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''' - целевые координаты в пикселях, к которым должен переместиться объект. Можно указывать переменные заданные с помощью [http://ge.absolutist.com/index.php/Machine#var_2 переменной var];
* '''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 на этой команде (запустить их снова можно из команд процессов).

Если у объекта прозрачность ''al=0.00'', то он невидим для всякого взаимодействия. Если у объекта прозрачность ''al=0.01'', то он видим для клика, но невидим для дропа(команда drop на объект не видит объект с прозрачностью ''0.01''). Если у объекта ''al=0.02'', то он видим и для клика, и для дропа.

=== 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), до которой мяч должен подпрыгнуть.

=== spline ===

Сплайн позволяет перемещать машину по заранее заданной траектории.

====Параметры====

*'''key''' - точки сплайна по которым движется
*'''t''' - время движения по траектории
*'''go''' - по окончанию переход в состояние
*'''if''' - условие перехода
*'''loop''' - количество повторений
*'''break''' - прервать команды на этой
*'''wait''' - номер запускаемого действия
*'''init''' - номер запускаемого действия
*'''alpha''' - номер запускаемого действия
*'''rot''' - номер запускаемого действия
*'''move''' - номер запускаемого действия
*'''set''' - номер запускаемого действия
*'''phys''' - номер запускаемого действия

====Построение сплайна====

# в состоянии машины добавляем правой кнопкой мыши действие "spline"
# добавляем минимально необходимые параметры: '''key''' и '''t''', указываем время движения в '''t'''
# выделяем для редактирования поле '''key'''
# записываем координаты точек через запятую, сначала x потом y, например: -211,-248,-151,-248,-91,-247,59,-246,60,101,60,159,1,190
Если записали все координаты вручную, то можно сохранить и проверять.
Или можно в окне списка состояний нажимаем на кнопку "build spline" (справа вверху).
[[Файл:Btn spline.jpg|500px]]

Окно с списком состояний закроется, появится дополнительная панель с настройками сплайна и появится возможность указывать мышкой по экрану точки для сплайна.

[[Файл:Spline panel.jpg|500px]]

Точки сплайна указываются кликом левой кнопки мыши по экрану.

Возможности редактирования:

'''режимы:'''
*'''add''' - по нажатию левой кнопкой мыши по экрану - будет добавлена новая точка, которая соеденится с предидущей
*'''select''' - по нажатию левой кнопкой мыши по точке сплайна появится возможность отредактировать её положение перетащив её или поменяв её координаты в полях x и у
*'''delete''' - по нажатию левой кнопкой мыши по точке сплайна точка удалится

Чтобы удалить все точки сплайна необходимо нажать на кнопку "'''delete all knots'''"

Сохранить сплайн можно нажав на кнопку "'''Save spline'''"

====Дополнительные сведения====

* Время движения между двумя соседними точками всегда одинаково, то есть чем дальше друг от друга соседние точки, тем быстрее будет двигаться объект, чем ближе - тем медленней.

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

=== click ===

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

По клику машина записывает координаты клика в параметры: clickX, clickY.

=== touch_in ===

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

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

=== touch_up ===

Отжатие мыши от машины

* '''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 ===

Данная команда позволяет "таскать" объект по сцене нажав и удерживая клавишу мишки или (палец в случае сенсорного устройства) на нем.Так же есть возможность ограничить разрешенную область таскания, за пределы которой объект вытащить невозможно. [[Файл:drag.jpg|right]]
* '''x1''' - разрешено таскать, когда координата объекта правее;
* '''x2''' - разрешено таскать, когда координата объекта левее;
* '''y1''' - разрешено таскать, когда координата объекта ниже;
* '''y2''' - разрешено таскать, когда координата объекта выше;
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у которого надо изменить состояние;
* '''st''' - новое состояние объекта obj;
* '''за пивот''' - "да" - таскать объект за пивот, "нет" - за ту точку, за которую схватили

=== dragRot ===

Данная команда позволяет вращать объект вокруг точки пивота. Нажав и удерживая клавишу мишки или палец (в случае сенсорного устройства) на нем, мы можем вращать его по часовой либо против часовой стрелки. При многократном вращении вокруг своей оси значение его угла не накапливается, а обнуляется выходя за границы [360 ; -360] градусов. [[Файл:dragRot.jpg|right]]
* '''if''' - номер команды условия (начиная с нуля) разрешения таскания;
* '''obj''' - объект у которого надо изменить состояние;
* '''st''' - новое состояние объекта obj;

=== drop ===

Если нажатая кнопка мышки отпускается, вызвается эта команда. Обычно она используется в связке с командой drag
* '''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.

[[Файл:Апплай.png|500px]]

Блок схема работы '''apply'''

[[Файл:Блок схема apply.png|500px]]

* Сначала у нас проверяется координаты '''x1''', '''x2''', '''y1''', '''y2'''.
* Далее проверяет если '''obj'''
* Если '''obj''' нет, то идёт проверку, и выдаёт результат
(если при этом если '''x1''', '''x2''', '''y1''', '''y2''' нет, то они считаются по ширине и высоте всего экрана.)
* Если есть '''obj''', то проверяет есть ли радиусы '''rm''', '''ro'''.
* Если он есть, то значит у нас '''apply''' по кругам
* Если нет, то проверяем наличие '''x1''', '''x2''', '''y1''', '''y2'''.
* Если они есть, то проверка и результат.
* Если их нет, то проверка идёт по шейпам объектов, и выдаётся результат/
Если не будет стоять ни каких галочек, то проверка будет идти по шейпам объектов.

Пусть, например, есть снаряд, который при помощи мышки надо кинуть в "тыкву". Если мы промахнулись, снаряд должен вернуться обратно, а с тыквой ничего не произойти. Если мы в тыкву попадаем, снаряд также возвращается, а тыква "взрывается":
<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. В этом поле можно указать this, это значит что if будет проводить проверку текущего объекта. Добавлено это вместе с параметром clone. Клоны рождаются и умирают в рамках одного экрана и при рождении имеют id такой же как у объекта оригинала. Для различия клонов между собой машина имеет уникальный параметр "clone_num" у оригинала = -1, у клонов от 0 до N, собственно с помощью this машина может сама себя проверить клон ли она и если да то какой у нее номер;
* '''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.

Для проверки текущего значения прозрачности у объекта можно воспользоваться параметром ''cur_al''

== Математика ==
Математика в appsalute creator представлена 4-мя основными операциями: (плюс), (минус), (умножить), (поделить) 
Организована благодаря совместному использованию '''[[#var|var]]''' и '''[[#set|set]]'''.
=== var ===
Благодаря использованию '''[[#var|var]]''' существует возможность cчитать любой числовой параметр любого объекта. Например: x - координату какой-то машины, текущее значение любого объекта counter или timer и конечно же считывание значения любого параметра из опций! Каким образом это устроено? Рассмотрим подробнее '''[[#var|var]]''': 
[[Файл:VAR.png|right]]
*'''name''' - здесь выбираем имя для нашей будущей переменной, которой будем оперировать далее
*'''obj''' - выбирается объект, параметры которого мы хотим считать
*'''par''' - параметр, который нужно вычитать из объекта, указанного выше
*'''val''' - указывается числовое значение, которое будет установлено по умолчанию в случае отсутствия obj и par
*'''user''' - если стоит "1", то будет считываться с текущего профиля в опциях
На изображении справа можно наблюдать каким образом организован '''[[#var|var]]'''. В данном случае объявлена переменная x_cor, которая cчитывает x-координату объекта actor_1, при этом cчитывание переменной происходит из текущего профиля, так, как в поле user установлено значение равное "1".

=== set ===
[[Файл:SET.png|right]]
Использование '''[[#var|var]]''' без '''[[#set|set]]''' не имеет смысла. Так, как переменная создается, но не используется дальше. Рассмотрим следующий пример, где вычитаем x - координату из одного объекта и сохраним ее в опции, предварительно увеличив ее на 50 единиц (в данном случае 50 пикселей).
На рисунке справа можно наблюдать, каким образом это сделано. В состоянии '''init''' объявляется переменная '''x_cor''', которая cчитывает координату '''x''' из объекта '''actor_1''', таким образом в переменную '''x_cor''' запишется положение по '''x''' объекта '''actor_1'''. Поле '''user''' в данном случае в '''1''' не обязательно устанавливать, так как работа ведется с машинами, а не с опциями. Если бы на месте '''actor_1''' оказался объект '''options''', то это было бы просто необходимо, иначе программа считает значение не из профиля. Далее в '''[[#set|set]]''' выбран объект '''options''', в параметр '''x_position''' которого будет сохранятся значение переменной '''x_cor''' увеличенной на 50. В поле '''round''' идет округление вычисляемого значения, если оно установлено в 1. Поле '''user ''' установлено в 1, это значит, что параметр '''x_position''' будет сохранен в профиль. После это выполняется сохранение опций путем задания объекту '''options''' состояния '''save'''. 
! ! !ВАЖНО: чтобы выполнить какие-то действия с '''[[#var|var]]''' его обязательно нужно указывать в поле '''val''' в '''set''', при этом, если он используется, то все выражение должно стоять в скобках. Если в поле '''val''' не используется переменная, то скобки необязательны.
 
 
 
 
Существует также возможность использовать '''[[#var|var]]''' совместно с '''[[#if|if]]''', а также '''[[#var|var]]''' с '''[[#move|move]]'''
 
 
 
Так же добавилась возможность записывать значение переменной в состояние "st", что значительно уменьшает необходимость в записи 1000 if-ов. При этом, тип переменно в '''[[#var|var]]''' должен быть "строка".

=== var и if ===
[[Файл:IF.png|right]]
При подробном рассмотрении '''[[#if|if]]''' можно заметить, что в нем есть поле '''val''', соответственно в этом поле можно указать переменную. Таким образом в поле '''val''' необязательно указывать константу, а можно указать какую-то переменную, которая может постоянно изменяться. Например, существует два объекта, один находится состоянии покоя, а другой находится в движении. При этом первый объект (тот, который в состоянии покоя) постоянно опрашивает положение второго объекта, и в случае, если у объекта, который движется, '''х''' координата равна '''х''' координате первого объекта, то первый объект входит в состояние, где он начинает свое движение. На рисунке показан объект, который находится в состоянии покоя, рассмотрим его состояния: 
В данном объекте существует два состояния: '''init''' и '''move'''. В '''init''' объект опрашивает другой объект и в случае, когда условие срабатывает, то переходит в состояние '''move''', где начинает свое движение.
В '''init''' создаем переменную, в которую записываем положение по '''x''' объекта '''actor_2''', в '''if''' проверяется условие на соответствие координат объектов '''actor_1''' и '''actor_2''', в данном случае координата объекта '''actor_2''' представлена в виде переменной '''x_cor'''. Если условие выполняется, то происходит переход в состояние '''move''', если нет, то заново проходим состояние '''init''' и повторяем вышеописанную последовательность действий.
 
 
 
 

=== var и move ===
Также с помощью '''[[#var|var]]''' есть возможность указать целевые координаты в '''[[#move|move]]'''. То есть, не обязательно указывать целевые координаты в виде констант, их можно указать теперь с помощью переменных. При использовании '''[[#var|var]]''' и '''[[#move|move]]''' можно организовать обмен двух объектов местами с анимацией движения. Для этого необходимо определять какой объект нажат первым, а какой вторым, сохранять их координаты через объект '''options''' и только потом менять их местами. На рисунке можно увидет, как это организовано.
[[Файл:var_move.png|1000px|thumb|center|]]
Рассмотрим подробнее состояние данной машины:
 
* '''init''' 
В этом состоянии ожидаем клик на объект и обнуляем параметр, который отвечает за то, какой по счету объект сейчас нажат. Так, как при обмене объектов, если мы делаем это по клику, важно знать, по какому кликнули нажали первым, а по какому вторым.
* '''check''' 
Проверяется параметр '''number''', если он равен '''0''', то это значит, что еще ничего не кликали и мы переходим в состояние, где в опции записываются координаты этого объекта, который считается нажатым первым. Если не равен '''0''', то считается, что этот объект нажат вторым и переходит в состояние, где в опции записываются координаты этого объекта, который считается нажатым вторым по счету.
* '''first_object''' 
В этом состоянии записываются координаты объекта в опции. Чтобы записать координаты в опции используются '''[[#var|var]]''' и '''[[#set|set]]''' упоминаемые выше. В опции координаты первого нажатого объекта сохраняются под параметрами '''x_first''' и '''y_first'''. В конце параметру '''number''' присваиваем значение '''1''', чтобы указать, что следующий нажатый объект будет вторым по счету.
* '''second_object''' 
В этом состоянии объект будет в том случае, если он будет нажатым вторым по счету, то есть после состояния '''check''' объект попадет в это состояние, где он запишет свои текущие координаты под параметрами '''x_second''' и '''y_second'''. Запись координат происходит таким же самым образом, что и в состоянии '''first_object'''. После этого он автоматически переходит в следующее состояние.
* '''move_first''' 
В этом состоянии объект будет в том случае, если он был нажат первым, поэтому он будет двигаться на место второго нажатого объекта, который сохранил свои координты в параметры'''x_second''' и '''y_second'''. Движение происходит следующим образом: сперва в переменную вычитываем координаты второго объекта, а потом в '''move''' вместо целевых координат записываем переменные, которые обязательно должны быть взяты в скобки.
* '''move_second''' 
В этом состоянии объект будет в том случае, если он был нажат вторым, поэтому он будет двигаться на место первого нажатого объекта, который сохранил свои координты в параметры '''x_first''' и '''y_first'''. Движение происходит следующим образом: сперва в переменную вычитываем координаты первого объекта, а потом в '''move''' вместо целевых координат записываем переменные, которые обязательно должны быть взяты в скобки.

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

=== Важно знать ===
* Переменная действует в рамках одного состояния, если нужно, чтобы она была глобальной, нужно сохранить ее в опции и потом в нужный момент считывать ее из опций.
* Если складываем два числа, то в поле '''val''' они должны быть записаны в скобках: (5+3).
* Если возникает необходимость написать какое-то более сложное арифметическое вычисление, то следует помнить, что на одно действие приходятся одни скобки. Например: (((5+3)\2)*2).
* Количество открывающих и закрывающих скобок должно быть одинаковым.
* В скобках можно писать переменную, если она была объявлена выше: (5+a).
* Переменная может состоять из цифр и букв и знака нижнего подчеркивания.
* Иногда бывает необходимым использование '''round''' в '''set''', так например, если какой-то параметр получен с помощью арифметических вычислений и потом используется его в каком-то условии, и условие проверяет параметр, как целочисленное значение, то могут возникнуть ошибки. Так, как число будет записано в следующем виде 123.0000 и программа будет считать, что оно не целочисленное, а дробное. И чтобы избавится от лишних нулей в дробной части следует округлять число.
* Действия, которые требуют времени, такие как move, rot, wait и другие перестают работать для уменьшения вычислительной нагрузки на устройство.
* Действия, которые не требуют времени, такие как set, init и другие продолжают функционировать.

<pre>
Если с помощью переменной менять объекту любой параметр, например, координату X, то она запомнится (запишется как значение по умолчанию).
Тогда при повторном попадании на экран считается не тот X, который указан в свойствах, а тот, который установлен через переменную.
Если нужно при ините экрана возвращать начальные значения параметров, то можно сделать это двумя способами:
- не использовать переменную;
- создать отдельное состояние, которое будет "вручную" устанавливать начальные значения параметрам при ините экрана.
Если координата (или другой параметр) меняется другим способом, то будут автоматически при ините экрана подтягиваться значения из свойств объекта.
</pre>

=== Примеры применений ===
С помощью математики можно организовать следующее:
* динамические опции (изменение звука и музыки с помощью ползунка);
* анимацию каунтера в играх (по окончанию уровня можно наблюдать, как изменяются очки);
* подсчет очков (гибкая система подсчета очков);
* обмен объектов местами (использование var и move)
* увеличение z-координаты любого объекта (когда необходимо, чтобы нажатый или таскаемый объект был выше других по z);
* простейший калькулятор;
* и много других.

== Копирование машины состояния с сохранением ссылки на себя ==
Довольно часто бывает, что машина состояний ссылается только на глобальные объекты и на саму себя. При этом, если мы просто скопируем объект, он будет ссылаться на свою предыдущую копию. Этого можно избежать, сделав 3 шага:
1. Переместить объект в отдельную сцену
2. Скопировать данную сцену(имеется в виду обычное копирование, без ссылки)
3. Перенести объект и его копию обратно, в нужную сцену
4. Созданые сцены можно удалить :)

== Guest ==

'''Guest (гость)''' - объект, который перевел машину в текущее состояние. Пример: кнопка ''btn1'' по клику переводит машину ''mch1'' в состояние ''st1'', в этом состоянии у машины ''mch1'' гостем является кнопка ''btn1''. Гостем может быть объект любого типа, если он может менять состояние другому объекту (например: хидден-объект по нахождению может менять состояние объекту, кнопка, машина, пэчворк и т.д.)

В машине состояний можно считывать (проверять) и передавать параметры и состояния гостя. Любое поле ''obj'' в выпадающем списке содержит строку ''guest'', что позволяет работать с гостем, как с любым другим объектом.

=== Пример использования ===

[[Файл:Guest1.jpg|left]]
Пускай экран содержит 3 кнопки (''btn1'', ''btn2'' и ''btn3'') и одну машину ''mch1''. Нужно сделать так, чтобы по клику на любую из кнопок машина перемещалась в ее координаты и переводила кнопку в состояние ''disable''. Так же по клику на кнопку ''btn2'', машина должна перейти в состояние ''bonus''. 
Всем трем кнопкам по клику пропишем передавать объекту ''mch1'' состояние ''check''. 
Создадим в машине три состояния: ''init'' - состояние в котором машина будет находиться по умолчанию, ''check'' - состояние, которое будет вызываться тремя кнопками, в этом состоянии у машины ''mch1'' одна из трех кнопок будет гостем, ''bonus'' - последнее состояние. 
Две команды ''var'' считывают у гостя координаты, т.к. мы не знаем, какая именно кнопка перевела машину ''mch1'' в состояние ''check'', то обращаемся к гостю, а не к кнопкам. За ними следует две команды ''set'', которые передают координаты гостя машине. Еще один ''set'' переводит гостя в состояние ''disable''. И через ''wait'' осуществляется переход в состояние ''bonus'', если гость ''btn2''.

<pre>
При смене состояния гость сохраняется, т.е. в состоянии bonus гостем останется btn2.
</pre>
<pre>
Если машина изначально сама себе меняет состояния, то у нее нет гостя.
</pre>

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

== Массив (Array) ==

В данном объекте реализован массив, имеющий максимальную длинну в 20 элементов.

=== Свойства объекта массив: ===

len - длинна массива. Длинна массива может как считываться, так и записываться. Влияет на количество сохраняемых объектов в Options.

index1 - индекс элемента. (данный массив можно расширить до многомерного и использовать несколько индексов)

val - значение элемента массива, с индексом index1

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

=== Состояния объекта массив: ===

get - при вызове этого состояния во внутреннюю переменную val записывается значение элемента с индексом index1

set - при вызове этого состояния во внутреннюю переменную a1..a20, соответствующую индексу index1 записывается значение val

load - загрузить значения массива из xml.

save - сохранить элементы массива от 1 до len

=== Как использовать? ===

1. Загружаем массив, переводя объект array в состояние load

2. Записываем значения массива

а). Задаём значение свойству index1 объекта array (устанавливаем индекс ячейки, в которую будет заноситься число)
б). Задаём значение свойству val объекта array (устанавливаем значение, которое будет заноситься в ячейку с индексом index1)
в). Переводим объект array в состояние set

3. Считываем значения массива
а). Задаём значение свойству index1 объекта array (устанавливаем индекс ячейки, из которой будет считываться число)
б). Переводим объект array в состояние get
в). Считываем значение из свойства val объекта array

4. Сохраняем массив, переводя объект array в состояние save. Если хотите изменить количество сохраняемых эелментов - предварительно измените параметр len.

=== Копирование объекта ===

При копировании, необходимо заменить в состояниях load и save array.имя_параметра на другое имя. Например, array2.имя_параметра. Копировать следует через использование доп. сцены (см. выше)

=== Достоинства ===

Позволяет избежать необходимости каждый раз создавать большое количество if-ов и set-ов, если необходимо работать с нумерованным списком. Можно один раз создать структуру и копировать её неограниченное количество раз

=== Недостатки ===

Данный объект содержит довольно большое количество кода, поэтому при большом их обилии/длинне может занизить скорость работы сцены и скорость загрузки сцены.

=== Исходный XML код===
Прим. id="369" - идентификатор объекта Options, сохраняющего все переменные приложения. id="7845" - идентификатор объекта

<pre>
<obj id="7845" type="machine" nm="array" sync="1" w="1" h="1">
<st id="init"/>
<st id="get">
<var nm="a1" obj="7845" par="a1"/>
<var nm="a2" obj="7845" par="a2"/>
<var nm="a3" obj="7845" par="a3"/>
<var nm="a4" obj="7845" par="a4"/>
<var nm="a5" obj="7845" par="a5"/>
<var nm="a6" obj="7845" par="a6"/>
<var nm="a7" obj="7845" par="a7"/>
<var nm="a8" obj="7845" par="a8"/>
<var nm="a9" obj="7845" par="a9"/>
<var nm="a10" obj="7845" par="a10"/>
<var nm="a11" obj="7845" par="a11"/>
<var nm="a12" obj="7845" par="a12"/>
<var nm="a13" obj="7845" par="a13"/>
<var nm="a14" obj="7845" par="a14"/>
<var nm="a15" obj="7845" par="a15"/>
<var nm="a16" obj="7845" par="a16"/>
<var nm="a17" obj="7845" par="a17"/>
<var nm="a18" obj="7845" par="a18"/>
<var nm="a19" obj="7845" par="a19"/>
<var nm="a20" obj="7845" par="a20"/>
<set obj="7845" par="val" val="(a1)" round="1" if="0"/>
<set obj="7845" par="val" val="(a2)" round="1" if="1"/>
<set obj="7845" par="val" val="(a3)" round="1" if="2"/>
<set obj="7845" par="val" val="(a4)" round="1" if="3"/>
<set obj="7845" par="val" val="(a5)" round="1" if="4"/>
<set obj="7845" par="val" val="(a6)" round="1" if="5"/>
<set obj="7845" par="val" val="(a7)" round="1" if="6"/>
<set obj="7845" par="val" val="(a8)" round="1" if="7"/>
<set obj="7845" par="val" val="(a9)" round="1" if="8"/>
<set obj="7845" par="val" val="(a10)" round="1" if="9"/>
<set obj="7845" par="val" val="(a11)" round="1" if="10"/>
<set obj="7845" par="val" val="(a12)" round="1" if="11"/>
<set obj="7845" par="val" val="(a13)" round="1" if="12"/>
<set obj="7845" par="val" val="(a14)" round="1" if="13"/>
<set obj="7845" par="val" val="(a15)" round="1" if="14"/>
<set obj="7845" par="val" val="(a16)" round="1" if="15"/>
<set obj="7845" par="val" val="(a17)" round="1" if="16"/>
<set obj="7845" par="val" val="(a18)" round="1" if="17"/>
<set obj="7845" par="val" val="(a19)" round="1" if="18"/>
<set obj="7845" par="val" val="(a20)" round="1" if="19"/>
<if obj="7845" par="index1" val="1"/>
<if obj="7845" par="index1" val="2"/>
<if obj="7845" par="index1" val="3"/>
<if obj="7845" par="index1" val="4"/>
<if obj="7845" par="index1" val="5"/>
<if obj="7845" par="index1" val="6"/>
<if obj="7845" par="index1" val="7"/>
<if obj="7845" par="index1" val="8"/>
<if obj="7845" par="index1" val="9"/>
<if obj="7845" par="index1" val="10"/>
<if obj="7845" par="index1" val="11"/>
<if obj="7845" par="index1" val="12"/>
<if obj="7845" par="index1" val="13"/>
<if obj="7845" par="index1" val="14"/>
<if obj="7845" par="index1" val="15"/>
<if obj="7845" par="index1" val="16"/>
<if obj="7845" par="index1" val="17"/>
<if obj="7845" par="index1" val="18"/>
<if obj="7845" par="index1" val="19"/>
<if obj="7845" par="index1" val="20"/>
</st>
<st id="set">
<var nm="val" obj="7845" par="val"/>
<set obj="7845" par="a1" val="(val)" round="1" if="0"/>
<set obj="7845" par="a2" val="(val)" round="1" if="1"/>
<set obj="7845" par="a3" val="(val)" round="1" if="2"/>
<set obj="7845" par="a4" val="(val)" round="1" if="3"/>
<set obj="7845" par="a5" val="(val)" round="1" if="4"/>
<set obj="7845" par="a6" val="(val)" round="1" if="5"/>
<set obj="7845" par="a7" val="(val)" round="1" if="6"/>
<set obj="7845" par="a8" val="(val)" round="1" if="7"/>
<set obj="7845" par="a9" val="(val)" round="1" if="8"/>
<set obj="7845" par="a10" val="(val)" round="1" if="9"/>
<set obj="7845" par="a11" val="(val)" round="1" if="10"/>
<set obj="7845" par="a12" val="(val)" round="1" if="11"/>
<set obj="7845" par="a13" val="(val)" round="1" if="12"/>
<set obj="7845" par="a14" val="(val)" round="1" if="13"/>
<set obj="7845" par="a15" val="(val)" round="1" if="14"/>
<set obj="7845" par="a16" val="(val)" round="1" if="15"/>
<set obj="7845" par="a17" val="(val)" round="1" if="16"/>
<set obj="7845" par="a18" val="(val)" round="1" if="17"/>
<set obj="7845" par="a19" val="(val)" round="1" if="18"/>
<set obj="7845" par="a20" val="(val)" round="1" if="19"/>
<if obj="7845" par="index1" val="1"/>
<if obj="7845" par="index1" val="2"/>
<if obj="7845" par="index1" val="3"/>
<if obj="7845" par="index1" val="4"/>
<if obj="7845" par="index1" val="5"/>
<if obj="7845" par="index1" val="6"/>
<if obj="7845" par="index1" val="7"/>
<if obj="7845" par="index1" val="8"/>
<if obj="7845" par="index1" val="9"/>
<if obj="7845" par="index1" val="10"/>
<if obj="7845" par="index1" val="11"/>
<if obj="7845" par="index1" val="12"/>
<if obj="7845" par="index1" val="13"/>
<if obj="7845" par="index1" val="14"/>
<if obj="7845" par="index1" val="15"/>
<if obj="7845" par="index1" val="16"/>
<if obj="7845" par="index1" val="17"/>
<if obj="7845" par="index1" val="18"/>
<if obj="7845" par="index1" val="19"/>
<if obj="7845" par="index1" val="20"/>
</st>
<st id="load">
<var nm="a1" obj="369" par="array.a1" user="1"/>
<var nm="a2" obj="369" par="array.a2" user="1"/>
<var nm="a3" obj="369" par="array.a3" user="1"/>
<var nm="a4" obj="369" par="array.a4" user="1"/>
<var nm="a5" obj="369" par="array.a5" user="1"/>
<var nm="a6" obj="369" par="array.a6" user="1"/>
<var nm="a7" obj="369" par="array.a7" user="1"/>
<var nm="a8" obj="369" par="array.a8" user="1"/>
<var nm="a9" obj="369" par="array.a9" user="1"/>
<var nm="a10" obj="369" par="array.a10" user="1"/>
<var nm="a11" obj="369" par="array.a11" user="1"/>
<var nm="a12" obj="369" par="array.a12" user="1"/>
<var nm="a13" obj="369" par="array.a13" user="1"/>
<var nm="a14" obj="369" par="array.a14" user="1"/>
<var nm="a15" obj="369" par="array.a15" user="1"/>
<var nm="a16" obj="369" par="array.a16" user="1"/>
<var nm="a17" obj="369" par="array.a17" user="1"/>
<var nm="a18" obj="369" par="array.a18" user="1"/>
<var nm="a19" obj="369" par="array.a19" user="1"/>
<var nm="a20" obj="369" par="array.a20" user="1"/>
<set obj="7845" par="a1" val="(a1)" round="1" if="0"/>
<set obj="7845" par="a2" val="(a2)" round="1" if="1"/>
<set obj="7845" par="a3" val="(a3)" round="1" if="2"/>
<set obj="7845" par="a4" val="(a4)" round="1" if="3"/>
<set obj="7845" par="a5" val="(a5)" round="1" if="4"/>
<set obj="7845" par="a6" val="(a6)" round="1" if="5"/>
<set obj="7845" par="a7" val="(a7)" round="1" if="6"/>
<set obj="7845" par="a8" val="(a8)" round="1" if="7"/>
<set obj="7845" par="a9" val="(a9)" round="1" if="8"/>
<set obj="7845" par="a10" val="(a10)" round="1" if="9"/>
<set obj="7845" par="a11" val="(a11)" round="1" if="10"/>
<set obj="7845" par="a12" val="(a12)" round="1" if="11"/>
<set obj="7845" par="a13" val="(a13)" round="1" if="12"/>
<set obj="7845" par="a14" val="(a14)" round="1" if="13"/>
<set obj="7845" par="a15" val="(a15)" round="1" if="14"/>
<set obj="7845" par="a16" val="(a16)" round="1" if="15"/>
<set obj="7845" par="a17" val="(a17)" round="1" if="16"/>
<set obj="7845" par="a18" val="(a18)" round="1" if="17"/>
<set obj="7845" par="a19" val="(a19)" round="1" if="18"/>
<set obj="7845" par="a20" val="(a20)" round="1" if="19"/>
<if obj="7845" par="len" op=">" val="0"/>
<if obj="7845" par="len" op=">" val="1"/>
<if obj="7845" par="len" op=">" val="2"/>
<if obj="7845" par="len" op=">" val="3"/>
<if obj="7845" par="len" op=">" val="4"/>
<if obj="7845" par="len" op=">" val="5"/>
<if obj="7845" par="len" op=">" val="6"/>
<if obj="7845" par="len" op=">" val="7"/>
<if obj="7845" par="len" op=">" val="8"/>
<if obj="7845" par="len" op=">" val="9"/>
<if obj="7845" par="len" op=">" val="10"/>
<if obj="7845" par="len" op=">" val="11"/>
<if obj="7845" par="len" op=">" val="12"/>
<if obj="7845" par="len" op=">" val="13"/>
<if obj="7845" par="len" op=">" val="14"/>
<if obj="7845" par="len" op=">" val="15"/>
<if obj="7845" par="len" op=">" val="16"/>
<if obj="7845" par="len" op=">" val="17"/>
<if obj="7845" par="len" op=">" val="18"/>
<if obj="7845" par="len" op=">" val="19"/>
</st>
<st id="save">
<var nm="len" obj="7845" par="len"/>
<var nm="a1" obj="7845" par="a1"/>
<var nm="a2" obj="7845" par="a2"/>
<var nm="a3" obj="7845" par="a3"/>
<var nm="a4" obj="7845" par="a4"/>
<var nm="a5" obj="7845" par="a5"/>
<var nm="a6" obj="7845" par="a6"/>
<var nm="a7" obj="7845" par="a7"/>
<var nm="a8" obj="7845" par="a8"/>
<var nm="a9" obj="7845" par="a9"/>
<var nm="a10" obj="7845" par="a10"/>
<var nm="a11" obj="7845" par="a11"/>
<var nm="a12" obj="7845" par="a12"/>
<var nm="a13" obj="7845" par="a13"/>
<var nm="a14" obj="7845" par="a14"/>
<var nm="a15" obj="7845" par="a15"/>
<var nm="a16" obj="7845" par="a16"/>
<var nm="a17" obj="7845" par="a17"/>
<var nm="a18" obj="7845" par="a18"/>
<var nm="a19" obj="7845" par="a19"/>
<var nm="a20" obj="7845" par="a20"/>
<set obj="369" par="array.a1" val="(a1)" round="1" user="1" if="0"/>
<set obj="369" par="array.a2" val="(a2)" round="1" user="1" if="1"/>
<set obj="369" par="array.a3" val="(a3)" round="1" user="1" if="2"/>
<set obj="369" par="array.a4" val="(a4)" round="1" user="1" if="3"/>
<set obj="369" par="array.a5" val="(a5)" round="1" user="1" if="4"/>
<set obj="369" par="array.a6" val="(a6)" round="1" user="1" if="5"/>
<set obj="369" par="array.a7" val="(a7)" round="1" user="1" if="6"/>
<set obj="369" par="array.a8" val="(a8)" round="1" user="1" if="7"/>
<set obj="369" par="array.a9" val="(a9)" round="1" user="1" if="8"/>
<set obj="369" par="array.a10" val="(a10)" round="1" user="1" if="9"/>
<set obj="369" par="array.a11" val="(a11)" round="1" user="1" if="10"/>
<set obj="369" par="array.a12" val="(a12)" round="1" user="1" if="11"/>
<set obj="369" par="array.a13" val="(a13)" round="1" user="1" if="12"/>
<set obj="369" par="array.a14" val="(a14)" round="1" user="1" if="13"/>
<set obj="369" par="array.a15" val="(a15)" round="1" user="1" if="14"/>
<set obj="369" par="array.a16" val="(a16)" round="1" user="1" if="15"/>
<set obj="369" par="array.a17" val="(a17)" round="1" user="1" if="16"/>
<set obj="369" par="array.a18" val="(a18)" round="1" user="1" if="17"/>
<set obj="369" par="array.a19" val="(a19)" round="1" user="1" if="18"/>
<set obj="369" par="array.a20" val="(a20)" round="1" user="1" if="19"/>
<set obj="369" par="array.len" val="(len)" round="1" user="1"/>
<if obj="7845" par="len" op=">" val="0"/>
<if obj="7845" par="len" op=">" val="1"/>
<if obj="7845" par="len" op=">" val="2"/>
<if obj="7845" par="len" op=">" val="3"/>
<if obj="7845" par="len" op=">" val="4"/>
<if obj="7845" par="len" op=">" val="5"/>
<if obj="7845" par="len" op=">" val="6"/>
<if obj="7845" par="len" op=">" val="7"/>
<if obj="7845" par="len" op=">" val="8"/>
<if obj="7845" par="len" op=">" val="9"/>
<if obj="7845" par="len" op=">" val="10"/>
<if obj="7845" par="len" op=">" val="11"/>
<if obj="7845" par="len" op=">" val="12"/>
<if obj="7845" par="len" op=">" val="13"/>
<if obj="7845" par="len" op=">" val="14"/>
<if obj="7845" par="len" op=">" val="15"/>
<if obj="7845" par="len" op=">" val="16"/>
<if obj="7845" par="len" op=">" val="17"/>
<if obj="7845" par="len" op=">" val="18"/>
<if obj="7845" par="len" op=">" val="19"/>
</st>
</obj>
</pre>

=== Машина состояний объекта ===
[[Файл:array.jpg]]

==Пример использования==

[http://fs5.absolutist.com/files/wikisample/machine.rar Download]

Bejewelled

2014-03-14T15:30:25Z

Epahomov:

Объект «Bejewelled» дает возможность организовать ряд игр, основанных на 3х "модах". 
Все эти механики являются играми на поле, основой, которого является регулярная решетка. Игра происходит при помощи фишек, расположенных в ячейках поля. 

[[Файл:03-02-2014 16-18-27.png|250px|thumb|right]]
=Свойства=
'''Общие параметры'''
*'''Слушатель''' - Объект типа matchbattle.
*'''Время партии''' - Время игры. По окончанию которого будет засчитано поражение.
=Перегруженные правила=
[[Файл:03-02-2014 16-35-45.png|250px|thumb|right]]
*'''Типов фишек''' - Число разновидностей типов фишек.
*'''Номер в фишках''' - Число номеров в фишках. Включая статические.
*'''Номер бомбы''' - Номер фишки, который соответствует бомбе. Не будет генерироваться сам по себе.
*'''Номер крестобомбы''' - Номер фишки, который соответствует крестобомбе, не будет генерироваться сам по себе.
*'''Статический номер''' - Номер фишки, которую нельзя добавить к пометке.
*'''Типов узлов''' - Число разновидностей типов нормальных узлов графа.
*'''Условия пометки''' - Условия для вхождения фишек в пометку. 0 - любые фишки, 1 - должен совпадать номер, 2 - должен совпадать цвет, 3 - должен совпадать номер и цвет фишек.
*'''Монотонность''' - Должны ли номера в первой пометке быть монотонной последовательностью.
*'''Мин.пометка''' - Минимальное число фишек помечаемых в первой пометке.
*'''Макс.пометка''' - Максимальное число фишек помечаемых в первой пометке.
*'''Время пометки''' - Пометка завершается спустя заданное в этом поле время.
*'''Переставлять''' - Фишки первой пометки переставляются.
*'''Уменьшать''' - Фишки первой пометки уменьшают свой номер.
*'''Удалять''' - Удалять ячейки первой пометки.
*'''Условие удаления''' - Условия для удаления фишек: 0 - не удалять, 1 - должен совпадать тип, 2 - должен совпадать номер, 3 - должен совпадать тип ИЛИ номер, 4 - должен совпадать тип И номер.
*'''Тип удаления''' - Тип удаления. 0 - заливка, 1 - вертикальные и горизонтальные линии, 2 - только сама пометка.
*'''Мин.удаление''' - Минимальное число фишек, которое можно удалить.
*'''Генерация без мачей''' - При генерации поля избегать готовых совпадений.
*'''Проверка после осыпания''' - После осыпания фишек ещё раз перепроверить возможные комбинации ходов.
*'''Добавление''' - Нужно ли добавлять фишки на поле. Или игра на разбор.
*'''Схлопывание''' - Нужно ли схлопывание (Ликвидация пустых столбцов).
*'''Менять тип узла''' - Увеличить ли тип нормальной ячейки, если над ней произошла трансформация фишек.
*'''Поддерживать число ходов''' - При осыпании фишек проверить поле на то, чтоб обязательно был возможный ход.
*'''Тащить фишку''' - Тащить первую фишку пометки за пальцем.
*'''Завершать пометку''' - Не ждать отпускания пальца для завершения пометки - актуально в тех случаях, когда в ней всегда одинаковое число фишек.
=Перегруженные цели=
*'''Очистить поле''' - Уничтожить соотв. % фишек. Не стоит комбинировать с досыпанием.
*'''Перекрасить поле''' - Перекрасить все ячейки поля в базовый тип.
*'''Уронить статические''' - Уронить все статические фишки на дно поля.
*'''Уничтожить фишек''' - Уничтожить фишек, количество через запятую.
=Внешний вид=
*'''Картинка''' - Графический ресурс картинки пазла.
*'''Фишки''' - Не рекомендуется использовать. Заменено на добавляемые параметр, см.ниже.
*'''Ячейки''' - Графический ресурс ячейки.
*'''Курсор''' - Курсор для выделения фишек.
*'''Обводка''' - Клип с границами ячеек, 0-й фрейм - верх, дальше по часовой стрелке.
*'''Колонок''' - Число колонок на которые разбивается пазл.
*'''Строк''' - Число строк на которые разбивается пазл.
*'''Авторазмер''' - Если 1, то для расчета размера ячеек используется картинка. 0 - размер ячейки = размер паззла / число ячеек
*'''Сетка?''' - Если 1, то будет показана сетка при разрезке картинки на блоки. При 0 - сетки не будет.
*'''Счетчик статических''' - Счетчик статических. Объект типа каунтер.
*'''Прогресс статических''' - Прогресс-бар статических. Объект типа progress.
=Добавляемые свойства=
*'''Изменить состояние объекта''' - Изменить состояние объекта в случае выигрыша/проигрыша. В случае клика на одиночную: открывает машину в которой необходимо объекту "Коллапс" установить состояние "del_last"
*'''Звук фишки''' - Удаление, появление.
*'''Уровень сложности''' - Номеров в фишках, Мин.размер кластера и Макс.размер кластера.
*'''Эффект''' - Объект, который будет вызываться при взрыве фишек. Должен иметь состояние beg.
*'''Эффект крестобомбы''' - Эффект, который будет использоваться при взрыве крестобомбы. Должен иметь состояние beg.
==Специальные типы ячеек==
*'''Залоченная фон''' - Графика подложки для залоченной ячейки.
*'''Залоченная нашлепка''' - Графика нашлепки для залоченной ячейки.
*'''Недоступная''' - Графика недоступной ячейки.
*'''Шоколадка''' - Графика ячейки-шоколадки
*'''Размножать шоколадку''' - Раз во сколько ходов будет размножаться шоколад.
==Графика фишки==
*'''Обычная''' - Обычная фишка(type=0).
*'''Эффект обычной''' - Объект, который будет использован в качестве эффекта взрыва фишки. Должен иметь состояние beg.
*'''Бомба 2 центр''' - Объект, который будет использован в качестве эффекта взрыва фишки, если та стала бонусной. Должен иметь состояние beg.
*'''Бомба 2 край''' - Объект, который будет использован в качестве эффекта взрыва фишки, если та стала бонусной. Должен иметь состояние beg.
*'''Бомба 2 прочее''' - Объект, который будет использован в качестве эффекта взрыва фишки, если та стала бонусной. Должен иметь состояние beg.
==Уровень сложности==
*'''Минимально ходов''' - Минимальное желаемое количество ходов на старте игры.
*'''Максимально ходов''' - Максимальное желаемое количество ходов на старте игры.
*'''Добавить цветов''' - Число цветов, которых будет больше.
*'''Коэффициент цветов''' - Коэффициент, который применяется к цветам из предыдущего поля.
*'''Типов узлов''' - Число разновидностей типов нормальных узлов графа.
=Пример=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bejewelled.zip

Economics

2014-03-14T15:04:14Z

Epahomov:

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

= Свойства =

*'''предметы''' - Объект типа eitems.
*'''задачи''' - Объект типа taskorganizer.

==Параметры==
===Основные параметры===

*'''Уровни''' - опыт, необходимый для перехода на следующий уровень. Последовательность чисел через запятую.
*'''Уровни парабола''' - Три числа через запятую, задающие коэффициенты параболы, которые определяют необходимый опыт после уже перечисленных уровней.
*'''Энергия''' - максимум энергии на каждом из уровней. Последовательность чисел через запятую. Последнее значение будет зациклено для всех последующих уровней.
*'''Энергия прибавка''' - Число определяющее прибавку к максимуму энергии после уже перечисленных уровней.
*'''Ресурс 1''' - количество ресурса 1 добавляемое за уровень. Последовательность чисел через запятую. Последнее значение будет зациклено для всех последующих уровней.
*'''Ресурс 2''' - количество ресурса 2 добавляемое за уровень. Последовательность чисел через запятую. Последнее значение будет зациклено для всех последующих уровней.
*'''Перезарядка''' - время за которое восстанавливается единица энергии в ms.
*'''нач. ресурс 1''' - Начальное значение ресурса 1.
*'''нач. ресурс 2''' - Начальное значение ресурса 2.
*'''время напоминания''' - время напоминания о задачах на каждом из уровней. Записывается в виде последовательности чисел через запятую. Последнее значение будет зациклено для всех последующих уровней. Время изменяется в часах.
*'''напоминание об энергии''' - уведомление перетаскивается с текстового редактора, представляет собой напоминание о том что энергия восстановилась. Например, "Ваше энергия полностью восстановлена".
*'''опции для facebook''' - поле в опциях, куда мы будем записывать 32битное целое: Уровень + Коллекции.ESocial добавит к ним число друзей и засабмит при вызове соотв. состояние

===Основные счетчики===
Этот раздел содержит необходимые объекты для подсчета (counter, timer, progressbar).

*'''Уровень''' - счетчик текущего уровня игрока.
*'''Прогресс в уровне (счетчик)''' - Набранный на этом уровне опыт и остаток до следующего уровня (счетчик).
*'''Прогресс в уровне (бар)''' - Набранный на этом уровне опыт и остаток до следующего уровня (прогрессбар).
*'''Опыта до уровня''' - счетчик показывающий сколько опыта необходимо для перехода с текущего уровня на следующий.
*'''Текущая энергия''' - прогрессбар текущей энергии.
*'''Максимальная энергия''' - счетчик, который отображает значение максимальной энергии.
*'''Таймер энергии''' - таймер отображающий время до восстановления единицы энергии.
*'''Таймер всей энергии''' - таймер, который отображает время до восстановления всей энергии.
*'''Ресурс 1''' - счетчик первого ресурса (денег).
*'''Ресурс 2''' - счетчик второго ресурса (кристаллов).
*'''анимация рес.1''' - Анимационный объект награды в ресурсе 1. Должен иметь состояние show.
*'''анимация рес.2''' - Анимационный объект награды в ресурсе 2. Должен иметь состояние show.
*'''анимация опыт''' - Анимационный объект награды в опыте. Должен иметь состояние show.

===Окно перед локацией===
Настройка окна, которое всплывает перед посещением локации. В этом окне отображается информация о локации которую мы хотим посетить.

*'''Окно''' - некая машина, олицетворяющая собой само окно превью. Должна иметь состояния ''open'' - открыта, ''open_lvl'' - не хватает лвл, ''open_buy'' - разница в уровнях позволяет нам купить анлок, ''open_item'' - не хватает предмета для анлока, ''open_unlock'' - состояние вызываемое окну перед локацией после успешной покупки предмета для анлока, ''open_energy'' - состояние вызываемое окну перед локацией в случае нехватки энергии.
*'''Превью локации''' - графический ресурс для отображения превью локации. В это поле можно поставить любую картинку для того, чтобы корректно разместить ее в "окне перед локацией". Далее экономикс сам будет подставлять нужные превью.
*'''Название локации''' - текстовый объект, в который будет подставляться название локации.
*'''Описание локации''' - текстовый объект, в который будет подставляться описание локации.
*'''Уровень мастерства''' - счетчик уровня мастерства.
*'''Прогрессбар уровня мастерства''' - прогрессбар, который отображает уровень мастерства.
*'''Текущий уровень''' - счетчик текущего уровня мастерства.
*'''Необходимая энергия''' - счетчик необходимой энергии.
*'''Аномальная энергия''' - счетчик, который отображает дополнительную энергию при наличии аномалии в локации.
*'''Призовой ресурс 1''' - счетчик призовых денег.
*'''Аномальный ресурс 1''' - счетчик, который отображает количество дополнительных призовых денег, которые даются за игру в локацию с наличием аномалии.
*'''Призовой ресурс 2''' - счетчик призовых кристаллов.
*'''Призовой опыт''' - счетчик призового опыта.
*'''Аномальный опыт''' - счетчик, который отображает значение дополнительного опыта, который дается за игру в локацию с наличием аномалии.
*'''Таблица коллекции''' - таблица, в которой будут отображаться предметы, которые можно найти в данной локации.

''для закрытой по уровню локации''
*'''Режим игры''' - машина, которой будут устанавливаться состояния в зависимости от режима игры (может быть смешанный, текст или силуэт). TODO пока обладает только режимом text и icon. Эта машина будет передавать настройки таблице, в которую помещаются поисковые объекты, поэтому важно, чтобы к этой таблице был доступ (например она может находится на глобальном экране).

*'''индикатор уровня''' - счетчик с необходимым для локации уровнем.

''для локации c ценой''

*'''цена ресурс 1''' - Стоимость анлока локации в ресурсе 1.
*'''цена ресурс 2''' - Стоимость анлока локации в ресурсе 2.

''для локации c требуемым предметом''

*'''предмет''' - иконка необходимого для локации предмета.
*'''название предмета''' - в этом поле указывается название, необходимого для локации предмета.
*'''счетчик цены''' - счетчик, который отображает стоимость предмета.
*'''иконка цены''' - иконка цены предмета, представляет собой картинку, которая перетаскивается из базы ресурсов.
*'''кнопка купить''' - Будет видна, если предмет нужно купить. Передает экономиксу состояние unlock_item.
*'''кнопка искать''' - Будет видна, если предмет поисковый.
*'''блок аномалии''' - контейнер, представляющий собой машину, которая содержит всю информацию про аномалию. Должна содержать в себе состояния hide, show и remov (состояние после прогона аномалии, чтобы сделать красивые эффекты, после которого машина попадет в состояние hide).
*'''иконка аномалии''' - иконка аномалии.
*'''название аномалии''' - текстовый объект, который будет отображать название аномалии.
*'''описание аномалии''' - текстовый объект, который будет отображать описание аномалии.
*'''иконка предмета''' - иконка предмета, необходимого для того что бы прогнать аномалию.
*'''кнопка прогнать предметом''' - кнопка по нажатию которой, можно прогнать аномалию используя предмет.
*'''кнопка купить предмет''' - кнопка по нажатию которой, можно купить предмет для прогона аномалии.
*'''кнопка прогнать миниигрой''' - кнопка по нажатию которой, можно прогнать аномалию миниигрой.

===Окно после локации===

Настройка окна, которое всплывает после посещения локации. В этом окне отображается информация о полученных очках и предметах за исследование локации.

*'''Окно''' - некая машина, олицетворяющая собой само окно превью. Должна иметь состояние ''open''.
*'''Название локации''' - текстовый объект, в который будет подставляться название локации.
*'''Описание локации''' - текстовый объект, в который будет подставляться описание локации.
*'''Уровень мастерства''' - счетчик уровня мастерства.
*'''Прогрессбар мастерства''' - прогрессбар, который отображает уровень мастерства.
*'''Текущий уровень''' - счетчик текущего уровня мастерства.
*'''Призовой ресурс 1''' - счетчик призовых денег.
*'''Аномальный ресурс 1''' - счетчик, который отображает количество дополнительных денег за прохождение локации с аномалией.
*'''Призовой ресурс 2''' - счетчик призовых кристаллов.
*'''Призовой опыт''' - счетчик призового опыта.
*'''Аномальный опыт''' - счетчик, отображающий дополнительный призовой опыт, который дается за прохождение локации с аномалией.
*'''Таблица коллекции''' - таблица, в которой будут отображаться предметы, которые можно найти в данной локации.
*'''ничего не найдено''' - Любой объект, так или иначе сообщающий игроку, что он не нашел ничего ценного.

===Окно перед монстром===
*'''окно''' - некая машина, олицетворяющая собой само окно превью. Должна иметь состояние open - все условия выполнены, open_energy - не хватает энергии для игры, но предмет для прогона есть, open_item - есть энергия, но не хватает предмета для прогона, open_item_energy - не хватает энергии для игры и нет предмета для прогона.
*'''превью монстра ''' - картинка, отображающая превью монстра.
*'''название монстра''' - текстовый объект, показывающий название монстра.
*'''описание монстра''' - текстовый объект, показывающий описание монстра.
*'''необходимая энергия''' - счетчик, отображающий количество необходимой энергии.
*'''призовой ресурс 1''' - счетчик, отображающий количество призовых денег.
*'''призовой опыт''' - счетчик, отображающий количество призового опыта.
*'''таблица коллекции''' - таблица, в которой будут отображаться предметы, которые можно отжать у данного монстра.
*'''иконка предмета''' - картинка, которая отображает предмет необходимый для игры с монстром.
*'''нужно предметов''' - счетчик, который отображает необходимое количество предметов.
*'''есть предметов''' - счетчик, который отображает текущее количество предметов, находящееся в наличии.
*'''суммарная стоимость''' - счетчик, который отображает суммарную стоимость недостающих предметов.
*'''кнопка купить''' - кнопка, по нажатию которой, происходит покупка недостающих предметов.
*'''кнопка прогнать''' - кнопка, по нажатию которой, можно прогнать монстра не играя в игру, эту кнопку можно не задавать.

===Окно после монстра===

*'''окно''' - некая машина, олицетворяющая собой само окно превью. Должна иметь состояние open.
*'''превью монстар''' - картинка, отображающая превью монстра.
*'''название монстра''' - текстовый объект, показывающий название монстра.
*'''описание монстра''' - текстовый объект, показывающий описание монстра.
*'''призовой ресурс 1''' - счетчик, отображающий количество призовых денег.
*'''призовой опыт''' - счетчик, отображающий количество призового опыта.
*'''таблица коллекции''' - таблица, в которой будут отображаться предметы, которые можно отжать у данного монстра.
*'''ничего не найдено''' - любой объект, сообщающий игроку, так или иначе, что он не нашел ничего ценного на данной локации.

===Окно коллекций===

*'''Шаблон коллекции''' - ссылка на объект типа ecollection который будет использоваться в качестве исходного для всех коллекций.
*'''Таблица''' - таблица, куда по ссылке будут добавлены шаблоны коллекции.
*'''алерт''' - некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open. Окно с информацией о предмете всплывает в окне с коллекциями.
*'''иконка''' - Иконка предмета.
*'''текст (объект)''' - Текстовый объект в окошке.
*'''описание (объект)''' - Текстовый объект в окошке, в который сложим описание предмета.
*'''имя коллекции (объект)''' - В это поле будет записано имя коллекции, к которой относится предмет.
*'''цифры''' - фреймовая анимация содержащая в себе цифры. Последний фрейм анимации - отметка много.

===Окошко коллекционного предмета===

*'''окно''' - Некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open. Окошко всплывает при клике на предмет в таблице окна перед/после локации.
*'''иконка''' - Иконка предмета.
*'''текст (объект)''' - Текстовый объект в окошке.
*'''описание (объект)''' - Текстовый объект в окошке, в который сложим описание предмета.
*'''имя коллекции (объект)''' - В это поле будет записано имя коллекции, к которой относится предмет.

===Окошко поздравления со сдачей коллекции===

*'''окно''' - некая машина,содержащая необходимую информацию, олицетворяющая само окно предмета. Должна иметь в себе состояние open.
*'''иконка''' - картинка отображающая иконку предмета-награды.
*'''текст(объект)''' - текстовый объект, отображающий название коллекции.
*'''призовой ресурс 1''' - счетчик, отображающий количество призовых денег.
*'''призовой опыт''' - счетчик, отображающий количество призовых денег.

===Окошко инвентарного предмета===

*'''окно''' - Некая машина, олицетворяющая собой само окно предмета. Должна иметь состояние open. Окошко всплывает при клике на предмет в таблице окна перед/после локации.
*'''иконка''' - Иконка предмета.
*'''текст (объект)''' - Текстовый объект в окошке.
*'''описание (объект)''' - Текстовый объект в окошке, в который сложим описание предмета.

===Окошко поздравления с получением уровня===

*'''окно''' - некая машина, содержащая необходимую информацию, олицетворяющая собой само окно предмета. Должна иметь состояние open.
*'''уровень''' - счетчик, отображающий номер полученного уровня.
*'''энергия''' - счетчик, отображающий количество энергии, которая прибавляется к максимуму.
*'''ресурс 1''' - счетчик, отображающий количество денег.
*'''ресурс 2''' - счетчик, отображающий количество кристаллов.

===Окошко поздравления с получением уровня и открытием локации===

*'''окно''' - некая машина, содержащая необходимую информацию, олицетворяющая собой само поздравительное окошко. Должна иметь состояние open.

*'''уровень''' - счетчик, отображающий номер полученного уровня.

*'''энергия''' - счетчик, отображающий количество энергии, которая прибавляется к максимуму.

*'''ресурс 1''' - счетчик, отображающий количество денег.

*'''ресурс 2''' - счетчик, отображающий количество кристаллов.

*'''иконка локации''' - картинка, отображающая иконку локации, которая стала доступна

*'''описание локации''' - текстовый объект, который отображает описание локации, которая стала доступна.

===Окошко получения уровня на локации===

*'''окно''' - некая машина, содержащая необходимую информацию, олицетворяющая собой само поздравительное окошко. Должна иметь состояние open.
*'''опции''' - поле в опциях, в которое записывается уровень по локации.

===Окошко, когда не хватает чарджера (общее) ===

*'''окно''' - некая машина, содержащая необходимую информацию, олицетворяющая собой само уведомительное окошко. Должна иметь состояние open.
*'''иконка''' - картинка, отображающая иконку предмета, который игрок получит за сдачу коллекции.
*'''текст''' - текстовый объект, который будет отображать описание коллекции.
*'''суммарная цена ресурса 1''' - счетчик, отображающий суммарную цену всех необходимых чарджеров, представлена в виде ресурса 1 (деньги).
*'''суммарная цена ресурса 2''' - счетчик, отображающий суммарную цену всех необходимых чарджеров, представлена в виде ресурса 2 (кристаллы).
*'''кнопка купить все''' - кнопка, по нажатию которой, происходит покупка необходимых предметов. Если в кнопке есть необходимость она будет появляться, в противном случае - сама исчезать.

===Окошко, которое выезжает когда найден коллекционный предмет ===

*'''окно''' - некая машина, содержащая необходимую информацию, олицетворяет собой само поздравительное окошко. Должна иметь состояние show.
*'''текст''' - текстовый объект, который используется для отображения названия коллекции.
*'''таблица''' - таблица, в которую складываются объекты коллекции.

===Дополнительные достижения ===

В этом разделе указаны некоторые достижение, которые отправляются объектом economics в gamecenter.

*'''достижение на трату ресурса 1''' - id достижения, отправляемого за трату ресурса 1 (когда игрок потратит сумму ресурса из следующего поля отправляется достижение 100%).
*'''количество ресурса 1''' - сумма ресурса 1, которую необходимо потратить для получения достижения.
*'''достижение на трату ресурса 2''' - id достижения, отправляемого за трату ресурса 2 (когда игрок потратит сумму ресурса из следующего поля отправляется достижение 100%).
*'''количество ресурса 2''' - сумма ресурса 2, которую необходимо потратить для получения достижения.
*'''достижение на число открытых локаций''' - id достижения, отправляемого за открытия количества локаций из следующего поля (при открытии нужного количества локаций отправляется 100% достижения).
*'''количество локаций''' - кол-во локаций, которое необходимо открыть для получения достижения.
*'''достижение за покупки чего-либо''' - id достижения, отправляемого за совершенное количество покупок из следующего поля (при покупке нужного кол-ва отправляется 100% достижения).
*'''количество покупок''' - количество покупок, которое необходимо свершить для получения достижения.

=== Настройки симуляции ===

*'''время''' - время симуляции, измеряется в секундах.

*'''минимум в локации''' - нижняя граница диапазона времени проводимого игроком в хиддене. Отображается в виде доли от времени из настроек локации.

*'''максимум в локации''' - верхняя граница диапазона времени проводимого игроком в хиддене. Отображается в виде доли от времени из настроек локации.
*'''порог покупки''' - число, указывающее какую долю, от ресурсов игрока, должна составлять цена локации, что бы он решился её купить.
*'''порог покупки предмета''' - число, указывающее какую долю,от ресурсов игрока, должна составлять цена предмета, что бы он решился его купить.
*'''вероятность задачи''' - число, отображающее вероятность того, что симуляция будет выбирать не из всех доступных локаций, а из связанных с заданиями.
*'''вероятность матча''' - число, отображающее вероятность того, что симуляция будет играть в матч.
*'''изначально хинтов''' - изначальное количество хинтов.
*'''предметов на хинт''' - на сколько найденных предметов игрок израсходует хинт.
*'''цена хинта монеты''' - сколько монет (ресурс 1), стоит некий усредненный хинт.
*'''цена хинта клисталлы''' - сколько кристаллов (ресурс 2), стоит некий усредненный хинт.
*'''хидденов подряд''' - игрок будет пытаться пройти не менее данного числа хидденов подряд.
*'''восстановить энергии''' - некое усредненное количество энергии для восстановления.
*'''цена энергии монеты''' - сколько монет стоит энергия (цена в ресурсе 1).
*'''цена энергии кристаллы''' - сколько кристаллов стоит энергия (цена в ресурсе 2).
*'''вероятность победы в матче'' - число, отображающее вероятность победы в матче.
*'''время в матче''' - условное время пребывания в матче.
*'''вероятность покупки за реал''' - каждый раз когда игроку не хватает денег или кристаллов - проверяем эту вероятность.
*'''цена монеты в деньгах''' - цена монеты в деньгах.
*'''количество монет в покупке''' - количество монет в покупке.
*'''цена кристаллов в деньгах''' - цена кристаллов деньгах.
*'''количество кристаллов в покупке''' - количество кристаллов в покупке.

==Поле economics setup==
По клику на "..." открывается редактор экономикса. В этом редакторе можно задать все настройки локациям и коллекциям, которые используются в игре.

[[Файл:Economics 1.jpg|500px]]

Economics setup содержит 11 вкладок : локация хидден, коллекция, предметы, окошко когда не хватает чарджера (чарджер), нехватка ресурсов на чарджер, монстр, летающий объект, аномалия, сдача коллекции, временный эффект, достижение.
Вверху можно увидеть ряд кнопок для добавления и удаления: справа для локаций, слева для уровней мастерства.

===Локация хидден===

Форма редактора экономикса разделена на 4 колонки. В первой колонке мы видим список локаций, используемых в игре. Имена локаций можно изменять. Добавляются новые локации по нажатию на кнопку ''Добавить локацию'', удаляются кнопкой ''Удалить локацию''. Во второй колонке отображаются свойства выделенной локации.

[[Файл:Economics 2.jpg|right]]
*'''Объект на карте''' - это объект ведущий в локацию с карты. Должен иметь как минимум состояния open и closed, которые ему будет вызывать экономикс.
*'''индиктор уровня''' - каунтер, который будет отображать номер уровня, начиная с которого локация доступна.
*'''Экран''' - экран, в котором расположен локация.
*'''Превью локации''' - графический ресурс для отображения превью локации из базы ресурсов.
*'''Имя локации''' - название локации, перетаскивается из текстовой базы.
*'''Описание локации''' - описание, перетаскивается из текстовой базы.
*'''Уровень''' - уровень требуемый для того, чтобы играть в локацию.
*'''Результат''' - имя поля в опциях, куда локацией будет занесен результат. Расчитываем найти там число.
*'''Связанный хидден лист''' - хидден-лист, связанный с локацией.
*'''необходимый предмет''' - предмет необходимый для входа в локацию. Может быть как коллекционным, так и инвентарным.
*'''разница в уровнях''' - разница в уровнях, при которой можно купить доступ в локацию.
*'''цена ресурс 1''' - если наш уровень ниже необходимого на разницу из верхнего поля, мы можем разлочить локацию за деньги.
*'''цена ресурс 2''' - если наш уровень ниже необходимого на разницу из верхнего поля, мы можем разлочить локацию за кристаллы.
*'''достижение''' - достижение, которое будет открываться по мере игры в эту локацию.
*'''процент''' - проценты достижения из предыдущего поля.

В третей колонке записываются уровни мастерства. Их можно переименовать. Добавляются кнопкой ''Добавить уровень мастерства''. Удаляются кнопкой ''Удалить уровень мастерства''. В четвертой колонке настраивается выделенный уровень мастерства.

[[Файл:Economics 3.jpg|right]]
*'''энергия''' - энергия требуемая для того, чтобы играть в локацию.
*'''ресурс 1''' - деньги даваемые за прохождение локации.
*'''ресурс 2''' - кристаллы даваемые за прохождение локации.
*'''опыт''' - опыт даваемый за прохождение локации.
*'''кол-во объектов''' - максимальное количество доступных для поиска объектов в одной игровой сессии.
*'''время игры''' - общее время игры (если -1, то игнорируется).
*'''режим игры''' - режим игры: 0 - случайный, 1- слова, 2 - силуэты.
*'''аномалия''' - вероятность возникновения аномалии в локациях.
*'''доступные аномалии''' - перечень доступных на данном уровне мастерства аномалий. Записываются в виде чисел через запятую. Доступные значения 0, 1, 2, 3.
*'''множитель''' - коэффициент, на который умножаются набранные очки. при расчете перехода на следующий уровень. Может быть меньше 1.
*'''постоянный прирост''' - постоянный прирост, если он больше 0, то будет использоваться ВМЕСТО реально набранных в хиддене очков и множителя.
*'''очки''' - очки, которые нужно набрать для перехода на следующий уровень мастерства. Набранные в локции очки умножаются на множитель и суммируются. Когда превысят это значение - произойдет переход.
*'''Предметы''' - id коллекционных предметов, которые можно найти на локации. Не обязаны принадлежать к одной коллекции. Перетаскиваются из текстового редактора. Будет использоваться их иконка.
*'''Вероятность''' - вероятность найти один из коллекционных предметов из предыдущего поля.
*'''Вероятность 2''' - вероятность найти один из коллекционных предметов из предыдущего поля.
*'''Вероятность 3''' - вероятность найти один из коллекционных предметов из предыдущего поля.
*'''Инвентарь''' - id инвентарных предметов, которые можно найти на локации. Перетаскиваются из текстового редактора.
*'''Вероятность инв.''' - вероятность найти один из инвентарных предметов из предыдущего поля.
*'''Вероятность инв. 2''' - вероятность найти один из инвентарных предметов из предыдущего поля.
*'''Вероятность инв. 3''' - вероятность найти один из инвентарных предметов из предыдущего поля.

===Коллекция===

Во вкладке ''Коллекция'' используются только первые две колонки. В первой колонке отображаются добавленные коллекции. Добавляются кнопкой ''Добавить локацию''. Удаляются кнопкой ''Удалить локацию''. Коллекции можно переименовывать. Второй столбик содержит id предметов входящих в коллекции. Перетаскиваются из текстового редактора. Будет использоваться их иконка. Ресурс 1 и ресурс 2 - ресурсы, которые даются за сдачу коллекции. Опыт - опыт, который дается за сдачу коллекции.

*'''имя''' - Имя (а также - описание, если нужно) конкретно коллекции.
*'''предметы''' - id предметов входящих в коллекции. Перетаскиваются из текстового редактора. Будет использоваться их иконка.
*'''ресурс 1''' - деньги даваемые за сдачу коллекции.
*'''ресурс 2''' - кристаллы даваемые за сдачу коллекции.
*'''опыт''' - опыт даваемый за сдачу коллекции.
*'''награда''' - предмет даваемый за сдачу коллекции. Перетаскивается из текстовой базы.
*'''заряжатели''' - Предметы инвентаря, необходимые для сдачи коллекции. ВНИМАНИЕ: будут использоваться не более первых 4х элементов списка.

===Предметы===

Раздел "Предметы" позволяет добавлять список инвентарных предметов, которые могут использоваться в процессе игры, предоставлять различные бонусы. В первой колонке список предметов. Добавляется кнопкой "Добавить локацию", удаляется кнопкой "Удалить локацию". Предметы могут быть переименованы. Во второй колонке записаны свойства каждого предмета.

[[Файл:Economics 4.jpg|350px|right]]

*'''nm''' - имя предмета

*'''section''' - категория предмета.

*'''use''' - если 1, то предмет может использоваться (кнопка Use видимая).

*'''nm''' - имя предмета (txtID).

*'''опции''' - если это поле задано, то в него будет записываться актуальное количество объектов.

*'''начальное количество''' - начальное количество предметов данного типа в инвентаре.

*'''можно продать''' - возможность продавать предмет: 1 - можно продать, 0 - нельзя продать.

*'''уникальный''' - если 1 - то предмет уникальный пропадает после покупки, если 0 - предмет после покупки не пропадает.

*'''res1''' - цена предмета в ресурсе 1.

*'''res2''' - цена предмета в ресурсе 2.

*'''sres1''' - продажа - цена предмета в ресурсе 1.

*'''sres2''' - продаже - цена предмета в ресурсе 2.

*'''en''' - восстанавливает энергии единовременно.

*'''tm''' - длительность действия в секундах.

*'''dTm''' - уменьшение времени восстановления энергии в %.

*'''dFnd''' - увеличение вероятности нахождения предмета в %.

*'''dExp''' - увеличение начисляемого опыта в %.

*'''dRes1''' - увеличение полученного ресурса 1 в %.

*'''dRes2''' - увеличение полученного ресурса 2 в %.

*'''dOvP''' - увеличение перегруженной вероятности нахождения предметов в %.

*'''num''' - число предметов в сундуке. Выбираются случайно из следующего поля. При 0 - следующее поле не используется.

*'''items''' - предметы, которые можно найти в сундуке. Перетаскиваются из текстовой базы.

*'''use_id''' - задание этого поля говорит о том, что данный предмет является оптовым пучком для предмета указанного у этом поле. Num, в этом случае, - количество.

*'''объект''' - связанный объект, будет добавляться в инвентарь.

*'''достижение''' - достижение, которое будет открываться по мере применения подобный предметов.

*'''процент''' - процент достижения их предыдущего поля.

*'''владелец''' - на данный момент - номер правильной кнопки в окне угадайки (если -1. то игнорируется).

===Окошко когда не хватает чарджера===
Позволяет добавлять окна. Окно добавляется кнопкой "Добавить локацию", окно можно переименовывать, удаляется кнопкой "Удалить локацию".

*'''название''' - текстовый объект в который вкладывается название чарджера.
*'''иконка''' - иконка чарджера.
*'''описание''' - текстовый объект в который вкладывается название чарджера.
*'''купить''' - кнопка покупка чарджера, передает economics состояние buy_charger.
*'''искать''' - кнопка поиска чарджера, передает economics состояние search_charger.
*'''есть''' - счетчик, который показывает сколько чарджеров есть сейчас.
*'''нужно''' - счетчик, который показывает сколько чарджерова необходимо для сдачи коллекции.
*'''цена ресурса 1''' - счетчик, который показывает цену чарджера в ресурсе 1.
*'''цена ресурса 2''' - счетчик, который показывает цену чарджера в ресурсе 2.
*'''достаточно''' - объект, который отображается вместо кнопки, в тот момент, когда чарджеров достаточное количество.

===Нехватка ресурсов на чарджер===
Позволяет изменить состояние выбранному объекту при нехватке ресурсов на чарджер. Добавляется кнопкой "Добавить локацию", можно переименовывать, удаляется кнопкой "Удалить локацию".

===Монстр===
В первой колонке добавляется монстр, добавляется кнопкой "Добавить локацию", если возможность переименовать, удаляется кнопкой "Удалить локацию"
Во второй колонке отображаются свойства выделенной колонки.

*'''Объект на карте''' - объект, который представляет монстра на карте. Как правило окно, которое должно иметь состояние hide (скрыт),show и disappear (прогнали).
*'''Имя монстра''' - текстовый id из которого берется иконка, имя и описание монстра.
*'''Экран''' - экран в котором расположена локация.
*'''min уровень''' - уровень, при достижении которого, появляется монстр.
*'''max уровень''' - уровень, при достижении которого, монстр исчезает.
*'''необходимый предмет''' - предмет необходимый для игры с духом.
*'''количество''' - количество предметов из поля "необходимый предмет".
*'''связанный баттл''' - поле в котором указывается связанный баттл.
*'''связанный матч''' - полое в котором указывается связанный матч.

В третей колонке записываются уровни мастерства. Их можно переименовывать. Добавляются уровни кнопкой "Добавить уровень мастерства", удаляются кнопкой "Удалить уровень мастерства".
В четвертой колонке настраивается выделенный уровень мастерства.

*'''энергия''' - энергия необходимая для того, что бы можно было начать играть в локацию.
*'''ресурс1''' - деньги даваемые за прохождение локации.
*'''опыт''' - опыт даваемый за прохождение локации.
*'''постоянный прирост''' - постоянный прирост.
*'''очки''' - количество очков, которое необходимо набрать для перехода на следующий уровень мастерства.
*'''предметы''' - id коллекционных предметов, которые можно найти на локации. Предметы не обязательно должны быть из одной коллекции. Необходимые предметы перетаскиваются из текстового редактора, при этом будет использоваться их иконка.
*'''Вероятность''' - вероятность найти один из коллекционных предметов из поля "предметы".
*'''Вероятность 2''' - вероятность найти один из коллекционных предметов из поля "предметы".
*'''Вероятность 3''' - вероятность найти один из коллекционных предметов из поля "предметы".
*'''Инвентарь''' - id инвентарных предметов, которые можно найти на локации. Перетаскиваются из текстового редактора.
*'''Вероятность инв.''' - вероятность найти один из инвентарных предметов из поля "инвентарь".
*'''Вероятность инв. 2''' - вероятность найти один из инвентарных предметов из поля "инвентарь".
*'''Вероятность инв. 3''' - вероятность найти один из инвентарных предметов из поля "инвентарь".
*'''жизни врага''' - записываются значения вражеских жизней.
*'''начальные жизни врага''' - начальное значение вражеских жизней.
*'''регенерация врага''' - время (в ms), за которое у противника отрастает жизнь. Если установлено -1, то отрастания жизни противника на происходит.
*'''число цветов''' - это число будет записываться в параметр numTokenNums матча.

===Летающий объект===
Впервой колонке кнопкой "Добавить локацию" добавляется летающий объект - объекты которые вылетают после прохождения локации или после покупки сундуков. Удаляется кнопкой "Удалить локацию". Во второй колонке добавляется объект выделенного летающего объекта. Состояния hide, wait, inventory и collection - обязательны для этого предмета.

''hide'' - состояние, когда объект не видно на экране. В этом состоянии можно указать свойство alpha=0.

''wait'' - состояние, в которое попадают летающие объекты, которые отображают коллекционные предметы до того, как объекту economics будет вызвано состояние col_item_found.

''collection'' - состояние, которое будет вызвано летающему объекту, который отображает коллекционный предмет после того как объекту economics будет вызвано состояние col_item_found (он может лететь в таблицу с нужной коллекцией).

''inventory'' - состояние, которое вызывается летающему объекту в случае, если он отображает инвентарный объект (в этом состоянии предмет становится видимым и в дальнейшем может перемещаться).

===Аномалия===

В хидден-локации могут присутствовать аномалии, затрудняющие ее прохождение.
Впервой колонке добавляется аномалия, добавляется кнопкой "Добавить локацию", можно переименовывать, удаляется кнопкой "Удалить локацию".
Во второй колонке отображаются свойства выделенной аномалии.
*'''id''' - поле в которое перетаскивается текстовый id, из которого используется название, описание и иконка аномалии.
*'''предмет''' - предмет необходимый для того, что бы изгнать аномалию.
*'''экран''' - в этом поле указывается экран, в котором расположена миниигра.
*'''прибавка к энергии''' - указывается прибавка к энергии, поскольку для игры в аномалию будет нужно больше энергии. Например, при значении 0,5 - энергии потребуется больше в полтора раза.
*'''прибавка к опыту''' - указывается прибавка к опыту, поскольку игра в локацию с аномалией будет давать больше опыта. Например, при значении 0,5 - опыта приобретается больше в полтора раза.
*'''прибавка к ресурсу 1''' - указывается прибавка к ресурсу 1. поскольку игра в локацию с аномалией будет давать больше ресурса 1. Например, при значении 0,5 - ресурса 1 приобретается больше в полтора раза.

===Сдача коллекции===

В первой колонке добавляется событие на сдачу коллекции кнопкой "Добавить локацию", удаляется кнопкой "Удалить локацию".
Во второй колонке устанавливается состояние объекту сдачи коллекции.

===Временный эффект===

Временный эффект - визуализация действия различных инвентарных объектов, которые применил игрок.
В первой колонке создается временный эффект, добавляется кнопкой "Добавить локацию", удаляется кнопкой "Удалить локацию".
Во второй колонке устанавливаются свойства выделенного временного эффекта.

*'''иконка''' - из редактора ресурсов, перетаскивается иконка временного эффекта
*'''таймер''' - указывается объект типа timer, который соответствует выбранному временному эффекту.
*'''подложка''' - из редактора ресурсов, перетаскивается картинка подложки для таймера указанного в поле "таймер".

===Достижение===
В первой колонке записываются достижения. Добавляются кнопкой "Добавить локацию", удаляются кнопкой "Удалить локацию".
Во второй колонке отображаются свойства выбранного достижения.

*'''достижение''' - достижение, которое будет открываться по мере применения подобных предметов.

*'''процент''' - в виде числа, указывается процент достижения из поля "достижение".

*'''режим игры''' - указывается режим игры, ели 0 - режим игры не важен для достижения, 1 - режим игры слова, 2 - режим игры силуэты.

*'''аномалия''' - указывается аномалия необходимая для достижения, если указывается -2 - то аномалия не важна для достижения, если указывается -1 - то для достижения может использоваться любая аномалия.

==Состояния==

[[Файл:Economics 5.jpg|right]]
Перед вызовом некоторых состояний объекту economics необходимо передать параметр '''param''' и его значение. Например когда нам нужно открыть окно перед локацией мы передаем параметр номера этой локации в списке локаций (начиная с 0).

 
*'''idle''' - состояние по умолчанию.
*'''completed''' - передает состояние окончания исследования локации (необходим параметр номера локации).
*'''exp''' - передает состояние начисления опыта (необходим параметр количества опыта). Нужен больше для тестирования, чем для самой игры.
*'''play''' - передает состояния перехода на локацию для исследования(при условии что хватит энергии и выполнены прочие условия).
*'''location''' - открывает окно перед локацией (необходим параметр номера локации).
*'''collection''' - заставляет экономикс заполнить таблицу коллекций. Лучше вызывать сразу перед открытием окна коллекций или во время его открытия.
*'''collections_scroll''' - заполняет таблицу коллекций и проматывает на коллекцию содержащую последний предмет для которого было показано окошко с информацией о предмете.
*'''item_collections''' - заставляет экономикс показать окошко с информацией о коллекционном предмете. Вызывается при тапе на таблицу в темплейте коллекций (объект ecollection).
*'''item_effect''' - сообщает economics, что необходимо показать окошко предмета от таймэфекта (необходим параметр номера эффекта)
*'''item_preview''' - заставляет экономикс показать окошко с информацией о предмете, который можно найти при обыске локации. Вызывается при тапе на таблицу с предметами в окне перед локацией.
*'''item_review''' - заставляет экономикс показать окошко с информацией о предмете, который нашли после обыска локации. Вызывается при тапе на таблицу с предметами в окне после локации.
*'''completed_animation''' - состояние запускает анимацию полученной награды за прохождение локации после "окна после локации". Можно запускать из состояния закрытия окна после локации.
*'''unlock_item''' - передает состояние покупки предмета, необходимого для открытия локации. Как правило, предмет находится в окне перед локацией.
*'''unlock''' - передает состояние при котором происходит разлочка локации если текущий уровень на один ниже, чем необходимый для открытии локации или значение ''разница в уровнях'', позволяет разлочить локацию. Как правило кнопка для разблокирования локации размещается в окне перед локацией. Когда разница уровней достаточна, чтобы разлочить локацию машина локации переводится в состояние '''can_buy'''.
*'''completed_reward''' - вызывается объектом анимации награды после прохождения локации. Если объектов несколько (опыт, монеты, кристаллы), то вызывается только один раз одним из объектов.
*'''search_charger''' - производит поиск недостающего чарджера. Пока только по монстрам. Номер чарджера 0 или 1 - в парам.
*'''buy_charger''' - производит покупку недостающего чарджера (номер в параметре, -1 - купить все).
*'''update''' - обновить все локации на карте.
*'''level_up''' - проверяет получение нового уровня. Чтобы окно с получением нового уровня не открывалось самостоятельно, мы вызываем это состояние, когда нам удобно. Проверяется был ли получен новый уровень, если был, то вызывается окно с получением нового уровня.
*'''res1''' - Добавить ресурс 1 (значение в параметре).
*'''res2''' - Добавить ресурс 2 (значение в параметре).
*'''res1s''' - скорректировать статистику по ресурсу 1 (значение в параметре, когда, например, ресурс не заработан, а выигран в казино).
*'''res2s''' - скорректировать статистику по ресурсу 2 (значение в параметре, когда, например, ресурс не заработан, а выигран в казино).
*'''energy''' - Добавить энергию (значение в параметре).
*'''failed''' - текущая локация провалена (не дается опыта и прочих наград за прохождение локации). Требует параметра локации.
*'''item_effect''' - показать окошко предмета от таймэффекта. В param - номер эффекта.
*'''search_collection''' - проскроллить карту на локацию где можно найти коллекционный предмет. При этом машина локации (Объект на карте) будет переведена в состояние highlight, в котором локацию можно посветить или выделить ее каким-то образом.
*'''search_task''' - проскроллить карту на локацию где можно найти предмет из задания. При этом машина локации (Объект на карте) будет переведена в состояние highlight, в котором локацию можно посветить или выделить ее каким-то образом.
*'''search_charger''' - проскролить карту на монстр, в котором можно найти чарджер (необходимо значение чарджера в параметре 0 или 1).
*'''monster''' - Открыть превью для монстра с номером указанном в поле параметр.
*'''monster_play''' - Играть в миниигру выбранного монстра (при условии, что хватит энергии и выполнены прочие условия).
*'''monster_removed''' - Монстра прогнали предметами. Вычесть предметы и успешно завершить.
*'''monster_completed''' - Текущая миниигра так или иначе пройдена.
*'''monster_failed''' - Текущая миниигра провалена, отличается от предыдущего тем, что не дается бонусного опыта и прочих наград.
*'''monster_buy''' - попытаться докупить предметы, необходимые для игры с монстром.
*'''col_item_param''' - Добавить коллекционный предмет, взяв его айди из параметра.
*'''anomaly_item''' - попытаться прогнать аномалию в текущей локации предметом. В зависимости от номера аномалии, машина локации (Объект на карте) переводится в состояние anomaly_N, где N - номер аномалии начиная с 0. (anomaly_0, anomaly_1 и т.д.). Таким образом можно визуализировать аномалию на карте.
*'''anomaly_game''' - попытаться прогнать аномалию в текущей локации миниигрой.
*'''anomaly_completed''' - минигра по прогону аномалии успешно завершена.
*'''anomaly_buy''' - показать окно покупки для предмета прогона аномалии (в текущей локации).
*'''cheat_loc_level''' - "накачать" всем локациям скилл левел до максимума (для тестирования).
*'''chest_animation''' - анимировать последний использованный сундук.
*'''col_item_found''' - показать окошко с коллекцией для одного найденного коллекционного предмета из очереди.
*'''cheat_one_level''' - просимулировать один уровень развития игрока.
*'''purchase_ok''' - сообщает economocs что произошла покупка. Сформировать событие флури.
*'''buy_random_col''' - купить случайный коллекционный предмет.

=Сопутствующие объекты=

Объекты, которые используются вместе с объектом economics и имеют с ним непосредственную связь:

* [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря(магазина) и экономики.
* [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина.
* [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря.
* [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий.
* [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания.
* [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции.
* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер

Table

2014-03-14T15:01:00Z

Epahomov:

Esocial

2014-03-14T14:19:58Z

Epahomov:

2014-03-14T13:54:11Z

Epahomov:

Esocialfrienditem

2014-03-14T13:51:13Z

Epahomov:

Esocialfrienditem

2014-03-14T13:44:47Z

Epahomov: Новая страница: «Объект представляет собой шаблон ячейки списка друзей из Facebook =Параметры= [[Файл:14-03-2014 15...»

Объект представляет собой шаблон ячейки списка друзей из Facebook

=Параметры=

[[Файл:14-03-2014 15-05-54.png|right]]
*'''alpha''' - прозрачность: от 0(объект полностью прозрачен)до 1(объект непрозрачен)
*'''eitems''' - ссылка на объект eitems

*'''название''' - ссылка на текстовый объект, которому передается название предмета

*'''описание''' - ссылка на текстовый объект, которому передается описание предмета

*'''иконка''' - иконка самого предмета, передается экономикой самостоятельно

*'''кнопка использования''' - кнопка, по нажатию на которую осуществляется использование предмета. Передает объекту Einventoryitem состояние '''use'''
*'''счетчик''' - счетчик, отображает количество предметов.
*'''иконка цены''' - картинка, отображающая иконку предмета.
*'''цена''' - счетчик, который отображает непосредственно цену предмета.
*'''кнопка продать''' - кнопка по нажатию на которую, происходит продажа предмета. Передает объекту Einventoryitem состояние '''sell'''

Absolutist Framework

2014-03-14T13:40:10Z

Epahomov: /* Social */

{{TOC right}}

== Новости ==
Вышла новая игра HOG созданная с помощью AppSalute Game Сreator. Созданы новые уникальные эффекты и механики для обеспечения незабываемых впечатлений.
Описание и видео:
http://time-gap.com/

== AppSalute Game Сreator ==
* [[Примеры приложений]]
* [[Введение в AppSalute Game Сreator]]
* [[Установка и настройка]]
* [[Интерфейс ScenceEditor ]]
* [[Интерфейс ResourceEditor ]]
* [[Интерфейс TextEditor ]]
*[[Интерфейс Viewer ]]
* [[Книга жалоб и пожеланий]]
* [[Roadmap]]

== Обучение ==

* [[Learning|Уроки по освоению фреймворка]]
* [[Примеры реализации в играх]]
* [[Основные понятия объектов физического мира]]
* [[FAQ]]
== Подготовка проекта ==
* [[Проектирование экранов игры]]
* [[Подготовка и форматы графики]]
* [[Подготовка и форматы шрифтов]]
* [[Подготовка и форматы звуков]]
* [[Подготовка и форматы видео]]
* [[Создание проекта]]
* [[Загрузка проекта по частям]]
* [[Конфигурация проекта для сборки]]
* [[Подготовка для загрузки на маркеты]]
* [[Сборка проекта]]

== Встроенные объекты редактора==

=== Common objects ===

''[[Файл:Screen.png]] - [[Screen]]'' - экран

''[[Файл:Scene.png]] - [[Scene]]'' - сцена

=== Main objects ===

''[[Файл:Objects.png]] - [[Object]]'' - общие параметры для всех игровых объектов

* [[Файл:Picture.png]] - [[Image]] - картинка
* [[Файл:Button.png]] - [[Button]] - кнопка
* [[Файл:Text.png]] - [[Text]] - текст
* [[Файл:Machine.png]] - [[Machine]] - машина состояний
* [[Файл:Tableicon.png]] - [[Table]] - таблица
* [[Файл:Checkbox.png]] - [[Checkbox]] - чекбокс (кнопка в 2-х состояниях)
* [[Файл:Checkgroup.png]] - [[Groupbox]] - группа, содержащая несколько чекбоксов
* [[Файл:Timer.png]] - [[Timer]] - цифровой таймер
* [[Файл:Counter2.png]] - [[Counter]] - счетчик сделанных кликов в игре и т.п.
* [[Файл:Progressbar.png]] - [[Progress]] - прогресс прохождения игры (эчивмент)
* [[Файл:Particle.png]] - [[Flyer]] - флаер (патиклы)
* [[Файл:Rectangle.png]] - [[Rectangle]] - прямоугольник
* [[Файл:Kub.png]] - [[Isomover]] - объект движения в изометрической карте
* [[Файл:Group.png]] - [[Group]] - группа
* [[Файл:Groupse3.png‎]] - [[Groupset]] - группа
* [[Файл:Effect.jpg|20px]] - [[Effect]] - Создание различных эффектов
* [[Файл:kub.png]] - [[Graphprogress]] - создание мини-карты для отображения прогресса прохождения игры.

=== Game mechanic ===

* [[Файл:Puzzle.png]] - [[Puzzle]] - игра пазл
* [[Файл:Memory.png]] - [[Memory]] - класс игр с memory-механикой
* [[Файл:Patchwork.png]] - [[Patchwork]] - класс игр с Patchwork-механикой
* [[Файл:Match3.png]] - [[Match]] - класс match-подобных игр
* [[Файл:kub.png]] - [[Collapse]] - класс match-подобных игр
* [[Файл:kub.png]] - [[Bejewelled]] - класс match-подобных игр
* [[Файл:kub.png]] - [[Bubble Shooter]] - класс Bubble игр включая механику Снукер
* [[Файл:kub.png]] - [[Match Battle]] - настройка глобальных параметров для мини-игр
* [[Файл:Move box.png]] - [[DragBox]] - класс игр с dragbox-механикой
* [[Файл:Labyrinth.png]] - [[Labyrinth]] - класс игр лабиринт
* [[Файл:Pipes.png]] - [[Pipes]] - класс игр трубы
* [[Файл:Search object.png]] - [[HiddenObject]] - поисковый объект в хидден играх
* [[Файл:Object list.png]] - [[HiddenList]] - список поисковых объектов в хидден играх
* [[Файл:Hint.png]] - [[HiddenHint]] - подсказка (указатель на спрятанный объект)
* [[Файл:Collection.png]] - [[Collection]] - "коллекция" поисковых объектов для хидден игр
* [[Файл:Inventory.png]] - [[Invetory]] - "инвентарь" список применяемых объектов для игр
* [[Файл:Tool.png]] - [[Tool]] - "применение" - объект, который можно применить для игр
* [[Файл:Kub.png]] - [[Isomap]] - изометрическая карта
* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер
** [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря/магазина и экономики
** [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина
** [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря
** [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий
** [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания
** [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции
* [[Файл:Paint.png‎]] - [[Paint]] - объект для рисования
* [[Файл:Physicsworld.png]] - [[Physicsworld]] - физический мир Box2D
** [[Файл:Physicsobject.png]] - [[Physicsobject]] - физические объекты
** [[Файл:Physics links.png]] - [[Physicsjoint]] - физические соединения
* [[Файл:ttb24.png]] - [[TapTheBubble]] - механика игры Tap The Bubble

=== Global score ===
* [[Файл:Gamecenter.png]] - [[Gamecenter]] - объект для отправки данных на GameCenter iTunse
* [[Файл:Gamecircle.jpg]] - [[Amazon GameCircle]] - объект для отправки данных Amazon GameCircle
* [[Файл:Google-play-games-android.jpg‎]] - [[Google Play services]] - объект для отправки данных на Google Play services
* [[Файл:Localtoplist.png]] - [[Localtoplist]] - настройки для отображения результатов прохождения игры
* [[Файл:Globaltoplist.png]] - [[Globaltoplist]] - настройки для отображения результатов прохождения игры
* [[Файл:Globaltopsender.png]] - [[Globaltopsender]] - настройки для отображения результатов прохождения игры

=== Options ===
* [[Файл:Options.png]] - [[Options]] - общие настройки игры
* [[Файл:Gamedata.png]] - [[Gamedata]] -
* [[Файл:Editicon.png]] - [[Edit]] - ввод текста
* [[Файл:Store.png]] - [[Store]] - настройки InApp покупок в игре
* [[Файл:Notification.png]] - [[Notification]] - push-уведомления
* [[Файл:Imagepicker.png]] - [[Imagepiker]] - объект для загрузки фото из галереи
* [[Файл:Video.png]] - [[Video]] - объект для просмотра видео
* [[Файл:Webview.png]] - [[Webview]] - объект для просмотра интернет страниц в приложении
* [[Файл:Flurryobject.png]] - [[Flurry]] - настройки системы статистики для приложений https://dev.flurry.com
* [[Файл:Moregames.png]] - [[MoreGamesList]] - запрос банеров рекламируемых игр
* [[Файл:Kub.png]] - [[Advertisement]] - банерная система flurry, amazon
* [[Файл:Kub.png]] - [[splitmanager]] - менеджер сплитов
* [[Файл:Tapjoy.png]] - [[Tapjoy]] - система рекламы игр
* [[Файл:Playhaven.png|24px]] - [[Playhaven]] - система рекламы игр с внутренними up-sale
* [[Файл:Mobileapptracking.png|24px]] - [[Mobileapptracking]] -
* [[Файл:Chartboost-logo-new.jpeg]] - [[Chartboost]] - Chartboost-logo-new.jpeg

=== Social ===
* [[Файл:Facebook.png]] - [[Facebook]] - настройки расшаривания Facebook
** [[Файл:Facebook.png]] - [[Esocialitem]] - Шаблон для ячейки списка друзей
** [[Файл:Facebook.png]] - [[Esocial]] - объект для взаимодействия с Facebook'ом
* [[Файл:Twitter.png]] - [[Twitter]] - настройки расшаривания Twitter
* [[Файл:Odru.png]] - [[Odnoklassniki]] - настройки для социальной сети Одноклассники
* [[Файл:GooglePlus-Logo-02.png]] - [[GooglePlus]] - настройки для социальной сети GooglePlus

=== Functions ===
* [[Файл:Forward.png]] - [[SendMail]] - отправка письма через почтовый клиент
* [[Файл:footer-icon-rate.png]] - [[Rate]] - вызов окна оценки приложения
----
<gallery widths="50px" heights="50px" >
Изображение:Who.png
Изображение:AnimalHideSeek.png
Изображение:travel.png
Изображение:Game_Adventure_Train.png
Изображение:Gmae_Match_MoveTheDolly.png
Изображение:Game_Patchwork_BigEyes.png
Изображение:Game_Patchwork_Chameleon.png
Изображение:Game_Patchwork_Logicly.png‎
Изображение:Game_Patchwork_Stickers.png‎
Изображение:Elephant.png
Изображение:Elephant2.png
Изображение:Cinderella.png
Изображение:Pigs.png
Изображение:Bremenskye.png
Изображение:Book_SnowWhite.png
Изображение:Book_PussInBoots.png
Изображение:Call.png
Изображение:GreatestArtists.png
Изображение:Game_Puzzle_Kids.png
Изображение:Game_Puzzle_Architect.png‎
Изображение:Game_Puzzle_Science.png
Изображение:Ico_1_114_Full.png
Изображение:Game_Adventure_Dreams.png
Изображение:Abc.png
Изображение:Ico_114_Full.png
Изображение:Ico_114_Paints.png
Изображение:Ico_114_Puzzle.png
</gallery>

2014-02-04T12:48:07Z

Epahomov: /* Setup */

{{TOC right}}
Построение мини-карты для отображения прогресса в игре.
=Graphprogress Setup=
*'''Узел пройденный''' - Графический ресурс для ключевого узла, до которого мы добрались.
*'''Узел закрытый''' - Графический ресурс для закрытого узла.
*'''Шаг пройденный''' - Графический ресурс для промежуточного узла, который мы прошли.
*'''Шаг закрытый''' - Графический ресурс для закрытого промежуточного узла.
*'''Цифры''' - Графический ресурс для отображения цифр (анимированный клип состояший из 10-и фреймов: первый фрейм - 0, последний - 9). Перетаскивается из редактора ресурсов.
*'''Указатель''' - Объект указатель прогресса. ДОЛЖЕН быть дочерним объектом graphprogress'a.
*'''Поле в опциях(узлы)''' - Поле в опциях откуда будет взято значение прогрессбара.
*'''Поле в опциях(шаги)''' - Поле в опциях откуда будет взято значение прогрессбара.
*'''Поле в опциях(указатель)''' - Поле в опциях откуда будет взято текущее местоположение объекта-указателя.
*'''Поля по краям ребра''' - Если 1 - длина всего ребра, то это поле - его доля которую мы отступим от краев перед генерацией промежуточных узлов.
*'''Смещение цифр''' - Смещение цифр относительно центра узла. Данное поле необходимо в виду отсутствия возможности задавать/изменять точку пивота для каждого из фреймов анимации.
*'''Isomap setup''' - Настройки Isomap.
===Клик на нод===
*'''Объект''' - Объект, состояние которого нужно изменить.
*'''Состояние''' - Новое состояние объекта.
==Setup==
[[Файл:03-02-2014 11-37-05.png]]
[[Файл:04-02-2014 14-46-28.png|right|250px|thumb]]
*'''Добавить''' - Добавить ключевой узел.
*'''Выбрать''' - Выбрать ключевой узел.
*'''_____''' - Поле ввода имени для выбранного ключевого узла.
*'''(x,y)''' - Координаты выбранного ключевого узла.
*'''Удалить''' - Удалить выбранный ключевой узел.
*'''Delete all nodes''' - Удалить все ключевые узлы.
*'''Добавить''' - Добавить ребро для выбранных ключевых узлов.
*'''Выбрать''' - Выбрать ребро.
*'''__''' - Задать тип ребра(на данный момент в этом объекте не используется).
*'''__''' - Задать вес ребра(подразумевается количество промежуточных узлов для данного ребра).
*'''Удалить''' - Удалить выбранное ребро.
*'''Delete all edges''' - Удалить все ребра.
*'''__''' - Выбрать промежуточный узел для текущего ребра.
*'''(x,y)''' - Координаты выбранного промежуточного узла.
*'''Insert before''' - Добавить промежуточный узел перед выбранным на текущем ребре.
*'''Insert after''' - Добавить промежуточный узел после выбранного на текущем ребре.
*'''__''' - Удалить промежуточный узел.
*'''Save graph''' - Сохранить текущие изменения и выйти.
*'''Exit without saving''' - Выйти из редактирования графа без сохранения текущих изменений.

=Состояния=
*'''value''' - Состояние в котором происходит отрисовка графпрогресса
*'''value_animation''' - Состояние в котором происходит отрисовка графпрогресса и происходит анимация передвижения указателя по заданному сплайну.
=Пример=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip