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

Machine

2013-12-20T07:49:39Z

Podkor: /* init */

{{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''' - координата точки пивота относительно сцены или родительского объекта;
* '''sx''','''sy''' - масштаб машины по осям (если 1, то это исходный размер; 0.5 - в два раза меньше);
* '''ang''' - угол поворота в градусах; отчитывается вниз от оси x, или вверх, если отрицательный;
* '''v''' - скорость для команды move
* '''vr''' - угловая скорость для команды rot
* '''vx''','''vy''' - начальная скорость для команды phys
* '''ax''','''ay''' - ускорение для команды phys
* '''z координата''' - координата машины по z.
* '''z приращение''' - приращение координаты машины по z относительно текущего
* '''vis''' - видимость - видимость машины (1 - видима, 0 - невидима)
* '''показать рейтинг''' - значение 1 означает, что при выполнении этого инита будет показано окно iOS рейтинга
Если на девайсе была нажата кнопка "отрейтинговать", то в опции запишется параметр rating значение 1, если нажата кнопка "позже" - rating 2, "никогда" - rating 3
* '''закрыть приложение''' - значение 1 означает, что при выполнении этого инита приложение будет закрыто
* '''перезагрузить лэйаут''' - значение 1 означает, что при выполнении этого инита будет перезагружен лэйаут
* '''вернуться назад''' - начение 1 означает, что при выполнении этого инита произойдет возврат на предыдущий экран
* '''реклама AdMob''' - 1 - показать, 0 - спрятать, -1 - не изменять состояние
* '''прокликиваемая''' - если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то клик обрабатывается, но передается дальше
* '''курсор''' - меняет текущий курсор мыши на указанный графический ресурс. Перетягивается из редактора ресурсов, поле должно быть в состоянии редактирования.
* '''if''' - номер (начиная с нуля) команды [[#if|if]] для условия выполнения; можно использовать логические операторы (см. [[#if|if]]);
* '''break''' - прервать команды.

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

=== set ===

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

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_param''' - глобальный либо текущий экран, параметры которого меняем
* '''scr_state''' - экран, состояние которого меняем
* '''parent''' - Объект, который будет установлен в качестве родителя объекту из obj. Объект obj будет оторван от текущего своего родителя и добавлен в детей объекта parent
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''val_res''' - Новое значение графического ресурса (перетаскивается из редактора ресурсов). (пока не работает)
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''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''' - аргумент функции

Обозначенная переменная существует (может использоваться) только в текущем состоянии. Переменная может определятся в одном состоянии только один раз. Если созданной переменной нужно изменить значение в рамках состояния, это можно сделать через другую переменную или через параметр опций ([[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''' - целевые координаты в пикселях, к которым должен переместиться объект;
* '''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;
* '''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]]'''
 
 
 

=== 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. Созданые сцены можно удалить :)

== Random ==
На момент, когда пишется данная статья, понятие вероятности существует только в команде wait и в текстовом поле(объект [[Text]]) можно показать случайный текст. Однако, и текущей функциональности достаточно, чтобы сделать генератор случайных чисел:
[[Файл:Random.jpg]]
Или в виде xml:
<nowiki>
<obj type="machine" id="<Вставьте сюда ваш идентификатор объекта>" nm="random" sync="1" x="800" y="1200" w="1" h="1" al="0" trace="1">

<st id="init">

<set obj="369" par="random.val" val="0" user="1"/>

<set obj="369" par="random.precision" val="0.01" user="1"/>

<set obj="369" par="random.add" val="1" user="1"/>

<set obj="369" st="save"/>

</st>

<st id="count">

<set obj="369" par="random.val" val="0" user="1"/>

<set obj="369" par="random.add" val="1" user="1"/>

<set obj="369" st="save"/>

<wait go="iterate"/>

</st>

<st id="iterate">

<var nm="add" obj="369" par="random.add" user="1"/>

<set obj="369" par="random.add" val="((add)/2)" user="1"/>

<wait if="0" go="complete"/>

<wait p="0.5" go="add"/>

<wait go="iterate"/>

<if obj="369" par="random.precision" op=">" val="(add)"/>

</st>

<st id="add">

<var nm="add" obj="369" par="random.add" user="1"/>

<var nm="val" obj="369" par="random.val" user="1"/>

<set obj="369" par="random.val" val="(add+val)" user="1"/>

<wait go="iterate"/>

</st>

<st id="complete">

<set obj="369" st="save"/>

</st>

</obj>
</nowiki>

прим. Объект с id="369" - объект типа [[Options]]

=== Краткое описание алгоритма ===
1. Задаются точность и обнуляется значение(val)

2. Устанавливается добавляемое значение (add)

3. add делится на двое. Если срабатывает wait - add добавляется к val. Если add становится меньше допустимой точности - переходим к п. 4. Если не один из переходов не сработал - повторяем п. 3.

4. Окончание работы объекта, сохранение опций

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

1. Задаём переменной Options->random.precision необходимую точность (обычно 0.01 для игровых проектов достаточно)

2. Переводим объект random в состояние count

3. Ждём определённое время (200 милисекунд, в принципе достаточно, если не успеете - получите результат с меньшей точностью), либо, если уж боитесь - в цикле(переходя wait-ами между 2-мя состояниями) проверяйте перешёл ли random в состояние complete

4. Результат вычислений заносится в переменную Options->random.val . val принимает значение от 0 до 1 (не включая 1)

=== Какие могут возникнуть проблемы ===

1. Если 2 объекта захотят одновременно вызвать random. Решение проблемы: Создать 2 объекта random. И ещё, обязательно переименовать в каждом объекте группу параметров, в который параметры будут заноситься (Например: random1.val, random2.val).

2. Не следует сохранять в Options промежуточные вычисления, т. к. это очень существенно замедлит вычисления

3. Если машина невидима(vis = 0), то она остаётся функционировать, но частично:

Предположим, что есть машина А, у которой перед загрузкой экрана vis=0, в ней в состоянии по-умолчанию есть движение, init и несколько set-ов на другие объекты. При загрузке экрана выполнятся set-ы, init, но объект двигаться как указано не будет.

Если необходимо чтобы объект двигался невидимым - следует использовать изменение прозрачности машины, или init для перемещения.

== Random 2 ==
Улучшенный вариант предыдущего генератора случайных чисел ([[Random]]).
Суть состоит в том, что объект записывает переменные внутрь себя, минуя запись объект [Options].
[[Файл:Random2.jpg]]

Исходный xml-код имеет вид:

<pre>
<obj id="4759" type="machine" nm="random_new" sync="1" x="800" y="1200" w="1" h="1" al="0" trace="1">
<st id="init">
<set obj="4759" par="val" val="0"/>
<set obj="4759" par="precision" val="0.01"/>
<set obj="4759" par="add" val="1"/>
</st>
<st id="count">
<set obj="4759" par="val" val="0"/>
<set obj="4759" par="add" val="1"/>
<wait go="iterate"/>
</st>
<st id="iterate">
<var nm="add" obj="4759" par="add"/>
<set obj="4759" par="add" val="((add)/2)"/>
<wait if="0" go="complete"/>
<wait p="0.5" go="add"/>
<wait go="iterate"/>
<if obj="4759" par="precision" op=">" val="(add)"/>
</st>
<st id="add">
<var nm="add" obj="4759" par="add"/>
<var nm="val" obj="4759" par="val"/>
<set obj="4759" par="val" val="(add+val)"/>
<wait go="iterate"/>
</st>
<st id="complete"/>
</obj>
</pre>

=== Краткое описание алгоритма ===
См. объект [[Random]]

=== Как пользоваться? ===
См. объект [[Random]]

=== Достоинства и недостатки ===
Достоинства: можно создавать несколько копий, при этом не нужно лезть внутрь объекта (если хотите иметь несколько генераторов в одном экране, скопируйте генератор в другой экран, а потом перенесите обратно - ссылка внутри объекта на самого себя сохранится).

Недостатки: Как и в случае с объектом Random, нужно выдержать время, чтобы генератор сработал. Таким образом, к генератору может безопасно обращаться только 1 объект.

== Random-псевдо ==
Генератор псевдослучайных чисел. Быстрый генератор, по сравнению с [[Random2]].
Суть состоит в том, что последовательность случайных чисел задаётся по формуле:

Хорошее среднее значение (0.47) даёт формула:
A=10000*i*/(i+1)
Даллее, от числа А оставляется только дробная часть.

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

Исходный xml-код имеет вид:

<pre>
<obj id="4908" type="machine" nm="random_pseudo" sync="1" x="800" y="800" w="100" h="100" trace="1">
<st id="init">
<set obj="4908" par="index" val="101"/>
<set obj="4908" par="val" val="0"/>
</st>
<st id="count">
<var nm="a1" obj="4908" par="index"/>
<var nm="a" obj="4908" par="a"/>
<var nm="ar" obj="4908" par="a_round"/>
<set obj="4908" par="a" val="(((a1)/(a1+1))*10000)"/>
<set obj="4908" par="a_round" val="(a)" round="1"/>
<set obj="4908" par="val" val="(a-ar)"/>
<set obj="4908" par="index" val="(a1+1)" if="(!0)"/>
<set obj="4908" par="index" val="101" if="0"/>
<if obj="4908" par="index" op=">" val="201"/>
</st>
</obj>
</pre>

=== Краткое описание алгоритма ===
1. Устанавливается начальное значение индекса index=101 (экспериментальное)

2. Подсчитывается значение а= index*10000/(index+1)

3. Отбрасывается целая часть а

4. Запись результата во внутренню переменную val

5. Если индекс стал больше 200- ставим его снова 101.

=== Как пользоваться? ===
1. Переводим объект random_pseudo в состояние count
2. Считываем результат из переменной val

=== Какие могут возникнуть проблемы? ===
Проблема, собственно, только одна - бедность данного генератора, т. к. он имеет всего 100 различных значений. Однако, для производства игр, такого количества вполне достаточно.

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

Недостатки: (они уже описаны выше) малое количество выдаваемых значений, цикличность последовательности.

== 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]

Button

2013-12-20T07:48:29Z

Podkor: /* Дополнительные параметры */

{{TOC right}}
'''Общие параметры'''
(см. описание [[Object|Object]])

*'''[[прокликиваемая]]''' - Если 1, то кнопка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то кнопка сама обрабатывает клик, но и пропускает его дальше
*'''память''' - Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)

== Основные параметры ==
'''Группа - внешний вид'''
[[Файл:But.png|250px|right]]

*'''up''' - Графический ресурс для отображения отжатой кнопки.
*'''down''' - Графический ресурс для отображения нажатой кнопки. Может отсутствовать.
*'''over''' - Графический ресурс для отображения кнопки с мышкой над ней. Может отсутствовать.
*'''disable''' - Графический ресурс для отображения неактивной кнопки. Может отсутствовать.
*'''накладывать''' - Если "1", то графика из параметра '''down''' будет накладываться на графику из параметра '''up''' при нажатии на кнопу, если "0", то не накладывается.
*'''down scale''' - Изменяет размеры графического ресурса для отображения нажатой кнопки. Может отсутствовать.
*'''over scale''' - Изменяет размеры графического ресурса для отображения кнопки с мышкой над ней. Может отсутствовать.

'''Группа - звуки'''

*'''up''' - Звуковой ресурс для проигрывания отжатой кнопки. Может отсутствовать.
*'''down''' - Звуковой ресурс для проигрывания нажатой кнопки. Может отсутствовать.
*'''over''' - Звуковой ресурс для проигрывания кнопки с мышкой над ней. Может отсутствовать.

'''Группа - время'''

*'''невидимости''' - Время невидимости перед открытием.
*'''открытия''' - Время проявления кнопки от полной прозрачности к прозрачности, заданной в модификаторах.
*'''закрытия''' - Время исчезания кнопки до полной прозрачности.

'''надпись ID''' - Надпись на кнопке, перетаскивается из редактора строк.

'''надпись''' - Надпись на кнопке. Используется только, если нет графики.

'''Группа - [[шрифт]]'''

*'''имя''' - Номер шрифта - целое число, начиная с 0 (порядковый номер шрифта).
*'''размер''' - Размер шрифта в пикселях.

== Дополнительные параметры ==

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

'''Группа - [[позиционирование]]'''
*'''горизонтальное''' - 0 - нет выравнивания; 1 - прижать к левому краю; 2 - центр; 3 - к правому
*'''вертикальное''' - 0 - нет выравнивания; 1 - прижать к верхнему краю; 2 - центр; 3 - к нижнему

== Добавляемые параметры ==

[[Файл:Menadd.png|300px|right]]
Меню выбора ''Добавляемые параметры'' к объектам активируется по правой кнопки мыши.

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

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

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

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

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

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

[[Файл:+.png]] '''изменить id экрана объекта''' - При клике на кнопку меняет id экрана на выбранный у другого объекта(на пример можно использовать для изменения id экрана для перехода у кнопки).
*'''объект''' - Объект у которого меняется id экрана.
*'''свойство''' - Свойство, в которое записывается новый id экрана.
*'''значение''' - Экран, id которого будет записан.

[[Файл:+.png]] '''совершить in-app покупку''' - При клике на кнопку открывается системное окно с предложением совершить in-app покупку.
*'''id покупки''' - Внутренний id покупки для приложения, указывается в объекте store
*'''объект(успех)''' - Объект, которому сообщается об удачной покупке
*'''состояние(успех)''' - Состояние в которое переводится выбранный объект в случае успешной покупки
*'''объект(провал)''' - Объект, которому сообщается о неудачной покупке
*'''состояние(провал)''' - Состояние в которое переводится объект в случае неудачной покупки

[[Файл:+.png]] '''скачать загружаемый контент''' - При клике на кнопку будет совершена попытка скачать контент.
*'''url''' - Ссылка на zip архив с контентом в интернете.
*'''объект (успех)''' - Этому объекту будет сообщено об успехе закачки.
*'''состояние (успех)''' - Это состояние будет установлено объекту при успешной закачке.
*'''объект (провал)''' - Этому объекту будет сообщено о неудаче закачки.
*'''состояние (провал)''' - Это состояние будет установлено объекту при ошибке/отмене закачки.
*'''счетчик прогресса''' - Объект типа счетчик, который будет отображать прогресс загрузки. Крайне желательно, чтобы он имел диапазон 0..100.

[[Файл:+.png]] '''открыть внешнюю ссылку''' - При клике на кнопку открыть ссылку в браузере.
*'''id cсылки''' - Если в опциях не будет найдено ссылки, то сам айдишник будет интерпретироваться как ссылка.
*'''id cсылки (iOS)''' - Если задано, то на iOS устройствах будет использоваться ВМЕСТО основного линка. Ссылка которая открывается на iOS устройствах(может быть в виде itms://.. itms-apps://.. http://...).
*'''id cсылки (Android)''' - Если задано, то на Android устройствах будет использоваться ВМЕСТО основного линка.
*'''id cсылки (текстовая база)''' - Если задано, то будет использоваться ссылка из записи текстовой базы(перетаскивается запись из текстовой базы) ВМЕСТО основного линка. Какая ссылка будет использоваться задаётся при сборке.

==Примечания и дополнения==

'''Важно помнить:'''

*Кнопка реагирует только на отпускание. (В отличии от машины, которая может реагировать как на нажатие, команда click, так и на отпускание, команда touch_up.) 
Часто для простых похожих действий используют как кнопки, так и машины. Важно учитывать, на каком этапе тапа они срабатывают (нажатие, удерживание, отпускание) потому, что игрок может очень длительное время удерживать палец на экране. 
Можно сделать так, что один тап будет приводить в действие два объекта. Например, тапнуть на машину, которая реагирует на нажатие, а затем перетащить палец на кнопку (или поместить кнопку поверх машины) и отпустить. В таком случае на один тап откликнется и машина, и кнопка.

*Следует аккуратно использовать кнопки, если у них или их родителей прокликиваемость = 2. В таком случае, если кнопку двигать (например, анимация колыхания), то она потеряет фокус и не будет реагировать на тап.

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

2013-12-09T15:04:15Z

Podkor:

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

: В объекте checkbox есть у параметра '''надпись''' свойство '''цвет''', который можно задать с помощью буквенных и цифровых значений. Но какую бы комбинацию не задавал, всегда цвет текста черный.--[[Участник:Lkunica|Lkunica]] 08:27, 23 октября 2013 (CEST)

: Есть возможность выделять группу объектов, чтобы задать сразу всем какое-то свойство.1.Пусть нужно задать прокликивание. Поменяется это свойство на заданное, если предварительно у всех выделенных объектов значение этого свойства было одинаковое.2.Хотелось бы сразу задавать нескольким текстовых объектам шрифт, его размер, и цвет. Пока такой возможности нет.

:При экспорте сцены с объектом groupset теряются добавленные в его группу объекты (точнее заменяются другими объектами сцены), и приходится заново их переподключать. При экспорте экрана все нормально.--[[Участник:Lkunica|Lkunica]] 08:27, 23 октября 2013 (CEST)

:Нельзя удалить графический ресурс в команде draw в машине состояний. Иногда это актуально,когда нужно заменить этот графический ресурс другим с таким же именем - не видно произошла замена или нет.--[[Участник:Lkunica|Lkunica]] 08:27, 23 октября 2013 (CEST)

:Есть возможность выделять группу объектов, что бы задать им какое-то свойство. Но такое свойство как, например, "текстID" в "hiddenObject", по умолчанию при коллективном выделении не отображается. Его, конечно, можно добавить с помощью Сережи Шейко, но было бы удобнее добавлять и удалять нужные свойства более рациональным способом, появилось бы больше места для маневра.--[[Участник:Podkor|Podkor]] 16:17, 28 октября 2013 (CET)

:В машине для каждой команды состояний предусмотрен параметр loop, который позволяет начать выполнение команд, начиная с первой. Но иногда есть необходимость начать выполнение команд (зацикливание), с некоторой отличной от первой. Было бы удобно, если бы в разделе "переходы и параметры выполнения" также присутсвовала каманда, для которой этот раздел активируется. Пока там присутсвуют все другие команды, кроме ее самой.--[[Участник:Lkunica|Lkunica]] 07:50, 8 ноября 2013 (CET)

:В состоянии машины, добавляемые свойства, просто необходимо разместить в алфавитном порядке

[[Файл:Property.jpg|250px|right]]--[[Участник:Podkor|Podkor]] 16:04, 9 декабря 2013 (CET)

Файл:Property.jpg

2013-12-09T15:01:42Z

Podkor:

Isomap

2013-11-26T14:38:55Z

2013-11-25T09:04:22Z

Podkor: Новая страница: «= Isomap = ''Isomap'' - объект с помощью которого, появилась возможность создать траекторию движе...»

= Isomap =
''Isomap'' - объект с помощью которого, появилась возможность создать траекторию движения для объекта типа ''isomover''. Например, можно создать движение машинки на карте.

Economics

2013-11-15T13:35:16Z

Podkor: /* Состояния */

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

= Свойства =

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

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

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

===Основные счетчики===
Этот раздел содержит необходимые объекты для подсчета (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]] - глобальная настройка игр типа ферма\билдер

Economics

2013-11-15T13:34:06Z

Podkor: /* Состояния */

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

= Свойства =

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

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

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

===Основные счетчики===
Этот раздел содержит необходимые объекты для подсчета (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 что произошла покупка. Сформировать событие флури.

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

Объекты, которые используются вместе с объектом 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]] - глобальная настройка игр типа ферма\билдер

Интерфейс TextEditor

2013-10-29T09:57:29Z

Podkor: /* Кнопки быстрого запуска */

{{TOC right}}
== [[Файл:Ico_text.png]]Редактор текстов ==

[[Файл:Ico_text.png|40px]] '''Text Editor''' - хранилище всех текстовых ресурсов (надписей) на различных языках. Аналогично графике и звукам при помощи мышки они перетаскиваются в соответствующие свойства объектов, находящихся в Scene Editor. 
Окно редактора имеет следующий вид:
[[Файл:Головна4.PNG|550px|right]]

===Общие свойства и действия с текстом===

'''После любых действий в текстовом редакторе необходимо обновить текстовую базу в Редакторе сцен!'''
*элемент текстовой базы - строка текста, которая может хранить в себе несколько различных фраз,записанных в разные поля
*фраза персонажа на разных языках записывается в один элемент текстовой базы
*в текстовой базе может храниться voice
*элемент текстовой базы может хранить в себе несколько иконок, для которых можно выбрать одну из 4-х категорий (mainPicture, icon1, icon2,icon3)
*каждому элементу текстовой базы присваивается уникальный номер.
*при добавлении элемента - присваивается следующий по порядку уникальный номер
*при экспорте экранов в текущий проект элементы текстовой базы добавляются автоматически в базу текущего проекта и присваиваются им следующие по порядку уникальные номера
*может существовать несколько элементов с одинаковыми именами
*текст может быть автоматически добавлен в текущий проект или добавлен из другой текстовой базы
*элемент текстовой базы может быть удален, модифицирован, категоризирован

=== Кнопки быстрого запуска ===
Вверху окна приложения расположены кнопки общего меню:
*[[Файл:00 6.png]] — команда создать Новый файл;
*[[Файл:00 7.png]] — команда открыть уже созданный проект;
*[[Файл:00 8.png]] — сохранить изменения в файле;
*[[Файл:00 18.png]] — создать новую папку в корневой базе;
*[[Файл:New record.jpg]] — добавить новую текстовую запись;
*[[Файл:Add new rec fr.jpg]] — добавить новую текстовую запись из базы ресурсов;
*[[Файл:Add url.jpg]] — добавить новую url запись;
*[[Файл:00 19.png]] — удалить текстовую запись.

=== Меню редактора ===
1. Если нажать в меню кнопку '''File''', выпадет список команд, с помощью которых можно создать новый или загрузить уже созданный файл, сохранить файл с указанием места сохранения и т.д. 
2.Для импорта фраз на другом языке необходимо воспользоваться Функцией Ипортировать меню File и выбрать .xml-файл с текстом и выбрать язык 
3. Если нажать в меню кнопку '''Resource''', выпадет список команд: 
* Open Resource - позволяет создать базу по ранее подготовленной графической базе ресурсов с точным совпадением структуры и названием папок и файлов. Используется для Hidden Objects;
* Choose Resource File - позволяет подгрузить базу графических ресурсов для перетаскивания изображений из ResourcesEditor на иконку;
* Choose Categories Config - помогает классифицировать текстовые файлы по категориям.
[[Файл:00_51.PNG]] [[Файл:00_52.PNG]]

=== Создание и заполнение текстовой базы проекта ===
Текстовая база не создается автоматически при создании проекта. 
Для создания и заполнения текстовой базы: 
1. Заходите в пункт меню '''file -> New'''. Появляется пустая база ресурсов, по умолчанию названная '''Untitled'''. 
2. Слева в дереве текстовых объектов кликаем правой кнопкой мыши и выбираем '''Add record'''. Каждый раз при добавлении новой текстовой записи редактор просит нас написать ее имя. Это имя можно будет изменить в любой момент. Запишем имя '''arrow_If_down'''. 
3. Выделить запись и в окне приложения TextEditor справа в столбце Word запишем слово, в столбце Sentence1,Sentence2 - указать подсказку для текстовой записи, в столбце voice - подключить звуковой файл для текстовой записи из ResourcesEditor. 
[[Файл:00_54.PNG]]

'''Необходимо обязательно сохранять любые изменения с текстом в редакторе TextEditor.''' 
Для вызова текстового редактора можно воспользоваться меню '''Tools -> Text Editor''', либо кнопкой быстрого запуска [[Файл:011.JPG]].

'''Замечание.''' Букву Ё заменяем на Е

=== Слияние нескольких текстовых баз ===

Используется для слияния нескольких тектовых баз одного проекта выполненых для разных локализаций.

Импорт текстовой базы

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

=== Добавление иконок в текстовый элемент ===

Необходимость добавления изображения в текстовый элемент, может возникнуть, например, при формировании элементов hiddenObject, или при работе с элементами economics.
Изображение перетаскивается в текстовый элемент из редактора ресурсов мышкой. Но, в случае необходимости создать множество элементов за один раз, есть более эффективный способ:
*На панели с кнопками быстрого запуска нажимаем ''Add new text records from resource...''.
[[Файл:Add new rec from.jpg|300px|]]
*Открылось окошко ''choose resource file'' в нем следует выбрать необходимый sirx файл.
[[Файл:Choose resource file.jpg]]
*В открывшемся дереве ресурсов выбираем нужную папку
[[Файл:Tree resources.jpg|400px|]]
*Из этой папки все файлы, не содержащие в названии символ "+", преобразуются в текстовые элементы содержащие строку ''word'' и соответствующее изображение и добавятся в редактор ресурсов в папку которая создастся в соответствии с папкой содержащей эти иконки в редакторе ресурсов.

Файл:New record.jpg

2013-10-29T09:57:19Z

Podkor: загружена новая версия «Файл:New record.jpg»

Файл:Add new rec fr.jpg

2013-10-29T09:56:15Z

Podkor: загружена новая версия «Файл:Add new rec fr.jpg»

Файл:Add url.jpg

2013-10-29T09:55:14Z

Podkor: загружена новая версия «Файл:Add url.jpg»

Файл:Add url.jpg

2013-10-29T09:52:32Z

Podkor:

Файл:Add new rec fr.jpg

2013-10-29T09:50:15Z

Podkor:

Файл:New record.jpg

2013-10-29T09:48:25Z

Podkor:

Интерфейс TextEditor

2013-10-29T09:46:04Z

Podkor: /* Слияние нескольких текстовых баз */

{{TOC right}}
== [[Файл:Ico_text.png]]Редактор текстов ==

[[Файл:Ico_text.png|40px]] '''Text Editor''' - хранилище всех текстовых ресурсов (надписей) на различных языках. Аналогично графике и звукам при помощи мышки они перетаскиваются в соответствующие свойства объектов, находящихся в Scene Editor. 
Окно редактора имеет следующий вид:
[[Файл:Головна4.PNG|550px|right]]

===Общие свойства и действия с текстом===

'''После любых действий в текстовом редакторе необходимо обновить текстовую базу в Редакторе сцен!'''
*элемент текстовой базы - строка текста, которая может хранить в себе несколько различных фраз,записанных в разные поля
*фраза персонажа на разных языках записывается в один элемент текстовой базы
*в текстовой базе может храниться voice
*элемент текстовой базы может хранить в себе несколько иконок, для которых можно выбрать одну из 4-х категорий (mainPicture, icon1, icon2,icon3)
*каждому элементу текстовой базы присваивается уникальный номер.
*при добавлении элемента - присваивается следующий по порядку уникальный номер
*при экспорте экранов в текущий проект элементы текстовой базы добавляются автоматически в базу текущего проекта и присваиваются им следующие по порядку уникальные номера
*может существовать несколько элементов с одинаковыми именами
*текст может быть автоматически добавлен в текущий проект или добавлен из другой текстовой базы
*элемент текстовой базы может быть удален, модифицирован, категоризирован

=== Кнопки быстрого запуска ===
Вверху окна приложения расположены кнопки общего меню:
*[[Файл:00 6.png]] — команда создать Новый файл;
*[[Файл:00 7.png]] — команда открыть уже созданный проект;
*[[Файл:00 8.png]] — сохранить изменения в файле;
*[[Файл:00 18.png]] — создать новую папку в корневой базе;
*[[Файл:00_53.PNG]] — добавить новую текстовую запись;
*[[Файл:00 19.png]] — удалить текстовую запись.

=== Меню редактора ===
1. Если нажать в меню кнопку '''File''', выпадет список команд, с помощью которых можно создать новый или загрузить уже созданный файл, сохранить файл с указанием места сохранения и т.д. 
2.Для импорта фраз на другом языке необходимо воспользоваться Функцией Ипортировать меню File и выбрать .xml-файл с текстом и выбрать язык 
3. Если нажать в меню кнопку '''Resource''', выпадет список команд: 
* Open Resource - позволяет создать базу по ранее подготовленной графической базе ресурсов с точным совпадением структуры и названием папок и файлов. Используется для Hidden Objects;
* Choose Resource File - позволяет подгрузить базу графических ресурсов для перетаскивания изображений из ResourcesEditor на иконку;
* Choose Categories Config - помогает классифицировать текстовые файлы по категориям.
[[Файл:00_51.PNG]] [[Файл:00_52.PNG]]

=== Создание и заполнение текстовой базы проекта ===
Текстовая база не создается автоматически при создании проекта. 
Для создания и заполнения текстовой базы: 
1. Заходите в пункт меню '''file -> New'''. Появляется пустая база ресурсов, по умолчанию названная '''Untitled'''. 
2. Слева в дереве текстовых объектов кликаем правой кнопкой мыши и выбираем '''Add record'''. Каждый раз при добавлении новой текстовой записи редактор просит нас написать ее имя. Это имя можно будет изменить в любой момент. Запишем имя '''arrow_If_down'''. 
3. Выделить запись и в окне приложения TextEditor справа в столбце Word запишем слово, в столбце Sentence1,Sentence2 - указать подсказку для текстовой записи, в столбце voice - подключить звуковой файл для текстовой записи из ResourcesEditor. 
[[Файл:00_54.PNG]]

'''Необходимо обязательно сохранять любые изменения с текстом в редакторе TextEditor.''' 
Для вызова текстового редактора можно воспользоваться меню '''Tools -> Text Editor''', либо кнопкой быстрого запуска [[Файл:011.JPG]].

'''Замечание.''' Букву Ё заменяем на Е

=== Слияние нескольких текстовых баз ===

Используется для слияния нескольких тектовых баз одного проекта выполненых для разных локализаций.

Импорт текстовой базы

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

=== Добавление иконок в текстовый элемент ===

Необходимость добавления изображения в текстовый элемент, может возникнуть, например, при формировании элементов hiddenObject, или при работе с элементами economics.
Изображение перетаскивается в текстовый элемент из редактора ресурсов мышкой. Но, в случае необходимости создать множество элементов за один раз, есть более эффективный способ:
*На панели с кнопками быстрого запуска нажимаем ''Add new text records from resource...''.
[[Файл:Add new rec from.jpg|300px|]]
*Открылось окошко ''choose resource file'' в нем следует выбрать необходимый sirx файл.
[[Файл:Choose resource file.jpg]]
*В открывшемся дереве ресурсов выбираем нужную папку
[[Файл:Tree resources.jpg|400px|]]
*Из этой папки все файлы, не содержащие в названии символ "+", преобразуются в текстовые элементы содержащие строку ''word'' и соответствующее изображение и добавятся в редактор ресурсов в папку которая создастся в соответствии с папкой содержащей эти иконки в редакторе ресурсов.

Файл:Add new rec from.jpg

2013-10-29T09:40:03Z

Podkor: загружена новая версия «Файл:Add new rec from.jpg»

Файл:Tree resources.jpg

2013-10-29T09:38:14Z

Podkor:

Файл:Choose resource file.jpg

2013-10-29T09:37:25Z

Podkor:

Файл:Add new rec from.jpg

2013-10-29T09:36:00Z

Podkor:

Интерфейс TextEditor

2013-10-29T07:36:11Z

Podkor: /* Общие свойства и действия с текстом */

{{TOC right}}
== [[Файл:Ico_text.png]]Редактор текстов ==

[[Файл:Ico_text.png|40px]] '''Text Editor''' - хранилище всех текстовых ресурсов (надписей) на различных языках. Аналогично графике и звукам при помощи мышки они перетаскиваются в соответствующие свойства объектов, находящихся в Scene Editor. 
Окно редактора имеет следующий вид:
[[Файл:Головна4.PNG|550px|right]]

===Общие свойства и действия с текстом===

'''После любых действий в текстовом редакторе необходимо обновить текстовую базу в Редакторе сцен!'''
*элемент текстовой базы - строка текста, которая может хранить в себе несколько различных фраз,записанных в разные поля
*фраза персонажа на разных языках записывается в один элемент текстовой базы
*в текстовой базе может храниться voice
*элемент текстовой базы может хранить в себе несколько иконок, для которых можно выбрать одну из 4-х категорий (mainPicture, icon1, icon2,icon3)
*каждому элементу текстовой базы присваивается уникальный номер.
*при добавлении элемента - присваивается следующий по порядку уникальный номер
*при экспорте экранов в текущий проект элементы текстовой базы добавляются автоматически в базу текущего проекта и присваиваются им следующие по порядку уникальные номера
*может существовать несколько элементов с одинаковыми именами
*текст может быть автоматически добавлен в текущий проект или добавлен из другой текстовой базы
*элемент текстовой базы может быть удален, модифицирован, категоризирован

=== Кнопки быстрого запуска ===
Вверху окна приложения расположены кнопки общего меню:
*[[Файл:00 6.png]] — команда создать Новый файл;
*[[Файл:00 7.png]] — команда открыть уже созданный проект;
*[[Файл:00 8.png]] — сохранить изменения в файле;
*[[Файл:00 18.png]] — создать новую папку в корневой базе;
*[[Файл:00_53.PNG]] — добавить новую текстовую запись;
*[[Файл:00 19.png]] — удалить текстовую запись.

=== Меню редактора ===
1. Если нажать в меню кнопку '''File''', выпадет список команд, с помощью которых можно создать новый или загрузить уже созданный файл, сохранить файл с указанием места сохранения и т.д. 
2.Для импорта фраз на другом языке необходимо воспользоваться Функцией Ипортировать меню File и выбрать .xml-файл с текстом и выбрать язык 
3. Если нажать в меню кнопку '''Resource''', выпадет список команд: 
* Open Resource - позволяет создать базу по ранее подготовленной графической базе ресурсов с точным совпадением структуры и названием папок и файлов. Используется для Hidden Objects;
* Choose Resource File - позволяет подгрузить базу графических ресурсов для перетаскивания изображений из ResourcesEditor на иконку;
* Choose Categories Config - помогает классифицировать текстовые файлы по категориям.
[[Файл:00_51.PNG]] [[Файл:00_52.PNG]]

=== Создание и заполнение текстовой базы проекта ===
Текстовая база не создается автоматически при создании проекта. 
Для создания и заполнения текстовой базы: 
1. Заходите в пункт меню '''file -> New'''. Появляется пустая база ресурсов, по умолчанию названная '''Untitled'''. 
2. Слева в дереве текстовых объектов кликаем правой кнопкой мыши и выбираем '''Add record'''. Каждый раз при добавлении новой текстовой записи редактор просит нас написать ее имя. Это имя можно будет изменить в любой момент. Запишем имя '''arrow_If_down'''. 
3. Выделить запись и в окне приложения TextEditor справа в столбце Word запишем слово, в столбце Sentence1,Sentence2 - указать подсказку для текстовой записи, в столбце voice - подключить звуковой файл для текстовой записи из ResourcesEditor. 
[[Файл:00_54.PNG]]

'''Необходимо обязательно сохранять любые изменения с текстом в редакторе TextEditor.''' 
Для вызова текстового редактора можно воспользоваться меню '''Tools -> Text Editor''', либо кнопкой быстрого запуска [[Файл:011.JPG]].

'''Замечание.''' Букву Ё заменяем на Е

=== Слияние нескольких текстовых баз ===

Используется для слияния нескольких тектовых баз одного проекта выполненых для разных локализаций.

Импорт текстовой базы

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

Интерфейс Viewer

2013-10-28T15:39:10Z

Podkor: /* Клавиша F2 */

{{TOC right}}
=Начало работы со вьювером =
'''Вьювер''' — приложение, визуализирующие созданную игру, и дающее возможность выявить ошибки и артефакты до начала тестирования. 
Вьювер предназначен для отладки и тестирования созданной игры самим гейм- дизайнером. 
Вьювер запускается непосредственно из ScenceEditor двумя способами из меню Вьювер - Открыть вьювер или кликом по кнопке [[Файл:00_9.png]] 
Для закрытия вьювера нажимаем «Закрыть» или клавишу Esc 
Перед запуском вьювера необходимо выбрать экран или сцену на экране, который начнёт проигрываться, и сохранить проект.
Может быть запущено несколько вюверов. 
При визуализации игры размеры окна вьювера можно изменять (растягивать / сжимать) 
==Особенности работы двух вьюверов одновременно==
Последний запущенный вьювер отображает внесенные и сохраненные изменения перед его запуском. Предыдущий запущенный вьювер — не будет отображать изменения в проекте, внесенные после его запуска 

=Вывод сообщений об ошибках в окне вьювера=

В ходе создания приложения возникают ошибки, которые вьювер отлеживает и отображает в своем окне. 
На примере ниже рассмотрим структуру сообщений об ошибках. 
Предположим, по клику на кнопку А пользователь должен прочитать сообщение, нажать на кнопку Б и уйти на другой экран. 
Алгоритм программы без ошибок: 
1. при клике на кнопку А, изменяется состояние машины MASH на see. 
2. Состояние see машины MASH показывает обьект TEXT c фразой и проявляет кнопку Б. 
3. При клике на кнопку Б переходим на другой экран 

Одноко гейм-дизайнер допустил ряд ошибок: 
1) при клике на кнопку А изменил состояние машина MASH на не существующее (asd) 
2) В свойстве обьекта TEXT не указал фразу персонажа 
3) Случайно удалил кнопку Б с экрана, а ссылка на нее осталась в машине MASH 

'''Вьювер отобразит ошибки:''' 
''При обращении к несуществующему состоянию обьекта.'' На экране будет отображен номер и тип обьекта, состояние которого пытаются вызвать,а также имя несуществующего состояния обьекта. 
[[Файл:Ошибка_тип_1.JPG|300px]] 
''При создании обьекта, которому не установили обязательные параметры, или при удалении обьекта из дерева проекта могут оставаться ссылки на него в других обьектах''. В таком случае вьювер вероятнее всего проигнорирует написанный Вами код и ничего не отобразит в своем окне.

=Клавиша F1=
[[Файл:Вьювер_1.JPG|right|200px]] Список команд, доступных во вьювере, вызываемых по нажатию клавиши F1:
*F2 (help) — открывается панель отладки приложения
*S (states) – при вызове команды на экране отображаются состояния объектов, у которых включена отладка
*F(frames) — отображаются границы обьектов
*V(verbose) – в браузере, установленном по умолчанию, откоется xml — код визуализируемой сцены
*T(fps) — отобразится информация о загрузке операционной памяти ПК
*M(mouse) – при клике по обьекту отобразятся координаты мыши
*D(device) - параметры экрана устройства, под которое разрабатвается приложение
*R(reload) — перезагружает во вьювер весь проект и визуализирует первый по списку экран проекта, но при этом считывает все параметры, записанные в опции
*space – останавливает все процессы игры на данном экране. Для повторного запуска нажимаем space.
Список команд закрывается при повторном нажатии клавиши F1

=Клавиша F2=
При клике на клавишу F2 вызвается панель отладки, позволяющая осуществить :[[Файл:Вювер_3.JPG|500px|right]] 
*переходы между экранами
*вызов других команд вювера
*отслеживать запись параметров в опции (в файл options)
*переключение между локализациями на разные языки
*настройка цвета текста, отображаемого на экране
На рисунке справа приведен вид экрана с включеной панелью отладки. 
Панель отладки закрывается при повторном нажатии клавиши F2 
'''Замечания:'''
*Для перехода на другой экран кликните по названию экрана левой кнопкой мыши.
*Для выбора оптимального цвета шрифта информации,отображаемой на экране поставьте галочки на панели выбора цвета шрифта или кликаем по клавише С
*Для выбора языка локализации игры кликните левой кнопкой мыши по аббревиатуре языка.
*При клике на кнопку Reload во вьювер перезагружается весь проект и визуализируется первый экран в дереве экранов проекта
*При клике на кнопку Save записываются текущие параметры игры (обьектов) и отображаются по порядку в области записи параметров прохождения игры. При клике на запись в области записи параметров прохождения игры игра возвращается в то состояние, после которого были записаны параметры игры.
*При вызове команды time отобразится информация о загрузке операционной памяти ПК/
*При клике на кнопку log записываются текущие статусы обьектов во viewer.log
*При вызове команды log откроется меню в панели отладки (отобразятся кнопоки hystory и pause) и одновременно на экране отобразится информация об изменении состояний и свойств обьектов во время прохождения игры в режиме реального времени. При клике на pause информация перестанет изменяться при клике на любые обьекты. 
*При вызове команды flyers показывается состояние всех флаеров

В нашем проекте может быть создано несколько лэйаутов под разные магазины, платформы и устройства. Для переключения между лэйатуами кликнем по его названию в правом верхнем углу. Для визуализации приложения на разных типах устройствах кликнем по списку устройств, расположенному чуть выше области записи параметров прохождения игры. 
'''Примечание:'''
Для того, чтобы была возможность визуализации игры на разных устройствах, необходимо в файле viewer.xml , расположенному в Application Data\Absolutist\Viewer, в параметрах
autoScX и autoScY прописать значения, подобранные относительно выбраного разрешения и устройства, моделью которого будет являться окно вьювера при визуализации игры. 

=Клавиши F7 и F8=
Нажатие клавиш ''F7'' и ''F8'' позволяет симулировать горячие кнопки девайсов работающих на платформе Android - Home и Back

=Клавиша S (states)=
Для отслеживания перехода обьекта в различные состояния в процессе проигрывания игры необходимо свойству обьекта Отладка присвоить вкл и при визуализации экрана нажать клавишу S. 
Ниже приведен пример отображения информации в окне вьювера при включенной функции states.
На экране отображена следующая информация:
*имя экрана
*уникальный номер и имя обьекта
*имя состояния, в котором обьект находится в данную секунду
[[Файл:States.JPG |500px|right]] 
'''Замечание:'''
*Не все обьекты имееют свойство Отладка.
*Для некоторых обьектов отображается дополнительная служебная информация (например, для обьектов типа mashine)
*Для получения более детальной информации о смене состояний и параметров обьектов в течении нескольких секунд рекомендуется воспользоваться кнопкой pause панели Отладка

==Включение отслеживания обьектов в процессе визуализации игры==
Существует возможность включения отслеживания перехода обьекта в другое состояние при визуализации игры. При включении функции states в левом верхнем углу появляется: 
*поле ID, куда необходимо вписать уникальный номер объекта,
*кнопка ADD – добавить обьект в / в список обьектов, изменение состояния которых отслеживается на экране
*кнопка DEL – удалить объект из списка бьектов, изменение состояния которых отслеживается на экране 
[[Файл:Frames_F.JPG|right|400px]] 

=Кнопка F (frames)=
В процессе размещения на сцене различных обьектов возникает необходимость отслеживать: 
*обьекты, которые прокликиваются,не должны перекрываться другими
*обьекты должны находится в точно заданных границах (например, при создании хидден-игр)
*обьекты, расположенные на разных сценах, не должны перекрываться другими
Во вьювере при клике на клавишу F отобразятся границы всех обьектов, расположенных на экране. 
'''Замечание:''' Границы обьектов выделяются разными цветами. 

=Кнопка V (verbose)=
[[Файл:verbose.JPG|right|500px]]
При визуализации может возникнуть необходимость просмотреть параметры обьектов, расположенных на визуализируемой сцене, не переходя в ScenceEditor и не открывая xml-файл проекта. 
Нажимаем кливишу V и в браузере установленном по умолчанию отобразится файл viewer_info.html, в котором описаны объекты, расположенные на визуализируемой сцене. 

'''Замечание.''' Файл viewer_info.html расположен в \Application Data\Absolutist\Viewer 

= Клавиша T (fps,time)=

В процессе визуализации экрана полезно отслеживать такие параметры: 
*как использование памяти
*какие экраны одновременно подгружены в память в месте с экраном, воспроизводимым в данную минуту
*количество обьектов, расположенных на экране
*количество кадров в минуту
*количество ошибок
Для получения всей этой информации мы нажимаем клавишу T. 
[[Файл:Time.JPG|800px]] 
Отображаемые параметры: 
*f: - количество кадров в секунду. (должно быть больше 30)
*loading screen – имя экрана, загружаемого перед этим (если включена функция предзагрузки экрана)
*img – количество загруженых обьектов
*ram+vram - суммарное количество занимаемой памяти . Значение параметра max – максимальное суммарное количество занимаемой памяти в какой-то момент визуализации игры
*RAM — группа параметров:
#первый параметр — количество памяти, указанное в файле app.icf
# need - количество памяти необходимое для игры 
# used – количество памяти используемое игрой 
# max – максимальное количество памяти, требуемой для игры 
#free – количество свободной памяти 
*VRAM – количество занимаемой памяти приложением и максимальное занимаемая память 
*OS free mem -количество свободной памяти на устройстве 
Render:
*textures: количество загруженых картинок
*imPerLastFrame: картинок в последнем кадре
*imBatchPerLastFrame: упакованных картинок, если значение совпадает с значением в max для этого параметра - значит графика не была упакована в текстуры.

=Клавиша М (mouse)=
[[Файл:Mouse.JPG|right|300px]] 
Иногда бывает ситуация, когда по клику в некоторой заданой области должно производиться некоторое действие. Для уточнения границы такой области воспользуемся функцией Mouse (клавиша М). 
На экране отобразится координата последнего выполненного клика.

=Клавиша D (device)=
Для получения информации о масштабе визуализации игры в окне вьювера необходимо нажать клавишу D в окне вьювера.
На экране отобразится информация:[[Файл:Device.JPG|right|400px]] 
*W – размеры окна вьювера
*L – размеры лэйаута
*D - размеры устройства.
*S – масштаб окна вьювера (относительно размеров лэйаута) 
Примечание. Значения параметра D забираются из файла viewer.xml , который расположен в Application Data\Absolutist\Viewer

=Клавиша С=
Нажатие клавиши ''С'' в тот момент когда на вьювере отображена какая-либо информация, позволяет менять цвет шрифта. Удобно если цвет текста сливается с бекграуном.

=Клавиша SPACE=
Нажатие клавиши SPACE "ставит на паузу" отображаемый во вьювере проект..

Интерфейс Viewer

2013-10-28T15:36:12Z

Podkor: /* Клавиша D (device) */

{{TOC right}}
=Начало работы со вьювером =
'''Вьювер''' — приложение, визуализирующие созданную игру, и дающее возможность выявить ошибки и артефакты до начала тестирования. 
Вьювер предназначен для отладки и тестирования созданной игры самим гейм- дизайнером. 
Вьювер запускается непосредственно из ScenceEditor двумя способами из меню Вьювер - Открыть вьювер или кликом по кнопке [[Файл:00_9.png]] 
Для закрытия вьювера нажимаем «Закрыть» или клавишу Esc 
Перед запуском вьювера необходимо выбрать экран или сцену на экране, который начнёт проигрываться, и сохранить проект.
Может быть запущено несколько вюверов. 
При визуализации игры размеры окна вьювера можно изменять (растягивать / сжимать) 
==Особенности работы двух вьюверов одновременно==
Последний запущенный вьювер отображает внесенные и сохраненные изменения перед его запуском. Предыдущий запущенный вьювер — не будет отображать изменения в проекте, внесенные после его запуска 

=Вывод сообщений об ошибках в окне вьювера=

В ходе создания приложения возникают ошибки, которые вьювер отлеживает и отображает в своем окне. 
На примере ниже рассмотрим структуру сообщений об ошибках. 
Предположим, по клику на кнопку А пользователь должен прочитать сообщение, нажать на кнопку Б и уйти на другой экран. 
Алгоритм программы без ошибок: 
1. при клике на кнопку А, изменяется состояние машины MASH на see. 
2. Состояние see машины MASH показывает обьект TEXT c фразой и проявляет кнопку Б. 
3. При клике на кнопку Б переходим на другой экран 

Одноко гейм-дизайнер допустил ряд ошибок: 
1) при клике на кнопку А изменил состояние машина MASH на не существующее (asd) 
2) В свойстве обьекта TEXT не указал фразу персонажа 
3) Случайно удалил кнопку Б с экрана, а ссылка на нее осталась в машине MASH 

'''Вьювер отобразит ошибки:''' 
''При обращении к несуществующему состоянию обьекта.'' На экране будет отображен номер и тип обьекта, состояние которого пытаются вызвать,а также имя несуществующего состояния обьекта. 
[[Файл:Ошибка_тип_1.JPG|300px]] 
''При создании обьекта, которому не установили обязательные параметры, или при удалении обьекта из дерева проекта могут оставаться ссылки на него в других обьектах''. В таком случае вьювер вероятнее всего проигнорирует написанный Вами код и ничего не отобразит в своем окне.

=Клавиша F1=
[[Файл:Вьювер_1.JPG|right|200px]] Список команд, доступных во вьювере, вызываемых по нажатию клавиши F1:
*F2 (help) — открывается панель отладки приложения
*S (states) – при вызове команды на экране отображаются состояния объектов, у которых включена отладка
*F(frames) — отображаются границы обьектов
*V(verbose) – в браузере, установленном по умолчанию, откоется xml — код визуализируемой сцены
*T(fps) — отобразится информация о загрузке операционной памяти ПК
*M(mouse) – при клике по обьекту отобразятся координаты мыши
*D(device) - параметры экрана устройства, под которое разрабатвается приложение
*R(reload) — перезагружает во вьювер весь проект и визуализирует первый по списку экран проекта, но при этом считывает все параметры, записанные в опции
*space – останавливает все процессы игры на данном экране. Для повторного запуска нажимаем space.
Список команд закрывается при повторном нажатии клавиши F1

=Клавиша F2=
При клике на клавишу F2 вызвается панель отладки, позволяющая осуществить :[[Файл:Вювер_3.JPG|500px|right]] 
*переходы между экранами
*вызов других команд вювера
*отслеживать запись параметров в опции (в файл options)
*переключение между локализациями на разные языки
*настройка цвета текста, отображаемого на экране
На рисунке справа приведен вид экрана с включеной панелью отладки. 
Панель отладки закрывается при повторном нажатии клавиши F2 
'''Замечания:'''
*Для перехода на другой экран кликните по названию экрана левой кнопкой мыши.
*Для выбора оптимального цвета шрифта информации,отображаемой на экране поставьте галочки на панели выбора цвета шрифта или кликаем по клавише С
*Для выбора языка локализации игры кликните левой кнопкой мыши по аббревиатуре языка.
*При клике на кнопку Reload во вьювер перезагружается весь проект и визуализируется первый экран в дереве экранов проекта
*При клике на кнопку Save записываются текущие параметры игры (обьектов) и отображаются по порядку в области записи параметров прохождения игры. При клике на запись в области записи параметров прохождения игры игра возвращается в то состояние, после которого были записаны параметры игры.
*При вызове команды time отобразится информация о загрузке операционной памяти ПК/
*При клике на кнопку log записываются текущие статусы обьектов во viewer.log
*При вызове команды log откроется меню в панели отладки (отобразятся кнопоки hystory и pause) и одновременно на экране отобразится информация об изменении состояний и свойств обьектов во время прохождения игры в режиме реального времени. При клике на pause информация перестанет изменяться при клике на любые обьекты. 
*При вызове команды flyers показывается состояние всех флаеров

В нашем проекте может быть создано несколько лэйаутов под разные магазины, платформы и устройства. Для переключения между лэйатуами кликнем по его названию в правом верхнем углу. Для визуализации приложения на разных типах устройствах кликнем по списку устройств, расположенному чуть выше области записи параметров прохождения игры. 
'''Примечание:'''
Для того, чтобы была возможность визуализации игры на разных устройствах, необходимо в файле viewer.xml , расположенному в Application Data\Absolutist\Viewer, в параметрах
autoScX и autoScY прописать значения, подобранные относительно выбраного разрешения и устройства, моделью которого будет являться окно вьювера при визуализации игры. 

=Клавиша S (states)=
Для отслеживания перехода обьекта в различные состояния в процессе проигрывания игры необходимо свойству обьекта Отладка присвоить вкл и при визуализации экрана нажать клавишу S. 
Ниже приведен пример отображения информации в окне вьювера при включенной функции states.
На экране отображена следующая информация:
*имя экрана
*уникальный номер и имя обьекта
*имя состояния, в котором обьект находится в данную секунду
[[Файл:States.JPG |500px|right]] 
'''Замечание:'''
*Не все обьекты имееют свойство Отладка.
*Для некоторых обьектов отображается дополнительная служебная информация (например, для обьектов типа mashine)
*Для получения более детальной информации о смене состояний и параметров обьектов в течении нескольких секунд рекомендуется воспользоваться кнопкой pause панели Отладка

==Включение отслеживания обьектов в процессе визуализации игры==
Существует возможность включения отслеживания перехода обьекта в другое состояние при визуализации игры. При включении функции states в левом верхнем углу появляется: 
*поле ID, куда необходимо вписать уникальный номер объекта,
*кнопка ADD – добавить обьект в / в список обьектов, изменение состояния которых отслеживается на экране
*кнопка DEL – удалить объект из списка бьектов, изменение состояния которых отслеживается на экране 
[[Файл:Frames_F.JPG|right|400px]] 

=Кнопка F (frames)=
В процессе размещения на сцене различных обьектов возникает необходимость отслеживать: 
*обьекты, которые прокликиваются,не должны перекрываться другими
*обьекты должны находится в точно заданных границах (например, при создании хидден-игр)
*обьекты, расположенные на разных сценах, не должны перекрываться другими
Во вьювере при клике на клавишу F отобразятся границы всех обьектов, расположенных на экране. 
'''Замечание:''' Границы обьектов выделяются разными цветами. 

=Кнопка V (verbose)=
[[Файл:verbose.JPG|right|500px]]
При визуализации может возникнуть необходимость просмотреть параметры обьектов, расположенных на визуализируемой сцене, не переходя в ScenceEditor и не открывая xml-файл проекта. 
Нажимаем кливишу V и в браузере установленном по умолчанию отобразится файл viewer_info.html, в котором описаны объекты, расположенные на визуализируемой сцене. 

'''Замечание.''' Файл viewer_info.html расположен в \Application Data\Absolutist\Viewer 

= Клавиша T (fps,time)=

В процессе визуализации экрана полезно отслеживать такие параметры: 
*как использование памяти
*какие экраны одновременно подгружены в память в месте с экраном, воспроизводимым в данную минуту
*количество обьектов, расположенных на экране
*количество кадров в минуту
*количество ошибок
Для получения всей этой информации мы нажимаем клавишу T. 
[[Файл:Time.JPG|800px]] 
Отображаемые параметры: 
*f: - количество кадров в секунду. (должно быть больше 30)
*loading screen – имя экрана, загружаемого перед этим (если включена функция предзагрузки экрана)
*img – количество загруженых обьектов
*ram+vram - суммарное количество занимаемой памяти . Значение параметра max – максимальное суммарное количество занимаемой памяти в какой-то момент визуализации игры
*RAM — группа параметров:
#первый параметр — количество памяти, указанное в файле app.icf
# need - количество памяти необходимое для игры 
# used – количество памяти используемое игрой 
# max – максимальное количество памяти, требуемой для игры 
#free – количество свободной памяти 
*VRAM – количество занимаемой памяти приложением и максимальное занимаемая память 
*OS free mem -количество свободной памяти на устройстве 
Render:
*textures: количество загруженых картинок
*imPerLastFrame: картинок в последнем кадре
*imBatchPerLastFrame: упакованных картинок, если значение совпадает с значением в max для этого параметра - значит графика не была упакована в текстуры.

=Клавиша М (mouse)=
[[Файл:Mouse.JPG|right|300px]] 
Иногда бывает ситуация, когда по клику в некоторой заданой области должно производиться некоторое действие. Для уточнения границы такой области воспользуемся функцией Mouse (клавиша М). 
На экране отобразится координата последнего выполненного клика.

=Клавиша D (device)=
Для получения информации о масштабе визуализации игры в окне вьювера необходимо нажать клавишу D в окне вьювера.
На экране отобразится информация:[[Файл:Device.JPG|right|400px]] 
*W – размеры окна вьювера
*L – размеры лэйаута
*D - размеры устройства.
*S – масштаб окна вьювера (относительно размеров лэйаута) 
Примечание. Значения параметра D забираются из файла viewer.xml , который расположен в Application Data\Absolutist\Viewer

=Клавиша С=
Нажатие клавиши ''С'' в тот момент когда на вьювере отображена какая-либо информация, позволяет менять цвет шрифта. Удобно если цвет текста сливается с бекграуном.

=Клавиша SPACE=
Нажатие клавиши SPACE "ставит на паузу" отображаемый во вьювере проект..

2013-09-05T09:09:36Z

Podkor: /* Проверка получения achievement */

Объект используется для отправки данных на gamecenter. Отправлять можно набранные очки (score) или достижения (achievement).

== Параметры и модификаторы ==

[[Файл:Gc1.jpg|right]]
* положение - определяет положение объекта на сцене.
* размер - определяет размер объекта на сцене.
* achievement - достижение, которое будем отправлять.
* achievement percent - на сколько процентов завершено достижение.
* score - очки, которые мы будем отправлять.
* score category - категория, в которую мы отправляем очки (ссылка на leaderboard).
* состояние - состояние, которое мы передаем объекту gamecenter
'''authenticate''' - состояние, по которому начинается авторизация мобильного
устройства на геймцентре.
'''score''' - состояние, по которому отправляются очки.
'''achievement''' - состояние, по которому отправляются достижения.
'''score_show''' - состояние, по которому можно посмотреть очки на геймцентре.
'''achievements_show''' - состояние, по которому можно посмотреть достижения.

== Пример применения ==

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

=== Очки ===

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

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

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

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

Чтобы посмотреть очки мы передаем объекту gamecenter состояние score_show.

=== Достижения ===

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

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

Для просмотра достижений нужно передать объекту gamecenter состояние achievements_show.

Отличительной особенностью достижений является то, что при успешной авторизации в опции записывается параметр, отвечающий за то или иное достижение. Поэтому эту информацию всегда можно считать из опций и использовать в игре. Выглядит она в опциях как параметр [[Файл:Gc5.jpg]], значение которого = 1.

== Примечания и дополнения ==

Для того, чтобы понимать что происходит с объектом gamecenter по логу viewer, приведен ряд значений, которые может получать GGamecenter (state=n, где n - номер состояния):

n состояние пояснение
0 ST_IDLE=0, // состояние простоя
1 ST_NOT_SUPPORTED, // геймцентр не поддерживается на устройстве
2 ST_AUTHENTICATE, // попытаться авторизоваться
3 ST_AUTHENTICATION_ERROR, // ошибка авторизации
4 ST_AUTHENTICATED, // успешно авторизовались
5 ST_REPORT_ACHIEVEMENT, // запостить ачивку
6 ST_ACHIEVEMENT_SUCCESS, // ачивка успешно отправлена
7 ST_ACHIEVEMENT_FAILED, // не удалось отправить ачивку
8 ST_SHOW_ACHIEVEMENTS, // показать стандартный гуи с ачивками
9 ST_REPORT_SCORE, // отправить очки
10 ST_SCORE_SUCCESS, // очки успешно отправлены
11 ST_SCORE_FAILED, // не удалось отправить очки
12 ST_SHOW_LEADERBOARDS, // показать стандартный гуи с очками

Например, GGameCenter::state old_state = 1, state = 5,
 где:
 old_state - предыдущее состояние,
 state - текущее состояние.
=== Проверка получения achievement ===

Есть возможность проверять из редактора (на компьютере) приходят ли achievements - для этого в файлике Viewer_Log нужно найти строчку:

GGameCenter::reportAchievement achievement = %s, percent = %d

где,
%s - имя ачивмента (ссылочка которую дают маркетологи)
%d - число процента

Gamecenter

2013-09-05T09:09:09Z

Podkor: /* Проверка получения achievement */

Объект используется для отправки данных на gamecenter. Отправлять можно набранные очки (score) или достижения (achievement).

== Параметры и модификаторы ==

[[Файл:Gc1.jpg|right]]
* положение - определяет положение объекта на сцене.
* размер - определяет размер объекта на сцене.
* achievement - достижение, которое будем отправлять.
* achievement percent - на сколько процентов завершено достижение.
* score - очки, которые мы будем отправлять.
* score category - категория, в которую мы отправляем очки (ссылка на leaderboard).
* состояние - состояние, которое мы передаем объекту gamecenter
'''authenticate''' - состояние, по которому начинается авторизация мобильного
устройства на геймцентре.
'''score''' - состояние, по которому отправляются очки.
'''achievement''' - состояние, по которому отправляются достижения.
'''score_show''' - состояние, по которому можно посмотреть очки на геймцентре.
'''achievements_show''' - состояние, по которому можно посмотреть достижения.

== Пример применения ==

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

=== Очки ===

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

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

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

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

Чтобы посмотреть очки мы передаем объекту gamecenter состояние score_show.

=== Достижения ===

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

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

Для просмотра достижений нужно передать объекту gamecenter состояние achievements_show.

Отличительной особенностью достижений является то, что при успешной авторизации в опции записывается параметр, отвечающий за то или иное достижение. Поэтому эту информацию всегда можно считать из опций и использовать в игре. Выглядит она в опциях как параметр [[Файл:Gc5.jpg]], значение которого = 1.

== Примечания и дополнения ==

Для того, чтобы понимать что происходит с объектом gamecenter по логу viewer, приведен ряд значений, которые может получать GGamecenter (state=n, где n - номер состояния):

n состояние пояснение
0 ST_IDLE=0, // состояние простоя
1 ST_NOT_SUPPORTED, // геймцентр не поддерживается на устройстве
2 ST_AUTHENTICATE, // попытаться авторизоваться
3 ST_AUTHENTICATION_ERROR, // ошибка авторизации
4 ST_AUTHENTICATED, // успешно авторизовались
5 ST_REPORT_ACHIEVEMENT, // запостить ачивку
6 ST_ACHIEVEMENT_SUCCESS, // ачивка успешно отправлена
7 ST_ACHIEVEMENT_FAILED, // не удалось отправить ачивку
8 ST_SHOW_ACHIEVEMENTS, // показать стандартный гуи с ачивками
9 ST_REPORT_SCORE, // отправить очки
10 ST_SCORE_SUCCESS, // очки успешно отправлены
11 ST_SCORE_FAILED, // не удалось отправить очки
12 ST_SHOW_LEADERBOARDS, // показать стандартный гуи с очками

Например, GGameCenter::state old_state = 1, state = 5,
 где:
 old_state - предыдущее состояние,
 state - текущее состояние.
=== Проверка получения achievement ===

Есть возможность проверять из редактора (на компьютере) приходят ли achievements:
для этого в файлике Viewer_Log нужно найти строчку
GGameCenter::reportAchievement achievement = %s, percent = %d

где,
%s - имя ачивмента (ссылочка которую дают маркетологи)
%d - число процента

Gamecenter

2013-09-05T09:04:34Z

Podkor: /* Примечания и дополнения */

Gamecenter

2013-09-05T09:04:12Z

Podkor: /* Примечания и дополнения */

Объект используется для отправки данных на gamecenter. Отправлять можно набранные очки (score) или достижения (achievement).

== Параметры и модификаторы ==

[[Файл:Gc1.jpg|right]]
* положение - определяет положение объекта на сцене.
* размер - определяет размер объекта на сцене.
* achievement - достижение, которое будем отправлять.
* achievement percent - на сколько процентов завершено достижение.
* score - очки, которые мы будем отправлять.
* score category - категория, в которую мы отправляем очки (ссылка на leaderboard).
* состояние - состояние, которое мы передаем объекту gamecenter
'''authenticate''' - состояние, по которому начинается авторизация мобильного
устройства на геймцентре.
'''score''' - состояние, по которому отправляются очки.
'''achievement''' - состояние, по которому отправляются достижения.
'''score_show''' - состояние, по которому можно посмотреть очки на геймцентре.
'''achievements_show''' - состояние, по которому можно посмотреть достижения.

== Пример применения ==

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

=== Очки ===

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

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

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

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

Чтобы посмотреть очки мы передаем объекту gamecenter состояние score_show.

=== Достижения ===

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

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

Для просмотра достижений нужно передать объекту gamecenter состояние achievements_show.

Отличительной особенностью достижений является то, что при успешной авторизации в опции записывается параметр, отвечающий за то или иное достижение. Поэтому эту информацию всегда можно считать из опций и использовать в игре. Выглядит она в опциях как параметр [[Файл:Gc5.jpg]], значение которого = 1.

== Примечания и дополнения ==

Для того, чтобы понимать что происходит с объектом gamecenter по логу viewer, приведен ряд значений, которые может получать GGamecenter (state=n, где n - номер состояния):

n состояние пояснение
0 ST_IDLE=0, // состояние простоя
1 ST_NOT_SUPPORTED, // геймцентр не поддерживается на устройстве
2 ST_AUTHENTICATE, // попытаться авторизоваться
3 ST_AUTHENTICATION_ERROR, // ошибка авторизации
4 ST_AUTHENTICATED, // успешно авторизовались
5 ST_REPORT_ACHIEVEMENT, // запостить ачивку
6 ST_ACHIEVEMENT_SUCCESS, // ачивка успешно отправлена
7 ST_ACHIEVEMENT_FAILED, // не удалось отправить ачивку
8 ST_SHOW_ACHIEVEMENTS, // показать стандартный гуи с ачивками
9 ST_REPORT_SCORE, // отправить очки
10 ST_SCORE_SUCCESS, // очки успешно отправлены
11 ST_SCORE_FAILED, // не удалось отправить очки
12 ST_SHOW_LEADERBOARDS, // показать стандартный гуи с очками

Например, GGameCenter::state old_state = 1, state = 5,
 где:
 old_state - предыдущее состояние,
 state - текущее состояние.

'''Проверка получения achievement'''

Machine

2013-08-21T07:25:13Z

Podkor: /* Параметры */

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

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

=== set ===

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

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_param''' - глобальный либо текущий экран, параметры которого меняем
* '''scr_state''' - экран, состояние которого меняем
* '''parent''' - Объект, который будет установлен в качестве родителя объекту из obj. Объект obj будет оторван от текущего своего родителя и добавлен в детей объекта parent
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''val_res''' - Новое значение графического ресурса (перетаскивается из редактора ресурсов). (пока не работает)
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''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''' - аргумент функции

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

=== buy ===

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

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

=== download ===

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

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

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

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

=== wait ===

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

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

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

=== move ===

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

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

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

=== rot ===

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

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

=== alpha ===

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

Если у объекта прозрачность ''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.

=== 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.

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

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

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

</pre>

== Условия ==

=== if ===

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

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

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

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

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

Для проверки текущего значения прозрачности у объекта можно воспользоваться параметром ''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]]'''
 
 
 

=== 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. Созданые сцены можно удалить :)

== Random ==
На момент, когда пишется данная статья, понятие вероятности существует только в команде wait и в текстовом поле(объект [[Text]]) можно показать случайный текст. Однако, и текущей функциональности достаточно, чтобы сделать генератор случайных чисел:
[[Файл:Random.jpg]]
Или в виде xml:
<nowiki>
<obj type="machine" id="<Вставьте сюда ваш идентификатор объекта>" nm="random" sync="1" x="800" y="1200" w="1" h="1" al="0" trace="1">

<st id="init">

<set obj="369" par="random.val" val="0" user="1"/>

<set obj="369" par="random.precision" val="0.01" user="1"/>

<set obj="369" par="random.add" val="1" user="1"/>

<set obj="369" st="save"/>

</st>

<st id="count">

<set obj="369" par="random.val" val="0" user="1"/>

<set obj="369" par="random.add" val="1" user="1"/>

<set obj="369" st="save"/>

<wait go="iterate"/>

</st>

<st id="iterate">

<var nm="add" obj="369" par="random.add" user="1"/>

<set obj="369" par="random.add" val="((add)/2)" user="1"/>

<wait if="0" go="complete"/>

<wait p="0.5" go="add"/>

<wait go="iterate"/>

<if obj="369" par="random.precision" op=">" val="(add)"/>

</st>

<st id="add">

<var nm="add" obj="369" par="random.add" user="1"/>

<var nm="val" obj="369" par="random.val" user="1"/>

<set obj="369" par="random.val" val="(add+val)" user="1"/>

<wait go="iterate"/>

</st>

<st id="complete">

<set obj="369" st="save"/>

</st>

</obj>
</nowiki>

прим. Объект с id="369" - объект типа [[Options]]

=== Краткое описание алгоритма ===
1. Задаются точность и обнуляется значение(val)

2. Устанавливается добавляемое значение (add)

3. add делится на двое. Если срабатывает wait - add добавляется к val. Если add становится меньше допустимой точности - переходим к п. 4. Если не один из переходов не сработал - повторяем п. 3.

4. Окончание работы объекта, сохранение опций

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

1. Задаём переменной Options->random.precision необходимую точность (обычно 0.01 для игровых проектов достаточно)

2. Переводим объект random в состояние count

3. Ждём определённое время (200 милисекунд, в принципе достаточно, если не успеете - получите результат с меньшей точностью), либо, если уж боитесь - в цикле(переходя wait-ами между 2-мя состояниями) проверяйте перешёл ли random в состояние complete

4. Результат вычислений заносится в переменную Options->random.val . val принимает значение от 0 до 1 (не включая 1)

=== Какие могут возникнуть проблемы ===

1. Если 2 объекта захотят одновременно вызвать random. Решение проблемы: Создать 2 объекта random. И ещё, обязательно переименовать в каждом объекте группу параметров, в который параметры будут заноситься (Например: random1.val, random2.val).

2. Не следует сохранять в Options промежуточные вычисления, т. к. это очень существенно замедлит вычисления

3. Если машина невидима(vis = 0), то она остаётся функционировать, но частично:

Предположим, что есть машина А, у которой перед загрузкой экрана vis=0, в ней в состоянии по-умолчанию есть движение, init и несколько set-ов на другие объекты. При загрузке экрана выполнятся set-ы, init, но объект двигаться как указано не будет.

Если необходимо чтобы объект двигался невидимым - следует использовать изменение прозрачности машины, или init для перемещения.

== Random 2 ==
Улучшенный вариант предыдущего генератора случайных чисел ([[Random]]).
Суть состоит в том, что объект записывает переменные внутрь себя, минуя запись объект [Options].
[[Файл:Random2.jpg]]

Исходный xml-код имеет вид:

<pre>
<obj id="4759" type="machine" nm="random_new" sync="1" x="800" y="1200" w="1" h="1" al="0" trace="1">
<st id="init">
<set obj="4759" par="val" val="0"/>
<set obj="4759" par="precision" val="0.01"/>
<set obj="4759" par="add" val="1"/>
</st>
<st id="count">
<set obj="4759" par="val" val="0"/>
<set obj="4759" par="add" val="1"/>
<wait go="iterate"/>
</st>
<st id="iterate">
<var nm="add" obj="4759" par="add"/>
<set obj="4759" par="add" val="((add)/2)"/>
<wait if="0" go="complete"/>
<wait p="0.5" go="add"/>
<wait go="iterate"/>
<if obj="4759" par="precision" op=">" val="(add)"/>
</st>
<st id="add">
<var nm="add" obj="4759" par="add"/>
<var nm="val" obj="4759" par="val"/>
<set obj="4759" par="val" val="(add+val)"/>
<wait go="iterate"/>
</st>
<st id="complete"/>
</obj>
</pre>

=== Краткое описание алгоритма ===
См. объект [[Random]]

=== Как пользоваться? ===
См. объект [[Random]]

=== Достоинства и недостатки ===
Достоинства: можно создавать несколько копий, при этом не нужно лезть внутрь объекта (если хотите иметь несколько генераторов в одном экране, скопируйте генератор в другой экран, а потом перенесите обратно - ссылка внутри объекта на самого себя сохранится).

Недостатки: Как и в случае с объектом Random, нужно выдержать время, чтобы генератор сработал. Таким образом, к генератору может безопасно обращаться только 1 объект.

== Random-псевдо ==
Генератор псевдослучайных чисел. Быстрый генератор, по сравнению с [[Random2]].
Суть состоит в том, что последовательность случайных чисел задаётся по формуле:

Хорошее среднее значение (0.47) даёт формула:
A=10000*i*/(i+1)
Даллее, от числа А оставляется только дробная часть.

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

Исходный xml-код имеет вид:

<pre>
<obj id="4908" type="machine" nm="random_pseudo" sync="1" x="800" y="800" w="100" h="100" trace="1">
<st id="init">
<set obj="4908" par="index" val="101"/>
<set obj="4908" par="val" val="0"/>
</st>
<st id="count">
<var nm="a1" obj="4908" par="index"/>
<var nm="a" obj="4908" par="a"/>
<var nm="ar" obj="4908" par="a_round"/>
<set obj="4908" par="a" val="(((a1)/(a1+1))*10000)"/>
<set obj="4908" par="a_round" val="(a)" round="1"/>
<set obj="4908" par="val" val="(a-ar)"/>
<set obj="4908" par="index" val="(a1+1)" if="(!0)"/>
<set obj="4908" par="index" val="101" if="0"/>
<if obj="4908" par="index" op=">" val="201"/>
</st>
</obj>
</pre>

=== Краткое описание алгоритма ===
1. Устанавливается начальное значение индекса index=101 (экспериментальное)

2. Подсчитывается значение а= index*10000/(index+1)

3. Отбрасывается целая часть а

4. Запись результата во внутренню переменную val

5. Если индекс стал больше 200- ставим его снова 101.

=== Как пользоваться? ===
1. Переводим объект random_pseudo в состояние count
2. Считываем результат из переменной val

=== Какие могут возникнуть проблемы? ===
Проблема, собственно, только одна - бедность данного генератора, т. к. он имеет всего 100 различных значений. Однако, для производства игр, такого количества вполне достаточно.

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

Недостатки: (они уже описаны выше) малое количество выдаваемых значений, цикличность последовательности.

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

2013-08-21T07:15:31Z

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

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

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

=== set ===

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

* '''obj''' - изменяемый объект (выбирается из списка объектов);
* '''st''' - состояние в которое переводится объект.
* '''scr_param''' - глобальный либо текущий экран, параметры которого меняем
* '''scr_state''' - экран, состояние которого меняем
* '''parent''' - Объект, который будет установлен в качестве родителя объекту из obj. Объект obj будет оторван от текущего своего родителя и добавлен в детей объекта parent
* '''par''' - параметр объекта для установки, используется вместе с val, val_obj, val_txt, val_scr.
* '''val''' - значение параметра объекта для установки
* '''round''' - округлить значение, записываемое в val
* '''val_obj''' - id объекта, будет записано в в par
* '''val_txt''' - id текста, будет записано в в par
* '''val_scr''' - id экрана, будет записано в в par
* '''val_res''' - Новое значение графического ресурса (перетаскивается из редактора ресурсов). (пока не работает)
* '''var''' - имя переменной данной машины, значение которой присваивается в параметр par объекта obj
* '''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''' - аргумент функции

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

=== buy ===

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

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

=== download ===

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

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

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

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

=== wait ===

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

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

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

=== move ===

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

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

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

=== rot ===

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

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

=== alpha ===

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

Если у объекта прозрачность ''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.

=== 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.

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

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

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

</pre>

== Условия ==

=== if ===

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

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

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

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

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

Для проверки текущего значения прозрачности у объекта можно воспользоваться параметром ''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]]'''
 
 
 

=== 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. Созданые сцены можно удалить :)

== Random ==
На момент, когда пишется данная статья, понятие вероятности существует только в команде wait и в текстовом поле(объект [[Text]]) можно показать случайный текст. Однако, и текущей функциональности достаточно, чтобы сделать генератор случайных чисел:
[[Файл:Random.jpg]]
Или в виде xml:
<nowiki>
<obj type="machine" id="<Вставьте сюда ваш идентификатор объекта>" nm="random" sync="1" x="800" y="1200" w="1" h="1" al="0" trace="1">

<st id="init">

<set obj="369" par="random.val" val="0" user="1"/>

<set obj="369" par="random.precision" val="0.01" user="1"/>

<set obj="369" par="random.add" val="1" user="1"/>

<set obj="369" st="save"/>

</st>

<st id="count">

<set obj="369" par="random.val" val="0" user="1"/>

<set obj="369" par="random.add" val="1" user="1"/>

<set obj="369" st="save"/>

<wait go="iterate"/>

</st>

<st id="iterate">

<var nm="add" obj="369" par="random.add" user="1"/>

<set obj="369" par="random.add" val="((add)/2)" user="1"/>

<wait if="0" go="complete"/>

<wait p="0.5" go="add"/>

<wait go="iterate"/>

<if obj="369" par="random.precision" op=">" val="(add)"/>

</st>

<st id="add">

<var nm="add" obj="369" par="random.add" user="1"/>

<var nm="val" obj="369" par="random.val" user="1"/>

<set obj="369" par="random.val" val="(add+val)" user="1"/>

<wait go="iterate"/>

</st>

<st id="complete">

<set obj="369" st="save"/>

</st>

</obj>
</nowiki>

прим. Объект с id="369" - объект типа [[Options]]

=== Краткое описание алгоритма ===
1. Задаются точность и обнуляется значение(val)

2. Устанавливается добавляемое значение (add)

3. add делится на двое. Если срабатывает wait - add добавляется к val. Если add становится меньше допустимой точности - переходим к п. 4. Если не один из переходов не сработал - повторяем п. 3.

4. Окончание работы объекта, сохранение опций

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

1. Задаём переменной Options->random.precision необходимую точность (обычно 0.01 для игровых проектов достаточно)

2. Переводим объект random в состояние count

3. Ждём определённое время (200 милисекунд, в принципе достаточно, если не успеете - получите результат с меньшей точностью), либо, если уж боитесь - в цикле(переходя wait-ами между 2-мя состояниями) проверяйте перешёл ли random в состояние complete

4. Результат вычислений заносится в переменную Options->random.val . val принимает значение от 0 до 1 (не включая 1)

=== Какие могут возникнуть проблемы ===

1. Если 2 объекта захотят одновременно вызвать random. Решение проблемы: Создать 2 объекта random. И ещё, обязательно переименовать в каждом объекте группу параметров, в который параметры будут заноситься (Например: random1.val, random2.val).

2. Не следует сохранять в Options промежуточные вычисления, т. к. это очень существенно замедлит вычисления

3. Если машина невидима(vis = 0), то она остаётся функционировать, но частично:

Предположим, что есть машина А, у которой перед загрузкой экрана vis=0, в ней в состоянии по-умолчанию есть движение, init и несколько set-ов на другие объекты. При загрузке экрана выполнятся set-ы, init, но объект двигаться как указано не будет.

Если необходимо чтобы объект двигался невидимым - следует использовать изменение прозрачности машины, или init для перемещения.

== Random 2 ==
Улучшенный вариант предыдущего генератора случайных чисел ([[Random]]).
Суть состоит в том, что объект записывает переменные внутрь себя, минуя запись объект [Options].
[[Файл:Random2.jpg]]

Исходный xml-код имеет вид:

<pre>
<obj id="4759" type="machine" nm="random_new" sync="1" x="800" y="1200" w="1" h="1" al="0" trace="1">
<st id="init">
<set obj="4759" par="val" val="0"/>
<set obj="4759" par="precision" val="0.01"/>
<set obj="4759" par="add" val="1"/>
</st>
<st id="count">
<set obj="4759" par="val" val="0"/>
<set obj="4759" par="add" val="1"/>
<wait go="iterate"/>
</st>
<st id="iterate">
<var nm="add" obj="4759" par="add"/>
<set obj="4759" par="add" val="((add)/2)"/>
<wait if="0" go="complete"/>
<wait p="0.5" go="add"/>
<wait go="iterate"/>
<if obj="4759" par="precision" op=">" val="(add)"/>
</st>
<st id="add">
<var nm="add" obj="4759" par="add"/>
<var nm="val" obj="4759" par="val"/>
<set obj="4759" par="val" val="(add+val)"/>
<wait go="iterate"/>
</st>
<st id="complete"/>
</obj>
</pre>

=== Краткое описание алгоритма ===
См. объект [[Random]]

=== Как пользоваться? ===
См. объект [[Random]]

=== Достоинства и недостатки ===
Достоинства: можно создавать несколько копий, при этом не нужно лезть внутрь объекта (если хотите иметь несколько генераторов в одном экране, скопируйте генератор в другой экран, а потом перенесите обратно - ссылка внутри объекта на самого себя сохранится).

Недостатки: Как и в случае с объектом Random, нужно выдержать время, чтобы генератор сработал. Таким образом, к генератору может безопасно обращаться только 1 объект.

== Random-псевдо ==
Генератор псевдослучайных чисел. Быстрый генератор, по сравнению с [[Random2]].
Суть состоит в том, что последовательность случайных чисел задаётся по формуле:

Хорошее среднее значение (0.47) даёт формула:
A=10000*i*/(i+1)
Даллее, от числа А оставляется только дробная часть.

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

Исходный xml-код имеет вид:

<pre>
<obj id="4908" type="machine" nm="random_pseudo" sync="1" x="800" y="800" w="100" h="100" trace="1">
<st id="init">
<set obj="4908" par="index" val="101"/>
<set obj="4908" par="val" val="0"/>
</st>
<st id="count">
<var nm="a1" obj="4908" par="index"/>
<var nm="a" obj="4908" par="a"/>
<var nm="ar" obj="4908" par="a_round"/>
<set obj="4908" par="a" val="(((a1)/(a1+1))*10000)"/>
<set obj="4908" par="a_round" val="(a)" round="1"/>
<set obj="4908" par="val" val="(a-ar)"/>
<set obj="4908" par="index" val="(a1+1)" if="(!0)"/>
<set obj="4908" par="index" val="101" if="0"/>
<if obj="4908" par="index" op=">" val="201"/>
</st>
</obj>
</pre>

=== Краткое описание алгоритма ===
1. Устанавливается начальное значение индекса index=101 (экспериментальное)

2. Подсчитывается значение а= index*10000/(index+1)

3. Отбрасывается целая часть а

4. Запись результата во внутренню переменную val

5. Если индекс стал больше 200- ставим его снова 101.

=== Как пользоваться? ===
1. Переводим объект random_pseudo в состояние count
2. Считываем результат из переменной val

=== Какие могут возникнуть проблемы? ===
Проблема, собственно, только одна - бедность данного генератора, т. к. он имеет всего 100 различных значений. Однако, для производства игр, такого количества вполне достаточно.

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

Недостатки: (они уже описаны выше) малое количество выдаваемых значений, цикличность последовательности.

== 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]