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

Bubble Shooter NEW

2019-09-30T08:56:21Z

Akovinenko: /* Хинты */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

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

'''Merge'''
*'''макс. уровень (max_level)''' - место в опциях, где лежит макс. уровень.
*'''сага тэг (saga_tag)''' - место в опциях, где лежит вся информация по саге.
*'''классика очки (classic_score)''' - место в опциях, где лежат очки по классике.
*'''классика тэг (classic_tag)''' - место в опциях, где лежит вся информация по классике.

=Графика=
*'''цветной шарик 1 (res1)''' - графический ресурс шарика 1.
*'''фрейм шарика 1 (res1Frame)''' - Номер фрейма ресурса шарика 1.
*'''цветной шарик 2 (res2)''' - графический ресурс шарика 2.
*'''фрейм шарика 2 (res2Frame)''' - Номер фрейма ресурса шарика 2.
*'''цветной шарик 3 (res3)''' - графический ресурс шарика 3
*'''фрейм шарика 3 (res3Frame)''' - Номер фрейма ресурса шарика 3.
*'''цветной шарик 4 (res4)''' - графический ресурс шарика 4.
*'''фрейм шарика 4 (res4Frame)''' - Номер фрейма ресурса шарика 4.
*'''цветной шарик 5 (res5)''' - графический ресурс шарика 5.
*'''фрейм шарика 5 (res5Frame)''' - Номер фрейма ресурса шарика 5.
*'''цветной шарик 6 (res6)''' - графический ресурс шарика 6.
*'''фрейм шарика 6 (res6Frame)''' - Номер фрейма ресурса шарика 6.
*'''цветной шарик 7 (res7)''' - графический ресурс шарика 7.
*'''фрейм шарика 7 (res7Frame)''' - Номер фрейма ресурса шарика 7.
*'''цветной шарик 8 (res8)''' - графический ресурс шарика 8.
*'''фрейм шарика 8 (res8Frame)''' - Номер фрейма ресурса шарика 8.
*'''цветной шарик Y (resY)''' - графический ресурс цветного шарика.
*'''гвоздь (resZ)''' - графический ресурс гвоздя.
*'''целевой шарик 1 (rest1)''' - графический ресурс целевого шарика 1.
*'''фрейм шарика 1 (rest1Frame)''' - Номер фрейма ресурса целевого шарика 1.
*'''целевой шарик 2 (rest2)''' - графический ресурс целевого шарика 2.
*'''фрейм шарика 2 (rest2Frame)''' - Номер фрейма ресурса целевого шарика 2.
*'''целевой шарик 3 (rest3)''' - графический ресурс целевого шарика 3
*'''фрейм шарика 3 (rest3Frame)''' - Номер фрейма ресурса целевого шарика 3.
*'''целевой шарик 4 (rest4)''' - графический ресурс целевого шарика 4.
*'''фрейм шарика 4 (rest4Frame)''' - Номер фрейма ресурса целевого шарика 4.
*'''целевой шарик 5 (rest5)''' - графический ресурс целевого шарика 5.
*'''фрейм шарика 5 (rest5Frame)''' - Номер фрейма ресурса целевого шарика 5.
*'''целевой шарик 6 (rest6)''' - графический ресурс целевого шарика 6.
*'''фрейм шарика 6 (rest6Frame)''' - Номер фрейма ресурса целевого шарика 6.
*'''целевой шарик 7 (rest7)''' - графический ресурс целевого шарика 7.
*'''фрейм шарика 7 (rest7Frame)''' - Номер фрейма ресурса целевого шарика 7.
*'''целевой шарик 8 (rest8)''' - графический ресурс целевого шарика 8.
*'''фрейм шарика 8 (rest8Frame)''' - Номер фрейма ресурса целевого шарика 8.
*'''целевой шарик Y (restY)''' - графический ресурс целевого цветного шарика.
*'''маска залочки (res_lock_mask)''' - графический ресурс маски залочки.
*'''падающий шарик (res_drop_mask)''' - графический ресурс падающего шарика.
*'''лунка (resf1)''' - графический ресурс лунки.
*'''фрейм лунка (resf1Frame)''' - Номер фрейма ресурса лунки.
*'''колючка (resf2)''' - графический ресурс колючки.
*'''фрейм колючка (resf2Frame)''' - Номер фрейма ресурса колючки.
*'''снежинка (resf3)''' - графический ресурс снежинки.
*'''фрейм снежинка (resf3Frame)''' - Номер фрейма ресурса снежинки.
*'''вредитель (resf4)''' - графический ресурс вредителя.
*'''фрейм вредитель (resf4Frame)''' - Номер фрейма ресурса вредителя.
*'''половинки (resf5)''' - графический ресурс половинок.
*'''фрейм половинки (resf5Frame)''' - Номер фрейма ресурса половинок.
*'''камень (resf6)''' - графический ресурс камня.
*'''фрейм камень (resf6Frame)''' - Номер фрейма ресурса камня.
*'''хищник (resf8)''' - графический ресурс маски залочки.
*'''фрейм хищник (resf8Frame)''' - графический ресурс маски залочки.
*'''призрак (resf9)''' - графический ресурс призрака.
*'''фрейм призрак (resf9Frame)''' - Номер фрейма ресурса призрака.
*'''шестеренка (resf10)''' - графический ресурс шетеренки.
*'''фрейм шестеренка (resf10Frame)''' - Номер фрейма ресурса шестеренки.
*'''туман (resf11)''' - графический ресурс тумана.
*'''фрейм туман (resf11Frame)''' - Номер фрейма ресурса тумана.
*'''портал (resf12)''' - графический ресурс портала.
*'''фрейм портал (resf12Frame)''' - Номер фрейма ресурса портала.
*'''призрак-цель (resf13)''' - графический ресурс призрак-цель.
*'''фрейм призрак-цель (resf13Frame)''' - Номер фрейма ресурса призрак-цель.
*'''огонь (resf14)''' - графический ресурс огня.
*'''фрейм огонь (resf14Frame)''' - Номер фрейма ресурса огонь.
*'''молния (resf15)''' - графический ресурс молнии.
*'''фрейм молния (resf15Frame)''' - Номер фрейма ресурса молния.
*'''радужный шар (resrainbow)''' - графический ресурс радужного шара.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''drop''' - Звук осыпания.
*'''intro''' - Звук в начале игры.
*'''add row''' - Звук добавления ряда.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Звук взрыва бомбы мина.
*'''Взрыв бомбы ядро''' - Звук взрыва бомбы ядро.
*'''Взрыв бомбы цвет''' - Звук взрыва бомбы цвет.
*'''Бомба мульти цвет''' - Звук взыва бомбы мульти цвет.
*'''Закат в лунку''' - Звук заката в лунку.
*'''Взрыв колючкой''' - Звук взрыва колючкой.
*'''Таяние снежинки''' - Звук таяния снежинки.

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.

=Машины отображающие пушку=
*'''Первый шарик''' - машина, отображающая первый шарик. При выстреле в эту машину пишется параметр '''curr_bomb_type''', который говорит о том, выстрелили мы обычным шариком или бустером (0 - обычный шарик).
*'''Второй шарик''' - машина, отображающая второй шарик.
*'''Третий шарик''' - машина, отображающая третий шарик.

'''Машины могут иметь состояния:'''
*'''shot''' - выстрел.
*'''shot_over''' - окончание выстрела.
*'''swap''' - смена шариков.
*'''swap_over''' - окончание смены шариков.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res (curres)''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Расстояние между шариками (distance)''' - Расстояние между шариками, от которого зависит их количество.
*'''Кол-во шариков в последней линии (last_line_count_bubs)''' - количество шариков, которе будет в последней линии курсора.
*'''Отражения (curlns)''' - максимальное кол-во отражений от стенок.
*'''Коэффициент (curkoef)''' - коэффициент ds/s, где s - базовое расстояние между шариками, ds - его наращивание.
*'''минимальный скейл (curminsc)''' - минимальный скейл графики шариков
*'''максимальный скейл (curmaxsc)''' - максимальный скейл графики шариков
*'''время скалирования (cursctm)''' - время скалирования шариков

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего шарика (x,y)''' - Позиция стреляющего шарика (x,y)
*'''Позиция следующего шарика (x,y)''' - Позиция следующего шарика (x,y).
*'''Позиция 3-го шарика (x,y)''' - Позиция 3-го шарика (x,y).
*'''третий шарик (n3bub)''' - если 0 - 3-го шарика не будет, 1 - есть третий шарик.
*'''Коэффициент вероятности цветов''' - коэффициент вероятности цветов.
*'''Расстояние от следующего шарика''' - расстояние от следующего шарика.
*'''Скорость наезда для режима Bubblez''' - скорость наезда для режима Bubblez.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Скейл шариков для снукера''' - скейл шариков для снукера.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления рядов''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Color mapping''' - Color mapping включён (0 - нет, 1 - да).
*'''Тип рандома''' - Тип рандома. Простой - берём случайный из всех цветов, Супер Рандом - супер алгоритм, Из набора - формируем набор из n шариков и перемешиваем.
*'''Количество цвета для набора''' - количество цвета для формирования набора в рандоме (касается типа рандома "Из набора").
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''Файл трекинга''' - Файл трекинга формата .xml.
*'''Таблица трекинга''' - Таблица трекинга.
*'''Объект новых шариков''' - Объект, которому сообщается о новых шариках.
*'''Мувер''' - Объект, двигающий баббл шутер.
*'''Задержка перед броском''' - задержка перед броском.
*'''Задержка перед обрывом шариков''' - задержка перед обрывом шариков.
*'''К-во секторов для броска''' - Количество секторов для броска.
*'''Слушатель движения мыши''' - объект, слушатель движения мыши.
*'''Слушатель броска''' - объект, слушатель броска. По сути вызывается только состояние st1.
*'''Слушатель движения поля''' - объект, слушатель движения поля. Должен иметь состояния move (поле двигается) и move_over (окончание движения поля).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''Феерверк после победы''' - Включить феерверк из шариков сразу после победы (0 - нет, 1 - да).

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Очковая система=
*'''Тип''' - ''classic'' (1+2+3+4...), ''new'' (n * (n + 1) / 2 * coef * k), ''Xkoef'' (x * n * k * coef), где n - к-во сматченных шариков, k - номер удачного выстрела в серии, coef - коэффициент, x - очки за шарик.
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''коеф для матча (xkoef)''' - (xkoef_match_coef) коэффициент очков для матча.
*'''коеф для обвала (xkoef)''' - (xkoef_drop_coef) коэффициент очков для обвала.
*'''коеф для бустера (xkoef)''' - (xkoef_booster_coef) коэффициент очков для матча.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта); (!!! Важно: делать это нужно машинкой, а не кнопкой, чтобы не было инита объекта!)
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

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

===[[Файл:+.png]] Визцализатор целей===
*'''Заглушки''' - заглушки.
*'''Индикаторы''' - индикаторы.
*'''Каунтеры''' - каунтеры.

===[[Файл:+.png]] Параметры эффекта для специальных шариков===
*'''Этими параметрами можно пользоваться вместо "параметры анимации для шарика"'''
*'''Тип специального шарика''' - тип специального шарика (лунка, колючка, снежинка, вредитель, шарик из двух половинок, камень, целевой шарик, хищник, призрак, шестеренка, туман, портал, целевой шарик призрак, огонь, молния, под огнем).
*'''Эффект''' - Машинка, которая будет получать события:
**'''beg''' - начало эффекта.
**'''hit''' - попадание (есть матч).
**'''miss''' - промах (нет матча).
**'''match_around''' - сматчились шарики рядом.
**'''shot''' - выстрел.
**'''destroy''' - уничтожение эффекта.
**'''end''' - окончание эффекта (вызывается после destroy).
*'''Смещение эффекта''' - смещение эффекта относительно шарика.
*'''Количество действий''' - количество действий (попаданий, выстрелов, промахов), после которых специальный шарик начнет некую обработку (например огонь перекинется на другой шарик).
*'''Действие''' - действие (нет, выстрел, попадание, промах).
*'''Задержка перед destroy''' - время перед уничтожением эффекта.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек. Возможные значения F - functionality в файле уровня:
**'''0''' - обычный шарик
**'''1''' - лунка (попавший в нее шарик "проваливается")
**'''2''' - колючка (попавший в нее шарик просто лопается и матч не просчитывается)
**'''3''' - снежинка (при попадании в нее или схлопывании шарика рядом тает и превращается в обычный шарик)
**'''4''' - вредитель (увеличит уровень залочки шарика на один; шарик выбирается по алгоритму закрашивания)
**'''5''' - шарик из двух половинок; при матче с одной половинкой шарик лопается
**'''6''' - камень (не матчится, не опадает, не двигается, от него отскакивают шарики)
**'''7''' - целевой шарик (когда все такие шарики убиваются или обваливаются, игра считается выиграна)
**'''8''' - хищник (съедает шарик; отличается от лунки наличием анимации и убиваемостью)
**'''9''' - призрак (то же, что и снежинка, но у снежинки цвет задан изначально, а призрак его обретает после матча)
**'''A''' - шестеренка (при попадании в нее начинает двигаться по горизонтали и убивать шарики на пути)
**'''B''' - туман (шар с туманом, при попадании туман пропадает на определенное количество действий)
**'''C''' - портал (имеет два входа-выхода, обозначенных цветом по контуру портала. При попадании шаром в один из входов-выходов, шар вылетает из другого, продолжая траекторию движения)
**'''D''' - целевой шарик призрак (сначала действует как призрак, потом как целевой шарик)
**'''E''' - огонь (при попадании шар воспломеняется. после определенного количество действий шар сгорает и "заражает" огнем соседний верхний шар)
**'''F''' - молния (при попадании лопает все шары по горизонтальной линии)
**'''16''' - замароженость
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Параметры анимации для шарика хищник===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика (уменьшение по скейлу).
*'''Время жизни''' - время жизни эффекта.
*'''Клип''' - анимация съедания шарика.

===[[Файл:+.png]] Параметры анимации для шарика шестеренка===
*'''Скорость''' - скорость движения.
*'''Клип влево''' - клип движения влево.
*'''Клип вправо''' - клип движения вправо.

===[[Файл:+.png]] Параметры анимации для залоченного шарика===
*'''Эффект''' - эффект.
*'''Задержка удаления эффекта''' - задержка удаления эффекта.

===[[Файл:+.png]] Параметры анимации для шарика туман===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика огонь===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''Эффект цели''' - эффект цели.
*'''Эффект цели - смещение''' - эффект цели - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика молния===
*'''Время жизни''' - время жизни эффекта.
*'''Эффект центральный''' - центральный эффект молнии.
*'''Эффект промежуточный''' - промежуточный эффект молнии.
*'''Эффект краевой''' - краевой эффект молнии.
*'''Звук''' - звук молнии.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.
*'''PredatorD''' - Расстояние в диаметрах между летящим шариком и хищником, при котором они взаимодействуют (0 - дефолтное взаимодействие).
*'''vel_bang_bubbles''' - Скорость разлетающихся шариков после взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

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

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

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

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

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] бустер радужный шар: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] бустер радужный шар: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

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

===[[Файл:+.png]] сгорел целевой шарик: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] обвал шариков: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить. Количество обвалившихся шариков пишется в параметр '''bubbles_left'''
*'''состояние''' - Новое состояние объект.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Примечания=
*Если нужно изменить номер фрейма шариков перед запуском уровня, это лучше делать в машинке на том же экране, где находится сам объект. Объект Бабблшутер уже должен быть проинициализирован к этому времени, чтобы избежать падений. После изменения номера фрейма (параметр res%N%Frame) нужно передать Бабблшутеру состояние update_params.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble.rar

=Пример реализации: задание уровня=

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

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter NEW

2019-09-30T08:55:49Z

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

Machine

2019-02-12T14:58:33Z

Akovinenko: /* Добавляемые параметры для LUA */

{{TOC right}}
[[Machine]] - [[Object|объект]] '''машина состояний''' (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]]''' - ускоренное движение;
** '''[[#rgb|rgb]]''' - изменить rgb-каналы;
** '''[[#spline|spline]]''' - движение по сплайну (по кривой).
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#touch_up|touch_up]]''' - отжатие мыши от машины;
** '''[[#tap|tap]]''' - умный тач;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

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

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

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

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

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

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

Все параметры доступны из LUA скрипта, привязанного к машинке.

Далее во всех параметрах присутствуют:

имя (name) - имя параметра, по которому он будет браться из скрипта.

значение (val) - значение, которое прилетит в скрипт.

описание (dsc) - описание параметра. Просто хинт для параметра, нигде не используется.

* '''параметр для lua скрипта (строка)''' - строка, которая доступна из LUA скрипта через viewer.getParamS("param_name", [default]).
* '''параметр для lua скрипта (целое)''' - целое число, которое доступно из LUA скрипта через viewer.getParamI("param_name", [default]).
* '''параметр для lua скрипта (дробное)''' - дробное число, которое доступно из LUA скрипта через viewer.getParamF("param_name", [default]).
* '''параметр для lua скрипта (id ресурса)''' - ресурс (перетаскивается из базы ресурсов), id доступен из LUA скрипта через viewer.getParamI("param_name", [default]).
* '''параметр для lua скрипта (id звука)''' - звук (перетаскивается из базы ресурсов), id доступен из LUA скрипта через viewer.getParamI("param_name", [default]).
* '''параметр для lua скрипта (id видео)''' - видео (перетаскивается из базы ресурсов), id доступен из LUA скрипта через viewer.getParamI("param_name", [default]).
* '''параметр для lua скрипта (id объекта)''' - объект из layout, id доступен из LUA скрипта через viewer.getParamI("param_name", [default]).
* '''параметр для lua скрипта (массив id объектов)''' - объекты из layout (добавляются через окошко, которое появляется при двойном нажатии на параметр), массив id доступен из LUA скрипта через viewer.getParamArrI("param_name", [default]).

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

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

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

=== draw ===

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

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

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

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

=== init ===

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

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

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

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

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

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

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

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

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

=== set ===

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

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

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

=== play ===

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

*'''snd''' - Короткий звук (перетаскивается из редактора ресурсов);
*'''voice''' - Голос (перетаскивается из редактора ресурсов);
*'''mus''' - Длинный звук (перетаскивается из редактора ресурсов);
*'''mus_field''' - Проиграть длинную музыку, id взяв из переменной машины, указанной в этом поле; (К примеру у машины есть параметр location_music=="7695" и в mus_field="location_music". То машина проиграет длинную музыку с id 7695)
*'''preload''' - Указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом;
*'''loop''' - Зациклить указанный звук. Использовать вместе с snd или voice;
*'''mus_loop''' - Зациклить указанную музыку. По умолчанию музыка всегда зацикленна. То есть, фактически этой флаг используется, когда нужно убрать зацикливание.
*'''repeat''' - Число повторов указанного звука при отключенном loop;
*'''mus_stop''' - Остановить музыку. Если используется вместе с mus, то остановится указанная. Если нет - то вся текущая.
*'''stop''' - Остановить указанный звук. Использовать вместе с snd или voice.
*'''mus_fading''' - Время появления/затухания указанной музыки в ms. Использовать вместе с mus.
*'''fading''' - Время появления/затухания указанного звука. Использовать вместе с snd или voice.
*'''volume''' - Установить громкость для всех звуков данной машины - тех что уже играют и тех, что будут запущены впоследствии;
*'''не выгружать''' - Позволяет продолжать проигрывание звука при смене экранов.
*'''go''' - Выбор состояния, в которое нужно перейти после проигрывания музыки/звука/голоса.
*'''if''' - Номер (начиная с нуля) условия перехода [[#if|if]].

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

1) Короткий звук (''snd'') нельзя запустить в первом (инитном) состоянии машины. Для того, чтобы запустить звук сразу при загрузке экрана, нужно в первом состоянии машины записать мгновенный переход во второе состояние мамашины (например, команда ''wait'', поле ''go'', в поле выбрать второе состояние), а во втором состоянии уже запустить звук.

2) Если звук нужно зациклить и проигрывать какое-то количество раз (''loop=1,2,3,..,n'') или бесконечно (''loop=-1''), то нужно проследить чтобы состояние, в котором запускается звук, не вызывалось повторно во время проигрывания звука, иначе возникнет наложение звуков.

3) Если во время проигрывания звука машина меняет свое состояние, звук продолжает играть.

4) Если в одной машине почти одновременно воспроизводится несколько звуков, то они прерывают друг друга.

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

6) Если не указан звук и голос, то команда (''stop'') остановит все звуки, запущенные этой машиной.

7) Музыка (''mus'') может быть формата .ogg или .mp3. На экране может воспроизводится только одна .mp3 музыка. Любой запуск .mp3 музыки независимо от того, в какой машине он осуществляется, будет прекращать проигрывание предыдущей .mp3 музыки. В тоже время может воспроизводиться несколько .ogg музыки.

8) Музыка, которая проигрывается на глобальном экране, проигрывается на всех экранах проекта.

=== var ===

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

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

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

=== buy ===

'''(in-app совершить in-app покупку)'''

При переходе в состояние, данная команда открывает системное окно с предложением совершить 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 на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.
Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект. Можно указывать переменные заданные с помощью [http://ge.absolutist.com/index.php/Machine#var_2 переменной var];
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются); можно задавать смесь tx, dy или dx,ty;
* '''v''' - скорость перемещения в пикселях в секунду; для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость;
* '''t''' - время перемещения (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду move, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

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

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

=== rot ===

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

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

=== alpha ===

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

Если у объекта прозрачность ''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 на этой команде (запустить их сново можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

=== phys ===

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

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''a''' - полное ускорение
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду phys, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''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), до которой мяч должен подпрыгнуть.

=== rgb ===

* '''trgb''' - целевой эффект rgb; подразумевает под собой цвет в виде HEX-кода; по-умолчанию: FFFFFF;
* '''t''' - длительность выполнения команды в ms;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

=== spline ===

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

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

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

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

# в состоянии машины добавляем правой кнопкой мыши действие "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;
* '''maxVel''' - Максимальная скорость вращения градус/сек;
* '''objStart''' - объект при начале вращения;
* '''stStart''' - его новое состояние;
* '''objEnd''' - объект при завершении вращения;
* '''stEnd''' - его новое состояние;
'''''Замечание.''''' ('''dragRot''') и обычный ('''drag''') не работает если сцена таскаемая.

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

====Использование свойства "Условие перехода" ====

Можно прописать условие, при котором выполняется переход при дропе.
[[Файл:Drop_if.png|300px|thumb|right]]

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

Для того, чтобы научить машину различать клик по ней и ее таскание сделаем следующее. Пропишем ей 2 состояния: click и drag, а также выставим ей параметр "хранить нажатость" = 1. В click будем вычислять координаты объекта и записывать объекту параметр допустимого смещения при котором таскание будет восприниматься как клик. (В данном примере эти параметры: cx, cy, vx, vy. А допустимое смещение составляет 10 пикселей.)

В состоянии drag будем проверять попадает ли координата объекта при дропе в границы допустимого смещения. Для того чтобы сравнить параметр объекта с переменной, вычтем из нашего объекта, то что мы записали в click. В зависимости от условий и места дропа переходим в соответствующее состояние.

[[Файл:Click.png|330px]] [[Файл:Drag st.png|630px]]

=== throw ===

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

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

=== tap ===

* '''go''' - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

=== apply ===

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

[[Файл:Screen_apply.jpg|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.

'''!!!Важно:''' нужно использовать полную скобочную структуру : "((1&2)&3)" - правильно, "1,2,3" - не правильно ( не гарантируется 100% адекватная работа).

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

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

Параметры команды:
* '''obj''' - находится ли объект obj в состоянии st или имеет ли его параметр par значение val. В этом поле можно указать this, это значит что if будет проводить проверку текущего объекта. Добавлено это вместе с параметром clone. Клоны рождаются и умирают в рамках одного экрана. Для различия клонов между собой машина имеет уникальный параметр "clone_num" у оригинала = -1, у клонов от 0 до N, собственно с помощью this машина может сама себя проверить клон ли она и если да то какой у нее номер;
* '''st''' - имя состояния в котором может находиться объект obj;
* '''par''' - имя параметра объекта obj, значение которого сравнивается с полем val;
* '''val''' - значение параметра par, которое проверяется у объекта obj;
* '''val_txt''' - Значение текстового параметра объекта для проверки условия;
* '''val_res''' - Значение ресурсного параметра объекта для проверки условия;
* '''val_obj''' - Значение id объекта для проверки условия;
* '''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''' - валиден (правилен и может быть запущен) ли данный интернет-адрес; на ios ссылка должна выглядеть так comabsolutisttwilighttown://, т.е. в конце ссылки добавляем ://
* '''is_mus''' - играет ли сейчас музыка (значение 1);
* '''guest''' - объект который установил состояние (используется вместо параметра obj). Если указанный объект не менял состояние этой машины, то условие не срабатывает.

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

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

У машины (другой или самой себя) можно проверить текущее состояние '''st''' и предыдущее состояние '''prev_st''', эти параметры живут на время сессии.

== Математика ==

=== Основные математические операции ===
Математика в appsalute creator представлена 6-ю основными операциями: (плюс), (минус), (умножить), (поделить), (целочисленное деление), (остаток от деления) 
Организована благодаря совместному использованию '''[[#var|var]]''' и '''[[#set|set]]'''.
[[Файл:Example_mod.png|300px|right|Пример использования операции остатка от деления]]
''(плюс)'' '''+''' 
''(минус)'' '''-''' 
''(умножить)'' '''*''' 
''(поделить)'' '''/''' 
''(целочисленное деление)'' '''\''' 
''(остаток от деления)'' '''%''' 
 
Примеры использования последних двух операций: 
5\2=2 
5%2=1 

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

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

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

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

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

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

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

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

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

== Guest ==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

== Clone ==
Clone - параметр команды init в разделе "системные действия".

[[Файл:Clone1.PNG]]

Значение 1 означает, что в текущем местоположении машины будет создана ее копия.

[[Файл:Clone2.PNG]]

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

1) Клонированная машина состояний имеет все свойства, состояния и параметры исходного объекта клонирования.

2) Клоны рождаются и умирают в рамках одного экрана.

3) Клоны отличаются друг от друга лишь параметром '''clone_num''', который у оригинала равен "-1", а у клонов от 0 до N.

4) Нежелательно применять клонирование к клону во избежание путаницы значений параметра '''clone_num'''.

5) Если при проверке условия [[#if|if]] в поле '''obj''' указать this, это значит что if будет проводить проверку текущего объекта. Таким образом машина может сама себя проверить по параметру '''clone_num''' клон ли она и если да то какой у нее номер;

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

По ссылке пример использования с подробным описанием машин.

[http://fs5.absolutist.com/files/wikisample/Clone.zip Download]

== Параметр команды машины состояний ==

В случае, когда необходимо изменить значение какого-либо параметра в командах машины состояний (например v в команде move) в процессе работы приложения, можно использовать блок "Параметр команды машины состояний" в команде ''set'' машины состояний. Приведу пример использования этого блока.

Пусть есть 2 машины: управляющая и управляемая.

[[Файл:Stm1.jpg|300px]][[Файл:Stm2.jpg|300px]]

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

В первом состоянии "wait" мы пытаемся изменить скорость движения управляемой машины. Для этого указали объект (sun), состояние в котором хотим поменять параметр (у машины sun это состояние move), имя команды в которой меняем параметр (в данном случае это move), номер команды (если таких команд несколько, то нужно указать порядковый номер начиная с 0; в нашем случае команда одна), имя параметра (мы хотим изменить скорость, поэтому имя параметра v) и значение (указали значение 200). После этого переходим в следующее состояние.

В состоянии "1" управляющей машины сначала мы вывели объект sun из состояния move, изменили параметр целевой координаты x на 512 и затем вернули в состояние move, чтобы применить изменения параметров. Таким образом управляемая машина начала движение в x=512 со скоростью 200. Через 2 секунды мы переводим управляющую машину в состояние "2", где аналогичным образом изменяется целевая координата на -512.

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

==Запись в viewer.log ==

Во время работы приложения, машина состояний может писать информацию о своей работе в viewer.log. Для этого параметр '''Level''', в разделе '''[GameTrace]''' файла '''app.icf''' должен быть выставлен в значение '''Verbose'''.

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

Ниже приведен пример записи из viewer.log. Жирным шрифтом выделено полезную информацию.

*Machine::state() state machine '''stat_google_gold (id:30818)''' from '''enough_coins''' to '''enough_coins''' through object '''c_current_gold (id:8807)''' from state '''inc''' - машина с именем и id: '''stat_google_gold (id:30818)''' перешла из состояния: '''enough_coins''' в: '''enough_coins'''; ее состояние изменил объект с именем и id: '''c_current_gold (id:8807)''' из состояния: '''inc'''.
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:17''' - машина с id '''(id:28076)''' начала выполнять команду '''set id:17'''; сначала проверяется истинно ли условие выполнения команды (if).
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) '''checkIf(0)=no''' - имеем некоторое сложное условие, проверяем его составляющие; if(0) не выполняется (имеет значение false).
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) '''checkIf(1)=yes''' - условие if(1) выполняется (имеет значение true).
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) '''checkIf(2)=yes''' - условие if(2) выполняется (имеет значение true).
*GMachine::Command::checkIf() GMachine'''(id:28076)'''::Command::'''checkIf id:17 expr:((0|(!1))|(!2)) res:false''' - проверяется все выражение; общий результат false, set(17) не выполняется.
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:18''' - машина с id '''(id:28076)''' начала выполнять команду '''set id:18''', в данном set условие if отсутствует.
*GMachine::Command::checkIf() GMachine'''(id:28076)'''::Command::'''checkIf id:18 expr: res:true''' - в команде set(18) условие '''checkIf id:18 expr: res:true''' есть истинно (точнее - не есть ложным, так как оно отсутствует); set(18) будет выполнен.
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:18 checkIf success''' - проверка условия прошла успешно, выполняем set(18).
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:18 obj:16039 -> par:param_name val:bundle_coins us:0''' - результат выполнения set(18) - объекту '''obj:16039''' устанавливаем параметр '''par:param_name val:bundle_coins''' равным '''us:0'''.
*GMachine::Command::getVarValue() Command::'''getVarValue(bundle_item): float result = 0.00''' - вычитываем переменную с помощью команды var; вычитываем параметр '''bundle_item''', результат операции '''float result = 0.00'''.
*GMachine::Set::init() Set::init: Expression: '''(bundle_coins)=0.000000(float)''' - используем значение переменной в команде set; переменная вчитывается в момент обращения к ней из другой команды (set, move и др.).

==Использование скриптов Lua ==
В машине состояний можно использовать скрипты [[Lua]]

==Окно==
В свойствах машины состояний есть 2 новых поля:
*'''окно''' - если ''да'', то машина считает себя окном. При включении данного параметра с момента постановки окна в очередь ''statesmanager'а'' и до вызова ''back'' в текущей машине блокируются внешние воздействия и переход между состояниями.
*'''тип окна''' - обычное; по альфе - при открытии отключает все нижние сцены по альфе; с фото - при открытии отключает все нижние сцены по альфе, предварительно делая фото этих сцен. Выключение сцен ''по альфе'' и ''с фото'' используются для больших окон основной очереди.
[[mwindow]]

[[Category:Main objects]]

Machine

2019-02-12T14:58:15Z

Akovinenko: /* Свойства */

{{TOC right}}
[[Machine]] - [[Object|объект]] '''машина состояний''' (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]]''' - ускоренное движение;
** '''[[#rgb|rgb]]''' - изменить rgb-каналы;
** '''[[#spline|spline]]''' - движение по сплайну (по кривой).
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#touch_up|touch_up]]''' - отжатие мыши от машины;
** '''[[#tap|tap]]''' - умный тач;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

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

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

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

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

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

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

Все параметры доступны из LUA скрипта, привязанного к машинке.
Далее во всех параметрах присутствуют:
имя (name) - имя параметра, по которому он будет браться из скрипта.
значение (val) - значение, которое прилетит в скрипт.
описание (dsc) - описание параметра. Просто хинт для параметра, нигде не используется.

* '''параметр для lua скрипта (строка)''' - строка, которая доступна из LUA скрипта через viewer.getParamS("param_name", [default]).
* '''параметр для lua скрипта (целое)''' - целое число, которое доступно из LUA скрипта через viewer.getParamI("param_name", [default]).
* '''параметр для lua скрипта (дробное)''' - дробное число, которое доступно из LUA скрипта через viewer.getParamF("param_name", [default]).
* '''параметр для lua скрипта (id ресурса)''' - ресурс (перетаскивается из базы ресурсов), id доступен из LUA скрипта через viewer.getParamI("param_name", [default]).
* '''параметр для lua скрипта (id звука)''' - звук (перетаскивается из базы ресурсов), id доступен из LUA скрипта через viewer.getParamI("param_name", [default]).
* '''параметр для lua скрипта (id видео)''' - видео (перетаскивается из базы ресурсов), id доступен из LUA скрипта через viewer.getParamI("param_name", [default]).
* '''параметр для lua скрипта (id объекта)''' - объект из layout, id доступен из LUA скрипта через viewer.getParamI("param_name", [default]).
* '''параметр для lua скрипта (массив id объектов)''' - объекты из layout (добавляются через окошко, которое появляется при двойном нажатии на параметр), массив id доступен из LUA скрипта через viewer.getParamArrI("param_name", [default]).

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

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

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

=== draw ===

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

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

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

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

=== init ===

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

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

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

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

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

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

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

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

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

=== set ===

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

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

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

=== play ===

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

*'''snd''' - Короткий звук (перетаскивается из редактора ресурсов);
*'''voice''' - Голос (перетаскивается из редактора ресурсов);
*'''mus''' - Длинный звук (перетаскивается из редактора ресурсов);
*'''mus_field''' - Проиграть длинную музыку, id взяв из переменной машины, указанной в этом поле; (К примеру у машины есть параметр location_music=="7695" и в mus_field="location_music". То машина проиграет длинную музыку с id 7695)
*'''preload''' - Указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом;
*'''loop''' - Зациклить указанный звук. Использовать вместе с snd или voice;
*'''mus_loop''' - Зациклить указанную музыку. По умолчанию музыка всегда зацикленна. То есть, фактически этой флаг используется, когда нужно убрать зацикливание.
*'''repeat''' - Число повторов указанного звука при отключенном loop;
*'''mus_stop''' - Остановить музыку. Если используется вместе с mus, то остановится указанная. Если нет - то вся текущая.
*'''stop''' - Остановить указанный звук. Использовать вместе с snd или voice.
*'''mus_fading''' - Время появления/затухания указанной музыки в ms. Использовать вместе с mus.
*'''fading''' - Время появления/затухания указанного звука. Использовать вместе с snd или voice.
*'''volume''' - Установить громкость для всех звуков данной машины - тех что уже играют и тех, что будут запущены впоследствии;
*'''не выгружать''' - Позволяет продолжать проигрывание звука при смене экранов.
*'''go''' - Выбор состояния, в которое нужно перейти после проигрывания музыки/звука/голоса.
*'''if''' - Номер (начиная с нуля) условия перехода [[#if|if]].

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

1) Короткий звук (''snd'') нельзя запустить в первом (инитном) состоянии машины. Для того, чтобы запустить звук сразу при загрузке экрана, нужно в первом состоянии машины записать мгновенный переход во второе состояние мамашины (например, команда ''wait'', поле ''go'', в поле выбрать второе состояние), а во втором состоянии уже запустить звук.

2) Если звук нужно зациклить и проигрывать какое-то количество раз (''loop=1,2,3,..,n'') или бесконечно (''loop=-1''), то нужно проследить чтобы состояние, в котором запускается звук, не вызывалось повторно во время проигрывания звука, иначе возникнет наложение звуков.

3) Если во время проигрывания звука машина меняет свое состояние, звук продолжает играть.

4) Если в одной машине почти одновременно воспроизводится несколько звуков, то они прерывают друг друга.

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

6) Если не указан звук и голос, то команда (''stop'') остановит все звуки, запущенные этой машиной.

7) Музыка (''mus'') может быть формата .ogg или .mp3. На экране может воспроизводится только одна .mp3 музыка. Любой запуск .mp3 музыки независимо от того, в какой машине он осуществляется, будет прекращать проигрывание предыдущей .mp3 музыки. В тоже время может воспроизводиться несколько .ogg музыки.

8) Музыка, которая проигрывается на глобальном экране, проигрывается на всех экранах проекта.

=== var ===

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

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

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

=== buy ===

'''(in-app совершить in-app покупку)'''

При переходе в состояние, данная команда открывает системное окно с предложением совершить 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 на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.
Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект. Можно указывать переменные заданные с помощью [http://ge.absolutist.com/index.php/Machine#var_2 переменной var];
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются); можно задавать смесь tx, dy или dx,ty;
* '''v''' - скорость перемещения в пикселях в секунду; для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость;
* '''t''' - время перемещения (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду move, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

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

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

=== rot ===

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

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

=== alpha ===

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

Если у объекта прозрачность ''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 на этой команде (запустить их сново можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

=== phys ===

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

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''a''' - полное ускорение
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду phys, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''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), до которой мяч должен подпрыгнуть.

=== rgb ===

* '''trgb''' - целевой эффект rgb; подразумевает под собой цвет в виде HEX-кода; по-умолчанию: FFFFFF;
* '''t''' - длительность выполнения команды в ms;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

=== spline ===

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

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

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

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

# в состоянии машины добавляем правой кнопкой мыши действие "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;
* '''maxVel''' - Максимальная скорость вращения градус/сек;
* '''objStart''' - объект при начале вращения;
* '''stStart''' - его новое состояние;
* '''objEnd''' - объект при завершении вращения;
* '''stEnd''' - его новое состояние;
'''''Замечание.''''' ('''dragRot''') и обычный ('''drag''') не работает если сцена таскаемая.

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

====Использование свойства "Условие перехода" ====

Можно прописать условие, при котором выполняется переход при дропе.
[[Файл:Drop_if.png|300px|thumb|right]]

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

Для того, чтобы научить машину различать клик по ней и ее таскание сделаем следующее. Пропишем ей 2 состояния: click и drag, а также выставим ей параметр "хранить нажатость" = 1. В click будем вычислять координаты объекта и записывать объекту параметр допустимого смещения при котором таскание будет восприниматься как клик. (В данном примере эти параметры: cx, cy, vx, vy. А допустимое смещение составляет 10 пикселей.)

В состоянии drag будем проверять попадает ли координата объекта при дропе в границы допустимого смещения. Для того чтобы сравнить параметр объекта с переменной, вычтем из нашего объекта, то что мы записали в click. В зависимости от условий и места дропа переходим в соответствующее состояние.

[[Файл:Click.png|330px]] [[Файл:Drag st.png|630px]]

=== throw ===

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

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

=== tap ===

* '''go''' - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

=== apply ===

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

[[Файл:Screen_apply.jpg|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.

'''!!!Важно:''' нужно использовать полную скобочную структуру : "((1&2)&3)" - правильно, "1,2,3" - не правильно ( не гарантируется 100% адекватная работа).

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

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

Параметры команды:
* '''obj''' - находится ли объект obj в состоянии st или имеет ли его параметр par значение val. В этом поле можно указать this, это значит что if будет проводить проверку текущего объекта. Добавлено это вместе с параметром clone. Клоны рождаются и умирают в рамках одного экрана. Для различия клонов между собой машина имеет уникальный параметр "clone_num" у оригинала = -1, у клонов от 0 до N, собственно с помощью this машина может сама себя проверить клон ли она и если да то какой у нее номер;
* '''st''' - имя состояния в котором может находиться объект obj;
* '''par''' - имя параметра объекта obj, значение которого сравнивается с полем val;
* '''val''' - значение параметра par, которое проверяется у объекта obj;
* '''val_txt''' - Значение текстового параметра объекта для проверки условия;
* '''val_res''' - Значение ресурсного параметра объекта для проверки условия;
* '''val_obj''' - Значение id объекта для проверки условия;
* '''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''' - валиден (правилен и может быть запущен) ли данный интернет-адрес; на ios ссылка должна выглядеть так comabsolutisttwilighttown://, т.е. в конце ссылки добавляем ://
* '''is_mus''' - играет ли сейчас музыка (значение 1);
* '''guest''' - объект который установил состояние (используется вместо параметра obj). Если указанный объект не менял состояние этой машины, то условие не срабатывает.

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

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

У машины (другой или самой себя) можно проверить текущее состояние '''st''' и предыдущее состояние '''prev_st''', эти параметры живут на время сессии.

== Математика ==

=== Основные математические операции ===
Математика в appsalute creator представлена 6-ю основными операциями: (плюс), (минус), (умножить), (поделить), (целочисленное деление), (остаток от деления) 
Организована благодаря совместному использованию '''[[#var|var]]''' и '''[[#set|set]]'''.
[[Файл:Example_mod.png|300px|right|Пример использования операции остатка от деления]]
''(плюс)'' '''+''' 
''(минус)'' '''-''' 
''(умножить)'' '''*''' 
''(поделить)'' '''/''' 
''(целочисленное деление)'' '''\''' 
''(остаток от деления)'' '''%''' 
 
Примеры использования последних двух операций: 
5\2=2 
5%2=1 

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

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

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

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

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

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

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

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

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

== Guest ==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

== Clone ==
Clone - параметр команды init в разделе "системные действия".

[[Файл:Clone1.PNG]]

Значение 1 означает, что в текущем местоположении машины будет создана ее копия.

[[Файл:Clone2.PNG]]

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

1) Клонированная машина состояний имеет все свойства, состояния и параметры исходного объекта клонирования.

2) Клоны рождаются и умирают в рамках одного экрана.

3) Клоны отличаются друг от друга лишь параметром '''clone_num''', который у оригинала равен "-1", а у клонов от 0 до N.

4) Нежелательно применять клонирование к клону во избежание путаницы значений параметра '''clone_num'''.

5) Если при проверке условия [[#if|if]] в поле '''obj''' указать this, это значит что if будет проводить проверку текущего объекта. Таким образом машина может сама себя проверить по параметру '''clone_num''' клон ли она и если да то какой у нее номер;

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

По ссылке пример использования с подробным описанием машин.

[http://fs5.absolutist.com/files/wikisample/Clone.zip Download]

== Параметр команды машины состояний ==

В случае, когда необходимо изменить значение какого-либо параметра в командах машины состояний (например v в команде move) в процессе работы приложения, можно использовать блок "Параметр команды машины состояний" в команде ''set'' машины состояний. Приведу пример использования этого блока.

Пусть есть 2 машины: управляющая и управляемая.

[[Файл:Stm1.jpg|300px]][[Файл:Stm2.jpg|300px]]

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

В первом состоянии "wait" мы пытаемся изменить скорость движения управляемой машины. Для этого указали объект (sun), состояние в котором хотим поменять параметр (у машины sun это состояние move), имя команды в которой меняем параметр (в данном случае это move), номер команды (если таких команд несколько, то нужно указать порядковый номер начиная с 0; в нашем случае команда одна), имя параметра (мы хотим изменить скорость, поэтому имя параметра v) и значение (указали значение 200). После этого переходим в следующее состояние.

В состоянии "1" управляющей машины сначала мы вывели объект sun из состояния move, изменили параметр целевой координаты x на 512 и затем вернули в состояние move, чтобы применить изменения параметров. Таким образом управляемая машина начала движение в x=512 со скоростью 200. Через 2 секунды мы переводим управляющую машину в состояние "2", где аналогичным образом изменяется целевая координата на -512.

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

==Запись в viewer.log ==

Во время работы приложения, машина состояний может писать информацию о своей работе в viewer.log. Для этого параметр '''Level''', в разделе '''[GameTrace]''' файла '''app.icf''' должен быть выставлен в значение '''Verbose'''.

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

Ниже приведен пример записи из viewer.log. Жирным шрифтом выделено полезную информацию.

*Machine::state() state machine '''stat_google_gold (id:30818)''' from '''enough_coins''' to '''enough_coins''' through object '''c_current_gold (id:8807)''' from state '''inc''' - машина с именем и id: '''stat_google_gold (id:30818)''' перешла из состояния: '''enough_coins''' в: '''enough_coins'''; ее состояние изменил объект с именем и id: '''c_current_gold (id:8807)''' из состояния: '''inc'''.
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:17''' - машина с id '''(id:28076)''' начала выполнять команду '''set id:17'''; сначала проверяется истинно ли условие выполнения команды (if).
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) '''checkIf(0)=no''' - имеем некоторое сложное условие, проверяем его составляющие; if(0) не выполняется (имеет значение false).
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) '''checkIf(1)=yes''' - условие if(1) выполняется (имеет значение true).
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) '''checkIf(2)=yes''' - условие if(2) выполняется (имеет значение true).
*GMachine::Command::checkIf() GMachine'''(id:28076)'''::Command::'''checkIf id:17 expr:((0|(!1))|(!2)) res:false''' - проверяется все выражение; общий результат false, set(17) не выполняется.
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:18''' - машина с id '''(id:28076)''' начала выполнять команду '''set id:18''', в данном set условие if отсутствует.
*GMachine::Command::checkIf() GMachine'''(id:28076)'''::Command::'''checkIf id:18 expr: res:true''' - в команде set(18) условие '''checkIf id:18 expr: res:true''' есть истинно (точнее - не есть ложным, так как оно отсутствует); set(18) будет выполнен.
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:18 checkIf success''' - проверка условия прошла успешно, выполняем set(18).
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:18 obj:16039 -> par:param_name val:bundle_coins us:0''' - результат выполнения set(18) - объекту '''obj:16039''' устанавливаем параметр '''par:param_name val:bundle_coins''' равным '''us:0'''.
*GMachine::Command::getVarValue() Command::'''getVarValue(bundle_item): float result = 0.00''' - вычитываем переменную с помощью команды var; вычитываем параметр '''bundle_item''', результат операции '''float result = 0.00'''.
*GMachine::Set::init() Set::init: Expression: '''(bundle_coins)=0.000000(float)''' - используем значение переменной в команде set; переменная вчитывается в момент обращения к ней из другой команды (set, move и др.).

==Использование скриптов Lua ==
В машине состояний можно использовать скрипты [[Lua]]

==Окно==
В свойствах машины состояний есть 2 новых поля:
*'''окно''' - если ''да'', то машина считает себя окном. При включении данного параметра с момента постановки окна в очередь ''statesmanager'а'' и до вызова ''back'' в текущей машине блокируются внешние воздействия и переход между состояниями.
*'''тип окна''' - обычное; по альфе - при открытии отключает все нижние сцены по альфе; с фото - при открытии отключает все нижние сцены по альфе, предварительно делая фото этих сцен. Выключение сцен ''по альфе'' и ''с фото'' используются для больших окон основной очереди.
[[mwindow]]

[[Category:Main objects]]

Интерфейс ScenceEditor

2018-12-05T08:59:09Z

Akovinenko: /* Экспорт проекта */

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

'''Редактор сцен''' — программа, предназначенная для создания, редактирования и экспорта игровых экранов, в котором происходит настройка свойств объектов и игровой логики. 

'''Окно редактора сцен состоит из:'''
*меню редактора;
*рабочей области, в которой размещен объект сцена, на котором размещают другие объекты;
*панель Лэйаут, в которой размещено иерархическое дерево проекта, которое состоит из экранов, на которых находятся игровые объекты;
*панель Свойства, которая отображает свойства объекта, который выбран в дереве проекта;
*панель для построения сплайна;
*панель инструментов;
*строка Координаты, отображающая координаты курсора в текущий момент времени 

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

[[Файл:Головна2.PNG|700px]]

=== Меню редактора ===

==== Project (Проект)====
меню, которое содержит список команд, с помощью которых можно создать новый или загрузить уже созданный проект, сохранить проект с указанием места сохранения и т.д.
*'''New project''' - создать новый проект;
*'''Open''' - открыть уже созданный проект (проект обязательно должен находится в подкаталоге редактора);
*'''Recent project...''' - показывает список последних открывавшихся проектов;
*'''Close''' - закрытие проекта (редактор при этом не закрывается);
*'''New project''' - создать новый проект;
*'''Save''' - сохранение проекта;
*'''Save as...''' - сохранение проекта под новым именем или в новом каталоге;
*'''Export...''' - экспорт проекта;
*'''Project options...''' - опции проекта;
*'''Exit''' - закрытие редактора.

==== Edit (Редактирование)====
меню редактирования проекта:
*'''Copy''' - копирование объекта;
*'''Paste into current object''' - вставка объекта в выбранный объект;
*'''Paste after current object''' - вставка объекта после выбранного объекта;
*'''Delete...''' - удаление объекта;
*'''Scale object''' - масштабирование выбранного объекта, если у него есть масштаб (scale x \ scale y);
*'''Rotate object''' - поворот выбранного объекта, если у него есть параметр поворота (angle);
*'''Modify vertex''' - изменение положения точек вертекса у выбранного объекта, если вертексы включены;
*'''Find object...''' - поиск объекта по id или по имени;
*'''Setup Editor...''' - настройки редактора.

[[Файл:SetupEditor.png|right|400px]]

1) Языки - выбор языка редактора.

2) Work mode - выбор режима работы.

3) Syles - выбор темы редактора.

4) Перемещение сцены мышью или клавишами клавиатуры - позволяет перемещать сцену на экране.

5) Рисовать сетку на экране - отображать сетку на экране или нет.

6) Utilities - Подключение утилит.

В редакторе есть возможность подключения утилит в форматах *.bat, *.exe, *.py, *.pyw, *.vbs.

Для примера, подключим bat-файл, открывающий логи вьвера в notepad++.

Для этого создадим файл Logs.bat со следущими командами:

cd C:\Users\<your-user>\AppData\Roaming\Absolutist\Viewer

start "C:\Program Files (x86)\Notepad++\notepad++.exe" "viewer.log"

В настройки редактора добавим утилиту нажав на плюсик. В списке ниже появится поле добавленной утилиты.

Нажмем на многоточие в столбце "Browse". В открывшимся окне "Open utility" откроем Logs.bat файл. После этого в меню редактора появится меню "Utilities" с командой Logs.

==== View (Просмотр)====
*'''Toggle grid''' - включает\выключает отображение сетки на сцене;
*'''open/hide comment''' - показывает\скрывает комментарии к объекту;
*'''Disable object movements''' - выключает\включает возможность перемещать объекты по сцене.

=== Viewer (Вьювер) ===
*'''Start Viewer''' - запуск вьювера;
*'''Start Viewer with changed time''' - запуск вьювера с заданным временем;
*'''Save and run viewer...''' - сохраняет проект и запускает вьювер;
*'''Run Viewer.bat''' - ???;
*'''Delete temp data''' - удаление опций;

====Layouts (Лейаут, Макеты)====
меню работа с лейаутами проекта (выбор макета устройства для проекта, редактирование экранов):
*'''Add new layout...''' - создание нового лейаута;
*'''Delete layout...''' - удаление лейаута;
*'''Layout settings...''' - настройки лейаута;
*'''Add folder...''' - создание папки в текущем лейаута;
*'''Add screen...''' - создание нового экрана.
==== Tools (Инструменты)====
меню дополнительных редакторов и инструментов для проекта (вызов редактора ресурсов, текстового редактора, анализ проекта). Список этого меню вынесен на панель с кнопками быстрого запуска:
*'''Resources Editor''' - редактор ресурсов;
*'''Texts Editor''' - текстовый редактор;
*'''Analyzer''' - анализатор ресурсов (показывает количество объектов проекта, их размер занимаемой памяти, сведения о ресурсах каждого объекта (размер, ID номер, название (имя), местонахождение в базе ресурсов));
*'''Object info...''' - общие свойства объекта (показывает размер памяти занимаемой текстурами);
*'''Options info...''' - информация об опциях.

==== Help (Помощь)====
меню вызова справки.

=== Кнопки панели Инструменты ===
Некоторые инструменты также вызываются горячими клавишами (комбинация клавиш приведена в скобках )

[[Файл:00 6.png]] (Ctrl+N) — создать новый проект; 
[[Файл:00 7.png]](Ctrl+O) — загрузить уже созданный проект; 
[[Файл:00 8.png]](Ctrl+S) — сохранить изменения в проекте; 
[[Файл:00 9.png]] — запустить Viewer; 
[[Файл:009.JPG]] — нормальный вид; 
[[Файл:Ico_text.png|25px]] - вызов текстового редактора; 
[[Файл:Ico_base.png|25px]] — вызов редактора ресурсов; 
[[Файл:013.JPG]] — анализатор ресурсов (показывает количество объектов проекта, их размер занимаемой памяти, сведения о ресурсах каждого объекта (размер, ID номер, название (имя), местонахождение в базе ресурсов)); 
[[Файл:014.JPG]]— поиск объекта по id или по имени. 

===Функции рабочей области===

'''1) Масштабирование рабочей области '''
Ctrl + колесико мышки крутим вперед - увеличиваем объекты , назад - уменьшаем объекты. 

'''2)Перемещение по рабочей области '''
После масштабирования возникает необходимость переместиться с левого уголка экрана в далекий правый, переместиться к выбраному обьекту, вверх или вниз. 

Кликаем правой кнопкой мыши по горизонтальному scroll и выпадает меню:
*scroll here — функция перемещает экран к объекту, который выделен в Лэйауте;
*scroll left / right - функция перемещает экран на маленькое расстояние вправо / влево;
*left / right edge — функция перемещает экран в левый / правый угол экрана;
*page left / right - функция показывает левую/правую часть экрана 

Кликаем правой кнопкой мыши по вертикальному scroll и выпадает меню:
*scroll here — функция перемещает экран к объекту, который выделен в Лэйауте;
*scroll up / down - функция перемещает экран на маленькое расстояние вверх / вниз;
*top/bottom - функция перемещает экран вверх / вниз;
*page up / down - функция перемещает экран верхнюю / нижнюю часть экрана. 

Меню прокрутки скрывается по нажатию клавиши Alt 

===Функции панели Лэйаут===
[[Файл:Лэйаут_1.JPG|right]]
При клике правой кнопкой мыши по выбранному лэйауту (см. рисунок справа)
*Создать папку в текущем объекте;
*Создать экран в текущем объекте - создание объекта в текущем лэйауте;
*Импорт/экспорт экранов — импорт/экспорт одного или нескольких экранов;
*Развернуть / Свернуть объекты с подобъектами — сворачивает / разворачивает дерево объектов всех экранов 

При клике правой кнопкой мыши по выбранному экрану, сцене или объекту возможно:
*Lock (Unlock) screen - золочивание (разлочивание) экрана: нельзя перемещать, удалять и изменять объекты (сцены) экрана, причем, если сцена расшареная, то она становиться залоченой и на остальных экранах; на залоченых экранах в панели проекта появляется замочек;
*Lock (Unlock) scene - золочивание (разлочивание) сцены: нельзя перемещать, удалять и изменять объекты (машины, картинки и др.) сцены, причем, если сцена расшареная, то она становиться залоченой и на остальных экранах; на залоченых сценах также появляется замочек;
*Создать сцену в текущем объекте - создание экран в текущем экране;
*Создать экран в текущем объекте - создание экран в текущем лэйауте;
*Создать объект сцены в текущем объекте - создание объекта в текущем объекте;
*Удалить объект - удаление объекта из проекта;
*Копировать объект — копирование объекта;
*Вставить в текущий объект — вставка объекта в текущий объект верхнего уровня ;
*Вставить как ссылку в текущий объект — вставка объекта в текущий объект для создания расшареной сцены;
*Вставить как ссылку после текущего объекта — вставка объекта после текущего объекта для создания расшареной сцены;
*Вставить после текущего объекта - вставка объекта после текущего объекта;
*Импорт/экспорт экранов — импорт/экспорт одного или нескольких экранов;
*Развернуть / Свернуть объекты с подобъектами — сворачивает /разворачивает дерево объектов экрана или сцены;

====Функция Расположить сцену в соответствии с изображением ====
Пусть на сцене будет находится очень много картинок, которые должны находиться в строго определенных местах. Переместим нашу картинку в нужную точку на сцене. Но у нас картинок очень много и мы потратим много времени на их расстановку. Для уменьшения времени на расстановку картинок воспользуемся функцией расположить сцену в соответствии с изображением. 
Функция расположить сцену в соответствии с изображением перемещает картинку в заданную точку художниками. Художник решил, что клумба должна быть в правом нижнем углу, после применения функции расположить сцену в соответствии с изображением, картинка станет именно на указанное художником место. 
Данная функция вызывается кликом правой кнопкой мыши по объекту [[Файл:панель_свойства_1.JPG|right]]

===Функции панели Свойства===

*При клике на тип или имя некоторых объектов вызываются дополнительные окна.Например, при клике на тип Machine открывается окно, где прописываются функции объекта типа Machine.
*При наведении на поле тип выпадет подсказка с уникальным номером объекта.
*При клике правой мышкой по названию свойства объекта выпадает меню с дополнительными свойствами объекта
*Некоторые свойства объектов объединены в группы (см. рисунок справа)

=== Создание проекта ===

1. Для создания нового игрового проекта необходимо запустить редактор сцен SceneEditor. 
2. В верхнем меню Проект выбрать Новый (т.е. создать новый проект). 
3. В появившемся окне указываем имя проекта и имя базы ресурсов.Выбираем папку для сохранения проекта 
4. В этом окне выбираем устройство для которого создаётся проект, а затем выбираем тип магазина и вариант версии игры 
[[Файл:020.JPG]] [[Файл:021.JPG]]

5. В редакторе сцен в меню Проект → Сохранить → проект с именем Learning. 
Эту методику действий можно брать за шаблон для создания других проектов. 
Результат: Создана база ресурсов и проект для выполнения Уроков.

====Важное замечание по созданию проекта====
[[Файл:2_лэйаута.JPG|right]] 
Предположим нам необходимо создать игру для магазина А и магазина Б. Игра будет отличаться только 10 функциями. Мы можем создать игру для магазина А., а потом скопировать папку с проектом, проект переименовать, внести изменения и получить игру для магазина Б. Результат: 2 игры и 2 папки с ресурсами. Такой подход не приветствуется. 
Для уменьшения времени на создание проекта, подключение ресурсов, внесения одинаковых объектов и удобства отслеживания багов и прочего в Редакторе Сцен существует возможность создания двух лэйаутов в одном проекте.
При создании проекта мы выбираем оба магазина, после чего в панели Лэйаут появится два лэйаута для магазина А и магазина Б(см. рисунок справа. При этом текстовая база проекта и база ресурсов у них будут идентичны. При создании новых объектов в одном лэйауте они же будут создаваться и в другом, при этом можно изменять свойства объекта каждого лэйаута независимо от второго. 
За применение изменений между лэйаутами отвечает параметр "синхронизация", который есть у каждого объекта. Если стоит "синхронизировать", то объект будет одинаков в каждом из лэйаутов. Если стоит "не синхронизировать", то объект будет уникальным для каждого экрана, его изменения не будут применены на других лэйаутах, не синхронизируемые объекты можно даже удалять, т.к. они уникальны для лэйаута.

===Экспорт проекта===

'''Этапы экспорта проекта'''
*Выполняется сжатие графики при необходимости
*Очистка базы ресурсов от неиспользуемой графики
*Запаковка графики в текстуры и контейнер
*При необходимости конвертирование файлов в pvr форматы 
С целью экономии оперативной памяти на устройстве возможно сжатие графики, упаковка графики в текстуры, создание нескольких исполняемых файлов, проекта, содержащих в себе несколько сцен проекта, и загружаемых в оперативную память устройства по мере прохождения игры. 

Процедура экспорта проекта вызывается через меню редактора Проект - Экспортировать проект 

[[Файл:Scene editor export window.jpg|right]]
'''Параметры экспорта проекта:''' 
''Настройки параметров графики''
*Ось Х, ось У — параметры сжатия графики по оси Х,У. Значения параметра от 0 до 1.
*При выполнении сжатия рекомендуется обращать внимания на размер лэйаута
*Сжатие графики возможно и непропорциональное . Используется редко

''Параметры запаковки графики''
*Common textures size - максимальный размер графической текстуры для графики, которая не находится в контейнерах и попадает в одну текстуру, или максимальный размер графического файла, если он не в контейнере и не попадает в текстуру.
*Create dat container - упаковка ресурсов в файл с типом DAT. Обеспечиваем защиту ресурсов проекта от несанкционированного доступа. Увеличиваем производительность при операциях чтения файлов ресурсов с твердотельного носителя.
*Quality - Качество графики, которая не находится в контейнерах
*Optimization - оптимизация графики для лучшего быстродействия(speed) или для занимаемого дискового пространства в распакованном виде(size)

''Тип экспорта''
*One project file - формируется один XML файл описывающий проект.
*Split project on screens, load partly' - проект будет разбит на отдельные файлы описывающие экраны, загружаться файлы будут в порядке использования (вызова) в проекте. В результате получаем увеличение начальной загрузки проекта и использование меньшего объема оперативной памяти.
*Release build - оптимизация по размеру файла базы ресурсов и основного файла проекта.

''Export to folder'' - Путь для экспорта. Если указан путь экспорта проекта - производится экспорт согласно настройкам для выбранной платформы. Если не указан - проект экспортируются под выбранную платформу и автоматически запускается сборка проекта.
Структура папки:
[[Файл:TreeFolder.png|TreeFolder.png]] 
'''Select platform''' - необходимо выбрать платформу для которой будем собирать проект. При экспорте на все платформы необходимо установить Marmalade SDK [[Установка и настройка|см. инструкцию]] при этом не нужно указывать путь для экспорта (оставить поле пустым). В результате запустится скрипт сборки исполняемого пакета, это будет видно по черным экранам с ходом выполнения процесса сборки.Процесс экспорта будет отображаться в окне.

Таблица результирующих форматов для платформ
{| border="1"
|-
|качество, оптимизация
|IOS
|Android
|Windows Phone8
|BlackBerry
|Windows
|Flash
|Web
|-
|Best, size
|webp(lossless)
|webp(lossless)
|png(RGBA)
|png(RGBA)
|webp(lossless)
|webp
|webp(lossless)
|-
|Best, speed
|webp
|webp
|jxr
|jxr
|webp
|webp
|webp(lossless)
|-
|Medium, size
|jpg + png(a)
|jpg + png(a)
|jpg + png(a)
|jpg + png(a)
|jpg + png(a)
|webp
|webp
|-
|Medium, speed
|PVRTC + wepb(a8)
|ETC1 + webp(a8)
|BC3 + hitmask
|PVR8888
|BC3 + hitmask
|webp
|webp
|-
|Low, size
|PVRTC + webp(lossless)(a8)
|ETC1 + webp(lossless)(a8)
|jpg + png(a)
|jpg + png(a)
|jpg + png(a)
|webp
|webp
|-
|Low, speed
|PVRTC(RGBA) + hitmask
|ETC1 + webp(a8)
|BC3 + hitmask
|PVR8888
|BC3 + hitmask
|webp
|webp
|}

*'''ETC''' - Ericsson Texture Compression : для устройств Android
*'''PVR''' - PowerVR Texture Compression : для устройств IOS
*'''bc3(dxt)''' - DirectX Texture : Windows, Windows Phone 8 
При экспорте с галкой ETC2 текстуры ETC1 экспортятся в ETC2

=== Режим отладки ===

Включение режима отладки:

[[Файл:SE debug0.JPG]]

Инструменты отладки:

[[Файл:SE debug1.JPG]]

* '''Debug dock''' - установка брейкпоинтов (точек остановки) и вывод отладочного лога от сервера.
* '''Logging''' - вывод логов вьювера (параллельно с viewer.log) с подсветкой и фильтрами.
* '''Debug Options''' - вывод дерева опций, подсветка изменений (при работе вьювера), слежение за конкретными параметрами.
* '''Debug Properties''' - вывод параметров объекта под курсором по хоткею (из вьювера) - на момент написания не реализовано.

==== Debug dock ====

[[Файл:SE debug2.JPG]]

Принцип работы брейкпоинтов (точек остановки):
* Добавляем в табличку брейкпоинтов новый пункт
* Задает objectID интересующего объекта
** Задаем название состояния, при переходе на которое вьювер станет на паузу
** ИЛИ задаем название параметра, при изменении которого вьювер станет на паузу
* Запускаем вьювер с отладкой
*: [[Файл:SE debug3.jpg]]
* После перехода в заданное состояние вьювер станет за паузу, а в редактре сцен откроется окно машинки с этим состоянием.

==== Logging ====

[[Файл:SE debug4.JPG]]

* Сие логирование происходит только с запущеным в режиме отладки вьювером;
* Логи с ворнингами выделены оранжевым цветом ('''не игнорируйте их''');
* Логи с ошибками выделены красным цветом ('''а их уж тем более не игнорируйте!''');
* Кнопка ''Clear log'' - очищает логи из данного окна;
* Кнопка ''(...)'' - открыть лог из файла
* Флаг ''Autoscroll'' - при добавлении новой записи листает список в конец

'''Фильтрация логов'''
* Фильтр задается для каждого поля отдельно;
* Можно фильтровать по нескольким полям одновременно;
* Для фильтрации по какому-либо полю просто нажмите на его заглавие (Level / Time / ...)
* '''Как правильно задавать фильтр''':
** ''[value]'' - поиск по полному совпадению - будут показаны только записи, текст которых в данном поле '''равен''' ''[value]''
**: [[Файл:SE debug log1.jpg]]
** ''[value]*'' - поиск по началу строки - будут показаны только те записи, текст которых в данном поле '''начинается с''' ''[value]''
**: [[Файл:SE debug log2.jpg]]
** ''*[value]'' - поиск по окончанию строки - будут показаны только те записи, текст которых в данном поле '''заканчивается на''' ''[value]''
**: [[Файл:SE debug log3.jpg]]
** ''*[value]*'' - поиск по вхождению - будут показаны только те записи, текст которых в данном поле '''содержит''' текст ''[value]''
**: [[Файл:SE debug log4.jpg]]
** ''![filter]'' - исключение - при добавлении знака '''!''' перед фильтром (любой его вариацией), будут показаны все записи, текст которых в данном поле '''НЕ''' подходит под фильтр.
**: [[Файл:SE debug log5.jpg]]
** ''[filter1]&[filter2]&[...]'' - фильтрация по нескольким критериям - будут показаны все записи, текст которых '''подходит хотя бы под один из фильтров'''
**: [[Файл:SE debug log6.jpg]]

==== Debug Options ====

Окно ''Debug options'' предназначено для отслеживания изменений опций в реальном времени.

[[Файл:SE debug6.JPG]]

* Кнопка '''Refresh''' - подгружает опции из файла options.xml
* ''Options update'':
** '''Manual update''' - обновление опций '''ТОЛЬКО''' в ручном режиме (кнопкой '''Refresh''')
** '''Auto Update''' - обновление опций вьювером - все записи, что меняет в опциях вьювер, будут обновлены (так же всё еще можно обновить вручную)
** '''Timer Update''' - обновление опций по таймеру - раз в заданный период автоматически обновляет опции из файла options.xml (команды вьювера игнорируются, все изменения берутся только из файла)
* Кнопка '''Save options''' - создает локальную копию текущего файла с опциями (в том же каталоге, где лежит options.xml)
* Кнопка '''Open options filder''' - открывает папку с опциями.

* '''All options''' - отображает все опции в виде дерева, показывает текущее значение параметров и предыдущее (если было изменено)
* '''Custom params''' - позволяет отслеживать изменений конкретных параметров; в поле ''Custom param tracking'' указывается тот же путь к параметру, что и в машинках:
*: [[Файл:SE debug7.JPG]]

=Горячие клавиши=
* '''Клавиша F10''' - По нажатию разворачивает/сворачивает все объекты и подобъекты в дереве проекта или в свойствах объекта.
* '''Клавиша Num* и Num-''' - По нажатию разворачивают/сворачивают подобъекты у выделенного объекта в дереве проекта или в свойствах объекта.

[[Category:AppSalute]]

Файл:Export formats.png

2018-12-05T08:46:23Z

Akovinenko: Export_formats

Export_formats

App.icf

2018-11-23T10:39:45Z

Akovinenko: /* [Advertisement] */

==[S3E]==

'''WinWidth'''=960 - Ширина окна

'''WinHeight'''=640 - Высота окна

'''DispFixRot'''="Landscape" - ориентация приложения (Free/Landscape/Portrait/FixedLandscape/FixedPortrait)

'''MemSize'''=32000000 - Размер "кучи" для основного приложения в байтах. По-умолчанию 3Mб. '''MemSize''' должен быть больше чем '''MB_GRAFICS'''

'''MemSize1'''=15000000 - Размер "кучи" для звуков приложения в байтах. По-умолчанию 0Mб.

'''SysStackSize'''=65536

'''MemSizeDebug'''=200000000

'''WindowAllowResize'''=1 - Разрешить изменение размера окна

'''WinResizable'''=1 - 0 или 1. На устройствах с оконным менеджером даёт возможность изменять размеры окна.

'''SoundOutputFreq'''=44100 - Частота звука

''Параметры для вьювера из-под редактора:''

'''WinTitle'''="Viewer"

'''SysAppVersion'''=0.0.1

'''SysAppCaption'''="viewer"

==[GxFont]==

'''CacheTextureMaxSize=1024''' - кэш для текстовой текстуры

==[Default]==

'''save'''="0" - сохранять экран на котором были перед выходом из приложения. необходимо для книжек(1), для пазлов и прочего отключить(0). Может быть вынесено в viewer.xml

'''cut'''="0" - обрезать изображение по размеру layout-а. В случае если предполагается что отмасштабированое изображение будет мало по отношению к окну(окно больше, а картинка меньше) ставим "0" и изображение не будет обрезано а будет выходить за рамки окна. Может быть вынесено в viewer.xml

==[Fonts]==

'''font_1'''="1_arial_16" - шрифт и его номер который используется

'''size_1=16''' - размер шрифта для формирования текстуры (чем больше значение, тем меньше знаков поместятся на текстуре. Необходимо будет увеличивать значение CacheTextureMaxSize=1024 что приведет к излишнему использованию памяти)

'''chars_1=256''' - Число знаков помещенных в кеш для отрисовки в единицу времени на экране. Иначе говоря - максимальное количество разных знаков, которое может отображаться на отдельных экранах.

'''koef_6=1''' - масштаб шрифта

'''koef_6_de=1.3''' - масштаб шрифта для определённого языка

==[Game]==

'''Market'''="amazon" - задаёт какие будут использованы инапы, если они есть, и ссылки в текстовой базе. возможны варианты: samsung, amazon, ios, wildtangent, android, blackberry, fortumo, google, mac, windows, phone8

'''debug="Absolutist-2253"''' - режим отладки, если ненужен, или для выгрузки в магазин - удалить.

'''show_build_date=1''' - показывать дату билда вьювера

'''mouseOver''' - 1 send mouse over events to viewer (for PC projects) 0 - don't send (for Mobile projects)

'''DispFixRot'''='''"Landscape"''' програмная ориентация приложения. Не путать с параметром в [S3E]

'''alignType'''=1 позиционирование объектов, если указано в объекте. 1 - по логическому экрану, 0 - по физическому. 1 - по умолчанию.

'''allow_background'''=1 - не ставить вьювер на паузу при потере фокуса.

'''purchaseEverything''=1 - совершать эмуляцию покупки (для тестирования покупок из-под редактора).

==[GameTrace]==

'''flurry=1''' - заносить в логи активность flurry

'''memorymanager=1''' - заносить в логи количество памяти затраченной приложением

'''Level'''="Verbose" - уровень записи в лог. Verbose - самый детальный, используется по умолчанию (Verbose/Info/Warnings/Errors). Info - в лог попадает только информация (Info,Warnings,Errors). Warnings - в лог пишутся только предупреждения и ошибки (Warnings,Errors). Errors - в лог пишутся только ошибки (Errors).

'''All'''=0 - 0-выключены все логи от объектов кроме тех, у которых стоит параметр 1 (см. ниже). 1 - логи от объектов включены, кроме тех у которых параметр 0 (см. ниже)

'''GMachine'''=1 - 1 логи от объекта включены, 0 - выключены

'''GESocial'''=0

==[GameMemory]==

'''MB_GRAFICS=18000000''' - размер буфера для загрузки изображений. Сначала изображение помещается в этот буфер, потом из него в видеопамять. По умолчанию - 9 мб. Память для буфера входит в '''MemSize''' - тоесть для объектов выделяется объём памяти равный '''MemSize''' - '''MB_GRAFICS'''.

==[s3eAndroidAppirater]==

'''title="App name"''' - название приложения

'''app_name="market://id?=com.your_company.application"''' - package id приложения

'''days=0'''

'''launches=0'''

'''events=0'''

'''need_email_button=1''' - нужна ли кнопка "отправить письмо"

'''email_addr="user@yourcompany.com"''' - email на который будет отправлено письмо

'''email_subj="Subject of email"''' - тема письма

'''email_text="Hello!"''' - текст письма

==[Parameters]==
Добавляет в options параметр и значение при запуске приложения. Параметры этой секции будут установлены в опции; нумерация должна быть последовательной от 1 до бесконечности

'''param1_name="param1.param"''' - имя параметра

'''param1_value="12"''' - значение параметра

'''param1_overwrite="0"''' - перезаписывать параметр, если был ранее 1 - по умолчанию. 1 - перезаписывать, 0 - неперезаписывать

'''param2_name="param2"'''

'''param2_value="13"'''

==[GHiddenList]==

'''HitTest''' - мода автотеста; (0- выкл.; 1 - разовая логика, пишется в файл раз в сессию для одного хидден листа ; 2 - при каждом init любого хидн листа дописывается статистика в файл);

'''HitTestDx''' = 5 - шаг с которым проходит автокликер по X;

'''HitTestDy''' = 5 - шаг с которым проходит автокликер по Y.

==[Splash]==

'''inscribe''' - вписывать видео сплэшскрина в текущий экран; (1 - вписывать);

Видео должно называться Splash.ogv и находиться рядом с вьювером

==[Advertisement]==
'''OfflineMode''' - включить оффлайн режим, при котором конфиг рекламы не будет качаться с сервера (будет браться из кеша); Если в кеше нет конфига - реклама работать не будет.

'''DebugMode''' - включить отладочный режим при котором загружается дебажный конфиг с серврера независимо от того с какого адреса идет запрос

'''ReleaseMode''' - включить релизный режим при котором загружается релизный конфиг с серврера независимо от того с какого адреса идет запрос

(если установлены оба последних параметра, выбирается отладочный режим)

==[DynamicConfig]==
'''offline''' - включить оффлайн режим использования динамического конфига (конфиг при помощи которого можно патчить приложение - пока используется только в H365 и HiddenBattle); при включённом режиме конфиг будет браться локально (из кеша), если имеется в наличии.

[[Category:Projects]]

App.icf

2018-11-23T10:39:28Z

Akovinenko: /* [Advertisement] */

==[S3E]==

'''WinWidth'''=960 - Ширина окна

'''WinHeight'''=640 - Высота окна

'''DispFixRot'''="Landscape" - ориентация приложения (Free/Landscape/Portrait/FixedLandscape/FixedPortrait)

'''MemSize'''=32000000 - Размер "кучи" для основного приложения в байтах. По-умолчанию 3Mб. '''MemSize''' должен быть больше чем '''MB_GRAFICS'''

'''MemSize1'''=15000000 - Размер "кучи" для звуков приложения в байтах. По-умолчанию 0Mб.

'''SysStackSize'''=65536

'''MemSizeDebug'''=200000000

'''WindowAllowResize'''=1 - Разрешить изменение размера окна

'''WinResizable'''=1 - 0 или 1. На устройствах с оконным менеджером даёт возможность изменять размеры окна.

'''SoundOutputFreq'''=44100 - Частота звука

''Параметры для вьювера из-под редактора:''

'''WinTitle'''="Viewer"

'''SysAppVersion'''=0.0.1

'''SysAppCaption'''="viewer"

==[GxFont]==

'''CacheTextureMaxSize=1024''' - кэш для текстовой текстуры

==[Default]==

'''save'''="0" - сохранять экран на котором были перед выходом из приложения. необходимо для книжек(1), для пазлов и прочего отключить(0). Может быть вынесено в viewer.xml

'''cut'''="0" - обрезать изображение по размеру layout-а. В случае если предполагается что отмасштабированое изображение будет мало по отношению к окну(окно больше, а картинка меньше) ставим "0" и изображение не будет обрезано а будет выходить за рамки окна. Может быть вынесено в viewer.xml

==[Fonts]==

'''font_1'''="1_arial_16" - шрифт и его номер который используется

'''size_1=16''' - размер шрифта для формирования текстуры (чем больше значение, тем меньше знаков поместятся на текстуре. Необходимо будет увеличивать значение CacheTextureMaxSize=1024 что приведет к излишнему использованию памяти)

'''chars_1=256''' - Число знаков помещенных в кеш для отрисовки в единицу времени на экране. Иначе говоря - максимальное количество разных знаков, которое может отображаться на отдельных экранах.

'''koef_6=1''' - масштаб шрифта

'''koef_6_de=1.3''' - масштаб шрифта для определённого языка

==[Game]==

'''Market'''="amazon" - задаёт какие будут использованы инапы, если они есть, и ссылки в текстовой базе. возможны варианты: samsung, amazon, ios, wildtangent, android, blackberry, fortumo, google, mac, windows, phone8

'''debug="Absolutist-2253"''' - режим отладки, если ненужен, или для выгрузки в магазин - удалить.

'''show_build_date=1''' - показывать дату билда вьювера

'''mouseOver''' - 1 send mouse over events to viewer (for PC projects) 0 - don't send (for Mobile projects)

'''DispFixRot'''='''"Landscape"''' програмная ориентация приложения. Не путать с параметром в [S3E]

'''alignType'''=1 позиционирование объектов, если указано в объекте. 1 - по логическому экрану, 0 - по физическому. 1 - по умолчанию.

'''allow_background'''=1 - не ставить вьювер на паузу при потере фокуса.

'''purchaseEverything''=1 - совершать эмуляцию покупки (для тестирования покупок из-под редактора).

==[GameTrace]==

'''flurry=1''' - заносить в логи активность flurry

'''memorymanager=1''' - заносить в логи количество памяти затраченной приложением

'''Level'''="Verbose" - уровень записи в лог. Verbose - самый детальный, используется по умолчанию (Verbose/Info/Warnings/Errors). Info - в лог попадает только информация (Info,Warnings,Errors). Warnings - в лог пишутся только предупреждения и ошибки (Warnings,Errors). Errors - в лог пишутся только ошибки (Errors).

'''All'''=0 - 0-выключены все логи от объектов кроме тех, у которых стоит параметр 1 (см. ниже). 1 - логи от объектов включены, кроме тех у которых параметр 0 (см. ниже)

'''GMachine'''=1 - 1 логи от объекта включены, 0 - выключены

'''GESocial'''=0

==[GameMemory]==

'''MB_GRAFICS=18000000''' - размер буфера для загрузки изображений. Сначала изображение помещается в этот буфер, потом из него в видеопамять. По умолчанию - 9 мб. Память для буфера входит в '''MemSize''' - тоесть для объектов выделяется объём памяти равный '''MemSize''' - '''MB_GRAFICS'''.

==[s3eAndroidAppirater]==

'''title="App name"''' - название приложения

'''app_name="market://id?=com.your_company.application"''' - package id приложения

'''days=0'''

'''launches=0'''

'''events=0'''

'''need_email_button=1''' - нужна ли кнопка "отправить письмо"

'''email_addr="user@yourcompany.com"''' - email на который будет отправлено письмо

'''email_subj="Subject of email"''' - тема письма

'''email_text="Hello!"''' - текст письма

==[Parameters]==
Добавляет в options параметр и значение при запуске приложения. Параметры этой секции будут установлены в опции; нумерация должна быть последовательной от 1 до бесконечности

'''param1_name="param1.param"''' - имя параметра

'''param1_value="12"''' - значение параметра

'''param1_overwrite="0"''' - перезаписывать параметр, если был ранее 1 - по умолчанию. 1 - перезаписывать, 0 - неперезаписывать

'''param2_name="param2"'''

'''param2_value="13"'''

==[GHiddenList]==

'''HitTest''' - мода автотеста; (0- выкл.; 1 - разовая логика, пишется в файл раз в сессию для одного хидден листа ; 2 - при каждом init любого хидн листа дописывается статистика в файл);

'''HitTestDx''' = 5 - шаг с которым проходит автокликер по X;

'''HitTestDy''' = 5 - шаг с которым проходит автокликер по Y.

==[Splash]==

'''inscribe''' - вписывать видео сплэшскрина в текущий экран; (1 - вписывать);

Видео должно называться Splash.ogv и находиться рядом с вьювером

==[Advertisement]==
'''OfflineMode''' - включить оффлайн режим, при котором конфиг рекламы не будет качаться с сервера (будет браться из кеша); Если в кеше нет конфига - реклама работать не будет.

'''DebugMode''' - включить отладочный режим при котором загружается дебажный конфиг с серврера независимо от того с какого адреса идет запрос

'''ReleaseMode''' - включить релизный режим при котором загружается релизный конфиг с серврера независимо от того с какого адреса идет запрос

#если установлены оба последних параметра, выбирается отладочный режим

==[DynamicConfig]==
'''offline''' - включить оффлайн режим использования динамического конфига (конфиг при помощи которого можно патчить приложение - пока используется только в H365 и HiddenBattle); при включённом режиме конфиг будет браться локально (из кеша), если имеется в наличии.

[[Category:Projects]]

App.icf

2018-11-23T10:39:15Z

Akovinenko: /* [Advertisement] */

==[S3E]==

'''WinWidth'''=960 - Ширина окна

'''WinHeight'''=640 - Высота окна

'''DispFixRot'''="Landscape" - ориентация приложения (Free/Landscape/Portrait/FixedLandscape/FixedPortrait)

'''MemSize'''=32000000 - Размер "кучи" для основного приложения в байтах. По-умолчанию 3Mб. '''MemSize''' должен быть больше чем '''MB_GRAFICS'''

'''MemSize1'''=15000000 - Размер "кучи" для звуков приложения в байтах. По-умолчанию 0Mб.

'''SysStackSize'''=65536

'''MemSizeDebug'''=200000000

'''WindowAllowResize'''=1 - Разрешить изменение размера окна

'''WinResizable'''=1 - 0 или 1. На устройствах с оконным менеджером даёт возможность изменять размеры окна.

'''SoundOutputFreq'''=44100 - Частота звука

''Параметры для вьювера из-под редактора:''

'''WinTitle'''="Viewer"

'''SysAppVersion'''=0.0.1

'''SysAppCaption'''="viewer"

==[GxFont]==

'''CacheTextureMaxSize=1024''' - кэш для текстовой текстуры

==[Default]==

'''save'''="0" - сохранять экран на котором были перед выходом из приложения. необходимо для книжек(1), для пазлов и прочего отключить(0). Может быть вынесено в viewer.xml

'''cut'''="0" - обрезать изображение по размеру layout-а. В случае если предполагается что отмасштабированое изображение будет мало по отношению к окну(окно больше, а картинка меньше) ставим "0" и изображение не будет обрезано а будет выходить за рамки окна. Может быть вынесено в viewer.xml

==[Fonts]==

'''font_1'''="1_arial_16" - шрифт и его номер который используется

'''size_1=16''' - размер шрифта для формирования текстуры (чем больше значение, тем меньше знаков поместятся на текстуре. Необходимо будет увеличивать значение CacheTextureMaxSize=1024 что приведет к излишнему использованию памяти)

'''chars_1=256''' - Число знаков помещенных в кеш для отрисовки в единицу времени на экране. Иначе говоря - максимальное количество разных знаков, которое может отображаться на отдельных экранах.

'''koef_6=1''' - масштаб шрифта

'''koef_6_de=1.3''' - масштаб шрифта для определённого языка

==[Game]==

'''Market'''="amazon" - задаёт какие будут использованы инапы, если они есть, и ссылки в текстовой базе. возможны варианты: samsung, amazon, ios, wildtangent, android, blackberry, fortumo, google, mac, windows, phone8

'''debug="Absolutist-2253"''' - режим отладки, если ненужен, или для выгрузки в магазин - удалить.

'''show_build_date=1''' - показывать дату билда вьювера

'''mouseOver''' - 1 send mouse over events to viewer (for PC projects) 0 - don't send (for Mobile projects)

'''DispFixRot'''='''"Landscape"''' програмная ориентация приложения. Не путать с параметром в [S3E]

'''alignType'''=1 позиционирование объектов, если указано в объекте. 1 - по логическому экрану, 0 - по физическому. 1 - по умолчанию.

'''allow_background'''=1 - не ставить вьювер на паузу при потере фокуса.

'''purchaseEverything''=1 - совершать эмуляцию покупки (для тестирования покупок из-под редактора).

==[GameTrace]==

'''flurry=1''' - заносить в логи активность flurry

'''memorymanager=1''' - заносить в логи количество памяти затраченной приложением

'''Level'''="Verbose" - уровень записи в лог. Verbose - самый детальный, используется по умолчанию (Verbose/Info/Warnings/Errors). Info - в лог попадает только информация (Info,Warnings,Errors). Warnings - в лог пишутся только предупреждения и ошибки (Warnings,Errors). Errors - в лог пишутся только ошибки (Errors).

'''All'''=0 - 0-выключены все логи от объектов кроме тех, у которых стоит параметр 1 (см. ниже). 1 - логи от объектов включены, кроме тех у которых параметр 0 (см. ниже)

'''GMachine'''=1 - 1 логи от объекта включены, 0 - выключены

'''GESocial'''=0

==[GameMemory]==

'''MB_GRAFICS=18000000''' - размер буфера для загрузки изображений. Сначала изображение помещается в этот буфер, потом из него в видеопамять. По умолчанию - 9 мб. Память для буфера входит в '''MemSize''' - тоесть для объектов выделяется объём памяти равный '''MemSize''' - '''MB_GRAFICS'''.

==[s3eAndroidAppirater]==

'''title="App name"''' - название приложения

'''app_name="market://id?=com.your_company.application"''' - package id приложения

'''days=0'''

'''launches=0'''

'''events=0'''

'''need_email_button=1''' - нужна ли кнопка "отправить письмо"

'''email_addr="user@yourcompany.com"''' - email на который будет отправлено письмо

'''email_subj="Subject of email"''' - тема письма

'''email_text="Hello!"''' - текст письма

==[Parameters]==
Добавляет в options параметр и значение при запуске приложения. Параметры этой секции будут установлены в опции; нумерация должна быть последовательной от 1 до бесконечности

'''param1_name="param1.param"''' - имя параметра

'''param1_value="12"''' - значение параметра

'''param1_overwrite="0"''' - перезаписывать параметр, если был ранее 1 - по умолчанию. 1 - перезаписывать, 0 - неперезаписывать

'''param2_name="param2"'''

'''param2_value="13"'''

==[GHiddenList]==

'''HitTest''' - мода автотеста; (0- выкл.; 1 - разовая логика, пишется в файл раз в сессию для одного хидден листа ; 2 - при каждом init любого хидн листа дописывается статистика в файл);

'''HitTestDx''' = 5 - шаг с которым проходит автокликер по X;

'''HitTestDy''' = 5 - шаг с которым проходит автокликер по Y.

==[Splash]==

'''inscribe''' - вписывать видео сплэшскрина в текущий экран; (1 - вписывать);

Видео должно называться Splash.ogv и находиться рядом с вьювером

==[Advertisement]==
'''OfflineMode''' - включить оффлайн режим, при котором конфиг рекламы не будет качаться с сервера (будет браться из кеша); Если в кеше нет конфига - реклама работать не будет.
'''DebugMode''' - включить отладочный режим при котором загружается дебажный конфиг с серврера независимо от того с какого адреса идет запрос
'''ReleaseMode''' - включить релизный режим при котором загружается релизный конфиг с серврера независимо от того с какого адреса идет запрос
#если установлены оба последних параметра, выбирается отладочный режим

==[DynamicConfig]==
'''offline''' - включить оффлайн режим использования динамического конфига (конфиг при помощи которого можно патчить приложение - пока используется только в H365 и HiddenBattle); при включённом режиме конфиг будет браться локально (из кеша), если имеется в наличии.

[[Category:Projects]]

2018-10-02T13:43:01Z

Akovinenko: /* Коды ошибок */

[[Object|Объект]] '''Advertisement''' позволяет отображать рекламу разных типов. Объект должен находиться на экране, на котором необходимо показать рекламу, либо на глобальном экране. Данный объект предназначен для соблюдения условий запуска рекламы. Огромный плюс, что большинство настроек, могут задавать удалённо маркетологи.

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

*'''синхронизация''' - не синхронизировать=0, синхронизировать=1;

*'''сохранение параметров''' - нет=0, только объект=1, объект с подобъектами=2, только подобъекты=3;

*'''placement''' - Идентификатор места показа рекламы в игре.

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

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

*'''объект''' - Объект, состояние которого нужно изменить; '''!!! Объект должен находиться выше по дереву, чтобы успеть проинициализироваться до готовности рекламы !!!'''

*'''состояние''' - Новое состояние объекта.

[[Файл:+.png]] '''реклама готова к показу: изменить свойство объекта'''

*'''объект''' - Объект, свойство которого нужно изменить; '''!!! Объект должен находиться выше по дереву, чтобы успеть проинициализироваться до готовности рекламы !!!'''

*'''свойство''' - Свойство, которое нужно изменить.

*'''значение''' - Новое значение свойства.

[[Файл:+.png]] '''реклама успешно показана: изменить состояние объекта'''

*'''объект''' - Объект, состояние которого нужно изменить;

*'''состояние''' - Новое состояние объекта.

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

*'''show''' - показать рекламу.

==Коды ошибок==

*'''0''' - ''AD_ERROR_NONE = 0'' - все хорошо, ошибок нет;
*'''1''' - ''AD_ERROR_SKIP = 1'' - показывать нечего (нет ни одного активного провайдера рекламы, нужно спрятать кнопки показа, пользовательские окна при этой ошибке показывать не нужно!!!);
*'''2''' - ''AD_ERROR_INTERNET = 2'' - ошибка отсутствия интернета;
*'''3''' - ''AD_ERROR_NOT_FOUND = 3'' - запрос на показ рекламы был отправлен, но реклама по данному запросу отсутствует;
*'''4''' - ''AD_ERROR_CANCELED = 4'' - показ рекламы был отменен пользователем.
*'''5''' - ''AD_ERROR_UNKNOWN = 5'' - неизвестная ошибка.

Для обработки ошибок использовать [[Errormanager|ErrorManager]].

==Симулятор==

Для работы симулятора рекламы на редакторном вьювере необходимо добавить в app.icf параметры:

[Game]
bundle="%id_game"
[Game]
VersionMain=%m
VersionGraphic=%g
VersionLogic=%l

где:
%id_game - бандл игры, соответствующий файлу конфигурации рекламы,
%m, %g, %l - номер версии игры, соответствующий файлу конфигурации рекламы.

При вызове состояния ''show'' объекту на экране появится черный прямоугольник с названием placement'а вызванной рекламы. Esc симулирует закрытие рекламы и вызов ''ошибки 4'' (показ рекламы отменен пользователем). Enter симулирует закрытие рекламы и вызов обработчика ''реклама успешно показана''.

[[Category:Options]]
[[Category:Реклама]]

Partnersconsole

2018-06-26T08:43:43Z

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

{{TOC right}}

'''partnersconsole''' - объект обмена опциями с партнерами. 

== Параметры ==
*'''id объекта''' (id) - уникальный номер объекта
*'''тип''' (type) - Выбранный тип объекта определяет его функциональное назначение и его свойства
*'''имя''' (name) - Имя объекта в дереве проекта. Может быть произвольным.
*'''отображать сразу игровое окно игры или показывать сначала окно лидербордов партнера''' (leaderboards_hide) - Не показывать окно лидербордов партнера (по умолчанию 0).

=== Состояния ===
*'''start''' - Это состояние нужно вызывать в начале уровня.
*'''game_over''' - Это состояние нужно вызывать в конце уровня. В уровневой игре перед отправкой нужно записать параметр '''levelnum''', равный номеру пройденного уровня.
*'''post_highscore''' - Состояние для отправки нового рекорда. Рекорд предварительно нужно записать в параметр '''highscore''' объекта. Вызывается при получении рекорда.
*'''get_options''' - Состояние для получения опций. Вызывается обычно при старте игры. При получении опций происходит автоматическая перезагрузка лейаута. Срабатывает только 1 раз, дополнительные проверки не требуются.
*'''send_options''' - Состояние для отправки опций. Вызывается обычно в конце уровня.

=== Добавляемые параметры ===
*'''Изменить состояние объекта - начало новой игры''' (game_event_play) - Была нажата внешняя кнопка Play, необходим перезапуск игры.
*'''Изменить состояние объекта - показать окно завершения игры''' (game_event_show_menu) - Нужно показать окно завершения игры.
*'''Изменить состояние объекта - скрыть окно завершения игры''' (game_event_hide_menu) - Нужно закрыть окно завершения игры.

[[Category:Main objects]]

Partnersconsole

2018-06-26T08:43:18Z

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

{{TOC right}}

'''partnersconsole''' - объект обмена опциями с партнерами. 

== Параметры ==
*'''id объекта''' (id) - уникальный номер объекта
*'''тип''' (type) - Выбранный тип объекта определяет его функциональное назначение и его свойства
*'''имя''' (name) - Имя объекта в дереве проекта. Может быть произвольным.
*'''отображать сразу игровое окно игры или показывать сначала окно лидербордов партнера''' (leaderboards_hide) - Не показывать окно лидербордов партнера (по умолчанию 0).

=== Состояния ===
*'''start''' - Это состояние нужно вызывать в начале уровня.
*'''game_over''' - Это состояние нужно вызывать в конце уровня. В уровневой игре перед отправкой нужно записать параметр levelnum, равный номеру пройденного уровня.
*'''post_highscore''' - Состояние для отправки нового рекорда. Рекорд предварительно нужно записать в параметр highscore объекта. Вызывается при получении рекорда.
*'''get_options''' - Состояние для получения опций. Вызывается обычно при старте игры. При получении опций происходит автоматическая перезагрузка лейаута. Срабатывает только 1 раз, дополнительные проверки не требуются.
*'''send_options''' - Состояние для отправки опций. Вызывается обычно в конце уровня.

=== Добавляемые параметры ===
*'''Изменить состояние объекта - начало новой игры''' (game_event_play) - Была нажата внешняя кнопка Play, необходим перезапуск игры.
*'''Изменить состояние объекта - показать окно завершения игры''' (game_event_show_menu) - Нужно показать окно завершения игры.
*'''Изменить состояние объекта - скрыть окно завершения игры''' (game_event_hide_menu) - Нужно закрыть окно завершения игры.

[[Category:Main objects]]

Partnersconsole

2018-06-21T09:16:58Z

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

{{TOC right}}

'''partnersconsole''' - объект обмена опциями с партнерами. 

== Параметры ==
*'''id объекта''' (id) - уникальный номер объекта
*'''тип''' (type) - Выбранный тип объекта определяет его функциональное назначение и его свойства
*'''имя''' (name) - Имя объекта в дереве проекта. Может быть произвольным.
*'''отображать сразу игровое окно игры или показывать сначала окно лидербордов партнера''' (leaderboards_hide) - Не показывать окно лидербордов партнера (по умолчанию 0).

=== Состояния ===
*'''start''' - Это состояние нужно вызывать в начале уровня.
*'''game_over''' - Это состояние нужно вызывать в конце уровня.
*'''post_highscore''' - Состояние для отправки нового рекорда. Рекорд предварительно нужно записать в параметр highscore объекта. Вызывается при получении рекорда.
*'''get_options''' - Состояние для получения опций. Вызывается обычно при старте игры. При получении опций происходит автоматическая перезагрузка лейаута. Срабатывает только 1 раз, дополнительные проверки не требуются.
*'''send_options''' - Состояние для отправки опций. Вызывается обычно в конце уровня.

=== Добавляемые параметры ===
*'''Изменить состояние объекта - начало новой игры''' (game_event_play) - Была нажата внешняя кнопка Play, необходим перезапуск игры.
*'''Изменить состояние объекта - показать окно завершения игры''' (game_event_show_menu) - Нужно показать окно завершения игры.
*'''Изменить состояние объекта - скрыть окно завершения игры''' (game_event_hide_menu) - Нужно закрыть окно завершения игры.

[[Category:Main objects]]

Effect

2018-06-19T13:33:46Z

Akovinenko: /* Описание эффекта */

{{TOC right}}
Effect - [[Object|объект]] редактора, предназначенный для создания различных визуальных эффектов, которые визуализируется (проявляются) в зависимости от частоты кликов пользователя по заданной области проявления эффекта. 
Обьект Effect расположен в Main objects 
'''Важное замечание!''' 
Эффект БЛЮР и ДЫМ не могут быть вызваны одним экземляром класса Effect 

=Эффект БЛЮР=
Эффект блюр позволяет создавать дребезжание объекта. Например, раздвоение объекта.
==Механизм работы эффекта БЛЮР==
Ситуация:
Пользователю необходимо отключить звенящий будильник. Пользователь на экране видит дребезжащий будильник. По клику на будильник дребезжание будильника прекращается. 
Порядок действий: 
* На сцене размещаем машину состояний с графическим ресурсом будильника. Назовем ее БУД. Обработка клика на машину состояний стандартная.
* На сцене размещаем объект Effect. Положение объекта Effect должно полностью совпадать с положением машины состояний БУД!
* Свойству Объект эффекта БЛЮР устанавливаем значение машину состояний БУД. Значения других свойств эффекта БЛЮР оставляем стандартными. 

==Параметры эффекта Блюр==
===Свойства объекта Блюр===
*Объект (obj) - Объект, к которому будет применен эффект блюр.
*Продолжительность (tm) - продолжительность эффекта. По умолчанию 4000.
*Отклонение (dev)-. Чем больше отклонение, тем больше "отскакивает" в разные стороны от центра объекта По умолчанию 10. При задании значений больше 90 объект "скачет" по диагонали.
*Скорость (vel) -Скорость "дрожания" объекта. По умолчанию 1000.
*Прозрачность (al) - По умолчанию 0.5.

===Состояния===
*beg - включить проявление Блюра
*end - остановить проявление Блюра
'''Замечание!''' По умолчанию Блюр находится в состоянии end
=Эффект ДЫМ=
==Физическое объяснение работы эффекта ДЫМ==
Область проявления эффекта(ОПФ) — строго ограничена. (В данной версии редактора область только прямоугольная).ОПФ является непрерывной поверхностью и находится в ожидании клика пользователя. 
При одинарном клике внутри ОПФ проявляется объект с набором параметров, установленными в свойствах объекта Effect, и параметров, определяемых частотой, силой кликов и координатами клика внутри ОПФ. Далее этот объект будем называть излучателем. [[Файл:Распространение_1.JPG|right|250px]] 
При одинарном клике по ОПФ , излучатель направляет во все направления частицы при этом большая часть частиц распространяется вдоль отрицательной оси У (вверх). Чем дальше частицы удаляются от центра излучателя , тем они становятся светлее. На рисунке отображена картинка, которую увидит игрок. [[Файл:Распространение_2.JPG|right]] 
При наличии 2 и более излучателей, находящихся на достаточном малом расстоянии друг от друга, большая часть частиц излучателей будет распространяться по направленному отрезку, образованному двумя излучателями. На экране игрок увидит эффект как от движения ручки по бумаге. 

При наличии на экране 2 и более излучателей, удаленных друг от друга на достаточно большом расстоянии внутри ОПФ, частицы излучателя начинают взаимодействовать друг с другом. 
Пусть в области ОПФ есть 4 излучателя. На схеме цветными кружками отображены излучатели, и цветными полями отображены направления распространения частиц излучателя. Пусть необходимо определить яркость частицы в точке Z. Не вдаваясь в математические вычисления, яркость частицы в точке Z будет равна средневзвешенному значению яркости частиц, расположенных вблизи точки Z. Все частицы излучателя влияют на яркость соседних. 
[[Файл:Точка_внутри_ОПФ.JPG|right|250px]]

==Механизм работы эффекта ДЫМ==
При клике по заданной области на экране проявляется визуальный эффект, который распространяется в границах заданной области
*в зависимости от «силы» клика проявляется эффект
*в зависимости от координаты точки клика внутри ОПФ эффект будет распространяться по всем направлениям
*при одинарном клике эффект движется направленно верх.
*при увеличении частоты кликов эффект начинает двигаться направленно вверх при этом высота эффекта увеличивается
*при достижения верхней / нижней границы заданной области эффект может начать двигаться вдоль нее
*при достижении правой/левой границы эффект может начать двигаться внутрь заданной области
*при нажатии на кнопку мыши и начале движения в любую сторону внутри области эффект начнет вести себя как ручка по бумаге
*при резком отведении нажатой мышки к границе ОПФ в области , находящейся близко к границе ОПФ, создается несколько излучателей/

[[Файл:Граница_ОПФ.JPG|right|175px]] 

==Взаимодействие с картинками эффекта ДЫМ==
Пусть Effect лежит поверх картинки. 
*После рассеивания всех частиц излучателей на картинке проявится граница ОПФ. Для устранения этого эффекта рекомендуется установить прозрачность объекту Effect.
*При необходимости добавления эффекта в строго ограниченные не прямоугольной области, например, создание эффекта воды в озере, необходимо области, на которых не должен проявляться эффект, "закрыть" фоном
*По умолчанию частица эффекта белого цвета. Есть возможность подгружать частицы любого размера.

==Параметры эффекта ДЫМ==
'''Внимание! Параметры обьекта будут уточняться!''' 
===Свойства объекта Дым===
{| class="wikitable"
|'''Название параметра на английском'''
|'''Названия параметра на русском'''
|'''Название параметра в xml'''
|'''Характеристика параметра'''
|'''Значение по умолчанию'''
|-
|
|частица
|smPart
|Ресурс частицы
|Цвет частицы - белый
|-
|w
|Ширина распространения эффекта
|w
|Значения до 40. Увеличивает ширину излучения. Чем меньше значения, тем шире
|70
|-
|h
|Высота распространения эффекта
|h
|До 200. Чем больше значение, тем выше
|70
|-
|Velocity diffusion
|Скорость диффузии
|Vd
|Значение до 25. Больше скорость , больше температура
|0
|-
|Diffusion itterations
|Количество итераций диффузии
|di
|До 400
|0
|-
|Pressure diffusion
|Давление диффузии
|pd
|Больше давление, больше частиц. Рекомендуется ставить до 10
|0
|-
|Ink diffusion
|Плотность газа
|id
|Плотность до 800
|0
|-
|Velocity friction a
|Квадратичное замедление
|fva
|Замедление распространения частиц.
|0
|-
|Velocity friction b
|Линейное замедление
|fvb
|Замедление распространения частиц.
|0
|-
|Velocity friction c
|Изменение скорости на заданную величину
|fvc
|Замедление распространения частиц.
|0
|-
|Vorticity
|Завихренность
|vort
|Чем больше значение, тем больше вихрей
|0
|-
|Pressure acc
|Давление в точке
|pacc
|Создаются маленькие излучатели вокруг излучателя. Рекомендуется ставить значение до 50
|2
|-
|ink heat
|плотность тепла ???
|ih
|Вертикально вниз падают частицы
|0
|-
|Heat force
|????
|hf
|Вертикальное падение частиц
|0.1
|-
|Heat friction a
|Квадратичное трение
|hfa
|
|0.5
|-
||Heat friction b
|Линейное трение Б
|hfa
|
|0.2
|-
||Heat friction с
|Изменение скорости на заданную величину
|hfa
|
|0.01
|-
|Velocity advection
|Скорость адвекции
|va
|Скорость распространения
|150
|-
|Pressure advection
|Давление адвекци
|padv
|Параметр, влияющий на величину давления частиц
|150
|-
|Heat advection
|Температура адвекции
|ha
|Моделируемая температура, при которой распространяются частицы
|150
|-
|}
 
====Важное замечание====
*Параметры Velocity friction a, Velocity friction b, Velocity friction c,Heat friction a,Heat friction b,Heat friction c позволяют управлять процессом распространения частиц по ОПФ. Хотя эффекты, создаваемые перечисленными параметрами можно получить с использованием других.
*Одновременное использование параметров групп Velocity friction или Heat friction приведет к замедлению распространению частиц. Рекомендуется подбирать значения параметров очень аккуратно при условии, что параметр А >B>C.

===Состояния эффекта ДЫМ===
В данной версии редактора состояний нет.

===Параметры, записываемые в options.xml===
В данной версии редактора такие параметры отсутствуют

=Эффект AMBIENT WITH LIGHT=

'''Параметры''' :

*awl - Тип эффекта.
*tag - Номер эффекта.

'''Состояния'''

*awl_beg - Активировать эффект AmbientWithLight.
*awl_run - Эффект AmbientWithLight работает.
*awl_upd - Обновить параметры эффекта AmbientWithLight.
*awl_end - Деактивировать эффект AmbientWithLight.

Замечание! По умолчанию AmbientWithLight находится в состоянии awl_end.

'''Примеры подборки коэффициентов:'''

Стартовая картинка:

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

'''''1) Картинка перекрашивается в темно-синий цвет. Эффект ночи.''''' [[Файл:awl_blue.png|right]]

r="0.1, 0.0, 0.0, 0.0" 
g="0.0, 0.1, 0.0, 0.0" 
b="0.0, 0.0, 0.5, 0.0" 

'''''2) Цветной негатив.''''' [[Файл:awl_c_neg.png|right]]

r="-1.0, 0.0, 0.0, 1.0" 
g="0.0, -1.0, 0.0, 1.0" 
b="0.0, 0.0, -1.0, 1.0" 

'''''3) Черно-белая сепия.''''' [[Файл:awl_dw.png|right]]

r="1.0, 0.0, 0.0, 0.0" 
g="1.0, 0.0, 0.0, 0.0" 
b="1.0, 0.0, 0.0, 0.0" 

'''''4) Черно-белый негатив.''''' [[Файл:awl_dw_neg.png|right]]

r="-1.0, 0.0, 0.0, 1.0" 
g="-1.0, 0.0, 0.0, 1.0" 
b="-1.0, 0.0, 0.0, 1.0" 

'''Пример подключения эффекта AmbientWithLight:'''

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

=Пример использования обьекта Effect=
Примеры эффектов создаваемых с использованием обьекта Effect расположены по ссылке. В проекте 28 экранов, на каждом из которых расположен один пример эффекта с описанием применяемых параметров. 
[[Файл:Пример_экрана_с_эффектом.JPG|500px]] 

== Перекрашивание графики ==
Для начала - перекрашиваемая графика должна быть максимально осветлённая ( чтобы точнее перекрасить цвет, чем темнее графика - тех меньше будет влиять перекрашивание).

Имеем графику:

[[Файл:Bg seryj copy.png|430px]]

Далее, производим махинации - узнаём при помощи пипетки ( Photoshop ) цвет эталлоного пикселя ( один и тот же пиксель, на нужной и на осветлённой графиках).
Заносим полученные значения RGB каналов в таблицу, и для каждого канала узнаём процент цвета ( делим нужный цвет на эталонный).

[[Файл:Colors.ods - LibreOffice Calc.jpg|960px]]

Полученные % используем в объекте effect:

[[Файл:Splitmanager_setup_awl_6.jpg|460px]]

Далее всё по обычному - указываем тип эффекта awl, указываем номер эффекта и передаём сост. "awl_beg", результат:
[[Файл:66c7052ca8.jpg|960px]]

=TimeLineFX эффекты=
TimeLineFX эффекты - эффекты, которые создаются с помощью TimeLineFX редактора или из готовых шаблонов.

==Описание эффекта==
Перед запуском TimeLineFX эффекта нужно записать в объект effect параметры '''eftype''' = particle, '''eftag''' = N (N - номер тега эффекта).

Для запуска эффекта необходимо передать объекту effect состояние '''particle_beg'''.

Для остановки эффекта необходимо передать объекту effect состояние '''particle_end'''.

'''particle_pause''' - ставит эффект на паузу.

'''particle_run''' - запускает эффект (снимает с паузы если particle_pause ; запускает с нуля если эффект particle_end).

Пример запуска эффекта через машину состояний показан ниже.

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

Для добавления нового эффекта, в настройках объекта effect используем кнопку '''"Import Effect"'''.

В открытом окне выбираем нужную нам библиотеку эффектов формата .eff.

В качестве эффектов можно добавлять готовые шаблоны из предложенных на сайте https://www.rigzsoft.co.uk/download-timelinefx/ или любых других источников.

Также эффекты можно модифицировать или создавать свои через TimeLineFX редактор.

После импорта эффекта он появится в табличке с параметрами:

'''NAME''' - имя эффекта. Берется из импортированной библиотеки, можно менять.

'''tag''' - номер тега эффекта, по которому будем его запускать.

'''tlfx''' - все параметры эффекта

'''resids''' - айдишники ресурсов, используемых эффектом

Нажав на кнопку с глазом возле "Import Effect" откроется окно предварительного просмотра эффекта.

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

Также можно создавать совершенно новые свои эффекты.

В самом редакторе '''ОЧЕНЬ''' много возможностей и настроек для эффектов.

Подробно ознакомиться с документацией редактора можно по ссылке:

https://www.rigzsoft.co.uk/timelinefx-help/

Пример TimeLineFX взрыва:

[[Файл:TimeLineFXexplosion.jpg|540px]]

После создания / модификаций эффекта сохраняем его в формате .eff и импортируем в объект effect в редакторе или просто сохраняем в случае открытия редактора для модификации уже импортированного эффекта через объект effect.

== Пример ==

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

[[Category:Main objects]]

Effect

2018-06-15T10:44:00Z

Akovinenko: /* TimeLineFX редактор */

{{TOC right}}
Effect - [[Object|объект]] редактора, предназначенный для создания различных визуальных эффектов, которые визуализируется (проявляются) в зависимости от частоты кликов пользователя по заданной области проявления эффекта. 
Обьект Effect расположен в Main objects 
'''Важное замечание!''' 
Эффект БЛЮР и ДЫМ не могут быть вызваны одним экземляром класса Effect 

=Эффект БЛЮР=
Эффект блюр позволяет создавать дребезжание объекта. Например, раздвоение объекта.
==Механизм работы эффекта БЛЮР==
Ситуация:
Пользователю необходимо отключить звенящий будильник. Пользователь на экране видит дребезжащий будильник. По клику на будильник дребезжание будильника прекращается. 
Порядок действий: 
* На сцене размещаем машину состояний с графическим ресурсом будильника. Назовем ее БУД. Обработка клика на машину состояний стандартная.
* На сцене размещаем объект Effect. Положение объекта Effect должно полностью совпадать с положением машины состояний БУД!
* Свойству Объект эффекта БЛЮР устанавливаем значение машину состояний БУД. Значения других свойств эффекта БЛЮР оставляем стандартными. 

==Параметры эффекта Блюр==
===Свойства объекта Блюр===
*Объект (obj) - Объект, к которому будет применен эффект блюр.
*Продолжительность (tm) - продолжительность эффекта. По умолчанию 4000.
*Отклонение (dev)-. Чем больше отклонение, тем больше "отскакивает" в разные стороны от центра объекта По умолчанию 10. При задании значений больше 90 объект "скачет" по диагонали.
*Скорость (vel) -Скорость "дрожания" объекта. По умолчанию 1000.
*Прозрачность (al) - По умолчанию 0.5.

===Состояния===
*beg - включить проявление Блюра
*end - остановить проявление Блюра
'''Замечание!''' По умолчанию Блюр находится в состоянии end
=Эффект ДЫМ=
==Физическое объяснение работы эффекта ДЫМ==
Область проявления эффекта(ОПФ) — строго ограничена. (В данной версии редактора область только прямоугольная).ОПФ является непрерывной поверхностью и находится в ожидании клика пользователя. 
При одинарном клике внутри ОПФ проявляется объект с набором параметров, установленными в свойствах объекта Effect, и параметров, определяемых частотой, силой кликов и координатами клика внутри ОПФ. Далее этот объект будем называть излучателем. [[Файл:Распространение_1.JPG|right|250px]] 
При одинарном клике по ОПФ , излучатель направляет во все направления частицы при этом большая часть частиц распространяется вдоль отрицательной оси У (вверх). Чем дальше частицы удаляются от центра излучателя , тем они становятся светлее. На рисунке отображена картинка, которую увидит игрок. [[Файл:Распространение_2.JPG|right]] 
При наличии 2 и более излучателей, находящихся на достаточном малом расстоянии друг от друга, большая часть частиц излучателей будет распространяться по направленному отрезку, образованному двумя излучателями. На экране игрок увидит эффект как от движения ручки по бумаге. 

При наличии на экране 2 и более излучателей, удаленных друг от друга на достаточно большом расстоянии внутри ОПФ, частицы излучателя начинают взаимодействовать друг с другом. 
Пусть в области ОПФ есть 4 излучателя. На схеме цветными кружками отображены излучатели, и цветными полями отображены направления распространения частиц излучателя. Пусть необходимо определить яркость частицы в точке Z. Не вдаваясь в математические вычисления, яркость частицы в точке Z будет равна средневзвешенному значению яркости частиц, расположенных вблизи точки Z. Все частицы излучателя влияют на яркость соседних. 
[[Файл:Точка_внутри_ОПФ.JPG|right|250px]]

==Механизм работы эффекта ДЫМ==
При клике по заданной области на экране проявляется визуальный эффект, который распространяется в границах заданной области
*в зависимости от «силы» клика проявляется эффект
*в зависимости от координаты точки клика внутри ОПФ эффект будет распространяться по всем направлениям
*при одинарном клике эффект движется направленно верх.
*при увеличении частоты кликов эффект начинает двигаться направленно вверх при этом высота эффекта увеличивается
*при достижения верхней / нижней границы заданной области эффект может начать двигаться вдоль нее
*при достижении правой/левой границы эффект может начать двигаться внутрь заданной области
*при нажатии на кнопку мыши и начале движения в любую сторону внутри области эффект начнет вести себя как ручка по бумаге
*при резком отведении нажатой мышки к границе ОПФ в области , находящейся близко к границе ОПФ, создается несколько излучателей/

[[Файл:Граница_ОПФ.JPG|right|175px]] 

==Взаимодействие с картинками эффекта ДЫМ==
Пусть Effect лежит поверх картинки. 
*После рассеивания всех частиц излучателей на картинке проявится граница ОПФ. Для устранения этого эффекта рекомендуется установить прозрачность объекту Effect.
*При необходимости добавления эффекта в строго ограниченные не прямоугольной области, например, создание эффекта воды в озере, необходимо области, на которых не должен проявляться эффект, "закрыть" фоном
*По умолчанию частица эффекта белого цвета. Есть возможность подгружать частицы любого размера.

==Параметры эффекта ДЫМ==
'''Внимание! Параметры обьекта будут уточняться!''' 
===Свойства объекта Дым===
{| class="wikitable"
|'''Название параметра на английском'''
|'''Названия параметра на русском'''
|'''Название параметра в xml'''
|'''Характеристика параметра'''
|'''Значение по умолчанию'''
|-
|
|частица
|smPart
|Ресурс частицы
|Цвет частицы - белый
|-
|w
|Ширина распространения эффекта
|w
|Значения до 40. Увеличивает ширину излучения. Чем меньше значения, тем шире
|70
|-
|h
|Высота распространения эффекта
|h
|До 200. Чем больше значение, тем выше
|70
|-
|Velocity diffusion
|Скорость диффузии
|Vd
|Значение до 25. Больше скорость , больше температура
|0
|-
|Diffusion itterations
|Количество итераций диффузии
|di
|До 400
|0
|-
|Pressure diffusion
|Давление диффузии
|pd
|Больше давление, больше частиц. Рекомендуется ставить до 10
|0
|-
|Ink diffusion
|Плотность газа
|id
|Плотность до 800
|0
|-
|Velocity friction a
|Квадратичное замедление
|fva
|Замедление распространения частиц.
|0
|-
|Velocity friction b
|Линейное замедление
|fvb
|Замедление распространения частиц.
|0
|-
|Velocity friction c
|Изменение скорости на заданную величину
|fvc
|Замедление распространения частиц.
|0
|-
|Vorticity
|Завихренность
|vort
|Чем больше значение, тем больше вихрей
|0
|-
|Pressure acc
|Давление в точке
|pacc
|Создаются маленькие излучатели вокруг излучателя. Рекомендуется ставить значение до 50
|2
|-
|ink heat
|плотность тепла ???
|ih
|Вертикально вниз падают частицы
|0
|-
|Heat force
|????
|hf
|Вертикальное падение частиц
|0.1
|-
|Heat friction a
|Квадратичное трение
|hfa
|
|0.5
|-
||Heat friction b
|Линейное трение Б
|hfa
|
|0.2
|-
||Heat friction с
|Изменение скорости на заданную величину
|hfa
|
|0.01
|-
|Velocity advection
|Скорость адвекции
|va
|Скорость распространения
|150
|-
|Pressure advection
|Давление адвекци
|padv
|Параметр, влияющий на величину давления частиц
|150
|-
|Heat advection
|Температура адвекции
|ha
|Моделируемая температура, при которой распространяются частицы
|150
|-
|}
 
====Важное замечание====
*Параметры Velocity friction a, Velocity friction b, Velocity friction c,Heat friction a,Heat friction b,Heat friction c позволяют управлять процессом распространения частиц по ОПФ. Хотя эффекты, создаваемые перечисленными параметрами можно получить с использованием других.
*Одновременное использование параметров групп Velocity friction или Heat friction приведет к замедлению распространению частиц. Рекомендуется подбирать значения параметров очень аккуратно при условии, что параметр А >B>C.

===Состояния эффекта ДЫМ===
В данной версии редактора состояний нет.

===Параметры, записываемые в options.xml===
В данной версии редактора такие параметры отсутствуют

=Эффект AMBIENT WITH LIGHT=

'''Параметры''' :

*awl - Тип эффекта.
*tag - Номер эффекта.

'''Состояния'''

*awl_beg - Активировать эффект AmbientWithLight.
*awl_run - Эффект AmbientWithLight работает.
*awl_upd - Обновить параметры эффекта AmbientWithLight.
*awl_end - Деактивировать эффект AmbientWithLight.

Замечание! По умолчанию AmbientWithLight находится в состоянии awl_end.

'''Примеры подборки коэффициентов:'''

Стартовая картинка:

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

'''''1) Картинка перекрашивается в темно-синий цвет. Эффект ночи.''''' [[Файл:awl_blue.png|right]]

r="0.1, 0.0, 0.0, 0.0" 
g="0.0, 0.1, 0.0, 0.0" 
b="0.0, 0.0, 0.5, 0.0" 

'''''2) Цветной негатив.''''' [[Файл:awl_c_neg.png|right]]

r="-1.0, 0.0, 0.0, 1.0" 
g="0.0, -1.0, 0.0, 1.0" 
b="0.0, 0.0, -1.0, 1.0" 

'''''3) Черно-белая сепия.''''' [[Файл:awl_dw.png|right]]

r="1.0, 0.0, 0.0, 0.0" 
g="1.0, 0.0, 0.0, 0.0" 
b="1.0, 0.0, 0.0, 0.0" 

'''''4) Черно-белый негатив.''''' [[Файл:awl_dw_neg.png|right]]

r="-1.0, 0.0, 0.0, 1.0" 
g="-1.0, 0.0, 0.0, 1.0" 
b="-1.0, 0.0, 0.0, 1.0" 

'''Пример подключения эффекта AmbientWithLight:'''

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

=Пример использования обьекта Effect=
Примеры эффектов создаваемых с использованием обьекта Effect расположены по ссылке. В проекте 28 экранов, на каждом из которых расположен один пример эффекта с описанием применяемых параметров. 
[[Файл:Пример_экрана_с_эффектом.JPG|500px]] 

== Перекрашивание графики ==
Для начала - перекрашиваемая графика должна быть максимально осветлённая ( чтобы точнее перекрасить цвет, чем темнее графика - тех меньше будет влиять перекрашивание).

Имеем графику:

[[Файл:Bg seryj copy.png|430px]]

Далее, производим махинации - узнаём при помощи пипетки ( Photoshop ) цвет эталлоного пикселя ( один и тот же пиксель, на нужной и на осветлённой графиках).
Заносим полученные значения RGB каналов в таблицу, и для каждого канала узнаём процент цвета ( делим нужный цвет на эталонный).

[[Файл:Colors.ods - LibreOffice Calc.jpg|960px]]

Полученные % используем в объекте effect:

[[Файл:Splitmanager_setup_awl_6.jpg|460px]]

Далее всё по обычному - указываем тип эффекта awl, указываем номер эффекта и передаём сост. "awl_beg", результат:
[[Файл:66c7052ca8.jpg|960px]]

=TimeLineFX эффекты=
TimeLineFX эффекты - эффекты, которые создаются с помощью TimeLineFX редактора или из готовых шаблонов.

==Описание эффекта==
Перед запуском TimeLineFX эффекта нужно записать в объект effect параметры '''eftype''' = particle, '''eftag''' = N (N - номер тега эффекта).

Для запуска эффекта необходимо передать объекту effect состояние '''particle_beg'''.

Для остановки эффекта необходимо передать объекту effect состояние '''particle_end'''.

Пример запуска эффекта через машину состояний показан ниже.

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

Для добавления нового эффекта, в настройках объекта effect используем кнопку '''"Import Effect"'''.

В открытом окне выбираем нужную нам библиотеку эффектов формата .eff.

В качестве эффектов можно добавлять готовые шаблоны из предложенных на сайте https://www.rigzsoft.co.uk/download-timelinefx/ или любых других источников.

Также эффекты можно модифицировать или создавать свои через TimeLineFX редактор.

После импорта эффекта он появится в табличке с параметрами:

'''NAME''' - имя эффекта. Берется из импортированной библиотеки, можно менять.

'''tag''' - номер тега эффекта, по которому будем его запускать.

'''tlfx''' - все параметры эффекта

'''resids''' - айдишники ресурсов, используемых эффектом

Нажав на кнопку с глазом возле "Import Effect" откроется окно предварительного просмотра эффекта.

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

Также можно создавать совершенно новые свои эффекты.

В самом редакторе '''ОЧЕНЬ''' много возможностей и настроек для эффектов.

Подробно ознакомиться с документацией редактора можно по ссылке:

https://www.rigzsoft.co.uk/timelinefx-help/

Пример TimeLineFX взрыва:

[[Файл:TimeLineFXexplosion.jpg|540px]]

После создания / модификаций эффекта сохраняем его в формате .eff и импортируем в объект effect в редакторе или просто сохраняем в случае открытия редактора для модификации уже импортированного эффекта через объект effect.

== Пример ==

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

[[Category:Main objects]]

Effect

2018-06-15T10:41:42Z

Akovinenko: /* TimeLineFX редактор */

{{TOC right}}
Effect - [[Object|объект]] редактора, предназначенный для создания различных визуальных эффектов, которые визуализируется (проявляются) в зависимости от частоты кликов пользователя по заданной области проявления эффекта. 
Обьект Effect расположен в Main objects 
'''Важное замечание!''' 
Эффект БЛЮР и ДЫМ не могут быть вызваны одним экземляром класса Effect 

=Эффект БЛЮР=
Эффект блюр позволяет создавать дребезжание объекта. Например, раздвоение объекта.
==Механизм работы эффекта БЛЮР==
Ситуация:
Пользователю необходимо отключить звенящий будильник. Пользователь на экране видит дребезжащий будильник. По клику на будильник дребезжание будильника прекращается. 
Порядок действий: 
* На сцене размещаем машину состояний с графическим ресурсом будильника. Назовем ее БУД. Обработка клика на машину состояний стандартная.
* На сцене размещаем объект Effect. Положение объекта Effect должно полностью совпадать с положением машины состояний БУД!
* Свойству Объект эффекта БЛЮР устанавливаем значение машину состояний БУД. Значения других свойств эффекта БЛЮР оставляем стандартными. 

==Параметры эффекта Блюр==
===Свойства объекта Блюр===
*Объект (obj) - Объект, к которому будет применен эффект блюр.
*Продолжительность (tm) - продолжительность эффекта. По умолчанию 4000.
*Отклонение (dev)-. Чем больше отклонение, тем больше "отскакивает" в разные стороны от центра объекта По умолчанию 10. При задании значений больше 90 объект "скачет" по диагонали.
*Скорость (vel) -Скорость "дрожания" объекта. По умолчанию 1000.
*Прозрачность (al) - По умолчанию 0.5.

===Состояния===
*beg - включить проявление Блюра
*end - остановить проявление Блюра
'''Замечание!''' По умолчанию Блюр находится в состоянии end
=Эффект ДЫМ=
==Физическое объяснение работы эффекта ДЫМ==
Область проявления эффекта(ОПФ) — строго ограничена. (В данной версии редактора область только прямоугольная).ОПФ является непрерывной поверхностью и находится в ожидании клика пользователя. 
При одинарном клике внутри ОПФ проявляется объект с набором параметров, установленными в свойствах объекта Effect, и параметров, определяемых частотой, силой кликов и координатами клика внутри ОПФ. Далее этот объект будем называть излучателем. [[Файл:Распространение_1.JPG|right|250px]] 
При одинарном клике по ОПФ , излучатель направляет во все направления частицы при этом большая часть частиц распространяется вдоль отрицательной оси У (вверх). Чем дальше частицы удаляются от центра излучателя , тем они становятся светлее. На рисунке отображена картинка, которую увидит игрок. [[Файл:Распространение_2.JPG|right]] 
При наличии 2 и более излучателей, находящихся на достаточном малом расстоянии друг от друга, большая часть частиц излучателей будет распространяться по направленному отрезку, образованному двумя излучателями. На экране игрок увидит эффект как от движения ручки по бумаге. 

При наличии на экране 2 и более излучателей, удаленных друг от друга на достаточно большом расстоянии внутри ОПФ, частицы излучателя начинают взаимодействовать друг с другом. 
Пусть в области ОПФ есть 4 излучателя. На схеме цветными кружками отображены излучатели, и цветными полями отображены направления распространения частиц излучателя. Пусть необходимо определить яркость частицы в точке Z. Не вдаваясь в математические вычисления, яркость частицы в точке Z будет равна средневзвешенному значению яркости частиц, расположенных вблизи точки Z. Все частицы излучателя влияют на яркость соседних. 
[[Файл:Точка_внутри_ОПФ.JPG|right|250px]]

==Механизм работы эффекта ДЫМ==
При клике по заданной области на экране проявляется визуальный эффект, который распространяется в границах заданной области
*в зависимости от «силы» клика проявляется эффект
*в зависимости от координаты точки клика внутри ОПФ эффект будет распространяться по всем направлениям
*при одинарном клике эффект движется направленно верх.
*при увеличении частоты кликов эффект начинает двигаться направленно вверх при этом высота эффекта увеличивается
*при достижения верхней / нижней границы заданной области эффект может начать двигаться вдоль нее
*при достижении правой/левой границы эффект может начать двигаться внутрь заданной области
*при нажатии на кнопку мыши и начале движения в любую сторону внутри области эффект начнет вести себя как ручка по бумаге
*при резком отведении нажатой мышки к границе ОПФ в области , находящейся близко к границе ОПФ, создается несколько излучателей/

[[Файл:Граница_ОПФ.JPG|right|175px]] 

==Взаимодействие с картинками эффекта ДЫМ==
Пусть Effect лежит поверх картинки. 
*После рассеивания всех частиц излучателей на картинке проявится граница ОПФ. Для устранения этого эффекта рекомендуется установить прозрачность объекту Effect.
*При необходимости добавления эффекта в строго ограниченные не прямоугольной области, например, создание эффекта воды в озере, необходимо области, на которых не должен проявляться эффект, "закрыть" фоном
*По умолчанию частица эффекта белого цвета. Есть возможность подгружать частицы любого размера.

==Параметры эффекта ДЫМ==
'''Внимание! Параметры обьекта будут уточняться!''' 
===Свойства объекта Дым===
{| class="wikitable"
|'''Название параметра на английском'''
|'''Названия параметра на русском'''
|'''Название параметра в xml'''
|'''Характеристика параметра'''
|'''Значение по умолчанию'''
|-
|
|частица
|smPart
|Ресурс частицы
|Цвет частицы - белый
|-
|w
|Ширина распространения эффекта
|w
|Значения до 40. Увеличивает ширину излучения. Чем меньше значения, тем шире
|70
|-
|h
|Высота распространения эффекта
|h
|До 200. Чем больше значение, тем выше
|70
|-
|Velocity diffusion
|Скорость диффузии
|Vd
|Значение до 25. Больше скорость , больше температура
|0
|-
|Diffusion itterations
|Количество итераций диффузии
|di
|До 400
|0
|-
|Pressure diffusion
|Давление диффузии
|pd
|Больше давление, больше частиц. Рекомендуется ставить до 10
|0
|-
|Ink diffusion
|Плотность газа
|id
|Плотность до 800
|0
|-
|Velocity friction a
|Квадратичное замедление
|fva
|Замедление распространения частиц.
|0
|-
|Velocity friction b
|Линейное замедление
|fvb
|Замедление распространения частиц.
|0
|-
|Velocity friction c
|Изменение скорости на заданную величину
|fvc
|Замедление распространения частиц.
|0
|-
|Vorticity
|Завихренность
|vort
|Чем больше значение, тем больше вихрей
|0
|-
|Pressure acc
|Давление в точке
|pacc
|Создаются маленькие излучатели вокруг излучателя. Рекомендуется ставить значение до 50
|2
|-
|ink heat
|плотность тепла ???
|ih
|Вертикально вниз падают частицы
|0
|-
|Heat force
|????
|hf
|Вертикальное падение частиц
|0.1
|-
|Heat friction a
|Квадратичное трение
|hfa
|
|0.5
|-
||Heat friction b
|Линейное трение Б
|hfa
|
|0.2
|-
||Heat friction с
|Изменение скорости на заданную величину
|hfa
|
|0.01
|-
|Velocity advection
|Скорость адвекции
|va
|Скорость распространения
|150
|-
|Pressure advection
|Давление адвекци
|padv
|Параметр, влияющий на величину давления частиц
|150
|-
|Heat advection
|Температура адвекции
|ha
|Моделируемая температура, при которой распространяются частицы
|150
|-
|}
 
====Важное замечание====
*Параметры Velocity friction a, Velocity friction b, Velocity friction c,Heat friction a,Heat friction b,Heat friction c позволяют управлять процессом распространения частиц по ОПФ. Хотя эффекты, создаваемые перечисленными параметрами можно получить с использованием других.
*Одновременное использование параметров групп Velocity friction или Heat friction приведет к замедлению распространению частиц. Рекомендуется подбирать значения параметров очень аккуратно при условии, что параметр А >B>C.

===Состояния эффекта ДЫМ===
В данной версии редактора состояний нет.

===Параметры, записываемые в options.xml===
В данной версии редактора такие параметры отсутствуют

=Эффект AMBIENT WITH LIGHT=

'''Параметры''' :

*awl - Тип эффекта.
*tag - Номер эффекта.

'''Состояния'''

*awl_beg - Активировать эффект AmbientWithLight.
*awl_run - Эффект AmbientWithLight работает.
*awl_upd - Обновить параметры эффекта AmbientWithLight.
*awl_end - Деактивировать эффект AmbientWithLight.

Замечание! По умолчанию AmbientWithLight находится в состоянии awl_end.

'''Примеры подборки коэффициентов:'''

Стартовая картинка:

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

'''''1) Картинка перекрашивается в темно-синий цвет. Эффект ночи.''''' [[Файл:awl_blue.png|right]]

r="0.1, 0.0, 0.0, 0.0" 
g="0.0, 0.1, 0.0, 0.0" 
b="0.0, 0.0, 0.5, 0.0" 

'''''2) Цветной негатив.''''' [[Файл:awl_c_neg.png|right]]

r="-1.0, 0.0, 0.0, 1.0" 
g="0.0, -1.0, 0.0, 1.0" 
b="0.0, 0.0, -1.0, 1.0" 

'''''3) Черно-белая сепия.''''' [[Файл:awl_dw.png|right]]

r="1.0, 0.0, 0.0, 0.0" 
g="1.0, 0.0, 0.0, 0.0" 
b="1.0, 0.0, 0.0, 0.0" 

'''''4) Черно-белый негатив.''''' [[Файл:awl_dw_neg.png|right]]

r="-1.0, 0.0, 0.0, 1.0" 
g="-1.0, 0.0, 0.0, 1.0" 
b="-1.0, 0.0, 0.0, 1.0" 

'''Пример подключения эффекта AmbientWithLight:'''

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

=Пример использования обьекта Effect=
Примеры эффектов создаваемых с использованием обьекта Effect расположены по ссылке. В проекте 28 экранов, на каждом из которых расположен один пример эффекта с описанием применяемых параметров. 
[[Файл:Пример_экрана_с_эффектом.JPG|500px]] 

== Перекрашивание графики ==
Для начала - перекрашиваемая графика должна быть максимально осветлённая ( чтобы точнее перекрасить цвет, чем темнее графика - тех меньше будет влиять перекрашивание).

Имеем графику:

[[Файл:Bg seryj copy.png|430px]]

Далее, производим махинации - узнаём при помощи пипетки ( Photoshop ) цвет эталлоного пикселя ( один и тот же пиксель, на нужной и на осветлённой графиках).
Заносим полученные значения RGB каналов в таблицу, и для каждого канала узнаём процент цвета ( делим нужный цвет на эталонный).

[[Файл:Colors.ods - LibreOffice Calc.jpg|960px]]

Полученные % используем в объекте effect:

[[Файл:Splitmanager_setup_awl_6.jpg|460px]]

Далее всё по обычному - указываем тип эффекта awl, указываем номер эффекта и передаём сост. "awl_beg", результат:
[[Файл:66c7052ca8.jpg|960px]]

=TimeLineFX эффекты=
TimeLineFX эффекты - эффекты, которые создаются с помощью TimeLineFX редактора или из готовых шаблонов.

==Описание эффекта==
Перед запуском TimeLineFX эффекта нужно записать в объект effect параметры '''eftype''' = particle, '''eftag''' = N (N - номер тега эффекта).

Для запуска эффекта необходимо передать объекту effect состояние '''particle_beg'''.

Для остановки эффекта необходимо передать объекту effect состояние '''particle_end'''.

Пример запуска эффекта через машину состояний показан ниже.

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

Для добавления нового эффекта, в настройках объекта effect используем кнопку '''"Import Effect"'''.

В открытом окне выбираем нужную нам библиотеку эффектов формата .eff.

В качестве эффектов можно добавлять готовые шаблоны из предложенных на сайте https://www.rigzsoft.co.uk/download-timelinefx/ или любых других источников.

Также эффекты можно модифицировать или создавать свои через TimeLineFX редактор.

После импорта эффекта он появится в табличке с параметрами:

'''NAME''' - имя эффекта. Берется из импортированной библиотеки, можно менять.

'''tag''' - номер тега эффекта, по которому будем его запускать.

'''tlfx''' - все параметры эффекта

'''resids''' - айдишники ресурсов, используемых эффектом

Нажав на кнопку с глазом возле "Import Effect" откроется окно предварительного просмотра эффекта.

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

Также можно создавать совершенно новые свои эффекты.

В самом редакторе '''ОЧЕНЬ''' много возможностей и настроек для эффектов.

Подробно ознакомиться с документацией редактора можно по ссылке:

https://www.rigzsoft.co.uk/timelinefx-help/

После создания / модификаций эффекта сохраняем его в формате .eff и импортируем в объект effect в редакторе или просто сохраняем в случае открытия редактора для модификации уже импортированного эффекта через объект effect.

== Пример ==

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

[[Category:Main objects]]

Файл:TimeLineFXexplosion.jpg

2018-06-15T10:41:13Z

Akovinenko:

Effect

2018-06-15T08:03:04Z

Akovinenko:

{{TOC right}}
Effect - [[Object|объект]] редактора, предназначенный для создания различных визуальных эффектов, которые визуализируется (проявляются) в зависимости от частоты кликов пользователя по заданной области проявления эффекта. 
Обьект Effect расположен в Main objects 
'''Важное замечание!''' 
Эффект БЛЮР и ДЫМ не могут быть вызваны одним экземляром класса Effect 

=Эффект БЛЮР=
Эффект блюр позволяет создавать дребезжание объекта. Например, раздвоение объекта.
==Механизм работы эффекта БЛЮР==
Ситуация:
Пользователю необходимо отключить звенящий будильник. Пользователь на экране видит дребезжащий будильник. По клику на будильник дребезжание будильника прекращается. 
Порядок действий: 
* На сцене размещаем машину состояний с графическим ресурсом будильника. Назовем ее БУД. Обработка клика на машину состояний стандартная.
* На сцене размещаем объект Effect. Положение объекта Effect должно полностью совпадать с положением машины состояний БУД!
* Свойству Объект эффекта БЛЮР устанавливаем значение машину состояний БУД. Значения других свойств эффекта БЛЮР оставляем стандартными. 

==Параметры эффекта Блюр==
===Свойства объекта Блюр===
*Объект (obj) - Объект, к которому будет применен эффект блюр.
*Продолжительность (tm) - продолжительность эффекта. По умолчанию 4000.
*Отклонение (dev)-. Чем больше отклонение, тем больше "отскакивает" в разные стороны от центра объекта По умолчанию 10. При задании значений больше 90 объект "скачет" по диагонали.
*Скорость (vel) -Скорость "дрожания" объекта. По умолчанию 1000.
*Прозрачность (al) - По умолчанию 0.5.

===Состояния===
*beg - включить проявление Блюра
*end - остановить проявление Блюра
'''Замечание!''' По умолчанию Блюр находится в состоянии end
=Эффект ДЫМ=
==Физическое объяснение работы эффекта ДЫМ==
Область проявления эффекта(ОПФ) — строго ограничена. (В данной версии редактора область только прямоугольная).ОПФ является непрерывной поверхностью и находится в ожидании клика пользователя. 
При одинарном клике внутри ОПФ проявляется объект с набором параметров, установленными в свойствах объекта Effect, и параметров, определяемых частотой, силой кликов и координатами клика внутри ОПФ. Далее этот объект будем называть излучателем. [[Файл:Распространение_1.JPG|right|250px]] 
При одинарном клике по ОПФ , излучатель направляет во все направления частицы при этом большая часть частиц распространяется вдоль отрицательной оси У (вверх). Чем дальше частицы удаляются от центра излучателя , тем они становятся светлее. На рисунке отображена картинка, которую увидит игрок. [[Файл:Распространение_2.JPG|right]] 
При наличии 2 и более излучателей, находящихся на достаточном малом расстоянии друг от друга, большая часть частиц излучателей будет распространяться по направленному отрезку, образованному двумя излучателями. На экране игрок увидит эффект как от движения ручки по бумаге. 

При наличии на экране 2 и более излучателей, удаленных друг от друга на достаточно большом расстоянии внутри ОПФ, частицы излучателя начинают взаимодействовать друг с другом. 
Пусть в области ОПФ есть 4 излучателя. На схеме цветными кружками отображены излучатели, и цветными полями отображены направления распространения частиц излучателя. Пусть необходимо определить яркость частицы в точке Z. Не вдаваясь в математические вычисления, яркость частицы в точке Z будет равна средневзвешенному значению яркости частиц, расположенных вблизи точки Z. Все частицы излучателя влияют на яркость соседних. 
[[Файл:Точка_внутри_ОПФ.JPG|right|250px]]

==Механизм работы эффекта ДЫМ==
При клике по заданной области на экране проявляется визуальный эффект, который распространяется в границах заданной области
*в зависимости от «силы» клика проявляется эффект
*в зависимости от координаты точки клика внутри ОПФ эффект будет распространяться по всем направлениям
*при одинарном клике эффект движется направленно верх.
*при увеличении частоты кликов эффект начинает двигаться направленно вверх при этом высота эффекта увеличивается
*при достижения верхней / нижней границы заданной области эффект может начать двигаться вдоль нее
*при достижении правой/левой границы эффект может начать двигаться внутрь заданной области
*при нажатии на кнопку мыши и начале движения в любую сторону внутри области эффект начнет вести себя как ручка по бумаге
*при резком отведении нажатой мышки к границе ОПФ в области , находящейся близко к границе ОПФ, создается несколько излучателей/

[[Файл:Граница_ОПФ.JPG|right|175px]] 

==Взаимодействие с картинками эффекта ДЫМ==
Пусть Effect лежит поверх картинки. 
*После рассеивания всех частиц излучателей на картинке проявится граница ОПФ. Для устранения этого эффекта рекомендуется установить прозрачность объекту Effect.
*При необходимости добавления эффекта в строго ограниченные не прямоугольной области, например, создание эффекта воды в озере, необходимо области, на которых не должен проявляться эффект, "закрыть" фоном
*По умолчанию частица эффекта белого цвета. Есть возможность подгружать частицы любого размера.

==Параметры эффекта ДЫМ==
'''Внимание! Параметры обьекта будут уточняться!''' 
===Свойства объекта Дым===
{| class="wikitable"
|'''Название параметра на английском'''
|'''Названия параметра на русском'''
|'''Название параметра в xml'''
|'''Характеристика параметра'''
|'''Значение по умолчанию'''
|-
|
|частица
|smPart
|Ресурс частицы
|Цвет частицы - белый
|-
|w
|Ширина распространения эффекта
|w
|Значения до 40. Увеличивает ширину излучения. Чем меньше значения, тем шире
|70
|-
|h
|Высота распространения эффекта
|h
|До 200. Чем больше значение, тем выше
|70
|-
|Velocity diffusion
|Скорость диффузии
|Vd
|Значение до 25. Больше скорость , больше температура
|0
|-
|Diffusion itterations
|Количество итераций диффузии
|di
|До 400
|0
|-
|Pressure diffusion
|Давление диффузии
|pd
|Больше давление, больше частиц. Рекомендуется ставить до 10
|0
|-
|Ink diffusion
|Плотность газа
|id
|Плотность до 800
|0
|-
|Velocity friction a
|Квадратичное замедление
|fva
|Замедление распространения частиц.
|0
|-
|Velocity friction b
|Линейное замедление
|fvb
|Замедление распространения частиц.
|0
|-
|Velocity friction c
|Изменение скорости на заданную величину
|fvc
|Замедление распространения частиц.
|0
|-
|Vorticity
|Завихренность
|vort
|Чем больше значение, тем больше вихрей
|0
|-
|Pressure acc
|Давление в точке
|pacc
|Создаются маленькие излучатели вокруг излучателя. Рекомендуется ставить значение до 50
|2
|-
|ink heat
|плотность тепла ???
|ih
|Вертикально вниз падают частицы
|0
|-
|Heat force
|????
|hf
|Вертикальное падение частиц
|0.1
|-
|Heat friction a
|Квадратичное трение
|hfa
|
|0.5
|-
||Heat friction b
|Линейное трение Б
|hfa
|
|0.2
|-
||Heat friction с
|Изменение скорости на заданную величину
|hfa
|
|0.01
|-
|Velocity advection
|Скорость адвекции
|va
|Скорость распространения
|150
|-
|Pressure advection
|Давление адвекци
|padv
|Параметр, влияющий на величину давления частиц
|150
|-
|Heat advection
|Температура адвекции
|ha
|Моделируемая температура, при которой распространяются частицы
|150
|-
|}
 
====Важное замечание====
*Параметры Velocity friction a, Velocity friction b, Velocity friction c,Heat friction a,Heat friction b,Heat friction c позволяют управлять процессом распространения частиц по ОПФ. Хотя эффекты, создаваемые перечисленными параметрами можно получить с использованием других.
*Одновременное использование параметров групп Velocity friction или Heat friction приведет к замедлению распространению частиц. Рекомендуется подбирать значения параметров очень аккуратно при условии, что параметр А >B>C.

===Состояния эффекта ДЫМ===
В данной версии редактора состояний нет.

===Параметры, записываемые в options.xml===
В данной версии редактора такие параметры отсутствуют

=Эффект AMBIENT WITH LIGHT=

'''Параметры''' :

*awl - Тип эффекта.
*tag - Номер эффекта.

'''Состояния'''

*awl_beg - Активировать эффект AmbientWithLight.
*awl_run - Эффект AmbientWithLight работает.
*awl_upd - Обновить параметры эффекта AmbientWithLight.
*awl_end - Деактивировать эффект AmbientWithLight.

Замечание! По умолчанию AmbientWithLight находится в состоянии awl_end.

'''Примеры подборки коэффициентов:'''

Стартовая картинка:

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

'''''1) Картинка перекрашивается в темно-синий цвет. Эффект ночи.''''' [[Файл:awl_blue.png|right]]

r="0.1, 0.0, 0.0, 0.0" 
g="0.0, 0.1, 0.0, 0.0" 
b="0.0, 0.0, 0.5, 0.0" 

'''''2) Цветной негатив.''''' [[Файл:awl_c_neg.png|right]]

r="-1.0, 0.0, 0.0, 1.0" 
g="0.0, -1.0, 0.0, 1.0" 
b="0.0, 0.0, -1.0, 1.0" 

'''''3) Черно-белая сепия.''''' [[Файл:awl_dw.png|right]]

r="1.0, 0.0, 0.0, 0.0" 
g="1.0, 0.0, 0.0, 0.0" 
b="1.0, 0.0, 0.0, 0.0" 

'''''4) Черно-белый негатив.''''' [[Файл:awl_dw_neg.png|right]]

r="-1.0, 0.0, 0.0, 1.0" 
g="-1.0, 0.0, 0.0, 1.0" 
b="-1.0, 0.0, 0.0, 1.0" 

'''Пример подключения эффекта AmbientWithLight:'''

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

=Пример использования обьекта Effect=
Примеры эффектов создаваемых с использованием обьекта Effect расположены по ссылке. В проекте 28 экранов, на каждом из которых расположен один пример эффекта с описанием применяемых параметров. 
[[Файл:Пример_экрана_с_эффектом.JPG|500px]] 

== Перекрашивание графики ==
Для начала - перекрашиваемая графика должна быть максимально осветлённая ( чтобы точнее перекрасить цвет, чем темнее графика - тех меньше будет влиять перекрашивание).

Имеем графику:

[[Файл:Bg seryj copy.png|430px]]

Далее, производим махинации - узнаём при помощи пипетки ( Photoshop ) цвет эталлоного пикселя ( один и тот же пиксель, на нужной и на осветлённой графиках).
Заносим полученные значения RGB каналов в таблицу, и для каждого канала узнаём процент цвета ( делим нужный цвет на эталонный).

[[Файл:Colors.ods - LibreOffice Calc.jpg|960px]]

Полученные % используем в объекте effect:

[[Файл:Splitmanager_setup_awl_6.jpg|460px]]

Далее всё по обычному - указываем тип эффекта awl, указываем номер эффекта и передаём сост. "awl_beg", результат:
[[Файл:66c7052ca8.jpg|960px]]

=TimeLineFX эффекты=
TimeLineFX эффекты - эффекты, которые создаются с помощью TimeLineFX редактора или из готовых шаблонов.

==Описание эффекта==
Перед запуском TimeLineFX эффекта нужно записать в объект effect параметры '''eftype''' = particle, '''eftag''' = N (N - номер тега эффекта).

Для запуска эффекта необходимо передать объекту effect состояние '''particle_beg'''.

Для остановки эффекта необходимо передать объекту effect состояние '''particle_end'''.

Пример запуска эффекта через машину состояний показан ниже.

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

Для добавления нового эффекта, в настройках объекта effect используем кнопку '''"Import Effect"'''.

В открытом окне выбираем нужную нам библиотеку эффектов формата .eff.

В качестве эффектов можно добавлять готовые шаблоны из предложенных на сайте https://www.rigzsoft.co.uk/download-timelinefx/ или любых других источников.

Также эффекты можно модифицировать или создавать свои через TimeLineFX редактор.

После импорта эффекта он появится в табличке с параметрами:

'''NAME''' - имя эффекта. Берется из импортированной библиотеки, можно менять.

'''tag''' - номер тега эффекта, по которому будем его запускать.

'''tlfx''' - все параметры эффекта

'''resids''' - айдишники ресурсов, используемых эффектом

Нажав на кнопку с глазом возле "Import Effect" откроется окно предварительного просмотра эффекта.

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

Также можно создавать совершенно новые свои эффекты.

В самом редакторе '''ОЧЕНЬ''' много возможностей и настроек для эффектов.

Подробно ознакомиться с документацией редактора можно по ссылке:

https://www.rigzsoft.co.uk/timelinefx-help/

После создания / модификаций эффекта сохраняем его в формате .eff и импортируем в объект effect в редакторе или просто сохраняем в случае открытия редактора для модификации уже импортированного эффекта через объект effect.

== Пример ==

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

[[Category:Main objects]]

Effect

2018-06-15T08:00:00Z

Akovinenko:

{{TOC right}}
Effect - [[Object|объект]] редактора, предназначенный для создания различных визуальных эффектов, которые визуализируется (проявляются) в зависимости от частоты кликов пользователя по заданной области проявления эффекта. 
Обьект Effect расположен в Main objects 
'''Важное замечание!''' 
Эффект БЛЮР и ДЫМ не могут быть вызваны одним экземляром класса Effect 

=Эффект БЛЮР=
Эффект блюр позволяет создавать дребезжание объекта. Например, раздвоение объекта.
==Механизм работы эффекта БЛЮР==
Ситуация:
Пользователю необходимо отключить звенящий будильник. Пользователь на экране видит дребезжащий будильник. По клику на будильник дребезжание будильника прекращается. 
Порядок действий: 
* На сцене размещаем машину состояний с графическим ресурсом будильника. Назовем ее БУД. Обработка клика на машину состояний стандартная.
* На сцене размещаем объект Effect. Положение объекта Effect должно полностью совпадать с положением машины состояний БУД!
* Свойству Объект эффекта БЛЮР устанавливаем значение машину состояний БУД. Значения других свойств эффекта БЛЮР оставляем стандартными. 

==Параметры эффекта Блюр==
===Свойства объекта Блюр===
*Объект (obj) - Объект, к которому будет применен эффект блюр.
*Продолжительность (tm) - продолжительность эффекта. По умолчанию 4000.
*Отклонение (dev)-. Чем больше отклонение, тем больше "отскакивает" в разные стороны от центра объекта По умолчанию 10. При задании значений больше 90 объект "скачет" по диагонали.
*Скорость (vel) -Скорость "дрожания" объекта. По умолчанию 1000.
*Прозрачность (al) - По умолчанию 0.5.

===Состояния===
*beg - включить проявление Блюра
*end - остановить проявление Блюра
'''Замечание!''' По умолчанию Блюр находится в состоянии end
=Эффект ДЫМ=
==Физическое объяснение работы эффекта ДЫМ==
Область проявления эффекта(ОПФ) — строго ограничена. (В данной версии редактора область только прямоугольная).ОПФ является непрерывной поверхностью и находится в ожидании клика пользователя. 
При одинарном клике внутри ОПФ проявляется объект с набором параметров, установленными в свойствах объекта Effect, и параметров, определяемых частотой, силой кликов и координатами клика внутри ОПФ. Далее этот объект будем называть излучателем. [[Файл:Распространение_1.JPG|right|250px]] 
При одинарном клике по ОПФ , излучатель направляет во все направления частицы при этом большая часть частиц распространяется вдоль отрицательной оси У (вверх). Чем дальше частицы удаляются от центра излучателя , тем они становятся светлее. На рисунке отображена картинка, которую увидит игрок. [[Файл:Распространение_2.JPG|right]] 
При наличии 2 и более излучателей, находящихся на достаточном малом расстоянии друг от друга, большая часть частиц излучателей будет распространяться по направленному отрезку, образованному двумя излучателями. На экране игрок увидит эффект как от движения ручки по бумаге. 

При наличии на экране 2 и более излучателей, удаленных друг от друга на достаточно большом расстоянии внутри ОПФ, частицы излучателя начинают взаимодействовать друг с другом. 
Пусть в области ОПФ есть 4 излучателя. На схеме цветными кружками отображены излучатели, и цветными полями отображены направления распространения частиц излучателя. Пусть необходимо определить яркость частицы в точке Z. Не вдаваясь в математические вычисления, яркость частицы в точке Z будет равна средневзвешенному значению яркости частиц, расположенных вблизи точки Z. Все частицы излучателя влияют на яркость соседних. 
[[Файл:Точка_внутри_ОПФ.JPG|right|250px]]

==Механизм работы эффекта ДЫМ==
При клике по заданной области на экране проявляется визуальный эффект, который распространяется в границах заданной области
*в зависимости от «силы» клика проявляется эффект
*в зависимости от координаты точки клика внутри ОПФ эффект будет распространяться по всем направлениям
*при одинарном клике эффект движется направленно верх.
*при увеличении частоты кликов эффект начинает двигаться направленно вверх при этом высота эффекта увеличивается
*при достижения верхней / нижней границы заданной области эффект может начать двигаться вдоль нее
*при достижении правой/левой границы эффект может начать двигаться внутрь заданной области
*при нажатии на кнопку мыши и начале движения в любую сторону внутри области эффект начнет вести себя как ручка по бумаге
*при резком отведении нажатой мышки к границе ОПФ в области , находящейся близко к границе ОПФ, создается несколько излучателей/

[[Файл:Граница_ОПФ.JPG|right|175px]] 

==Взаимодействие с картинками эффекта ДЫМ==
Пусть Effect лежит поверх картинки. 
*После рассеивания всех частиц излучателей на картинке проявится граница ОПФ. Для устранения этого эффекта рекомендуется установить прозрачность объекту Effect.
*При необходимости добавления эффекта в строго ограниченные не прямоугольной области, например, создание эффекта воды в озере, необходимо области, на которых не должен проявляться эффект, "закрыть" фоном
*По умолчанию частица эффекта белого цвета. Есть возможность подгружать частицы любого размера.

==Параметры эффекта ДЫМ==
'''Внимание! Параметры обьекта будут уточняться!''' 
===Свойства объекта Дым===
{| class="wikitable"
|'''Название параметра на английском'''
|'''Названия параметра на русском'''
|'''Название параметра в xml'''
|'''Характеристика параметра'''
|'''Значение по умолчанию'''
|-
|
|частица
|smPart
|Ресурс частицы
|Цвет частицы - белый
|-
|w
|Ширина распространения эффекта
|w
|Значения до 40. Увеличивает ширину излучения. Чем меньше значения, тем шире
|70
|-
|h
|Высота распространения эффекта
|h
|До 200. Чем больше значение, тем выше
|70
|-
|Velocity diffusion
|Скорость диффузии
|Vd
|Значение до 25. Больше скорость , больше температура
|0
|-
|Diffusion itterations
|Количество итераций диффузии
|di
|До 400
|0
|-
|Pressure diffusion
|Давление диффузии
|pd
|Больше давление, больше частиц. Рекомендуется ставить до 10
|0
|-
|Ink diffusion
|Плотность газа
|id
|Плотность до 800
|0
|-
|Velocity friction a
|Квадратичное замедление
|fva
|Замедление распространения частиц.
|0
|-
|Velocity friction b
|Линейное замедление
|fvb
|Замедление распространения частиц.
|0
|-
|Velocity friction c
|Изменение скорости на заданную величину
|fvc
|Замедление распространения частиц.
|0
|-
|Vorticity
|Завихренность
|vort
|Чем больше значение, тем больше вихрей
|0
|-
|Pressure acc
|Давление в точке
|pacc
|Создаются маленькие излучатели вокруг излучателя. Рекомендуется ставить значение до 50
|2
|-
|ink heat
|плотность тепла ???
|ih
|Вертикально вниз падают частицы
|0
|-
|Heat force
|????
|hf
|Вертикальное падение частиц
|0.1
|-
|Heat friction a
|Квадратичное трение
|hfa
|
|0.5
|-
||Heat friction b
|Линейное трение Б
|hfa
|
|0.2
|-
||Heat friction с
|Изменение скорости на заданную величину
|hfa
|
|0.01
|-
|Velocity advection
|Скорость адвекции
|va
|Скорость распространения
|150
|-
|Pressure advection
|Давление адвекци
|padv
|Параметр, влияющий на величину давления частиц
|150
|-
|Heat advection
|Температура адвекции
|ha
|Моделируемая температура, при которой распространяются частицы
|150
|-
|}
 
====Важное замечание====
*Параметры Velocity friction a, Velocity friction b, Velocity friction c,Heat friction a,Heat friction b,Heat friction c позволяют управлять процессом распространения частиц по ОПФ. Хотя эффекты, создаваемые перечисленными параметрами можно получить с использованием других.
*Одновременное использование параметров групп Velocity friction или Heat friction приведет к замедлению распространению частиц. Рекомендуется подбирать значения параметров очень аккуратно при условии, что параметр А >B>C.

===Состояния эффекта ДЫМ===
В данной версии редактора состояний нет.

===Параметры, записываемые в options.xml===
В данной версии редактора такие параметры отсутствуют

=Эффект AMBIENT WITH LIGHT=

'''Параметры''' :

*awl - Тип эффекта.
*tag - Номер эффекта.

'''Состояния'''

*awl_beg - Активировать эффект AmbientWithLight.
*awl_run - Эффект AmbientWithLight работает.
*awl_upd - Обновить параметры эффекта AmbientWithLight.
*awl_end - Деактивировать эффект AmbientWithLight.

Замечание! По умолчанию AmbientWithLight находится в состоянии awl_end.

'''Примеры подборки коэффициентов:'''

Стартовая картинка:

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

'''''1) Картинка перекрашивается в темно-синий цвет. Эффект ночи.''''' [[Файл:awl_blue.png|right]]

r="0.1, 0.0, 0.0, 0.0" 
g="0.0, 0.1, 0.0, 0.0" 
b="0.0, 0.0, 0.5, 0.0" 

'''''2) Цветной негатив.''''' [[Файл:awl_c_neg.png|right]]

r="-1.0, 0.0, 0.0, 1.0" 
g="0.0, -1.0, 0.0, 1.0" 
b="0.0, 0.0, -1.0, 1.0" 

'''''3) Черно-белая сепия.''''' [[Файл:awl_dw.png|right]]

r="1.0, 0.0, 0.0, 0.0" 
g="1.0, 0.0, 0.0, 0.0" 
b="1.0, 0.0, 0.0, 0.0" 

'''''4) Черно-белый негатив.''''' [[Файл:awl_dw_neg.png|right]]

r="-1.0, 0.0, 0.0, 1.0" 
g="-1.0, 0.0, 0.0, 1.0" 
b="-1.0, 0.0, 0.0, 1.0" 

'''Пример подключения эффекта AmbientWithLight:'''

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

=Пример использования обьекта Effect=
Примеры эффектов создаваемых с использованием обьекта Effect расположены по ссылке. В проекте 28 экранов, на каждом из которых расположен один пример эффекта с описанием применяемых параметров. 
[[Файл:Пример_экрана_с_эффектом.JPG|500px]] 

== Перекрашивание графики ==
Для начала - перекрашиваемая графика должна быть максимально осветлённая ( чтобы точнее перекрасить цвет, чем темнее графика - тех меньше будет влиять перекрашивание).

Имеем графику:

[[Файл:Bg seryj copy.png|430px]]

Далее, производим махинации - узнаём при помощи пипетки ( Photoshop ) цвет эталлоного пикселя ( один и тот же пиксель, на нужной и на осветлённой графиках).
Заносим полученные значения RGB каналов в таблицу, и для каждого канала узнаём процент цвета ( делим нужный цвет на эталонный).

[[Файл:Colors.ods - LibreOffice Calc.jpg|960px]]

Полученные % используем в объекте effect:

[[Файл:Splitmanager_setup_awl_6.jpg|460px]]

Далее всё по обычному - указываем тип эффекта awl, указываем номер эффекта и передаём сост. "awl_beg", результат:
[[Файл:66c7052ca8.jpg|960px]]

=TimeLineFX эффекты=
TimeLineFX эффекты - эффекты, которые создаются с помощью TimeLineFX редактора или из готовых шаблонов.

==Описание эффекта==
Перед запуском TimeLineFX эффекта нужно записать в объект effect параметры eftype = particle, eftag = N (N - номер тега эффекта).

Для запуска эффекта необходимо передать объекту effect состояние particle_beg.

Для остановки эффекта необходимо передать объекту effect состояние particle_end.

Пример запуска эффекта через машину состояний показан ниже.

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

Для добавления нового эффекта, в настройках объекта effect используем кнопку "Import Effect".

В открытом окне выбираем нужную нам библиотеку эффектов формата .eff.

В качестве эффектов можно добавлять готовые шаблоны из предложенных на сайте https://www.rigzsoft.co.uk/download-timelinefx/ или любых других источников.

Также эффекты можно модифицировать или создавать свои через TimeLineFX редактор.

После импорта эффекта он появится в табличке с параметрами:

NAME - имя эффекта. Берется из импортированной библиотеки, можно менять.

tag - номер тега эффекта, по которому будем его запускать.

tlfx - все параметры эффекта

resids - айдишники ресурсов, используемых эффектом

Нажав на кнопку с глазом возле "Import Effect" откроется окно предварительного просмотра эффекта.

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

Также можно создавать совершенно новые свои эффекты.

В самом редакторе ОЧЕНЬ много возможностей и настроек для эффектов.

Подробно ознакомиться с документацией редактора можно по ссылке:

https://www.rigzsoft.co.uk/timelinefx-help/

После создания / модификаций эффекта сохраняем его в формате .eff и импортируем в объект effect в редакторе или просто сохраняем в случае открытия редактора для модификации уже импортированного эффекта через объект effect.

== Пример ==

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

[[Category:Main objects]]

Файл:TimeLineFXstates.jpg

2018-06-15T07:58:08Z

Akovinenko:

Файл:TimeLineFX states.png

2018-06-15T07:23:00Z

Akovinenko:

Machine

2018-05-10T09:37:05Z

Akovinenko: /* Системные действия */

{{TOC right}}
[[Machine]] - [[Object|объект]] '''машина состояний''' (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]]''' - ускоренное движение;
** '''[[#rgb|rgb]]''' - изменить rgb-каналы;
** '''[[#spline|spline]]''' - движение по сплайну (по кривой).
* '''[[#Воздействия|Воздействия]]''':
** '''[[#click|click]]''' - что делать при клике на машине;
** '''[[#drop|drop]]''' - на машине отпущена клавиша мыши;
** '''[[#drag|drag]]''' - машину схватили и тащат;
** '''[[#throw|throw]]''' - машину схватили и кинули;
** '''[[#apply|apply]]''' - сработает при пересечении машины с линией или объектом;
** '''[[#touch_in|touch_in]]''' - наведение мыши/пальца на машину, если палец "тащат" по экрану;
** '''[[#touch_out|touch_out]]''' - выведение мыши из машины, если палец "тащат" по экрану;
** '''[[#touch_up|touch_up]]''' - отжатие мыши от машины;
** '''[[#tap|tap]]''' - умный тач;
** '''[[#mouse_in|mouse_in]]''' - наведение мыши на машину даже если не нажата кнопка мыши;
** '''[[#mouse_out|mouse_out]]''' - выведение мыши из машины даже если не нажата кнопка мыши.

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

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

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

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

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

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

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

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

=== draw ===

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

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

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

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

=== init ===

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

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

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

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

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

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

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

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

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

=== set ===

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

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

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

=== play ===

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

*'''snd''' - Короткий звук (перетаскивается из редактора ресурсов);
*'''voice''' - Голос (перетаскивается из редактора ресурсов);
*'''mus''' - Длинный звук (перетаскивается из редактора ресурсов);
*'''mus_field''' - Проиграть длинную музыку, id взяв из переменной машины, указанной в этом поле; (К примеру у машины есть параметр location_music=="7695" и в mus_field="location_music". То машина проиграет длинную музыку с id 7695)
*'''preload''' - Указанный звук будет загружен в память, но не будет проигрываться прямо сейчас. Для ускорения его старта потом;
*'''loop''' - Зациклить указанный звук. Использовать вместе с snd или voice;
*'''mus_loop''' - Зациклить указанную музыку. По умолчанию музыка всегда зацикленна. То есть, фактически этой флаг используется, когда нужно убрать зацикливание.
*'''repeat''' - Число повторов указанного звука при отключенном loop;
*'''mus_stop''' - Остановить музыку. Если используется вместе с mus, то остановится указанная. Если нет - то вся текущая.
*'''stop''' - Остановить указанный звук. Использовать вместе с snd или voice.
*'''mus_fading''' - Время появления/затухания указанной музыки в ms. Использовать вместе с mus.
*'''fading''' - Время появления/затухания указанного звука. Использовать вместе с snd или voice.
*'''volume''' - Установить громкость для всех звуков данной машины - тех что уже играют и тех, что будут запущены впоследствии;
*'''не выгружать''' - Позволяет продолжать проигрывание звука при смене экранов.
*'''go''' - Выбор состояния, в которое нужно перейти после проигрывания музыки/звука/голоса.
*'''if''' - Номер (начиная с нуля) условия перехода [[#if|if]].

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

1) Короткий звук (''snd'') нельзя запустить в первом (инитном) состоянии машины. Для того, чтобы запустить звук сразу при загрузке экрана, нужно в первом состоянии машины записать мгновенный переход во второе состояние мамашины (например, команда ''wait'', поле ''go'', в поле выбрать второе состояние), а во втором состоянии уже запустить звук.

2) Если звук нужно зациклить и проигрывать какое-то количество раз (''loop=1,2,3,..,n'') или бесконечно (''loop=-1''), то нужно проследить чтобы состояние, в котором запускается звук, не вызывалось повторно во время проигрывания звука, иначе возникнет наложение звуков.

3) Если во время проигрывания звука машина меняет свое состояние, звук продолжает играть.

4) Если в одной машине почти одновременно воспроизводится несколько звуков, то они прерывают друг друга.

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

6) Если не указан звук и голос, то команда (''stop'') остановит все звуки, запущенные этой машиной.

7) Музыка (''mus'') может быть формата .ogg или .mp3. На экране может воспроизводится только одна .mp3 музыка. Любой запуск .mp3 музыки независимо от того, в какой машине он осуществляется, будет прекращать проигрывание предыдущей .mp3 музыки. В тоже время может воспроизводиться несколько .ogg музыки.

8) Музыка, которая проигрывается на глобальном экране, проигрывается на всех экранах проекта.

=== var ===

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

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

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

=== buy ===

'''(in-app совершить in-app покупку)'''

При переходе в состояние, данная команда открывает системное окно с предложением совершить 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 на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.
Простейший набор параметров команды wait выглядит следующим образом:
<pre>
<wait t="1000" go="next"/> // ждем 1000ms и покидаем состояние
</pre>
Для программирования объектов со случайным поведением можно использовать последовательность команд wait с параметром вероятности перехода p (от 0 до 1):
<pre>
<wait t="100" p="0.5" go="st1"/> // через t с вероятностью 1/2 перейдет в st1
<wait go="st2"/> // иначе, перейдем в st2
</pre>
Этот же синтаксис позволяет делать состояния с различным временем жизни:
<pre>
<wait t="100" p="0.5" go="next"/> // с вероятностью 1/2 живем 100ms
<wait t="100" go="next"/> // или 200ms
</pre>
Впрочем, последнюю задачу можно решить при помощи указывания интервала dt, внутри которого произойдет окончание команды. Так, состояние, живущее от 800 до 1200ms, реализуется следующим образом:
<pre>
<wait t="1000" dt="200" go="next"/>
</pre>

=== move ===

Перемещение по сцене:
* '''tx''', '''ty''' - целевые координаты в пикселях, к которым должен переместиться объект. Можно указывать переменные заданные с помощью [http://ge.absolutist.com/index.php/Machine#var_2 переменной var];
* '''dx''', '''dy''' - величина смещения от текущей (если есть - tx,ty игнорируются); можно задавать смесь tx, dy или dx,ty;
* '''v''' - скорость перемещения в пикселях в секунду; для фреймовой анимации, например, ходьбы скорость рассчитывается исходя из длительности одного кадра и числа кадров на фазу движения. Поэтому, в этом случае, удобнее задавать скорость;
* '''t''' - время перемещения (v игнорируется);
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду move, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд движения с первой команды;
* '''break''' - прервать команды - Прервать выполнение команд move на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

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

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

=== rot ===

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

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

=== alpha ===

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

Если у объекта прозрачность ''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 на этой команде (запустить их сново можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

=== phys ===

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

* '''vx''', '''vy''' - начальная скорость
* '''ax''', '''ay''' - величина ускорения по каждой оси
* '''a''' - полное ускорение
* '''tvx''', '''tvy''' - целевая скорость
* '''tx''', '''ty''' - целевая координата
* '''go''' - новое состояние - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go; команда ждет срабатывания условия, и не запускает следующую команду phys, пока if не выполнится;
* '''loop''' - зациклить команды - Начать выполнение команд phys с первой команды.
* '''break''' - прервать команды - Прервать выполнение команд phys на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''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), до которой мяч должен подпрыгнуть.

=== rgb ===

* '''trgb''' - целевой эффект rgb; подразумевает под собой цвет в виде HEX-кода; по-умолчанию: FFFFFF;
* '''t''' - длительность выполнения команды в ms;
* '''go''' - состояние, в которое нужно перейти поле окончания времени и срабатывания условия [[#if|if]], если оно указано;
* '''if''' - номер (начиная с нуля) команды [[#if|if]], при выполнении которой происходит переход go;
* '''loop''' - зациклить команды;
* '''break''' - прервать выполнение команд wait на этой команде (запустить их снова можно из команд процессов).
* '''init''', '''set''', '''draw''', '''move''', '''rot''', '''alpha''', '''scale''', '''phys''' - Номер запускаемой команды.

=== spline ===

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

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

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

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

# в состоянии машины добавляем правой кнопкой мыши действие "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;
* '''maxVel''' - Максимальная скорость вращения градус/сек;
* '''objStart''' - объект при начале вращения;
* '''stStart''' - его новое состояние;
* '''objEnd''' - объект при завершении вращения;
* '''stEnd''' - его новое состояние;
'''''Замечание.''''' ('''dragRot''') и обычный ('''drag''') не работает если сцена таскаемая.

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

====Использование свойства "Условие перехода" ====

Можно прописать условие, при котором выполняется переход при дропе.
[[Файл:Drop_if.png|300px|thumb|right]]

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

Для того, чтобы научить машину различать клик по ней и ее таскание сделаем следующее. Пропишем ей 2 состояния: click и drag, а также выставим ей параметр "хранить нажатость" = 1. В click будем вычислять координаты объекта и записывать объекту параметр допустимого смещения при котором таскание будет восприниматься как клик. (В данном примере эти параметры: cx, cy, vx, vy. А допустимое смещение составляет 10 пикселей.)

В состоянии drag будем проверять попадает ли координата объекта при дропе в границы допустимого смещения. Для того чтобы сравнить параметр объекта с переменной, вычтем из нашего объекта, то что мы записали в click. В зависимости от условий и места дропа переходим в соответствующее состояние.

[[Файл:Click.png|330px]] [[Файл:Drag st.png|630px]]

=== throw ===

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

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

=== tap ===

* '''go''' - Состояние в которое нужно перейти после окончания времени.
* '''if''' - номер (начиная с нуля) условия [[#if|if]] разрешения бросания.

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

'''!!!Важно:''' нужно использовать полную скобочную структуру : "((1&2)&3)" - правильно, "1,2,3" - не правильно ( не гарантируется 100% адекватная работа).

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

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

Параметры команды:
* '''obj''' - находится ли объект obj в состоянии st или имеет ли его параметр par значение val. В этом поле можно указать this, это значит что if будет проводить проверку текущего объекта. Добавлено это вместе с параметром clone. Клоны рождаются и умирают в рамках одного экрана. Для различия клонов между собой машина имеет уникальный параметр "clone_num" у оригинала = -1, у клонов от 0 до N, собственно с помощью this машина может сама себя проверить клон ли она и если да то какой у нее номер;
* '''st''' - имя состояния в котором может находиться объект obj;
* '''par''' - имя параметра объекта obj, значение которого сравнивается с полем val;
* '''val''' - значение параметра par, которое проверяется у объекта obj;
* '''val_txt''' - Значение текстового параметра объекта для проверки условия;
* '''val_res''' - Значение ресурсного параметра объекта для проверки условия;
* '''val_obj''' - Значение id объекта для проверки условия;
* '''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''' - валиден (правилен и может быть запущен) ли данный интернет-адрес; на ios ссылка должна выглядеть так comabsolutisttwilighttown://, т.е. в конце ссылки добавляем ://
* '''is_mus''' - играет ли сейчас музыка (значение 1);
* '''guest''' - объект который установил состояние (используется вместо параметра obj). Если указанный объект не менял состояние этой машины, то условие не срабатывает.

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

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

У машины (другой или самой себя) можно проверить текущее состояние '''st''' и предыдущее состояние '''prev_st''', эти параметры живут на время сессии.

== Математика ==

=== Основные математические операции ===
Математика в appsalute creator представлена 6-ю основными операциями: (плюс), (минус), (умножить), (поделить), (целочисленное деление), (остаток от деления) 
Организована благодаря совместному использованию '''[[#var|var]]''' и '''[[#set|set]]'''.
[[Файл:Example_mod.png|300px|right|Пример использования операции остатка от деления]]
''(плюс)'' '''+''' 
''(минус)'' '''-''' 
''(умножить)'' '''*''' 
''(поделить)'' '''/''' 
''(целочисленное деление)'' '''\''' 
''(остаток от деления)'' '''%''' 
 
Примеры использования последних двух операций: 
5\2=2 
5%2=1 

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

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

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

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

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

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

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

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

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

== Guest ==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

== Clone ==
Clone - параметр команды init в разделе "системные действия".

[[Файл:Clone1.PNG]]

Значение 1 означает, что в текущем местоположении машины будет создана ее копия.

[[Файл:Clone2.PNG]]

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

1) Клонированная машина состояний имеет все свойства, состояния и параметры исходного объекта клонирования.

2) Клоны рождаются и умирают в рамках одного экрана.

3) Клоны отличаются друг от друга лишь параметром '''clone_num''', который у оригинала равен "-1", а у клонов от 0 до N.

4) Нежелательно применять клонирование к клону во избежание путаницы значений параметра '''clone_num'''.

5) Если при проверке условия [[#if|if]] в поле '''obj''' указать this, это значит что if будет проводить проверку текущего объекта. Таким образом машина может сама себя проверить по параметру '''clone_num''' клон ли она и если да то какой у нее номер;

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

По ссылке пример использования с подробным описанием машин.

[http://fs5.absolutist.com/files/wikisample/Clone.zip Download]

== Параметр команды машины состояний ==

В случае, когда необходимо изменить значение какого-либо параметра в командах машины состояний (например v в команде move) в процессе работы приложения, можно использовать блок "Параметр команды машины состояний" в команде ''set'' машины состояний. Приведу пример использования этого блока.

Пусть есть 2 машины: управляющая и управляемая.

[[Файл:Stm1.jpg|300px]][[Файл:Stm2.jpg|300px]]

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

В первом состоянии "wait" мы пытаемся изменить скорость движения управляемой машины. Для этого указали объект (sun), состояние в котором хотим поменять параметр (у машины sun это состояние move), имя команды в которой меняем параметр (в данном случае это move), номер команды (если таких команд несколько, то нужно указать порядковый номер начиная с 0; в нашем случае команда одна), имя параметра (мы хотим изменить скорость, поэтому имя параметра v) и значение (указали значение 200). После этого переходим в следующее состояние.

В состоянии "1" управляющей машины сначала мы вывели объект sun из состояния move, изменили параметр целевой координаты x на 512 и затем вернули в состояние move, чтобы применить изменения параметров. Таким образом управляемая машина начала движение в x=512 со скоростью 200. Через 2 секунды мы переводим управляющую машину в состояние "2", где аналогичным образом изменяется целевая координата на -512.

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

==Запись в viewer.log ==

Во время работы приложения, машина состояний может писать информацию о своей работе в viewer.log. Для этого параметр '''Level''', в разделе '''[GameTrace]''' файла '''app.icf''' должен быть выставлен в значение '''Verbose'''.

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

Ниже приведен пример записи из viewer.log. Жирным шрифтом выделено полезную информацию.

*Machine::state() state machine '''stat_google_gold (id:30818)''' from '''enough_coins''' to '''enough_coins''' through object '''c_current_gold (id:8807)''' from state '''inc''' - машина с именем и id: '''stat_google_gold (id:30818)''' перешла из состояния: '''enough_coins''' в: '''enough_coins'''; ее состояние изменил объект с именем и id: '''c_current_gold (id:8807)''' из состояния: '''inc'''.
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:17''' - машина с id '''(id:28076)''' начала выполнять команду '''set id:17'''; сначала проверяется истинно ли условие выполнения команды (if).
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) '''checkIf(0)=no''' - имеем некоторое сложное условие, проверяем его составляющие; if(0) не выполняется (имеет значение false).
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) '''checkIf(1)=yes''' - условие if(1) выполняется (имеет значение true).
*GMachine::Command::calcExpr() GMachine::Command::calcExpr ((0|(!1))|(!2)) '''checkIf(2)=yes''' - условие if(2) выполняется (имеет значение true).
*GMachine::Command::checkIf() GMachine'''(id:28076)'''::Command::'''checkIf id:17 expr:((0|(!1))|(!2)) res:false''' - проверяется все выражение; общий результат false, set(17) не выполняется.
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:18''' - машина с id '''(id:28076)''' начала выполнять команду '''set id:18''', в данном set условие if отсутствует.
*GMachine::Command::checkIf() GMachine'''(id:28076)'''::Command::'''checkIf id:18 expr: res:true''' - в команде set(18) условие '''checkIf id:18 expr: res:true''' есть истинно (точнее - не есть ложным, так как оно отсутствует); set(18) будет выполнен.
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:18 checkIf success''' - проверка условия прошла успешно, выполняем set(18).
*GMachine::Set::init() GMachine'''(id:28076)'''::Set::init '''set id:18 obj:16039 -> par:param_name val:bundle_coins us:0''' - результат выполнения set(18) - объекту '''obj:16039''' устанавливаем параметр '''par:param_name val:bundle_coins''' равным '''us:0'''.
*GMachine::Command::getVarValue() Command::'''getVarValue(bundle_item): float result = 0.00''' - вычитываем переменную с помощью команды var; вычитываем параметр '''bundle_item''', результат операции '''float result = 0.00'''.
*GMachine::Set::init() Set::init: Expression: '''(bundle_coins)=0.000000(float)''' - используем значение переменной в команде set; переменная вчитывается в момент обращения к ней из другой команды (set, move и др.).

==Использование скриптов Lua ==
В машине состояний можно использовать скрипты [[Lua]]

==Окно==
В свойствах машины состояний есть 2 новых поля:
*'''окно''' - если ''да'', то машина считает себя окном. При включении данного параметра с момента постановки окна в очередь ''statesmanager'а'' и до вызова ''back'' в текущей машине блокируются внешние воздействия и переход между состояниями.
*'''тип окна''' - обычное; по альфе - при открытии отключает все нижние сцены по альфе; с фото - при открытии отключает все нижние сцены по альфе, предварительно делая фото этих сцен. Выключение сцен ''по альфе'' и ''с фото'' используются для больших окон основной очереди.
[[mwindow]]

[[Category:Main objects]]

Partnersconsole

2018-04-10T06:30:01Z

Akovinenko: /* Добавляемые параметры */

{{TOC right}}

'''partnersconsole''' - объект обмена опциями с партнерами. 

== Параметры ==
*'''id объекта''' (id) - уникальный номер объекта
*'''тип''' (type) - Выбранный тип объекта определяет его функциональное назначение и его свойства
*'''имя''' (name) - Имя объекта в дереве проекта. Может быть произвольным.

=== Состояния ===
*'''start''' - Это состояние нужно вызывать в начале уровня.
*'''game_over''' - Это состояние нужно вызывать в конце уровня.
*'''post_highscore''' - Состояние для отправки нового рекорда. Рекорд предварительно нужно записать в параметр highscore объекта. Вызывается при получении рекорда.
*'''get_options''' - Состояние для получения опций. Вызывается обычно при старте игры. При получении опций происходит автоматическая перезагрузка лейаута. Срабатывает только 1 раз, дополнительные проверки не требуются.
*'''send_options''' - Состояние для отправки опций. Вызывается обычно в конце уровня.

=== Добавляемые параметры ===
*'''Изменить состояние объекта - начало новой игры''' (game_event_play) - Была нажата внешняя кнопка Play, необходим перезапуск игры.
*'''Изменить состояние объекта - показать окно завершения игры''' (game_event_show_menu) - Нужно показать окно завершения игры.
*'''Изменить состояние объекта - скрыть окно завершения игры''' (game_event_hide_menu) - Нужно закрыть окно завершения игры.

[[Category:Main objects]]

Partnersconsole

2018-04-03T07:44:53Z

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

{{TOC right}}

'''partnersconsole''' - объект обмена опциями с партнерами. 

== Параметры ==
*'''id-объекта'''(id) - уникальный номер объекта
*'''тип''' (type) - Выбранный тип объекта определяет его функциональное назначение и его свойства
*'''имя'''(name) - Имя объекта в дереве проекта. Может быть произвольным.

=== Состояния ===
*'''start''' - Это состояние нужно вызывать в начале уровня.
*'''game_over''' - Это состояние нужно вызывать в конце уровня.
*'''highscore''' - Состояние для отправки нового рекорда. Рекорд предварительно нужно записать в параметр highscore объекта. Вызывается при получении рекорда.
*'''send_options''' - Состояние для отправки опций. Вызывается обычно в конце уровня.

[[Category:Main objects]]

Partnersconsole

2018-04-03T07:44:24Z

Akovinenko: Новая страница: «{{TOC right}} '''partnersconsole''' - объект обмена опциями с партнерами. == Параметры == *'''id-объекта'''(i…»

{{TOC right}}

'''partnersconsole''' - объект обмена опциями с партнерами. 

== Параметры ==
*'''id-объекта'''(id) - уникальный номер объекта
*'''тип''' (type) - Выбранный тип объекта определяет его функциональное назначение и его свойства
*'''имя'''(name) - Имя объекта в дереве проекта. Может быть произвольным.

=== Состояния ===
*'''start'''(videos) - Это состояние нужно вызывать в начале уровня.
*'''game_over''' (sounds)- Это состояние нужно вызывать в конце уровня.
*'''highscore''' (fonts)- Состояние для отправки нового рекорда. Рекорд предварительно нужно записать в параметр highscore объекта. Вызывается при получении рекорда.
*'''send_options''' (configs)- Состояние для отправки опций. Вызывается обычно в конце уровня.

[[Category:Main objects]]

Absolutist Framework

2018-04-03T07:39:10Z

Akovinenko: /* Main objects */

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

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

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

* [[Learning|Уроки по освоению фреймворка]]
* [[Примеры реализации в играх]]
* [[Основные понятия объектов физического мира]]
* [[Использование AppSalute Debugger при отладке]]
* [[Отладка на флеше]]
* [[FAQ]]

== Подготовка проекта ==
* [[Проектирование экранов игры]]
* [[Подготовка и форматы графики]]
* [[Подготовка и форматы шрифтов]]
* [[Подготовка и форматы звуков]]
* [[Подготовка и форматы видео]]
* [[Создание проекта]]
* [[Загрузка проекта по частям]]
* [[Конфигурация проекта для сборки]]
* [[Подготовка для загрузки на маркеты]]
* [[Сборка проекта]]
* [[Частые ошибки]]
* [[Отличия подготовки проекта для разных платформ]]
* [[Lua|Использование lua-скриптов]]
* [[Подготовка версии для Viber]]
* [[Проверка подгрузки текстур]]
* [[Экспорт проекта]]
* [[Шаблон|Экспорт/импорт шаблона проекта]]

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

=== Common objects ===

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

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

=== Main objects ===

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

* [[Файл:Kub.png]] - [[Azmanager]] - менеджер активных зон
* [[Файл:Kub.png]] - [[Active zone]] - активная зона
* [[Файл:Picture.png]] - [[Image]] - картинка
* [[Файл:Kub.png]] - [[Statistic]] - объект для отправки событий статистики.
* [[Файл:Button.png]] - [[Button]] - кнопка
* [[Файл:Text.png]] - [[Text]] - текст
* [[Файл:Machine.png]] - [[Machine]] - машина состояний
** [[Файл:Mwindow.png]] - [[Mwindow]] - машина состояний - окно
* [[Файл:Tableicon.png]] - [[Table]] - таблица
* [[Файл:Checkbox.png]] - [[Checkbox]] - чекбокс (кнопка в 2-х состояниях)
* [[Файл:Checkgroup.png]] - [[Groupbox]] - группа, содержащая несколько чекбоксов
* [[Файл:Timer.png]] - [[Timer]] - цифровой таймер
** [[Файл:Kub.png]] - [[Globaltimer]] - таймер "реального времени"
* [[Файл:Counter2.png]] - [[Counter]] - счетчик сделанных кликов в игре и т.п.
* [[Файл:Progressbar.png]] - [[Progress]] - прогресс прохождения игры (эчивмент)
* [[Файл:Particle.png]] - [[Flyer]] - флаер (патиклы)
* [[Файл:Rectangle.png]] - [[Rectangle]] - прямоугольник
* [[Файл:Kub.png]] - [[Isomover]] - объект движения в изометрической карте
* [[Файл:Group.png]] - [[Group]] - группа
* [[Файл:Groupset.png‎]] - [[Groupset]] - группа
* [[Файл:Effect.jpg|20px]] - [[Effect]] - Создание различных эффектов
* [[Файл:Graphprogress.png]] - [[Graphprogress]] - создание мини-карты для отображения прогресса прохождения игры.
* [[Файл:Statesmanager_ico.png]] - [[Statesmanager]] - очередь работы с объектами
* [[Файл:Slider icons.png]] - [[Slider]] - объект реализующий листание списка.
* [[Файл:Ribbon.png]] - [[Ribbon]] - объект отображения графики по сплайну
* [[Файл:Kub.png]] - [[Animation]] - объект различных анимаций
* [[Файл:Kub.png]] - [[Magicparticles]] - объект файлов Magic Particles
* [[Файл:Kub.png]] - [[puzzle3D]] - 3D паззл
* [[Файл:Kub.png]] - [[3D-object]] - 3D объект
* [[Файл:Kub.png]] - [[Scriptresources]] - scriptresources
* [[Файл:Kub.png]] - [[Partnersconsole]] - partnersconsole

=== Game mechanic ===

* [[Файл:Kub.png]] - [[Avoider]] - эвойдер
* [[Файл:Kub.png]] - [[Battle]] - боевка
* [[Файл:Puzzle.png]] - [[Puzzle]] - игра пазл
* [[Файл:Memory.png]] - [[Memory]] - класс игр с memory-механикой
* [[Файл:Patchwork.png]] - [[Patchwork]] - класс игр с Patchwork-механикой
* [[Файл:Match3.png]] - [[Match]] - класс match-подобных игр
* [[Файл:Collaps.png]] - [[Collapse]] - класс match-подобных игр
* [[Файл:Bejewelled.png]] - [[Bejewelled]] - класс match-подобных игр
* [[Файл:Bs_old.png]] - [[Bubble Shooter]] - класс Bubble игр включая механику Снукер
* [[Файл:BubbleShooter.png]] - [[Bubble Shooter NEW]] - класс Bubble игр включая механику Снукер (Новый)
* [[Файл:Tapthebubble.png]] - [[TapTheBubble]] - механика игры Tap The Bubble
* [[Файл:GemSlider.jpg]] - [[Gem Slider]] - механика игры Gem Slider
* [[Файл:W-57.png]] - [[Words]] - механика игры Words
* [[Файл:Kub.png]] - [[2048]] - механика игры 2048
* [[Файл:Kub.png]] - [[Planet]] - игра "Планетки"
* [[Файл:Kub.png]] - [[Unblock]] - механика игры unblock
* [[Файл:Matchbattle.png]] - [[Match Battle]] - настройка глобальных параметров для мини-игр
* [[Файл:Move box.png]] - [[DragBox]] - класс игр с dragbox-механикой
* [[Файл:Labyrinth.png]] - [[Labyrinth]] - класс игр лабиринт
* [[Файл:Pipes.png]] - [[Pipes]] - класс игр трубы
* [[Файл:Search object.png]] - [[HiddenObject]] - поисковый объект в хидден играх
* [[Файл:Object list.png]] - [[HiddenList]] - список поисковых объектов в хидден играх
* [[Файл:Hint.png]] - [[HiddenHint]] - подсказка (указатель на спрятанный объект)
* [[Файл:Kub.png]] - [[HiddenHighLighter]] - позволяет показать не найденные объекты в хиддене.
* [[Файл:Collection.png]] - [[Collection]] - "коллекция" поисковых объектов для хидден игр
* [[Файл:Kub.png]] - [[Color Switch]] - механика игры Color Switch
* [[Файл:Inventory.png]] - [[Inventory]] - "инвентарь" список применяемых объектов для игр
* [[Файл:Tool.png]] - [[Tool]] - "применение" - объект, который можно применить для игр
* [[Файл:Kub.png]] - [[Isomap]] - изометрическая карта
* [[Файл:Slotmachine.png]] - [[Slotmachine]] - объект типа "slot"
* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер
** [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря/магазина и экономики
** [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина
** [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря
** [[Файл:Kub.png]] - [[Ecraftitem]] - шаблон для ячейки создания предмета.
** [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий
*** [[Файл:Kub.png]] - [[Etasktemplate]] - шаблон задачи для таблицы темплейтов.
*** [[Файл:Kub.png]] - [[Elogbooktemplate]] - шаблон отображения ячейки логбука.
** [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания
** [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции
* [[Файл:Paint.png‎]] - [[Paint]] - объект для рисования
* [[Файл:Physicsworld.png]] - [[Physicsworld]] - физический мир Box2D
** [[Файл:Physicsobject.png]] - [[Physicsobject]] - физические объекты
** [[Файл:Physics links.png]] - [[Physicsjoint]] - физические соединения
* [[Файл:Eraser.png]] - [[Eraser]] - стирачка
* [[Файл:Kub.png]] - [[trivia]] - игровая механика - миллионер (trivia)
* [[Файл:Kub.png]] - [[Dailybonus]] - объект для управления механизмом ежедневного бонуса за вход в игру.
* [[Файл:Kub.png]] - [[Pet]] - объект питомца.
** [[Файл:Kub.png]] - [[PetCollectionTemplate]] - объект шаблона ячейки с коллекцией.
** [[Файл:Kub.png]] - [[PetTemplate]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[CakeTower]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[Pentamino]] - механика игры в [https://ru.wikipedia.org/wiki/%D0%9F%D0%B5%D0%BD%D1%82%D0%B0%D0%BC%D0%B8%D0%BD%D0%BE пентамино]
* [[Файл:Kub.png]] - [[TapTheNew]]
* [[Файл:Kub.png]] - [[Dressing]] - гардероб.
** [[Файл:Kub.png]] - [[Dressingtemplate]] - объект шаблона гардероба.
* [[Файл:Kub.png]] - [[solitaire]] - солитер

* [[Файл:digitz.png]] - [[Digitz]] - механика игры Digitz.
* [[Файл:Kub.png]] - [[Wordsearch]] - механика поиска слов на поле
* [[Файл:Kub.png]] - [[Builder]] - механика типа фермы
** [[Файл:Kub.png]] - [[Builderitem]] - объект шаблона здания
** [[Файл:Kub.png]] - [[Buildercomponent]] - шаблон материала для апгрейда здания
* [[Файл:Kub.png]] - [[Script Game]] - Script Game

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

=== Options ===
* [[Файл:Options.png]] - [[Options]] - общие настройки игры
* [[Файл:Gamedata.png]] - [[Gamedata]] -
* [[Файл:Controls.png]] - [[Controls]] - обьект для работы с клавишами клавиатуры или девайса
* [[Файл:Editicon.png]] - [[Edit]] - ввод текста
* [[Файл:Store.png]] - [[Store]] - настройки InApp покупок в игре
** [[Файл:Kub.png]] - [[Wallet]] - объект для начисления игровой валюты при InApp покупках через объект economics
* [[Файл:Notification.png]] - [[Notification]] - push-уведомления
* [[Файл:Imagepicker.png]] - [[Imagepiker]] - объект для загрузки фото из галереи
* [[Файл:Video.png]] - [[Video]] - объект для просмотра видео
* [[Файл:Webview.png]] - [[Webview]] - объект для просмотра интернет страниц в приложении
* [[Файл:Flurryobject.png]] - [[Flurry]] - настройки системы статистики для приложений https://dev.flurry.com
* [[Файл:Moregames.png]] - [[MoreGamesList]] - запрос банеров рекламируемых игр
* [[Файл:Advertisement.png]] - [[Advertisement]] - банерная система flurry, amazon
* [[Файл:Splitmanager.png]] - [[Splitmanager or A\B Testing]] - менеджер сплитов
* [[Файл:Tapjoy.png]] - [[Tapjoy]] - система рекламы игр
* [[Файл:Playhaven.png|24px]] - [[Playhaven]] - система рекламы игр с внутренними up-sale
* [[Файл:Mobileapptracker.png|24px]] - [[Mobileapptracking]] -
* [[Файл:Chartboost-logo-new.jpeg]] - [[Chartboost]] - Chartboost-logo-new.jpeg
* [[Файл:Kub.png]] - [[SuperSonic]] - провайдер рекламы SuperSonic
* [[Файл:Kub.png]] - [[System]] - объект для доступа к системным настройкам
* [[Файл:Kub.png]] - [[Salesmanager]] - менеджер акций
* [[Файл:Kub.png]] - [[Cloud]] - объект для синхронизации в облаке
* [[Файл:Kub.png]] - [[Game]] - объект для отправки событий
* [[Файл:Kub.png]] - [[Errormanager]] - менеджер ошибок
* [[Файл:Kub.png]] - [[Multiplayer]] - объект мультиплеера

=== Social ===
* [[Файл:Facebook.png]] - [[Facebook]] - настройки расшаривания Facebook
** [[Файл:Esocialfrienditem.png]] - [[Esocialitem]] - Шаблон для ячейки списка друзей
** [[Файл:Kub.png]] - [[Esocialgiftitem]] - Шаблон для ячейки с предметом, который можно подарить другу
** [[Файл:Esocial.png]] - [[Esocial]] - объект для взаимодействия с Facebook'ом
* [[Файл:Twitter.png]] - [[Twitter]] - настройки расшаривания Twitter
* [[Файл:Odnoklassniki.png]] - [[Odnoklassniki]] - настройки для социальной сети Одноклассники
* [[Файл:Googleplus.png]] - [[GooglePlus]] - настройки для социальной сети GooglePlus
* [[Файл:Kub.png]] - [[ShareDialog]] - объект для вызова окна шаринга в другие приложения устройства

=== Functions ===
* [[Файл:Forward.png]] - [[SendMail]] - отправка письма через почтовый клиент
* [[Файл:footer-icon-rate.png]] - [[Rate]] - вызов окна оценки приложения
* [[Файл:Kub.png]] - [[Config]] - конфиг для игровой механики

----
[[Файл:!.png]] - [[Правила оформления]] - Требование к описанию объектов.
----
<gallery widths="50px" heights="50px" >
Изображение:Who.png
Изображение:AnimalHideSeek.png
Изображение:travel.png
Изображение:Game_Adventure_Train.png
Изображение:Gmae_Match_MoveTheDolly.png
Изображение:Game_Patchwork_BigEyes.png
Изображение:Game_Patchwork_Chameleon.png
Изображение:Game_Patchwork_Logicly.png‎
Изображение:Game_Patchwork_Stickers.png‎
Изображение:Elephant.png
Изображение:Elephant2.png
Изображение:Cinderella.png
Изображение:Pigs.png
Изображение:Bremenskye.png
Изображение:Book_SnowWhite.png
Изображение:Book_PussInBoots.png
Изображение:Call.png
Изображение:GreatestArtists.png
Изображение:Game_Puzzle_Kids.png
Изображение:Game_Puzzle_Architect.png‎
Изображение:Game_Puzzle_Science.png
Изображение:Ico_1_114_Full.png
Изображение:Game_Adventure_Dreams.png
Изображение:Abc.png
Изображение:Ico_114_Full.png
Изображение:Ico_114_Paints.png
Изображение:Ico_114_Puzzle.png
</gallery>

[[category:main]]

Scriptresources

2018-03-30T09:18:38Z

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

{{TOC right}}

'''scriptresources''' - объект применяется для того, чтобы в экспорт попадали ресурсы, которые используются в скриптах и которых нет в лэйауте. 

== Параметры ==
*'''id-объекта'''(id) - уникальный номер объекта
*'''тип''' (type) - Выбранный тип объекта определяет его функциональное назначение и его свойства
*'''имя'''(name) - Имя объекта в дереве проекта. Может быть произвольным.
*'''синхронизация''' (sync)- Применяется для синхронизации между лейаутами, если указан параметр ''нет'' то объект будет активен только на текущем лейауте
*'''тексты''' (textResources) - Список текстовых ресурсов (перетаскиваются из текстовой базы).
*'''изображения''' (graphResources) - Список графических ресурсов (перетаскиваются из базы ресурсов).

=== Добавляемые параметры ===
*'''Видео ресурс'''(videos) - Видео ресурс (перетаскивается из базы ресурсов).
*'''Звук''' (sounds)- Звук (перетаскивается из базы ресурсов).
*'''Шрифт''' (fonts)- Шрифт (перетаскивается из базы ресурсов).
*'''Файл конфигураций''' (configs)- Файл конфигураций (перетаскивается из базы ресурсов).
*'''3D модель''' (models)- 3D модель (перетаскивается из базы ресурсов).

Добавляемых параметров может быть сколько угодно.

[[Category:Main objects]]

Scriptresources

2018-03-30T09:17:39Z

Akovinenko: Новая страница: «{{TOC right}} '''scriptresources''' - объект применяется для того, чтобы в экспорт попадали ресурсы, кот…»

{{TOC right}}

'''scriptresources''' - объект применяется для того, чтобы в экспорт попадали ресурсы, которые используются в скриптах и которых нет в лэйауте. 

== Параметры ==
*'''id-объекта'''(id) - уникальный номер объекта
*'''тип''' (type) - Выбранный тип объекта определяет его функциональное назначение и его свойства
*'''имя'''(name) - Имя графического объекта в дереве проекта. Может быть произвольным. По умолчанию соответствует имени файла из базы ресурсов.
*'''синхронизация''' (sync)- Применяется для синхронизации между лейаутами, если указан параметр ''нет'' то объект будет активен только на текущем лейауте
*'''тексты''' (textResources) - Список текстовых ресурсов (перетаскиваются из текстовой базы).
*'''изображения''' (graphResources) - Список графических ресурсов (перетаскиваются из базы ресурсов).

=== Добавляемые параметры ===
*'''Видео ресурс'''(videos) - Видео ресурс (перетаскивается из базы ресурсов).
*'''Звук''' (sounds)- Звук (перетаскивается из базы ресурсов).
*'''Шрифт''' (fonts)- Шрифт (перетаскивается из базы ресурсов).
*'''Файл конфигураций''' (configs)- Файл конфигураций (перетаскивается из базы ресурсов).
*'''3D модель''' (models)- 3D модель (перетаскивается из базы ресурсов).

Добавляемых параметров может быть сколько угодно.

[[Category:Main objects]]

Absolutist Framework

2018-03-30T08:32:19Z

Akovinenko: /* Main objects */

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

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

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

* [[Learning|Уроки по освоению фреймворка]]
* [[Примеры реализации в играх]]
* [[Основные понятия объектов физического мира]]
* [[Использование AppSalute Debugger при отладке]]
* [[Отладка на флеше]]
* [[FAQ]]

== Подготовка проекта ==
* [[Проектирование экранов игры]]
* [[Подготовка и форматы графики]]
* [[Подготовка и форматы шрифтов]]
* [[Подготовка и форматы звуков]]
* [[Подготовка и форматы видео]]
* [[Создание проекта]]
* [[Загрузка проекта по частям]]
* [[Конфигурация проекта для сборки]]
* [[Подготовка для загрузки на маркеты]]
* [[Сборка проекта]]
* [[Частые ошибки]]
* [[Отличия подготовки проекта для разных платформ]]
* [[Lua|Использование lua-скриптов]]
* [[Подготовка версии для Viber]]
* [[Проверка подгрузки текстур]]
* [[Экспорт проекта]]
* [[Шаблон|Экспорт/импорт шаблона проекта]]

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

=== Common objects ===

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

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

=== Main objects ===

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

* [[Файл:Kub.png]] - [[Azmanager]] - менеджер активных зон
* [[Файл:Kub.png]] - [[Active zone]] - активная зона
* [[Файл:Picture.png]] - [[Image]] - картинка
* [[Файл:Kub.png]] - [[Statistic]] - объект для отправки событий статистики.
* [[Файл:Button.png]] - [[Button]] - кнопка
* [[Файл:Text.png]] - [[Text]] - текст
* [[Файл:Machine.png]] - [[Machine]] - машина состояний
** [[Файл:Mwindow.png]] - [[Mwindow]] - машина состояний - окно
* [[Файл:Tableicon.png]] - [[Table]] - таблица
* [[Файл:Checkbox.png]] - [[Checkbox]] - чекбокс (кнопка в 2-х состояниях)
* [[Файл:Checkgroup.png]] - [[Groupbox]] - группа, содержащая несколько чекбоксов
* [[Файл:Timer.png]] - [[Timer]] - цифровой таймер
** [[Файл:Kub.png]] - [[Globaltimer]] - таймер "реального времени"
* [[Файл:Counter2.png]] - [[Counter]] - счетчик сделанных кликов в игре и т.п.
* [[Файл:Progressbar.png]] - [[Progress]] - прогресс прохождения игры (эчивмент)
* [[Файл:Particle.png]] - [[Flyer]] - флаер (патиклы)
* [[Файл:Rectangle.png]] - [[Rectangle]] - прямоугольник
* [[Файл:Kub.png]] - [[Isomover]] - объект движения в изометрической карте
* [[Файл:Group.png]] - [[Group]] - группа
* [[Файл:Groupset.png‎]] - [[Groupset]] - группа
* [[Файл:Effect.jpg|20px]] - [[Effect]] - Создание различных эффектов
* [[Файл:Graphprogress.png]] - [[Graphprogress]] - создание мини-карты для отображения прогресса прохождения игры.
* [[Файл:Statesmanager_ico.png]] - [[Statesmanager]] - очередь работы с объектами
* [[Файл:Slider icons.png]] - [[Slider]] - объект реализующий листание списка.
* [[Файл:Ribbon.png]] - [[Ribbon]] - объект отображения графики по сплайну
* [[Файл:Kub.png]] - [[Animation]] - объект различных анимаций
* [[Файл:Kub.png]] - [[Magicparticles]] - объект файлов Magic Particles
* [[Файл:Kub.png]] - [[puzzle3D]] - 3D паззл
* [[Файл:Kub.png]] - [[3D-object]] - 3D объект
* [[Файл:Kub.png]] - [[Scriptresources]] - scriptresources

=== Game mechanic ===

* [[Файл:Kub.png]] - [[Avoider]] - эвойдер
* [[Файл:Kub.png]] - [[Battle]] - боевка
* [[Файл:Puzzle.png]] - [[Puzzle]] - игра пазл
* [[Файл:Memory.png]] - [[Memory]] - класс игр с memory-механикой
* [[Файл:Patchwork.png]] - [[Patchwork]] - класс игр с Patchwork-механикой
* [[Файл:Match3.png]] - [[Match]] - класс match-подобных игр
* [[Файл:Collaps.png]] - [[Collapse]] - класс match-подобных игр
* [[Файл:Bejewelled.png]] - [[Bejewelled]] - класс match-подобных игр
* [[Файл:Bs_old.png]] - [[Bubble Shooter]] - класс Bubble игр включая механику Снукер
* [[Файл:BubbleShooter.png]] - [[Bubble Shooter NEW]] - класс Bubble игр включая механику Снукер (Новый)
* [[Файл:Tapthebubble.png]] - [[TapTheBubble]] - механика игры Tap The Bubble
* [[Файл:GemSlider.jpg]] - [[Gem Slider]] - механика игры Gem Slider
* [[Файл:W-57.png]] - [[Words]] - механика игры Words
* [[Файл:Kub.png]] - [[2048]] - механика игры 2048
* [[Файл:Kub.png]] - [[Planet]] - игра "Планетки"
* [[Файл:Kub.png]] - [[Unblock]] - механика игры unblock
* [[Файл:Matchbattle.png]] - [[Match Battle]] - настройка глобальных параметров для мини-игр
* [[Файл:Move box.png]] - [[DragBox]] - класс игр с dragbox-механикой
* [[Файл:Labyrinth.png]] - [[Labyrinth]] - класс игр лабиринт
* [[Файл:Pipes.png]] - [[Pipes]] - класс игр трубы
* [[Файл:Search object.png]] - [[HiddenObject]] - поисковый объект в хидден играх
* [[Файл:Object list.png]] - [[HiddenList]] - список поисковых объектов в хидден играх
* [[Файл:Hint.png]] - [[HiddenHint]] - подсказка (указатель на спрятанный объект)
* [[Файл:Kub.png]] - [[HiddenHighLighter]] - позволяет показать не найденные объекты в хиддене.
* [[Файл:Collection.png]] - [[Collection]] - "коллекция" поисковых объектов для хидден игр
* [[Файл:Kub.png]] - [[Color Switch]] - механика игры Color Switch
* [[Файл:Inventory.png]] - [[Inventory]] - "инвентарь" список применяемых объектов для игр
* [[Файл:Tool.png]] - [[Tool]] - "применение" - объект, который можно применить для игр
* [[Файл:Kub.png]] - [[Isomap]] - изометрическая карта
* [[Файл:Slotmachine.png]] - [[Slotmachine]] - объект типа "slot"
* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер
** [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря/магазина и экономики
** [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина
** [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря
** [[Файл:Kub.png]] - [[Ecraftitem]] - шаблон для ячейки создания предмета.
** [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий
*** [[Файл:Kub.png]] - [[Etasktemplate]] - шаблон задачи для таблицы темплейтов.
*** [[Файл:Kub.png]] - [[Elogbooktemplate]] - шаблон отображения ячейки логбука.
** [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания
** [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции
* [[Файл:Paint.png‎]] - [[Paint]] - объект для рисования
* [[Файл:Physicsworld.png]] - [[Physicsworld]] - физический мир Box2D
** [[Файл:Physicsobject.png]] - [[Physicsobject]] - физические объекты
** [[Файл:Physics links.png]] - [[Physicsjoint]] - физические соединения
* [[Файл:Eraser.png]] - [[Eraser]] - стирачка
* [[Файл:Kub.png]] - [[trivia]] - игровая механика - миллионер (trivia)
* [[Файл:Kub.png]] - [[Dailybonus]] - объект для управления механизмом ежедневного бонуса за вход в игру.
* [[Файл:Kub.png]] - [[Pet]] - объект питомца.
** [[Файл:Kub.png]] - [[PetCollectionTemplate]] - объект шаблона ячейки с коллекцией.
** [[Файл:Kub.png]] - [[PetTemplate]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[CakeTower]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[Pentamino]] - механика игры в [https://ru.wikipedia.org/wiki/%D0%9F%D0%B5%D0%BD%D1%82%D0%B0%D0%BC%D0%B8%D0%BD%D0%BE пентамино]
* [[Файл:Kub.png]] - [[TapTheNew]]
* [[Файл:Kub.png]] - [[Dressing]] - гардероб.
** [[Файл:Kub.png]] - [[Dressingtemplate]] - объект шаблона гардероба.
* [[Файл:Kub.png]] - [[solitaire]] - солитер

* [[Файл:digitz.png]] - [[Digitz]] - механика игры Digitz.
* [[Файл:Kub.png]] - [[Wordsearch]] - механика поиска слов на поле
* [[Файл:Kub.png]] - [[Builder]] - механика типа фермы
** [[Файл:Kub.png]] - [[Builderitem]] - объект шаблона здания
** [[Файл:Kub.png]] - [[Buildercomponent]] - шаблон материала для апгрейда здания
* [[Файл:Kub.png]] - [[Script Game]] - Script Game

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

=== Options ===
* [[Файл:Options.png]] - [[Options]] - общие настройки игры
* [[Файл:Gamedata.png]] - [[Gamedata]] -
* [[Файл:Controls.png]] - [[Controls]] - обьект для работы с клавишами клавиатуры или девайса
* [[Файл:Editicon.png]] - [[Edit]] - ввод текста
* [[Файл:Store.png]] - [[Store]] - настройки InApp покупок в игре
** [[Файл:Kub.png]] - [[Wallet]] - объект для начисления игровой валюты при InApp покупках через объект economics
* [[Файл:Notification.png]] - [[Notification]] - push-уведомления
* [[Файл:Imagepicker.png]] - [[Imagepiker]] - объект для загрузки фото из галереи
* [[Файл:Video.png]] - [[Video]] - объект для просмотра видео
* [[Файл:Webview.png]] - [[Webview]] - объект для просмотра интернет страниц в приложении
* [[Файл:Flurryobject.png]] - [[Flurry]] - настройки системы статистики для приложений https://dev.flurry.com
* [[Файл:Moregames.png]] - [[MoreGamesList]] - запрос банеров рекламируемых игр
* [[Файл:Advertisement.png]] - [[Advertisement]] - банерная система flurry, amazon
* [[Файл:Splitmanager.png]] - [[Splitmanager or A\B Testing]] - менеджер сплитов
* [[Файл:Tapjoy.png]] - [[Tapjoy]] - система рекламы игр
* [[Файл:Playhaven.png|24px]] - [[Playhaven]] - система рекламы игр с внутренними up-sale
* [[Файл:Mobileapptracker.png|24px]] - [[Mobileapptracking]] -
* [[Файл:Chartboost-logo-new.jpeg]] - [[Chartboost]] - Chartboost-logo-new.jpeg
* [[Файл:Kub.png]] - [[SuperSonic]] - провайдер рекламы SuperSonic
* [[Файл:Kub.png]] - [[System]] - объект для доступа к системным настройкам
* [[Файл:Kub.png]] - [[Salesmanager]] - менеджер акций
* [[Файл:Kub.png]] - [[Cloud]] - объект для синхронизации в облаке
* [[Файл:Kub.png]] - [[Game]] - объект для отправки событий
* [[Файл:Kub.png]] - [[Errormanager]] - менеджер ошибок
* [[Файл:Kub.png]] - [[Multiplayer]] - объект мультиплеера

=== Social ===
* [[Файл:Facebook.png]] - [[Facebook]] - настройки расшаривания Facebook
** [[Файл:Esocialfrienditem.png]] - [[Esocialitem]] - Шаблон для ячейки списка друзей
** [[Файл:Kub.png]] - [[Esocialgiftitem]] - Шаблон для ячейки с предметом, который можно подарить другу
** [[Файл:Esocial.png]] - [[Esocial]] - объект для взаимодействия с Facebook'ом
* [[Файл:Twitter.png]] - [[Twitter]] - настройки расшаривания Twitter
* [[Файл:Odnoklassniki.png]] - [[Odnoklassniki]] - настройки для социальной сети Одноклассники
* [[Файл:Googleplus.png]] - [[GooglePlus]] - настройки для социальной сети GooglePlus
* [[Файл:Kub.png]] - [[ShareDialog]] - объект для вызова окна шаринга в другие приложения устройства

=== Functions ===
* [[Файл:Forward.png]] - [[SendMail]] - отправка письма через почтовый клиент
* [[Файл:footer-icon-rate.png]] - [[Rate]] - вызов окна оценки приложения
* [[Файл:Kub.png]] - [[Config]] - конфиг для игровой механики

----
[[Файл:!.png]] - [[Правила оформления]] - Требование к описанию объектов.
----
<gallery widths="50px" heights="50px" >
Изображение:Who.png
Изображение:AnimalHideSeek.png
Изображение:travel.png
Изображение:Game_Adventure_Train.png
Изображение:Gmae_Match_MoveTheDolly.png
Изображение:Game_Patchwork_BigEyes.png
Изображение:Game_Patchwork_Chameleon.png
Изображение:Game_Patchwork_Logicly.png‎
Изображение:Game_Patchwork_Stickers.png‎
Изображение:Elephant.png
Изображение:Elephant2.png
Изображение:Cinderella.png
Изображение:Pigs.png
Изображение:Bremenskye.png
Изображение:Book_SnowWhite.png
Изображение:Book_PussInBoots.png
Изображение:Call.png
Изображение:GreatestArtists.png
Изображение:Game_Puzzle_Kids.png
Изображение:Game_Puzzle_Architect.png‎
Изображение:Game_Puzzle_Science.png
Изображение:Ico_1_114_Full.png
Изображение:Game_Adventure_Dreams.png
Изображение:Abc.png
Изображение:Ico_114_Full.png
Изображение:Ico_114_Paints.png
Изображение:Ico_114_Puzzle.png
</gallery>

[[category:main]]

Absolutist Framework

2018-03-30T08:31:49Z

Akovinenko: /* Main objects */

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

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

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

* [[Learning|Уроки по освоению фреймворка]]
* [[Примеры реализации в играх]]
* [[Основные понятия объектов физического мира]]
* [[Использование AppSalute Debugger при отладке]]
* [[Отладка на флеше]]
* [[FAQ]]

== Подготовка проекта ==
* [[Проектирование экранов игры]]
* [[Подготовка и форматы графики]]
* [[Подготовка и форматы шрифтов]]
* [[Подготовка и форматы звуков]]
* [[Подготовка и форматы видео]]
* [[Создание проекта]]
* [[Загрузка проекта по частям]]
* [[Конфигурация проекта для сборки]]
* [[Подготовка для загрузки на маркеты]]
* [[Сборка проекта]]
* [[Частые ошибки]]
* [[Отличия подготовки проекта для разных платформ]]
* [[Lua|Использование lua-скриптов]]
* [[Подготовка версии для Viber]]
* [[Проверка подгрузки текстур]]
* [[Экспорт проекта]]
* [[Шаблон|Экспорт/импорт шаблона проекта]]

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

=== Common objects ===

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

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

=== Main objects ===

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

* [[Файл:Kub.png]] - [[Azmanager]] - менеджер активных зон
* [[Файл:Kub.png]] - [[Active zone]] - активная зона
* [[Файл:Picture.png]] - [[Image]] - картинка
* [[Файл:Kub.png]] - [[Statistic]] - объект для отправки событий статистики.
* [[Файл:Button.png]] - [[Button]] - кнопка
* [[Файл:Text.png]] - [[Text]] - текст
* [[Файл:Machine.png]] - [[Machine]] - машина состояний
** [[Файл:Mwindow.png]] - [[Mwindow]] - машина состояний - окно
* [[Файл:Tableicon.png]] - [[Table]] - таблица
* [[Файл:Checkbox.png]] - [[Checkbox]] - чекбокс (кнопка в 2-х состояниях)
* [[Файл:Checkgroup.png]] - [[Groupbox]] - группа, содержащая несколько чекбоксов
* [[Файл:Timer.png]] - [[Timer]] - цифровой таймер
** [[Файл:Kub.png]] - [[Globaltimer]] - таймер "реального времени"
* [[Файл:Counter2.png]] - [[Counter]] - счетчик сделанных кликов в игре и т.п.
* [[Файл:Progressbar.png]] - [[Progress]] - прогресс прохождения игры (эчивмент)
* [[Файл:Particle.png]] - [[Flyer]] - флаер (патиклы)
* [[Файл:Rectangle.png]] - [[Rectangle]] - прямоугольник
* [[Файл:Kub.png]] - [[Isomover]] - объект движения в изометрической карте
* [[Файл:Group.png]] - [[Group]] - группа
* [[Файл:Groupset.png‎]] - [[Groupset]] - группа
* [[Файл:Effect.jpg|20px]] - [[Effect]] - Создание различных эффектов
* [[Файл:Graphprogress.png]] - [[Graphprogress]] - создание мини-карты для отображения прогресса прохождения игры.
* [[Файл:Statesmanager_ico.png]] - [[Statesmanager]] - очередь работы с объектами
* [[Файл:Slider icons.png]] - [[Slider]] - объект реализующий листание списка.
* [[Файл:Ribbon.png]] - [[Ribbon]] - объект отображения графики по сплайну
* [[Файл:Kub.png]] - [[Animation]] - объект различных анимаций
* [[Файл:Kub.png]] - [[Magicparticles]] - объект файлов Magic Particles
* [[Файл:Kub.png]] - [[puzzle3D]] - 3D паззл
* [[Файл:Kub.png]] - [[3D-object]] - 3D объект
* [[Файл:Kub.png]] - [[scriptresources]] - scriptresources

=== Game mechanic ===

* [[Файл:Kub.png]] - [[Avoider]] - эвойдер
* [[Файл:Kub.png]] - [[Battle]] - боевка
* [[Файл:Puzzle.png]] - [[Puzzle]] - игра пазл
* [[Файл:Memory.png]] - [[Memory]] - класс игр с memory-механикой
* [[Файл:Patchwork.png]] - [[Patchwork]] - класс игр с Patchwork-механикой
* [[Файл:Match3.png]] - [[Match]] - класс match-подобных игр
* [[Файл:Collaps.png]] - [[Collapse]] - класс match-подобных игр
* [[Файл:Bejewelled.png]] - [[Bejewelled]] - класс match-подобных игр
* [[Файл:Bs_old.png]] - [[Bubble Shooter]] - класс Bubble игр включая механику Снукер
* [[Файл:BubbleShooter.png]] - [[Bubble Shooter NEW]] - класс Bubble игр включая механику Снукер (Новый)
* [[Файл:Tapthebubble.png]] - [[TapTheBubble]] - механика игры Tap The Bubble
* [[Файл:GemSlider.jpg]] - [[Gem Slider]] - механика игры Gem Slider
* [[Файл:W-57.png]] - [[Words]] - механика игры Words
* [[Файл:Kub.png]] - [[2048]] - механика игры 2048
* [[Файл:Kub.png]] - [[Planet]] - игра "Планетки"
* [[Файл:Kub.png]] - [[Unblock]] - механика игры unblock
* [[Файл:Matchbattle.png]] - [[Match Battle]] - настройка глобальных параметров для мини-игр
* [[Файл:Move box.png]] - [[DragBox]] - класс игр с dragbox-механикой
* [[Файл:Labyrinth.png]] - [[Labyrinth]] - класс игр лабиринт
* [[Файл:Pipes.png]] - [[Pipes]] - класс игр трубы
* [[Файл:Search object.png]] - [[HiddenObject]] - поисковый объект в хидден играх
* [[Файл:Object list.png]] - [[HiddenList]] - список поисковых объектов в хидден играх
* [[Файл:Hint.png]] - [[HiddenHint]] - подсказка (указатель на спрятанный объект)
* [[Файл:Kub.png]] - [[HiddenHighLighter]] - позволяет показать не найденные объекты в хиддене.
* [[Файл:Collection.png]] - [[Collection]] - "коллекция" поисковых объектов для хидден игр
* [[Файл:Kub.png]] - [[Color Switch]] - механика игры Color Switch
* [[Файл:Inventory.png]] - [[Inventory]] - "инвентарь" список применяемых объектов для игр
* [[Файл:Tool.png]] - [[Tool]] - "применение" - объект, который можно применить для игр
* [[Файл:Kub.png]] - [[Isomap]] - изометрическая карта
* [[Файл:Slotmachine.png]] - [[Slotmachine]] - объект типа "slot"
* [[Файл:Economics.png]] - [[Economics]] - глобальная настройка игр типа ферма\билдер
** [[Файл:E_items.png]] - [[Eitems]] - объект, служащий для связи инвентаря/магазина и экономики
** [[Файл:E_store_item.png]] - [[Estoreitem]] - шаблон для ячейки магазина
** [[Файл:E_inventory_item.png]] - [[Einventoryitem]] - шаблон для ячейки инвентаря
** [[Файл:Kub.png]] - [[Ecraftitem]] - шаблон для ячейки создания предмета.
** [[Файл:Taskorganizer.png]] - [[Taskorganizer]] - органайзер заданий
*** [[Файл:Kub.png]] - [[Etasktemplate]] - шаблон задачи для таблицы темплейтов.
*** [[Файл:Kub.png]] - [[Elogbooktemplate]] - шаблон отображения ячейки логбука.
** [[Файл:E_task_item.png]] - [[Etaskitem]] - шаблон для ячейки задания
** [[Файл:E_collection.png]] - [[Ecollection]] - шаблон для строки в таблице коллекции
* [[Файл:Paint.png‎]] - [[Paint]] - объект для рисования
* [[Файл:Physicsworld.png]] - [[Physicsworld]] - физический мир Box2D
** [[Файл:Physicsobject.png]] - [[Physicsobject]] - физические объекты
** [[Файл:Physics links.png]] - [[Physicsjoint]] - физические соединения
* [[Файл:Eraser.png]] - [[Eraser]] - стирачка
* [[Файл:Kub.png]] - [[trivia]] - игровая механика - миллионер (trivia)
* [[Файл:Kub.png]] - [[Dailybonus]] - объект для управления механизмом ежедневного бонуса за вход в игру.
* [[Файл:Kub.png]] - [[Pet]] - объект питомца.
** [[Файл:Kub.png]] - [[PetCollectionTemplate]] - объект шаблона ячейки с коллекцией.
** [[Файл:Kub.png]] - [[PetTemplate]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[CakeTower]] - объект шаблона ячейки с животным.
* [[Файл:Kub.png]] - [[Pentamino]] - механика игры в [https://ru.wikipedia.org/wiki/%D0%9F%D0%B5%D0%BD%D1%82%D0%B0%D0%BC%D0%B8%D0%BD%D0%BE пентамино]
* [[Файл:Kub.png]] - [[TapTheNew]]
* [[Файл:Kub.png]] - [[Dressing]] - гардероб.
** [[Файл:Kub.png]] - [[Dressingtemplate]] - объект шаблона гардероба.
* [[Файл:Kub.png]] - [[solitaire]] - солитер

* [[Файл:digitz.png]] - [[Digitz]] - механика игры Digitz.
* [[Файл:Kub.png]] - [[Wordsearch]] - механика поиска слов на поле
* [[Файл:Kub.png]] - [[Builder]] - механика типа фермы
** [[Файл:Kub.png]] - [[Builderitem]] - объект шаблона здания
** [[Файл:Kub.png]] - [[Buildercomponent]] - шаблон материала для апгрейда здания
* [[Файл:Kub.png]] - [[Script Game]] - Script Game

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

=== Options ===
* [[Файл:Options.png]] - [[Options]] - общие настройки игры
* [[Файл:Gamedata.png]] - [[Gamedata]] -
* [[Файл:Controls.png]] - [[Controls]] - обьект для работы с клавишами клавиатуры или девайса
* [[Файл:Editicon.png]] - [[Edit]] - ввод текста
* [[Файл:Store.png]] - [[Store]] - настройки InApp покупок в игре
** [[Файл:Kub.png]] - [[Wallet]] - объект для начисления игровой валюты при InApp покупках через объект economics
* [[Файл:Notification.png]] - [[Notification]] - push-уведомления
* [[Файл:Imagepicker.png]] - [[Imagepiker]] - объект для загрузки фото из галереи
* [[Файл:Video.png]] - [[Video]] - объект для просмотра видео
* [[Файл:Webview.png]] - [[Webview]] - объект для просмотра интернет страниц в приложении
* [[Файл:Flurryobject.png]] - [[Flurry]] - настройки системы статистики для приложений https://dev.flurry.com
* [[Файл:Moregames.png]] - [[MoreGamesList]] - запрос банеров рекламируемых игр
* [[Файл:Advertisement.png]] - [[Advertisement]] - банерная система flurry, amazon
* [[Файл:Splitmanager.png]] - [[Splitmanager or A\B Testing]] - менеджер сплитов
* [[Файл:Tapjoy.png]] - [[Tapjoy]] - система рекламы игр
* [[Файл:Playhaven.png|24px]] - [[Playhaven]] - система рекламы игр с внутренними up-sale
* [[Файл:Mobileapptracker.png|24px]] - [[Mobileapptracking]] -
* [[Файл:Chartboost-logo-new.jpeg]] - [[Chartboost]] - Chartboost-logo-new.jpeg
* [[Файл:Kub.png]] - [[SuperSonic]] - провайдер рекламы SuperSonic
* [[Файл:Kub.png]] - [[System]] - объект для доступа к системным настройкам
* [[Файл:Kub.png]] - [[Salesmanager]] - менеджер акций
* [[Файл:Kub.png]] - [[Cloud]] - объект для синхронизации в облаке
* [[Файл:Kub.png]] - [[Game]] - объект для отправки событий
* [[Файл:Kub.png]] - [[Errormanager]] - менеджер ошибок
* [[Файл:Kub.png]] - [[Multiplayer]] - объект мультиплеера

=== Social ===
* [[Файл:Facebook.png]] - [[Facebook]] - настройки расшаривания Facebook
** [[Файл:Esocialfrienditem.png]] - [[Esocialitem]] - Шаблон для ячейки списка друзей
** [[Файл:Kub.png]] - [[Esocialgiftitem]] - Шаблон для ячейки с предметом, который можно подарить другу
** [[Файл:Esocial.png]] - [[Esocial]] - объект для взаимодействия с Facebook'ом
* [[Файл:Twitter.png]] - [[Twitter]] - настройки расшаривания Twitter
* [[Файл:Odnoklassniki.png]] - [[Odnoklassniki]] - настройки для социальной сети Одноклассники
* [[Файл:Googleplus.png]] - [[GooglePlus]] - настройки для социальной сети GooglePlus
* [[Файл:Kub.png]] - [[ShareDialog]] - объект для вызова окна шаринга в другие приложения устройства

=== Functions ===
* [[Файл:Forward.png]] - [[SendMail]] - отправка письма через почтовый клиент
* [[Файл:footer-icon-rate.png]] - [[Rate]] - вызов окна оценки приложения
* [[Файл:Kub.png]] - [[Config]] - конфиг для игровой механики

----
[[Файл:!.png]] - [[Правила оформления]] - Требование к описанию объектов.
----
<gallery widths="50px" heights="50px" >
Изображение:Who.png
Изображение:AnimalHideSeek.png
Изображение:travel.png
Изображение:Game_Adventure_Train.png
Изображение:Gmae_Match_MoveTheDolly.png
Изображение:Game_Patchwork_BigEyes.png
Изображение:Game_Patchwork_Chameleon.png
Изображение:Game_Patchwork_Logicly.png‎
Изображение:Game_Patchwork_Stickers.png‎
Изображение:Elephant.png
Изображение:Elephant2.png
Изображение:Cinderella.png
Изображение:Pigs.png
Изображение:Bremenskye.png
Изображение:Book_SnowWhite.png
Изображение:Book_PussInBoots.png
Изображение:Call.png
Изображение:GreatestArtists.png
Изображение:Game_Puzzle_Kids.png
Изображение:Game_Puzzle_Architect.png‎
Изображение:Game_Puzzle_Science.png
Изображение:Ico_1_114_Full.png
Изображение:Game_Adventure_Dreams.png
Изображение:Abc.png
Изображение:Ico_114_Full.png
Изображение:Ico_114_Paints.png
Изображение:Ico_114_Puzzle.png
</gallery>

[[category:main]]

HiddenHint

2018-02-14T13:43:59Z

Akovinenko: /* Добавляемые параметры */

'''HiddenHint''' - тип [[Object|объекта]], который используется для управления подсказками в "хидденах".
[[Файл:HiddenHint_1.jpg|right]]
== Общие параметры ==

Смотреть описание [[Object|Object]].

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

*'''картинка''' (''res'') - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Обычно не используется, а применяется для отображения table.

'''Группа - анимация:'''
*'''тип анимации''' (''animType'') - Тип анимирования сцены;
*'''сцена''' (''anim_scene'') - Анимируемая сцена;
*'''скорость''' (''vel'') - Скорость анимирования сцены (имеет смысл для фокусировки);
*'''восстановить''' (''recover'') - Нужно ли восстанавливать исходное состояние сцены после отработки хинта (по умолчанию да): '''0''' - нет, '''1''' - да;
*'''время''' (''anim_time'') - Время анимации ( минимум 0);
*'''отсечение''' (''down_border'') - Нижнее отсечение ( минимум 0).

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

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

Меню выбора ''Добавляемые параметры'' к объектам активируется по нажатию правой кнопки мыши.

[[Файл:+.png]] '''ошибка запуска хинта''' (''hnt_err'') - Изменяет состояние объекта при ошибке запуска хинта:
*'''объект''' (''obj'') - При клике на кнопку перевести объект в состояние из следующего поля;
*'''состояние''' (''st'') - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''ошибка запуска хинта - у хидденлиста закончились сессии''' (''errSes'') - Изменяет состояние объекта при ошибке запуска хинта:
*'''объект''' (''obj'') - При клике на кнопку перевести объект в состояние из следующего поля;
*'''состояние''' (''st'') - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''ошибка хинта - хидденлист разобран''' (''errEnd'') - Изменяет состояние объекта при ошибке запуска хинта:
*'''объект''' (''obj'') - При клике на кнопку перевести объект в состояние из следующего поля;
*'''состояние''' (''st'') - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''хинт (type1)''' (''hnt1'') - Хинт с партиклами который облетает искомый объект по эллипсу:
*'''кнопка запуска''' (''button'') - Кнопка запуска хинта;
*'''объект хинта''' (''hint'') - Объект хинта;
*'''подлетание''' (''approach''): '''1''' - сначала подлетает к хиддену, '''0''' - начинать облетать сразу;
*'''позиция (x)''' (''x0'') - Начальная позиция флайера (x);
*'''позиция (y)''' (''y0'') - Начальная позиция флайера (y);
*'''скорость подлета''' (''v_line'') - Скорость подлета;
*'''скорость облета''' (''v_ellipse'') - Скорость облета;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда( минимум 500 мс);
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет;
*'''клонировать указатель''' (''hlclone'') - если выставлен, на искомом предмете соответственно будет клон указателя, который будет удалён только после нахождения предмета или ухода с экрана. При этом параметр '''Перманентный''' должен быть выключен.

[[Файл:+.png]] '''хинт (type2)''' (''hnt2'') - Хинт с фоновой подложкой;
*'''кнопка запуска''' (''button'') - Кнопка, по нажатию на которую запуcкается хинт. При нажатии кнопка должна изменить состояние хинту в "start";
*'''объект хинта''' (''hint'') - Объект хинта. Такой себе воркер хинта (та самая подложка которая подсветит объекты). Является ресурсной машиной состояний (''machine''), которая имеет состояние: beg и end;
*'''время''' (''time'') - Время работы хинта. Устанавливается в миллисекундах;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда ( минимум 500 мс). Время, за которое можно будет повторно использовать хинт;
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.

[[Файл:+.png]] '''хинт (type3)''' (''hnt3'') - Хинт с подсветкой хидденов партиклами:
*'''кнопка запуска''' (''button'') - Кнопка, по нажатию на которую запускается хинт. При нажатии кнопка должна изменить состояние хинту в "start";
*'''объект хинта''' (''hint'') - Объект хинта. Объект типа ''flyer'' или ''machine'', у которого есть 2 состояния: beg и end;
*'''время''' (''time'') - Время действия хинта. Устанавливается в миллисекундах.;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда. Время, за которое можно будет повторно использовать хинт. Если хинт заряжается моментально, то ставить не меньше 500 мс.
*'''нечего подсказывать: объект''' (''fail_obj'') - При отсутствии объектов для подсветки данным хинтом перевести данный объект в новое состояние;
*'''нечего подсказывать: состояние''' (''fail_st'') - Новое состояние для объекта из предыдущего поля;
*'''хинт сработал: объект''' (''succ_obj'') - При успешной подсветке объекта данным хинтом перевести данный объект в новое состояние;
*'''хинт сработал: состояние''' (''succ_st'') - Новое состояние для объекта из предыдущего поля;
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.

[[Файл:+.png]] '''хинт (type4)''' (''hnt4'') - Хинт с таскаемым кругом или кольцом:
*'''кнопка запуска''' (''button'') - Кнопка, по нажатию на которую запускается хинт. При нажатии кнопка должна изменить состояние хинту в "start";
*'''объект хинта''' (''hint'') - Объект хинта. Является ресурсной (полупрозрачная область в виде круга) машиной состояний (''machine''), которая имеет состояние: beg и end. Ее подобъектом может быть кольцо. Таким образом, поисковые объекты будут проявляться между этим кругом и кольцом.
*'''позиция (x)''' (''x0'') - Стартовая позиция (x), где появляется таскаемый кусок;
*'''позиция (y)''' (''y0'') - Стартовая позиция (y), где появляется таскаемый кусок;
*'''подсвечивать все''' (''hint_all''): '''1''' - подсвечивать все хиддены, '''0''' - подсвечивать один рандомно выбранный;
*'''время''' (''time'') - Время действия хинта. Устанавливается в миллисекундах;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда. Время за которое можно будет повторно использовать хинт. Если хинт заряжается моментально, то ставить не меньше 500 мс;
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.

[[Файл:+.png]] '''хинт (type5)''' (''hnt5'') - Хинт с миганием искомого объекта по альфе:
*'''кнопка запуска''' (''button'') - Кнопка запуска хинта;
*'''время''' (''time'') - Время действия хинта;
*'''прозрачность''' (''alpha'') - Целевая прозрачность как способ прятания объекта;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда ( минимум 500мс);
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.

[[Файл:+.png]] '''хинт (искра)''' (''hnt6'') - Хинт с ''искрой'' которая вылетает и указывает расположение искомого объекта:
*'''кнопка запуска''' (''button'') - Кнопка запуска хинта;
*'''хвост''' (''tail'') - Хвост (как у кометы);
*'''указатель''' (''ptr'') - Объект, зажигающийся на месте хиддена;
*'''скорость''' (''vel'') - Скорость полета искры к объекту;
*'''время''' (''tm'') - Время активности указателя;
*'''x''' (''x'') - Точка вылетания искры (x);
*'''y''' (''y'') - Точка вылетания искры (y);
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда ( минимум 500 мс);
*'''лететь из таблицы''' (''fromTable'') - Если да, то хинт летит не из заданной точки, а из ячейки таблицы, соответствующей предмету.
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.
*'''перманентный''' (''permanent'') - Если да, то хинт не будет завершаться до клика по предмету.
*'''учитывать скейл сцены''' (''use_anim_stage_scale'') - Учитывать скейл сцены при подсчете координат полета хинта.

[[Файл:+.png]] '''хинт (цепная молния)''' (''hnt7'') - Хинт с ''цепной молнией'' которая вылетает и поочередно указывает несколько искомых объектов:
*'''кнопка запуска''' (''button'') - Кнопка запуска хинта;
*'''хвост''' (''tail'') - Хвост (как у кометы);
*'''указатель''' (''ptr'') - Объект, зажигающийся на месте хиддена;
*'''скорость''' (''vel'') - Скорость полета искры к объекту;
*'''dt''' (''dt'') - Промежутки между вспышками указателя, если хвост не задан;
*'''время''' (''tm'') - Время активности указателя;
*'''x''' (''x ') - Точка вылетания искры (x);
*'''y''' (''y'') - Точка вылетания искры (y);
*'''min''' (''min'') - Минимальное количество подсвечиваемых объектов;
*'''max''' (''max'') - Максимальное количество подсвечиваемых объектов;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда ( минимум 500 мс);
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.
*'''перманентный''' (''permanent'') - Если да, то хинт не будет завершаться до клика по предмету (для корректной работы, нужно включить параметр - "перемещать в сцену", иначе при утке флаер будет статичен в не зависимости от зума HO сцены).
*'''перемещать в сцену''' (''change_parent'') - Если да, то хинт будет перемешён в HO сцену во время работы(!!! обязательно указать флаерам прокликиваеммость).

[[Файл:+.png]] '''хинт (остановка таймера)''' (''hnt8'') - Хинт с остановкой таймер на некоторое время:
*'''кнопка запуска''' (''button'') - Кнопка запуска хинта;
*'''таймер''' (''tmr'') - Останавливаемый таймер;
*'''время''' (''tm'') - Время остановки таймера;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда ( минимум 500 мс);
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.

[[Файл:+.png]] '''хинт (бомба)''' (''hnt9'') - Хинт с ''бомбой'' которая взрывает несколько объектов.
*'''кнопка запуска''' (''button'') - Кнопка запуска хинта;
*'''начальная задержка''' (''btm'') - Задержка между началом дрожания и взрывами.
*'''интервал''' (''etm'') - Интервал между взрывами.
*'''количество''' (''num'') - Количество взрываемых объектов.
*'''отклонение''' (''dev'') - Максимальное отклонение сцены во время дрожания.
*'''интервал дрожания''' (''dtm'') - Интервал между вызовами итераций дрожания.
*'''конечная задержка''' (''wtm'') - Задержка после взрыва последнего объекта.
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда ( минимум 500 мс);
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.

[[Файл:+.png]] '''хинт (фонарь)''' (''hnt10'') - Хинт с таскаемым кругом который восстанавливает цветность в своей окружности (работает только при наличии аномалии).
*'''кнопка запуска''' (''button'') - Кнопка запуска хинта;
*'''эффект''' (''ef'') - Эффект, к которому применяется фонарь.
*'''радиус''' (''er'') - Радиус фонаря в эффекте.
*'''border''' (''eb'') - Толщина области перехода между фонарем и полным эффектом.
*'''время''' (''etr'') - Время остановки таймера.
*'''время''' (''tm'') - Время активности указателя;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда ( минимум 500 мс);
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.

[[Файл:+.png]] '''хинт (прогнать аномалию)''' (''hnt11'') - Хинт необходимый для изгнания аномалии прямиком из игры (работает только при наличии аномалии); данный хинт удаляет аномалии привязанные к объекту - effect ( аномалию дым - нужно отключать руками);
*'''кнопка запуска''' (''button'') - Кнопка запуска хинта;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда ( минимум 500 мс);
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет;
*'''правило подсветки''' ('''') - ;

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

* '''start''' - Запускает хинт.

== Правила подсветки хинтов ==

Объект хидден хинт может управлять подсветкой кнопок хинтов, чтобы обращать внимание пользователя на подсказки и заставлять его ими пользоваться. Правила подсветки записываются в виде строки:
[[Файл:Hhint highlight1.png]]

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

Когда срабатывает нужное правило, то хидден-хинт переводит машинку из поля "Объект подсветки" в одно из состояний hl%d, где %d - номер хинта. Номер хинта можно узнать наведя мышку на добавляемое свойство. Например, если навести на хинт(искра), то мы увидим hnt6, значит объект подсветки будет переведен в состояние hl6.

== Примечания ==

*HiddenHint обязательно должен быть подключен к [[HiddenList]] для того что бы знать какие объекты ему показывать.

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

== Примеры ==

=== Хинт с партиклами, которые облетают искомый объект по эллипсу (type1)===

[[Файл:Hint type1 1.jpg]] [[Файл:Hint type1 2.jpg]]

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (type1)''' 
2. Настраиваем его следующим образом:

[[Файл:Hint type1 3.jpg]]

3. Объектом хинта является флаер:

[[Файл:Hint type1 4.jpg]]

4. Объект хинта располагаем на сцене с поисковыми объектами. 
5. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

6. В группе параметров хинта '''анимация''' выбираем анимируемую сцену и тип анимации - фокусировка.

===Хинт с подложкой (type2)===

На некоторое время на сцене появляется подложка и активные хиддены становятся видны на ее фоне.

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

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (type2)''' 
2. Настраиваем его следующим образом:

[[Файл:Hint type2 1.jpg]]

3. Объектом хинта является машина состояний. Представляет собой полупрозрачный (хотя не обязательно) бекграунд для затемнения сцены (на скрине выше это синий бекграунд). Имеет 2 состояния:

*''beg'' — состояние, в которое он переводится в начале работы хинта и остается в нем до окончания его работы;
*''end'' — состояние, в котором он находится все оставшееся время, и его начальное состояние.

Как правило, в состоянии end задают нулевую прозрачность (al=0), имитируя таким образом невидимость подложки, а в состоянии beg — полную (al=1) непрозрачность. 
Должна находиться на сцене с поисковыми объектами и располагаться выше всех хидденов (то есть ниже всех хидден-объектов в дереве сцены) и связанных с ними картинок (например, таковыми могут быть небольшие бекграунды, прикрывающие хиддены).

4. Время работы хинта, время заряда устанавливаем по своему усмотрению. 
5. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

=== Хинт с подсветкой хидденов партиклами (type3) ===

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

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

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (type3)''' 
2. Настраиваем его следующим образом:

[[Файл:Hint type3 1.jpg]]

3. Объектом хинта является объект типа ''flyer''. На скрине это партикл взрыва. По настройкам параметров партикловых эффектов см. статью [[Flyer]]. 
Объектом хинта также может быть машина состояний. Она должна иметь 2 состояния: 
*''beg'' — состояние, в которое он переводится в начале работы хинта и остается в нем до окончания его работы;
*''end'' — состояние, в котором он находится все оставшееся время, и его начальное состояние.

4. Объект хинта располагаем на сцене с поисковыми объектами. 
5. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

=== Хинт с таскаемым кругом и кольцом (type4) ===

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

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

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (type4)''' 
2. Настраиваем его следующим образом:

[[Файл:Hint type4 1.jpg]]

3. Объектом хинта является ресурсная машина состояний. Имеет 2 состояния:

*''beg'' — состояние, в которое он переводится в начале работы хинта и остается в нем до окончания его работы;
*''end'' — состояние, в котором он находится все оставшееся время, и его начальное состояние.

Как правило, в состоянии end задают нулевую прозрачность (al=0), имитируя таким образом невидимость подложки, а в состоянии beg — полную (единичную) прозрачность (al=1). 

5. Графический ресурс этой машины - некоторый полупрозрачный круг. Ее подобъект - объект типа ''image'', представляющий собой кольцо. 
6. Для объекта хинта устанавливаем в 1 флаг ''хранить нажатость''. 
7. Объект хинта должен находиться на сцене с поисковыми объектами и быть выше их всех. 
8. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

9. В группе параметров хинта '''анимация''' выбираем анимируемую сцену и нужный тип анимации.

=== Хинт с миганием искомого объекта по альфе (type5) ===

Заключается в том, что на указанное время изменяется прозрачность рандомно выбранного искомого объекта. Прозрачность также, как и время, задаются в настройках хинта. 
1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (type5)''' 
2. Настраиваем его:

[[Файл:Hint type5 1.jpg]]

3. Время работы хинта, время заряда и прозрачность устанавливаем по своему усмотрению. 
4. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

=== Хинт (Искра), которая вылетает и указывает расположение искомого объекта ===

[[Файл:Hint iskra 1.jpg]] [[Файл:Hint iskra 2.jpg]]

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (искра)''' 
2. Настраиваем его следующим образом

[[Файл:Hint iskra 3.jpg]]

3. Настраиваем флаеры хвоста и указателя:

[[Файл:Hint iskra 4.jpg]] [[Файл:Hint iskra 5.jpg]]

4. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

5. В группе параметров хинта '''анимация''' выбираем анимируемую сцену и тип анимации - фокусировка.

6. Для подсветки пары объектов необходимо задать второй хвост и второй указатель (причем отличный от первого).

7. В объект HiddenHint в поле '''object_to_hint''' запишется id HiddenObject который подсвечивается, в момент старта анимации.

=== Хинт (Цепная молния), которая вылетает и поочередно указывает расположение нескольких искомых объекта ===

[[Файл:Hint type7 1.jpg]] [[Файл:Hint type7 2.jpg]]

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (цепная молния)''' 
2. Настраиваем его следующим образом

[[Файл:Hint type7 3.jpg]]

3. Настройки флаеров хвоста и указателя такие же, как и для хинта ''Искра''.

4. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

5. В группе параметров хинта '''анимация''' выбираем анимируемую сцену и тип анимации - фокусировка.

=== Хинт с остановкой таймер на некоторое время ===

Таймер останавливается на некоторое время, оставляя возможность игроку находить искомые предметы. 

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (остановка таймера)''' 
2. Настраиваем его следующим образом

[[Файл:Hint type8 11.jpg]]

3. Останавливаемый таймер - это таймер, который привязан к хидден-листу. 
4. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

=== Хинт с бомбой которая взрывает несколько объектов ===

Бекграунд начинает дрожать и с некоторой задержкой взрываются/находятся несколько поисковых объектов.

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (бомба)''' 
2. Настраиваем его следующим образом

[[Файл:Hint type8 1.jpg]]

3. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

=== Хинт с таскаемым кругом, который восстанавливает цветность в своей окружности ===

[[Файл:Hint type10 1.jpg]]

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (фонарь)''' 
2. Работает этот хинт при условии наличия аномалии. Поэтому для начала настраиваем объект типа 'effect'. На скрине - это эффект черно-белого негатива. Настроен он следующим образом: 

[[Файл:Hint type10 4.jpg]]

3. Подключаем аномалию в хидден-листе:

[[Файл:Hint type10 3.jpg]]

4.Настраиваем хинт:

[[Файл:Hint type10 2.jpg]]

5. Не забываем, что кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

== Пример ==

[[Category:Game mechanic]]

HiddenList

2018-02-14T13:41:42Z

Akovinenko: /* Основные параметры */

{{TOC right}}
HiddenList является менеджером поисковых [[Object|объектов]]. На сегодня HiddenList не просто управляет объектами на сцене - он отвечает за все штрафы и поощрения. В связке с такими объектами как [[HiddenHint]] + [[Effect]] HiddenList дает возможность реализовать систему подсказок, а также такие графические эффекты как: "ночь", "трансформация цвета" и т.д. с одним набором графики.

==Общие параметры==
(см. описание [[Object|Object]])

[[Файл:HOList_1.jpg|right]]

*'''имя''' ('' nm '') - Имя объекта HiddenList в дереве проекта. Может быт произвольным.
*'''id-объекта''' - Уникальный номер объекта HiddenList, который можно увидеть в строке "имя" либо при наведении курсора на неё.
*'''синхронизация''' ('' sync '') - Применяется для синхронизации между лейаутами. Если указан параметр "нет", то объект будет активен только на текущем лейауте. По умолчанию указан параметр "да".
*'''сохранение параметров''' ('' sv '') - Настройка этого параметра актуальна, если приложение в дальнейшем будет сворачиваться в системную панель («трей»). Выбирается значение этого параметра из выпадающего списка. Возможны следующие варианты: "нет", "только объект", "объект с подобъектами", "только подобъекты". При выходе из трэя будут восстановлены ранее измененные/установленные (при переходе с одного экрана на другой)параметры объектов или подобъектов в зависимости от выбранного варианта для этого параметра. По умолчанию указан параметр "нет". Следует помнить, что если выбирается для объекта некоторой сцены значения этого параметра отличное от "нет", то должно и предусматриваться соответствующее значение этого параметра и для этой сцены, и для экрана, содержащего эту сцену.
*'''z''' ('' z '') - Параметр порядка рисования объекта. Сначала рисуются объекты с большим z, затем, поверх них - с меньшим.
*'''память''' ('' memo ''):
:'''1''' - при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана);
:'''0''' - обновит свои параметры, при повторном открытии экрана.
*'''группа''' ('' gr '') - Группа, в которую входит текущий объект.

У листа также есть группы стандартных параметров такие как '''положение''', '''размер''', '''модификаторы'''. Но, по сути, они не важны. Главное, чтобы лист не перекрывал на сцене другие объекты. Поэтому ему лучше находиться за пределами сцены.

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

*'''Картинка''' ('' res '') - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Обычно не используется, а применяется для отображения table; 
*'''Таблица''' ('' table '') - Объект типа [[table]], который является визуальным отображением списка. '''Должна быть обязательно'''; 
*'''Подсказка''' ('' hint '') — объект типа [[HiddenHint]], который является менеджером хинтов; 
*'''highlighter''' ('' hl '') — объект типа [[HiddenHighLighter|hiddenhighlighter]], который подсвечивает не найденные объекты.; 
*'''Счетчик''' ('' hdncnt '') — объект типа [[Counter]], который отображает количество найденных объектов. 
В самом счетчике в параметрах нужно указать val = 0, поскольку изначально нет найденных объектов;
*'''Таймер''' ('' timer '') — объект типа [[Timer]], который отображает время игры.
При инициализации листа он передаст состояние "start" таймеру.
*'''отладка''' ('' trace '') — Отображать в окне состояний текущий объект.

'''Группа - внешний вид'''

*'''вычеркнуть''' ('' cross ''):
:'''1''' - найденный объект вычеркивается, оставаясь в списке(таблице);
:'''число''' - найденный объект удаляется из списка;
*'''листать''' ('' scroll '')
:'''1''' - список можно листать (скролировать);
:'''число''' - ищутся только те объекты, которые видны в списке (таблице);
*'''тип списка''' ('' kind '') - Тип поиска объектов:
:'''1''' - слово;
:'''2''' - предложение;
:'''3''' - удаляемая пиктограмма;
:'''4''' - пиктограмма;
:'''5''' - поиск различий.
*'''поиск пар''' ('' pair '') - Если 1, то идет поиска пар объектов с одинаковым типом, иначе обычный режим
:'''пары''' - поиск пар;
:'''одиночные''' - поиск по одному объекту.

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

*'''обычный''' ('' sndNrm '') - Звук при нахождении обычного [[HiddenObject]].
*'''коллекционный''' ('' sndCol '') - Звук при нахождении коллекционного [[HiddenObject]](объекту должна быть установлена коллекция).

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

*'''объектов''' ('' num '') - Максимальное количество доступных для поиска объектов в одной игровой сессии. (ВАЖНО!!! Таблице нужно установить общее количество ячеек равное(или больше) количеству доступных для поиска объектов).
*'''активных объектов''' ('' numact '') - Максимальное количество активных объектов в одной игровой сессии.
*'''видимых объектов''' ('' numvis'') - Максимальное количество видимых объектов в одной игровой сессии.
*'''одного типа''' ('' max ''):
:'''число''' - Максимальное количество объектов одного типа - поле тип в [[hiddenObject]] или хидден объекты с одинаковыми текстовыми ID могут считаться объектами одного типа;
:'''-1''' - игнорируется.
*'''прятать''' ('' hide '') - Делать невидимыми объекты, не участвующие в поиске.
*'''оставлять''' ('' stay '') - Оставлять найденный объект на месте (вызывая только флаеры) при удачном клике.
*'''актёр-иконка''' ('' actorIco '') - если "да", то во время полёта найденного хидден-объекта вместо него летит иконка которая помечена как "main picture" и указана в текстовом id хидден-объекта. 
*'''актер''' ('' actor '') - машина состояний, которая управляет процессом полета к таблице найденных [[HiddenObject]] .
*'''z актера''' ('' actorZ '') - z актера. Будет применено только если не равен 0.
*'''актер стартует из таблицы''' ('' actorTable '') - если настройка включена, то актер стартует не из позиции хиддена, а из ячейки таблицы .
*'''целевой объект''' (''trg'') - Если задан, [[HiddenObject]] после нахождения летит не в ячейку таблицы, а к нему.

'''Группа - скорость'''

Отвечают за скорость перемещения найденного объекта.
*'''полета''' ('' vf '') - Скорость полета в пикселях в секунду.
*'''вращения''' ('' vr '') - Скорость вращения в градусах в секунду.

'''Группа - равномерное распределение'''

*'''включить''' ('' undist '') - Равномерно распределять объекты по площади сцены.
*'''дополнительные сортировки''' ('' altern_algo '') - Использовать альтернативный алгоритм равномерного распределения.
*'''максимальное перекрытие''' ('' max_overlapping '') - Максимальная допустимая площадь перекрытия в пикселях.
*'''количество итераций''' ('' fix_overlapping_iter_num '') - Максимальное количество итераций фикса перекрытия объектов.
*'''удалять перекрытия''' ('' del_after_fix '') - Удалять оставшиеся перекрытия после последней итерации фикса.

Рекомендации по использованию:

*Если включать "Удалять перекрытия", то нужно для счетчика кол-ва оставшихся хидденов считывать значение из "num".
*Оптимальное значение максимальной площади - 1024 пикселей, т.е. допускаем перекрытие в 32 на 32 пикселя, что совсем не влияет на визуальное перекрытие объектов.
*Количество итераций можем ставить 20-50. Если перекрытий не останется раньше, то фикс перекрытий остановится, если выполнится все количество - отобразится количество перекрытий в логах. Большое количество итераций фикса негативно сказывается на скорости загрузки сцены.

Логи:

*"Deleting a hidden object with textID: %i" - удаление объекта с текстовым ID
*"Overlapping detected! Area: %f px" - обнаружения перекрытия в столько-то пикселей
*"fixOverlapping() Iterations num: %i / %i; Overlaps num: %i" - итерации, итоговое количество перекрытий

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

*'''скалирование объектов''' ('' scale_object '') - При нахождении во время полета объект будет скалироватся:
:'''0''' - отключено;
:'''1''' - включено.
*'''пропадание объектов''' ('' alpha_object '') - При нахождении во время полета объект будет менять альфу:
:'''0''' - отключено;
:'''1''' - включено.
*'''реагировать на отпускание''' ('' touch_up '') - Объекты связанные с этим хидденлистом будут реагировать на отпускание, а не на нажатие:
:'''0''' - отключено;
:'''1''' - включено (То есть реагировать на четкий клик, если кликнули и сместили область клика объект не реагирует!).
*'''реагировать на finger tap''' ('' finger_tap '') - Объекты, связанные с этим хидденлистом, будут реагировать на отпускание после ожидания даблтача.
*'''задержка срабатывания''' ('' touch_delay '') - только для реакции на нажатие. Время между нажатием и реакцией списка объектов.
*'''объединять одинаковые тексты''' ('' same_txt '') - Объекты с одинаковым текстом будут жить в одной ячейке таблицы с добавлением множителя xN.
:'''0''' - отключено;
:'''1''' - включено.
*'''множитель для иконок''' ('' ico_res '') - Графический ресурс(анимация) для отображения множителя у иконок для типа списка 4(поиск по иконкам) и включенного объединения одинаковых текстов. Первый фрейм - х2, второй - х3 и т.д.
*'''исключать одинаковые тексты''' ('' unTxtID '') - исключает или не исключает из поиска объекты с одинаковыми txtID, используется совместно с '''одного типа'''.
*'''вероятность пассивного предпочитаемого объекта''' ('' prefProb '') - вероятность выпадения пассивного объекта, если у объекта стоит параметр "предпочитаемый" используется при исключении объектов с одинаковыми текстовыми ID.
*'''вероятность активного предпочитаемого объекта''' ('' prefProbAct '') - вероятность выпадения активного объекта, если у объекта стоит параметр "предпочитаемый" используется при исключении объектов с одинаковыми текстовыми ID.
*'''реагировать на невидимые''' ('' canInvis '') - реагировать или нет на объекты, которые в момент игры не видны в таблице. (Кликаются только те [[hiddenObject]] которые отображены в таблице, остальные нет!).
*'''прятать актеров при старте''' ('' hideact '') - Устанавливать актерам видимость false при старте (по умолчанию - да)(То есть всем актерам которые находятся на сцене при запуске принудительно установиться vis = 0).
*'''аномалия''' ('' anom '') - для всех аномалий кроме текстовой [[HiddenObject]] и игровой фон должны быть подобъектами [[Effect]]):
:'''0''' - нет;
:'''1''' - текстовая;
:'''2''' - ночь; В машине которая выставляет эффект ночь, должны передавать сцене с объектом аномалия ( obj="scene"; par="drag"; val="0" ) и ( obj="scene"; st="update");
:'''3''' - трансформация цвета;
:'''4''' - дым.
При применении аномалии "блитц" через объект [[Economics]] набор параметров: anom="0", is_blitz="1".
*'''флурри''' ('' flurry '') - Нужно ли отправлять статистику флурри "regexp=":
:'''0''' - нет;
:'''1''' - да.
*'''вероятность инверсии''' ('' invProb '') - Вероятность того, что сцена будет перевернута по x;
*'''набор''' ('' kit '') - Набор, из которого берутся объекты.
*'''поведение дифференсов''' (''difbeh'') - Поведение найденных объектов в режиме поиск отличий.

'''Группа - появление новых объектов'''

*'''время''' ('' acttm '') - Время появления объекта (мс);
*'''начальный скейл''' ('' actsc '') - Начальный скейл;
*'''начальная альфа''' ('' actal '') - Начальная альфа.

'''Группа - сессии'''

*'''сессионность''' ('' ses ''):
:'''0''' - нет;
:'''1''' - да.
*'''ограничение сессий''' ('' sesLim '') - Максимальное количество сессий, в которые можно играть.
*'''набор объектов''' ('' sesSet '') - Набор объектов при заходе в хидден после последней сессии:
:'''0''' - случайный;
:'''1''' - последний фон;
:'''2''' - пустой.

'''Группа - цвета'''

*'''Цвет обязательных''' ('' c_forced '') — цвет текста для обязательных объектов, указывается код цвета, если строку не заполнять цвет не используется.
*'''Цвет найденных''' ('' c_found '') — цвет текста для найденных объектов, указывается код цвета, если строку не заполнять цвет не используется.
*'''Время перехода''' ('' c_time '') - Время изменения цвета.

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

*'''игры''' ('' tmGm '') - Общее время игры. Если оно истекает, идет переход на экран [время вышло] (см.ниже):
:'''-1''' - игнорируется;
:'''число''' - время игры.
*'''прерывать''' ('' tmInt ''):
:'''1''' - по окончанию времени игра будет прервана;
:'''0''' - по окончанию времени игра продолжится, но переход все равно будет на неудачную ветку.
*'''паузы''' ('' tmWt '') - Время перед закрытием окна после разбора (для осмысления результата);
*'''полета актера''' ('' tmActor '') - Время работы актера, после которого обрабатываются ячейки таблицы;
*'''перед исчезновением''' ('' tmWtHide '') - Время, в течение которого объект остается видимым после обработки.

'''Группа - ошибки'''

*'''flyer при ошибке''' ('' fl '') - обычно объект типа flyer (летуны которых надо показать в точке клика, если этот клик ошибочный). Можно в принципе любой объект который обладает состоянием "beg". Ошибочный клик - все клики мимо [[hiddenObject]].
*'''вычет времени при ошибке''' ('' tmPen '') - Сколько отнять миллисекунд за ошибочный клик.

'''Группа - переход'''

*'''при разборе''' ('' scrOk '') - Экран на который надо перейти, если все объекты найдены.
*'''время вышло''' ('' scrOv '') - Экран на который надо перейти если время вышло, а не все объекты найдены.

'''Группа - система очков'''

*'''Счетчик''' ('' score_counter '') — счетчик, отображающий набранные очки.
*'''счетчик (test)''' ('' score_counter_test '') — счетчик, отображающий набранные очки.
*'''ID пака''' ('' pack_id '') — строковый идентификатор пака(для записи набранных очков в [[options]] должен быть заполнен); используется для вытаскивания суммарных очков в счетчики и дальнейшего их отображения.
*'''ID игры''' ('' game_id '') — строковый идентификатор игры (сцены).
'''Обязательно должен иметь префикс ID пака. Например, если pack_id = "pack1", то game_id = "pack1.game1"'''.
*'''мультипликатор очков''' ('' scoreM '') — Мультипликатор очков за объект, если все собрано за отведенное время.
*'''Очки''' ('' score '') — количество очков, которые даются за каждый найденный [[hiddenObject]].
*'''Бонус за скорость''' ('' bonusS '') — бонус за быстро найденный [[hiddenObject]].
*'''Бонусный интервал''' ('' bonusT '') — время, за которое нужно найти [[hiddenObject]] для получения бонуса.
*'''бонус за время''' ('' bonusTime '') - бонус за оставшееся время игры = коэффициент который введем * оставшееся время таймера.
*'''Бонусный мультипликатор''' ('' grow ''):
:'''1''' - умножать очки за второй быстро найденный предмет на 2, за третий на 3, и т. д.
:'''0''' - не умножать.
*'''Количество кликов для штрафа''' ('' wrngC '') — количество неверных кликов, после которых запустится блокатор (см. ниже).
*'''Интервал для штрафа''' ('' wrngT '') — время, за которое нужно совершить неверные клики.
*'''Штраф (очки)''' ('' delS '') — Сколько отнимаем очков за ошибочный клик.
*'''Штраф (время)''' ('' delT '') — Сколько отнимаем времени за ошибочный клик.
*'''блокатор''' ('' blockImg '') - Объект, блокирующий сцену при серии ошибочных кликов. (Обычно маска растянутая на весь экран. '''ДОЛЖНА иметь состояние "beg"''').
*'''время блокировки''' ('' blockTime '') - Время блокировки при серии ошибочных кликов по истечении переводит "блокатор" в состояние '''end'''.
*'''порог touch move''' ('' mvSens '') - Порог, начиная с которого движение пальца воспринимается как мув и сбрасываются неправильные клики.
*'''touch move как штраф''' ('' tchMvPen '') - Считать ли touch move за ложное попадание:
:'''0''' - нет;
:'''1''' - да.
*'''клик на найденный как штраф''' ('' clkFndPen '') - Считать ли клик на найденный объект за ложное попадание(актуально если объекты остаются на сцене).
*'''аниматор очков''' ('' scoreAnim '') - машина, которая анимирует полученные очки, должна иметь состояние '''anim'''.
*'''коэффициент комбо''' ('' cmbCoef '') - коэффициент для расчёта комбо очков по формуле s(n) = k * n * (n + 1).
*'''счётчик очков за объект''' ('' objScCnt '') - счётчик который показывает очки за последний полученный объект (учитывая бонусы).
*'''счётчик комбо-очков''' ('' cmbScCnt '') - счётчик очков полученных за комбо-серию.
*'''счётчик комбо-серий''' ('' cmbRwCnt '') - счётчик который показывает комбо-серию (комбо из 2-х, 3-х и т.д. найденных объектов).
*'''комбо2 прогресс''' ('' cmb2Pr '') - комбо2 прогресс;
*'''комбо2 время''' ('' cmb2Tm '') - комбо2 время;
*'''комбо2 кол-во''' ('' cmb2Num '') - комбо2 кол-во.
*'''очки 3.0''' (''score30'') - Использовать систему очков, придуманную Степановым в августе 2015.
*'''очки 3.0 коэф. комбо''' (''score30lc'') - в конце комбо даем за него очков n * s * l * (n-1) - где n число предметов в комбо, s - очки за один предмет, l - этот коэффициент
*'''очки 3.0 коэф. аккуратности''' (''score30la'') - в конце игры начисляем очки за точность по формуле s * la / (1 + Nmiss / N)
*'''очки 3.0 коэф. времени 1 (l)''' (''score30lt'') - в конце игры начисляем очки за время по формуле s * lt / (1 + T / (tt * N))
*'''очки 3.0 коэф. времени 2 (t)''' (''score30tt'') - в конце игры начисляем очки за время по формуле s * lt / (1 + T / (tt * N))

'''Группа - звезды'''

*'''combo num''' ('' comboNum '') - Количество быстро найденных объектов, нужное для получения звезды Combo.
*'''combo time''' ('' comboInt '') - Интервал между кликами, считающимися быстрыми для Combo.
*'''accuracy''' ('' accuracy '') - Точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные).
*'''лимит ложных кликов''' ('' starWrAcc '') - Лимит ложных кликов.
Формула расчета проста, количество верных кликов делим на общее количество получаем коэффициент если он равен или больше указного нами то в опции пишем параметр, если нет то не пишем.

==Параметры бота и мультиплеера==

'''Группа - Хидден бот'''

*'''тип бота''' - тип бота:
:'''нет''' - обычная одиночная игра, бот выключен;
:'''на одном поле''' - игра с ботом на одном поле, у обоих одинаковый список предметов;
:'''с маленьким полем''' - бот будет играть на отдельном поле (??????);
:'''горячий стул''' - hotsit, игра двух живых игроков на одном девайсе, передача хода по очереди;
:'''мультиплеер''' - игра через сервер с живым оппонентом;
*'''файл уровня''' - xml файл с настройками сложности бота ([[HiddenList#Настройка сложности бота|пример]]);
*'''номер уровня''' - номер уровня в файле (начиная с 0);
*'''номер уровня max''' - если задан больше предыдущего номера - выбирается рандомное значение;
*'''multiplayer''' - объект мультиплеера;
*'''кнопка хинта''' - кнопка хинта для 2го игрока \ бота;
*'''проверять интернет''' - проверять интернет при игре с ботом (так же, как при игре с живым игроком);
*'''первый ход (вероятность)''' - вероятность первого хода игрока при игре с ботом (в процентах);
*'''t min abs ms''' - самая минимальная задержка между ходами бота;
*'''t1 min ms''' - минимальное время для быстрого нахождения предмета ботом;
*'''t1 max ms''' - максимальное время для быстрого нахождения предмета ботом;
*'''t1 prob %''' - вероятность быстрого нахождения предмета ботом;
*'''t2 min ms''' - минимальное время для нахождения предмета ботом;
*'''t2 max ms''' - максимальное время для нахождения предмета ботом;
*'''t coef delta''' - коэффициент сложности (кажется от -1 до 1, могу ошибаться);
*'''t wrong min ms''' - минимальное время между ложными кликами (мимо объекта) бота;
*'''t wrong max ms''' - максимальное время между ложными кликами бота;
*'''bot hint chance (percent)''' - шанс бота использовать хинт (в процентах);
*'''bot hint num''' - максимальное кол-во использования хинтов ботом на игру;
*'''доп. поле x''' - координаты доп. поля по Х;
*'''доп. поле y''' - координаты доп. поля по Y;
*'''доп. поле sx''' - масштаб доп. поля;
*'''доп. поле sy''' - масштаб доп. поля;
*'''указатель хода''' - указатель хода бота\оппонента. Должен иметь состояние ''beg'' и находитсья в сцене с хидденами;
*'''родитель''' - родитель, в который поместим клонированную сцену (доп. поле);
*'''счетчик очков бота''' - счетчик, выводящий очки;
*'''счетчик без бонусов бота''' - счетчик, выводящий очки без бонусов за время и точность;
*'''комбо2 прогресс бота''' - комбо2 прогресс;
*'''аниматор очков бота''' - машина, которая при нахождении хиддена анимирует полученные очки;
*'''счетчик очков за объект бот''' - счетчик, выводящий очки за объект;
*'''счетчик комбо-серий (макс) бот''' - счетчик, выводящий макс. количество комбо-серий;
*'''счетчик комбо-серий (тек) бот''' - счетчик, выводящий текущее количество комбо-серий;
*'''flyer при ошибке''' - объект типа ''flyer'' который надо показать в точке клика, если этот клик ошибочный;
*'''таймер хода бота''' - таймер хода бота;
*'''таймер хода игрока''' - таймер хода игрока;
*'''длительность хода ms''' - длительность хода игрока \ бота. Если задан 0 - игроки ходят одновременно;
*'''длительность паузы между ходами ms''' - длительность паузы при смене хода игрока\бота.

=== Настройка сложности бота ===

Файл уровней для хидден-бота должен иметь такую структуру:
<bots>
<obj id="0">
<bot weight="3" t1min="1000" t1max="2000" t1percent="15" t2min="3000" t2max="21000" twrongmax="10000" />
<bot weight="1" t1min="1000" t1max="2000" t1percent="15" t2min="3000" t2max="5000" twrongmax="10000" />
</obj>
<obj id="1">
<bot weight="1" t1min="1000" t1max="2000" t1percent="10" t2min="10000" t2max="25000" twrongmax="10000" />
<bot weight="1" t1min="1000" t1max="2000" t1percent="15" t2min="3000" t2max="7000" twrongmax="10000" />
</obj>
<obj id="2">
<bot weight="1" t1min="1000" t1max="2000" t1percent="10" t2min="7000" t2max="21000" twrongmax="10000" />
<bot weight="2" t1min="1000" t1max="2000" t1percent="15" t2min="3000" t2max="5000" twrongmax="10000" />
</obj>
</bots>

*bots - основной таг
*obj > id - номер уровня
*bot - содержит те же параметры, что и настройки бота в хидден листе

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

Состояния которые есть у листа. Мы можем передавать их с помощью различных объектов:
*'''invert''' - горизонтально отображает изображение;
*'''run''' - переводит хидден в состояние активности, если до этого был на паузе;
*'''pause''' -переводит хидден в состояние паузы, объекты не кликаются!
*'''swap_hiddens''' -меняет отображаемые в таблице поисковые объекты на случайные другие.

==Примечания==

*HiddenList должен располагаться в дереве проекта ниже всех своих поисковых объектов.

*Единственный '''обязательный объект''' о котором должен знать лист это [[Table]] для отображения списка поиска, даже если таблица не будет использоваться быть все равно должна!

*После завершения хидден-игры (по разбору или по времени)при переходе на другой экран HiddenList записывает данные в опции в два места: первое - это то, которое указано у настройках (ID пака, ID уровня, тип списка), для каждой локации свое; а второе - это last_game. 
Например, 
'''last_game.time_spent''' (либо же '''pck_N.lvl_N.kind_N.time_spent''') - время последней игры, 
'''last_game.clicks''' (либо же '''pck_N.lvl_N.kind_N.clicks''') - количество найденных объектов и т.д. 
Все их можно увидеть в опциях. last_game был придуман для того, чтобы было удобно задавать счетчики в окне результатов. Также эти данные могут быть сохранены в опциях, если задать листу состояние '''wait'''.

*Для проверки кликабельности хидденобъектов можно воспользоваться следующими настройками в app.icf:

<pre>
[GHiddenList]
HitTest=0
HitTestDx=1 - шаг по х
HitTestDy=1 - шаг по y
</pre>

в результате после перехода на сцену с хидденом появится файл, в котором будет казан объекты и координаты в которых они не тапаются.

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

[[Файл:+.png]] '''появляется новый объект: изменить состояние объекта''' ('' actst ''):
:'''объект''' ('' obj '') - Объект, состояние которого нужно изменить;
:'''состояние''' ('' st '') - Новое состояние объекта.

[[Файл:HOList_3.jpg|right]]

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

[[Файл:+.png]] '''разбор: изменить состояние объекта''' ('' nstOk '') - При нахождении всех объектов, перевести объект в новое состояние:
:'''объект''' ('' obj '') - Перевести объект в состояние из следующего поля;
:'''состояние''' ('' st '') - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''разбор: изменить параметр объекта''' ('' chgOk '') - При нахождении всех объектов, изменить параметр объекта:
:'''объект''' ('' obj '') - этот объект меняет свой параметр;
:'''свойство''' ('' par '') - Параметр, который мы изменяем;
:'''значение''' ('' val '') - Новое значение параметра.

[[Файл:+.png]] '''не успел: если был экран''' ('' wscrOv '') - Если вышло время, а объекты не найдены, переходим на определенный экран, если некоторый экран был уже хотя бы раз посещен:
:'''был экран''' ('' was '') - Экран, который мы проверяем на то, был ли он уже открыт хотя бы один раз;
:'''перейти на''' ('' scr '') - Переходим на этот экран, если экран из предыдущего поля уже открывался.

[[Файл:+.png]] '''не успел: изменить состояние объекта''' ('' nstOv '') - Если вышло время, а объекты не найдены, перевести объект в новое состояние:
:'''объект''' ('' obj '') - перевести объект в состояние из следующего поля;
:'''состояние''' ('' st '') - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''не успел: изменить параметр объекта''' ('' chgOv '') - Если вышло время, а объекты не найдены, изменить параметр объекта:
:'''объект''' ('' obj '') - этот объект меняет свой параметр;
:'''свойство''' ('' par '')- Параметр, который мы изменяем;
:'''значение''' ('' val '') - Новое значение параметра.

[[Файл:+.png]] '''счетчик очков''' ('' scoreCnt ''):
:'''счетчик''' ('' cnt '') - Каунтер, которому приходят очки.

[[Файл:+.png]] '''группа extra bonus''' ('' extraBonus ''). Используется для economics, при нахождении объекта с некой вероятностью может выпасть бонус. Объект который анимирует появление бонуса должен иметь состояние show, время на анимацию бонуса - 10 секунд:
:'''монетки объект''' ('' coinsObj '') - объект который анимирует получение монет;
:'''монетки вероятность''' ('' coinsProb '') - вероятность по нахождению объекта получить дополнительно монетки;
:'''опыт объект''' ('' expObj '') - объект который анимирует получение опыта;
:'''опыт вероятность''' ('' expProb '') - вероятность по нахождению объекта получить дополнительно опыт;
:'''энергия объект''' ('' energyObj '') - объект который анимирует получение энергии;
:'''энергия вероятность''' ('' energyProb '') - вероятность по нахождению объекта получить дополнительно энергию.

[[Файл:+.png]] '''Объект, который срабатывает, если долго не находить хидден''' ('' notfnd ''):
:'''объект''' ('' obj '') - Объект, который переводится в указанное состояние, если долго не находить хидден;
:'''состояние''' ('' st '') - Состояние, в которое переводится объект;
:'''время''' ('' tm '') - Время от последнего нахождения хиддена, после которого срабатывает объект.

[[Файл:+.png]] '''параметры аномалии с исчезновением букв''' ('' hlPars ''):
:'''оставшиеся буквы''' ('' min '') - Минимальное количество оставшихся букв в предложении;
:'''задержка''' ('' wait '') - Момент времени, начиная с которого аномалия будет проявляться;
:'''задержка 2''' ('' wait2 '') - Задержка для появившихся слов, изначально недоступных;
:'''время''' ('' time '') - Время, за которое должны исчезнуть все буквы (если -1, то до конца времени в хиддене);
:'''промежутки''' ('' dt '') - промежутки времени между каждой итерацией;
:'''флайер''' ('' fl '') - Флайер, анимирующий исчезающую букву (должен иметь '''текстовый''' тип).

[[Файл:+.png]] '''параметры аномалии ночь''' ('' nightPars ''):
:'''effect''' ('' ef '') - эффект, управляющий трансформацией цвета;
:'''tag''' ('' eftag '') - Тег эффекта, реализующего ночь.

[[Файл:+.png]] '''параметры аномалии трансформации цвета''' ('' colInvPars ''):
:'''effect''' ('' ef '') - Эффект, управляющий трансформацией цвета;
:'''tags''' ('' eftags '') - Теги эффектов, реализующих трансформацию цвета, из которых будет выбран один.

[[Файл:+.png]] '''параметры аномалии дым''' ('' smokePars ''):
:'''effect''' ('' ef '') - Машина, управляющая эффектом дыма;
:'''tag''' ('' eftag '') - Тег эффекта, реализующего дым.

Все аномалии кроме текстовой должны быть настроены с помощью объекта [[Effect]]

== Get Started==
Минимальный набор ресурсов:
* Фоновая картинка для поисковой сцены
* Комплект картинок, с которых будут сделаны поисковые [[HiddenObject|объекты]]
* Текстовые объекты для идентификации спрятанных объектов

Минимальный набор объектов редактора:
* [[Image]] который будет изменен в хидден-лист
* [[Table|Таблица]] в которой будут отображаться тексты/картинки (зависит от режима) спрятанных объектов.
* По одному [[Image]] для каждого спрятанного объекта (будут созданы автоматически при добавлении картинок из базы ресурсов на сцену)

Наши действия:
# откроем [[Интерфейс_ScenceEditor|редактор сцен]] и создадим новый проект,
# добавим новый экран с именем ''scrHList''
# создадим в этом экране сцену ''stgHList''
# перейдём в [[Интерфейс_ResourceEditor|редактор ресурсов]]
## создаём папку ''HList''
## добавим в ней картинку для фона и картинки для спрятанных объектов.
## выделим все картинки в дереве ресурсов и перенесем их на нашу сцену ''stgHList'', при этом для каждой картинки автоматически создастся объект [[Image]].
## закроем редактор ресурсов
# перейдём в [[Интерфейс_TextEditor|редактор текстов]]
## создаём папку ''HListText''
## добавим в нее текстовые объекты, по одному на каждый поисковый объект.
## сохраним внесенные изменения.
# перейдём в редактор сцен.
# создадим в сцене stgHList объект [[Table]] и назовем его HOT
## настроим размер и положение таблицы, согласно нашего дизайна
## установим параметры колонок = "50", колонок видно = "5", строчек = "5", строчек видно = "1" (таким образом в таблице будут отображаться 5 поисковых предметов, а максимальное количество объектов для поиска будет равно 250)
## установим параметры скорость листания = "650", добавлять по строкам = "0", центрировать = "растянуть", сдвигать ячейки при удалении ="да"
# создадим в сцене stgHList объект '''HiddenList''', напоминаем что его размер и положение на сцене не имеют значения, по этому расположим его где-нибудь за границей экрана. '''Важно''' В дереве проекта хидден-лист должен быть ниже всех своих поисковых объектов.
## в поле таблица указываем нашу HOT
## установим параметр объектов = "10"
## установим параметр пропадание объектов = "да"
## установим параметр реагировать на отпускание = "да"
## установим параметр реагировать на невидимые = "нет"
## установим параметр набор = "1"
# Настроим объекты, которые будут прятаться. Для этого выделим картинки поисковых объектов, добавленные нами ранее, и изменим им тип на "hiddenObject". Оставляя группу этих объектов выделенной, настроим им параметры:
## в поле list укажем наш HiddenList
## параметр набор = "1"
## Теперь снимаем выделение и каждому объекту в поле текстID перетаскиваем мышкой соответствующий текстовый объект из текстовой базы (поле текстID должно быть активно для редактирования - по нему нужно кликнуть мышкой)
# сохраним проект
# запустим [[Интерфейс_Viewer|вьювер]]

== Динамический HG==
Функционал позволяет генерировать HL самостоятельно HO объекты из файла конфига.

П.С. - вся графика д.б. динамической. Данные файлы может создавать HO_Manager ( http://wiki/index.php/HO_Manager )

[[Файл:D485ecbbbb.jpg|right]]
*'''файл уровня''' ('' configFile'') — указываем путь к файлу конфигу, где перечисляем файлы с HG.
*'''список графических ресурсов''' — служебное, пока не используется;
*'''список текстовых ресурсов''' — служебное, пока не используется;
*'''номер уровня''' ('' hiddenLevelNum '') — номер уровня из файла;
*'''образец хиддена''' ('' hiddenTemplate '') — obj_id HO объект, должен иметь нужные параметры (остальные возьмутся из конфига) ;
*'''образец нашлёпки''' ('' hiddenPatchTempl '') — obj_id нашлёпки на HO объект, должна иметь нужные параметры (остальные возьмутся из конфига);
*'''корневой объект''' ('' hiddenRoot '') — obj_id корневого объект в который сложим всех клонов;
*'''точечный спецэффект''' ('' hiddenEffect '') — ;
*'''фоновый объект ''' ('' hiddenBG '') — obj_id объекта которому поменяем ресурс;

Требования, вся графика HO,BG отрисовывается без учёта пивоты;

Файлы конфиги имеют вид:
Файл уровня имеет вид:
{
"levels": [
{
"file": "ViewerFiles/DynHid/hidden0.cfg",
"pack":3
}
]
}

:Где "levels" - линки на файлы уровней.
:::"file" - путь к файлу;
:::"pack" - пак в который попадут ресурсы;

Файл конкретного уровня имеет вид:
{
"bg": {
"src": "bg.png",
"w": 2048,
"h": 1151,
"id": 16,
"color": "#ffffff",
"tile": ""
},
"hiddens": [
{
"id": 1022,
"nm": "bucket_01",
"res": 129,
"bg": 666,
"rect": {
"x": 1393,
"y": 653,
"w": 115,
"h": 137
},
"objs": [{
"res": 1488,
"rect": {
"x": 1393,
"y": 653,
"w": 115,
"h": 137
}
}],
},
{
"x": 1537,
"y": 409,
"id": 1023,
"res": 329,
"nm": "bucket_02",
"rect": {
"x": 1493,
"y": 366,
"w": 81,
"h": 87
}
}
],
"res": {
"images": [16, 129, 1488, 329],
"texts": [1022, 1023],
"sounds": [],
}
}

:Где "bg" - настройки фона.
:::"src" - сорс графического файла в ресурсной базе;
:::"color" - цвет которым будет залито под фоном, нужное если фон имеет дырки;
:::"tile" - тайлинг фона;
:::"id" - id ресурса из ресурсной базы;
::"hiddens" - перечень HO с их настройками
::::"id" - TxtId;
::::"nm" - имя HO;
::::"res" - графический ресурс HO;
::::"bg" - графический ресурс тени;
::::"rect" - настройки "res";
:::::"x" - координата x, в координатах корневого объекта;
:::::"y" - координата y, в координатах корневого объекта;
:::::"w" - ширина;
:::::"h" - высота;
::::"objs" - перечень нашлёпок;
:::::"res" - графический ресурс нашлёпки;
:::::"rect" - настройки графического ресурса нашлёпки;
::::::"x" - координата x, в координатах HO;
::::::"y" - координата y, в координатах HO;
::::::"w" - ширина;
::::::"h" - высота;
::"res" - ресурсы которые входят в пак уровня ( будут вырезаны при экспорте в пак уровня)
::::"images" - перечень графических ресурсов
::::"texts" - перечень текстовых ресурсов
::::"sounds" - перечень звуковых ресурсов

== Авто тест HL ==
Для запуска автотеста, нам нужно указать в app.icf параметры:

[GHiddenList]
:'''HitTest''' - мода автотеста; (0- выкл.; 1 - разовая логика, пишется в файл раз в сессию для одного хидден листа ; 2 - при каждом init любого хидн листа дописывается статистика в файл);
:'''HitTestDx''' = 5 - шаг с которым проходит автокликер по X;
:'''HitTestDy''' = 5 - шаг с которым проходит автокликер по Y;

Для HitTest==2, очень помогает параметр "allow_background". Остаётся только написать скриптулину, которая ходит сама между экранами.

== Пример ==

S:\!MOBILE\!!!EditorGames\Wiki_sample

HiddenList.rar

[[Category:Game mechanic]]

[[Category:Get Started]]

HiddenHint

2018-01-26T16:13:26Z

Akovinenko: /* Добавляемые параметры */

'''HiddenHint''' - тип [[Object|объекта]], который используется для управления подсказками в "хидденах".
[[Файл:HiddenHint_1.jpg|right]]
== Общие параметры ==

Смотреть описание [[Object|Object]].

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

*'''картинка''' (''res'') - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Обычно не используется, а применяется для отображения table.

'''Группа - анимация:'''
*'''тип анимации''' (''animType'') - Тип анимирования сцены;
*'''сцена''' (''anim_scene'') - Анимируемая сцена;
*'''скорость''' (''vel'') - Скорость анимирования сцены (имеет смысл для фокусировки);
*'''восстановить''' (''recover'') - Нужно ли восстанавливать исходное состояние сцены после отработки хинта (по умолчанию да): '''0''' - нет, '''1''' - да;
*'''время''' (''anim_time'') - Время анимации ( минимум 0);
*'''отсечение''' (''down_border'') - Нижнее отсечение ( минимум 0).

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

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

Меню выбора ''Добавляемые параметры'' к объектам активируется по нажатию правой кнопки мыши.

[[Файл:+.png]] '''ошибка запуска хинта''' (''hnt_err'') - Изменяет состояние объекта при ошибке запуска хинта:
*'''объект''' (''obj'') - При клике на кнопку перевести объект в состояние из следующего поля;
*'''состояние''' (''st'') - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''ошибка запуска хинта - у хидденлиста закончились сессии''' (''errSes'') - Изменяет состояние объекта при ошибке запуска хинта:
*'''объект''' (''obj'') - При клике на кнопку перевести объект в состояние из следующего поля;
*'''состояние''' (''st'') - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''ошибка хинта - хидденлист разобран''' (''errEnd'') - Изменяет состояние объекта при ошибке запуска хинта:
*'''объект''' (''obj'') - При клике на кнопку перевести объект в состояние из следующего поля;
*'''состояние''' (''st'') - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''хинт (type1)''' (''hnt1'') - Хинт с партиклами который облетает искомый объект по эллипсу:
*'''кнопка запуска''' (''button'') - Кнопка запуска хинта;
*'''объект хинта''' (''hint'') - Объект хинта;
*'''подлетание''' (''approach''): '''1''' - сначала подлетает к хиддену, '''0''' - начинать облетать сразу;
*'''позиция (x)''' (''x0'') - Начальная позиция флайера (x);
*'''позиция (y)''' (''y0'') - Начальная позиция флайера (y);
*'''скорость подлета''' (''v_line'') - Скорость подлета;
*'''скорость облета''' (''v_ellipse'') - Скорость облета;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда( минимум 500 мс);
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет;
*'''клонировать указатель''' (''hlclone'') - если выставлен, на искомом предмете соответственно будет клон указателя, который будет удалён только после нахождения предмета или ухода с экрана. При этом параметр '''Перманентный''' должен быть выключен.

[[Файл:+.png]] '''хинт (type2)''' (''hnt2'') - Хинт с фоновой подложкой;
*'''кнопка запуска''' (''button'') - Кнопка, по нажатию на которую запуcкается хинт. При нажатии кнопка должна изменить состояние хинту в "start";
*'''объект хинта''' (''hint'') - Объект хинта. Такой себе воркер хинта (та самая подложка которая подсветит объекты). Является ресурсной машиной состояний (''machine''), которая имеет состояние: beg и end;
*'''время''' (''time'') - Время работы хинта. Устанавливается в миллисекундах;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда ( минимум 500 мс). Время, за которое можно будет повторно использовать хинт;
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.

[[Файл:+.png]] '''хинт (type3)''' (''hnt3'') - Хинт с подсветкой хидденов партиклами:
*'''кнопка запуска''' (''button'') - Кнопка, по нажатию на которую запускается хинт. При нажатии кнопка должна изменить состояние хинту в "start";
*'''объект хинта''' (''hint'') - Объект хинта. Объект типа ''flyer'' или ''machine'', у которого есть 2 состояния: beg и end;
*'''время''' (''time'') - Время действия хинта. Устанавливается в миллисекундах.;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда. Время, за которое можно будет повторно использовать хинт. Если хинт заряжается моментально, то ставить не меньше 500 мс.
*'''нечего подсказывать: объект''' (''fail_obj'') - При отсутствии объектов для подсветки данным хинтом перевести данный объект в новое состояние;
*'''нечего подсказывать: состояние''' (''fail_st'') - Новое состояние для объекта из предыдущего поля;
*'''хинт сработал: объект''' (''succ_obj'') - При успешной подсветке объекта данным хинтом перевести данный объект в новое состояние;
*'''хинт сработал: состояние''' (''succ_st'') - Новое состояние для объекта из предыдущего поля;
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.

[[Файл:+.png]] '''хинт (type4)''' (''hnt4'') - Хинт с таскаемым кругом или кольцом:
*'''кнопка запуска''' (''button'') - Кнопка, по нажатию на которую запускается хинт. При нажатии кнопка должна изменить состояние хинту в "start";
*'''объект хинта''' (''hint'') - Объект хинта. Является ресурсной (полупрозрачная область в виде круга) машиной состояний (''machine''), которая имеет состояние: beg и end. Ее подобъектом может быть кольцо. Таким образом, поисковые объекты будут проявляться между этим кругом и кольцом.
*'''позиция (x)''' (''x0'') - Стартовая позиция (x), где появляется таскаемый кусок;
*'''позиция (y)''' (''y0'') - Стартовая позиция (y), где появляется таскаемый кусок;
*'''подсвечивать все''' (''hint_all''): '''1''' - подсвечивать все хиддены, '''0''' - подсвечивать один рандомно выбранный;
*'''время''' (''time'') - Время действия хинта. Устанавливается в миллисекундах;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда. Время за которое можно будет повторно использовать хинт. Если хинт заряжается моментально, то ставить не меньше 500 мс;
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.

[[Файл:+.png]] '''хинт (type5)''' (''hnt5'') - Хинт с миганием искомого объекта по альфе:
*'''кнопка запуска''' (''button'') - Кнопка запуска хинта;
*'''время''' (''time'') - Время действия хинта;
*'''прозрачность''' (''alpha'') - Целевая прозрачность как способ прятания объекта;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда ( минимум 500мс);
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.

[[Файл:+.png]] '''хинт (искра)''' (''hnt6'') - Хинт с ''искрой'' которая вылетает и указывает расположение искомого объекта:
*'''кнопка запуска''' (''button'') - Кнопка запуска хинта;
*'''хвост''' (''tail'') - Хвост (как у кометы);
*'''указатель''' (''ptr'') - Объект, зажигающийся на месте хиддена;
*'''скорость''' (''vel'') - Скорость полета искры к объекту;
*'''время''' (''tm'') - Время активности указателя;
*'''x''' (''x'') - Точка вылетания искры (x);
*'''y''' (''y'') - Точка вылетания искры (y);
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда ( минимум 500 мс);
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.
*'''перманентный''' (''permanent'') - Если да, то хинт не будет завершаться до клика по предмету.
*'''учитывать скейл сцены''' (''use_anim_stage_scale'') - Учитывать скейл сцены при подсчете координат полета хинта.

[[Файл:+.png]] '''хинт (цепная молния)''' (''hnt7'') - Хинт с ''цепной молнией'' которая вылетает и поочередно указывает несколько искомых объектов:
*'''кнопка запуска''' (''button'') - Кнопка запуска хинта;
*'''хвост''' (''tail'') - Хвост (как у кометы);
*'''указатель''' (''ptr'') - Объект, зажигающийся на месте хиддена;
*'''скорость''' (''vel'') - Скорость полета искры к объекту;
*'''dt''' (''dt'') - Промежутки между вспышками указателя, если хвост не задан;
*'''время''' (''tm'') - Время активности указателя;
*'''x''' (''x ') - Точка вылетания искры (x);
*'''y''' (''y'') - Точка вылетания искры (y);
*'''min''' (''min'') - Минимальное количество подсвечиваемых объектов;
*'''max''' (''max'') - Максимальное количество подсвечиваемых объектов;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда ( минимум 500 мс);
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.
*'''перманентный''' (''permanent'') - Если да, то хинт не будет завершаться до клика по предмету (для корректной работы, нужно включить параметр - "перемещать в сцену", иначе при утке флаер будет статичен в не зависимости от зума HO сцены).
*'''перемещать в сцену''' (''change_parent'') - Если да, то хинт будет перемешён в HO сцену во время работы(!!! обязательно указать флаерам прокликиваеммость).

[[Файл:+.png]] '''хинт (остановка таймера)''' (''hnt8'') - Хинт с остановкой таймер на некоторое время:
*'''кнопка запуска''' (''button'') - Кнопка запуска хинта;
*'''таймер''' (''tmr'') - Останавливаемый таймер;
*'''время''' (''tm'') - Время остановки таймера;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда ( минимум 500 мс);
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.

[[Файл:+.png]] '''хинт (бомба)''' (''hnt9'') - Хинт с ''бомбой'' которая взрывает несколько объектов.
*'''кнопка запуска''' (''button'') - Кнопка запуска хинта;
*'''начальная задержка''' (''btm'') - Задержка между началом дрожания и взрывами.
*'''интервал''' (''etm'') - Интервал между взрывами.
*'''количество''' (''num'') - Количество взрываемых объектов.
*'''отклонение''' (''dev'') - Максимальное отклонение сцены во время дрожания.
*'''интервал дрожания''' (''dtm'') - Интервал между вызовами итераций дрожания.
*'''конечная задержка''' (''wtm'') - Задержка после взрыва последнего объекта.
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда ( минимум 500 мс);
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.

[[Файл:+.png]] '''хинт (фонарь)''' (''hnt10'') - Хинт с таскаемым кругом который восстанавливает цветность в своей окружности (работает только при наличии аномалии).
*'''кнопка запуска''' (''button'') - Кнопка запуска хинта;
*'''эффект''' (''ef'') - Эффект, к которому применяется фонарь.
*'''радиус''' (''er'') - Радиус фонаря в эффекте.
*'''border''' (''eb'') - Толщина области перехода между фонарем и полным эффектом.
*'''время''' (''etr'') - Время остановки таймера.
*'''время''' (''tm'') - Время активности указателя;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда ( минимум 500 мс);
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет.

[[Файл:+.png]] '''хинт (прогнать аномалию)''' (''hnt11'') - Хинт необходимый для изгнания аномалии прямиком из игры (работает только при наличии аномалии); данный хинт удаляет аномалии привязанные к объекту - effect ( аномалию дым - нужно отключать руками);
*'''кнопка запуска''' (''button'') - Кнопка запуска хинта;
*'''заряжаемый''' (''chargeable'') - Заряжаемая подсказка: '''1''' - вкл., '''0''' - выкл.;
*'''время заряда''' (''charge_time'') - Время заряда ( минимум 500 мс);
*'''блокирующий''' (''bl'') - Если да, то выполнение хинта блокирует возможность запуска других хинтов: '''0''' - да, '''1''' - нет;
*'''правило подсветки''' ('''') - ;

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

* '''start''' - Запускает хинт.

== Правила подсветки хинтов ==

Объект хидден хинт может управлять подсветкой кнопок хинтов, чтобы обращать внимание пользователя на подсказки и заставлять его ими пользоваться. Правила подсветки записываются в виде строки:
[[Файл:Hhint highlight1.png]]

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

Когда срабатывает нужное правило, то хидден-хинт переводит машинку из поля "Объект подсветки" в одно из состояний hl%d, где %d - номер хинта. Номер хинта можно узнать наведя мышку на добавляемое свойство. Например, если навести на хинт(искра), то мы увидим hnt6, значит объект подсветки будет переведен в состояние hl6.

== Примечания ==

*HiddenHint обязательно должен быть подключен к [[HiddenList]] для того что бы знать какие объекты ему показывать.

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

== Примеры ==

=== Хинт с партиклами, которые облетают искомый объект по эллипсу (type1)===

[[Файл:Hint type1 1.jpg]] [[Файл:Hint type1 2.jpg]]

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (type1)''' 
2. Настраиваем его следующим образом:

[[Файл:Hint type1 3.jpg]]

3. Объектом хинта является флаер:

[[Файл:Hint type1 4.jpg]]

4. Объект хинта располагаем на сцене с поисковыми объектами. 
5. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

6. В группе параметров хинта '''анимация''' выбираем анимируемую сцену и тип анимации - фокусировка.

===Хинт с подложкой (type2)===

На некоторое время на сцене появляется подложка и активные хиддены становятся видны на ее фоне.

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

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (type2)''' 
2. Настраиваем его следующим образом:

[[Файл:Hint type2 1.jpg]]

3. Объектом хинта является машина состояний. Представляет собой полупрозрачный (хотя не обязательно) бекграунд для затемнения сцены (на скрине выше это синий бекграунд). Имеет 2 состояния:

*''beg'' — состояние, в которое он переводится в начале работы хинта и остается в нем до окончания его работы;
*''end'' — состояние, в котором он находится все оставшееся время, и его начальное состояние.

Как правило, в состоянии end задают нулевую прозрачность (al=0), имитируя таким образом невидимость подложки, а в состоянии beg — полную (al=1) непрозрачность. 
Должна находиться на сцене с поисковыми объектами и располагаться выше всех хидденов (то есть ниже всех хидден-объектов в дереве сцены) и связанных с ними картинок (например, таковыми могут быть небольшие бекграунды, прикрывающие хиддены).

4. Время работы хинта, время заряда устанавливаем по своему усмотрению. 
5. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

=== Хинт с подсветкой хидденов партиклами (type3) ===

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

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

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (type3)''' 
2. Настраиваем его следующим образом:

[[Файл:Hint type3 1.jpg]]

3. Объектом хинта является объект типа ''flyer''. На скрине это партикл взрыва. По настройкам параметров партикловых эффектов см. статью [[Flyer]]. 
Объектом хинта также может быть машина состояний. Она должна иметь 2 состояния: 
*''beg'' — состояние, в которое он переводится в начале работы хинта и остается в нем до окончания его работы;
*''end'' — состояние, в котором он находится все оставшееся время, и его начальное состояние.

4. Объект хинта располагаем на сцене с поисковыми объектами. 
5. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

=== Хинт с таскаемым кругом и кольцом (type4) ===

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

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

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (type4)''' 
2. Настраиваем его следующим образом:

[[Файл:Hint type4 1.jpg]]

3. Объектом хинта является ресурсная машина состояний. Имеет 2 состояния:

*''beg'' — состояние, в которое он переводится в начале работы хинта и остается в нем до окончания его работы;
*''end'' — состояние, в котором он находится все оставшееся время, и его начальное состояние.

Как правило, в состоянии end задают нулевую прозрачность (al=0), имитируя таким образом невидимость подложки, а в состоянии beg — полную (единичную) прозрачность (al=1). 

5. Графический ресурс этой машины - некоторый полупрозрачный круг. Ее подобъект - объект типа ''image'', представляющий собой кольцо. 
6. Для объекта хинта устанавливаем в 1 флаг ''хранить нажатость''. 
7. Объект хинта должен находиться на сцене с поисковыми объектами и быть выше их всех. 
8. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

9. В группе параметров хинта '''анимация''' выбираем анимируемую сцену и нужный тип анимации.

=== Хинт с миганием искомого объекта по альфе (type5) ===

Заключается в том, что на указанное время изменяется прозрачность рандомно выбранного искомого объекта. Прозрачность также, как и время, задаются в настройках хинта. 
1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (type5)''' 
2. Настраиваем его:

[[Файл:Hint type5 1.jpg]]

3. Время работы хинта, время заряда и прозрачность устанавливаем по своему усмотрению. 
4. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

=== Хинт (Искра), которая вылетает и указывает расположение искомого объекта ===

[[Файл:Hint iskra 1.jpg]] [[Файл:Hint iskra 2.jpg]]

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (искра)''' 
2. Настраиваем его следующим образом

[[Файл:Hint iskra 3.jpg]]

3. Настраиваем флаеры хвоста и указателя:

[[Файл:Hint iskra 4.jpg]] [[Файл:Hint iskra 5.jpg]]

4. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

5. В группе параметров хинта '''анимация''' выбираем анимируемую сцену и тип анимации - фокусировка.

6. Для подсветки пары объектов необходимо задать второй хвост и второй указатель (причем отличный от первого).

7. В объект HiddenHint в поле '''object_to_hint''' запишется id HiddenObject который подсвечивается, в момент старта анимации.

=== Хинт (Цепная молния), которая вылетает и поочередно указывает расположение нескольких искомых объекта ===

[[Файл:Hint type7 1.jpg]] [[Файл:Hint type7 2.jpg]]

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (цепная молния)''' 
2. Настраиваем его следующим образом

[[Файл:Hint type7 3.jpg]]

3. Настройки флаеров хвоста и указателя такие же, как и для хинта ''Искра''.

4. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

5. В группе параметров хинта '''анимация''' выбираем анимируемую сцену и тип анимации - фокусировка.

=== Хинт с остановкой таймер на некоторое время ===

Таймер останавливается на некоторое время, оставляя возможность игроку находить искомые предметы. 

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (остановка таймера)''' 
2. Настраиваем его следующим образом

[[Файл:Hint type8 11.jpg]]

3. Останавливаемый таймер - это таймер, который привязан к хидден-листу. 
4. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

=== Хинт с бомбой которая взрывает несколько объектов ===

Бекграунд начинает дрожать и с некоторой задержкой взрываются/находятся несколько поисковых объектов.

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (бомба)''' 
2. Настраиваем его следующим образом

[[Файл:Hint type8 1.jpg]]

3. Кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

=== Хинт с таскаемым кругом, который восстанавливает цветность в своей окружности ===

[[Файл:Hint type10 1.jpg]]

1. Выбираем для хинта добавляемый параметр [[Файл:+.png]] '''хинт (фонарь)''' 
2. Работает этот хинт при условии наличия аномалии. Поэтому для начала настраиваем объект типа 'effect'. На скрине - это эффект черно-белого негатива. Настроен он следующим образом: 

[[Файл:Hint type10 4.jpg]]

3. Подключаем аномалию в хидден-листе:

[[Файл:Hint type10 3.jpg]]

4.Настраиваем хинт:

[[Файл:Hint type10 2.jpg]]

5. Не забываем, что кнопка запуска хинта должна содержать следующее событие:

[[Файл:Hint iskra 6.jpg]]

== Пример ==

[[Category:Game mechanic]]

HiddenList

2018-01-26T16:11:36Z

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

{{TOC right}}
HiddenList является менеджером поисковых [[Object|объектов]]. На сегодня HiddenList не просто управляет объектами на сцене - он отвечает за все штрафы и поощрения. В связке с такими объектами как [[HiddenHint]] + [[Effect]] HiddenList дает возможность реализовать систему подсказок, а также такие графические эффекты как: "ночь", "трансформация цвета" и т.д. с одним набором графики.

==Общие параметры==
(см. описание [[Object|Object]])

[[Файл:HOList_1.jpg|right]]

*'''имя''' ('' nm '') - Имя объекта HiddenList в дереве проекта. Может быт произвольным.
*'''id-объекта''' - Уникальный номер объекта HiddenList, который можно увидеть в строке "имя" либо при наведении курсора на неё.
*'''синхронизация''' ('' sync '') - Применяется для синхронизации между лейаутами. Если указан параметр "нет", то объект будет активен только на текущем лейауте. По умолчанию указан параметр "да".
*'''сохранение параметров''' ('' sv '') - Настройка этого параметра актуальна, если приложение в дальнейшем будет сворачиваться в системную панель («трей»). Выбирается значение этого параметра из выпадающего списка. Возможны следующие варианты: "нет", "только объект", "объект с подобъектами", "только подобъекты". При выходе из трэя будут восстановлены ранее измененные/установленные (при переходе с одного экрана на другой)параметры объектов или подобъектов в зависимости от выбранного варианта для этого параметра. По умолчанию указан параметр "нет". Следует помнить, что если выбирается для объекта некоторой сцены значения этого параметра отличное от "нет", то должно и предусматриваться соответствующее значение этого параметра и для этой сцены, и для экрана, содержащего эту сцену.
*'''z''' ('' z '') - Параметр порядка рисования объекта. Сначала рисуются объекты с большим z, затем, поверх них - с меньшим.
*'''память''' ('' memo ''):
:'''1''' - при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана);
:'''0''' - обновит свои параметры, при повторном открытии экрана.
*'''группа''' ('' gr '') - Группа, в которую входит текущий объект.

У листа также есть группы стандартных параметров такие как '''положение''', '''размер''', '''модификаторы'''. Но, по сути, они не важны. Главное, чтобы лист не перекрывал на сцене другие объекты. Поэтому ему лучше находиться за пределами сцены.

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

*'''Картинка''' ('' res '') - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Обычно не используется, а применяется для отображения table; 
*'''Таблица''' ('' table '') - Объект типа [[table]], который является визуальным отображением списка. '''Должна быть обязательно'''; 
*'''Подсказка''' ('' hint '') — объект типа [[HiddenHint]], который является менеджером хинтов; 
*'''highlighter''' ('' hl '') — объект типа [[HiddenHighLighter|hiddenhighlighter]], который подсвечивает не найденные объекты.; 
*'''Счетчик''' ('' hdncnt '') — объект типа [[Counter]], который отображает количество найденных объектов. 
В самом счетчике в параметрах нужно указать val = 0, поскольку изначально нет найденных объектов;
*'''Таймер''' ('' timer '') — объект типа [[Timer]], который отображает время игры.
При инициализации листа он передаст состояние "start" таймеру.
*'''отладка''' ('' trace '') — Отображать в окне состояний текущий объект.

'''Группа - внешний вид'''

*'''вычеркнуть''' ('' cross ''):
:'''1''' - найденный объект вычеркивается, оставаясь в списке(таблице);
:'''число''' - найденный объект удаляется из списка;
*'''листать''' ('' scroll '')
:'''1''' - список можно листать (скролировать);
:'''число''' - ищутся только те объекты, которые видны в списке (таблице);
*'''тип списка''' ('' kind '') - Тип поиска объектов:
:'''1''' - слово;
:'''2''' - предложение;
:'''3''' - удаляемая пиктограмма;
:'''4''' - пиктограмма;
:'''5''' - поиск различий.
*'''поиск пар''' ('' pair '') - Если 1, то идет поиска пар объектов с одинаковым типом, иначе обычный режим
:'''пары''' - поиск пар;
:'''одиночные''' - поиск по одному объекту.

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

*'''обычный''' ('' sndNrm '') - Звук при нахождении обычного [[HiddenObject]].
*'''коллекционный''' ('' sndCol '') - Звук при нахождении коллекционного [[HiddenObject]](объекту должна быть установлена коллекция).

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

*'''объектов''' ('' num '') - Максимальное количество доступных для поиска объектов в одной игровой сессии. (ВАЖНО!!! Таблице нужно установить общее количество ячеек равное(или больше) количеству доступных для поиска объектов).
*'''активных объектов''' ('' numact '') - Максимальное количество активных объектов в одной игровой сессии.
*'''видимых объектов''' ('' numvis'') - Максимальное количество видимых объектов в одной игровой сессии.
*'''одного типа''' ('' max ''):
:'''число''' - Максимальное количество объектов одного типа - поле тип в [[hiddenObject]] или хидден объекты с одинаковыми текстовыми ID могут считаться объектами одного типа;
:'''-1''' - игнорируется.
*'''прятать''' ('' hide '') - Делать невидимыми объекты, не участвующие в поиске.
*'''оставлять''' ('' stay '') - Оставлять найденный объект на месте (вызывая только флаеры) при удачном клике.
*'''актёр-иконка''' ('' actorIco '') - если "да", то во время полёта найденного хидден-объекта вместо него летит иконка которая помечена как "main picture" и указана в текстовом id хидден-объекта. 
*'''актер''' ('' actor '') - машина состояний, которая управляет процессом полета к таблице найденных [[HiddenObject]] .
*'''целевой объект''' (''trg'') - Если задан, [[HiddenObject]] после нахождения летит не в ячейку таблицы, а к нему.

'''Группа - скорость'''

Отвечают за скорость перемещения найденного объекта.
*'''полета''' ('' vf '') - Скорость полета в пикселях в секунду.
*'''вращения''' ('' vr '') - Скорость вращения в градусах в секунду.

'''Группа - равномерное распределение'''

*'''включить''' ('' undist '') - Равномерно распределять объекты по площади сцены.
*'''дополнительные сортировки''' ('' altern_algo '') - Использовать альтернативный алгоритм равномерного распределения.
*'''максимальное перекрытие''' ('' max_overlapping '') - Максимальная допустимая площадь перекрытия в пикселях.
*'''количество итераций''' ('' fix_overlapping_iter_num '') - Максимальное количество итераций фикса перекрытия объектов.
*'''удалять перекрытия''' ('' del_after_fix '') - Удалять оставшиеся перекрытия после последней итерации фикса.

Рекомендации по использованию:

*Если включать "Удалять перекрытия", то нужно для счетчика кол-ва оставшихся хидденов считывать значение из "num".
*Оптимальное значение максимальной площади - 1024 пикселей, т.е. допускаем перекрытие в 32 на 32 пикселя, что совсем не влияет на визуальное перекрытие объектов.
*Количество итераций можем ставить 20-50. Если перекрытий не останется раньше, то фикс перекрытий остановится, если выполнится все количество - отобразится количество перекрытий в логах. Большое количество итераций фикса негативно сказывается на скорости загрузки сцены.

Логи:

*"Deleting a hidden object with textID: %i" - удаление объекта с текстовым ID
*"Overlapping detected! Area: %f px" - обнаружения перекрытия в столько-то пикселей
*"fixOverlapping() Iterations num: %i / %i; Overlaps num: %i" - итерации, итоговое количество перекрытий

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

*'''скалирование объектов''' ('' scale_object '') - При нахождении во время полета объект будет скалироватся:
:'''0''' - отключено;
:'''1''' - включено.
*'''пропадание объектов''' ('' alpha_object '') - При нахождении во время полета объект будет менять альфу:
:'''0''' - отключено;
:'''1''' - включено.
*'''реагировать на отпускание''' ('' touch_up '') - Объекты связанные с этим хидденлистом будут реагировать на отпускание, а не на нажатие:
:'''0''' - отключено;
:'''1''' - включено (То есть реагировать на четкий клик, если кликнули и сместили область клика объект не реагирует!).
*'''реагировать на finger tap''' ('' finger_tap '') - Объекты, связанные с этим хидденлистом, будут реагировать на отпускание после ожидания даблтача.
*'''задержка срабатывания''' ('' touch_delay '') - только для реакции на нажатие. Время между нажатием и реакцией списка объектов.
*'''объединять одинаковые тексты''' ('' same_txt '') - Объекты с одинаковым текстом будут жить в одной ячейке таблицы с добавлением множителя xN.
:'''0''' - отключено;
:'''1''' - включено.
*'''множитель для иконок''' ('' ico_res '') - Графический ресурс(анимация) для отображения множителя у иконок для типа списка 4(поиск по иконкам) и включенного объединения одинаковых текстов. Первый фрейм - х2, второй - х3 и т.д.
*'''исключать одинаковые тексты''' ('' unTxtID '') - исключает или не исключает из поиска объекты с одинаковыми txtID, используется совместно с '''одного типа'''.
*'''вероятность пассивного предпочитаемого объекта''' ('' prefProb '') - вероятность выпадения пассивного объекта, если у объекта стоит параметр "предпочитаемый" используется при исключении объектов с одинаковыми текстовыми ID.
*'''вероятность активного предпочитаемого объекта''' ('' prefProbAct '') - вероятность выпадения активного объекта, если у объекта стоит параметр "предпочитаемый" используется при исключении объектов с одинаковыми текстовыми ID.
*'''реагировать на невидимые''' ('' canInvis '') - реагировать или нет на объекты, которые в момент игры не видны в таблице. (Кликаются только те [[hiddenObject]] которые отображены в таблице, остальные нет!).
*'''прятать актеров при старте''' ('' hideact '') - Устанавливать актерам видимость false при старте (по умолчанию - да)(То есть всем актерам которые находятся на сцене при запуске принудительно установиться vis = 0).
*'''аномалия''' ('' anom '') - для всех аномалий кроме текстовой [[HiddenObject]] и игровой фон должны быть подобъектами [[Effect]]):
:'''0''' - нет;
:'''1''' - текстовая;
:'''2''' - ночь; В машине которая выставляет эффект ночь, должны передавать сцене с объектом аномалия ( obj="scene"; par="drag"; val="0" ) и ( obj="scene"; st="update");
:'''3''' - трансформация цвета;
:'''4''' - дым.
При применении аномалии "блитц" через объект [[Economics]] набор параметров: anom="0", is_blitz="1".
*'''флурри''' ('' flurry '') - Нужно ли отправлять статистику флурри "regexp=":
:'''0''' - нет;
:'''1''' - да.
*'''вероятность инверсии''' ('' invProb '') - Вероятность того, что сцена будет перевернута по x;
*'''набор''' ('' kit '') - Набор, из которого берутся объекты.
*'''поведение дифференсов''' (''difbeh'') - Поведение найденных объектов в режиме поиск отличий.

'''Группа - появление новых объектов'''

*'''время''' ('' acttm '') - Время появления объекта (мс);
*'''начальный скейл''' ('' actsc '') - Начальный скейл;
*'''начальная альфа''' ('' actal '') - Начальная альфа.

'''Группа - сессии'''

*'''сессионность''' ('' ses ''):
:'''0''' - нет;
:'''1''' - да.
*'''ограничение сессий''' ('' sesLim '') - Максимальное количество сессий, в которые можно играть.
*'''набор объектов''' ('' sesSet '') - Набор объектов при заходе в хидден после последней сессии:
:'''0''' - случайный;
:'''1''' - последний фон;
:'''2''' - пустой.

'''Группа - цвета'''

*'''Цвет обязательных''' ('' c_forced '') — цвет текста для обязательных объектов, указывается код цвета, если строку не заполнять цвет не используется.
*'''Цвет найденных''' ('' c_found '') — цвет текста для найденных объектов, указывается код цвета, если строку не заполнять цвет не используется.
*'''Время перехода''' ('' c_time '') - Время изменения цвета.

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

*'''игры''' ('' tmGm '') - Общее время игры. Если оно истекает, идет переход на экран [время вышло] (см.ниже):
:'''-1''' - игнорируется;
:'''число''' - время игры.
*'''прерывать''' ('' tmInt ''):
:'''1''' - по окончанию времени игра будет прервана;
:'''0''' - по окончанию времени игра продолжится, но переход все равно будет на неудачную ветку.
*'''паузы''' ('' tmWt '') - Время перед закрытием окна после разбора (для осмысления результата);
*'''полета актера''' ('' tmActor '') - Время работы актера, после которого обрабатываются ячейки таблицы;
*'''перед исчезновением''' ('' tmWtHide '') - Время, в течение которого объект остается видимым после обработки.

'''Группа - ошибки'''

*'''flyer при ошибке''' ('' fl '') - обычно объект типа flyer (летуны которых надо показать в точке клика, если этот клик ошибочный). Можно в принципе любой объект который обладает состоянием "beg". Ошибочный клик - все клики мимо [[hiddenObject]].
*'''вычет времени при ошибке''' ('' tmPen '') - Сколько отнять миллисекунд за ошибочный клик.

'''Группа - переход'''

*'''при разборе''' ('' scrOk '') - Экран на который надо перейти, если все объекты найдены.
*'''время вышло''' ('' scrOv '') - Экран на который надо перейти если время вышло, а не все объекты найдены.

'''Группа - система очков'''

*'''Счетчик''' ('' score_counter '') — счетчик, отображающий набранные очки.
*'''счетчик (test)''' ('' score_counter_test '') — счетчик, отображающий набранные очки.
*'''ID пака''' ('' pack_id '') — строковый идентификатор пака(для записи набранных очков в [[options]] должен быть заполнен); используется для вытаскивания суммарных очков в счетчики и дальнейшего их отображения.
*'''ID игры''' ('' game_id '') — строковый идентификатор игры (сцены).
'''Обязательно должен иметь префикс ID пака. Например, если pack_id = "pack1", то game_id = "pack1.game1"'''.
*'''мультипликатор очков''' ('' scoreM '') — Мультипликатор очков за объект, если все собрано за отведенное время.
*'''Очки''' ('' score '') — количество очков, которые даются за каждый найденный [[hiddenObject]].
*'''Бонус за скорость''' ('' bonusS '') — бонус за быстро найденный [[hiddenObject]].
*'''Бонусный интервал''' ('' bonusT '') — время, за которое нужно найти [[hiddenObject]] для получения бонуса.
*'''бонус за время''' ('' bonusTime '') - бонус за оставшееся время игры = коэффициент который введем * оставшееся время таймера.
*'''Бонусный мультипликатор''' ('' grow ''):
:'''1''' - умножать очки за второй быстро найденный предмет на 2, за третий на 3, и т. д.
:'''0''' - не умножать.
*'''Количество кликов для штрафа''' ('' wrngC '') — количество неверных кликов, после которых запустится блокатор (см. ниже).
*'''Интервал для штрафа''' ('' wrngT '') — время, за которое нужно совершить неверные клики.
*'''Штраф (очки)''' ('' delS '') — Сколько отнимаем очков за ошибочный клик.
*'''Штраф (время)''' ('' delT '') — Сколько отнимаем времени за ошибочный клик.
*'''блокатор''' ('' blockImg '') - Объект, блокирующий сцену при серии ошибочных кликов. (Обычно маска растянутая на весь экран. '''ДОЛЖНА иметь состояние "beg"''').
*'''время блокировки''' ('' blockTime '') - Время блокировки при серии ошибочных кликов по истечении переводит "блокатор" в состояние '''end'''.
*'''порог touch move''' ('' mvSens '') - Порог, начиная с которого движение пальца воспринимается как мув и сбрасываются неправильные клики.
*'''touch move как штраф''' ('' tchMvPen '') - Считать ли touch move за ложное попадание:
:'''0''' - нет;
:'''1''' - да.
*'''клик на найденный как штраф''' ('' clkFndPen '') - Считать ли клик на найденный объект за ложное попадание(актуально если объекты остаются на сцене).
*'''аниматор очков''' ('' scoreAnim '') - машина, которая анимирует полученные очки, должна иметь состояние '''anim'''.
*'''коэффициент комбо''' ('' cmbCoef '') - коэффициент для расчёта комбо очков по формуле s(n) = k * n * (n + 1).
*'''счётчик очков за объект''' ('' objScCnt '') - счётчик который показывает очки за последний полученный объект (учитывая бонусы).
*'''счётчик комбо-очков''' ('' cmbScCnt '') - счётчик очков полученных за комбо-серию.
*'''счётчик комбо-серий''' ('' cmbRwCnt '') - счётчик который показывает комбо-серию (комбо из 2-х, 3-х и т.д. найденных объектов).
*'''комбо2 прогресс''' ('' cmb2Pr '') - комбо2 прогресс;
*'''комбо2 время''' ('' cmb2Tm '') - комбо2 время;
*'''комбо2 кол-во''' ('' cmb2Num '') - комбо2 кол-во.
*'''очки 3.0''' (''score30'') - Использовать систему очков, придуманную Степановым в августе 2015.
*'''очки 3.0 коэф. комбо''' (''score30lc'') - в конце комбо даем за него очков n * s * l * (n-1) - где n число предметов в комбо, s - очки за один предмет, l - этот коэффициент
*'''очки 3.0 коэф. аккуратности''' (''score30la'') - в конце игры начисляем очки за точность по формуле s * la / (1 + Nmiss / N)
*'''очки 3.0 коэф. времени 1 (l)''' (''score30lt'') - в конце игры начисляем очки за время по формуле s * lt / (1 + T / (tt * N))
*'''очки 3.0 коэф. времени 2 (t)''' (''score30tt'') - в конце игры начисляем очки за время по формуле s * lt / (1 + T / (tt * N))

'''Группа - звезды'''

*'''combo num''' ('' comboNum '') - Количество быстро найденных объектов, нужное для получения звезды Combo.
*'''combo time''' ('' comboInt '') - Интервал между кликами, считающимися быстрыми для Combo.
*'''accuracy''' ('' accuracy '') - Точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные).
*'''лимит ложных кликов''' ('' starWrAcc '') - Лимит ложных кликов.
Формула расчета проста, количество верных кликов делим на общее количество получаем коэффициент если он равен или больше указного нами то в опции пишем параметр, если нет то не пишем.

==Параметры бота и мультиплеера==

'''Группа - Хидден бот'''

*'''тип бота''' - тип бота:
:'''нет''' - обычная одиночная игра, бот выключен;
:'''на одном поле''' - игра с ботом на одном поле, у обоих одинаковый список предметов;
:'''с маленьким полем''' - бот будет играть на отдельном поле (??????);
:'''горячий стул''' - hotsit, игра двух живых игроков на одном девайсе, передача хода по очереди;
:'''мультиплеер''' - игра через сервер с живым оппонентом;
*'''файл уровня''' - xml файл с настройками сложности бота ([[HiddenList#Настройка сложности бота|пример]]);
*'''номер уровня''' - номер уровня в файле (начиная с 0);
*'''номер уровня max''' - если задан больше предыдущего номера - выбирается рандомное значение;
*'''multiplayer''' - объект мультиплеера;
*'''кнопка хинта''' - кнопка хинта для 2го игрока \ бота;
*'''проверять интернет''' - проверять интернет при игре с ботом (так же, как при игре с живым игроком);
*'''первый ход (вероятность)''' - вероятность первого хода игрока при игре с ботом (в процентах);
*'''t min abs ms''' - самая минимальная задержка между ходами бота;
*'''t1 min ms''' - минимальное время для быстрого нахождения предмета ботом;
*'''t1 max ms''' - максимальное время для быстрого нахождения предмета ботом;
*'''t1 prob %''' - вероятность быстрого нахождения предмета ботом;
*'''t2 min ms''' - минимальное время для нахождения предмета ботом;
*'''t2 max ms''' - максимальное время для нахождения предмета ботом;
*'''t coef delta''' - коэффициент сложности (кажется от -1 до 1, могу ошибаться);
*'''t wrong min ms''' - минимальное время между ложными кликами (мимо объекта) бота;
*'''t wrong max ms''' - максимальное время между ложными кликами бота;
*'''bot hint chance (percent)''' - шанс бота использовать хинт (в процентах);
*'''bot hint num''' - максимальное кол-во использования хинтов ботом на игру;
*'''доп. поле x''' - координаты доп. поля по Х;
*'''доп. поле y''' - координаты доп. поля по Y;
*'''доп. поле sx''' - масштаб доп. поля;
*'''доп. поле sy''' - масштаб доп. поля;
*'''указатель хода''' - указатель хода бота\оппонента. Должен иметь состояние ''beg'' и находитсья в сцене с хидденами;
*'''родитель''' - родитель, в который поместим клонированную сцену (доп. поле);
*'''счетчик очков бота''' - счетчик, выводящий очки;
*'''счетчик без бонусов бота''' - счетчик, выводящий очки без бонусов за время и точность;
*'''комбо2 прогресс бота''' - комбо2 прогресс;
*'''аниматор очков бота''' - машина, которая при нахождении хиддена анимирует полученные очки;
*'''счетчик очков за объект бот''' - счетчик, выводящий очки за объект;
*'''счетчик комбо-серий (макс) бот''' - счетчик, выводящий макс. количество комбо-серий;
*'''счетчик комбо-серий (тек) бот''' - счетчик, выводящий текущее количество комбо-серий;
*'''flyer при ошибке''' - объект типа ''flyer'' который надо показать в точке клика, если этот клик ошибочный;
*'''таймер хода бота''' - таймер хода бота;
*'''таймер хода игрока''' - таймер хода игрока;
*'''длительность хода ms''' - длительность хода игрока \ бота. Если задан 0 - игроки ходят одновременно;
*'''длительность паузы между ходами ms''' - длительность паузы при смене хода игрока\бота.

=== Настройка сложности бота ===

Файл уровней для хидден-бота должен иметь такую структуру:
<bots>
<obj id="0">
<bot weight="3" t1min="1000" t1max="2000" t1percent="15" t2min="3000" t2max="21000" twrongmax="10000" />
<bot weight="1" t1min="1000" t1max="2000" t1percent="15" t2min="3000" t2max="5000" twrongmax="10000" />
</obj>
<obj id="1">
<bot weight="1" t1min="1000" t1max="2000" t1percent="10" t2min="10000" t2max="25000" twrongmax="10000" />
<bot weight="1" t1min="1000" t1max="2000" t1percent="15" t2min="3000" t2max="7000" twrongmax="10000" />
</obj>
<obj id="2">
<bot weight="1" t1min="1000" t1max="2000" t1percent="10" t2min="7000" t2max="21000" twrongmax="10000" />
<bot weight="2" t1min="1000" t1max="2000" t1percent="15" t2min="3000" t2max="5000" twrongmax="10000" />
</obj>
</bots>

*bots - основной таг
*obj > id - номер уровня
*bot - содержит те же параметры, что и настройки бота в хидден листе

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

Состояния которые есть у листа. Мы можем передавать их с помощью различных объектов:
*'''invert''' - горизонтально отображает изображение;
*'''run''' - переводит хидден в состояние активности, если до этого был на паузе;
*'''pause''' -переводит хидден в состояние паузы, объекты не кликаются!
*'''swap_hiddens''' -меняет отображаемые в таблице поисковые объекты на случайные другие.

==Примечания==

*HiddenList должен располагаться в дереве проекта ниже всех своих поисковых объектов.

*Единственный '''обязательный объект''' о котором должен знать лист это [[Table]] для отображения списка поиска, даже если таблица не будет использоваться быть все равно должна!

*После завершения хидден-игры (по разбору или по времени)при переходе на другой экран HiddenList записывает данные в опции в два места: первое - это то, которое указано у настройках (ID пака, ID уровня, тип списка), для каждой локации свое; а второе - это last_game. 
Например, 
'''last_game.time_spent''' (либо же '''pck_N.lvl_N.kind_N.time_spent''') - время последней игры, 
'''last_game.clicks''' (либо же '''pck_N.lvl_N.kind_N.clicks''') - количество найденных объектов и т.д. 
Все их можно увидеть в опциях. last_game был придуман для того, чтобы было удобно задавать счетчики в окне результатов. Также эти данные могут быть сохранены в опциях, если задать листу состояние '''wait'''.

*Для проверки кликабельности хидденобъектов можно воспользоваться следующими настройками в app.icf:

<pre>
[GHiddenList]
HitTest=0
HitTestDx=1 - шаг по х
HitTestDy=1 - шаг по y
</pre>

в результате после перехода на сцену с хидденом появится файл, в котором будет казан объекты и координаты в которых они не тапаются.

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

[[Файл:+.png]] '''появляется новый объект: изменить состояние объекта''' ('' actst ''):
:'''объект''' ('' obj '') - Объект, состояние которого нужно изменить;
:'''состояние''' ('' st '') - Новое состояние объекта.

[[Файл:HOList_3.jpg|right]]

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

[[Файл:+.png]] '''разбор: изменить состояние объекта''' ('' nstOk '') - При нахождении всех объектов, перевести объект в новое состояние:
:'''объект''' ('' obj '') - Перевести объект в состояние из следующего поля;
:'''состояние''' ('' st '') - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''разбор: изменить параметр объекта''' ('' chgOk '') - При нахождении всех объектов, изменить параметр объекта:
:'''объект''' ('' obj '') - этот объект меняет свой параметр;
:'''свойство''' ('' par '') - Параметр, который мы изменяем;
:'''значение''' ('' val '') - Новое значение параметра.

[[Файл:+.png]] '''не успел: если был экран''' ('' wscrOv '') - Если вышло время, а объекты не найдены, переходим на определенный экран, если некоторый экран был уже хотя бы раз посещен:
:'''был экран''' ('' was '') - Экран, который мы проверяем на то, был ли он уже открыт хотя бы один раз;
:'''перейти на''' ('' scr '') - Переходим на этот экран, если экран из предыдущего поля уже открывался.

[[Файл:+.png]] '''не успел: изменить состояние объекта''' ('' nstOv '') - Если вышло время, а объекты не найдены, перевести объект в новое состояние:
:'''объект''' ('' obj '') - перевести объект в состояние из следующего поля;
:'''состояние''' ('' st '') - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''не успел: изменить параметр объекта''' ('' chgOv '') - Если вышло время, а объекты не найдены, изменить параметр объекта:
:'''объект''' ('' obj '') - этот объект меняет свой параметр;
:'''свойство''' ('' par '')- Параметр, который мы изменяем;
:'''значение''' ('' val '') - Новое значение параметра.

[[Файл:+.png]] '''счетчик очков''' ('' scoreCnt ''):
:'''счетчик''' ('' cnt '') - Каунтер, которому приходят очки.

[[Файл:+.png]] '''группа extra bonus''' ('' extraBonus ''). Используется для economics, при нахождении объекта с некой вероятностью может выпасть бонус. Объект который анимирует появление бонуса должен иметь состояние show, время на анимацию бонуса - 10 секунд:
:'''монетки объект''' ('' coinsObj '') - объект который анимирует получение монет;
:'''монетки вероятность''' ('' coinsProb '') - вероятность по нахождению объекта получить дополнительно монетки;
:'''опыт объект''' ('' expObj '') - объект который анимирует получение опыта;
:'''опыт вероятность''' ('' expProb '') - вероятность по нахождению объекта получить дополнительно опыт;
:'''энергия объект''' ('' energyObj '') - объект который анимирует получение энергии;
:'''энергия вероятность''' ('' energyProb '') - вероятность по нахождению объекта получить дополнительно энергию.

[[Файл:+.png]] '''Объект, который срабатывает, если долго не находить хидден''' ('' notfnd ''):
:'''объект''' ('' obj '') - Объект, который переводится в указанное состояние, если долго не находить хидден;
:'''состояние''' ('' st '') - Состояние, в которое переводится объект;
:'''время''' ('' tm '') - Время от последнего нахождения хиддена, после которого срабатывает объект.

[[Файл:+.png]] '''параметры аномалии с исчезновением букв''' ('' hlPars ''):
:'''оставшиеся буквы''' ('' min '') - Минимальное количество оставшихся букв в предложении;
:'''задержка''' ('' wait '') - Момент времени, начиная с которого аномалия будет проявляться;
:'''задержка 2''' ('' wait2 '') - Задержка для появившихся слов, изначально недоступных;
:'''время''' ('' time '') - Время, за которое должны исчезнуть все буквы (если -1, то до конца времени в хиддене);
:'''промежутки''' ('' dt '') - промежутки времени между каждой итерацией;
:'''флайер''' ('' fl '') - Флайер, анимирующий исчезающую букву (должен иметь '''текстовый''' тип).

[[Файл:+.png]] '''параметры аномалии ночь''' ('' nightPars ''):
:'''effect''' ('' ef '') - эффект, управляющий трансформацией цвета;
:'''tag''' ('' eftag '') - Тег эффекта, реализующего ночь.

[[Файл:+.png]] '''параметры аномалии трансформации цвета''' ('' colInvPars ''):
:'''effect''' ('' ef '') - Эффект, управляющий трансформацией цвета;
:'''tags''' ('' eftags '') - Теги эффектов, реализующих трансформацию цвета, из которых будет выбран один.

[[Файл:+.png]] '''параметры аномалии дым''' ('' smokePars ''):
:'''effect''' ('' ef '') - Машина, управляющая эффектом дыма;
:'''tag''' ('' eftag '') - Тег эффекта, реализующего дым.

Все аномалии кроме текстовой должны быть настроены с помощью объекта [[Effect]]

== Get Started==
Минимальный набор ресурсов:
* Фоновая картинка для поисковой сцены
* Комплект картинок, с которых будут сделаны поисковые [[HiddenObject|объекты]]
* Текстовые объекты для идентификации спрятанных объектов

Минимальный набор объектов редактора:
* [[Image]] который будет изменен в хидден-лист
* [[Table|Таблица]] в которой будут отображаться тексты/картинки (зависит от режима) спрятанных объектов.
* По одному [[Image]] для каждого спрятанного объекта (будут созданы автоматически при добавлении картинок из базы ресурсов на сцену)

Наши действия:
# откроем [[Интерфейс_ScenceEditor|редактор сцен]] и создадим новый проект,
# добавим новый экран с именем ''scrHList''
# создадим в этом экране сцену ''stgHList''
# перейдём в [[Интерфейс_ResourceEditor|редактор ресурсов]]
## создаём папку ''HList''
## добавим в ней картинку для фона и картинки для спрятанных объектов.
## выделим все картинки в дереве ресурсов и перенесем их на нашу сцену ''stgHList'', при этом для каждой картинки автоматически создастся объект [[Image]].
## закроем редактор ресурсов
# перейдём в [[Интерфейс_TextEditor|редактор текстов]]
## создаём папку ''HListText''
## добавим в нее текстовые объекты, по одному на каждый поисковый объект.
## сохраним внесенные изменения.
# перейдём в редактор сцен.
# создадим в сцене stgHList объект [[Table]] и назовем его HOT
## настроим размер и положение таблицы, согласно нашего дизайна
## установим параметры колонок = "50", колонок видно = "5", строчек = "5", строчек видно = "1" (таким образом в таблице будут отображаться 5 поисковых предметов, а максимальное количество объектов для поиска будет равно 250)
## установим параметры скорость листания = "650", добавлять по строкам = "0", центрировать = "растянуть", сдвигать ячейки при удалении ="да"
# создадим в сцене stgHList объект '''HiddenList''', напоминаем что его размер и положение на сцене не имеют значения, по этому расположим его где-нибудь за границей экрана. '''Важно''' В дереве проекта хидден-лист должен быть ниже всех своих поисковых объектов.
## в поле таблица указываем нашу HOT
## установим параметр объектов = "10"
## установим параметр пропадание объектов = "да"
## установим параметр реагировать на отпускание = "да"
## установим параметр реагировать на невидимые = "нет"
## установим параметр набор = "1"
# Настроим объекты, которые будут прятаться. Для этого выделим картинки поисковых объектов, добавленные нами ранее, и изменим им тип на "hiddenObject". Оставляя группу этих объектов выделенной, настроим им параметры:
## в поле list укажем наш HiddenList
## параметр набор = "1"
## Теперь снимаем выделение и каждому объекту в поле текстID перетаскиваем мышкой соответствующий текстовый объект из текстовой базы (поле текстID должно быть активно для редактирования - по нему нужно кликнуть мышкой)
# сохраним проект
# запустим [[Интерфейс_Viewer|вьювер]]

== Динамический HG==
Функционал позволяет генерировать HL самостоятельно HO объекты из файла конфига.

П.С. - вся графика д.б. динамической. Данные файлы может создавать HO_Manager ( http://wiki/index.php/HO_Manager )

[[Файл:D485ecbbbb.jpg|right]]
*'''файл уровня''' ('' configFile'') — указываем путь к файлу конфигу, где перечисляем файлы с HG.
*'''список графических ресурсов''' — служебное, пока не используется;
*'''список текстовых ресурсов''' — служебное, пока не используется;
*'''номер уровня''' ('' hiddenLevelNum '') — номер уровня из файла;
*'''образец хиддена''' ('' hiddenTemplate '') — obj_id HO объект, должен иметь нужные параметры (остальные возьмутся из конфига) ;
*'''образец нашлёпки''' ('' hiddenPatchTempl '') — obj_id нашлёпки на HO объект, должна иметь нужные параметры (остальные возьмутся из конфига);
*'''корневой объект''' ('' hiddenRoot '') — obj_id корневого объект в который сложим всех клонов;
*'''точечный спецэффект''' ('' hiddenEffect '') — ;
*'''фоновый объект ''' ('' hiddenBG '') — obj_id объекта которому поменяем ресурс;

Требования, вся графика HO,BG отрисовывается без учёта пивоты;

Файлы конфиги имеют вид:
Файл уровня имеет вид:
{
"levels": [
{
"file": "ViewerFiles/DynHid/hidden0.cfg",
"pack":3
}
]
}

:Где "levels" - линки на файлы уровней.
:::"file" - путь к файлу;
:::"pack" - пак в который попадут ресурсы;

Файл конкретного уровня имеет вид:
{
"bg": {
"src": "bg.png",
"w": 2048,
"h": 1151,
"id": 16,
"color": "#ffffff",
"tile": ""
},
"hiddens": [
{
"id": 1022,
"nm": "bucket_01",
"res": 129,
"bg": 666,
"rect": {
"x": 1393,
"y": 653,
"w": 115,
"h": 137
},
"objs": [{
"res": 1488,
"rect": {
"x": 1393,
"y": 653,
"w": 115,
"h": 137
}
}],
},
{
"x": 1537,
"y": 409,
"id": 1023,
"res": 329,
"nm": "bucket_02",
"rect": {
"x": 1493,
"y": 366,
"w": 81,
"h": 87
}
}
]
}

:Где "bg" - настройки фона.
:::"src" - сорс графического файла в ресурсной базе;
:::"color" - цвет которым будет залито под фоном, нужное если фон имеет дырки;
:::"tile" - тайлинг фона;
:::"id" - id ресурса из ресурсной базы;
::"hiddens" - перечень HO с их настройками
::::"id" - TxtId;
::::"nm" - имя HO;
::::"res" - графический ресурс HO;
::::"bg" - графический ресурс тени;
::::"rect" - настройки "res";
:::::"x" - координата x, в координатах корневого объекта;
:::::"y" - координата y, в координатах корневого объекта;
:::::"w" - ширина;
:::::"h" - высота;
::::"objs" - перечень нашлёпок;
:::::"res" - графический ресурс нашлёпки;
:::::"rect" - настройки графического ресурса нашлёпки;
::::::"x" - координата x, в координатах HO;
::::::"y" - координата y, в координатах HO;
::::::"w" - ширина;
::::::"h" - высота;

== Авто тест HL ==
Для запуска автотеста, нам нужно указать в app.icf параметры:

[GHiddenList]
:'''HitTest''' - мода автотеста; (0- выкл.; 1 - разовая логика, пишется в файл раз в сессию для одного хидден листа ; 2 - при каждом init любого хидн листа дописывается статистика в файл);
:'''HitTestDx''' = 5 - шаг с которым проходит автокликер по X;
:'''HitTestDy''' = 5 - шаг с которым проходит автокликер по Y;

Для HitTest==2, очень помогает параметр "allow_background". Остаётся только написать скриптулину, которая ходит сама между экранами.

== Пример ==

S:\!MOBILE\!!!EditorGames\Wiki_sample

HiddenList.rar

[[Category:Game mechanic]]

[[Category:Get Started]]

Bubble Shooter NEW

2018-01-05T11:59:36Z

Akovinenko: /* Очковая система */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

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

'''Merge'''
*'''макс. уровень (max_level)''' - место в опциях, где лежит макс. уровень.
*'''сага тэг (saga_tag)''' - место в опциях, где лежит вся информация по саге.
*'''классика очки (classic_score)''' - место в опциях, где лежат очки по классике.
*'''классика тэг (classic_tag)''' - место в опциях, где лежит вся информация по классике.

=Графика=
*'''цветной шарик 1 (res1)''' - графический ресурс шарика 1.
*'''фрейм шарика 1 (res1Frame)''' - Номер фрейма ресурса шарика 1.
*'''цветной шарик 2 (res2)''' - графический ресурс шарика 2.
*'''фрейм шарика 2 (res2Frame)''' - Номер фрейма ресурса шарика 2.
*'''цветной шарик 3 (res3)''' - графический ресурс шарика 3
*'''фрейм шарика 3 (res3Frame)''' - Номер фрейма ресурса шарика 3.
*'''цветной шарик 4 (res4)''' - графический ресурс шарика 4.
*'''фрейм шарика 4 (res4Frame)''' - Номер фрейма ресурса шарика 4.
*'''цветной шарик 5 (res5)''' - графический ресурс шарика 5.
*'''фрейм шарика 5 (res5Frame)''' - Номер фрейма ресурса шарика 5.
*'''цветной шарик 6 (res6)''' - графический ресурс шарика 6.
*'''фрейм шарика 6 (res6Frame)''' - Номер фрейма ресурса шарика 6.
*'''цветной шарик 7 (res7)''' - графический ресурс шарика 7.
*'''фрейм шарика 7 (res7Frame)''' - Номер фрейма ресурса шарика 7.
*'''цветной шарик 8 (res8)''' - графический ресурс шарика 8.
*'''фрейм шарика 8 (res8Frame)''' - Номер фрейма ресурса шарика 8.
*'''цветной шарик Y (resY)''' - графический ресурс цветного шарика.
*'''гвоздь (resZ)''' - графический ресурс гвоздя.
*'''целевой шарик 1 (rest1)''' - графический ресурс целевого шарика 1.
*'''фрейм шарика 1 (rest1Frame)''' - Номер фрейма ресурса целевого шарика 1.
*'''целевой шарик 2 (rest2)''' - графический ресурс целевого шарика 2.
*'''фрейм шарика 2 (rest2Frame)''' - Номер фрейма ресурса целевого шарика 2.
*'''целевой шарик 3 (rest3)''' - графический ресурс целевого шарика 3
*'''фрейм шарика 3 (rest3Frame)''' - Номер фрейма ресурса целевого шарика 3.
*'''целевой шарик 4 (rest4)''' - графический ресурс целевого шарика 4.
*'''фрейм шарика 4 (rest4Frame)''' - Номер фрейма ресурса целевого шарика 4.
*'''целевой шарик 5 (rest5)''' - графический ресурс целевого шарика 5.
*'''фрейм шарика 5 (rest5Frame)''' - Номер фрейма ресурса целевого шарика 5.
*'''целевой шарик 6 (rest6)''' - графический ресурс целевого шарика 6.
*'''фрейм шарика 6 (rest6Frame)''' - Номер фрейма ресурса целевого шарика 6.
*'''целевой шарик 7 (rest7)''' - графический ресурс целевого шарика 7.
*'''фрейм шарика 7 (rest7Frame)''' - Номер фрейма ресурса целевого шарика 7.
*'''целевой шарик 8 (rest8)''' - графический ресурс целевого шарика 8.
*'''фрейм шарика 8 (rest8Frame)''' - Номер фрейма ресурса целевого шарика 8.
*'''целевой шарик Y (restY)''' - графический ресурс целевого цветного шарика.
*'''маска залочки (res_lock_mask)''' - графический ресурс маски залочки.
*'''падающий шарик (res_drop_mask)''' - графический ресурс падающего шарика.
*'''лунка (resf1)''' - графический ресурс лунки.
*'''фрейм лунка (resf1Frame)''' - Номер фрейма ресурса лунки.
*'''колючка (resf2)''' - графический ресурс колючки.
*'''фрейм колючка (resf2Frame)''' - Номер фрейма ресурса колючки.
*'''снежинка (resf3)''' - графический ресурс снежинки.
*'''фрейм снежинка (resf3Frame)''' - Номер фрейма ресурса снежинки.
*'''вредитель (resf4)''' - графический ресурс вредителя.
*'''фрейм вредитель (resf4Frame)''' - Номер фрейма ресурса вредителя.
*'''половинки (resf5)''' - графический ресурс половинок.
*'''фрейм половинки (resf5Frame)''' - Номер фрейма ресурса половинок.
*'''камень (resf6)''' - графический ресурс камня.
*'''фрейм камень (resf6Frame)''' - Номер фрейма ресурса камня.
*'''хищник (resf8)''' - графический ресурс маски залочки.
*'''фрейм хищник (resf8Frame)''' - графический ресурс маски залочки.
*'''призрак (resf9)''' - графический ресурс призрака.
*'''фрейм призрак (resf9Frame)''' - Номер фрейма ресурса призрака.
*'''шестеренка (resf10)''' - графический ресурс шетеренки.
*'''фрейм шестеренка (resf10Frame)''' - Номер фрейма ресурса шестеренки.
*'''туман (resf11)''' - графический ресурс тумана.
*'''фрейм туман (resf11Frame)''' - Номер фрейма ресурса тумана.
*'''портал (resf12)''' - графический ресурс портала.
*'''фрейм портал (resf12Frame)''' - Номер фрейма ресурса портала.
*'''призрак-цель (resf13)''' - графический ресурс призрак-цель.
*'''фрейм призрак-цель (resf13Frame)''' - Номер фрейма ресурса призрак-цель.
*'''огонь (resf14)''' - графический ресурс огня.
*'''фрейм огонь (resf14Frame)''' - Номер фрейма ресурса огонь.
*'''молния (resf15)''' - графический ресурс молнии.
*'''фрейм молния (resf15Frame)''' - Номер фрейма ресурса молния.
*'''радужный шар (resrainbow)''' - графический ресурс радужного шара.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''drop''' - Звук осыпания.
*'''intro''' - Звук в начале игры.
*'''add row''' - Звук добавления ряда.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Звук взрыва бомбы мина.
*'''Взрыв бомбы ядро''' - Звук взрыва бомбы ядро.
*'''Взрыв бомбы цвет''' - Звук взрыва бомбы цвет.
*'''Бомба мульти цвет''' - Звук взыва бомбы мульти цвет.
*'''Закат в лунку''' - Звук заката в лунку.
*'''Взрыв колючкой''' - Звук взрыва колючкой.
*'''Таяние снежинки''' - Звук таяния снежинки.

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.

=Машины отображающие пушку=
*'''Первый шарик''' - машина, отображающая первый шарик. При выстреле в эту машину пишется параметр '''curr_bomb_type''', который говорит о том, выстрелили мы обычным шариком или бустером (0 - обычный шарик).
*'''Второй шарик''' - машина, отображающая второй шарик.
*'''Третий шарик''' - машина, отображающая третий шарик.

'''Машины могут иметь состояния:'''
*'''shot''' - выстрел.
*'''shot_over''' - окончание выстрела.
*'''swap''' - смена шариков.
*'''swap_over''' - окончание смены шариков.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res (curres)''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Расстояние между шариками (distance)''' - Расстояние между шариками, от которого зависит их количество.
*'''Кол-во шариков в последней линии (last_line_count_bubs)''' - количество шариков, которе будет в последней линии курсора.
*'''Отражения (curlns)''' - максимальное кол-во отражений от стенок.
*'''Коэффициент (curkoef)''' - коэффициент ds/s, где s - базовое расстояние между шариками, ds - его наращивание.
*'''минимальный скейл (curminsc)''' - минимальный скейл графики шариков
*'''максимальный скейл (curmaxsc)''' - максимальный скейл графики шариков
*'''время скалирования (cursctm)''' - время скалирования шариков

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего шарика (x,y)''' - Позиция стреляющего шарика (x,y)
*'''Позиция следующего шарика (x,y)''' - Позиция следующего шарика (x,y).
*'''Позиция 3-го шарика (x,y)''' - Позиция 3-го шарика (x,y).
*'''третий шарик (n3bub)''' - если 0 - 3-го шарика не будет, 1 - есть третий шарик.
*'''Коэффициент вероятности цветов''' - коэффициент вероятности цветов.
*'''Расстояние от следующего шарика''' - расстояние от следующего шарика.
*'''Скорость наезда для режима Bubblez''' - скорость наезда для режима Bubblez.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Скейл шариков для снукера''' - скейл шариков для снукера.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления рядов''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Color mapping''' - Color mapping включён (0 - нет, 1 - да).
*'''Тип рандома''' - Тип рандома. Простой - берём случайный из всех цветов, Супер Рандом - супер алгоритм, Из набора - формируем набор из n шариков и перемешиваем.
*'''Количество цвета для набора''' - количество цвета для формирования набора в рандоме (касается типа рандома "Из набора").
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''Файл трекинга''' - Файл трекинга формата .xml.
*'''Таблица трекинга''' - Таблица трекинга.
*'''Объект новых шариков''' - Объект, которому сообщается о новых шариках.
*'''Мувер''' - Объект, двигающий баббл шутер.
*'''Задержка перед броском''' - задержка перед броском.
*'''Задержка перед обрывом шариков''' - задержка перед обрывом шариков.
*'''К-во секторов для броска''' - Количество секторов для броска.
*'''Слушатель движения мыши''' - объект, слушатель движения мыши.
*'''Слушатель броска''' - объект, слушатель броска. По сути вызывается только состояние st1.
*'''Слушатель движения поля''' - объект, слушатель движения поля. Должен иметь состояния move (поле двигается) и move_over (окончание движения поля).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''Феерверк после победы''' - Включить феерверк из шариков сразу после победы (0 - нет, 1 - да).

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Очковая система=
*'''Тип''' - ''classic'' (1+2+3+4...), ''new'' (n * (n + 1) / 2 * coef * k), ''Xkoef'' (x * n * k * coef), где n - к-во сматченных шариков, k - номер удачного выстрела в серии, coef - коэффициент, x - очки за шарик.
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''коеф для матча (xkoef)''' - (xkoef_match_coef) коэффициент очков для матча.
*'''коеф для обвала (xkoef)''' - (xkoef_drop_coef) коэффициент очков для обвала.
*'''коеф для бустера (xkoef)''' - (xkoef_booster_coef) коэффициент очков для матча.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

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

===[[Файл:+.png]] Визцализатор целей===
*'''Заглушки''' - заглушки.
*'''Индикаторы''' - индикаторы.
*'''Каунтеры''' - каунтеры.

===[[Файл:+.png]] Параметры эффекта для специальных шариков===
*'''Этими параметрами можно пользоваться вместо "параметры анимации для шарика"'''
*'''Тип специального шарика''' - тип специального шарика (лунка, колючка, снежинка, вредитель, шарик из двух половинок, камень, целевой шарик, хищник, призрак, шестеренка, туман, портал, целевой шарик призрак, огонь, молния, под огнем).
*'''Эффект''' - Машинка, которая будет получать события:
**'''beg''' - начало эффекта.
**'''hit''' - попадание (есть матч).
**'''miss''' - промах (нет матча).
**'''match_around''' - сматчились шарики рядом.
**'''shot''' - выстрел.
**'''destroy''' - уничтожение эффекта.
**'''end''' - окончание эффекта (вызывается после destroy).
*'''Смещение эффекта''' - смещение эффекта относительно шарика.
*'''Количество действий''' - количество действий (попаданий, выстрелов, промахов), после которых специальный шарик начнет некую обработку (например огонь перекинется на другой шарик).
*'''Действие''' - действие (нет, выстрел, попадание, промах).
*'''Задержка перед destroy''' - время перед уничтожением эффекта.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек. Возможные значения F - functionality в файле уровня:
**'''0''' - обычный шарик
**'''1''' - лунка (попавший в нее шарик "проваливается")
**'''2''' - колючка (попавший в нее шарик просто лопается и матч не просчитывается)
**'''3''' - снежинка (при попадании в нее или схлопывании шарика рядом тает и превращается в обычный шарик)
**'''4''' - вредитель (увеличит уровень залочки шарика на один; шарик выбирается по алгоритму закрашивания)
**'''5''' - шарик из двух половинок; при матче с одной половинкой шарик лопается
**'''6''' - камень (не матчится, не опадает, не двигается, от него отскакивают шарики)
**'''7''' - целевой шарик (когда все такие шарики убиваются или обваливаются, игра считается выиграна)
**'''8''' - хищник (съедает шарик; отличается от лунки наличием анимации и убиваемостью)
**'''9''' - призрак (то же, что и снежинка, но у снежинки цвет задан изначально, а призрак его обретает после матча)
**'''A''' - шестеренка (при попадании в нее начинает двигаться по горизонтали и убивать шарики на пути)
**'''B''' - туман (шар с туманом, при попадании туман пропадает на определенное количество действий)
**'''C''' - портал (имеет два входа-выхода, обозначенных цветом по контуру портала. При попадании шаром в один из входов-выходов, шар вылетает из другого, продолжая траекторию движения)
**'''D''' - целевой шарик призрак (сначала действует как призрак, потом как целевой шарик)
**'''E''' - огонь (при попадании шар воспломеняется. после определенного количество действий шар сгорает и "заражает" огнем соседний верхний шар)
**'''F''' - молния (при попадании лопает все шары по горизонтальной линии)
**'''16''' - замароженость
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Параметры анимации для шарика хищник===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика (уменьшение по скейлу).
*'''Время жизни''' - время жизни эффекта.
*'''Клип''' - анимация съедания шарика.

===[[Файл:+.png]] Параметры анимации для шарика шестеренка===
*'''Скорость''' - скорость движения.
*'''Клип влево''' - клип движения влево.
*'''Клип вправо''' - клип движения вправо.

===[[Файл:+.png]] Параметры анимации для залоченного шарика===
*'''Эффект''' - эффект.
*'''Задержка удаления эффекта''' - задержка удаления эффекта.

===[[Файл:+.png]] Параметры анимации для шарика туман===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика огонь===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''Эффект цели''' - эффект цели.
*'''Эффект цели - смещение''' - эффект цели - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика молния===
*'''Время жизни''' - время жизни эффекта.
*'''Эффект центральный''' - центральный эффект молнии.
*'''Эффект промежуточный''' - промежуточный эффект молнии.
*'''Эффект краевой''' - краевой эффект молнии.
*'''Звук''' - звук молнии.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.
*'''PredatorD''' - Расстояние в диаметрах между летящим шариком и хищником, при котором они взаимодействуют (0 - дефолтное взаимодействие).
*'''vel_bang_bubbles''' - Скорость разлетающихся шариков после взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

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

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

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

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

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] бустер радужный шар: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] бустер радужный шар: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

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

===[[Файл:+.png]] сгорел целевой шарик: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] обвал шариков: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить. Количество обвалившихся шариков пишется в параметр '''bubbles_left'''
*'''состояние''' - Новое состояние объект.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Примечания=
*Если нужно изменить номер фрейма шариков перед запуском уровня, это лучше делать в машинке на том же экране, где находится сам объект. Объект Бабблшутер уже должен быть проинициализирован к этому времени, чтобы избежать падений. После изменения номера фрейма (параметр res%N%Frame) нужно передать Бабблшутеру состояние update_params.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble.rar

=Пример реализации: задание уровня=

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

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter

2017-12-14T13:01:51Z

Akovinenko:

Bubble Shooter

2017-12-14T13:00:49Z

Akovinenko: /* Курсор */

Bubble Shooter NEW

2017-12-14T12:55:14Z

Akovinenko:

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

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

'''Merge'''
*'''макс. уровень (max_level)''' - место в опциях, где лежит макс. уровень.
*'''сага тэг (saga_tag)''' - место в опциях, где лежит вся информация по саге.
*'''классика очки (classic_score)''' - место в опциях, где лежат очки по классике.
*'''классика тэг (classic_tag)''' - место в опциях, где лежит вся информация по классике.

=Графика=
*'''цветной шарик 1 (res1)''' - графический ресурс шарика 1.
*'''фрейм шарика 1 (res1Frame)''' - Номер фрейма ресурса шарика 1.
*'''цветной шарик 2 (res2)''' - графический ресурс шарика 2.
*'''фрейм шарика 2 (res2Frame)''' - Номер фрейма ресурса шарика 2.
*'''цветной шарик 3 (res3)''' - графический ресурс шарика 3
*'''фрейм шарика 3 (res3Frame)''' - Номер фрейма ресурса шарика 3.
*'''цветной шарик 4 (res4)''' - графический ресурс шарика 4.
*'''фрейм шарика 4 (res4Frame)''' - Номер фрейма ресурса шарика 4.
*'''цветной шарик 5 (res5)''' - графический ресурс шарика 5.
*'''фрейм шарика 5 (res5Frame)''' - Номер фрейма ресурса шарика 5.
*'''цветной шарик 6 (res6)''' - графический ресурс шарика 6.
*'''фрейм шарика 6 (res6Frame)''' - Номер фрейма ресурса шарика 6.
*'''цветной шарик 7 (res7)''' - графический ресурс шарика 7.
*'''фрейм шарика 7 (res7Frame)''' - Номер фрейма ресурса шарика 7.
*'''цветной шарик 8 (res8)''' - графический ресурс шарика 8.
*'''фрейм шарика 8 (res8Frame)''' - Номер фрейма ресурса шарика 8.
*'''цветной шарик Y (resY)''' - графический ресурс цветного шарика.
*'''гвоздь (resZ)''' - графический ресурс гвоздя.
*'''целевой шарик 1 (rest1)''' - графический ресурс целевого шарика 1.
*'''фрейм шарика 1 (rest1Frame)''' - Номер фрейма ресурса целевого шарика 1.
*'''целевой шарик 2 (rest2)''' - графический ресурс целевого шарика 2.
*'''фрейм шарика 2 (rest2Frame)''' - Номер фрейма ресурса целевого шарика 2.
*'''целевой шарик 3 (rest3)''' - графический ресурс целевого шарика 3
*'''фрейм шарика 3 (rest3Frame)''' - Номер фрейма ресурса целевого шарика 3.
*'''целевой шарик 4 (rest4)''' - графический ресурс целевого шарика 4.
*'''фрейм шарика 4 (rest4Frame)''' - Номер фрейма ресурса целевого шарика 4.
*'''целевой шарик 5 (rest5)''' - графический ресурс целевого шарика 5.
*'''фрейм шарика 5 (rest5Frame)''' - Номер фрейма ресурса целевого шарика 5.
*'''целевой шарик 6 (rest6)''' - графический ресурс целевого шарика 6.
*'''фрейм шарика 6 (rest6Frame)''' - Номер фрейма ресурса целевого шарика 6.
*'''целевой шарик 7 (rest7)''' - графический ресурс целевого шарика 7.
*'''фрейм шарика 7 (rest7Frame)''' - Номер фрейма ресурса целевого шарика 7.
*'''целевой шарик 8 (rest8)''' - графический ресурс целевого шарика 8.
*'''фрейм шарика 8 (rest8Frame)''' - Номер фрейма ресурса целевого шарика 8.
*'''целевой шарик Y (restY)''' - графический ресурс целевого цветного шарика.
*'''маска залочки (res_lock_mask)''' - графический ресурс маски залочки.
*'''падающий шарик (res_drop_mask)''' - графический ресурс падающего шарика.
*'''лунка (resf1)''' - графический ресурс лунки.
*'''фрейм лунка (resf1Frame)''' - Номер фрейма ресурса лунки.
*'''колючка (resf2)''' - графический ресурс колючки.
*'''фрейм колючка (resf2Frame)''' - Номер фрейма ресурса колючки.
*'''снежинка (resf3)''' - графический ресурс снежинки.
*'''фрейм снежинка (resf3Frame)''' - Номер фрейма ресурса снежинки.
*'''вредитель (resf4)''' - графический ресурс вредителя.
*'''фрейм вредитель (resf4Frame)''' - Номер фрейма ресурса вредителя.
*'''половинки (resf5)''' - графический ресурс половинок.
*'''фрейм половинки (resf5Frame)''' - Номер фрейма ресурса половинок.
*'''камень (resf6)''' - графический ресурс камня.
*'''фрейм камень (resf6Frame)''' - Номер фрейма ресурса камня.
*'''хищник (resf8)''' - графический ресурс маски залочки.
*'''фрейм хищник (resf8Frame)''' - графический ресурс маски залочки.
*'''призрак (resf9)''' - графический ресурс призрака.
*'''фрейм призрак (resf9Frame)''' - Номер фрейма ресурса призрака.
*'''шестеренка (resf10)''' - графический ресурс шетеренки.
*'''фрейм шестеренка (resf10Frame)''' - Номер фрейма ресурса шестеренки.
*'''туман (resf11)''' - графический ресурс тумана.
*'''фрейм туман (resf11Frame)''' - Номер фрейма ресурса тумана.
*'''портал (resf12)''' - графический ресурс портала.
*'''фрейм портал (resf12Frame)''' - Номер фрейма ресурса портала.
*'''призрак-цель (resf13)''' - графический ресурс призрак-цель.
*'''фрейм призрак-цель (resf13Frame)''' - Номер фрейма ресурса призрак-цель.
*'''огонь (resf14)''' - графический ресурс огня.
*'''фрейм огонь (resf14Frame)''' - Номер фрейма ресурса огонь.
*'''молния (resf15)''' - графический ресурс молнии.
*'''фрейм молния (resf15Frame)''' - Номер фрейма ресурса молния.
*'''радужный шар (resrainbow)''' - графический ресурс радужного шара.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''drop''' - Звук осыпания.
*'''intro''' - Звук в начале игры.
*'''add row''' - Звук добавления ряда.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Звук взрыва бомбы мина.
*'''Взрыв бомбы ядро''' - Звук взрыва бомбы ядро.
*'''Взрыв бомбы цвет''' - Звук взрыва бомбы цвет.
*'''Бомба мульти цвет''' - Звук взыва бомбы мульти цвет.
*'''Закат в лунку''' - Звук заката в лунку.
*'''Взрыв колючкой''' - Звук взрыва колючкой.
*'''Таяние снежинки''' - Звук таяния снежинки.

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.

=Машины отображающие пушку=
*'''Первый шарик''' - машина, отображающая первый шарик. При выстреле в эту машину пишется параметр '''curr_bomb_type''', который говорит о том, выстрелили мы обычным шариком или бустером (0 - обычный шарик).
*'''Второй шарик''' - машина, отображающая второй шарик.
*'''Третий шарик''' - машина, отображающая третий шарик.

'''Машины могут иметь состояния:'''
*'''shot''' - выстрел.
*'''shot_over''' - окончание выстрела.
*'''swap''' - смена шариков.
*'''swap_over''' - окончание смены шариков.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res (curres)''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Расстояние между шариками (distance)''' - Расстояние между шариками, от которого зависит их количество.
*'''Кол-во шариков в последней линии (last_line_count_bubs)''' - количество шариков, которе будет в последней линии курсора.
*'''Отражения (curlns)''' - максимальное кол-во отражений от стенок.
*'''Коэффициент (curkoef)''' - коэффициент ds/s, где s - базовое расстояние между шариками, ds - его наращивание.
*'''минимальный скейл (curminsc)''' - минимальный скейл графики шариков
*'''максимальный скейл (curmaxsc)''' - максимальный скейл графики шариков
*'''время скалирования (cursctm)''' - время скалирования шариков

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего шарика (x,y)''' - Позиция стреляющего шарика (x,y)
*'''Позиция следующего шарика (x,y)''' - Позиция следующего шарика (x,y).
*'''Позиция 3-го шарика (x,y)''' - Позиция 3-го шарика (x,y).
*'''третий шарик (n3bub)''' - если 0 - 3-го шарика не будет, 1 - есть третий шарик.
*'''Коэффициент вероятности цветов''' - коэффициент вероятности цветов.
*'''Расстояние от следующего шарика''' - расстояние от следующего шарика.
*'''Скорость наезда для режима Bubblez''' - скорость наезда для режима Bubblez.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Скейл шариков для снукера''' - скейл шариков для снукера.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления рядов''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Color mapping''' - Color mapping включён (0 - нет, 1 - да).
*'''Тип рандома''' - Тип рандома. Простой - берём случайный из всех цветов, Супер Рандом - супер алгоритм, Из набора - формируем набор из n шариков и перемешиваем.
*'''Количество цвета для набора''' - количество цвета для формирования набора в рандоме (касается типа рандома "Из набора").
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''Файл трекинга''' - Файл трекинга формата .xml.
*'''Таблица трекинга''' - Таблица трекинга.
*'''Объект новых шариков''' - Объект, которому сообщается о новых шариках.
*'''Мувер''' - Объект, двигающий баббл шутер.
*'''Задержка перед броском''' - задержка перед броском.
*'''Задержка перед обрывом шариков''' - задержка перед обрывом шариков.
*'''К-во секторов для броска''' - Количество секторов для броска.
*'''Слушатель движения мыши''' - объект, слушатель движения мыши.
*'''Слушатель броска''' - объект, слушатель броска. По сути вызывается только состояние st1.
*'''Слушатель движения поля''' - объект, слушатель движения поля. Должен иметь состояния move (поле двигается) и move_over (окончание движения поля).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''Феерверк после победы''' - Включить феерверк из шариков сразу после победы (0 - нет, 1 - да).

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

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

===[[Файл:+.png]] Визцализатор целей===
*'''Заглушки''' - заглушки.
*'''Индикаторы''' - индикаторы.
*'''Каунтеры''' - каунтеры.

===[[Файл:+.png]] Параметры эффекта для специальных шариков===
*'''Этими параметрами можно пользоваться вместо "параметры анимации для шарика"'''
*'''Тип специального шарика''' - тип специального шарика (лунка, колючка, снежинка, вредитель, шарик из двух половинок, камень, целевой шарик, хищник, призрак, шестеренка, туман, портал, целевой шарик призрак, огонь, молния, под огнем).
*'''Эффект''' - Машинка, которая будет получать события:
**'''beg''' - начало эффекта.
**'''hit''' - попадание (есть матч).
**'''miss''' - промах (нет матча).
**'''match_around''' - сматчились шарики рядом.
**'''shot''' - выстрел.
**'''destroy''' - уничтожение эффекта.
**'''end''' - окончание эффекта (вызывается после destroy).
*'''Смещение эффекта''' - смещение эффекта относительно шарика.
*'''Количество действий''' - количество действий (попаданий, выстрелов, промахов), после которых специальный шарик начнет некую обработку (например огонь перекинется на другой шарик).
*'''Действие''' - действие (нет, выстрел, попадание, промах).
*'''Задержка перед destroy''' - время перед уничтожением эффекта.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек. Возможные значения F - functionality в файле уровня:
**'''0''' - обычный шарик
**'''1''' - лунка (попавший в нее шарик "проваливается")
**'''2''' - колючка (попавший в нее шарик просто лопается и матч не просчитывается)
**'''3''' - снежинка (при попадании в нее или схлопывании шарика рядом тает и превращается в обычный шарик)
**'''4''' - вредитель (увеличит уровень залочки шарика на один; шарик выбирается по алгоритму закрашивания)
**'''5''' - шарик из двух половинок; при матче с одной половинкой шарик лопается
**'''6''' - камень (не матчится, не опадает, не двигается, от него отскакивают шарики)
**'''7''' - целевой шарик (когда все такие шарики убиваются или обваливаются, игра считается выиграна)
**'''8''' - хищник (съедает шарик; отличается от лунки наличием анимации и убиваемостью)
**'''9''' - призрак (то же, что и снежинка, но у снежинки цвет задан изначально, а призрак его обретает после матча)
**'''A''' - шестеренка (при попадании в нее начинает двигаться по горизонтали и убивать шарики на пути)
**'''B''' - туман (шар с туманом, при попадании туман пропадает на определенное количество действий)
**'''C''' - портал (имеет два входа-выхода, обозначенных цветом по контуру портала. При попадании шаром в один из входов-выходов, шар вылетает из другого, продолжая траекторию движения)
**'''D''' - целевой шарик призрак (сначала действует как призрак, потом как целевой шарик)
**'''E''' - огонь (при попадании шар воспломеняется. после определенного количество действий шар сгорает и "заражает" огнем соседний верхний шар)
**'''F''' - молния (при попадании лопает все шары по горизонтальной линии)
**'''16''' - замароженость
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Параметры анимации для шарика хищник===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика (уменьшение по скейлу).
*'''Время жизни''' - время жизни эффекта.
*'''Клип''' - анимация съедания шарика.

===[[Файл:+.png]] Параметры анимации для шарика шестеренка===
*'''Скорость''' - скорость движения.
*'''Клип влево''' - клип движения влево.
*'''Клип вправо''' - клип движения вправо.

===[[Файл:+.png]] Параметры анимации для залоченного шарика===
*'''Эффект''' - эффект.
*'''Задержка удаления эффекта''' - задержка удаления эффекта.

===[[Файл:+.png]] Параметры анимации для шарика туман===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика огонь===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''Эффект цели''' - эффект цели.
*'''Эффект цели - смещение''' - эффект цели - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика молния===
*'''Время жизни''' - время жизни эффекта.
*'''Эффект центральный''' - центральный эффект молнии.
*'''Эффект промежуточный''' - промежуточный эффект молнии.
*'''Эффект краевой''' - краевой эффект молнии.
*'''Звук''' - звук молнии.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.
*'''PredatorD''' - Расстояние в диаметрах между летящим шариком и хищником, при котором они взаимодействуют (0 - дефолтное взаимодействие).
*'''vel_bang_bubbles''' - Скорость разлетающихся шариков после взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

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

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

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

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

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] бустер радужный шар: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] бустер радужный шар: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

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

===[[Файл:+.png]] сгорел целевой шарик: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] обвал шариков: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить. Количество обвалившихся шариков пишется в параметр '''bubbles_left'''
*'''состояние''' - Новое состояние объект.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Примечания=
*Если нужно изменить номер фрейма шариков перед запуском уровня, это лучше делать в машинке на том же экране, где находится сам объект. Объект Бабблшутер уже должен быть проинициализирован к этому времени, чтобы избежать падений. После изменения номера фрейма (параметр res%N%Frame) нужно передать Бабблшутеру состояние update_params.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble.rar

=Пример реализации: задание уровня=

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

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter NEW

2017-12-14T12:50:11Z

Akovinenko:

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

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

'''Merge'''
*'''макс. уровень (max_level)''' - место в опциях, где лежит макс. уровень.
*'''сага тэг (saga_tag)''' - место в опциях, где лежит вся информация по саге.
*'''классика очки (classic_score)''' - место в опциях, где лежат очки по классике.
*'''классика тэг (classic_tag)''' - место в опциях, где лежит вся информация по классике.

=Графика=
*'''цветной шарик 1 (res1)''' - графический ресурс шарика 1.
*'''фрейм шарика 1 (res1Frame)''' - Номер фрейма ресурса шарика 1.
*'''цветной шарик 2 (res2)''' - графический ресурс шарика 2.
*'''фрейм шарика 2 (res2Frame)''' - Номер фрейма ресурса шарика 2.
*'''цветной шарик 3 (res3)''' - графический ресурс шарика 3
*'''фрейм шарика 3 (res3Frame)''' - Номер фрейма ресурса шарика 3.
*'''цветной шарик 4 (res4)''' - графический ресурс шарика 4.
*'''фрейм шарика 4 (res4Frame)''' - Номер фрейма ресурса шарика 4.
*'''цветной шарик 5 (res5)''' - графический ресурс шарика 5.
*'''фрейм шарика 5 (res5Frame)''' - Номер фрейма ресурса шарика 5.
*'''цветной шарик 6 (res6)''' - графический ресурс шарика 6.
*'''фрейм шарика 6 (res6Frame)''' - Номер фрейма ресурса шарика 6.
*'''цветной шарик 7 (res7)''' - графический ресурс шарика 7.
*'''фрейм шарика 7 (res7Frame)''' - Номер фрейма ресурса шарика 7.
*'''цветной шарик 8 (res8)''' - графический ресурс шарика 8.
*'''фрейм шарика 8 (res8Frame)''' - Номер фрейма ресурса шарика 8.
*'''цветной шарик Y (resY)''' - графический ресурс цветного шарика.
*'''гвоздь (resZ)''' - графический ресурс гвоздя.
*'''целевой шарик 1 (rest1)''' - графический ресурс целевого шарика 1.
*'''фрейм шарика 1 (rest1Frame)''' - Номер фрейма ресурса целевого шарика 1.
*'''целевой шарик 2 (rest2)''' - графический ресурс целевого шарика 2.
*'''фрейм шарика 2 (rest2Frame)''' - Номер фрейма ресурса целевого шарика 2.
*'''целевой шарик 3 (rest3)''' - графический ресурс целевого шарика 3
*'''фрейм шарика 3 (rest3Frame)''' - Номер фрейма ресурса целевого шарика 3.
*'''целевой шарик 4 (rest4)''' - графический ресурс целевого шарика 4.
*'''фрейм шарика 4 (rest4Frame)''' - Номер фрейма ресурса целевого шарика 4.
*'''целевой шарик 5 (rest5)''' - графический ресурс целевого шарика 5.
*'''фрейм шарика 5 (rest5Frame)''' - Номер фрейма ресурса целевого шарика 5.
*'''целевой шарик 6 (rest6)''' - графический ресурс целевого шарика 6.
*'''фрейм шарика 6 (rest6Frame)''' - Номер фрейма ресурса целевого шарика 6.
*'''целевой шарик 7 (rest7)''' - графический ресурс целевого шарика 7.
*'''фрейм шарика 7 (rest7Frame)''' - Номер фрейма ресурса целевого шарика 7.
*'''целевой шарик 8 (rest8)''' - графический ресурс целевого шарика 8.
*'''фрейм шарика 8 (rest8Frame)''' - Номер фрейма ресурса целевого шарика 8.
*'''целевой шарик Y (restY)''' - графический ресурс целевого цветного шарика.
*'''маска залочки (res_lock_mask)''' - графический ресурс маски залочки.
*'''падающий шарик (res_drop_mask)''' - графический ресурс падающего шарика.
*'''лунка (resf1)''' - графический ресурс лунки.
*'''фрейм лунка (resf1Frame)''' - Номер фрейма ресурса лунки.
*'''колючка (resf2)''' - графический ресурс колючки.
*'''фрейм колючка (resf2Frame)''' - Номер фрейма ресурса колючки.
*'''снежинка (resf3)''' - графический ресурс снежинки.
*'''фрейм снежинка (resf3Frame)''' - Номер фрейма ресурса снежинки.
*'''вредитель (resf4)''' - графический ресурс вредителя.
*'''фрейм вредитель (resf4Frame)''' - Номер фрейма ресурса вредителя.
*'''половинки (resf5)''' - графический ресурс половинок.
*'''фрейм половинки (resf5Frame)''' - Номер фрейма ресурса половинок.
*'''камень (resf6)''' - графический ресурс камня.
*'''фрейм камень (resf6Frame)''' - Номер фрейма ресурса камня.
*'''хищник (resf8)''' - графический ресурс маски залочки.
*'''фрейм хищник (resf8Frame)''' - графический ресурс маски залочки.
*'''призрак (resf9)''' - графический ресурс призрака.
*'''фрейм призрак (resf9Frame)''' - Номер фрейма ресурса призрака.
*'''шестеренка (resf10)''' - графический ресурс шетеренки.
*'''фрейм шестеренка (resf10Frame)''' - Номер фрейма ресурса шестеренки.
*'''туман (resf11)''' - графический ресурс тумана.
*'''фрейм туман (resf11Frame)''' - Номер фрейма ресурса тумана.
*'''портал (resf12)''' - графический ресурс портала.
*'''фрейм портал (resf12Frame)''' - Номер фрейма ресурса портала.
*'''призрак-цель (resf13)''' - графический ресурс призрак-цель.
*'''фрейм призрак-цель (resf13Frame)''' - Номер фрейма ресурса призрак-цель.
*'''огонь (resf14)''' - графический ресурс огня.
*'''фрейм огонь (resf14Frame)''' - Номер фрейма ресурса огонь.
*'''молния (resf15)''' - графический ресурс молнии.
*'''фрейм молния (resf15Frame)''' - Номер фрейма ресурса молния.
*'''радужный шар (resrainbow)''' - графический ресурс радужного шара.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''drop''' - Звук осыпания.
*'''intro''' - Звук в начале игры.
*'''add row''' - Звук добавления ряда.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Звук взрыва бомбы мина.
*'''Взрыв бомбы ядро''' - Звук взрыва бомбы ядро.
*'''Взрыв бомбы цвет''' - Звук взрыва бомбы цвет.
*'''Бомба мульти цвет''' - Звук взыва бомбы мульти цвет.
*'''Закат в лунку''' - Звук заката в лунку.
*'''Взрыв колючкой''' - Звук взрыва колючкой.
*'''Таяние снежинки''' - Звук таяния снежинки.

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.

=Машины отображающие пушку=
*'''Первый шарик''' - машина, отображающая первый шарик. При выстреле в эту машину пишется параметр '''curr_bomb_type''', который говорит о том, выстрелили мы обычным шариком или бустером (0 - обычный шарик).
*'''Второй шарик''' - машина, отображающая второй шарик.
*'''Третий шарик''' - машина, отображающая третий шарик.

'''Машины могут иметь состояния:'''
*'''shot''' - выстрел.
*'''shot_over''' - окончание выстрела.
*'''swap''' - смена шариков.
*'''swap_over''' - окончание смены шариков.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res (curres)''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Расстояние между шариками (distance)''' - Расстояние между шариками, от которого зависит их количество.
*'''Кол-во шариков в последней линии (last_line_count_bubs)''' - количество шариков, которе будет в последней линии курсора.
*'''Отражения (curlns)''' - максимальное кол-во отражений от стенок.
*'''Коэффициент (curkoef)''' - коэффициент ds/s, где s - базовое расстояние между шариками, ds - его наращивание.
*'''минимальный скейл (curminsc)''' - минимальный скейл графики шариков
*'''максимальный скейл (curmaxsc)''' - максимальный скейл графики шариков
*'''время скалирования (cursctm)''' - время скалирования шариков

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего шарика (x,y)''' - Позиция стреляющего шарика (x,y)
*'''Позиция следующего шарика (x,y)''' - Позиция следующего шарика (x,y).
*'''Позиция 3-го шарика (x,y)''' - Позиция 3-го шарика (x,y).
*'''третий шарик (n3bub)''' - если 0 - 3-го шарика не будет, 1 - есть третий шарик.
*'''Коэффициент вероятности цветов''' - коэффициент вероятности цветов.
*'''Расстояние от следующего шарика''' - расстояние от следующего шарика.
*'''Скорость наезда для режима Bubblez''' - скорость наезда для режима Bubblez.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Скейл шариков для снукера''' - скейл шариков для снукера.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления рядов''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Color mapping''' - Color mapping включён (0 - нет, 1 - да).
*'''Тип рандома''' - Тип рандома. Простой - берём случайный из всех цветов, Супер Рандом - супер алгоритм, Из набора - формируем набор из n шариков и перемешиваем.
*'''Количество цвета для набора''' - количество цвета для формирования набора в рандоме (касается типа рандома "Из набора").
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''Файл трекинга''' - Файл трекинга формата .xml.
*'''Таблица трекинга''' - Таблица трекинга.
*'''Объект новых шариков''' - Объект, которому сообщается о новых шариках.
*'''Мувер''' - Объект, двигающий баббл шутер.
*'''Задержка перед броском''' - задержка перед броском.
*'''Задержка перед обрывом шариков''' - задержка перед обрывом шариков.
*'''К-во секторов для броска''' - Количество секторов для броска.
*'''Слушатель движения мыши''' - объект, слушатель движения мыши.
*'''Слушатель броска''' - объект, слушатель броска. По сути вызывается только состояние st1.
*'''Слушатель движения поля''' - объект, слушатель движения поля. Должен иметь состояния move (поле двигается) и move_over (окончание движения поля).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''Феерверк после победы''' - Включить феерверк из шариков сразу после победы (0 - нет, 1 - да).

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

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

===[[Файл:+.png]] Визцализатор целей===
*'''Заглушки''' - заглушки.
*'''Индикаторы''' - индикаторы.
*'''Каунтеры''' - каунтеры.

===[[Файл:+.png]] Параметры эффекта для специальных шариков===
*'''Этими параметрами можно пользоваться вместо "параметры анимации для шарика"'''
*'''Тип специального шарика''' - тип специального шарика (лунка, колючка, снежинка, вредитель, шарик из двух половинок, камень, целевой шарик, хищник, призрак, шестеренка, туман, портал, целевой шарик призрак, огонь, молния, под огнем).
*'''Эффект''' - Машинка, которая будет получать события:
**'''beg''' - начало эффекта.
**'''hit''' - попадание (есть матч).
**'''miss''' - промах (нет матча).
**'''match_around''' - сматчились шарики рядом.
**'''shot''' - выстрел.
**'''destroy''' - уничтожение эффекта.
**'''end''' - окончание эффекта (вызывается после destroy).
*'''Смещение эффекта''' - смещение эффекта относительно шарика.
*'''Количество действий''' - количество действий (попаданий, выстрелов, промахов), после которых специальный шарик начнет некую обработку (например огонь перекинется на другой шарик).
*'''Действие''' - действие (нет, выстрел, попадание, промах).
*'''Задержка перед destroy''' - время перед уничтожением эффекта.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек. Возможные значения F - functionality в файле уровня:
**'''0''' - обычный шарик
**'''1''' - лунка (попавший в нее шарик "проваливается")
**'''2''' - колючка (попавший в нее шарик просто лопается и матч не просчитывается)
**'''3''' - снежинка (при попадании в нее или схлопывании шарика рядом тает и превращается в обычный шарик)
**'''4''' - вредитель (увеличит уровень залочки шарика на один; шарик выбирается по алгоритму закрашивания)
**'''5''' - шарик из двух половинок; при матче с одной половинкой шарик лопается
**'''6''' - камень (не матчится, не опадает, не двигается, от него отскакивают шарики)
**'''7''' - целевой шарик (когда все такие шарики убиваются или обваливаются, игра считается выиграна)
**'''8''' - хищник (съедает шарик; отличается от лунки наличием анимации и убиваемостью)
**'''9''' - призрак (то же, что и снежинка, но у снежинки цвет задан изначально, а призрак его обретает после матча)
**'''A''' - шестеренка (при попадании в нее начинает двигаться по горизонтали и убивать шарики на пути)
**'''B''' - туман (шар с туманом, при попадании туман пропадает на определенное количество действий)
**'''C''' - портал (имеет два входа-выхода, обозначенных цветом по контуру портала. При попадании шаром в один из входов-выходов, шар вылетает из другого, продолжая траекторию движения)
**'''D''' - целевой шарик призрак (сначала действует как призрак, потом как целевой шарик)
**'''E''' - огонь (при попадании шар воспломеняется. после определенного количество действий шар сгорает и "заражает" огнем соседний верхний шар)
**'''F''' - молния (при попадании лопает все шары по горизонтальной линии)
**'''16''' - замароженость
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Параметры анимации для шарика хищник===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика (уменьшение по скейлу).
*'''Время жизни''' - время жизни эффекта.
*'''Клип''' - анимация съедания шарика.

===[[Файл:+.png]] Параметры анимации для шарика шестеренка===
*'''Скорость''' - скорость движения.
*'''Клип влево''' - клип движения влево.
*'''Клип вправо''' - клип движения вправо.

===[[Файл:+.png]] Параметры анимации для залоченного шарика===
*'''Эффект''' - эффект.
*'''Задержка удаления эффекта''' - задержка удаления эффекта.

===[[Файл:+.png]] Параметры анимации для шарика туман===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика огонь===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''Эффект цели''' - эффект цели.
*'''Эффект цели - смещение''' - эффект цели - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика молния===
*'''Время жизни''' - время жизни эффекта.
*'''Эффект центральный''' - центральный эффект молнии.
*'''Эффект промежуточный''' - промежуточный эффект молнии.
*'''Эффект краевой''' - краевой эффект молнии.
*'''Звук''' - звук молнии.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.
*'''PredatorD''' - Расстояние в диаметрах между летящим шариком и хищником, при котором они взаимодействуют (0 - дефолтное взаимодействие).
*'''vel_bang_bubbles''' - Скорость разлетающихся шариков после взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

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

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

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

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

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] бустер радужный шар: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] бустер радужный шар: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

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

===[[Файл:+.png]] сгорел целевой шарик: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] обвал шариков: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить. Количество обвалившихся шариков пишется в параметр '''bubbles_left'''
*'''состояние''' - Новое состояние объект.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble.rar

=Пример реализации: задание уровня=

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

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter NEW

2017-12-14T12:46:37Z

Akovinenko: /* Файл:+.png обвал шариков: изменить состояние объекта */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

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

'''Merge'''
*'''макс. уровень (max_level)''' - место в опциях, где лежит макс. уровень.
*'''сага тэг (saga_tag)''' - место в опциях, где лежит вся информация по саге.
*'''классика очки (classic_score)''' - место в опциях, где лежат очки по классике.
*'''классика тэг (classic_tag)''' - место в опциях, где лежит вся информация по классике.

=Графика=
*'''цветной шарик 1 (res1)''' - графический ресурс шарика 1.
*'''фрейм шарика 1 (res1Frame)''' - Номер фрейма ресурса шарика 1.
*'''цветной шарик 2 (res2)''' - графический ресурс шарика 2.
*'''фрейм шарика 2 (res2Frame)''' - Номер фрейма ресурса шарика 2.
*'''цветной шарик 3 (res3)''' - графический ресурс шарика 3
*'''фрейм шарика 3 (res3Frame)''' - Номер фрейма ресурса шарика 3.
*'''цветной шарик 4 (res4)''' - графический ресурс шарика 4.
*'''фрейм шарика 4 (res4Frame)''' - Номер фрейма ресурса шарика 4.
*'''цветной шарик 5 (res5)''' - графический ресурс шарика 5.
*'''фрейм шарика 5 (res5Frame)''' - Номер фрейма ресурса шарика 5.
*'''цветной шарик 6 (res6)''' - графический ресурс шарика 6.
*'''фрейм шарика 6 (res6Frame)''' - Номер фрейма ресурса шарика 6.
*'''цветной шарик 7 (res7)''' - графический ресурс шарика 7.
*'''фрейм шарика 7 (res7Frame)''' - Номер фрейма ресурса шарика 7.
*'''цветной шарик 8 (res8)''' - графический ресурс шарика 8.
*'''фрейм шарика 8 (res8Frame)''' - Номер фрейма ресурса шарика 8.
*'''цветной шарик Y (resY)''' - графический ресурс цветного шарика.
*'''гвоздь (resZ)''' - графический ресурс гвоздя.
*'''целевой шарик 1 (rest1)''' - графический ресурс целевого шарика 1.
*'''фрейм шарика 1 (rest1Frame)''' - Номер фрейма ресурса целевого шарика 1.
*'''целевой шарик 2 (rest2)''' - графический ресурс целевого шарика 2.
*'''фрейм шарика 2 (rest2Frame)''' - Номер фрейма ресурса целевого шарика 2.
*'''целевой шарик 3 (rest3)''' - графический ресурс целевого шарика 3
*'''фрейм шарика 3 (rest3Frame)''' - Номер фрейма ресурса целевого шарика 3.
*'''целевой шарик 4 (rest4)''' - графический ресурс целевого шарика 4.
*'''фрейм шарика 4 (rest4Frame)''' - Номер фрейма ресурса целевого шарика 4.
*'''целевой шарик 5 (rest5)''' - графический ресурс целевого шарика 5.
*'''фрейм шарика 5 (rest5Frame)''' - Номер фрейма ресурса целевого шарика 5.
*'''целевой шарик 6 (rest6)''' - графический ресурс целевого шарика 6.
*'''фрейм шарика 6 (rest6Frame)''' - Номер фрейма ресурса целевого шарика 6.
*'''целевой шарик 7 (rest7)''' - графический ресурс целевого шарика 7.
*'''фрейм шарика 7 (rest7Frame)''' - Номер фрейма ресурса целевого шарика 7.
*'''целевой шарик 8 (rest8)''' - графический ресурс целевого шарика 8.
*'''фрейм шарика 8 (rest8Frame)''' - Номер фрейма ресурса целевого шарика 8.
*'''целевой шарик Y (restY)''' - графический ресурс целевого цветного шарика.
*'''маска залочки (res_lock_mask)''' - графический ресурс маски залочки.
*'''падающий шарик (res_drop_mask)''' - графический ресурс падающего шарика.
*'''лунка (resf1)''' - графический ресурс лунки.
*'''фрейм лунка (resf1Frame)''' - Номер фрейма ресурса лунки.
*'''колючка (resf2)''' - графический ресурс колючки.
*'''фрейм колючка (resf2Frame)''' - Номер фрейма ресурса колючки.
*'''снежинка (resf3)''' - графический ресурс снежинки.
*'''фрейм снежинка (resf3Frame)''' - Номер фрейма ресурса снежинки.
*'''вредитель (resf4)''' - графический ресурс вредителя.
*'''фрейм вредитель (resf4Frame)''' - Номер фрейма ресурса вредителя.
*'''половинки (resf5)''' - графический ресурс половинок.
*'''фрейм половинки (resf5Frame)''' - Номер фрейма ресурса половинок.
*'''камень (resf6)''' - графический ресурс камня.
*'''фрейм камень (resf6Frame)''' - Номер фрейма ресурса камня.
*'''хищник (resf8)''' - графический ресурс маски залочки.
*'''фрейм хищник (resf8Frame)''' - графический ресурс маски залочки.
*'''призрак (resf9)''' - графический ресурс призрака.
*'''фрейм призрак (resf9Frame)''' - Номер фрейма ресурса призрака.
*'''шестеренка (resf10)''' - графический ресурс шетеренки.
*'''фрейм шестеренка (resf10Frame)''' - Номер фрейма ресурса шестеренки.
*'''туман (resf11)''' - графический ресурс тумана.
*'''фрейм туман (resf11Frame)''' - Номер фрейма ресурса тумана.
*'''портал (resf12)''' - графический ресурс портала.
*'''фрейм портал (resf12Frame)''' - Номер фрейма ресурса портала.
*'''призрак-цель (resf13)''' - графический ресурс призрак-цель.
*'''фрейм призрак-цель (resf13Frame)''' - Номер фрейма ресурса призрак-цель.
*'''огонь (resf14)''' - графический ресурс огня.
*'''фрейм огонь (resf14Frame)''' - Номер фрейма ресурса огонь.
*'''молния (resf15)''' - графический ресурс молнии.
*'''фрейм молния (resf15Frame)''' - Номер фрейма ресурса молния.
*'''радужный шар (resrainbow)''' - графический ресурс радужного шара.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''drop''' - Звук осыпания.
*'''intro''' - Звук в начале игры.
*'''add row''' - Звук добавления ряда.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Звук взрыва бомбы мина.
*'''Взрыв бомбы ядро''' - Звук взрыва бомбы ядро.
*'''Взрыв бомбы цвет''' - Звук взрыва бомбы цвет.
*'''Бомба мульти цвет''' - Звук взыва бомбы мульти цвет.
*'''Закат в лунку''' - Звук заката в лунку.
*'''Взрыв колючкой''' - Звук взрыва колючкой.
*'''Таяние снежинки''' - Звук таяния снежинки.

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.

=Машины отображающие пушку=
*'''Первый шарик''' - машина, отображающая первый шарик. При выстреле в эту машину пишется параметр '''curr_bomb_type''', который говорит о том, выстрелили мы обычным шариком или бустером (0 - обычный шарик).
*'''Второй шарик''' - машина, отображающая второй шарик.
*'''Третий шарик''' - машина, отображающая третий шарик.

'''Машины могут иметь состояния:'''
*'''shot''' - выстрел.
*'''shot_over''' - окончание выстрела.
*'''swap''' - смена шариков.
*'''swap_over''' - окончание смены шариков.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res (curres)''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Расстояние между шариками (distance)''' - Расстояние между шариками, от которого зависит их количество.
*'''Кол-во шариков в последней линии (last_line_count_bubs)''' - количество шариков, которе будет в последней линии курсора.
*'''Отражения (curlns)''' - максимальное кол-во отражений от стенок.
*'''Коэффициент (curkoef)''' - коэффициент ds/s, где s - базовое расстояние между шариками, ds - его наращивание.
*'''минимальный скейл (curminsc)''' - минимальный скейл графики шариков
*'''максимальный скейл (curmaxsc)''' - максимальный скейл графики шариков
*'''время скалирования (cursctm)''' - время скалирования шариков

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего шарика (x,y)''' - Позиция стреляющего шарика (x,y)
*'''Позиция следующего шарика (x,y)''' - Позиция следующего шарика (x,y).
*'''Позиция 3-го шарика (x,y)''' - Позиция 3-го шарика (x,y).
*'''третий шарик (n3bub)''' - если 0 - 3-го шарика не будет, 1 - есть третий шарик.
*'''Коэффициент вероятности цветов''' - коэффициент вероятности цветов.
*'''Расстояние от следующего шарика''' - расстояние от следующего шарика.
*'''Скорость наезда для режима Bubblez''' - скорость наезда для режима Bubblez.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Скейл шариков для снукера''' - скейл шариков для снукера.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления рядов''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Color mapping''' - Color mapping включён (0 - нет, 1 - да).
*'''Тип рандома''' - Тип рандома. Простой - берём случайный из всех цветов, Супер Рандом - супер алгоритм, Из набора - формируем набор из n шариков и перемешиваем.
*'''Количество цвета для набора''' - количество цвета для формирования набора в рандоме (касается типа рандома "Из набора").
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''Файл трекинга''' - Файл трекинга формата .xml.
*'''Таблица трекинга''' - Таблица трекинга.
*'''Объект новых шариков''' - Объект, которому сообщается о новых шариках.
*'''Мувер''' - Объект, двигающий баббл шутер.
*'''Задержка перед броском''' - задержка перед броском.
*'''Задержка перед обрывом шариков''' - задержка перед обрывом шариков.
*'''К-во секторов для броска''' - Количество секторов для броска.
*'''Слушатель движения мыши''' - объект, слушатель движения мыши.
*'''Слушатель броска''' - объект, слушатель броска. По сути вызывается только состояние st1.
*'''Слушатель движения поля''' - объект, слушатель движения поля. Должен иметь состояния move (поле двигается) и move_over (окончание движения поля).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''Феерверк после победы''' - Включить феерверк из шариков сразу после победы (0 - нет, 1 - да).

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

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

===[[Файл:+.png]] Визцализатор целей===
*'''Заглушки''' - заглушки.
*'''Индикаторы''' - индикаторы.
*'''Каунтеры''' - каунтеры.

===[[Файл:+.png]] Параметры эффекта для специальных шариков===
*'''Этими параметрами можно пользоваться вместо "параметры анимации для шарика"'''
*'''Тип специального шарика''' - тип специального шарика (лунка, колючка, снежинка, вредитель, шарик из двух половинок, камень, целевой шарик, хищник, призрак, шестеренка, туман, портал, целевой шарик призрак, огонь, молния, под огнем).
*'''Эффект''' - Машинка, которая будет получать события:
**'''beg''' - начало эффекта.
**'''hit''' - попадание (есть матч).
**'''miss''' - промах (нет матча).
**'''match_around''' - сматчились шарики рядом.
**'''shot''' - выстрел.
**'''destroy''' - уничтожение эффекта.
**'''end''' - окончание эффекта (вызывается после destroy).
*'''Смещение эффекта''' - смещение эффекта относительно шарика.
*'''Количество действий''' - количество действий (попаданий, выстрелов, промахов), после которых специальный шарик начнет некую обработку (например огонь перекинется на другой шарик).
*'''Действие''' - действие (нет, выстрел, попадание, промах).
*'''Задержка перед destroy''' - время перед уничтожением эффекта.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек. Возможные значения F - functionality в файле уровня:
**'''0''' - обычный шарик
**'''1''' - лунка (попавший в нее шарик "проваливается")
**'''2''' - колючка (попавший в нее шарик просто лопается и матч не просчитывается)
**'''3''' - снежинка (при попадании в нее или схлопывании шарика рядом тает и превращается в обычный шарик)
**'''4''' - вредитель (увеличит уровень залочки шарика на один; шарик выбирается по алгоритму закрашивания)
**'''5''' - шарик из двух половинок; при матче с одной половинкой шарик лопается
**'''6''' - камень (не матчится, не опадает, не двигается, от него отскакивают шарики)
**'''7''' - целевой шарик (когда все такие шарики убиваются или обваливаются, игра считается выиграна)
**'''8''' - хищник (съедает шарик; отличается от лунки наличием анимации и убиваемостью)
**'''9''' - призрак (то же, что и снежинка, но у снежинки цвет задан изначально, а призрак его обретает после матча)
**'''A''' - шестеренка (при попадании в нее начинает двигаться по горизонтали и убивать шарики на пути)
**'''B''' - туман (шар с туманом, при попадании туман пропадает на определенное количество действий)
**'''C''' - портал (имеет два входа-выхода, обозначенных цветом по контуру портала. При попадании шаром в один из входов-выходов, шар вылетает из другого, продолжая траекторию движения)
**'''D''' - целевой шарик призрак (сначала действует как призрак, потом как целевой шарик)
**'''E''' - огонь (при попадании шар воспломеняется. после определенного количество действий шар сгорает и "заражает" огнем соседний верхний шар)
**'''F''' - молния (при попадании лопает все шары по горизонтальной линии)
**'''16''' - замароженость
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Параметры анимации для шарика хищник===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика (уменьшение по скейлу).
*'''Время жизни''' - время жизни эффекта.
*'''Клип''' - анимация съедания шарика.

===[[Файл:+.png]] Параметры анимации для шарика шестеренка===
*'''Скорость''' - скорость движения.
*'''Клип влево''' - клип движения влево.
*'''Клип вправо''' - клип движения вправо.

===[[Файл:+.png]] Параметры анимации для залоченного шарика===
*'''Эффект''' - эффект.
*'''Задержка удаления эффекта''' - задержка удаления эффекта.

===[[Файл:+.png]] Параметры анимации для шарика туман===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика огонь===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''Эффект цели''' - эффект цели.
*'''Эффект цели - смещение''' - эффект цели - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика молния===
*'''Время жизни''' - время жизни эффекта.
*'''Эффект центральный''' - центральный эффект молнии.
*'''Эффект промежуточный''' - промежуточный эффект молнии.
*'''Эффект краевой''' - краевой эффект молнии.
*'''Звук''' - звук молнии.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.
*'''PredatorD''' - Расстояние в диаметрах между летящим шариком и хищником, при котором они взаимодействуют (0 - дефолтное взаимодействие).
*'''vel_bang_bubbles''' - Скорость разлетающихся шариков после взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

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

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

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

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

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] бустер радужный шар: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] бустер радужный шар: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

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

===[[Файл:+.png]] сгорел целевой шарик: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] обвал шариков: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить. Количество обвалившихся шариков пишется в параметр '''bubbles_left'''
*'''состояние''' - Новое состояние объект.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble.rar

=Пример реализации: задание уровня=

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

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter NEW

2017-12-14T12:34:47Z

Akovinenko: /* Машины отображающие пушку */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

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

'''Merge'''
*'''макс. уровень (max_level)''' - место в опциях, где лежит макс. уровень.
*'''сага тэг (saga_tag)''' - место в опциях, где лежит вся информация по саге.
*'''классика очки (classic_score)''' - место в опциях, где лежат очки по классике.
*'''классика тэг (classic_tag)''' - место в опциях, где лежит вся информация по классике.

=Графика=
*'''цветной шарик 1 (res1)''' - графический ресурс шарика 1.
*'''фрейм шарика 1 (res1Frame)''' - Номер фрейма ресурса шарика 1.
*'''цветной шарик 2 (res2)''' - графический ресурс шарика 2.
*'''фрейм шарика 2 (res2Frame)''' - Номер фрейма ресурса шарика 2.
*'''цветной шарик 3 (res3)''' - графический ресурс шарика 3
*'''фрейм шарика 3 (res3Frame)''' - Номер фрейма ресурса шарика 3.
*'''цветной шарик 4 (res4)''' - графический ресурс шарика 4.
*'''фрейм шарика 4 (res4Frame)''' - Номер фрейма ресурса шарика 4.
*'''цветной шарик 5 (res5)''' - графический ресурс шарика 5.
*'''фрейм шарика 5 (res5Frame)''' - Номер фрейма ресурса шарика 5.
*'''цветной шарик 6 (res6)''' - графический ресурс шарика 6.
*'''фрейм шарика 6 (res6Frame)''' - Номер фрейма ресурса шарика 6.
*'''цветной шарик 7 (res7)''' - графический ресурс шарика 7.
*'''фрейм шарика 7 (res7Frame)''' - Номер фрейма ресурса шарика 7.
*'''цветной шарик 8 (res8)''' - графический ресурс шарика 8.
*'''фрейм шарика 8 (res8Frame)''' - Номер фрейма ресурса шарика 8.
*'''цветной шарик Y (resY)''' - графический ресурс цветного шарика.
*'''гвоздь (resZ)''' - графический ресурс гвоздя.
*'''целевой шарик 1 (rest1)''' - графический ресурс целевого шарика 1.
*'''фрейм шарика 1 (rest1Frame)''' - Номер фрейма ресурса целевого шарика 1.
*'''целевой шарик 2 (rest2)''' - графический ресурс целевого шарика 2.
*'''фрейм шарика 2 (rest2Frame)''' - Номер фрейма ресурса целевого шарика 2.
*'''целевой шарик 3 (rest3)''' - графический ресурс целевого шарика 3
*'''фрейм шарика 3 (rest3Frame)''' - Номер фрейма ресурса целевого шарика 3.
*'''целевой шарик 4 (rest4)''' - графический ресурс целевого шарика 4.
*'''фрейм шарика 4 (rest4Frame)''' - Номер фрейма ресурса целевого шарика 4.
*'''целевой шарик 5 (rest5)''' - графический ресурс целевого шарика 5.
*'''фрейм шарика 5 (rest5Frame)''' - Номер фрейма ресурса целевого шарика 5.
*'''целевой шарик 6 (rest6)''' - графический ресурс целевого шарика 6.
*'''фрейм шарика 6 (rest6Frame)''' - Номер фрейма ресурса целевого шарика 6.
*'''целевой шарик 7 (rest7)''' - графический ресурс целевого шарика 7.
*'''фрейм шарика 7 (rest7Frame)''' - Номер фрейма ресурса целевого шарика 7.
*'''целевой шарик 8 (rest8)''' - графический ресурс целевого шарика 8.
*'''фрейм шарика 8 (rest8Frame)''' - Номер фрейма ресурса целевого шарика 8.
*'''целевой шарик Y (restY)''' - графический ресурс целевого цветного шарика.
*'''маска залочки (res_lock_mask)''' - графический ресурс маски залочки.
*'''падающий шарик (res_drop_mask)''' - графический ресурс падающего шарика.
*'''лунка (resf1)''' - графический ресурс лунки.
*'''фрейм лунка (resf1Frame)''' - Номер фрейма ресурса лунки.
*'''колючка (resf2)''' - графический ресурс колючки.
*'''фрейм колючка (resf2Frame)''' - Номер фрейма ресурса колючки.
*'''снежинка (resf3)''' - графический ресурс снежинки.
*'''фрейм снежинка (resf3Frame)''' - Номер фрейма ресурса снежинки.
*'''вредитель (resf4)''' - графический ресурс вредителя.
*'''фрейм вредитель (resf4Frame)''' - Номер фрейма ресурса вредителя.
*'''половинки (resf5)''' - графический ресурс половинок.
*'''фрейм половинки (resf5Frame)''' - Номер фрейма ресурса половинок.
*'''камень (resf6)''' - графический ресурс камня.
*'''фрейм камень (resf6Frame)''' - Номер фрейма ресурса камня.
*'''хищник (resf8)''' - графический ресурс маски залочки.
*'''фрейм хищник (resf8Frame)''' - графический ресурс маски залочки.
*'''призрак (resf9)''' - графический ресурс призрака.
*'''фрейм призрак (resf9Frame)''' - Номер фрейма ресурса призрака.
*'''шестеренка (resf10)''' - графический ресурс шетеренки.
*'''фрейм шестеренка (resf10Frame)''' - Номер фрейма ресурса шестеренки.
*'''туман (resf11)''' - графический ресурс тумана.
*'''фрейм туман (resf11Frame)''' - Номер фрейма ресурса тумана.
*'''портал (resf12)''' - графический ресурс портала.
*'''фрейм портал (resf12Frame)''' - Номер фрейма ресурса портала.
*'''призрак-цель (resf13)''' - графический ресурс призрак-цель.
*'''фрейм призрак-цель (resf13Frame)''' - Номер фрейма ресурса призрак-цель.
*'''огонь (resf14)''' - графический ресурс огня.
*'''фрейм огонь (resf14Frame)''' - Номер фрейма ресурса огонь.
*'''молния (resf15)''' - графический ресурс молнии.
*'''фрейм молния (resf15Frame)''' - Номер фрейма ресурса молния.
*'''радужный шар (resrainbow)''' - графический ресурс радужного шара.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''drop''' - Звук осыпания.
*'''intro''' - Звук в начале игры.
*'''add row''' - Звук добавления ряда.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Звук взрыва бомбы мина.
*'''Взрыв бомбы ядро''' - Звук взрыва бомбы ядро.
*'''Взрыв бомбы цвет''' - Звук взрыва бомбы цвет.
*'''Бомба мульти цвет''' - Звук взыва бомбы мульти цвет.
*'''Закат в лунку''' - Звук заката в лунку.
*'''Взрыв колючкой''' - Звук взрыва колючкой.
*'''Таяние снежинки''' - Звук таяния снежинки.

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.

=Машины отображающие пушку=
*'''Первый шарик''' - машина, отображающая первый шарик. При выстреле в эту машину пишется параметр '''curr_bomb_type''', который говорит о том, выстрелили мы обычным шариком или бустером (0 - обычный шарик).
*'''Второй шарик''' - машина, отображающая второй шарик.
*'''Третий шарик''' - машина, отображающая третий шарик.

'''Машины могут иметь состояния:'''
*'''shot''' - выстрел.
*'''shot_over''' - окончание выстрела.
*'''swap''' - смена шариков.
*'''swap_over''' - окончание смены шариков.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res (curres)''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Расстояние между шариками (distance)''' - Расстояние между шариками, от которого зависит их количество.
*'''Кол-во шариков в последней линии (last_line_count_bubs)''' - количество шариков, которе будет в последней линии курсора.
*'''Отражения (curlns)''' - максимальное кол-во отражений от стенок.
*'''Коэффициент (curkoef)''' - коэффициент ds/s, где s - базовое расстояние между шариками, ds - его наращивание.
*'''минимальный скейл (curminsc)''' - минимальный скейл графики шариков
*'''максимальный скейл (curmaxsc)''' - максимальный скейл графики шариков
*'''время скалирования (cursctm)''' - время скалирования шариков

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего шарика (x,y)''' - Позиция стреляющего шарика (x,y)
*'''Позиция следующего шарика (x,y)''' - Позиция следующего шарика (x,y).
*'''Позиция 3-го шарика (x,y)''' - Позиция 3-го шарика (x,y).
*'''третий шарик (n3bub)''' - если 0 - 3-го шарика не будет, 1 - есть третий шарик.
*'''Коэффициент вероятности цветов''' - коэффициент вероятности цветов.
*'''Расстояние от следующего шарика''' - расстояние от следующего шарика.
*'''Скорость наезда для режима Bubblez''' - скорость наезда для режима Bubblez.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Скейл шариков для снукера''' - скейл шариков для снукера.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления рядов''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Color mapping''' - Color mapping включён (0 - нет, 1 - да).
*'''Тип рандома''' - Тип рандома. Простой - берём случайный из всех цветов, Супер Рандом - супер алгоритм, Из набора - формируем набор из n шариков и перемешиваем.
*'''Количество цвета для набора''' - количество цвета для формирования набора в рандоме (касается типа рандома "Из набора").
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''Файл трекинга''' - Файл трекинга формата .xml.
*'''Таблица трекинга''' - Таблица трекинга.
*'''Объект новых шариков''' - Объект, которому сообщается о новых шариках.
*'''Мувер''' - Объект, двигающий баббл шутер.
*'''Задержка перед броском''' - задержка перед броском.
*'''Задержка перед обрывом шариков''' - задержка перед обрывом шариков.
*'''К-во секторов для броска''' - Количество секторов для броска.
*'''Слушатель движения мыши''' - объект, слушатель движения мыши.
*'''Слушатель броска''' - объект, слушатель броска. По сути вызывается только состояние st1.
*'''Слушатель движения поля''' - объект, слушатель движения поля. Должен иметь состояния move (поле двигается) и move_over (окончание движения поля).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''Феерверк после победы''' - Включить феерверк из шариков сразу после победы (0 - нет, 1 - да).

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

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

===[[Файл:+.png]] Визцализатор целей===
*'''Заглушки''' - заглушки.
*'''Индикаторы''' - индикаторы.
*'''Каунтеры''' - каунтеры.

===[[Файл:+.png]] Параметры эффекта для специальных шариков===
*'''Этими параметрами можно пользоваться вместо "параметры анимации для шарика"'''
*'''Тип специального шарика''' - тип специального шарика (лунка, колючка, снежинка, вредитель, шарик из двух половинок, камень, целевой шарик, хищник, призрак, шестеренка, туман, портал, целевой шарик призрак, огонь, молния, под огнем).
*'''Эффект''' - Машинка, которая будет получать события:
**'''beg''' - начало эффекта.
**'''hit''' - попадание (есть матч).
**'''miss''' - промах (нет матча).
**'''match_around''' - сматчились шарики рядом.
**'''shot''' - выстрел.
**'''destroy''' - уничтожение эффекта.
**'''end''' - окончание эффекта (вызывается после destroy).
*'''Смещение эффекта''' - смещение эффекта относительно шарика.
*'''Количество действий''' - количество действий (попаданий, выстрелов, промахов), после которых специальный шарик начнет некую обработку (например огонь перекинется на другой шарик).
*'''Действие''' - действие (нет, выстрел, попадание, промах).
*'''Задержка перед destroy''' - время перед уничтожением эффекта.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек. Возможные значения F - functionality в файле уровня:
**'''0''' - обычный шарик
**'''1''' - лунка (попавший в нее шарик "проваливается")
**'''2''' - колючка (попавший в нее шарик просто лопается и матч не просчитывается)
**'''3''' - снежинка (при попадании в нее или схлопывании шарика рядом тает и превращается в обычный шарик)
**'''4''' - вредитель (увеличит уровень залочки шарика на один; шарик выбирается по алгоритму закрашивания)
**'''5''' - шарик из двух половинок; при матче с одной половинкой шарик лопается
**'''6''' - камень (не матчится, не опадает, не двигается, от него отскакивают шарики)
**'''7''' - целевой шарик (когда все такие шарики убиваются или обваливаются, игра считается выиграна)
**'''8''' - хищник (съедает шарик; отличается от лунки наличием анимации и убиваемостью)
**'''9''' - призрак (то же, что и снежинка, но у снежинки цвет задан изначально, а призрак его обретает после матча)
**'''A''' - шестеренка (при попадании в нее начинает двигаться по горизонтали и убивать шарики на пути)
**'''B''' - туман (шар с туманом, при попадании туман пропадает на определенное количество действий)
**'''C''' - портал (имеет два входа-выхода, обозначенных цветом по контуру портала. При попадании шаром в один из входов-выходов, шар вылетает из другого, продолжая траекторию движения)
**'''D''' - целевой шарик призрак (сначала действует как призрак, потом как целевой шарик)
**'''E''' - огонь (при попадании шар воспломеняется. после определенного количество действий шар сгорает и "заражает" огнем соседний верхний шар)
**'''F''' - молния (при попадании лопает все шары по горизонтальной линии)
**'''16''' - замароженость
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Параметры анимации для шарика хищник===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика (уменьшение по скейлу).
*'''Время жизни''' - время жизни эффекта.
*'''Клип''' - анимация съедания шарика.

===[[Файл:+.png]] Параметры анимации для шарика шестеренка===
*'''Скорость''' - скорость движения.
*'''Клип влево''' - клип движения влево.
*'''Клип вправо''' - клип движения вправо.

===[[Файл:+.png]] Параметры анимации для залоченного шарика===
*'''Эффект''' - эффект.
*'''Задержка удаления эффекта''' - задержка удаления эффекта.

===[[Файл:+.png]] Параметры анимации для шарика туман===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика огонь===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''Эффект цели''' - эффект цели.
*'''Эффект цели - смещение''' - эффект цели - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика молния===
*'''Время жизни''' - время жизни эффекта.
*'''Эффект центральный''' - центральный эффект молнии.
*'''Эффект промежуточный''' - промежуточный эффект молнии.
*'''Эффект краевой''' - краевой эффект молнии.
*'''Звук''' - звук молнии.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.
*'''PredatorD''' - Расстояние в диаметрах между летящим шариком и хищником, при котором они взаимодействуют (0 - дефолтное взаимодействие).
*'''vel_bang_bubbles''' - Скорость разлетающихся шариков после взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

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

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

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

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

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] бустер радужный шар: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] бустер радужный шар: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

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

===[[Файл:+.png]] сгорел целевой шарик: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] обвал шариков: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble.rar

=Пример реализации: задание уровня=

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

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter NEW

2017-12-14T12:24:01Z

Akovinenko:

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

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

'''Merge'''
*'''макс. уровень (max_level)''' - место в опциях, где лежит макс. уровень.
*'''сага тэг (saga_tag)''' - место в опциях, где лежит вся информация по саге.
*'''классика очки (classic_score)''' - место в опциях, где лежат очки по классике.
*'''классика тэг (classic_tag)''' - место в опциях, где лежит вся информация по классике.

=Графика=
*'''цветной шарик 1 (res1)''' - графический ресурс шарика 1.
*'''фрейм шарика 1 (res1Frame)''' - Номер фрейма ресурса шарика 1.
*'''цветной шарик 2 (res2)''' - графический ресурс шарика 2.
*'''фрейм шарика 2 (res2Frame)''' - Номер фрейма ресурса шарика 2.
*'''цветной шарик 3 (res3)''' - графический ресурс шарика 3
*'''фрейм шарика 3 (res3Frame)''' - Номер фрейма ресурса шарика 3.
*'''цветной шарик 4 (res4)''' - графический ресурс шарика 4.
*'''фрейм шарика 4 (res4Frame)''' - Номер фрейма ресурса шарика 4.
*'''цветной шарик 5 (res5)''' - графический ресурс шарика 5.
*'''фрейм шарика 5 (res5Frame)''' - Номер фрейма ресурса шарика 5.
*'''цветной шарик 6 (res6)''' - графический ресурс шарика 6.
*'''фрейм шарика 6 (res6Frame)''' - Номер фрейма ресурса шарика 6.
*'''цветной шарик 7 (res7)''' - графический ресурс шарика 7.
*'''фрейм шарика 7 (res7Frame)''' - Номер фрейма ресурса шарика 7.
*'''цветной шарик 8 (res8)''' - графический ресурс шарика 8.
*'''фрейм шарика 8 (res8Frame)''' - Номер фрейма ресурса шарика 8.
*'''цветной шарик Y (resY)''' - графический ресурс цветного шарика.
*'''гвоздь (resZ)''' - графический ресурс гвоздя.
*'''целевой шарик 1 (rest1)''' - графический ресурс целевого шарика 1.
*'''фрейм шарика 1 (rest1Frame)''' - Номер фрейма ресурса целевого шарика 1.
*'''целевой шарик 2 (rest2)''' - графический ресурс целевого шарика 2.
*'''фрейм шарика 2 (rest2Frame)''' - Номер фрейма ресурса целевого шарика 2.
*'''целевой шарик 3 (rest3)''' - графический ресурс целевого шарика 3
*'''фрейм шарика 3 (rest3Frame)''' - Номер фрейма ресурса целевого шарика 3.
*'''целевой шарик 4 (rest4)''' - графический ресурс целевого шарика 4.
*'''фрейм шарика 4 (rest4Frame)''' - Номер фрейма ресурса целевого шарика 4.
*'''целевой шарик 5 (rest5)''' - графический ресурс целевого шарика 5.
*'''фрейм шарика 5 (rest5Frame)''' - Номер фрейма ресурса целевого шарика 5.
*'''целевой шарик 6 (rest6)''' - графический ресурс целевого шарика 6.
*'''фрейм шарика 6 (rest6Frame)''' - Номер фрейма ресурса целевого шарика 6.
*'''целевой шарик 7 (rest7)''' - графический ресурс целевого шарика 7.
*'''фрейм шарика 7 (rest7Frame)''' - Номер фрейма ресурса целевого шарика 7.
*'''целевой шарик 8 (rest8)''' - графический ресурс целевого шарика 8.
*'''фрейм шарика 8 (rest8Frame)''' - Номер фрейма ресурса целевого шарика 8.
*'''целевой шарик Y (restY)''' - графический ресурс целевого цветного шарика.
*'''маска залочки (res_lock_mask)''' - графический ресурс маски залочки.
*'''падающий шарик (res_drop_mask)''' - графический ресурс падающего шарика.
*'''лунка (resf1)''' - графический ресурс лунки.
*'''фрейм лунка (resf1Frame)''' - Номер фрейма ресурса лунки.
*'''колючка (resf2)''' - графический ресурс колючки.
*'''фрейм колючка (resf2Frame)''' - Номер фрейма ресурса колючки.
*'''снежинка (resf3)''' - графический ресурс снежинки.
*'''фрейм снежинка (resf3Frame)''' - Номер фрейма ресурса снежинки.
*'''вредитель (resf4)''' - графический ресурс вредителя.
*'''фрейм вредитель (resf4Frame)''' - Номер фрейма ресурса вредителя.
*'''половинки (resf5)''' - графический ресурс половинок.
*'''фрейм половинки (resf5Frame)''' - Номер фрейма ресурса половинок.
*'''камень (resf6)''' - графический ресурс камня.
*'''фрейм камень (resf6Frame)''' - Номер фрейма ресурса камня.
*'''хищник (resf8)''' - графический ресурс маски залочки.
*'''фрейм хищник (resf8Frame)''' - графический ресурс маски залочки.
*'''призрак (resf9)''' - графический ресурс призрака.
*'''фрейм призрак (resf9Frame)''' - Номер фрейма ресурса призрака.
*'''шестеренка (resf10)''' - графический ресурс шетеренки.
*'''фрейм шестеренка (resf10Frame)''' - Номер фрейма ресурса шестеренки.
*'''туман (resf11)''' - графический ресурс тумана.
*'''фрейм туман (resf11Frame)''' - Номер фрейма ресурса тумана.
*'''портал (resf12)''' - графический ресурс портала.
*'''фрейм портал (resf12Frame)''' - Номер фрейма ресурса портала.
*'''призрак-цель (resf13)''' - графический ресурс призрак-цель.
*'''фрейм призрак-цель (resf13Frame)''' - Номер фрейма ресурса призрак-цель.
*'''огонь (resf14)''' - графический ресурс огня.
*'''фрейм огонь (resf14Frame)''' - Номер фрейма ресурса огонь.
*'''молния (resf15)''' - графический ресурс молнии.
*'''фрейм молния (resf15Frame)''' - Номер фрейма ресурса молния.
*'''радужный шар (resrainbow)''' - графический ресурс радужного шара.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''drop''' - Звук осыпания.
*'''intro''' - Звук в начале игры.
*'''add row''' - Звук добавления ряда.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Звук взрыва бомбы мина.
*'''Взрыв бомбы ядро''' - Звук взрыва бомбы ядро.
*'''Взрыв бомбы цвет''' - Звук взрыва бомбы цвет.
*'''Бомба мульти цвет''' - Звук взыва бомбы мульти цвет.
*'''Закат в лунку''' - Звук заката в лунку.
*'''Взрыв колючкой''' - Звук взрыва колючкой.
*'''Таяние снежинки''' - Звук таяния снежинки.

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.

=Машины отображающие пушку=
*'''Первый шарик''' - машина, отображающая первый шарик.
*'''Второй шарик''' - машина, отображающая второй шарик.
*'''Третий шарик''' - машина, отображающая третий шарик.

'''Машины могут иметь состояния:'''
*'''shot''' - выстрел.
*'''shot_over''' - окончание выстрела.
*'''swap''' - смена шариков.
*'''swap_over''' - окончание смены шариков.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res (curres)''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Расстояние между шариками (distance)''' - Расстояние между шариками, от которого зависит их количество.
*'''Кол-во шариков в последней линии (last_line_count_bubs)''' - количество шариков, которе будет в последней линии курсора.
*'''Отражения (curlns)''' - максимальное кол-во отражений от стенок.
*'''Коэффициент (curkoef)''' - коэффициент ds/s, где s - базовое расстояние между шариками, ds - его наращивание.
*'''минимальный скейл (curminsc)''' - минимальный скейл графики шариков
*'''максимальный скейл (curmaxsc)''' - максимальный скейл графики шариков
*'''время скалирования (cursctm)''' - время скалирования шариков

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего шарика (x,y)''' - Позиция стреляющего шарика (x,y)
*'''Позиция следующего шарика (x,y)''' - Позиция следующего шарика (x,y).
*'''Позиция 3-го шарика (x,y)''' - Позиция 3-го шарика (x,y).
*'''третий шарик (n3bub)''' - если 0 - 3-го шарика не будет, 1 - есть третий шарик.
*'''Коэффициент вероятности цветов''' - коэффициент вероятности цветов.
*'''Расстояние от следующего шарика''' - расстояние от следующего шарика.
*'''Скорость наезда для режима Bubblez''' - скорость наезда для режима Bubblez.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Скейл шариков для снукера''' - скейл шариков для снукера.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления рядов''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Color mapping''' - Color mapping включён (0 - нет, 1 - да).
*'''Тип рандома''' - Тип рандома. Простой - берём случайный из всех цветов, Супер Рандом - супер алгоритм, Из набора - формируем набор из n шариков и перемешиваем.
*'''Количество цвета для набора''' - количество цвета для формирования набора в рандоме (касается типа рандома "Из набора").
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''Файл трекинга''' - Файл трекинга формата .xml.
*'''Таблица трекинга''' - Таблица трекинга.
*'''Объект новых шариков''' - Объект, которому сообщается о новых шариках.
*'''Мувер''' - Объект, двигающий баббл шутер.
*'''Задержка перед броском''' - задержка перед броском.
*'''Задержка перед обрывом шариков''' - задержка перед обрывом шариков.
*'''К-во секторов для броска''' - Количество секторов для броска.
*'''Слушатель движения мыши''' - объект, слушатель движения мыши.
*'''Слушатель броска''' - объект, слушатель броска. По сути вызывается только состояние st1.
*'''Слушатель движения поля''' - объект, слушатель движения поля. Должен иметь состояния move (поле двигается) и move_over (окончание движения поля).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''Феерверк после победы''' - Включить феерверк из шариков сразу после победы (0 - нет, 1 - да).

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

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

===[[Файл:+.png]] Визцализатор целей===
*'''Заглушки''' - заглушки.
*'''Индикаторы''' - индикаторы.
*'''Каунтеры''' - каунтеры.

===[[Файл:+.png]] Параметры эффекта для специальных шариков===
*'''Этими параметрами можно пользоваться вместо "параметры анимации для шарика"'''
*'''Тип специального шарика''' - тип специального шарика (лунка, колючка, снежинка, вредитель, шарик из двух половинок, камень, целевой шарик, хищник, призрак, шестеренка, туман, портал, целевой шарик призрак, огонь, молния, под огнем).
*'''Эффект''' - Машинка, которая будет получать события:
**'''beg''' - начало эффекта.
**'''hit''' - попадание (есть матч).
**'''miss''' - промах (нет матча).
**'''match_around''' - сматчились шарики рядом.
**'''shot''' - выстрел.
**'''destroy''' - уничтожение эффекта.
**'''end''' - окончание эффекта (вызывается после destroy).
*'''Смещение эффекта''' - смещение эффекта относительно шарика.
*'''Количество действий''' - количество действий (попаданий, выстрелов, промахов), после которых специальный шарик начнет некую обработку (например огонь перекинется на другой шарик).
*'''Действие''' - действие (нет, выстрел, попадание, промах).
*'''Задержка перед destroy''' - время перед уничтожением эффекта.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек. Возможные значения F - functionality в файле уровня:
**'''0''' - обычный шарик
**'''1''' - лунка (попавший в нее шарик "проваливается")
**'''2''' - колючка (попавший в нее шарик просто лопается и матч не просчитывается)
**'''3''' - снежинка (при попадании в нее или схлопывании шарика рядом тает и превращается в обычный шарик)
**'''4''' - вредитель (увеличит уровень залочки шарика на один; шарик выбирается по алгоритму закрашивания)
**'''5''' - шарик из двух половинок; при матче с одной половинкой шарик лопается
**'''6''' - камень (не матчится, не опадает, не двигается, от него отскакивают шарики)
**'''7''' - целевой шарик (когда все такие шарики убиваются или обваливаются, игра считается выиграна)
**'''8''' - хищник (съедает шарик; отличается от лунки наличием анимации и убиваемостью)
**'''9''' - призрак (то же, что и снежинка, но у снежинки цвет задан изначально, а призрак его обретает после матча)
**'''A''' - шестеренка (при попадании в нее начинает двигаться по горизонтали и убивать шарики на пути)
**'''B''' - туман (шар с туманом, при попадании туман пропадает на определенное количество действий)
**'''C''' - портал (имеет два входа-выхода, обозначенных цветом по контуру портала. При попадании шаром в один из входов-выходов, шар вылетает из другого, продолжая траекторию движения)
**'''D''' - целевой шарик призрак (сначала действует как призрак, потом как целевой шарик)
**'''E''' - огонь (при попадании шар воспломеняется. после определенного количество действий шар сгорает и "заражает" огнем соседний верхний шар)
**'''F''' - молния (при попадании лопает все шары по горизонтальной линии)
**'''16''' - замароженость
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Параметры анимации для шарика хищник===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика (уменьшение по скейлу).
*'''Время жизни''' - время жизни эффекта.
*'''Клип''' - анимация съедания шарика.

===[[Файл:+.png]] Параметры анимации для шарика шестеренка===
*'''Скорость''' - скорость движения.
*'''Клип влево''' - клип движения влево.
*'''Клип вправо''' - клип движения вправо.

===[[Файл:+.png]] Параметры анимации для залоченного шарика===
*'''Эффект''' - эффект.
*'''Задержка удаления эффекта''' - задержка удаления эффекта.

===[[Файл:+.png]] Параметры анимации для шарика туман===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика огонь===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''Эффект цели''' - эффект цели.
*'''Эффект цели - смещение''' - эффект цели - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика молния===
*'''Время жизни''' - время жизни эффекта.
*'''Эффект центральный''' - центральный эффект молнии.
*'''Эффект промежуточный''' - промежуточный эффект молнии.
*'''Эффект краевой''' - краевой эффект молнии.
*'''Звук''' - звук молнии.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.
*'''PredatorD''' - Расстояние в диаметрах между летящим шариком и хищником, при котором они взаимодействуют (0 - дефолтное взаимодействие).
*'''vel_bang_bubbles''' - Скорость разлетающихся шариков после взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

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

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

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

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

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] бустер радужный шар: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] бустер радужный шар: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

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

===[[Файл:+.png]] сгорел целевой шарик: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] обвал шариков: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble.rar

=Пример реализации: задание уровня=

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

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter NEW

2017-12-14T12:16:24Z

Akovinenko: /* Добавляемые параметры */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

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

'''Merge'''
*'''макс. уровень (max_level)''' - место в опциях, где лежит макс. уровень.
*'''сага тэг (saga_tag)''' - место в опциях, где лежит вся информация по саге.
*'''классика очки (classic_score)''' - место в опциях, где лежат очки по классике.
*'''классика тэг (classic_tag)''' - место в опциях, где лежит вся информация по классике.

=Графика=
*'''цветной шарик 1 (res1)''' - графический ресурс шарика 1.
*'''фрейм шарика 1 (res1Frame)''' - Номер фрейма ресурса шарика 1.
*'''цветной шарик 2 (res2)''' - графический ресурс шарика 2.
*'''фрейм шарика 2 (res2Frame)''' - Номер фрейма ресурса шарика 2.
*'''цветной шарик 3 (res3)''' - графический ресурс шарика 3
*'''фрейм шарика 3 (res3Frame)''' - Номер фрейма ресурса шарика 3.
*'''цветной шарик 4 (res4)''' - графический ресурс шарика 4.
*'''фрейм шарика 4 (res4Frame)''' - Номер фрейма ресурса шарика 4.
*'''цветной шарик 5 (res5)''' - графический ресурс шарика 5.
*'''фрейм шарика 5 (res5Frame)''' - Номер фрейма ресурса шарика 5.
*'''цветной шарик 6 (res6)''' - графический ресурс шарика 6.
*'''фрейм шарика 6 (res6Frame)''' - Номер фрейма ресурса шарика 6.
*'''цветной шарик 7 (res7)''' - графический ресурс шарика 7.
*'''фрейм шарика 7 (res7Frame)''' - Номер фрейма ресурса шарика 7.
*'''цветной шарик 8 (res8)''' - графический ресурс шарика 8.
*'''фрейм шарика 8 (res8Frame)''' - Номер фрейма ресурса шарика 8.
*'''цветной шарик Y (resY)''' - графический ресурс цветного шарика.
*'''гвоздь (resZ)''' - графический ресурс гвоздя.
*'''целевой шарик 1 (rest1)''' - графический ресурс целевого шарика 1.
*'''фрейм шарика 1 (rest1Frame)''' - Номер фрейма ресурса целевого шарика 1.
*'''целевой шарик 2 (rest2)''' - графический ресурс целевого шарика 2.
*'''фрейм шарика 2 (rest2Frame)''' - Номер фрейма ресурса целевого шарика 2.
*'''целевой шарик 3 (rest3)''' - графический ресурс целевого шарика 3
*'''фрейм шарика 3 (rest3Frame)''' - Номер фрейма ресурса целевого шарика 3.
*'''целевой шарик 4 (rest4)''' - графический ресурс целевого шарика 4.
*'''фрейм шарика 4 (rest4Frame)''' - Номер фрейма ресурса целевого шарика 4.
*'''целевой шарик 5 (rest5)''' - графический ресурс целевого шарика 5.
*'''фрейм шарика 5 (rest5Frame)''' - Номер фрейма ресурса целевого шарика 5.
*'''целевой шарик 6 (rest6)''' - графический ресурс целевого шарика 6.
*'''фрейм шарика 6 (rest6Frame)''' - Номер фрейма ресурса целевого шарика 6.
*'''целевой шарик 7 (rest7)''' - графический ресурс целевого шарика 7.
*'''фрейм шарика 7 (rest7Frame)''' - Номер фрейма ресурса целевого шарика 7.
*'''целевой шарик 8 (rest8)''' - графический ресурс целевого шарика 8.
*'''фрейм шарика 8 (rest8Frame)''' - Номер фрейма ресурса целевого шарика 8.
*'''целевой шарик Y (restY)''' - графический ресурс целевого цветного шарика.
*'''маска залочки (res_lock_mask)''' - графический ресурс маски залочки.
*'''падающий шарик (res_drop_mask)''' - графический ресурс падающего шарика.
*'''лунка (resf1)''' - графический ресурс лунки.
*'''фрейм лунка (resf1Frame)''' - Номер фрейма ресурса лунки.
*'''колючка (resf2)''' - графический ресурс колючки.
*'''фрейм колючка (resf2Frame)''' - Номер фрейма ресурса колючки.
*'''снежинка (resf3)''' - графический ресурс снежинки.
*'''фрейм снежинка (resf3Frame)''' - Номер фрейма ресурса снежинки.
*'''вредитель (resf4)''' - графический ресурс вредителя.
*'''фрейм вредитель (resf4Frame)''' - Номер фрейма ресурса вредителя.
*'''половинки (resf5)''' - графический ресурс половинок.
*'''фрейм половинки (resf5Frame)''' - Номер фрейма ресурса половинок.
*'''камень (resf6)''' - графический ресурс камня.
*'''фрейм камень (resf6Frame)''' - Номер фрейма ресурса камня.
*'''хищник (resf8)''' - графический ресурс маски залочки.
*'''фрейм хищник (resf8Frame)''' - графический ресурс маски залочки.
*'''призрак (resf9)''' - графический ресурс призрака.
*'''фрейм призрак (resf9Frame)''' - Номер фрейма ресурса призрака.
*'''шестеренка (resf10)''' - графический ресурс шетеренки.
*'''фрейм шестеренка (resf10Frame)''' - Номер фрейма ресурса шестеренки.
*'''туман (resf11)''' - графический ресурс тумана.
*'''фрейм туман (resf11Frame)''' - Номер фрейма ресурса тумана.
*'''портал (resf12)''' - графический ресурс портала.
*'''фрейм портал (resf12Frame)''' - Номер фрейма ресурса портала.
*'''призрак-цель (resf13)''' - графический ресурс призрак-цель.
*'''фрейм призрак-цель (resf13Frame)''' - Номер фрейма ресурса призрак-цель.
*'''огонь (resf14)''' - графический ресурс огня.
*'''фрейм огонь (resf14Frame)''' - Номер фрейма ресурса огонь.
*'''молния (resf15)''' - графический ресурс молнии.
*'''фрейм молния (resf15Frame)''' - Номер фрейма ресурса молния.
*'''радужный шар (resrainbow)''' - графический ресурс радужного шара.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''drop''' - Звук осыпания.
*'''intro''' - Звук в начале игры.
*'''add row''' - Звук добавления ряда.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Звук взрыва бомбы мина.
*'''Взрыв бомбы ядро''' - Звук взрыва бомбы ядро.
*'''Взрыв бомбы цвет''' - Звук взрыва бомбы цвет.
*'''Бомба мульти цвет''' - Звук взыва бомбы мульти цвет.
*'''Закат в лунку''' - Звук заката в лунку.
*'''Взрыв колючкой''' - Звук взрыва колючкой.
*'''Таяние снежинки''' - Звук таяния снежинки.

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.

=Машины отображающие пушку=
*'''Первый шарик''' - машина, отображающая первый шарик.
*'''Второй шарик''' - машина, отображающая второй шарик.
*'''Третий шарик''' - машина, отображающая третий шарик.

'''Машины могут иметь состояния:'''
*'''shot''' - выстрел.
*'''shot_over''' - окончание выстрела.
*'''swap''' - смена шариков.
*'''swap_over''' - окончание смены шариков.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res (curres)''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Расстояние между шариками (distance)''' - Расстояние между шариками, от которого зависит их количество.
*'''Кол-во шариков в последней линии (last_line_count_bubs)''' - количество шариков, которе будет в последней линии курсора.
*'''Отражения (curlns)''' - максимальное кол-во отражений от стенок.
*'''Коэффициент (curkoef)''' - коэффициент ds/s, где s - базовое расстояние между шариками, ds - его наращивание.
*'''минимальный скейл (curminsc)''' - минимальный скейл графики шариков
*'''максимальный скейл (curmaxsc)''' - максимальный скейл графики шариков
*'''время скалирования (cursctm)''' - время скалирования шариков

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего шарика (x,y)''' - Позиция стреляющего шарика (x,y)
*'''Позиция следующего шарика (x,y)''' - Позиция следующего шарика (x,y).
*'''Позиция 3-го шарика (x,y)''' - Позиция 3-го шарика (x,y).
*'''третий шарик (n3bub)''' - если 0 - 3-го шарика не будет, 1 - есть третий шарик.
*'''Коэффициент вероятности цветов''' - коэффициент вероятности цветов.
*'''Расстояние от следующего шарика''' - расстояние от следующего шарика.
*'''Скорость наезда для режима Bubblez''' - скорость наезда для режима Bubblez.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Скейл шариков для снукера''' - скейл шариков для снукера.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления рядов''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Color mapping''' - Color mapping включён (0 - нет, 1 - да).
*'''Тип рандома''' - Тип рандома. Простой - берём случайный из всех цветов, Супер Рандом - супер алгоритм, Из набора - формируем набор из n шариков и перемешиваем.
*'''Количество цвета для набора''' - количество цвета для формирования набора в рандоме (касается типа рандома "Из набора").
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''Файл трекинга''' - Файл трекинга формата .xml.
*'''Таблица трекинга''' - Таблица трекинга.
*'''Объект новых шариков''' - Объект, которому сообщается о новых шариках.
*'''Мувер''' - Объект, двигающий баббл шутер.
*'''Задержка перед броском''' - задержка перед броском.
*'''Задержка перед обрывом шариков''' - задержка перед обрывом шариков.
*'''К-во секторов для броска''' - Количество секторов для броска.
*'''Слушатель движения мыши''' - объект, слушатель движения мыши.
*'''Слушатель броска''' - объект, слушатель броска. По сути вызывается только состояние st1.
*'''Слушатель движения поля''' - объект, слушатель движения поля. Должен иметь состояния move (поле двигается) и move_over (окончание движения поля).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''Феерверк после победы''' - Включить феерверк из шариков сразу после победы (0 - нет, 1 - да).

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

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

===[[Файл:+.png]] Визцализатор целей===
*'''Заглушки''' - заглушки.
*'''Индикаторы''' - индикаторы.
*'''Каунтеры''' - каунтеры.

===[[Файл:+.png]] Параметры эффекта для специальных шариков===
*'''Этими параметрами можно пользоваться вместо "параметры анимации для шарика"'''
*'''Тип специального шарика''' - тип специального шарика (лунка, колючка, снежинка, вредитель, шарик из двух половинок, камень, целевой шарик, хищник, призрак, шестеренка, туман, портал, целевой шарик призрак, огонь, молния, под огнем).
*'''Эффект''' - Машинка, которая будет получать события:
**'''beg''' - начало эффекта.
**'''hit''' - попадание (есть матч).
**'''miss''' - промах (нет матча).
**'''match_around''' - сматчились шарики рядом.
**'''shot''' - выстрел.
**'''destroy''' - уничтожение эффекта.
**'''end''' - окончание эффекта (вызывается после destroy).
*'''Смещение эффекта''' - смещение эффекта относительно шарика.
*'''Количество действий''' - количество действий (попаданий, выстрелов, промахов), после которых специальный шарик начнет некую обработку (например огонь перекинется на другой шарик).
*'''Действие''' - действие (нет, выстрел, попадание, промах).
*'''Задержка перед destroy''' - время перед уничтожением эффекта.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек. Возможные значения F - functionality в файле уровня:
**'''0''' - обычный шарик
**'''1''' - лунка (попавший в нее шарик "проваливается")
**'''2''' - колючка (попавший в нее шарик просто лопается и матч не просчитывается)
**'''3''' - снежинка (при попадании в нее или схлопывании шарика рядом тает и превращается в обычный шарик)
**'''4''' - вредитель (увеличит уровень залочки шарика на один; шарик выбирается по алгоритму закрашивания)
**'''5''' - шарик из двух половинок; при матче с одной половинкой шарик лопается
**'''6''' - камень (не матчится, не опадает, не двигается, от него отскакивают шарики)
**'''7''' - целевой шарик (когда все такие шарики убиваются или обваливаются, игра считается выиграна)
**'''8''' - хищник (съедает шарик; отличается от лунки наличием анимации и убиваемостью)
**'''9''' - призрак (то же, что и снежинка, но у снежинки цвет задан изначально, а призрак его обретает после матча)
**'''A''' - шестеренка (при попадании в нее начинает двигаться по горизонтали и убивать шарики на пути)
**'''B''' - туман (шар с туманом, при попадании туман пропадает на определенное количество действий)
**'''C''' - портал (имеет два входа-выхода, обозначенных цветом по контуру портала. При попадании шаром в один из входов-выходов, шар вылетает из другого, продолжая траекторию движения)
**'''D''' - целевой шарик призрак (сначала действует как призрак, потом как целевой шарик)
**'''E''' - огонь (при попадании шар воспломеняется. после определенного количество действий шар сгорает и "заражает" огнем соседний верхний шар)
**'''F''' - молния (при попадании лопает все шары по горизонтальной линии)
**'''16''' - замароженость
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Параметры анимации для шарика хищник===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика (уменьшение по скейлу).
*'''Время жизни''' - время жизни эффекта.
*'''Клип''' - анимация съедания шарика.

===[[Файл:+.png]] Параметры анимации для шарика шестеренка===
*'''Скорость''' - скорость движения.
*'''Клип влево''' - клип движения влево.
*'''Клип вправо''' - клип движения вправо.

===[[Файл:+.png]] Параметры анимации для залоченного шарика===
*'''Эффект''' - эффект.
*'''Задержка удаления эффекта''' - задержка удаления эффекта.

===[[Файл:+.png]] Параметры анимации для шарика туман===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика огонь===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''Эффект цели''' - эффект цели.
*'''Эффект цели - смещение''' - эффект цели - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика молния===
*'''Время жизни''' - время жизни эффекта.
*'''Эффект центральный''' - центральный эффект молнии.
*'''Эффект промежуточный''' - промежуточный эффект молнии.
*'''Эффект краевой''' - краевой эффект молнии.
*'''Звук''' - звук молнии.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.
*'''PredatorD''' - Расстояние в диаметрах между летящим шариком и хищником, при котором они взаимодействуют (0 - дефолтное взаимодействие).
*'''vel_bang_bubbles''' - Скорость разлетающихся шариков после взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

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

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

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

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

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] бустер радужный шар: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] бустер радужный шар: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

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

===[[Файл:+.png]] сгорел целевой шарик: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] обвал шариков: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble.rar

=Пример реализации: задание уровня=

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

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter NEW

2017-12-14T12:14:35Z

Akovinenko: /* Добавляемые параметры */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

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

'''Merge'''
*'''макс. уровень (max_level)''' - место в опциях, где лежит макс. уровень.
*'''сага тэг (saga_tag)''' - место в опциях, где лежит вся информация по саге.
*'''классика очки (classic_score)''' - место в опциях, где лежат очки по классике.
*'''классика тэг (classic_tag)''' - место в опциях, где лежит вся информация по классике.

=Графика=
*'''цветной шарик 1 (res1)''' - графический ресурс шарика 1.
*'''фрейм шарика 1 (res1Frame)''' - Номер фрейма ресурса шарика 1.
*'''цветной шарик 2 (res2)''' - графический ресурс шарика 2.
*'''фрейм шарика 2 (res2Frame)''' - Номер фрейма ресурса шарика 2.
*'''цветной шарик 3 (res3)''' - графический ресурс шарика 3
*'''фрейм шарика 3 (res3Frame)''' - Номер фрейма ресурса шарика 3.
*'''цветной шарик 4 (res4)''' - графический ресурс шарика 4.
*'''фрейм шарика 4 (res4Frame)''' - Номер фрейма ресурса шарика 4.
*'''цветной шарик 5 (res5)''' - графический ресурс шарика 5.
*'''фрейм шарика 5 (res5Frame)''' - Номер фрейма ресурса шарика 5.
*'''цветной шарик 6 (res6)''' - графический ресурс шарика 6.
*'''фрейм шарика 6 (res6Frame)''' - Номер фрейма ресурса шарика 6.
*'''цветной шарик 7 (res7)''' - графический ресурс шарика 7.
*'''фрейм шарика 7 (res7Frame)''' - Номер фрейма ресурса шарика 7.
*'''цветной шарик 8 (res8)''' - графический ресурс шарика 8.
*'''фрейм шарика 8 (res8Frame)''' - Номер фрейма ресурса шарика 8.
*'''цветной шарик Y (resY)''' - графический ресурс цветного шарика.
*'''гвоздь (resZ)''' - графический ресурс гвоздя.
*'''целевой шарик 1 (rest1)''' - графический ресурс целевого шарика 1.
*'''фрейм шарика 1 (rest1Frame)''' - Номер фрейма ресурса целевого шарика 1.
*'''целевой шарик 2 (rest2)''' - графический ресурс целевого шарика 2.
*'''фрейм шарика 2 (rest2Frame)''' - Номер фрейма ресурса целевого шарика 2.
*'''целевой шарик 3 (rest3)''' - графический ресурс целевого шарика 3
*'''фрейм шарика 3 (rest3Frame)''' - Номер фрейма ресурса целевого шарика 3.
*'''целевой шарик 4 (rest4)''' - графический ресурс целевого шарика 4.
*'''фрейм шарика 4 (rest4Frame)''' - Номер фрейма ресурса целевого шарика 4.
*'''целевой шарик 5 (rest5)''' - графический ресурс целевого шарика 5.
*'''фрейм шарика 5 (rest5Frame)''' - Номер фрейма ресурса целевого шарика 5.
*'''целевой шарик 6 (rest6)''' - графический ресурс целевого шарика 6.
*'''фрейм шарика 6 (rest6Frame)''' - Номер фрейма ресурса целевого шарика 6.
*'''целевой шарик 7 (rest7)''' - графический ресурс целевого шарика 7.
*'''фрейм шарика 7 (rest7Frame)''' - Номер фрейма ресурса целевого шарика 7.
*'''целевой шарик 8 (rest8)''' - графический ресурс целевого шарика 8.
*'''фрейм шарика 8 (rest8Frame)''' - Номер фрейма ресурса целевого шарика 8.
*'''целевой шарик Y (restY)''' - графический ресурс целевого цветного шарика.
*'''маска залочки (res_lock_mask)''' - графический ресурс маски залочки.
*'''падающий шарик (res_drop_mask)''' - графический ресурс падающего шарика.
*'''лунка (resf1)''' - графический ресурс лунки.
*'''фрейм лунка (resf1Frame)''' - Номер фрейма ресурса лунки.
*'''колючка (resf2)''' - графический ресурс колючки.
*'''фрейм колючка (resf2Frame)''' - Номер фрейма ресурса колючки.
*'''снежинка (resf3)''' - графический ресурс снежинки.
*'''фрейм снежинка (resf3Frame)''' - Номер фрейма ресурса снежинки.
*'''вредитель (resf4)''' - графический ресурс вредителя.
*'''фрейм вредитель (resf4Frame)''' - Номер фрейма ресурса вредителя.
*'''половинки (resf5)''' - графический ресурс половинок.
*'''фрейм половинки (resf5Frame)''' - Номер фрейма ресурса половинок.
*'''камень (resf6)''' - графический ресурс камня.
*'''фрейм камень (resf6Frame)''' - Номер фрейма ресурса камня.
*'''хищник (resf8)''' - графический ресурс маски залочки.
*'''фрейм хищник (resf8Frame)''' - графический ресурс маски залочки.
*'''призрак (resf9)''' - графический ресурс призрака.
*'''фрейм призрак (resf9Frame)''' - Номер фрейма ресурса призрака.
*'''шестеренка (resf10)''' - графический ресурс шетеренки.
*'''фрейм шестеренка (resf10Frame)''' - Номер фрейма ресурса шестеренки.
*'''туман (resf11)''' - графический ресурс тумана.
*'''фрейм туман (resf11Frame)''' - Номер фрейма ресурса тумана.
*'''портал (resf12)''' - графический ресурс портала.
*'''фрейм портал (resf12Frame)''' - Номер фрейма ресурса портала.
*'''призрак-цель (resf13)''' - графический ресурс призрак-цель.
*'''фрейм призрак-цель (resf13Frame)''' - Номер фрейма ресурса призрак-цель.
*'''огонь (resf14)''' - графический ресурс огня.
*'''фрейм огонь (resf14Frame)''' - Номер фрейма ресурса огонь.
*'''молния (resf15)''' - графический ресурс молнии.
*'''фрейм молния (resf15Frame)''' - Номер фрейма ресурса молния.
*'''радужный шар (resrainbow)''' - графический ресурс радужного шара.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''drop''' - Звук осыпания.
*'''intro''' - Звук в начале игры.
*'''add row''' - Звук добавления ряда.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Звук взрыва бомбы мина.
*'''Взрыв бомбы ядро''' - Звук взрыва бомбы ядро.
*'''Взрыв бомбы цвет''' - Звук взрыва бомбы цвет.
*'''Бомба мульти цвет''' - Звук взыва бомбы мульти цвет.
*'''Закат в лунку''' - Звук заката в лунку.
*'''Взрыв колючкой''' - Звук взрыва колючкой.
*'''Таяние снежинки''' - Звук таяния снежинки.

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.

=Машины отображающие пушку=
*'''Первый шарик''' - машина, отображающая первый шарик.
*'''Второй шарик''' - машина, отображающая второй шарик.
*'''Третий шарик''' - машина, отображающая третий шарик.

'''Машины могут иметь состояния:'''
*'''shot''' - выстрел.
*'''shot_over''' - окончание выстрела.
*'''swap''' - смена шариков.
*'''swap_over''' - окончание смены шариков.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res (curres)''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Расстояние между шариками (distance)''' - Расстояние между шариками, от которого зависит их количество.
*'''Кол-во шариков в последней линии (last_line_count_bubs)''' - количество шариков, которе будет в последней линии курсора.
*'''Отражения (curlns)''' - максимальное кол-во отражений от стенок.
*'''Коэффициент (curkoef)''' - коэффициент ds/s, где s - базовое расстояние между шариками, ds - его наращивание.
*'''минимальный скейл (curminsc)''' - минимальный скейл графики шариков
*'''максимальный скейл (curmaxsc)''' - максимальный скейл графики шариков
*'''время скалирования (cursctm)''' - время скалирования шариков

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего шарика (x,y)''' - Позиция стреляющего шарика (x,y)
*'''Позиция следующего шарика (x,y)''' - Позиция следующего шарика (x,y).
*'''Позиция 3-го шарика (x,y)''' - Позиция 3-го шарика (x,y).
*'''третий шарик (n3bub)''' - если 0 - 3-го шарика не будет, 1 - есть третий шарик.
*'''Коэффициент вероятности цветов''' - коэффициент вероятности цветов.
*'''Расстояние от следующего шарика''' - расстояние от следующего шарика.
*'''Скорость наезда для режима Bubblez''' - скорость наезда для режима Bubblez.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Скейл шариков для снукера''' - скейл шариков для снукера.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления рядов''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Color mapping''' - Color mapping включён (0 - нет, 1 - да).
*'''Тип рандома''' - Тип рандома. Простой - берём случайный из всех цветов, Супер Рандом - супер алгоритм, Из набора - формируем набор из n шариков и перемешиваем.
*'''Количество цвета для набора''' - количество цвета для формирования набора в рандоме (касается типа рандома "Из набора").
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''Файл трекинга''' - Файл трекинга формата .xml.
*'''Таблица трекинга''' - Таблица трекинга.
*'''Объект новых шариков''' - Объект, которому сообщается о новых шариках.
*'''Мувер''' - Объект, двигающий баббл шутер.
*'''Задержка перед броском''' - задержка перед броском.
*'''Задержка перед обрывом шариков''' - задержка перед обрывом шариков.
*'''К-во секторов для броска''' - Количество секторов для броска.
*'''Слушатель движения мыши''' - объект, слушатель движения мыши.
*'''Слушатель броска''' - объект, слушатель броска. По сути вызывается только состояние st1.
*'''Слушатель движения поля''' - объект, слушатель движения поля. Должен иметь состояния move (поле двигается) и move_over (окончание движения поля).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''Феерверк после победы''' - Включить феерверк из шариков сразу после победы (0 - нет, 1 - да).

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

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

===[[Файл:+.png]] Визцализатор целей===
*'''Заглушки''' - заглушки.
*'''Индикаторы''' - индикаторы.
*'''Каунтеры''' - каунтеры.

===[[Файл:+.png]] Параметры эффекта для специальных шариков===
*'''Этими параметрами можно пользоваться вместо "параметры анимации для шарика"'''
*'''Тип специального шарика''' - тип специального шарика (лунка, колючка, снежинка, вредитель, шарик из двух половинок, камень, целевой шарик, хищник, призрак, шестеренка, туман, портал, целевой шарик призрак, огонь, молния, под огнем).
*'''Эффект''' - Машинка, которая будет получать события:
**'''beg''' - начало эффекта.
**'''hit''' - попадание (есть матч).
**'''miss''' - промах (нет матча).
**'''match_around''' - сматчились шарики рядом.
**'''shot''' - выстрел.
**'''destroy''' - уничтожение эффекта.
**'''end''' - окончание эффекта (вызывается после destroy).
*'''Смещение эффекта''' - смещение эффекта относительно шарика.
*'''Количество действий''' - количество действий (попаданий, выстрелов, промахов), после которых специальный шарик начнет некую обработку (например огонь перекинется на другой шарик).
*'''Действие''' - действие (нет, выстрел, попадание, промах).
*'''Задержка перед destroy''' - время перед уничтожением эффекта.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек. Возможные значения F - functionality в файле уровня:
**'''0''' - обычный шарик
**'''1''' - лунка (попавший в нее шарик "проваливается")
**'''2''' - колючка (попавший в нее шарик просто лопается и матч не просчитывается)
**'''3''' - снежинка (при попадании в нее или схлопывании шарика рядом тает и превращается в обычный шарик)
**'''4''' - вредитель (увеличит уровень залочки шарика на один; шарик выбирается по алгоритму закрашивания)
**'''5''' - шарик из двух половинок; при матче с одной половинкой шарик лопается
**'''6''' - камень (не матчится, не опадает, не двигается, от него отскакивают шарики)
**'''7''' - целевой шарик (когда все такие шарики убиваются или обваливаются, игра считается выиграна)
**'''8''' - хищник (съедает шарик; отличается от лунки наличием анимации и убиваемостью)
**'''9''' - призрак (то же, что и снежинка, но у снежинки цвет задан изначально, а призрак его обретает после матча)
**'''A''' - шестеренка (при попадании в нее начинает двигаться по горизонтали и убивать шарики на пути)
**'''B''' - туман (шар с туманом, при попадании туман пропадает на определенное количество действий)
**'''C''' - портал (имеет два входа-выхода, обозначенных цветом по контуру портала. При попадании шаром в один из входов-выходов, шар вылетает из другого, продолжая траекторию движения)
**'''D''' - целевой шарик призрак (сначала действует как призрак, потом как целевой шарик)
**'''E''' - огонь (при попадании шар воспломеняется. после определенного количество действий шар сгорает и "заражает" огнем соседний верхний шар)
**'''F''' - молния (при попадании лопает все шары по горизонтальной линии)
**'''16''' - замароженость
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Параметры анимации для шарика хищник===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика (уменьшение по скейлу).
*'''Время жизни''' - время жизни эффекта.
*'''Клип''' - анимация съедания шарика.

===[[Файл:+.png]] Параметры анимации для шарика шестеренка===
*'''Скорость''' - скорость движения.
*'''Клип влево''' - клип движения влево.
*'''Клип вправо''' - клип движения вправо.

===[[Файл:+.png]] Параметры анимации для залоченного шарика===
*'''Эффект''' - эффект.
*'''Задержка удаления эффекта''' - задержка удаления эффекта.

===[[Файл:+.png]] Параметры анимации для шарика туман===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика огонь===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''Эффект цели''' - эффект цели.
*'''Эффект цели - смещение''' - эффект цели - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика молния===
*'''Время жизни''' - время жизни эффекта.
*'''Эффект центральный''' - центральный эффект молнии.
*'''Эффект промежуточный''' - промежуточный эффект молнии.
*'''Эффект краевой''' - краевой эффект молнии.
*'''Звук''' - звук молнии.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.
*'''PredatorD''' - Расстояние в диаметрах между летящим шариком и хищником, при котором они взаимодействуют (0 - дефолтное взаимодействие).
*'''vel_bang_bubbles''' - Скорость разлетающихся шариков после взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

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

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

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

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

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

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

===[[Файл:+.png]] сгорел целевой шарик: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] обвал шариков: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble.rar

=Пример реализации: задание уровня=

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

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter NEW

2017-12-14T12:08:11Z

Akovinenko: /* Файл:+.png Ресурсы функциональных шариков */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

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

'''Merge'''
*'''макс. уровень (max_level)''' - место в опциях, где лежит макс. уровень.
*'''сага тэг (saga_tag)''' - место в опциях, где лежит вся информация по саге.
*'''классика очки (classic_score)''' - место в опциях, где лежат очки по классике.
*'''классика тэг (classic_tag)''' - место в опциях, где лежит вся информация по классике.

=Графика=
*'''цветной шарик 1 (res1)''' - графический ресурс шарика 1.
*'''фрейм шарика 1 (res1Frame)''' - Номер фрейма ресурса шарика 1.
*'''цветной шарик 2 (res2)''' - графический ресурс шарика 2.
*'''фрейм шарика 2 (res2Frame)''' - Номер фрейма ресурса шарика 2.
*'''цветной шарик 3 (res3)''' - графический ресурс шарика 3
*'''фрейм шарика 3 (res3Frame)''' - Номер фрейма ресурса шарика 3.
*'''цветной шарик 4 (res4)''' - графический ресурс шарика 4.
*'''фрейм шарика 4 (res4Frame)''' - Номер фрейма ресурса шарика 4.
*'''цветной шарик 5 (res5)''' - графический ресурс шарика 5.
*'''фрейм шарика 5 (res5Frame)''' - Номер фрейма ресурса шарика 5.
*'''цветной шарик 6 (res6)''' - графический ресурс шарика 6.
*'''фрейм шарика 6 (res6Frame)''' - Номер фрейма ресурса шарика 6.
*'''цветной шарик 7 (res7)''' - графический ресурс шарика 7.
*'''фрейм шарика 7 (res7Frame)''' - Номер фрейма ресурса шарика 7.
*'''цветной шарик 8 (res8)''' - графический ресурс шарика 8.
*'''фрейм шарика 8 (res8Frame)''' - Номер фрейма ресурса шарика 8.
*'''цветной шарик Y (resY)''' - графический ресурс цветного шарика.
*'''гвоздь (resZ)''' - графический ресурс гвоздя.
*'''целевой шарик 1 (rest1)''' - графический ресурс целевого шарика 1.
*'''фрейм шарика 1 (rest1Frame)''' - Номер фрейма ресурса целевого шарика 1.
*'''целевой шарик 2 (rest2)''' - графический ресурс целевого шарика 2.
*'''фрейм шарика 2 (rest2Frame)''' - Номер фрейма ресурса целевого шарика 2.
*'''целевой шарик 3 (rest3)''' - графический ресурс целевого шарика 3
*'''фрейм шарика 3 (rest3Frame)''' - Номер фрейма ресурса целевого шарика 3.
*'''целевой шарик 4 (rest4)''' - графический ресурс целевого шарика 4.
*'''фрейм шарика 4 (rest4Frame)''' - Номер фрейма ресурса целевого шарика 4.
*'''целевой шарик 5 (rest5)''' - графический ресурс целевого шарика 5.
*'''фрейм шарика 5 (rest5Frame)''' - Номер фрейма ресурса целевого шарика 5.
*'''целевой шарик 6 (rest6)''' - графический ресурс целевого шарика 6.
*'''фрейм шарика 6 (rest6Frame)''' - Номер фрейма ресурса целевого шарика 6.
*'''целевой шарик 7 (rest7)''' - графический ресурс целевого шарика 7.
*'''фрейм шарика 7 (rest7Frame)''' - Номер фрейма ресурса целевого шарика 7.
*'''целевой шарик 8 (rest8)''' - графический ресурс целевого шарика 8.
*'''фрейм шарика 8 (rest8Frame)''' - Номер фрейма ресурса целевого шарика 8.
*'''целевой шарик Y (restY)''' - графический ресурс целевого цветного шарика.
*'''маска залочки (res_lock_mask)''' - графический ресурс маски залочки.
*'''падающий шарик (res_drop_mask)''' - графический ресурс падающего шарика.
*'''лунка (resf1)''' - графический ресурс лунки.
*'''фрейм лунка (resf1Frame)''' - Номер фрейма ресурса лунки.
*'''колючка (resf2)''' - графический ресурс колючки.
*'''фрейм колючка (resf2Frame)''' - Номер фрейма ресурса колючки.
*'''снежинка (resf3)''' - графический ресурс снежинки.
*'''фрейм снежинка (resf3Frame)''' - Номер фрейма ресурса снежинки.
*'''вредитель (resf4)''' - графический ресурс вредителя.
*'''фрейм вредитель (resf4Frame)''' - Номер фрейма ресурса вредителя.
*'''половинки (resf5)''' - графический ресурс половинок.
*'''фрейм половинки (resf5Frame)''' - Номер фрейма ресурса половинок.
*'''камень (resf6)''' - графический ресурс камня.
*'''фрейм камень (resf6Frame)''' - Номер фрейма ресурса камня.
*'''хищник (resf8)''' - графический ресурс маски залочки.
*'''фрейм хищник (resf8Frame)''' - графический ресурс маски залочки.
*'''призрак (resf9)''' - графический ресурс призрака.
*'''фрейм призрак (resf9Frame)''' - Номер фрейма ресурса призрака.
*'''шестеренка (resf10)''' - графический ресурс шетеренки.
*'''фрейм шестеренка (resf10Frame)''' - Номер фрейма ресурса шестеренки.
*'''туман (resf11)''' - графический ресурс тумана.
*'''фрейм туман (resf11Frame)''' - Номер фрейма ресурса тумана.
*'''портал (resf12)''' - графический ресурс портала.
*'''фрейм портал (resf12Frame)''' - Номер фрейма ресурса портала.
*'''призрак-цель (resf13)''' - графический ресурс призрак-цель.
*'''фрейм призрак-цель (resf13Frame)''' - Номер фрейма ресурса призрак-цель.
*'''огонь (resf14)''' - графический ресурс огня.
*'''фрейм огонь (resf14Frame)''' - Номер фрейма ресурса огонь.
*'''молния (resf15)''' - графический ресурс молнии.
*'''фрейм молния (resf15Frame)''' - Номер фрейма ресурса молния.
*'''радужный шар (resrainbow)''' - графический ресурс радужного шара.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''drop''' - Звук осыпания.
*'''intro''' - Звук в начале игры.
*'''add row''' - Звук добавления ряда.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Звук взрыва бомбы мина.
*'''Взрыв бомбы ядро''' - Звук взрыва бомбы ядро.
*'''Взрыв бомбы цвет''' - Звук взрыва бомбы цвет.
*'''Бомба мульти цвет''' - Звук взыва бомбы мульти цвет.
*'''Закат в лунку''' - Звук заката в лунку.
*'''Взрыв колючкой''' - Звук взрыва колючкой.
*'''Таяние снежинки''' - Звук таяния снежинки.

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.

=Машины отображающие пушку=
*'''Первый шарик''' - машина, отображающая первый шарик.
*'''Второй шарик''' - машина, отображающая второй шарик.
*'''Третий шарик''' - машина, отображающая третий шарик.

'''Машины могут иметь состояния:'''
*'''shot''' - выстрел.
*'''shot_over''' - окончание выстрела.
*'''swap''' - смена шариков.
*'''swap_over''' - окончание смены шариков.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res (curres)''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Расстояние между шариками (distance)''' - Расстояние между шариками, от которого зависит их количество.
*'''Кол-во шариков в последней линии (last_line_count_bubs)''' - количество шариков, которе будет в последней линии курсора.
*'''Отражения (curlns)''' - максимальное кол-во отражений от стенок.
*'''Коэффициент (curkoef)''' - коэффициент ds/s, где s - базовое расстояние между шариками, ds - его наращивание.
*'''минимальный скейл (curminsc)''' - минимальный скейл графики шариков
*'''максимальный скейл (curmaxsc)''' - максимальный скейл графики шариков
*'''время скалирования (cursctm)''' - время скалирования шариков

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего шарика (x,y)''' - Позиция стреляющего шарика (x,y)
*'''Позиция следующего шарика (x,y)''' - Позиция следующего шарика (x,y).
*'''Позиция 3-го шарика (x,y)''' - Позиция 3-го шарика (x,y).
*'''третий шарик (n3bub)''' - если 0 - 3-го шарика не будет, 1 - есть третий шарик.
*'''Коэффициент вероятности цветов''' - коэффициент вероятности цветов.
*'''Расстояние от следующего шарика''' - расстояние от следующего шарика.
*'''Скорость наезда для режима Bubblez''' - скорость наезда для режима Bubblez.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Скейл шариков для снукера''' - скейл шариков для снукера.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления рядов''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Color mapping''' - Color mapping включён (0 - нет, 1 - да).
*'''Тип рандома''' - Тип рандома. Простой - берём случайный из всех цветов, Супер Рандом - супер алгоритм, Из набора - формируем набор из n шариков и перемешиваем.
*'''Количество цвета для набора''' - количество цвета для формирования набора в рандоме (касается типа рандома "Из набора").
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''Файл трекинга''' - Файл трекинга формата .xml.
*'''Таблица трекинга''' - Таблица трекинга.
*'''Объект новых шариков''' - Объект, которому сообщается о новых шариках.
*'''Мувер''' - Объект, двигающий баббл шутер.
*'''Задержка перед броском''' - задержка перед броском.
*'''Задержка перед обрывом шариков''' - задержка перед обрывом шариков.
*'''К-во секторов для броска''' - Количество секторов для броска.
*'''Слушатель движения мыши''' - объект, слушатель движения мыши.
*'''Слушатель броска''' - объект, слушатель броска. По сути вызывается только состояние st1.
*'''Слушатель движения поля''' - объект, слушатель движения поля. Должен иметь состояния move (поле двигается) и move_over (окончание движения поля).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''Феерверк после победы''' - Включить феерверк из шариков сразу после победы (0 - нет, 1 - да).

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

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

===[[Файл:+.png]] Визцализатор целей===
*'''Заглушки''' - заглушки.
*'''Индикаторы''' - индикаторы.
*'''Каунтеры''' - каунтеры.

===[[Файл:+.png]] Параметры эффекта для специальных шариков===
*'''Этими параметрами можно пользоваться вместо "параметры анимации для шарика"'''
*'''Тип специального шарика''' - тип специального шарика (лунка, колючка, снежинка, вредитель, шарик из двух половинок, камень, целевой шарик, хищник, призрак, шестеренка, туман, портал, целевой шарик призрак, огонь, молния, под огнем).
*'''Эффект''' - Машинка, которая будет получать события:
**'''beg''' - начало эффекта.
**'''hit''' - попадание (есть матч).
**'''miss''' - промах (нет матча).
**'''match_around''' - сматчились шарики рядом.
**'''shot''' - выстрел.
**'''destroy''' - уничтожение эффекта.
**'''end''' - окончание эффекта (вызывается после destroy).
*'''Смещение эффекта''' - смещение эффекта относительно шарика.
*'''Количество действий''' - количество действий (попаданий, выстрелов, промахов), после которых специальный шарик начнет некую обработку (например огонь перекинется на другой шарик).
*'''Действие''' - действие (нет, выстрел, попадание, промах).
*'''Задержка перед destroy''' - время перед уничтожением эффекта.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек. Возможные значения F - functionality в файле уровня:
**'''0''' - обычный шарик
**'''1''' - лунка (попавший в нее шарик "проваливается")
**'''2''' - колючка (попавший в нее шарик просто лопается и матч не просчитывается)
**'''3''' - снежинка (при попадании в нее или схлопывании шарика рядом тает и превращается в обычный шарик)
**'''4''' - вредитель (увеличит уровень залочки шарика на один; шарик выбирается по алгоритму закрашивания)
**'''5''' - шарик из двух половинок; при матче с одной половинкой шарик лопается
**'''6''' - камень (не матчится, не опадает, не двигается, от него отскакивают шарики)
**'''7''' - целевой шарик (когда все такие шарики убиваются или обваливаются, игра считается выиграна)
**'''8''' - хищник (съедает шарик; отличается от лунки наличием анимации и убиваемостью)
**'''9''' - призрак (то же, что и снежинка, но у снежинки цвет задан изначально, а призрак его обретает после матча)
**'''A''' - шестеренка (при попадании в нее начинает двигаться по горизонтали и убивать шарики на пути)
**'''B''' - туман (шар с туманом, при попадании туман пропадает на определенное количество действий)
**'''C''' - портал (имеет два входа-выхода, обозначенных цветом по контуру портала. При попадании шаром в один из входов-выходов, шар вылетает из другого, продолжая траекторию движения)
**'''D''' - целевой шарик призрак (сначала действует как призрак, потом как целевой шарик)
**'''E''' - огонь (при попадании шар воспломеняется. после определенного количество действий шар сгорает и "заражает" огнем соседний верхний шар)
**'''F''' - молния (при попадании лопает все шары по горизонтальной линии)
**'''16''' - замароженость
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Параметры анимации для шарика хищник===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика (уменьшение по скейлу).
*'''Время жизни''' - время жизни эффекта.
*'''Клип''' - анимация съедания шарика.

===[[Файл:+.png]] Параметры анимации для шарика шестеренка===
*'''Скорость''' - скорость движения.
*'''Клип влево''' - клип движения влево.
*'''Клип вправо''' - клип движения вправо.

===[[Файл:+.png]] Параметры анимации для залоченного шарика===
*'''Эффект''' - эффект.
*'''Задержка удаления эффекта''' - задержка удаления эффекта.

===[[Файл:+.png]] Параметры анимации для шарика туман===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика огонь===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''Эффект цели''' - эффект цели.
*'''Эффект цели - смещение''' - эффект цели - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика молния===
*'''Время жизни''' - время жизни эффекта.
*'''Эффект центральный''' - центральный эффект молнии.
*'''Эффект промежуточный''' - промежуточный эффект молнии.
*'''Эффект краевой''' - краевой эффект молнии.
*'''Звук''' - звук молнии.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.
*'''PredatorD''' - Расстояние в диаметрах между летящим шариком и хищником, при котором они взаимодействуют (0 - дефолтное взаимодействие).
*'''vel_bang_bubbles''' - Скорость разлетающихся шариков после взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

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

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

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

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

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

===[[Файл:+.png]] выбили цвет: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble.rar

=Пример реализации: задание уровня=

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

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter NEW

2017-12-14T11:56:34Z

Akovinenko: /* Добавляемые параметры */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

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

'''Merge'''
*'''макс. уровень (max_level)''' - место в опциях, где лежит макс. уровень.
*'''сага тэг (saga_tag)''' - место в опциях, где лежит вся информация по саге.
*'''классика очки (classic_score)''' - место в опциях, где лежат очки по классике.
*'''классика тэг (classic_tag)''' - место в опциях, где лежит вся информация по классике.

=Графика=
*'''цветной шарик 1 (res1)''' - графический ресурс шарика 1.
*'''фрейм шарика 1 (res1Frame)''' - Номер фрейма ресурса шарика 1.
*'''цветной шарик 2 (res2)''' - графический ресурс шарика 2.
*'''фрейм шарика 2 (res2Frame)''' - Номер фрейма ресурса шарика 2.
*'''цветной шарик 3 (res3)''' - графический ресурс шарика 3
*'''фрейм шарика 3 (res3Frame)''' - Номер фрейма ресурса шарика 3.
*'''цветной шарик 4 (res4)''' - графический ресурс шарика 4.
*'''фрейм шарика 4 (res4Frame)''' - Номер фрейма ресурса шарика 4.
*'''цветной шарик 5 (res5)''' - графический ресурс шарика 5.
*'''фрейм шарика 5 (res5Frame)''' - Номер фрейма ресурса шарика 5.
*'''цветной шарик 6 (res6)''' - графический ресурс шарика 6.
*'''фрейм шарика 6 (res6Frame)''' - Номер фрейма ресурса шарика 6.
*'''цветной шарик 7 (res7)''' - графический ресурс шарика 7.
*'''фрейм шарика 7 (res7Frame)''' - Номер фрейма ресурса шарика 7.
*'''цветной шарик 8 (res8)''' - графический ресурс шарика 8.
*'''фрейм шарика 8 (res8Frame)''' - Номер фрейма ресурса шарика 8.
*'''цветной шарик Y (resY)''' - графический ресурс цветного шарика.
*'''гвоздь (resZ)''' - графический ресурс гвоздя.
*'''целевой шарик 1 (rest1)''' - графический ресурс целевого шарика 1.
*'''фрейм шарика 1 (rest1Frame)''' - Номер фрейма ресурса целевого шарика 1.
*'''целевой шарик 2 (rest2)''' - графический ресурс целевого шарика 2.
*'''фрейм шарика 2 (rest2Frame)''' - Номер фрейма ресурса целевого шарика 2.
*'''целевой шарик 3 (rest3)''' - графический ресурс целевого шарика 3
*'''фрейм шарика 3 (rest3Frame)''' - Номер фрейма ресурса целевого шарика 3.
*'''целевой шарик 4 (rest4)''' - графический ресурс целевого шарика 4.
*'''фрейм шарика 4 (rest4Frame)''' - Номер фрейма ресурса целевого шарика 4.
*'''целевой шарик 5 (rest5)''' - графический ресурс целевого шарика 5.
*'''фрейм шарика 5 (rest5Frame)''' - Номер фрейма ресурса целевого шарика 5.
*'''целевой шарик 6 (rest6)''' - графический ресурс целевого шарика 6.
*'''фрейм шарика 6 (rest6Frame)''' - Номер фрейма ресурса целевого шарика 6.
*'''целевой шарик 7 (rest7)''' - графический ресурс целевого шарика 7.
*'''фрейм шарика 7 (rest7Frame)''' - Номер фрейма ресурса целевого шарика 7.
*'''целевой шарик 8 (rest8)''' - графический ресурс целевого шарика 8.
*'''фрейм шарика 8 (rest8Frame)''' - Номер фрейма ресурса целевого шарика 8.
*'''целевой шарик Y (restY)''' - графический ресурс целевого цветного шарика.
*'''маска залочки (res_lock_mask)''' - графический ресурс маски залочки.
*'''падающий шарик (res_drop_mask)''' - графический ресурс падающего шарика.
*'''лунка (resf1)''' - графический ресурс лунки.
*'''фрейм лунка (resf1Frame)''' - Номер фрейма ресурса лунки.
*'''колючка (resf2)''' - графический ресурс колючки.
*'''фрейм колючка (resf2Frame)''' - Номер фрейма ресурса колючки.
*'''снежинка (resf3)''' - графический ресурс снежинки.
*'''фрейм снежинка (resf3Frame)''' - Номер фрейма ресурса снежинки.
*'''вредитель (resf4)''' - графический ресурс вредителя.
*'''фрейм вредитель (resf4Frame)''' - Номер фрейма ресурса вредителя.
*'''половинки (resf5)''' - графический ресурс половинок.
*'''фрейм половинки (resf5Frame)''' - Номер фрейма ресурса половинок.
*'''камень (resf6)''' - графический ресурс камня.
*'''фрейм камень (resf6Frame)''' - Номер фрейма ресурса камня.
*'''хищник (resf8)''' - графический ресурс маски залочки.
*'''фрейм хищник (resf8Frame)''' - графический ресурс маски залочки.
*'''призрак (resf9)''' - графический ресурс призрака.
*'''фрейм призрак (resf9Frame)''' - Номер фрейма ресурса призрака.
*'''шестеренка (resf10)''' - графический ресурс шетеренки.
*'''фрейм шестеренка (resf10Frame)''' - Номер фрейма ресурса шестеренки.
*'''туман (resf11)''' - графический ресурс тумана.
*'''фрейм туман (resf11Frame)''' - Номер фрейма ресурса тумана.
*'''портал (resf12)''' - графический ресурс портала.
*'''фрейм портал (resf12Frame)''' - Номер фрейма ресурса портала.
*'''призрак-цель (resf13)''' - графический ресурс призрак-цель.
*'''фрейм призрак-цель (resf13Frame)''' - Номер фрейма ресурса призрак-цель.
*'''огонь (resf14)''' - графический ресурс огня.
*'''фрейм огонь (resf14Frame)''' - Номер фрейма ресурса огонь.
*'''молния (resf15)''' - графический ресурс молнии.
*'''фрейм молния (resf15Frame)''' - Номер фрейма ресурса молния.
*'''радужный шар (resrainbow)''' - графический ресурс радужного шара.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''drop''' - Звук осыпания.
*'''intro''' - Звук в начале игры.
*'''add row''' - Звук добавления ряда.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Звук взрыва бомбы мина.
*'''Взрыв бомбы ядро''' - Звук взрыва бомбы ядро.
*'''Взрыв бомбы цвет''' - Звук взрыва бомбы цвет.
*'''Бомба мульти цвет''' - Звук взыва бомбы мульти цвет.
*'''Закат в лунку''' - Звук заката в лунку.
*'''Взрыв колючкой''' - Звук взрыва колючкой.
*'''Таяние снежинки''' - Звук таяния снежинки.

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.

=Машины отображающие пушку=
*'''Первый шарик''' - машина, отображающая первый шарик.
*'''Второй шарик''' - машина, отображающая второй шарик.
*'''Третий шарик''' - машина, отображающая третий шарик.

'''Машины могут иметь состояния:'''
*'''shot''' - выстрел.
*'''shot_over''' - окончание выстрела.
*'''swap''' - смена шариков.
*'''swap_over''' - окончание смены шариков.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res (curres)''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Расстояние между шариками (distance)''' - Расстояние между шариками, от которого зависит их количество.
*'''Кол-во шариков в последней линии (last_line_count_bubs)''' - количество шариков, которе будет в последней линии курсора.
*'''Отражения (curlns)''' - максимальное кол-во отражений от стенок.
*'''Коэффициент (curkoef)''' - коэффициент ds/s, где s - базовое расстояние между шариками, ds - его наращивание.
*'''минимальный скейл (curminsc)''' - минимальный скейл графики шариков
*'''максимальный скейл (curmaxsc)''' - максимальный скейл графики шариков
*'''время скалирования (cursctm)''' - время скалирования шариков

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего шарика (x,y)''' - Позиция стреляющего шарика (x,y)
*'''Позиция следующего шарика (x,y)''' - Позиция следующего шарика (x,y).
*'''Позиция 3-го шарика (x,y)''' - Позиция 3-го шарика (x,y).
*'''третий шарик (n3bub)''' - если 0 - 3-го шарика не будет, 1 - есть третий шарик.
*'''Коэффициент вероятности цветов''' - коэффициент вероятности цветов.
*'''Расстояние от следующего шарика''' - расстояние от следующего шарика.
*'''Скорость наезда для режима Bubblez''' - скорость наезда для режима Bubblez.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Скейл шариков для снукера''' - скейл шариков для снукера.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления рядов''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Color mapping''' - Color mapping включён (0 - нет, 1 - да).
*'''Тип рандома''' - Тип рандома. Простой - берём случайный из всех цветов, Супер Рандом - супер алгоритм, Из набора - формируем набор из n шариков и перемешиваем.
*'''Количество цвета для набора''' - количество цвета для формирования набора в рандоме (касается типа рандома "Из набора").
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''Файл трекинга''' - Файл трекинга формата .xml.
*'''Таблица трекинга''' - Таблица трекинга.
*'''Объект новых шариков''' - Объект, которому сообщается о новых шариках.
*'''Мувер''' - Объект, двигающий баббл шутер.
*'''Задержка перед броском''' - задержка перед броском.
*'''Задержка перед обрывом шариков''' - задержка перед обрывом шариков.
*'''К-во секторов для броска''' - Количество секторов для броска.
*'''Слушатель движения мыши''' - объект, слушатель движения мыши.
*'''Слушатель броска''' - объект, слушатель броска. По сути вызывается только состояние st1.
*'''Слушатель движения поля''' - объект, слушатель движения поля. Должен иметь состояния move (поле двигается) и move_over (окончание движения поля).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''Феерверк после победы''' - Включить феерверк из шариков сразу после победы (0 - нет, 1 - да).

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

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

===[[Файл:+.png]] Визцализатор целей===
*'''Заглушки''' - заглушки.
*'''Индикаторы''' - индикаторы.
*'''Каунтеры''' - каунтеры.

===[[Файл:+.png]] Параметры эффекта для специальных шариков===
*'''Этими параметрами можно пользоваться вместо "параметры анимации для шарика"'''
*'''Тип специального шарика''' - тип специального шарика (лунка, колючка, снежинка, вредитель, шарик из двух половинок, камень, целевой шарик, хищник, призрак, шестеренка, туман, портал, целевой шарик призрак, огонь, молния, под огнем).
*'''Эффект''' - Машинка, которая будет получать события:
**'''beg''' - начало эффекта.
**'''hit''' - попадание (есть матч).
**'''miss''' - промах (нет матча).
**'''match_around''' - сматчились шарики рядом.
**'''shot''' - выстрел.
**'''destroy''' - уничтожение эффекта.
**'''end''' - окончание эффекта (вызывается после destroy).
*'''Смещение эффекта''' - смещение эффекта относительно шарика.
*'''Количество действий''' - количество действий (попаданий, выстрелов, промахов), после которых специальный шарик начнет некую обработку (например огонь перекинется на другой шарик).
*'''Действие''' - действие (нет, выстрел, попадание, промах).
*'''Задержка перед destroy''' - время перед уничтожением эффекта.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Параметры анимации для шарика хищник===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика (уменьшение по скейлу).
*'''Время жизни''' - время жизни эффекта.
*'''Клип''' - анимация съедания шарика.

===[[Файл:+.png]] Параметры анимации для шарика шестеренка===
*'''Скорость''' - скорость движения.
*'''Клип влево''' - клип движения влево.
*'''Клип вправо''' - клип движения вправо.

===[[Файл:+.png]] Параметры анимации для залоченного шарика===
*'''Эффект''' - эффект.
*'''Задержка удаления эффекта''' - задержка удаления эффекта.

===[[Файл:+.png]] Параметры анимации для шарика туман===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика огонь===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''Эффект цели''' - эффект цели.
*'''Эффект цели - смещение''' - эффект цели - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика молния===
*'''Время жизни''' - время жизни эффекта.
*'''Эффект центральный''' - центральный эффект молнии.
*'''Эффект промежуточный''' - промежуточный эффект молнии.
*'''Эффект краевой''' - краевой эффект молнии.
*'''Звук''' - звук молнии.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.
*'''PredatorD''' - Расстояние в диаметрах между летящим шариком и хищником, при котором они взаимодействуют (0 - дефолтное взаимодействие).
*'''vel_bang_bubbles''' - Скорость разлетающихся шариков после взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

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

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

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

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

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

===[[Файл:+.png]] выбили цвет: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble.rar

=Пример реализации: задание уровня=

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

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter NEW

2017-12-14T11:05:33Z

Akovinenko:

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

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

'''Merge'''
*'''макс. уровень (max_level)''' - место в опциях, где лежит макс. уровень.
*'''сага тэг (saga_tag)''' - место в опциях, где лежит вся информация по саге.
*'''классика очки (classic_score)''' - место в опциях, где лежат очки по классике.
*'''классика тэг (classic_tag)''' - место в опциях, где лежит вся информация по классике.

=Графика=
*'''цветной шарик 1 (res1)''' - графический ресурс шарика 1.
*'''фрейм шарика 1 (res1Frame)''' - Номер фрейма ресурса шарика 1.
*'''цветной шарик 2 (res2)''' - графический ресурс шарика 2.
*'''фрейм шарика 2 (res2Frame)''' - Номер фрейма ресурса шарика 2.
*'''цветной шарик 3 (res3)''' - графический ресурс шарика 3
*'''фрейм шарика 3 (res3Frame)''' - Номер фрейма ресурса шарика 3.
*'''цветной шарик 4 (res4)''' - графический ресурс шарика 4.
*'''фрейм шарика 4 (res4Frame)''' - Номер фрейма ресурса шарика 4.
*'''цветной шарик 5 (res5)''' - графический ресурс шарика 5.
*'''фрейм шарика 5 (res5Frame)''' - Номер фрейма ресурса шарика 5.
*'''цветной шарик 6 (res6)''' - графический ресурс шарика 6.
*'''фрейм шарика 6 (res6Frame)''' - Номер фрейма ресурса шарика 6.
*'''цветной шарик 7 (res7)''' - графический ресурс шарика 7.
*'''фрейм шарика 7 (res7Frame)''' - Номер фрейма ресурса шарика 7.
*'''цветной шарик 8 (res8)''' - графический ресурс шарика 8.
*'''фрейм шарика 8 (res8Frame)''' - Номер фрейма ресурса шарика 8.
*'''цветной шарик Y (resY)''' - графический ресурс цветного шарика.
*'''гвоздь (resZ)''' - графический ресурс гвоздя.
*'''целевой шарик 1 (rest1)''' - графический ресурс целевого шарика 1.
*'''фрейм шарика 1 (rest1Frame)''' - Номер фрейма ресурса целевого шарика 1.
*'''целевой шарик 2 (rest2)''' - графический ресурс целевого шарика 2.
*'''фрейм шарика 2 (rest2Frame)''' - Номер фрейма ресурса целевого шарика 2.
*'''целевой шарик 3 (rest3)''' - графический ресурс целевого шарика 3
*'''фрейм шарика 3 (rest3Frame)''' - Номер фрейма ресурса целевого шарика 3.
*'''целевой шарик 4 (rest4)''' - графический ресурс целевого шарика 4.
*'''фрейм шарика 4 (rest4Frame)''' - Номер фрейма ресурса целевого шарика 4.
*'''целевой шарик 5 (rest5)''' - графический ресурс целевого шарика 5.
*'''фрейм шарика 5 (rest5Frame)''' - Номер фрейма ресурса целевого шарика 5.
*'''целевой шарик 6 (rest6)''' - графический ресурс целевого шарика 6.
*'''фрейм шарика 6 (rest6Frame)''' - Номер фрейма ресурса целевого шарика 6.
*'''целевой шарик 7 (rest7)''' - графический ресурс целевого шарика 7.
*'''фрейм шарика 7 (rest7Frame)''' - Номер фрейма ресурса целевого шарика 7.
*'''целевой шарик 8 (rest8)''' - графический ресурс целевого шарика 8.
*'''фрейм шарика 8 (rest8Frame)''' - Номер фрейма ресурса целевого шарика 8.
*'''целевой шарик Y (restY)''' - графический ресурс целевого цветного шарика.
*'''маска залочки (res_lock_mask)''' - графический ресурс маски залочки.
*'''падающий шарик (res_drop_mask)''' - графический ресурс падающего шарика.
*'''лунка (resf1)''' - графический ресурс лунки.
*'''фрейм лунка (resf1Frame)''' - Номер фрейма ресурса лунки.
*'''колючка (resf2)''' - графический ресурс колючки.
*'''фрейм колючка (resf2Frame)''' - Номер фрейма ресурса колючки.
*'''снежинка (resf3)''' - графический ресурс снежинки.
*'''фрейм снежинка (resf3Frame)''' - Номер фрейма ресурса снежинки.
*'''вредитель (resf4)''' - графический ресурс вредителя.
*'''фрейм вредитель (resf4Frame)''' - Номер фрейма ресурса вредителя.
*'''половинки (resf5)''' - графический ресурс половинок.
*'''фрейм половинки (resf5Frame)''' - Номер фрейма ресурса половинок.
*'''камень (resf6)''' - графический ресурс камня.
*'''фрейм камень (resf6Frame)''' - Номер фрейма ресурса камня.
*'''хищник (resf8)''' - графический ресурс маски залочки.
*'''фрейм хищник (resf8Frame)''' - графический ресурс маски залочки.
*'''призрак (resf9)''' - графический ресурс призрака.
*'''фрейм призрак (resf9Frame)''' - Номер фрейма ресурса призрака.
*'''шестеренка (resf10)''' - графический ресурс шетеренки.
*'''фрейм шестеренка (resf10Frame)''' - Номер фрейма ресурса шестеренки.
*'''туман (resf11)''' - графический ресурс тумана.
*'''фрейм туман (resf11Frame)''' - Номер фрейма ресурса тумана.
*'''портал (resf12)''' - графический ресурс портала.
*'''фрейм портал (resf12Frame)''' - Номер фрейма ресурса портала.
*'''призрак-цель (resf13)''' - графический ресурс призрак-цель.
*'''фрейм призрак-цель (resf13Frame)''' - Номер фрейма ресурса призрак-цель.
*'''огонь (resf14)''' - графический ресурс огня.
*'''фрейм огонь (resf14Frame)''' - Номер фрейма ресурса огонь.
*'''молния (resf15)''' - графический ресурс молнии.
*'''фрейм молния (resf15Frame)''' - Номер фрейма ресурса молния.
*'''радужный шар (resrainbow)''' - графический ресурс радужного шара.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''drop''' - Звук осыпания.
*'''intro''' - Звук в начале игры.
*'''add row''' - Звук добавления ряда.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Звук взрыва бомбы мина.
*'''Взрыв бомбы ядро''' - Звук взрыва бомбы ядро.
*'''Взрыв бомбы цвет''' - Звук взрыва бомбы цвет.
*'''Бомба мульти цвет''' - Звук взыва бомбы мульти цвет.
*'''Закат в лунку''' - Звук заката в лунку.
*'''Взрыв колючкой''' - Звук взрыва колючкой.
*'''Таяние снежинки''' - Звук таяния снежинки.

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.

=Машины отображающие пушку=
*'''Первый шарик''' - машина, отображающая первый шарик.
*'''Второй шарик''' - машина, отображающая второй шарик.
*'''Третий шарик''' - машина, отображающая третий шарик.

'''Машины могут иметь состояния:'''
*'''shot''' - выстрел.
*'''shot_over''' - окончание выстрела.
*'''swap''' - смена шариков.
*'''swap_over''' - окончание смены шариков.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res (curres)''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Расстояние между шариками (distance)''' - Расстояние между шариками, от которого зависит их количество.
*'''Кол-во шариков в последней линии (last_line_count_bubs)''' - количество шариков, которе будет в последней линии курсора.
*'''Отражения (curlns)''' - максимальное кол-во отражений от стенок.
*'''Коэффициент (curkoef)''' - коэффициент ds/s, где s - базовое расстояние между шариками, ds - его наращивание.
*'''минимальный скейл (curminsc)''' - минимальный скейл графики шариков
*'''максимальный скейл (curmaxsc)''' - максимальный скейл графики шариков
*'''время скалирования (cursctm)''' - время скалирования шариков

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего шарика (x,y)''' - Позиция стреляющего шарика (x,y)
*'''Позиция следующего шарика (x,y)''' - Позиция следующего шарика (x,y).
*'''Позиция 3-го шарика (x,y)''' - Позиция 3-го шарика (x,y).
*'''третий шарик (n3bub)''' - если 0 - 3-го шарика не будет, 1 - есть третий шарик.
*'''Коэффициент вероятности цветов''' - коэффициент вероятности цветов.
*'''Расстояние от следующего шарика''' - расстояние от следующего шарика.
*'''Скорость наезда для режима Bubblez''' - скорость наезда для режима Bubblez.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Скейл шариков для снукера''' - скейл шариков для снукера.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления рядов''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Color mapping''' - Color mapping включён (0 - нет, 1 - да).
*'''Тип рандома''' - Тип рандома. Простой - берём случайный из всех цветов, Супер Рандом - супер алгоритм, Из набора - формируем набор из n шариков и перемешиваем.
*'''Количество цвета для набора''' - количество цвета для формирования набора в рандоме (касается типа рандома "Из набора").
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''Файл трекинга''' - Файл трекинга формата .xml.
*'''Таблица трекинга''' - Таблица трекинга.
*'''Объект новых шариков''' - Объект, которому сообщается о новых шариках.
*'''Мувер''' - Объект, двигающий баббл шутер.
*'''Задержка перед броском''' - задержка перед броском.
*'''Задержка перед обрывом шариков''' - задержка перед обрывом шариков.
*'''К-во секторов для броска''' - Количество секторов для броска.
*'''Слушатель движения мыши''' - объект, слушатель движения мыши.
*'''Слушатель броска''' - объект, слушатель броска. По сути вызывается только состояние st1.
*'''Слушатель движения поля''' - объект, слушатель движения поля. Должен иметь состояния move (поле двигается) и move_over (окончание движения поля).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''Феерверк после победы''' - Включить феерверк из шариков сразу после победы (0 - нет, 1 - да).

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

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

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Параметры анимации для шарика хищник===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика (уменьшение по скейлу).
*'''Время жизни''' - время жизни эффекта.
*'''Клип''' - анимация съедания шарика.

===[[Файл:+.png]] Параметры анимации для шарика шестеренка===
*'''Скорость''' - скорость движения.
*'''Клип влево''' - клип движения влево.
*'''Клип вправо''' - клип движения вправо.

===[[Файл:+.png]] Параметры анимации для залоченного шарика===
*'''Эффект''' - эффект.
*'''Задержка удаления эффекта''' - задержка удаления эффекта.

===[[Файл:+.png]] Параметры анимации для шарика туман===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика огонь===
*'''Эффект''' - эффект.
*'''Эффект - смещение''' - эффект - смещение.
*'''Каунтер''' - каунтер.
*'''Каунтер - смещение''' - каунтер - смещение.
*'''Эффект цели''' - эффект цели.
*'''Эффект цели - смещение''' - эффект цели - смещение.
*'''num''' - num.
*'''Клип''' - клип.

===[[Файл:+.png]] Параметры анимации для шарика молния===
*'''Время жизни''' - время жизни эффекта.
*'''Эффект центральный''' - центральный эффект молнии.
*'''Эффект промежуточный''' - промежуточный эффект молнии.
*'''Эффект краевой''' - краевой эффект молнии.
*'''Звук''' - звук молнии.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.
*'''PredatorD''' - Расстояние в диаметрах между летящим шариком и хищником, при котором они взаимодействуют (0 - дефолтное взаимодействие).
*'''vel_bang_bubbles''' - Скорость разлетающихся шариков после взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

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

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

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

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

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

===[[Файл:+.png]] выбили цвет: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble.rar

=Пример реализации: задание уровня=

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

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter NEW

2017-12-14T08:45:24Z

Akovinenko: /* Файл:+.png Физика */

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

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

'''Merge'''
*'''макс. уровень (max_level)''' - место в опциях, где лежит макс. уровень.
*'''сага тэг (saga_tag)''' - место в опциях, где лежит вся информация по саге.
*'''классика очки (classic_score)''' - место в опциях, где лежат очки по классике.
*'''классика тэг (classic_tag)''' - место в опциях, где лежит вся информация по классике.

=Графика=
*'''цветной шарик 1 (res1)''' - графический ресурс шарика 1.
*'''фрейм шарика 1 (res1Frame)''' - Номер фрейма ресурса шарика 1.
*'''цветной шарик 2 (res2)''' - графический ресурс шарика 2.
*'''фрейм шарика 2 (res2Frame)''' - Номер фрейма ресурса шарика 2.
*'''цветной шарик 3 (res3)''' - графический ресурс шарика 3
*'''фрейм шарика 3 (res3Frame)''' - Номер фрейма ресурса шарика 3.
*'''цветной шарик 4 (res4)''' - графический ресурс шарика 4.
*'''фрейм шарика 4 (res4Frame)''' - Номер фрейма ресурса шарика 4.
*'''цветной шарик 5 (res5)''' - графический ресурс шарика 5.
*'''фрейм шарика 5 (res5Frame)''' - Номер фрейма ресурса шарика 5.
*'''цветной шарик 6 (res6)''' - графический ресурс шарика 6.
*'''фрейм шарика 6 (res6Frame)''' - Номер фрейма ресурса шарика 6.
*'''цветной шарик 7 (res7)''' - графический ресурс шарика 7.
*'''фрейм шарика 7 (res7Frame)''' - Номер фрейма ресурса шарика 7.
*'''цветной шарик 8 (res8)''' - графический ресурс шарика 8.
*'''фрейм шарика 8 (res8Frame)''' - Номер фрейма ресурса шарика 8.
*'''цветной шарик Y (resY)''' - графический ресурс цветного шарика.
*'''гвоздь (resZ)''' - графический ресурс гвоздя.
*'''целевой шарик 1 (rest1)''' - графический ресурс целевого шарика 1.
*'''фрейм шарика 1 (rest1Frame)''' - Номер фрейма ресурса целевого шарика 1.
*'''целевой шарик 2 (rest2)''' - графический ресурс целевого шарика 2.
*'''фрейм шарика 2 (rest2Frame)''' - Номер фрейма ресурса целевого шарика 2.
*'''целевой шарик 3 (rest3)''' - графический ресурс целевого шарика 3
*'''фрейм шарика 3 (rest3Frame)''' - Номер фрейма ресурса целевого шарика 3.
*'''целевой шарик 4 (rest4)''' - графический ресурс целевого шарика 4.
*'''фрейм шарика 4 (rest4Frame)''' - Номер фрейма ресурса целевого шарика 4.
*'''целевой шарик 5 (rest5)''' - графический ресурс целевого шарика 5.
*'''фрейм шарика 5 (rest5Frame)''' - Номер фрейма ресурса целевого шарика 5.
*'''целевой шарик 6 (rest6)''' - графический ресурс целевого шарика 6.
*'''фрейм шарика 6 (rest6Frame)''' - Номер фрейма ресурса целевого шарика 6.
*'''целевой шарик 7 (rest7)''' - графический ресурс целевого шарика 7.
*'''фрейм шарика 7 (rest7Frame)''' - Номер фрейма ресурса целевого шарика 7.
*'''целевой шарик 8 (rest8)''' - графический ресурс целевого шарика 8.
*'''фрейм шарика 8 (rest8Frame)''' - Номер фрейма ресурса целевого шарика 8.
*'''целевой шарик Y (restY)''' - графический ресурс целевого цветного шарика.
*'''маска залочки (res_lock_mask)''' - графический ресурс маски залочки.
*'''падающий шарик (res_drop_mask)''' - графический ресурс падающего шарика.
*'''лунка (resf1)''' - графический ресурс лунки.
*'''фрейм лунка (resf1Frame)''' - Номер фрейма ресурса лунки.
*'''колючка (resf2)''' - графический ресурс колючки.
*'''фрейм колючка (resf2Frame)''' - Номер фрейма ресурса колючки.
*'''снежинка (resf3)''' - графический ресурс снежинки.
*'''фрейм снежинка (resf3Frame)''' - Номер фрейма ресурса снежинки.
*'''вредитель (resf4)''' - графический ресурс вредителя.
*'''фрейм вредитель (resf4Frame)''' - Номер фрейма ресурса вредителя.
*'''половинки (resf5)''' - графический ресурс половинок.
*'''фрейм половинки (resf5Frame)''' - Номер фрейма ресурса половинок.
*'''камень (resf6)''' - графический ресурс камня.
*'''фрейм камень (resf6Frame)''' - Номер фрейма ресурса камня.
*'''хищник (resf8)''' - графический ресурс маски залочки.
*'''фрейм хищник (resf8Frame)''' - графический ресурс маски залочки.
*'''призрак (resf9)''' - графический ресурс призрака.
*'''фрейм призрак (resf9Frame)''' - Номер фрейма ресурса призрака.
*'''шестеренка (resf10)''' - графический ресурс шетеренки.
*'''фрейм шестеренка (resf10Frame)''' - Номер фрейма ресурса шестеренки.
*'''туман (resf11)''' - графический ресурс тумана.
*'''фрейм туман (resf11Frame)''' - Номер фрейма ресурса тумана.
*'''портал (resf12)''' - графический ресурс портала.
*'''фрейм портал (resf12Frame)''' - Номер фрейма ресурса портала.
*'''призрак-цель (resf13)''' - графический ресурс призрак-цель.
*'''фрейм призрак-цель (resf13Frame)''' - Номер фрейма ресурса призрак-цель.
*'''огонь (resf14)''' - графический ресурс огня.
*'''фрейм огонь (resf14Frame)''' - Номер фрейма ресурса огонь.
*'''молния (resf15)''' - графический ресурс молнии.
*'''фрейм молния (resf15Frame)''' - Номер фрейма ресурса молния.
*'''радужный шар (resrainbow)''' - графический ресурс радужного шара.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''drop''' - Звук осыпания.
*'''intro''' - Звук в начале игры.
*'''add row''' - Звук добавления ряда.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Звук взрыва бомбы мина.
*'''Взрыв бомбы ядро''' - Звук взрыва бомбы ядро.
*'''Взрыв бомбы цвет''' - Звук взрыва бомбы цвет.
*'''Бомба мульти цвет''' - Звук взыва бомбы мульти цвет.
*'''Закат в лунку''' - Звук заката в лунку.
*'''Взрыв колючкой''' - Звук взрыва колючкой.
*'''Таяние снежинки''' - Звук таяния снежинки.

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.

=Машины отображающие пушку=
*'''Первый шарик''' - машина, отображающая первый шарик.
*'''Второй шарик''' - машина, отображающая второй шарик.
*'''Третий шарик''' - машина, отображающая третий шарик.

'''Машины могут иметь состояния:'''
*'''shot''' - выстрел.
*'''shot_over''' - окончание выстрела.
*'''swap''' - смена шариков.
*'''swap_over''' - окончание смены шариков.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res (curres)''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Расстояние между шариками (distance)''' - Расстояние между шариками, от которого зависит их количество.
*'''Кол-во шариков в последней линии (last_line_count_bubs)''' - количество шариков, которе будет в последней линии курсора.
*'''Отражения (curlns)''' - максимальное кол-во отражений от стенок.
*'''Коэффициент (curkoef)''' - коэффициент ds/s, где s - базовое расстояние между шариками, ds - его наращивание.
*'''минимальный скейл (curminsc)''' - минимальный скейл графики шариков
*'''максимальный скейл (curmaxsc)''' - максимальный скейл графики шариков
*'''время скалирования (cursctm)''' - время скалирования шариков

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего шарика (x,y)''' - Позиция стреляющего шарика (x,y)
*'''Позиция следующего шарика (x,y)''' - Позиция следующего шарика (x,y).
*'''Позиция 3-го шарика (x,y)''' - Позиция 3-го шарика (x,y).
*'''третий шарик (n3bub)''' - если 0 - 3-го шарика не будет, 1 - есть третий шарик.
*'''Коэффициент вероятности цветов''' - коэффициент вероятности цветов.
*'''Расстояние от следующего шарика''' - расстояние от следующего шарика.
*'''Скорость наезда для режима Bubblez''' - скорость наезда для режима Bubblez.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Скейл шариков для снукера''' - скейл шариков для снукера.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления рядов''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Color mapping''' - Color mapping включён (0 - нет, 1 - да).
*'''Тип рандома''' - Тип рандома. Простой - берём случайный из всех цветов, Супер Рандом - супер алгоритм, Из набора - формируем набор из n шариков и перемешиваем.
*'''Количество цвета для набора''' - количество цвета для формирования набора в рандоме (касается типа рандома "Из набора").
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''Файл трекинга''' - Файл трекинга формата .xml.
*'''Таблица трекинга''' - Таблица трекинга.
*'''Объект новых шариков''' - Объект, которому сообщается о новых шариках.
*'''Мувер''' - Объект, двигающий баббл шутер.
*'''Задержка перед броском''' - задержка перед броском.
*'''Задержка перед обрывом шариков''' - задержка перед обрывом шариков.
*'''К-во секторов для броска''' - Количество секторов для броска.
*'''Слушатель движения мыши''' - объект, слушатель движения мыши.
*'''Слушатель броска''' - объект, слушатель броска. По сути вызывается только состояние st1.
*'''Слушатель движения поля''' - объект, слушатель движения поля. Должен иметь состояния move (поле двигается) и move_over (окончание движения поля).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''Феерверк после победы''' - Включить феерверк из шариков сразу после победы (0 - нет, 1 - да).

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

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

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.
*'''PredatorD''' - Расстояние в диаметрах между летящим шариком и хищником, при котором они взаимодействуют (0 - дефолтное взаимодействие).
*'''vel_bang_bubbles''' - Скорость разлетающихся шариков после взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

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

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

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

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

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

===[[Файл:+.png]] выбили цвет: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble.rar

=Пример реализации: задание уровня=

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

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter NEW

2017-12-13T15:26:37Z

Akovinenko:

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

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

'''Merge'''
*'''макс. уровень (max_level)''' - место в опциях, где лежит макс. уровень.
*'''сага тэг (saga_tag)''' - место в опциях, где лежит вся информация по саге.
*'''классика очки (classic_score)''' - место в опциях, где лежат очки по классике.
*'''классика тэг (classic_tag)''' - место в опциях, где лежит вся информация по классике.

=Графика=
*'''цветной шарик 1 (res1)''' - графический ресурс шарика 1.
*'''фрейм шарика 1 (res1Frame)''' - Номер фрейма ресурса шарика 1.
*'''цветной шарик 2 (res2)''' - графический ресурс шарика 2.
*'''фрейм шарика 2 (res2Frame)''' - Номер фрейма ресурса шарика 2.
*'''цветной шарик 3 (res3)''' - графический ресурс шарика 3
*'''фрейм шарика 3 (res3Frame)''' - Номер фрейма ресурса шарика 3.
*'''цветной шарик 4 (res4)''' - графический ресурс шарика 4.
*'''фрейм шарика 4 (res4Frame)''' - Номер фрейма ресурса шарика 4.
*'''цветной шарик 5 (res5)''' - графический ресурс шарика 5.
*'''фрейм шарика 5 (res5Frame)''' - Номер фрейма ресурса шарика 5.
*'''цветной шарик 6 (res6)''' - графический ресурс шарика 6.
*'''фрейм шарика 6 (res6Frame)''' - Номер фрейма ресурса шарика 6.
*'''цветной шарик 7 (res7)''' - графический ресурс шарика 7.
*'''фрейм шарика 7 (res7Frame)''' - Номер фрейма ресурса шарика 7.
*'''цветной шарик 8 (res8)''' - графический ресурс шарика 8.
*'''фрейм шарика 8 (res8Frame)''' - Номер фрейма ресурса шарика 8.
*'''цветной шарик Y (resY)''' - графический ресурс цветного шарика.
*'''гвоздь (resZ)''' - графический ресурс гвоздя.
*'''целевой шарик 1 (rest1)''' - графический ресурс целевого шарика 1.
*'''фрейм шарика 1 (rest1Frame)''' - Номер фрейма ресурса целевого шарика 1.
*'''целевой шарик 2 (rest2)''' - графический ресурс целевого шарика 2.
*'''фрейм шарика 2 (rest2Frame)''' - Номер фрейма ресурса целевого шарика 2.
*'''целевой шарик 3 (rest3)''' - графический ресурс целевого шарика 3
*'''фрейм шарика 3 (rest3Frame)''' - Номер фрейма ресурса целевого шарика 3.
*'''целевой шарик 4 (rest4)''' - графический ресурс целевого шарика 4.
*'''фрейм шарика 4 (rest4Frame)''' - Номер фрейма ресурса целевого шарика 4.
*'''целевой шарик 5 (rest5)''' - графический ресурс целевого шарика 5.
*'''фрейм шарика 5 (rest5Frame)''' - Номер фрейма ресурса целевого шарика 5.
*'''целевой шарик 6 (rest6)''' - графический ресурс целевого шарика 6.
*'''фрейм шарика 6 (rest6Frame)''' - Номер фрейма ресурса целевого шарика 6.
*'''целевой шарик 7 (rest7)''' - графический ресурс целевого шарика 7.
*'''фрейм шарика 7 (rest7Frame)''' - Номер фрейма ресурса целевого шарика 7.
*'''целевой шарик 8 (rest8)''' - графический ресурс целевого шарика 8.
*'''фрейм шарика 8 (rest8Frame)''' - Номер фрейма ресурса целевого шарика 8.
*'''целевой шарик Y (restY)''' - графический ресурс целевого цветного шарика.
*'''маска залочки (res_lock_mask)''' - графический ресурс маски залочки.
*'''падающий шарик (res_drop_mask)''' - графический ресурс падающего шарика.
*'''лунка (resf1)''' - графический ресурс лунки.
*'''фрейм лунка (resf1Frame)''' - Номер фрейма ресурса лунки.
*'''колючка (resf2)''' - графический ресурс колючки.
*'''фрейм колючка (resf2Frame)''' - Номер фрейма ресурса колючки.
*'''снежинка (resf3)''' - графический ресурс снежинки.
*'''фрейм снежинка (resf3Frame)''' - Номер фрейма ресурса снежинки.
*'''вредитель (resf4)''' - графический ресурс вредителя.
*'''фрейм вредитель (resf4Frame)''' - Номер фрейма ресурса вредителя.
*'''половинки (resf5)''' - графический ресурс половинок.
*'''фрейм половинки (resf5Frame)''' - Номер фрейма ресурса половинок.
*'''камень (resf6)''' - графический ресурс камня.
*'''фрейм камень (resf6Frame)''' - Номер фрейма ресурса камня.
*'''хищник (resf8)''' - графический ресурс маски залочки.
*'''фрейм хищник (resf8Frame)''' - графический ресурс маски залочки.
*'''призрак (resf9)''' - графический ресурс призрака.
*'''фрейм призрак (resf9Frame)''' - Номер фрейма ресурса призрака.
*'''шестеренка (resf10)''' - графический ресурс шетеренки.
*'''фрейм шестеренка (resf10Frame)''' - Номер фрейма ресурса шестеренки.
*'''туман (resf11)''' - графический ресурс тумана.
*'''фрейм туман (resf11Frame)''' - Номер фрейма ресурса тумана.
*'''портал (resf12)''' - графический ресурс портала.
*'''фрейм портал (resf12Frame)''' - Номер фрейма ресурса портала.
*'''призрак-цель (resf13)''' - графический ресурс призрак-цель.
*'''фрейм призрак-цель (resf13Frame)''' - Номер фрейма ресурса призрак-цель.
*'''огонь (resf14)''' - графический ресурс огня.
*'''фрейм огонь (resf14Frame)''' - Номер фрейма ресурса огонь.
*'''молния (resf15)''' - графический ресурс молнии.
*'''фрейм молния (resf15Frame)''' - Номер фрейма ресурса молния.
*'''радужный шар (resrainbow)''' - графический ресурс радужного шара.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''drop''' - Звук осыпания.
*'''intro''' - Звук в начале игры.
*'''add row''' - Звук добавления ряда.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Звук взрыва бомбы мина.
*'''Взрыв бомбы ядро''' - Звук взрыва бомбы ядро.
*'''Взрыв бомбы цвет''' - Звук взрыва бомбы цвет.
*'''Бомба мульти цвет''' - Звук взыва бомбы мульти цвет.
*'''Закат в лунку''' - Звук заката в лунку.
*'''Взрыв колючкой''' - Звук взрыва колючкой.
*'''Таяние снежинки''' - Звук таяния снежинки.

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.

=Машины отображающие пушку=
*'''Первый шарик''' - машина, отображающая первый шарик.
*'''Второй шарик''' - машина, отображающая второй шарик.
*'''Третий шарик''' - машина, отображающая третий шарик.

'''Машины могут иметь состояния:'''
*'''shot''' - выстрел.
*'''shot_over''' - окончание выстрела.
*'''swap''' - смена шариков.
*'''swap_over''' - окончание смены шариков.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res (curres)''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Расстояние между шариками (distance)''' - Расстояние между шариками, от которого зависит их количество.
*'''Кол-во шариков в последней линии (last_line_count_bubs)''' - количество шариков, которе будет в последней линии курсора.
*'''Отражения (curlns)''' - максимальное кол-во отражений от стенок.
*'''Коэффициент (curkoef)''' - коэффициент ds/s, где s - базовое расстояние между шариками, ds - его наращивание.
*'''минимальный скейл (curminsc)''' - минимальный скейл графики шариков
*'''максимальный скейл (curmaxsc)''' - максимальный скейл графики шариков
*'''время скалирования (cursctm)''' - время скалирования шариков

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего шарика (x,y)''' - Позиция стреляющего шарика (x,y)
*'''Позиция следующего шарика (x,y)''' - Позиция следующего шарика (x,y).
*'''Позиция 3-го шарика (x,y)''' - Позиция 3-го шарика (x,y).
*'''третий шарик (n3bub)''' - если 0 - 3-го шарика не будет, 1 - есть третий шарик.
*'''Коэффициент вероятности цветов''' - коэффициент вероятности цветов.
*'''Расстояние от следующего шарика''' - расстояние от следующего шарика.
*'''Скорость наезда для режима Bubblez''' - скорость наезда для режима Bubblez.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Скейл шариков для снукера''' - скейл шариков для снукера.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления рядов''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Color mapping''' - Color mapping включён (0 - нет, 1 - да).
*'''Тип рандома''' - Тип рандома. Простой - берём случайный из всех цветов, Супер Рандом - супер алгоритм, Из набора - формируем набор из n шариков и перемешиваем.
*'''Количество цвета для набора''' - количество цвета для формирования набора в рандоме (касается типа рандома "Из набора").
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''Файл трекинга''' - Файл трекинга формата .xml.
*'''Таблица трекинга''' - Таблица трекинга.
*'''Объект новых шариков''' - Объект, которому сообщается о новых шариках.
*'''Мувер''' - Объект, двигающий баббл шутер.
*'''Задержка перед броском''' - задержка перед броском.
*'''Задержка перед обрывом шариков''' - задержка перед обрывом шариков.
*'''К-во секторов для броска''' - Количество секторов для броска.
*'''Слушатель движения мыши''' - объект, слушатель движения мыши.
*'''Слушатель броска''' - объект, слушатель броска. По сути вызывается только состояние st1.
*'''Слушатель движения поля''' - объект, слушатель движения поля. Должен иметь состояния move (поле двигается) и move_over (окончание движения поля).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''Феерверк после победы''' - Включить феерверк из шариков сразу после победы (0 - нет, 1 - да).

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

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

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

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

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

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

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

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

===[[Файл:+.png]] выбили цвет: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble.rar

=Пример реализации: задание уровня=

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

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]

Bubble Shooter NEW

2017-12-13T15:25:43Z

Akovinenko:

{{TOC right}}
Игровая механика BubbleShooter.

=BubbleShooter Setup=
'''Общие настройки'''
*''' память''' - (memo) Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
*'''res''' - графичесий ресурс поля для игры. Его размер является зоной для тапа.
*'''Слушатель''' - объект типа Matchbattle.

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

'''Merge'''
*'''макс. уровень (max_level)''' - место в опциях, где лежит макс. уровень.
*'''сага тэг (saga_tag)''' - место в опциях, где лежит вся информация по саге.
*'''классика очки (classic_score)''' - место в опциях, где лежат очки по классике.
*'''классика тэг (classic_tag)''' - место в опциях, где лежит вся информация по классике.

=Графика=
*'''цветной шарик 1 (res1)''' - графический ресурс шарика 1.
*'''фрейм шарика 1 (res1Frame)''' - Номер фрейма ресурса шарика 1.
*'''цветной шарик 2 (res2)''' - графический ресурс шарика 2.
*'''фрейм шарика 2 (res2Frame)''' - Номер фрейма ресурса шарика 2.
*'''цветной шарик 3 (res3)''' - графический ресурс шарика 3
*'''фрейм шарика 3 (res3Frame)''' - Номер фрейма ресурса шарика 3.
*'''цветной шарик 4 (res4)''' - графический ресурс шарика 4.
*'''фрейм шарика 4 (res4Frame)''' - Номер фрейма ресурса шарика 4.
*'''цветной шарик 5 (res5)''' - графический ресурс шарика 5.
*'''фрейм шарика 5 (res5Frame)''' - Номер фрейма ресурса шарика 5.
*'''цветной шарик 6 (res6)''' - графический ресурс шарика 6.
*'''фрейм шарика 6 (res6Frame)''' - Номер фрейма ресурса шарика 6.
*'''цветной шарик 7 (res7)''' - графический ресурс шарика 7.
*'''фрейм шарика 7 (res7Frame)''' - Номер фрейма ресурса шарика 7.
*'''цветной шарик 8 (res8)''' - графический ресурс шарика 8.
*'''фрейм шарика 8 (res8Frame)''' - Номер фрейма ресурса шарика 8.
*'''цветной шарик Y (resY)''' - графический ресурс цветного шарика.
*'''гвоздь (resZ)''' - графический ресурс гвоздя.
*'''целевой шарик 1 (rest1)''' - графический ресурс целевого шарика 1.
*'''фрейм шарика 1 (rest1Frame)''' - Номер фрейма ресурса целевого шарика 1.
*'''целевой шарик 2 (rest2)''' - графический ресурс целевого шарика 2.
*'''фрейм шарика 2 (rest2Frame)''' - Номер фрейма ресурса целевого шарика 2.
*'''целевой шарик 3 (rest3)''' - графический ресурс целевого шарика 3
*'''фрейм шарика 3 (rest3Frame)''' - Номер фрейма ресурса целевого шарика 3.
*'''целевой шарик 4 (rest4)''' - графический ресурс целевого шарика 4.
*'''фрейм шарика 4 (rest4Frame)''' - Номер фрейма ресурса целевого шарика 4.
*'''целевой шарик 5 (rest5)''' - графический ресурс целевого шарика 5.
*'''фрейм шарика 5 (rest5Frame)''' - Номер фрейма ресурса целевого шарика 5.
*'''целевой шарик 6 (rest6)''' - графический ресурс целевого шарика 6.
*'''фрейм шарика 6 (rest6Frame)''' - Номер фрейма ресурса целевого шарика 6.
*'''целевой шарик 7 (rest7)''' - графический ресурс целевого шарика 7.
*'''фрейм шарика 7 (rest7Frame)''' - Номер фрейма ресурса целевого шарика 7.
*'''целевой шарик 8 (rest8)''' - графический ресурс целевого шарика 8.
*'''фрейм шарика 8 (rest8Frame)''' - Номер фрейма ресурса целевого шарика 8.
*'''целевой шарик Y (restY)''' - графический ресурс целевого цветного шарика.
*'''маска залочки (res_lock_mask)''' - графический ресурс маски залочки.
*'''падающий шарик (res_drop_mask)''' - графический ресурс падающего шарика.
*'''лунка (resf1)''' - графический ресурс лунки.
*'''фрейм лунка (resf1Frame)''' - Номер фрейма ресурса лунки.
*'''колючка (resf2)''' - графический ресурс колючки.
*'''фрейм колючка (resf2Frame)''' - Номер фрейма ресурса колючки.
*'''снежинка (resf3)''' - графический ресурс снежинки.
*'''фрейм снежинка (resf3Frame)''' - Номер фрейма ресурса снежинки.
*'''вредитель (resf4)''' - графический ресурс вредителя.
*'''фрейм вредитель (resf4Frame)''' - Номер фрейма ресурса вредителя.
*'''половинки (resf5)''' - графический ресурс половинок.
*'''фрейм половинки (resf5Frame)''' - Номер фрейма ресурса половинок.
*'''камень (resf6)''' - графический ресурс камня.
*'''фрейм камень (resf6Frame)''' - Номер фрейма ресурса камня.
*'''хищник (resf8)''' - графический ресурс маски залочки.
*'''фрейм хищник (resf8Frame)''' - графический ресурс маски залочки.
*'''призрак (resf9)''' - графический ресурс призрака.
*'''фрейм призрак (resf9Frame)''' - Номер фрейма ресурса призрака.
*'''шестеренка (resf10)''' - графический ресурс шетеренки.
*'''фрейм шестеренка (resf10Frame)''' - Номер фрейма ресурса шестеренки.
*'''туман (resf11)''' - графический ресурс тумана.
*'''фрейм туман (resf11Frame)''' - Номер фрейма ресурса тумана.
*'''портал (resf12)''' - графический ресурс портала.
*'''фрейм портал (resf12Frame)''' - Номер фрейма ресурса портала.
*'''призрак-цель (resf13)''' - графический ресурс призрак-цель.
*'''фрейм призрак-цель (resf13Frame)''' - Номер фрейма ресурса призрак-цель.
*'''огонь (resf14)''' - графический ресурс огня.
*'''фрейм огонь (resf14Frame)''' - Номер фрейма ресурса огонь.
*'''молния (resf15)''' - графический ресурс молнии.
*'''фрейм молния (resf15Frame)''' - Номер фрейма ресурса молния.
*'''радужный шар (resrainbow)''' - графический ресурс радужного шара.

=Звуки=
*'''shot''' - Звук выстрела.
*'''fail''' - Звук промаха.
*'''explosion''' - Звук взрыва шариков.
*'''drop''' - Звук осыпания.
*'''intro''' - Звук в начале игры.
*'''add row''' - Звук добавления ряда.
*'''game over''' - Звук окончания игры.
*'''bomb mine''' - Звук выстрела бомбы "мина".
*'''bomb bullet''' - Звук выстрела бомбы "ядро".
*'''bomb color''' - Звук выстрела бомбы "цвет".
*'''Взрыв бомбы мина''' - Звук взрыва бомбы мина.
*'''Взрыв бомбы ядро''' - Звук взрыва бомбы ядро.
*'''Взрыв бомбы цвет''' - Звук взрыва бомбы цвет.
*'''Бомба мульти цвет''' - Звук взыва бомбы мульти цвет.
*'''Закат в лунку''' - Звук заката в лунку.
*'''Взрыв колючкой''' - Звук взрыва колючкой.
*'''Таяние снежинки''' - Звук таяния снежинки.

=Эффекты=
*'''Удар бомбы об гвоздь''' - объект, запускаемый на месте удара бомбы об гвоздь.
*'''Удар шара об гвоздь''' - объект, запускаемый на месте удара шарика об гвоздь.

=Машины отображающие пушку=
*'''Первый шарик''' - машина, отображающая первый шарик.
*'''Второй шарик''' - машина, отображающая второй шарик.
*'''Третий шарик''' - машина, отображающая третий шарик.

'''Машины могут иметь состояния:'''
*'''shot''' - выстрел.
*'''shot_over''' - окончание выстрела.
*'''swap''' - смена шариков.
*'''swap_over''' - окончание смены шариков.

=Прицел=
*'''res''' - Графический ресурс прицела, перетаскивается из редактора ресурсов.
*'''Время''' - Время от нажатия до момента появления прицела.
*'''Время перед мувом''' - Время от нажатия до момента появления прицела в движении.
*'''Смещение''' - Расстояние между пальцем и центром прицела.

=Курсор=
*'''res (curres)''' - Графический ресурс курсора, перетаскивается из редактора ресурсов.
*'''Расстояние между шариками (distance)''' - Расстояние между шариками, от которого зависит их количество.
*'''Кол-во шариков в последней линии (last_line_count_bubs)''' - количество шариков, которе будет в последней линии курсора.
*'''Отражения (curlns)''' - максимальное кол-во отражений от стенок.
*'''Коэффициент (curkoef)''' - коэффициент ds/s, где s - базовое расстояние между шариками, ds - его наращивание.
*'''минимальный скейл (curminsc)''' - минимальный скейл графики шариков
*'''максимальный скейл (curmaxsc)''' - максимальный скейл графики шариков
*'''время скалирования (cursctm)''' - время скалирования шариков

=Слушатели=
*'''Выстрел''' - объект, которому передаются нижеследующие состояния при выстреле из пушки. Состояния: '''shot''' - выстрел обычным шариком, '''mine''' - выстрел миной, '''color''' - выстрел цветной бомбой, '''bullet''' - выстрел бомбой-ядром.

=Настройки=
[[Файл:02-01-2014 13-40-18.png|250px|thumb|right]]
*'''Позиция стреляющего шарика (x,y)''' - Позиция стреляющего шарика (x,y)
*'''Позиция следующего шарика (x,y)''' - Позиция следующего шарика (x,y).
*'''Позиция 3-го шарика (x,y)''' - Позиция 3-го шарика (x,y).
*'''третий шарик (n3bub)''' - если 0 - 3-го шарика не будет, 1 - есть третий шарик.
*'''Коэффициент вероятности цветов''' - коэффициент вероятности цветов.
*'''Расстояние от следующего шарика''' - расстояние от следующего шарика.
*'''Скорость наезда для режима Bubblez''' - скорость наезда для режима Bubblez.
*'''Смещение''' - Смешение поля относительно начала координат родителя.
*'''Скейл шариков для снукера''' - скейл шариков для снукера.
*'''Радиус шариков''' - Радиус шариков.
*'''Мин.радиус шариков''' - Мин.размер шариков во время "взрыва".
*'''Макс.радиус шариков''' - Макс.размер шариков во время "взрыва".
*'''Ширина шариков''' - Ширина шариков на поле. Вычисляется по формуле (2R+2).
*'''Высота шариков''' - Высота шариков на поле. Вычисляется по формуле (2R-2).
*'''убирать выбитый цвет из пушки''' - (fbub1) Убирать выбитый цвет из пушки (нет=0, да=1).
*'''Уровень''' - Уровень игры: новичок, любитель, эксперт, мастер, кастомный (настройки уровня сложности зависят от параметров заданных в добавляемом поле "уровень сложности")
*'''Вид игры''' - Режим игры: аркада, стратегия. Режим Аркада был создан для моды "битва", в котором предусматривалось добавление доп.рядов через определенное время бездействия игрока.
[[Файл:02-01-2014 10-04-52.png|250px|thumb|right]]
*'''Начальные шаги до наезда''' - Количество шагов через которое поле "накажет" игрока дополнительными рядами.
*'''Промежутки добавления рядов''' - Время через которое будут добавляться следующий ряд (в режиме Аркада).
*'''Добавление рядов''' - Разрешить добавление рядов. Иначе только извне. Целесообразно использовать в снукере.
*'''Color mapping''' - Color mapping включён (0 - нет, 1 - да).
*'''Тип рандома''' - Тип рандома. Простой - берём случайный из всех цветов, Супер Рандом - супер алгоритм, Из набора - формируем набор из n шариков и перемешиваем.
*'''Количество цвета для набора''' - количество цвета для формирования набора в рандоме (касается типа рандома "Из набора").
*'''Файл-описание уровня''' - Файл формата .xml в котором будет построены уровни для игры. Пример приведен справа.
*'''Номер уровня в файле''' - Стартовый уровень, с которого будет начинаться игра.
*'''Файл трекинга''' - Файл трекинга формата .xml.
*'''Таблица трекинга''' - Таблица трекинга.
*'''Объект новых шариков''' - Объект, которому сообщается о новых шариках.
*'''Мувер''' - Объект, двигающий баббл шутер.
*'''Задержка перед броском''' - задержка перед броском.
*'''Задержка перед обрывом шариков''' - задержка перед обрывом шариков.
*'''К-во секторов для броска''' - Количество секторов для броска.
*'''Слушатель движения мыши''' - объект, слушатель движения мыши.
*'''Слушатель броска''' - объект, слушатель броска. По сути вызывается только состояние st1.
*'''Слушатель движения поля''' - объект, слушатель движения поля. Должен иметь состояния move (поле двигается) и move_over (окончание движения поля).
*'''собирать статистику''' - (collec_stat) Включить сбор статистики (нет=0, да=1).
*'''Феерверк после победы''' - Включить феерверк из шариков сразу после победы (0 - нет, 1 - да).

=Параметры бомб=
===Мина===
[[Файл:02-01-2014 13-37-11.png|250px|thumb|right]]
*'''res''' - Графический ресурс мины в пушке.
*'''res1''' - Графический ресурс мины в полете.
*'''подложка''' - (bomb1bg) Графический ресурс для подложки бомбы (взрыв по радиусу).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Радиус''' - Радиус взрыва данной бомбы
*'''Эффект''' - Эффект на месте взрыва бомбы. Объект должен иметь состояние beg.

===Цвет===
*'''res''' - Графический ресурс бомбы-цвет в пушке.
*'''res1''' - Графический ресурс бомбы-цвет в полете.
*'''подложка''' - (bomb2bg) Графический ресурс для подложки бомбы 2 (взрыв шариков одного цвета).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.

===Ядро===
*'''res''' - Графический ресурс ядра в пушке.
*'''res1''' - Графический ресурс ядра в полете.
*'''подложка''' - (bomb3bg) Графический ресурс для подложки бомбы 3 (летит и взрывает все вокруг себя).
*'''Вероятность''' - Вероятность появления данной бомбы.
*'''Скип''' - Количество пропущенных первых шагов для появления бомбы (не реализовано).
*'''Количество''' - Количество появления бомбы за одну игровую сессию.
*'''Шаги''' - Количество шагов до появления данной бомбы.
*'''Шаги ok''' - Количество удачных шагов до появления бомбы.
*'''Шаги miss''' - Количество неудачных шагов до появления бомбы.
*'''n1''' - Минимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''n2''' - Максимальное количество шариков взорванных за ход необходимое для появления данной бомбы.
*'''Флайер''' - Флайер летящий под бомбочкой.
*'''Флайер 2''' - Флайер летящий под бомбочкой.
*'''Скорость''' - Скорость перемещения бомбочки.
*'''Число отскоков''' - Число отскоков от стен для бомбочки.

=Очковая система=
*'''Тип''' - ''classic'', ''lostnumbers'', ''nightopera''
*'''коеф для матча''' - (match_coef) коэффициент очков для матча.
*'''коеф для обвала''' - (drop_coef) коэффициент очков для обвала.
*'''Визуализатор шагов''' - счетчик, прогресс, которые отображает оставшееся количество шагов до "наезда".
*'''Визуализатор последних очков''' - счетчик, таймер, прогресс последних очков.
*'''Аниматор последних очков''' - машина со счетчиком (подобъектом), которая запускается в месте попадания шарика. Должна иметь состояние ''show''.
*'''Тип подсчета''' - очки могут считаться как: 1) количество сматченных шариков * на kBub; 2) сумма порядковых номеров (сматчили 4 шарика -> очки = 1+2+3+4)
*'''kBub''' - коэффициент за сматченные шарики.
*'''kCmb''' - коэффициент за комбо.
*'''kMov''' - коэффициент за оставшиеся ходы.
*'''kTim''' - коэффициент за оставшиеся секунды.
*'''kPst''' - коэффициент за удаленные с поля вредители.
*'''kSnw''' - коэффициент за удаленные с поля снежинки.

= Состояния =
*'''pause''' - перевести объект в паузу;
*'''resume''' - вытащить объект из паузы;
*'''hint''' - выполнить хинт ( нужно в поле hntt указать номер хинта);
*'''gover''' -
*'''game_continue''' - продолжить игру (например, в случае, когда мы проиграли, но даем игроку шанс, убрав несколько нижних линий);
*'''game_lose''' - задекларировать проигрыш (например, когда мы проиграли, и игрок отказался от шанса продолжить игру);
*'''cur_on''' - отображать траекторию при прицеливании;
*'''cur_off''' - убрать траекторию при прицеливании;
*'''fbubswap''' - поменять местами шарики в пушке;
*'''del_bottom''' - удалить несколько (задается параметром) нижних рядов;
*'''effdigsc2''' -
*'''update_params''' - обновить параметры объекта(пока только номер фрейма клипа шариков);
*'''reset_game''' - сбросит игру , которая сохранена в опциях;
*'''send_stat''' - отправить статистику.

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

===[[Файл:+.png]] Графический ресурс===
*'''Клип''' - Графический ресурс, перетаскивается из редактора ресурсов.
*'''Номер цвета''' - Номер цвета, который будет соответствовать значению цвета в файле-уровня.

===[[Файл:+.png]] Ресурсы функциональных шариков===
[[Файл:03-02-2014 10-35-45.png|200px|thumb|right]]
*'''Функционал''' - Записываем значение чудо-шарика из файла-настроек.
*'''Клип''' - Графический ресурс шариков, обладающих данным функционалом.
*'''Звук''' - Звук шарика, обладающего данным функционалом.
*'''Эффект''' - Машина/Патикл обладающие состоянием beg.

===[[Файл:+.png]] Параметры анимации для шарика лунка===
*'''Время перемещения''' - время движения шарика в центр лунки.
*'''Время исчезновения''' - время исчезновения шарика в лунке (скейл).
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика колючка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика снежинка===
*'''Время жизни''' - время жизни эффекта.

===[[Файл:+.png]] Параметры анимации для шарика вредитель===
*'''Время жизни''' - время жизни эффекта.
*'''Время ожидания скина''' - время, пока поменяется скин шарика.
*'''Эффект''' - эффект, возникающий в момент обрастания вредителя снежинками.

===[[Файл:+.png]] Физика===
[[Файл:02-01-2014 13-57-15.png|250px|thumb|right]]
*'''Справа находится пример настроек физики для шариков радиусом 24.'''
*'''Move''' - Коэффициент отталкивания летящего шарика.
*'''MinDest2''' - Квадрат минимального расстояния, когда шарик считается в покое.
*'''MinVel2''' - Квадрат минимальной скорости, когда шарик считается в покое.
*'''Down''' - Трение.
*'''MaxVel''' - Максимальная скорость колебаний.
*'''Elast''' - Эластичность с-мы (коэффициент для сил действующих между соседними шариками).
*'''Glue''' - Коэффициент притяжения шарика к центру ячейки.
*'''MoveC''' - Радиус действия летящего шарика в ячейках.
*'''BangVel''' - Приращение для скорости взрыва.

===[[Файл:+.png]] параметры хинта бомба===
*'''res''' - (res) Графический ресурс для бомбочки.
*'''радиус''' - (r) Радиус действия бомбочки (взрывает шарики в пределах этого радиуса).

===[[Файл:+.png]] параметры хинта бомба удаляющая цвет к которому коснулась при выстреле===
*'''res''' - (res) Графический ресурс для бомбочки.

===[[Файл:+.png]] кастомные параметры поля===
*'''кол-во цветов''' - (colors) Количество цветов.
*'''заполненные строки''' - (lines) Количество заполненных строк.
*'''шаги до наезда''' - (steps) Количество шагов до наезда.

===[[Файл:+.png]] Уровень сложности===
''Название параметров говорит само за себя. Создавать их можно бесконечное множество, главное не забывать назначать им порядковые номера в поле "уровень" по мере добавления новых уровней. Количество уровней сложности внутри объекта должно соответствовать количеству уровней сложности у необходимого Вам монстра. Количество цветов заданное в файле-настройках .xml имеет приоритет над теми, что мы задаем в объекте.''
*'''Уровень''' - номер уровня.
*'''Кол-во цветов''' - число цветов на поле.
*'''Шаги до наезда''' - число шагов до наезда.
*'''Бомба мина: вероятность''' - вероятность появления мины в процентах.
*'''Бомба мина: радиус''' - радиус мины в шариках.
*'''Бомба ядро:вероятность''' - вероятность появления ядра в процентах.
*'''Бомба ядро: число отскоков от стен''' - число отскоков ядра от стен поля.
*'''Бомба цвет: количество''' - число бомб-цвет, которые появятся на уровне.
*'''Бомба цвет: шаги''' - число шагов вначале уровня до появления бомбы-цвет.

===[[Файл:+.png]] Визуализатор общих очков===
*'''Объект''' - счетчик, прогресс, показывающий сумму очков за уровень.

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

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

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

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

===[[Файл:+.png]] хинт бомба цвет: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба цвет: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба ядро: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]]хинт бомба ядро: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объекта.

===[[Файл:+.png]] хинт бомба мина: неуспех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

===[[Файл:+.png]] хинт 'поменять шары местами': успех: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

===[[Файл:+.png]] выбили цвет: изменить состояние объекта===
*'''объект''' - Объект, состояние которого нужно изменить.
*'''состояние''' - Новое состояние объект.

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

=Хинты=
*'''Замена шарика''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние hint.
*'''Удаление цвета''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=5, после чего передать состояние hint.
*'''Ядро''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=3, после чего передать состояние hint.
*'''Мина''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=1, после чего передать состояние hint.
*'''Курсор''' - Для того, чтоб вызвать этот хинт необходимо сделать следующие манипуляции: Вызвать объекту BubbleShooter параметр hntt=0, после чего передать состояние cur_on. После выстрела курсор исчезает.

=Пример проекта=
S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble_snooker_graphprogress.zip

S:\!MOBILE\!!!EditorGames\Wiki_sample\bubble.rar

=Пример реализации: задание уровня=

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

[[Файл:Bubble change level.png|centre]]

::'''2)''' Если же, мы задаем нужный уровень удалённо ( с другого экрана), то мы расшариваем экран с самим шутером на сцену где будем задавать ему новый уровень. И на том экране (удалённом) задаём шутеру нужный уровень (levelNum).

[[Category:Game mechanic]]