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

Partnersconsole

2018-04-06T11:53:00Z

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

{{TOC right}}

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

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

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

=== Добавляемые параметры ===
*'''game_event_play''' - Была нажата внешняя кнопка Play, необходим перезапуск игры.

[[Category:Main objects]]

Partnersconsole

2018-04-06T11:51:32Z

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

Partnersconsole

2018-04-04T13:05:22Z

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

Partnersconsole

2018-04-04T13:04:54Z

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

{{TOC right}}

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

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

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

[[Category:Main objects]]

Gamecenter

2017-08-29T08:29:12Z

Vgat: /* Отключение неиспользуемого функционала */

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

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

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

* состояние - состояние, которое мы передаем объекту gamecenter
'''authenticate''' - состояние, по которому начинается авторизация мобильного
устройства на геймцентре.
'''score''' - состояние, по которому отправляются очки.
'''achievement''' - состояние, по которому отправляются достижения.
'''score_show''' - состояние, по которому можно посмотреть очки на геймцентре.
'''achievements_show''' - состояние, по которому можно посмотреть достижения.
'''cloud_check''' - состояние, по которому проверяется, есть ли сохранение в клауде.
'''cloud_apply''' - состояние, по которому применяется новое сохранение из клауда (reload).
'''cloud_cancel''' - состояние, по которому автоматическая отправка/получение сохранений будет отключена,
пока не будет вызвано состояние '''cloud_check'''
'''cloud_delete''' - состояние, по которому сохранение в клауде удаляется.
'''local''' - состояние, по которому в локальную таблицу подтянутся локальные темплейты (шаблоны достижений)
'''next_achievement''' - состояние, для обработки очереди полученных аччивок, при передаче состояния, объект уменьшает
значение achievement_num на единицу и заполняет поля achievement_ico и achievement_txt. Нужно передавать,
после того как показали текущую аччивку.
'''achievement_position''' - состояние, для получения порядкового номера аччивки в таблице локальных аччивок. Перед
передачей, заполняем в поле '''param''' txtID локальной аччивки и забираем порядковый номер из поля '''result'''
( нумерация начин. с нуля). '''!!!''' объект невыдаёт result пока хотя бы раз не отобразится таблица с аччивками
(лучше вызывать состояние когда открыта таблица с аччивками).
'''report_all''' - состояние, по которому при логине отправляются все достижения, полученные ранее.

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

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

=== Очки и Достижения ===

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

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

Все очки, лидер бордеры, ачивки прописываются в обеъкте Gamecenter, каждая ачивка или score добавляется дополнительным параметром.

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

Для каждой ачивки или score нужно прописать ее внутренний id и заполнить поля - внешние ссылки для различных платформ iOS, Amazon и т.д. Таким образом у нас заранее прописаны все ачивки и очки, и для их отправки мы выбираем их по внутреннему id.

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

Далее когда у нам нужно отправить какое то достижение мы объекту в параметре achievement передаем внутренний id ачивки которую нужно отправить и передаем состояние achievement. См. скрин ниже. 
Для того чтоб авивка выполнялась не полностью, а выполнился ее определенный процент, то есть если мы хотим получить ачивку в несколько этапов, перед отправкой мы должны указать процент отправки. По умолчанию стоит 100%.

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

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

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

=== Сохранение в Cloud ===

Для того что бы заработала синхронизация с облаком, нужна авторизация. Все процессы происходят в фоне, за исключением момента после первой успешной авторизации. В этом случае, если в облаке есть какие либо данные, то пользователю должно быть предложено применить или отменить новое сохранение.
...
P.S. В данный момент работает только в Google Play Games, т.е. если параметр '''android google''' = 1.

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

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

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

[[Файл:+.png]] '''Leaderboard - категория''' - Дополнительный параметр для отправки Score
*'''id достиженя'''
*'''IOS id достиженя'''
*'''Amazon id достиженя'''
*'''IGoogle id достиженя'''

[[Файл:+.png]] '''Achievement - достижение''' - Дополнительный параметр для отправки Achievement
*'''id достиженя'''
*'''IOS id достиженя'''
*'''Amazon id достиженя'''
*'''IGoogle id достиженя'''
*'''локальный текст''' - текст который поместится в локальный шаблон аччивок ( поле word - текст аччивки; icon1 - картинка в темплейт);
*'''не отображать в маркетах''' - указываем тексты из текстовой базы с названиями платформ ( поле word="webok"; google, webfb...);

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

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

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

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

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

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

=== Отключение неиспользуемого функционала ===

Если в проекте не используются лидерборды, ачивки, синхронизацию между устройствами, то их можно принудительно отключить вписав в [[app.icf]] или [[platform.icf]] следующие строки:
<pre>

[GameCenter]
Achievements=1
Leaderboards=1
Whispersync=0

</pre>

1 - используется, 0 - не используется

по умолчанию:

Achievements=1 
Leaderboards=1 
Whispersync=0 

Для включения отправки очков на Amazon GameCircle по таймауту добавляем строку:

GameCircle.SubmitScoreTimeout=3600 

[http://www.amazon.com/gp/help/customer/display.html/?nodeId=200775230 Whispersync]

===Особенности Cloud save===

# У объекта типа геймцентр параметр "память" должен быть равен 1(еденице)
# минимальное значение ключевого параметра должно быть и быть больше 0(например 1)
# В облако отправляется файл опций при переходе между экранами, но не раньше чем через 2 минуты. То есть пользователь в облаке имеет файл опций 2-3х-минутной давности.
# в AndroidManifest.xml(android-extra-application-manifest.xml) долны быть следующие строки:
<pre>
<meta-data android:name="com.google.android.gms.games.APP_ID" android:value= "@string/app_id" />
<meta-data android:name="com.google.android.gms.appstate.APP_ID" android:value= "@string/app_id" />
</pre>
и естественно должен быть указан id приложения для геймцентра

=== Настройки геймцентра для Google ===

в файле ids.xml долен быть указан id приложения

<pre>
<?xml version="1.0" encoding="utf-8"?>

<resources>
<string name="app_id">id_приложения_google_для_геймцентра</string>
<string name="facebook_app_id">id_приложения_для_facebook(для работы только геймцентра указывать необязательно, но строка должна присутствовать)</string>
</resources>
</pre>

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

На одном экране пусть будет объект типа "геймцентр", объект типа "options", обработчики сообщений, кнопки авторизации, перехода на другой экран, проверки новых данных, применения пришедших изменений.

На другом - счётчик, который будет записывать значение в ключевое поле. На экране с счётчиком кнопка, которая увеличивает его значение, и кнопка возврата на основной экран.

Отправка происходит следующим образом:

# авторизуемся
# появилось сообщение о том что новых данных нет
# переходим на 2-й экран
# увеличиваем счётчик до выбранного значения
# ждём 2 минуты
# переходим на главный экран
# немного ждём
# закрываем приложение
# в управлении приложениями удаляем данные приложения (или просто удаляем приложение и устанавливаем снова)
# запускаем приложение
# авторизуемся
# появилось сообщение о том что есть новые данные
# применяем пришедшие изменения
# убеждаемся что счётчик показывает правильное значение

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

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

[https://app.box.com/s/7ekw5b2klih4j1ishsbk Пример проекта] с cloud save

=== Получение аччивки ===

Когда мы получаем аччивку (100% прогресс), то в объект gamecentre записываются след. параметры (чтобы моментально открыть окошко, вешаем на все аччивменты дёргание одной машинки):
:'''achievement_num''' - количество аччивок в очереди.
:'''achievement_txt''' - локальный текст последней в очереди аччивки;
:'''achievement_ico''' - иконка последней аччивки.

Имея данные параметры мы заполняем поздравительное окошко с получением аччивки, после показа аччивки , передаём объекту gamecentre сост. '''next_achievement''' , чтобы объект обновил параметры ( если в очереди две аччивки, то объект перезаполнит поля achievement_txt и achievement_ico).

[[Файл:Achieve obtain wnd.jpg]]
[[Файл:Achieve obtain wnd 2.jpg]]

=== Пост аччивки на Facebook ===

Объект геймцентр отправит пост на стену при получении аччивки, если в соответствующие поле будет указан линк:

[[Файл:6edd4a97ee.jpg]]

[[Category:Global score]]

HiddenList

2017-08-23T13:03:53Z

Vgat: /* Основные параметры */

{{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''' - дым.
*'''флурри''' ('' 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''' -переводит хидден с состояние паузы, объекты не кликаются!

==Примечания==

*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"
}
],
"bg": [
{
"src": "bg.png",
"id": 356
}
]
}

:Где "levels" - линки на файлы уровней.
:::"file" - путь к файлу;
::"bg" - данные о фонах, для каждого файла уровня
:::"src" - сорс графического ресурса;
:::"id" - id ресурса из ресурсной базы;

Файл конкретного уровня имеет вид:
{
"bg": {
"src": "bg.png",
"w": 2048,
"h": 1151,
"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" - тайлинг фона;
::"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]]

HiddenList

2017-08-23T13:02:47Z

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

HiddenList

2017-08-23T13:02:17Z

Vgat: /* Основные параметры */

{{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]] которые отображены в таблице, остальные нет!).
*'''распределять равномерно''' ('' undist '') - Равномерно распределять объекты по площади сцены.
*'''альтернативный алгоритм''' ('' altern_algo '') - Использовать альтернативный алгоритм равномерного распределения (при включенном равномерном распределении).
*'''прятать актеров при старте''' ('' hideact '') - Устанавливать актерам видимость false при старте (по умолчанию - да)(То есть всем актерам которые находятся на сцене при запуске принудительно установиться vis = 0).
*'''аномалия''' ('' anom '') - для всех аномалий кроме текстовой [[HiddenObject]] и игровой фон должны быть подобъектами [[Effect]]):
:'''0''' - нет;
:'''1''' - текстовая;
:'''2''' - ночь; В машине которая выставляет эффект ночь, должны передавать сцене с объектом аномалия ( obj="scene"; par="drag"; val="0" ) и ( obj="scene"; st="update");
:'''3''' - трансформация цвета;
:'''4''' - дым.
*'''флурри''' ('' 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''' -переводит хидден с состояние паузы, объекты не кликаются!

==Примечания==

*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"
}
],
"bg": [
{
"src": "bg.png",
"id": 356
}
]
}

:Где "levels" - линки на файлы уровней.
:::"file" - путь к файлу;
::"bg" - данные о фонах, для каждого файла уровня
:::"src" - сорс графического ресурса;
:::"id" - id ресурса из ресурсной базы;

Файл конкретного уровня имеет вид:
{
"bg": {
"src": "bg.png",
"w": 2048,
"h": 1151,
"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" - тайлинг фона;
::"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]]

HiddenList

2017-08-23T13:01:15Z

Vgat: /* Основные параметры */

{{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]] которые отображены в таблице, остальные нет!).
*'''распределять равномерно''' ('' undist '') - Равномерно распределять объекты по площади сцены.
*'''альтернативный алгоритм''' ('' altern_algo '') - Использовать альтернативный алгоритм равномерного распределения (при включенном равномерном распределении).
*'''прятать актеров при старте''' ('' hideact '') - Устанавливать актерам видимость false при старте (по умолчанию - да)(То есть всем актерам которые находятся на сцене при запуске принудительно установиться vis = 0).
*'''аномалия''' ('' anom '') - для всех аномалий кроме текстовой [[HiddenObject]] и игровой фон должны быть подобъектами [[Effect]]):
:'''0''' - нет;
:'''1''' - текстовая;
:'''2''' - ночь; В машине которая выставляет эффект ночь, должны передавать сцене с объектом аномалия ( obj="scene"; par="drag"; val="0" ) и ( obj="scene"; st="update");
:'''3''' - трансформация цвета;
:'''4''' - дым.
*'''флурри''' ('' 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''' -переводит хидден с состояние паузы, объекты не кликаются!

==Примечания==

*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"
}
],
"bg": [
{
"src": "bg.png",
"id": 356
}
]
}

:Где "levels" - линки на файлы уровней.
:::"file" - путь к файлу;
::"bg" - данные о фонах, для каждого файла уровня
:::"src" - сорс графического ресурса;
:::"id" - id ресурса из ресурсной базы;

Файл конкретного уровня имеет вид:
{
"bg": {
"src": "bg.png",
"w": 2048,
"h": 1151,
"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" - тайлинг фона;
::"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]]

HiddenList

2017-08-23T13:00:27Z

Vgat: /* Основные параметры */

{{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]] которые отображены в таблице, остальные нет!).
*'''распределять равномерно''' ('' undist '') - Равномерно распределять объекты по площади сцены.
*'''альтернативный алгоритм''' ('' altern_algo '') - Использовать альтернативный алгоритм равномерного распределения (при включенном равномерном распределении).
*'''прятать актеров при старте''' ('' hideact '') - Устанавливать актерам видимость false при старте (по умолчанию - да)(То есть всем актерам которые находятся на сцене при запуске принудительно установиться vis = 0).
*'''аномалия''' ('' anom '') - для всех аномалий кроме текстовой [[HiddenObject]] и игровой фон должны быть подобъектами [[Effect]]):
:'''0''' - нет;
:'''1''' - текстовая;
:'''2''' - ночь; В машине которая выставляет эффект ночь, должны передавать сцене с объектом аномалия ( obj="scene"; par="drag"; val="0" ) и ( obj="scene"; st="update");
:'''3''' - трансформация цвета;
:'''4''' - дым.
*'''флурри''' ('' 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''' -переводит хидден с состояние паузы, объекты не кликаются!

==Примечания==

*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"
}
],
"bg": [
{
"src": "bg.png",
"id": 356
}
]
}

:Где "levels" - линки на файлы уровней.
:::"file" - путь к файлу;
::"bg" - данные о фонах, для каждого файла уровня
:::"src" - сорс графического ресурса;
:::"id" - id ресурса из ресурсной базы;

Файл конкретного уровня имеет вид:
{
"bg": {
"src": "bg.png",
"w": 2048,
"h": 1151,
"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" - тайлинг фона;
::"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]]

HiddenHint

2017-07-10T09:18:16Z

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

'''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''' - нет;

[[Файл:+.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. Для подсветки пары объектов необходимо задать второй хвост и второй указатель (причем отличный от первого).

=== Хинт (Цепная молния), которая вылетает и поочередно указывает расположение нескольких искомых объекта ===

[[Файл: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]]

Image

2017-06-20T13:08:23Z

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

{{TOC right}}

'''Image''' - [[Object|объект]] применяется для отображения графических файлов на сцене. 
==Особенности объекта Image==
[[Файл:Image_02.JPG|150px|right]]
На первом рисунке приведен пример того, как выглядит объект Image без графического ресурса. На втором рисунке отображен объект Image с графическим ресурсом.
*Объект Image может не иметь графический ресурс, который виден на сцене
*Параметры объекта Image в процессе геймплэя могут меняться через объекты [[Machine]], [[Button]] ,[[Checkbox]] и т.п.
*На положение графического ресурса объекта Image влияет точка пивота.
*Графический ресурс объекта Image должен лежать в базе ресурсов проекта
*Графический ресурс объекта Image может иметь бордеры (о бордерах смотри больше на [[Интерфейс ResourceEditor]])
*Независимо от видимой формы графического ресурса на сцене форма объекта Image прямоугольная (мы видим прямоугольную рамочку) 
*При задании графического ресурса объекту Image необходимо разместить графический ресурс в соответствии с задумкой художников. Для этого необходимо воспользоваться функций "Расположить сцену в соответствии с изображением" Больше о данной функции смотри [[Функция Расположить сцену в соответствии с изображением]]
[[Файл:Image_01.JPG|150px|right]]

== Параметры ==
*'''id-объекта'''(id) - уникальный номер объекта
*'''тип''' (type) - Выбранный тип объекта определяет его функциональное назначение и его свойства
*'''имя'''(name) - Имя графического объекта в дереве проекта. Может быть произвольным. По умолчанию соответствует имени файла из базы ресурсов.
*'''синхронизация''' (sync)- Применяется для синхронизации между лейаутами, если указан параметр ''нет'' то объект будет активен только на текущем лейауте
*'''память''' (memo) - Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана).
*'''res''' - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования).
*'''[[прокликиваемая]]''' (passClk) - Если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то картинка сама обрабатывает клик, но и пропускает его дальше"
*'''Сохранение параметров''' -Настройка этого параметра актуальна, если приложение в дальнейшем будет сворачиваться в системную панель («трей»). При выходе из трэя будут восстановлены ранее измененные/установленные (при переходе с одного экрана на другой)параметры объектов или подобъектов в зависимости от выбранного варианта для этого параметра. По умолчанию указан параметр "нет". Возможны следующие варианты: "нет", "только объект", "объект с подобъектами", "только подобъекты". Следует помнить, что если выбирается для объекта некоторой сцены значения этого параметра отличное от "нет", то должно и предусматриваться соответствующее значение этого параметра и для этой сцены, и для экрана, содержащего эту сцену.
'''Группа - положение'''
*'''положение X'''(px) - Горизонтальная координата центра графического объекта (его точки пивота) в пикселях. Отсчитывается от точки пивота сцены.
*'''положение Y''' (py)- Вертикальная координата центра графического объекта (его точки пивота) в пикселях. Отсчитывается от точки пивота сцены.

'''Группа - размер'''
[[Файл:object1.png|400px|right]]
*'''размер -> W''' (w) - Ширина графического объекта в пикселях
*'''размер -> H''' (h)- Высота графического объекта в пикселях
'''Группа - vertex'''
[[Файл:Image_deform.png|400px|right]]
*'''vertex -> включить vertex''' (useVertex) - Использовать задание точек положения изображения
*'''vertex -> точки''' - Точки местонахождения изображение. Первая точка - верхняя левая точка. Следующие - против часовой стрелки от первой.
*'''vertex -> настройки -> треугольники''' (triangles) - Количество треугольников, по которым растягивается изображение для искажения. Больше - лучше, но больше и нагрузка.
*'''vertex -> настройки -> пузырь''' (bubbleDeform) - Коэффициент искажения вида Пузырь. Отрицательное значение - вогнутость внутрь.
'''Группа - модификаторы'''
*'''alpha''' (al) - Прозрачность: от 0 (прозрачен) до 1 (не прозрачен).
*'''blending''' (bl) - Alpha смешивание (parent - наследует alpha от родителя, blend - смешивание, add - добавление, sub - вычитание, none - ничего не происходит. (Подробнее о Alpha смешивании - здесь)).
*'''angle''' (ang) - Угол поворота в градусах (0 - не повёрнут). Отсчитывается от оси x вниз. Вверх - идут отрицательные углы.
*'''scale x''' (sx) - Масштаб по оси '''x''' (1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.).
*'''scale y''' (sy)- Масштаб по оси '''y''' (1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.).
*'''Принудительный scale x''' - Строгий масштаб по оси '''х''', независимый от масштаба родителей (если указать 0, то будет использоваться обычный скейл с учетом родителей)
*'''Принудительный scale y''' - Строгий масштаб по оси '''y'''.
*'''тайлинг''' - если размер объекта отличается от размера графического ресурса, то с графическим ресурсом:
#ничего не делать (нет)
#замостить им область объекта (тайлинг)
#растянуть по области объекта (растянуть)
*'''z''' - Параметр порядка рисования объекта. Сначала рисуются объекты с большим z, затем, поверх них - с меньшим.

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

Сам по себе объект Image статичен, то есть не может менять положение на сцене.

== Точка пивота ==
[[Файл:scena.png|400px|right]]

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

[[Файл:pivot_point1.png|400px|left]]
 
'''Пример изменения координат точки пивота''' 
Пусть на сцене расположен объект Image c параметром angle=90. 
Рисунок слева иллюстрирует, что после задания параметра angle=90 точка пивота объекта не сместилась. 
Рисунок справа иллюстрирует, что при изменении точки пивота объекта (ее переместили вниз) в редакторе ресурсов и после задания параметра angle=90 в редакторе точка пивота остается на месте.

[[Файл:pivot1.png|400px|left]][[Файл:pivot2.png|400px|center]]

[[Category:Main objects]]

Файл:Image deform.png

2017-06-20T13:07:11Z

Vgat: Последовательность задания точек при использовании искажения изображения.

Последовательность задания точек при использовании искажения изображения.

Image

2017-06-20T13:05:13Z

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

{{TOC right}}

'''Image''' - [[Object|объект]] применяется для отображения графических файлов на сцене. 
==Особенности объекта Image==
[[Файл:Image_02.JPG|150px|right]]
На первом рисунке приведен пример того, как выглядит объект Image без графического ресурса. На втором рисунке отображен объект Image с графическим ресурсом.
*Объект Image может не иметь графический ресурс, который виден на сцене
*Параметры объекта Image в процессе геймплэя могут меняться через объекты [[Machine]], [[Button]] ,[[Checkbox]] и т.п.
*На положение графического ресурса объекта Image влияет точка пивота.
*Графический ресурс объекта Image должен лежать в базе ресурсов проекта
*Графический ресурс объекта Image может иметь бордеры (о бордерах смотри больше на [[Интерфейс ResourceEditor]])
*Независимо от видимой формы графического ресурса на сцене форма объекта Image прямоугольная (мы видим прямоугольную рамочку) 
*При задании графического ресурса объекту Image необходимо разместить графический ресурс в соответствии с задумкой художников. Для этого необходимо воспользоваться функций "Расположить сцену в соответствии с изображением" Больше о данной функции смотри [[Функция Расположить сцену в соответствии с изображением]]
[[Файл:Image_01.JPG|150px|right]]

== Параметры ==
*'''id-объекта'''(id) - уникальный номер объекта
*'''тип''' (type) - Выбранный тип объекта определяет его функциональное назначение и его свойства
*'''имя'''(name) - Имя графического объекта в дереве проекта. Может быть произвольным. По умолчанию соответствует имени файла из базы ресурсов.
*'''синхронизация''' (sync)- Применяется для синхронизации между лейаутами, если указан параметр ''нет'' то объект будет активен только на текущем лейауте
*'''память''' (memo) - Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана).
*'''res''' - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования).
*'''[[прокликиваемая]]''' (passClk) - Если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то картинка сама обрабатывает клик, но и пропускает его дальше"
*'''Сохранение параметров''' -Настройка этого параметра актуальна, если приложение в дальнейшем будет сворачиваться в системную панель («трей»). При выходе из трэя будут восстановлены ранее измененные/установленные (при переходе с одного экрана на другой)параметры объектов или подобъектов в зависимости от выбранного варианта для этого параметра. По умолчанию указан параметр "нет". Возможны следующие варианты: "нет", "только объект", "объект с подобъектами", "только подобъекты". Следует помнить, что если выбирается для объекта некоторой сцены значения этого параметра отличное от "нет", то должно и предусматриваться соответствующее значение этого параметра и для этой сцены, и для экрана, содержащего эту сцену.
'''Группа - положение'''
*'''положение X'''(px) - Горизонтальная координата центра графического объекта (его точки пивота) в пикселях. Отсчитывается от точки пивота сцены.
*'''положение Y''' (py)- Вертикальная координата центра графического объекта (его точки пивота) в пикселях. Отсчитывается от точки пивота сцены.

'''Группа - размер'''
[[Файл:object1.png|400px|right]]
*'''размер -> W''' (w) - Ширина графического объекта в пикселях
*'''размер -> H''' (h)- Высота графического объекта в пикселях
'''Группа - vertex'''
*'''vertex -> включить vertex''' (useVertex) - Использовать задание точек положения изображения
*'''vertex -> точки''' - Точки местонахождения изображение. Первая точка - верхняя левая точка. Следующие - против часовой стрелки от первой.
*'''vertex -> настройки -> треугольники''' (triangles) - Количество треугольников, по которым растягивается изображение для искажения. Больше - лучше, но больше и нагрузка.
*'''vertex -> настройки -> пузырь''' (bubbleDeform) - Коэффициент искажения вида Пузырь. Отрицательное значение - вогнутость внутрь.
'''Группа - модификаторы'''
*'''alpha''' (al) - Прозрачность: от 0 (прозрачен) до 1 (не прозрачен).
*'''blending''' (bl) - Alpha смешивание (parent - наследует alpha от родителя, blend - смешивание, add - добавление, sub - вычитание, none - ничего не происходит. (Подробнее о Alpha смешивании - здесь)).
*'''angle''' (ang) - Угол поворота в градусах (0 - не повёрнут). Отсчитывается от оси x вниз. Вверх - идут отрицательные углы.
*'''scale x''' (sx) - Масштаб по оси '''x''' (1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.).
*'''scale y''' (sy)- Масштаб по оси '''y''' (1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.).
*'''Принудительный scale x''' - Строгий масштаб по оси '''х''', независимый от масштаба родителей (если указать 0, то будет использоваться обычный скейл с учетом родителей)
*'''Принудительный scale y''' - Строгий масштаб по оси '''y'''.
*'''тайлинг''' - если размер объекта отличается от размера графического ресурса, то с графическим ресурсом:
#ничего не делать (нет)
#замостить им область объекта (тайлинг)
#растянуть по области объекта (растянуть)
*'''z''' - Параметр порядка рисования объекта. Сначала рисуются объекты с большим z, затем, поверх них - с меньшим.

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

Сам по себе объект Image статичен, то есть не может менять положение на сцене.

== Точка пивота ==
[[Файл:scena.png|400px|right]]

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

[[Файл:pivot_point1.png|400px|left]]
 
'''Пример изменения координат точки пивота''' 
Пусть на сцене расположен объект Image c параметром angle=90. 
Рисунок слева иллюстрирует, что после задания параметра angle=90 точка пивота объекта не сместилась. 
Рисунок справа иллюстрирует, что при изменении точки пивота объекта (ее переместили вниз) в редакторе ресурсов и после задания параметра angle=90 в редакторе точка пивота остается на месте.

[[Файл:pivot1.png|400px|left]][[Файл:pivot2.png|400px|center]]

[[Category:Main objects]]

ShareDialog

2017-06-09T15:39:52Z

Vgat: /* Примечания */

==Состояния==
*'''update_params''' - считать параметры из img_id, extra_text, extra_subject

*'''send_to_device''' - отправить запрос открытия окна шаринга на телефон

==Параметры==
*'''img_id''' - Отправляемое изображения. Задаем id графического ресурса с ресурсной базы.

*'''extra_text''' - Основной текст. Задаем id текста с текстовой базы.

*'''extra_subject''' - Заголовок. Задаем id текста с текстовой базы.

==Примечания==
Список приложений, доступных для отправки, по фильтрам выбираем мы сами.
В случае передачи только текста - фильтр text/plain, только изображение - image/*, но в случае, когда есть и изображение, и текст - image/*, поскольку нет возможности выбора нескольких флагов.

'''!!!ВАЖНО!!!''' 
Картинки для шаринга должны все быть в первом паке.

Отправка поста не обновляет автоматически параметры, поэтому требуется до '''send_to_device''' выполнение состояния '''update_params'''

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

Пример взаимодействия с приложениями: 
*'''ВКонтакте''' - принимает основной текст и изображение 
*'''Facebook''' - принимает только изображение 
*'''Instagram''' - принимает только изображение 
*'''GMail''' - принимает заголовок, основной текст и изображение 
*'''Viber''' - принимает только изображения

ShareDialog

2017-06-09T15:36:54Z

Vgat: /* Примечания */

==Состояния==
*'''update_params''' - считать параметры из img_id, extra_text, extra_subject

*'''send_to_device''' - отправить запрос открытия окна шаринга на телефон

==Параметры==
*'''img_id''' - Отправляемое изображения. Задаем id графического ресурса с ресурсной базы.

*'''extra_text''' - Основной текст. Задаем id текста с текстовой базы.

*'''extra_subject''' - Заголовок. Задаем id текста с текстовой базы.

==Примечания==
Список приложений, доступных для отправки, по фильтрам выбираем мы сами.
В случае передачи только текста - фильтр text/plain, только изображение - image/*, но в случае, когда есть и изображение, и текст - image/*, поскольку нет возможности выбора нескольких флагов.

'''!!!ВАЖНО!!!''' 
Картинки для шаринга должны все быть в первом паке.

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

Пример взаимодействия с приложениями: 
*'''ВКонтакте''' - принимает основной текст и изображение 
*'''Facebook''' - принимает только изображение 
*'''Instagram''' - принимает только изображение 
*'''GMail''' - принимает заголовок, основной текст и изображение 
*'''Viber''' - принимает только изображения

ShareDialog

2017-06-09T15:35:42Z

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

==Состояния==
*'''update_params''' - считать параметры из img_id, extra_text, extra_subject

*'''send_to_device''' - отправить запрос открытия окна шаринга на телефон

==Параметры==
*'''img_id''' - Отправляемое изображения. Задаем id графического ресурса с ресурсной базы.

*'''extra_text''' - Основной текст. Задаем id текста с текстовой базы.

*'''extra_subject''' - Заголовок. Задаем id текста с текстовой базы.

==Примечания==
Список приложений, доступных для отправки, по фильтрам выбираем мы сами.
В случае передачи только текста - фильтр text/plain, только изображение - image/*, и изображение, и текст - image/*.

'''!!!ВАЖНО!!!''' 
Картинки для шаринга должны все быть в первом паке.

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

Пример взаимодействия с приложениями: 
*'''ВКонтакте''' - принимает основной текст и изображение 
*'''Facebook''' - принимает только изображение 
*'''Instagram''' - принимает только изображение 
*'''GMail''' - принимает заголовок, основной текст и изображение 
*'''Viber''' - принимает только изображения

ShareDialog

2017-06-09T15:35:11Z

Vgat: /* Примечания */

==Состояния==
*'''update_params''' - считать параметры из img_id, extra_text, extra_subject

*'''send_to_device''' - отправить запрос открытия окна шаринга на телефон

==Параметры==
*'''img_id''' - Картинка. Задаем id графического ресурса с ресурсной базы.

*'''extra_text''' - Основной текст. Задаем id текста с текстовой базы.

*'''extra_subject''' - Заголовок. Задаем id текста с текстовой базы.

==Примечания==
Список приложений, доступных для отправки, по фильтрам выбираем мы сами.
В случае передачи только текста - фильтр text/plain, только изображение - image/*, и изображение, и текст - image/*.

'''!!!ВАЖНО!!!''' 
Картинки для шаринга должны все быть в первом паке.

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

Пример взаимодействия с приложениями: 
*'''ВКонтакте''' - принимает основной текст и изображение 
*'''Facebook''' - принимает только изображение 
*'''Instagram''' - принимает только изображение 
*'''GMail''' - принимает заголовок, основной текст и изображение 
*'''Viber''' - принимает только изображения

ShareDialog

2017-06-09T15:34:17Z

Vgat: /* Примечания */

==Состояния==
*'''update_params''' - считать параметры из img_id, extra_text, extra_subject

*'''send_to_device''' - отправить запрос открытия окна шаринга на телефон

==Параметры==
*'''img_id''' - Картинка. Задаем id графического ресурса с ресурсной базы.

*'''extra_text''' - Основной текст. Задаем id текста с текстовой базы.

*'''extra_subject''' - Заголовок. Задаем id текста с текстовой базы.

==Примечания==
Список приложений, доступных для отправки, по фильтрам выбираем мы сами.
В случае передачи только текста - фильтр text/plain, только изображение - image/*, и изображение, и текст - image/*.

'''!!!ВАЖНО!!!''' 
Картинки для шаринга должны все быть в первом паке.

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

Пример взаимодействия с приложениями: 
''ВКонтакте - принимает основной текст и изображение 
''Facebook - принимает только изображение 
''Instagram - принимает только изображение 
''GMail - принимает заголовок, основной текст и изображение 
''Viber - принимает только изображения

ShareDialog

2017-06-09T15:33:43Z

Vgat: /* Примечания */

==Состояния==
*'''update_params''' - считать параметры из img_id, extra_text, extra_subject

*'''send_to_device''' - отправить запрос открытия окна шаринга на телефон

==Параметры==
*'''img_id''' - Картинка. Задаем id графического ресурса с ресурсной базы.

*'''extra_text''' - Основной текст. Задаем id текста с текстовой базы.

*'''extra_subject''' - Заголовок. Задаем id текста с текстовой базы.

==Примечания==
Список приложений, доступных для отправки, по фильтрам выбираем мы сами.
В случае передачи только текста - фильтр text/plain, только изображение - image/*, и изображение, и текст - image/*.

'''!!!ВАЖНО!!!'''
Картинки для шаринга должны все быть в первом паке.

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

Пример взаимодействия с приложениями:
''ВКонтакте - принимает основной текст и изображение
''Facebook - принимает только изображение
''Instagram - принимает только изображение
''GMail - принимает заголовок, основной текст и изображение
''Viber - принимает только изображения

ShareDialog

2017-06-09T15:20:13Z

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

ShareDialog

2017-06-09T15:18:19Z

Vgat: /* Использование */

ShareDialog

2017-06-09T15:15:37Z

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

ShareDialog

2017-06-09T15:15:00Z

Vgat: Новая страница: «==Состояния== *'''update_params''' - считать параметры из img_id, extra_text, extra_subject *'''send_to_device''' - отправить…»

==Состояния==
*'''update_params''' - считать параметры из img_id, extra_text, extra_subject

*'''send_to_device''' - отправить запрос открытия окна шаринга на телефон

Absolutist Framework

2017-06-09T15:11:27Z

Vgat: /* Social */

{{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 объект

=== Game mechanic ===

* [[Файл:Kub.png]] - [[Avoider]] - эвойдер
* [[Файл:Puzzle.png]] - [[Puzzle]] - игра пазл
* [[Файл:Memory.png]] - [[Memory]] - класс игр с memory-механикой
* [[Файл:Patchwork.png]] - [[Patchwork]] - класс игр с Patchwork-механикой
* [[Файл:Match3.png]] - [[Match]] - класс match-подобных игр
* [[Файл:Collaps.png]] - [[Collapse]] - класс match-подобных игр
* [[Файл:Bejewelled.png]] - [[Bejewelled]] - класс match-подобных игр
* [[Файл:BubbleShooter.png]] - [[Bubble Shooter]] - класс 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.

=== 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]] - менеджер ошибок

=== 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]] - вызов окна оценки приложения
----
<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]]

HiddenList

2017-06-01T07:21:25Z

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

{{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 '') - Скорость вращения в градусах в секунду.

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

*'''скалирование объектов''' ('' 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]] которые отображены в таблице, остальные нет!).
*'''распределять равномерно''' ('' undist '') - Равномерно распределять объекты по площади сцены.
*'''альтернативный алгоритм''' ('' altern_algo '') - Использовать альтернативный алгоритм равномерного распределения (при включенном равномерном распределении).
*'''прятать актеров при старте''' ('' hideact '') - Устанавливать актерам видимость false при старте (по умолчанию - да)(То есть всем актерам которые находятся на сцене при запуске принудительно установиться vis = 0).
*'''аномалия''' ('' anom '') - для всех аномалий кроме текстовой [[HiddenObject]] и игровой фон должны быть подобъектами [[Effect]]):
:'''0''' - нет;
:'''1''' - текстовая;
:'''2''' - ночь; В машине которая выставляет эффект ночь, должны передавать сцене с объектом аномалия ( obj="scene"; par="drag"; val="0" ) и ( obj="scene"; st="update");
:'''3''' - трансформация цвета;
:'''4''' - дым.
*'''флурри''' ('' 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 '') - Лимит ложных кликов.
Формула расчета проста, количество верных кликов делим на общее количество получаем коэффициент если он равен или больше указного нами то в опции пишем параметр, если нет то не пишем.

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

Состояния которые есть у листа. Мы можем передавать их с помощью различных объектов:
*'''invert''' - горизонтально отображает изображение;
*'''run''' - переводит хидден с состояние активности, если до этого был на паузе;
*'''pause''' -переводит хидден с состояние паузы, объекты не кликаются!

==Примечания==

*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"
}
],
"bg": [
{
"src": "bg.png",
"id": 356
}
]
}

:Где "levels" - линки на файлы уровней.
:::"file" - путь к файлу;
::"bg" - данные о фонах, для каждого файла уровня
:::"src" - сорс графического ресурса;
:::"id" - id ресурса из ресурсной базы;

Файл конкретного уровня имеет вид:
{
"bg": {
"src": "bg.png",
"w": 2048,
"h": 1151,
"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" - тайлинг фона;
::"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]]

Интерфейс

2017-02-01T09:23:54Z

Vgat: /* View (Просмотр) */

{{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...''' - удаление объекта;
*'''Delete temp data''' - удаление опций;
*'''Find object...''' - поиск объекта по id или по имени;
*'''Setup Editor...''' - настройки редактора.

==== View (Просмотр)====
меню запуска Вьювера (Viewer)- проигрывателя созданного экрана проекта:
*'''Start Viewer''' - запуск вьювера;
*'''Start Viewer with changed time''' - запуск вьювера с заданным временем;
*'''Setup Viewer...''' - настройки окна вьювера для выбранного проекта.

====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]]
При клике правой кнопкой мыши по выбраному лэйауту (см. рисунок справа)
*Создать папку в текущем обьекте;
*Создать экран в текущем обьекте - создание обьекта в текущем лэйауте;
*Импорт/экспорт экранов — импорт/экспорт одного или нескольких экранов;
*Развернуть / Свернуть обьекты с подобъектами — сворачивает / разворачивает дерево обьектов всех экранов 

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

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

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

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

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

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

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

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

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

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

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

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

''Параметры запаковки графики''
*Packege Type - упаковка ресурсов в фаил с типом DAT. Обеспечиваем защиту ресурсов проекта от несанкционированного доступа. Увеличиваем производительность при операциях чтения файлов ресурсов с твердотельного носителя.
*Texture Type - упаковка графических файлов в текстуры. Необходимо для уменьшения используемого объема оперативной памяти.

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

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

== [[Файл:Ico_base.png]]Редактор ресурсов ==

===Общее описание===
[[Файл:Ico_base.png|40px]]'''Редактор ресурсов''' - приложение, которое управляет базой графических, анимационных, видео и звуковых ресурсов проекта. [[Файл:New resource editor look.jpg|500px|right]]
Ресурсы проекта могут быть внесены и модифицированы только через Редактор ресурсов. 
Как и в редакторе сцен, вверху окна редактора ресурсов расположено меню и кнопки быстрого доступа: создать базу ресурсов, открыть уже существующую, добавить картинку (png, jpeg), анимацию, мелодию (mp3, ogg), видео (mp4). 
Ниже, в левой панели находятся папки, внутри которых можно найти различные графические ресурсы:
*Если в дереве папок активна данная папка, то на правой панели мы видим список графических ресурсов в виде иконок.
*Если же в дереве кликнуть на имя конкретной картинки, то в правой панели она будет представлена в натуральную величину.
*При клике на ресурс в левой нижней части окна редактора ресурсов появится панель с настройками ресурса в зависимости от его типа

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

====Меню File====
*New Project (Ctrl+N) – создать новый проект с новой базай ресурсов. Возможно в качестве базы ресурсов выбрать уже существующий каталог ресурсов.
*Open Project (Ctrl+N) - открыть базу ресурсов ранее созданного проекта
*Создать проект по папке — создать базу ресурсов по каталогу с ресурсами

====Меню View====
*Always on top - всегда отображать Редактор Ресурсов поверх всех окон
*Image Viewer - отобразить панель Image Viewer для просмотра ресурсов

====Меню Project====
*Add Root Base - создать еще одну базу ресурсов в текущем проекте
*Add images — добавить изображения в проект
*Add Animations — добавить анимацию в проект
*Add Sounds - добавить звук в проект
*AddVideos - добавить видео в проект
*Delete Resource — удалить ресурс
*Options — вызов окна настройки отображения изображений в редакторе
*Обрезать images в старом проекте — вызов функции удаления бордера изображения (у всех ресурсов) на указанную величину в параметре Transparent Border Size вкладки Cropping Settings из Options меню Project 

Кнопки Add images, Add Animations, Add Sounds , AddVideos, Delete Resource вызвается по клику правой кнопки мыши в дереве базы ресурсов

====Область визуализации ресурсов Image Viewer====
В данной области визуализируется ресурс. Все виды ресурсов визуализируется как изображение.
По клику правой кнопкой мыши внутри области визуализации выпадает меню: 
''Center image by''
Предположим мы изменили точку пивота ресурса. 
*Если выберем Image Center to Center, то в центре Image Viewer отобразится ресурс.
* Если выберем Image Pivot to Center, то в центре Image Viewer отобразится точка пивота. (См. рисунок справа) 
''Directory View Mode'' — . Если мы выберем режим Full Source Image , то мы будем видеть изображение и бордер, а если Cropped Images — то только изображение без бордера 
[[Файл:RR_Pivot_1_.JPG|300px]] [[Файл:RR_Pivot_2.JPG|350px]] 

====Shape====
Для работы с обьектами физического мира иногда требуется создать дополнительный конутр вокруг обьекта.
Физ_объектами могут быть не только прямоугольники. Шейп (Shape) можно задавать полигоном и кругом в Shape editor.
Количество вершин в полигоне должно быть от 3 до 8. Создавать новую шейп-фигуру можно несколькими полигонами.
Для удаления нарисованного шейпа нажимаем Delete 
[[Файл:Физика5.PNG|500px]]

=== Создание базы графических ресурсов ===
1. Запустить редактор ресурсов ResourcesEditor.exe. В меню File выбрать New Project. 
2. В окне базы создания ресурсов в строке "Папка проекта" указать путь на ранее созданную пустую папку Resources, затем в строке "Имя базы ресурсов" вписать имя корневой базы Learning_Base. 
[[Файл:00_26.PNG]] 
3. В корневой базе создать папку Create New Folder (например, папка Lesson_01). 
4.Загрузить исходники графики из папки Sources → Lesson_01. 
[[Файл:00 27.png]] [[Файл:00 28.png]] [[Файл:00_29.PNG]] 
В папке ресурсов Resources автоматически создается папка с корневой базой (в нашем случае Learning_Base), в которой автоматически появляются папка с графическими ресурсами Lesson_01 (для урока 1) и файл Learning_Base.sirx 
[[Файл:00 30.png]] 
'''Внимание! Прямое изменение структуры файлов в папке Resources запрещено. Допускается работа только через редактор ресурсов.'''

=== Автоматическое создание базы ===

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

[[Файл:00_30a.PNG]] [[Файл:00_30b.PNG]]

=== Действия с ресурсами в Resources Editor ===
==== Общие свойства и действия с ресурсами====
'''После любых действий в редакторе ресурсов необходимо обновить базу ресурсов в Редакторе сцен!'''
*каждому ресурсу присваивается уникальный номер.
*при добавлении ресурса - присваивается следующий по порядку уникальный номер
*при экспорте экранов в текущий проект ресурсы добавляются автоматически в базу текущего проекта и присваиваются им следующие по порядку уникальные номера
*может существовать несколько ресурсов с одинаковыми именами
*ресурсы могут быть автоматически добавлены в текущий проект или добавлены из другой базы ресурсов
*ресурсы могут быть удалены, модифицированы 

==== Графические ресурсы====
В редактор ресурсов подгружаются графические форматы:
*JPEG - изображение, не имеющее прозрачности. Может использоваться для "облегчения веса", в качестве фонового изображения или для паззла;
*PNG - может поддерживать прозрачность, произвольные границы изображения. Сохраняет высокое качество изображения.
=====Cоздание бордера изображения=====
[[Файл:00_37.PNG|right]]
Для уменьшения вероятности появления графических артефатов вокруг изображений рекомендуется создавать прозрачную область вокруг изображения. Размеры бордера задаются в пикселях. 
Для создания прозрачной области кликаем по изображению и меняем параметр BorderSize на панели настройки ресурса(см. рисунок справа) 
Для создания бордеров у всех ресурсов выбираем меню Projects – Options и на вкладке Cropping Settings параметру Transparent Border Size присваиваем нужное значение. 
[[Файл:00_46.PNG|00_46.PNG]] [[Файл:00_47.PNG]] 
=====Точка пивота=====
Иногда возникает необходимость сместить точку вращения обьекта вокруг своей оси (точку пивота). 
Для этого в редакторе ресурсов выбирем редактируемый обьект и в панели настроек ресурса изменим значения параметров Pivot. 
Если мы хотим произвольно задать координаты точки пивота, то ставим галочку Edit Pivot и после этого «таскаем» редактируемый ресурс по области визуализации ресурсов. Точка пивота находится в центре экрана (красный крестик)

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

=====Настройки текстур=====
параметр texture mode [[Файл:Texture mode resource editor.jpg]] определяет принадлежность картинки к текстуре.
*Если стоит -1, то картинка которая используется только на одном экране вместе с такими же картинками(которые используются только на том же экране что и выбранная) на этом экране будут упакованы в текстуру, если все картинки не поместятся в текстуру размером 1024х1024, то те картинки, которые не поместились попадут в 2-й файл текстуры.
*Если картинка используется на нескольких экранах, то в текстуру она не попадёт.
*Если стоит 1, 2, 3 и т.д до 100, то данная картинка объединится в текстуру вместе с картинками у которых стоит такое же значение в texture mode. Если все не поместятся в одну текстуру размером 1024х1024, то не поместившиеся изображения попадут в 2-ю текстуру и т.д..

====Анимация====
Анимация создается путем вызова кнопки add_animations и выбором нескольких графических файлов из любой папки 
[[Файл:00_40.PNG]][[Файл:00_41.PNG|300px]] 
После загрузки анимации можно изменить ее параметры. Например, изменить скорость анимации (смены кадров) и зациклить, поставив галочку напротив Looped. 
В левой части нижнего окна анимации находится список загруженных изображений, в правой - последовательность изображений (кадров), которые можно менять местами, добавлять/удалять, загружать в прямом/обратном порядке. Таким образом, можно "уменьшить вес" анимации за счет использования меньшего количества исходных изображений. 
[[Файл:00_43.PNG]][[Файл:00_44.PNG]] [[Файл:00_45.PNG]]

====Звуковые файлы====
Звуковые файлы нам нужны для озвучки персонажей и не только. Используются файлы в форматах: 
*mp3 - используется как ресурс для длинного звука mus. Звуки такого формата могут воспроизводиться только последовательно.
*ogg - используется как ресурс для короткого звука snd (snd-звуки могут воспроизводиться параллельно) и для подключения голоса voice (если voice подключен к тексту, то воспроизводится последовательно). Имеет меньший объем, чем формат mp3.
Воспроизведение звуковых файлов устанавливают через различные обьекты. Например, через состояния обьекта Machine
[[Файл:00_48.PNG]] 

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

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

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

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

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

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

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

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

[[Category:Projects]]

Slotmachine

2017-01-23T08:54:49Z

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

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

==Общие параметры==
(см. описание [[Object|Object]])

[[Файл:Slot settings.png|right]]
* '''тип''' - тип объекта
* '''имя''' - имя объекта
* '''синхронизация''' - синхронизация между лейаутами
* '''положение'''
** '''x''' - положение объекта по оси х
** '''y''' - положение объекта по оси y
* '''размер'''
** '''w''' - ширина объекта в пикслях
** '''h''' - высота объекта в пикселях
* '''модификаторы'''
** '''alpha''' - прозрачность объекта от 0 (прозрачен) до 1 (не прозрачен)
** '''angle''' - угол поворота в градусах. 0 - не повернут. Отсчитывается от оси х вниз. Вверх идут отрицательные углы.
** '''scale x''' - масштаб по оси х: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
** '''scale y''' - масштаб по оси y: 1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.
* '''файл уровня''' (''levelFile'') - Имя файла с уровнями
* '''вычислять размер''' (''calcsize'') - Вычислять размер исходя из ширины и высоты объекта или использовать размер картинок" ''calcsize'': размер графики = 0, размер объекта = 1
* '''сдвиг по y''' (''y_shift'') - Смещение иконок по y.
* '''множитель скорости''' (''speedm'') - Множитель скорости для изменения направления вращения барабана.
* '''эффект ячейки''' (''effect_obj'') - Объект, который склонируем для выигрышной ячейки. Флаер или машина с состоянием beg без подобъектов
* '''доп. эффект ячейки''' (''effect_obj2'') - Объект, который склонируем для выигрышной ячейки. Флаер или машина с состоянием beg без подобъектов. Дополнительный объект удобно использовать для копирования различный flyer-анимаций выигрыша ячейки, при этом основной эффект чаще всего является объектом, которому заменяется графика из полей "эффект ячейки".
* '''эффект линии''' (''line_obj'') - Машина, обеспечивающая анимацию выигравших линий. Должна иметь состояния line_0 ... line_N (N от 4 до 24)
[[Файл:Slot_2.PNG|200px|thumb|right|пример машины для анимации линий]]
* '''ribbon''' (''ribbon_obj'') - Объект типа [[Ribbon]] для эффекта линии. В нем будут использоваться ресурсы, указанные в доп.параметре с эффектом линии.
* '''смещение ribbon''' (''ribbon_y_shift'') - Смещение объекта ribbon вниз в % от высоты ячейки. Задается в единицах процентов от 1 до 100.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается случайно, 1 - эффект ячейки выбирается последовательно (для первой выигравшей - первый по порядку, второй - второй и т.д), 2 - по номеру линии (каждой линии будет соответствовать ресурс для ribbon и ресурс для эффекта ячейки, взятый по порядку из добавляемых свойств. Т.е если комбинация выпала на линии 14, то для неё будут использованы ресурсы, указанные в 14том по порядку добавляемом свойстве).
* '''линии или пути''' (''linespath'') - Использовать для вычисления выигрыша линии или пути.
* '''макс. число линий"''' (''max_lines'') - Если задано больше 0, то нельзя поставить более чем на столько линий. Не может превышать число реально заданных линий. При вызове add_bet ставка не сможет превысить это значение.
* '''последовательные эффекты''' (''order_effects'') - 0 - эффект ячейки выбирается рандомно (описано ниже, исторический параметр, не используется), 1 - эффект ячейки выбирается последовательно (выиграли линии 4,12,25. Для 4 - первый эффект, 12 - второй добавленные и т.д), 2 - по номеру линии (выиграли линии 4,12,25. Для 4 - эффект 4 (порядковый номер в списке добавленных), для 12 - 12-й и т.д). Сделано для того, чтобы номер линии всегда был связан с определенным цветом. Иконка линии обычно окрашена в этот же цвет.
* '''видимых строк''' (''max_rows'') - "высота" слота. Количество строк для отображения. Пр.: Если слот 5х3, то 3.
* '''подсчет бонусных иконок''' (''bonuscalc'') - 0 - на любом месте на поле, 1 - на активной линии (если играем на 9 линий, а иконки выпали на 11той - бонусная игра не будет запущена), 2 - на активной линии подряд (аналогично предыдущему, но без пропуска иконок по столбцам, т.е на линии и последовательно, как обычная иконка)
* '''считать линии в обе стороны''' (''twowayscalc'') - 0-нет, 1-да (обычно линии считаются с самой левой иконки в сторону правой. Есть случаи, когда отдельная иконка или все линии считаются как слева-направо так и справа-налево. В таком случае обязательно (и это учтено в объекте), что награда за 5 выпавших иконок НЕ УДВАИВАЕТСЯ)
* '''время подсветки всех линий''' (''allLinesTime'') - время, которое будут показываться ribbon для всех выигравших линий. После окончания этого времени будет вызван обработчик из добавляемого свойства. Если значение 0 - сразу идем перебирать эффекты линий (запускается обработчик для начала этой процедуры, которая запускается и управляется НЕ ИЗ ОБЪЕКТА).
* '''прятать иконки линий''' (''lineicohide'') - 0 - не прятать, 1 - по видимости (если линий меньше N, то по vis будут выключены все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N), 2 - первый второй фрейм (если графика доб. объектов-иконок была фреймовой анимацией, то если N меньше максимального кол-ва линий - все объекты иконок линий из добавляемого свойства, порядковый номер которых больше N отобразят второй фрейм). Это сложно описано, я знаю.
* '''показывать все линии при добавлении''' (''alllineswhenadd'') - при изменении кол-ва активных линий (вызове состояний add_line dec_line) показывать или не показывать эффекты для ВСЕХ активных линий. Вызываются последовательно эффекты для каждой линии (выглядит как отрисовка абсолютно всех риббонов, учитывая настройку выше).
* '''чит''' (''cheat'') - Желаемый результат. Будет выпадать всегда, пока это поле заполнено. По сути - это порядковый номер иконки в каждой рельсе. Имеет вид (1, 5, 6, 2, 4). Т.е на поле в позиции [1,1] будет иконка 1 (не id, а порядковый номер в r1[1]), [1,2]==r2[5] и так далее.
* '''число симуляций перед спином''' (''simNum'') - Перед спином будет проведено n симуляций и выбрана лучшая.
* '''ставки''':
** '''economics''' (''economics'') - объект экономики, чтобы объект знал о всех параметрах игрока и его прохождении.
** '''использовать''' (''use'') - Автоматическое снятие и начисление монет и опыта. Нет - не снимаем ставки, не начисляе выигранное; да - снимаем и начисляем.
** '''значения ставок''' (''betValues'') - УПОРЯДОЧЕННЫЙ (я не просто так выделил) массив значений ставки. Значения могут нелинейно расти и шаг может меняться от ставки к ставке. РАЗМЕР этого массива должен точно совпадать с размером следующего.
** '''уровни ставок''' (''betLevels'') - упорядоченный массив уровней к предыдущему. Обязательно должны совпадать по размеру. Каждому значению из betValues[i] соответствует betLevels[i]. Означает уровень, на котором станет доступной то или иное значение ставки.
* '''счетчики''':
** '''число линий''' (''cntLinesNum'') - изменяется при вызове add_line, remove_line и отображает текущее число активных линий.
** '''ставка на линию''' (''cntLineBet'') - изменяется при вызове add_bet, dec_bet и отображает текущую ставку.
** '''итого''' (''cntTotalBet'') - отображает суммарную ставку (перемноженные значения из полей выше). Изменяется автоматически при вызове предыдущих состояний.

* '''копилка''': при каждом начале спина - происходит снятие ресурса за спин в размере суммарной ставки и в отдельное укромное место (mboxOptions) помещается сумма, равная rand(min;max)*total_bet, если в укромном месте не накопилась сумма большая или равная значению из mboxValues при текущем уровне XP.
** '''ключ в опциях''' (''mboxOptions'') - Ключ в опциях (КОРРЕКТНОСТЬ ЗНАЧЕНИЙ НА ПОЛЬЗОВАТЕЛЕ)
** '''процент min''' (''mboxMin'') - процент min.
** '''процент max''' (''mboxMax'') - процент max.
** '''значения предела''' (''mboxValues'') - Значения предела
** '''уровни предела''' (''mboxLevels'') - Уровни предела

* '''интрига''':
** '''множитель интриги''' (''speedi'') - Множитель скорости для режима интриги.
** '''ячеек для интриги''' (''numi'') - Сколько иконок одного типа должны выпасть (учитывая условия активации бонуса), чтобы запустился режим интриги.
** '''эффект интриги''' (''intrigue_obj'') - Машина, обеспечивающая анимацию при режиме интриги. Будет склонирована в центр рельсы, должна иметь состояние beg. Объект будет скопирован для каждой рельсы, где будет запущен режим. Прячется или при вызове состояния '''hide_animation''' или в начале спина.

*'''расширение wild по вертикали''' - срабатывает (при wildexp_t != -1), когда wild участвует в построении выигрышной цепочки. Расширяется на весь барабан (реализовано для высоты барабана == 3 иконка). После чего происходит еще одна итерация проверки выигрышей.
* '''задержка''' (''wildexp_t'') -
* '''эффект вниз на 2''' (''wildexp_down2'') - машина, которая клонируется для эффекта и помещается в ячейку, которая сработала. Может запускать фреймовую анимацию или видео. Видео должно расширяться вниз.
* '''эффект вверх и вниз''' (''wildexp_updown'') - Видео должно расширяться вниз и вверх на высоту одной иконки.
* '''эффект вверх на 2''' (''wildexp_up2'') - Видео должно расширяться вверх на высоту двух иконок.

* '''рельсы''' - пять полей с номерами иконок. '''ВАЖНО:''' Появление в рельсе иконки с порядковым номером выше, чем максимальное кол-во иконок - вызовет падение viewer с ошибкой в log.
** '''рельса N''' (''r1..r5'') - Рельса N - номера иконок (начиная с 0) через запятую. Пустая строка - игнорировать рельсу
* '''параметры вращения''':
** '''time''' (''spin_t'') - Время вращения левого барабана.
** '''time step''' (''spin_t_step'') - Время на которое каждый последующий барабан крутится дольше предыдущего. (''таким образом был реализован эффект последовательной остановки барабанов, как в механической версии данного автомата'')
** '''time delta''' - Случайная погрешность для времени вращения барабана. Нужна для исключения появления устойчивых наборов иконок. Составляет обычно 10% от времени вращения барабана. Чем больше эта погрешность - тем большее влияние будет давать значение числа симуляций перед окончанием спина. Влияет на разброс места остановки барабана. Не должна давать разброс больше 1-2 иконок.
** '''vel min''' (''min_vel'') - Минимальная скорость вращения (левый барабан)
** '''vel max''' (''max_vel'') - Максимальная скорость вращения (правый барабан).

* '''звуки''':
** барабан вращается (''sndspin'') - барабан вращается.
** барабан вращается (''sndspin2'') - барабан вращается.
** барабан вращается (''sndspin3'') - барабан вращается.
** барабан вращается (''sndspin4'') - барабан вращается.
Как можно заметить - тут аж 4 звука вращения барабанов. Если указаны все или больше двух, то порядок воспроизведения такой:
Первый спин - первый звук. Второй спин - звук два и так далее зациклено. Если объект был проинициализирован или были бесплатные спины - очередь сбрасывается. Параметры 2-4 являются НЕОБЯЗАТЕЛЬНЫМИ.
** барабан фриспины (''sndspinf'') - барабан вращается (звук вращения во время бесплатных спинов).
** запуск барабанов (''sndstart'') - запуск барабанов.
** остановка барабана (''sndstop'') - остановка барабана.
** остановка барабана (''sndstop2'') - остановка барабана 2.
** остановка барабана (''sndstop3'') - остановка барабана 3.
** остановка барабана (''sndstop4'') - остановка барабана 4.
** остановка барабана (''sndstop5'') - остановка барабана 5.
** выигрыш (''sndwin'') - выигрыш.
** проигрыш (''sndfail'') - проигрыш.
** особая комбинация (''sndspecial'') - особая комбинация.

*'''пять в ряд''' - особый случай,когда длина цепочки равняется числу барабанов. Пример: пять иконок на линии при размере слота 5 на 3.
** '''объект для картинки''' (''line5_obji'') - Объект, ресурс которого будет заменен на ресурс иконки, которая участвовала в таком событии. Если таких иконок было несколько - выберется самая дорогая из них, учитывая таблицу выплат.
** '''объект для состояния''' (''line5_objs'') - объект для состояния
** '''состояние''' (''line5_st'') - Новое состояние для объекта из предыдущего поля.

*'''big win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, но меньше чем у mega win, то вызовется этот обработчик. Пример big_value = 5 , mega_value = 25. Если win/total bet >= 5 и <=25, то big win. Если больше 25 - mega win.
** '''значение''' (''big_value'') - значение отношения.
** '''каунтер''' (''big_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''big_objs'') - объект для состояния
** '''состояние''' (''big_st'') - Новое состояние для объекта из предыдущего поля.

*'''mega win''' - если суммарный выигрыш и суммарная ставка относятся как значение из следующего поля и больше, то вызовется этот обработчик.
** '''значение''' (''mega_value'') - значение отношения.
** '''каунтер''' (''mega_obji'') - счетчик, куда будет помещено значение выигрыша и он будет проанимирован.
** '''объект для состояния''' (''mega_obji'') - объект для состояния
** '''состояние''' (''objid'') - Новое состояние для объекта из предыдущего поля.

*'''scatter без scatter''' - включение режима бесплатных спинов БЕЗ иконки типа scatter.
** '''спинов подряд min''' (''spinspreemin'') - Мин. число спинов подряд для дополнительных скаттеров
** '''спинов подряд max''' (''spinspreemax'') - Мaкс. число спинов подряд для дополнительных скаттеров
** '''вероятность''' (''addscatterp'') - Вероятность того, что дадим фриспины
** '''дать скаттеров min''' (''addscattermin'') - Мин. число скаттеров, которое дадим.
** '''дать скаттеров max''' (''addscattermax'') - Максимальное число.

Как работает:
Игрок делает спины подряд, не считаем прерыванием цепочки включением дополнительных механик.
Если номер текущего спина в серии больше или равен spinspreemin - каждый спин с вероятностью addscatterp можно получить от addscattermin до addscattermax спинов (равновероятно).
Если номер спина превысил spinspreemax - включаем с вероятностью == 1. Т.е в любом случае.

*'''фри спины''' -
** '''рельса 1-5''' (''r1s-r5s'') - дополнительные рельсы на бесплатные спины. Заменяют основные.
** '''осталось спинов''' (''cntFreeSpins'') - сколько осталось спинов из начисленных за выпавшие иконки. Счетчик, который заполняется объектом и перисовывается в начале каждого спина.
** '''выигрыш''' (''cntFreeSpinsWin'') - сумма всех заработанных монет за выпавшие бесплатные спины.
** '''задержка перед след. спином выигр''' (''freeWinDelay'') - задержка перед началом следующего спина, если был выигрыш.
** '''задержка перед след. спином проигр''' (''freeLooseDelay'') - задержка перед началом следующего спина, если был проигрыш.

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

* '''иконка''' (''slotico'') - добавляемый параметр с настройками иконки:
** '''графика''' (''icores'') - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Можно использовать фреймовую анимацию, которая будет использовать все настройки редактора ресурсов.
** '''тип''' (''icotype'') - Тип иконки. 0 - обычная, 2 - Bonus, 1 - Wild, 3 - Scatter, 4- бонусная иконка, начисляет деньги. 0 - обычная иконка. 2 - при выпадении N и больше иконок на барабанах (учитывая настройку выше) - вызывается обработчик. 1 - бонусная иконка, при попадании ее в линию - может заменить любую иконку и даёт возможность продолжить/начать/закончить игровую линию. 3 - механика схожа с бонусной иконкой, но вызывает уже бесплатные спины. 4 - иконка, при выпадении N иконок и более начисляется награда за каждую иконку в размере множитель*суммарная ставка. Множитель пересчитывается для каждой иконки отдельно.
** '''выигрыш''' (''icowin'') - Выигрыш по иконке. За 1, 2, 3 и т.д. иконку в линии.
** '''эффект ячейки''' (''icoeffect'') - Объект, который склонируем для выигрышной ячейки. Флаер или машина с состоянием beg без подобъектов
** '''доп. эффект ячейки''' (''icoeffect2'') - Дополнительный объект удобно использовать для копирования различный flyer-анимаций выигрыша ячейки, при этом основной эффект чаще всего является объектом, которому заменяется графика из полей "эффект ячейки".
''если эти поля не заполнены - используются эффекты по умолчанию''
** '''прятать основную картинку при эффекте''' (''icohide'') - прятать ли ресурс иконки при включении основного эффекта ячейки или дополнительного.
** '''не рисовать следующих''' (''icoskip'') - если хотим отрисовать длинную иконку (высота больше одной иконки, к примеру - равна высоты всей рельсы), то указываем сколько иконок не рисовать после текущей (в рельсе это выглядит как 222), при этом точку пивота у графики следует разместить в верхней трети.
** '''объект иконка''' (''icoobj'') - объект, в который поместим графику иконки из поля icores. Нужна для оформления таблицы выплат.
** '''объект текст''' (''icotxt'') - объект, в который поместим значения выплат из поля icowin. Нужна для оформления таблицы выплат.
** '''цвет 1''' (''icocolor1'') - цвет, который будем использовать в текстовом объекте.
** '''цвет 2''' (''icocolor2'') - <цвет 1>5 - </цвет 1><цвет 2>icowin[5]|</цвет 2><цвет 1>4 - </цвет 1><цвет 2>icowin[4]|</цвет 2> и так далее.
** '''превращаться в вайлд при соседях''' (''transwild'') - Для слота "Русалки". Превращаться в вайлд при соседях, у которых этот параметр так же равен единицы. Только при активных фриспинах. При срабатывании включаем эффект превращения.
** '''эффект превращения''' (''transwildeffect'') - эффект превращения
** '''направление''' (''dir'') - 0-слева направо, 1-справа налево, 2-обе. Эта настройка нужна для того, чтобы не у всех линий менять направление подсчета выигрыша, а только у конкретной иконки (к примеру у дорогой, которая очень редко встречается).
** '''тип 4. кол-во''' (''type4val'') - только для типа 4. Сколько иконок типа должно появиться, чтобы сработал эффект, срабатывает если больше 0 хотя бы один элемент из массива.
** '''тип 4. мин''' (''type4min'') - массив целых через запятую, означает нижний предел множителя.
** '''тип 4. макс''' (''type4max'') - массив целых через запятую, означает верхний предел множителя.
** '''тип 4. текст''' (''type4text'') - id объекта, счетчик. Сумма выигрыша помещается в значение счетчика, после чего он анимируется.
** '''тип 4. dx''' (''type4dx'') - смещение счетчика относительно пивота иконки по x
** '''тип 4. dy''' (''type4dy'') - смещение счетчика относительно пивота иконки по у
** '''звук''' (''icosnd'') - звук иконки. Срабатывает после выигрыша иконки.

<pre>
Пример:

0, 1, 0, 0 - за строку начисляется выигрыш (1), если подряд попадается одна такая иконка.

0, 0, 10, 0 - за строку начисляется выигрыш (10 очков), если подряд попадаются две таких иконки.

0, 0, 0, 5 - за строку начисляется выигрыш (5 очков), если подряд попадаются три таких иконки.
</pre>
[[Файл:Slot_3.gif|thumb|right|пример расположения линий]]

'''Важно! Иконки в линии считаются слева направо. На изображении линии 6 и 7 перепутаны.'''

Текущий выигрыш можно узнать считав параметр '''current_win''' у объекта.
Количество линий, эффект для которых нужно показать отображает параметр '''lines_num'''. Считывается у объекта. Обновляется каждый раз при выполнении '''next_line_effect'''.

==Состояния==
* '''Основные''':
** '''spin''' - запустить барабаны
** '''add_line''' - добавить еще одну линию как игровую. При этом автоматически запускается эффект линии и переводится в состояние, соответствующее номеру последней добавленной линии.
** '''remove_line''' - убирает одну линию. Одна линия для проверки - минимум, убрать её нельзя.

''Оба состояния '''add_line''' и '''remove_line''' передаются с параметром кол-ва линий. par=param val=кол-во линий, аналогично dval у counter.''

** '''clear''' - убрать все строки (кроме первой) для проверки выигрыша
** '''next_line_effect''' - вызывает эффект для следующей линии. Одновременно с этим вызывается эффект для ячейки.
** '''stop''' - остановить барабаны. Вызывается с параметром param от 0 до 4 для остановки конкретного барабана. Примечание: перевод объекта в состояния
add_line и clear во время вращения барабана - приводит к его остановке.
** '''stop_all''' - останавливает барабаны и пересчитывает награду (выпавшие линии), предназначено для остановки барабана по рычагу/кнопке .
** '''shuffle''' - новое начальное положение барабана (выбирается случайная иконка на всей рельсе и от неё отображаются иконки на всех рельсах).
** '''hide_animation''' - спрятать все эффекты линии и ячейки, которые были склонированы. Удобно использовать при досрочном закрытии мини-игры. Если вам нужно открывать что-то поверх активного слота ( во время показа анимации), вам нужно эти окна положить в отдельную сцену поверх сцены со слотом, т.к. анимация копируется в сцену со слот машиной.
** '''add_bet''' - увеличить ставку (значение ставки берется из соответствующего поля. Максимальное и минимальное значения зависят от уровня опыта игрока)
** '''dec_bet''' - уменьшить ставку
** '''max_bet''' - поставить максимальную ставку
** '''start_free_spins''' - начать режим бесплатных спинов (если scatter_num > 0).
** '''pause_free_spins''' - приостановить режим бесплатных спинов. Скопирует значение из scatter_num в опции по ключу slot%id%.saved_scatter. При этом scatter_num обнуляется.
** '''resume_free_spins''' - продолжить бесплатные спины. Скопирует значение по ключу и вставит его в scatter_num.
** '''autotest''' - для текущего lvlNum запустит автоматический спин с текущей ставкой и кол-вом линий N раз. N берется из param у объекта.
** '''clear_spree''' - очищаем очередь спинов для scatter без scatter
** '''clear_stats''' - очищаем параметры для статистики.

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

Меню выбора ''Добавляемые параметры'' к объектам активируется по правой кнопки мыши.

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

[[Файл:+.png]] '''изменить состояние объекта - бросок завершен выигрыш''' - При current_win!=0 по завершению вращения перевести слушателя в состояние.
*'''объект'''- объект - состояние которого меняем.
*'''состояние'''- состояние - значение нового состояния

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

[[Файл:+.png]] '''изменить состояние объекта - есть свободные спины''' - scatter_num стал больше нуля, что означает, что выпали бонусные иконки. Запускается обработчик.

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

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

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

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

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

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

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

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

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

[[Файл:+.png]] '''фриспины за расклад''' - если на поле выпали иконки, где каждая "строка" слота совпадает с шаблоном - начисляем бесплатные спины.
*'''расклад для строки''' - массив целых через запятую, обозначающих первую строку. Длина массива == кол-во барабанов.
*'''число фриспинов''' - кол-во бесплатных спинов, которое начислим за выпадение такой комбинации

[[Файл:+.png]] '''''' -

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

[[Файл:+.png]] '''эффект ячейки''' - При current_win!=0 по завершению вращения заменяет из набора ресурсов таких дополнительных свойств графику для клонируемого эффекта ячейки.
*'''клип'''- ресурс. Перетаскивается из базы ресурсов.
<pre>
Графика в виде фреймовой анимации. Допустим у нас есть набор из 8-ми анимаций.

Работает такая логика при выборе графики (если стоит настройка СЛУЧАЙНО):

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

2. Для всех последующих в этом спине выигранных линий — графика последовательно выбирается из набора (оставшейся графики) в произвольном порядке.

3. Если линий больше 8-ми — повторяем с первого пункта, выбирая первой графику отличную от 8-мой.

Пример:

1й спин — выпало 12 линий.

0, 2, 4, 3, 5, 7, 1, 6 … (начинаем не с 6) 4, 0, 3, 1

2й спин — выпало 6 линий.

(начинаем не с 0) 5, 6, 7, 1, 0, 3

где 0..7 — номера анимаций.
</pre>

==Дополнительные настройки механик==

===Scatter без scatter===

Есть возможность начислять бесплатные спины без использования специальной иконки.

Для этого разработана такая методика:
После совершения подряд MIN спинов - после каждого последующего спина до MAX есть вероятность P начислить игроку N бесплатных спинов.
Если номер спина в последовательности спинов превысил MAX, то бесплатные спины начисляются с вероятностью P=1.

При этом указываем

<code>
spinspreemin="16" spinspreemax="66" addscatterp="0.03" addscattermin="7" addscattermax="9"
</code>

Это значит, что начиная с 16-го спина по 66-й включительно с вероятностью 3% будет начислено от 7 до 9ти бесплатных спинов (7,8 или 9 равновероятно).

При чем во время самих бесплатных спинов очередь продолжается, но так как 16>7, то выпасть дополнительные спины во время бесплатных не могут.

Перед выходом из слота ОБЯЗАТЕЛЬНО очищаем очередь путём вызова объекту состояния *clear_spree*.

Частота выпадения бесплатных спинов и регулировка отдачи с их помощью можно осуществить изменяя параметры addscatterp и spinspreemin/spinspreemax.

===Линии или пути===

Часто можно встретить вместо привычных линий так называемые "пути" или "ways". И их почему-то огромное кол-во, в сравнении с линиями.
243 ways на слоте с тремя рядами и пятью барабанами. Это означает то, что мы играем сразу на все возможные линии, которых всего может быть 3^5=243. Таким же образом в слоте 4x5 всего 1024 пути.

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

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

Пример: иконка1 встретилась на 1-й, 2-й и 3-ей рельсе по одной на каждой. Иконка1 участвовала в построении выигрышной цепочки длинной 3 иконки.

У объекта в GData можно найти параметр linespath=0 или 1. Удобно ориентироваться по нему для изменений в UI, к примеру.

===Превращение в wild при соседях===

Механика, позволяющая наделить обычную иконку св-вами wild при особых условиях.
Условия:
Режим бесплатных спинов активен.
На соседних рельсах попали иконки, у которых параметр transwild=1.
[[Файл:mermaid_free_spins_wild.png|200px|thumb|left]]
При выполнении условий у иконок включается специальный эффект, который может являться машиной, которая запускает видео/фреймовую анимацию.

===Тип иконки 4===

Данный тип иконки нужен для начисления ресурса1 за выпадение N иконок на поле.
Т.е условия запуска механики такие же, как и для иконки scatter.
Но в данном случае начисляются не бесплатные спины, а ресурс.

А вот и пример:

<code>
<slotico icores="1080" icotype="4" icowin="0,0,0,0,0,0" type4val="3" type4min="0,0,0,1,5,10" type4max="0,0,0,3,15,20" type4text="2383" type4dx="-5" type4dy="45" icoobj="3566" icohide="1" icoeffect2="5409"/>
</code>

Обратите внимание, что массивы type4min и type4max - связаны.

Как это работает:
Выпало 3 иконки на поле.
Для них мы включаем эффект2, сами иконки прячем.
За каждую иконку начисляем от type4min[3] до type4max[3] суммарных ставок.
Суммарная ставка была 100 монет. Выпало три иконки. За первую мы начисляем 100, 200 или 300 монет. За вторую и за третью аналогично.
Поверх эффекта2 будет отрисован и проанимирован счетчик type4text, со значением равным выигрышу за каждую из иконок соответственно.
При этом счетчик будет смещен на type4dx и type4dy относительно центра иконки (которая совпадает с пересечением диагоналей ячейки).

==Автотест==

Запускается автотест из viewer путём вызова состояния *autospin* объекту слота.

Дополнительные параметры param - кол-во спинов, которые будут сделаны и param2 - кол-во итераций.

После начала режима создается файл возле options.xml с результатами автотеста, который заполняется по ходу работы.

Файл имеет название id из файла уровней _ кол-во спинов из param _ name из файла уровней _ месяц _ день _ часы _ минуты
Если на момент запуска новой итерации время не изменилось - идет дозапись в текущий файл.

Внутри csv-файла видим таблицу

{| class="wikitable" style="text-align: center"
|spin
|slot id
|lines
|line bet
|res1before
|res1after
|win
|type
|pos1
|pos2
|pos3
|pos4
|pos5
|bonus_num
|-
|номер спина
|id из файла уровней
|сколько линий
|какая ставка на линию
|баланс до спина
|баланс после спина
|выигрыш за спин
|тип спина r/f обычный/бесплатный
|позиция на рельсе1
|позиция на рельсе2
|позиция на рельсе3
|позиция на рельсе4
|позиция на рельсе5
|множитель бонусный игры, если был
|}

По окончанию итерации будет выведена краткая статистика:

return = отдача

free spins = кол-во бесплатных спинов

win spins = количество победных спинов

bonus spins = кол-во бонусных игр

big win = кол-во big win

mega win = кол-во mega win

[[Категория:Game mechanic]]

Planet

2016-08-10T11:29:30Z

Vgat: /* Основные параметры */

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

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

'''Размер экрана''' - Размер игрового поля за пределами которого планеты не будут рисоваться.
*'''Ширина''' ''(ws)'' - Размер поля по оси X.
*'''Высота''' ''(hs)'' - Размер поля по оси Y.
'''Положение первой планет''' - Расстояние от стартовой планеты, с которой игрок начинает игру до первой планеты на которую он может приземлиться.
*'''x''' ''(fplx)'' - Координаты первой планеты по оси X.
*'''y''' ''(fply)'' - Координаты первой планеты по оси Y.
'''Расстояние между планетами''' - Диапазоны расстояний между планетами (не учитывается первая).
*'''min x''' ''(minx)'' - Минимальное расстояние между планетами по оси X.
*'''max x''' ''(maxx)'' - Максимальное расстояние между планетами по оси X.
*'''min y''' ''(miny)'' - Минимальное расстояние между планетами по оси Y.
*'''max y''' ''(maxy)'' - Максимальное расстояние между планетами по оси Y.
'''Звуки игры''' - Звуки, воспроизводимые в игре.
*'''Прыжок''' ''(sndJ)'' - Звук, который воспроизводится при прыжке.
*'''Приземление''' ''(sndG)'' - Звук удачного приземления на планету
*'''Улетел''' ''(sndB)'' - Звук, когда астронавт улетел за пределы игрового экрана/попал на солнце
'''Времена игры'''
*'''Перемещение камеры''' ''(tmMovCam)'' - Время за которое перемещается камера за астронавтом.
'''Скорости игры'''
*'''Вращения''' ''(planetSpeed)'' - Средняя скорость вращения планеты.
*'''Разброс скорости вращения''' ''(planetSpeedDISP)'' - Дисперсия значений скорости вращения планеты.
*'''Прыжка''' ''(vjump)'' - Скорость прыжка совершаемого игроком.
'''Игрок-астронавт'''
*'''Графика''' ''(playerClip)'' - Графический ресурс игрового персонажа. Перетаскивается из базы ресурсов.
*'''Масса''' ''(playerw)'' - Масса астронавта.
'''Эффекты'''
*'''Приземление''' ''(eff_d)'' - Воспроизводится во время "приземления" астронавта на планету. Должен иметь состояние 'beg'.
*'''Прыжок''' ''(eff_u)'' - Звук удачного приземления на планету
*'''Полет''' ''(eff_f)'' - Воспроизводится во время "отталкивания" астронавта от планеты. Должен иметь состояние 'beg'.
'''Игровые очки'''
*'''Объект score''' ''(score)'' - Объект типа "каунтер". Счетчик очков
*'''кол-во за прыжок''' ''(sc_jp)' - Кол-во очков, которые начисляются за каждое успешное приземление на планету.
*'''кол-во за монету''' ''(sc_cn)' - Кол-во очков, которые начисляются за каждую подобранную монету.
'''Бонусные монеты'''
*'''Графика''' ''(coinClip)'' - Графический ресурс/анимация монет, которые вращаются вокруг планет и указывают правильный маршрут. Перетаскивается из базы ресурсов.
'''Монеты-путь'''
*'''кол-во монет''' ''(coinNum)'' - Количество монет, которые указывают правильный маршрут между планетами.
*'''Равномерно расставлять''' ''(cbCoin)'' - Чекбокс, который определяет как размещать звезды между планетами. "Да" - равномерно. "Нет" - использовать параметр "coinDist".
*'''Расстояние между монетами''' ''(coinDist)'' - Расстояние между монетами.
'''Монеты-планеты'''
*'''вероятность монет''' ''(coinProb)'' - Количество монет, которые указывают правильный маршрут между планетами.
*'''Кол-во монет вокруг планет''' ''(coinNumPl)'' - Чекбокс, который определяет как размещать звезды между планетами. "Да" - равномерно. "Нет" - использовать параметр "coinDist".
*'''Расстояние от планет''' ''(coinDistPl)'' - Расстояние между монетами.
*'''Радиус разворота''' ''(radOfRot)'' - Расстояние до планеты, приближаясь к которой, астронавт будет переворачиваться ногами вниз.
'''Easing'''
*'''Часть высоты''' ''(easing)'' - Часть высоты графики персонажа, на которую астронавт перед началом полета и при приземлении просаживается.
*'''Скорость''' ''(easingSpeed)'' - Скорость просаживания, которая является частью от скорости прыжка.

== Добавляемые параметры ==
[[Файл:Add_attribute.png|thumb|right|500|Добавляемые свойства]]
'''Добавить планету'''
*'''Графика''' ''(pl_gr)''- Графика планет. Добавляется из редактора ресурсов. В качестве ресурса может использоваться анимация.
*'''Эффект''' ''(eff_pl)''- Эффект, который рисует под планетой. Так же может быть и анимацией.
*'''Масса''' ''(pl_wg)''- Масса планеты
*'''Радиус''' ''(pl_rd)''- Радиус планеты в px. Если == 0, то используется размер графики
'''Добавить Солнце'''
*'''Графика''' ''(bh_gr)''- Графика "солнца". Добавляется из редактора ресурсов. В качестве ресурса может использоваться анимация.
*'''Эффект''' ''(eff_bh)''- Эффект, который рисует под "солнцем". Так же может быть и анимацией.
*'''Масса''' ''(bh_wg)''- Масса планеты
*'''Радиус''' ''(bh_rd)''- Радиус "солнца" в px. Если == 0, то используется размер графики
'''Добавить звук монеты''' - позволяет последовательно воспроизводить звуки подбора монет. Если задано больше 1-го звука, то первая монетка во время "подбора" воспроизведет 1-й звук, вторая - 2-й звук, и т.д.
*'''Звук''' ''(sndM)''- Звук при подборе монеты. Добавляется из редактора ресурсов.
== Состояния объекта ==
*'''reborn''' - Используется для "последнего шанса". В случае, если игрок промахнулся мимо планеты, у него должна быть возможность вернуться на крайнюю планету на которой он находился. При вызове этого состояния персонаж перемещается на планету с которой совершал прыжок.
*'''init''' - состояние с весьма ожидаемой реакцией. Объект начинает свою работу с самого начала. С первой планеты и полностью обнуляются заработанные монеты

Создание игры «Hidden Object Game»

2016-08-10T08:07:26Z

Vgat: /* ПРОГРЕСС */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов HiddenObjectList, HiddenObject и Table для типа механики Hidden Object Game на базе создания уровня из игры Travel.

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

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 создадим новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Для корректной работы на мобильном устройстве необходимо настроить параметр.

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья».

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи значение Word, Sentence-En, добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменить тип с image на [[HiddenObject]].

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

2. Создать специальные объекты [[Table]] и [[HiddenList]]. Для этого необходимо перенести графическое изображение table с последующим изменением типа с image на Table. Название объекта изменить на HOT**

[[Файл:07 5.png]]

3. Для объекта HiddenList перенести любое графическое изображение с последующим изменением типа с image на HiddenList и удалением графического ресурса из поля настроек (res)*. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HOL**

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

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HOL (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

3. Описание Table

[[Файл:07 9.png]]

6. Параметры, общие для всех спрятанных объектов:

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

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

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:07 11.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

== Упражнение № 6 ==
Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]), машиной-комбо3 ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

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

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) отображает уровень прохождения игры.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор, машину-комбо3 и прогресс в хиденлисте «HL_01» ([[hiddenList]]).

== СЧЕТЧИК ==

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто).
</blockquote>

‎[[Файл:Coun (5).png]] ‎[[Файл:Coun (6).png]] [[Файл:Coun (7).png]] [[Файл:Coun (8).png]] ‎[[Файл:Coun (9).png]] [[Файл:Coun_(10).png]] ‎[[Файл:Coun (11).png]] ‎[[Файл:Coun (1).png]] ‎‎[[Файл:Coun (2).png]] ‎[[Файл:Coun (3).png]] ‎[[‎Файл:Coun (4).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель перетаскиваем в отдельную графу без анимации. Настройки для счетчика:

[[Файл:243.png]] [[Файл:33.png]]

== ТАЙМЕР ==

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие. Настройки для таймера:

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

== ПРОГРЕСС ==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходить уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую.
Настройки для прогресса :

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

Графика для Progress: [[Файл:666.png]]

Настройки для машины-Combo3c :

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

Во всех HiddenObject изменить параметры и свойства объекта combo3c [[Файл:1818.png]]

Настройки для машины-блокатора «ban_H» (machine) :

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

Настройки для hiddenList:

[[Файл:1010.png]] [[Файл:1011.png]]

Группа - звезды combo num =1 Количество быстро найденных объектов, нужное для получения звезды Combo combo time = 3000 Интервал между кликами, считающимися быстрыми для Combo accuracy = 0,85 Точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные) лимит ложных кликов =5 Лимит ложных кликов. Формула расчета количество верных кликов делим на общее количество получаем коэффициент если он равен или больше указного нами то в опции пишем параметр, если нет то не пишем.

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

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

Графика для Rectangle black : [[Файл:0101.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Графика для Rectangle black используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_1 — игровые очки;

уровень: last_game.score30_total

2) счетчик 7_4_2 — бонус за время;

уровень: last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность;

уровень: last_game.score30_accuracy

4) счетчик 7_4_4 — бонус за комбо;

уровень: last_game.score30_time

5) счетчик 7_4_5 — очки за уровень;

уровень: last_game.score30_level

Настройки для машины — star1
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

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

Настройки для машины — star2
(если параметр accuracy=0)

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

Настройки для машины — star3
(если игра пройдена за указанное время)

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

Настройки для машины — win

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

Машина win считывает «read» показания счетчика и запускает star1 если игра пройдена.

Кнопка close закрывает окно вывода результатов изменением состояния обьекта win состоянием close.

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

----
{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 5]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 7]]
|}

[[Category:Learning]]

Создание игры «Hidden Object Game»

2016-08-10T08:02:31Z

Vgat: /* Детальная настройка объектов */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов HiddenObjectList, HiddenObject и Table для типа механики Hidden Object Game на базе создания уровня из игры Travel.

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

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 создадим новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Для корректной работы на мобильном устройстве необходимо настроить параметр.

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья».

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи значение Word, Sentence-En, добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменить тип с image на [[HiddenObject]].

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

2. Создать специальные объекты [[Table]] и [[HiddenList]]. Для этого необходимо перенести графическое изображение table с последующим изменением типа с image на Table. Название объекта изменить на HOT**

[[Файл:07 5.png]]

3. Для объекта HiddenList перенести любое графическое изображение с последующим изменением типа с image на HiddenList и удалением графического ресурса из поля настроек (res)*. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HOL**

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

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HOL (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

3. Описание Table

[[Файл:07 9.png]]

6. Параметры, общие для всех спрятанных объектов:

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

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

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без параметра ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:07 11.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

== Упражнение № 6 ==
Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]), машиной-комбо3 ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

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

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) отображает уровень прохождения игры.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор, машину-комбо3 и прогресс в хиденлисте «HL_01» ([[hiddenList]]).

== СЧЕТЧИК ==

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто).
</blockquote>

‎[[Файл:Coun (5).png]] ‎[[Файл:Coun (6).png]] [[Файл:Coun (7).png]] [[Файл:Coun (8).png]] ‎[[Файл:Coun (9).png]] [[Файл:Coun_(10).png]] ‎[[Файл:Coun (11).png]] ‎[[Файл:Coun (1).png]] ‎‎[[Файл:Coun (2).png]] ‎[[Файл:Coun (3).png]] ‎[[‎Файл:Coun (4).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель перетаскиваем в отдельную графу без анимации. Настройки для счетчика:

[[Файл:243.png]] [[Файл:33.png]]

== ТАЙМЕР ==

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие. Настройки для таймера:

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

== ПРОГРЕСС ==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходить уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую.
Настройки для прогресса :

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

Графика для Progress: [[Файл:666.png]]

Настройки для машины-Combo3c :

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

Во всех HiddenObject изменить параметры и свойства объекта combo3c [[Файл:1818.png]]

Настройки для машины-блокатора «ban_H» (machine) :

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

Настройки для hiddenList:

[[Файл:1010.png]] [[Файл:1011.png]]

Группа - звезды combo num =1 Количество быстро найденных объектов, нужное для получения звезды Combo combo time = 3000 Интервал между кликами, считающимися быстрыми для Combo accuracy = 0,85 Точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные) лимит ложных кликов =5 Лимит ложных кликов. Формула расчета количество верных кликов делим на общее количество получаем коэффициент если он равен или больше указного нами то в опции пишем параметр, если нет то не пишем.

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

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

Графика для Rectangle black : [[Файл:0101.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Графика для Rectangle black используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_5 — очки за уровень

уровень: Last_game.score30_level

2) счетчик 7_4_4 — бонус комбо

уровень: Last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность

уровень: Last_game.score30_accuracy

4) счетчик 7_4_2 — бонус за время

уровень: Last_game.score30_time

5) счетчик 7_4_1 — игровые очки

уровень: Last_game.score30_total

Настройки для машины — star1
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

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

Настройки для машины — star2
(если параметр accuracy=0)

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

Настройки для машины — star3
(если игра пройдена за указанное время)

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

Настройки для машины — win

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

Машина win считывает «read» показания счетчика и запускает star1 если игра пройдена.

Кнопка close закрывает окно вывода результатов изменением состояния обьекта win состоянием close.

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

----
{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 5]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 7]]
|}

[[Category:Learning]]

Создание игры «Hidden Object Game»

2016-08-10T07:56:43Z

Vgat: /* Детальная настройка объектов */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов HiddenObjectList, HiddenObject и Table для типа механики Hidden Object Game на базе создания уровня из игры Travel.

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

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 создадим новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Для корректной работы на мобильном устройстве необходимо настроить параметр.

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья».

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи значение Word, Sentence-En, добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменить тип с image на [[HiddenObject]].

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

2. Создать специальные объекты [[Table]] и [[HiddenList]]. Для этого необходимо перенести графическое изображение table с последующим изменением типа с image на Table. Название объекта изменить на HOT**

[[Файл:07 5.png]]

3. Для объекта HiddenList перенести любое графическое изображение с последующим изменением типа с image на HiddenList и удалением графического ресурса из поля настроек (res)*. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HOL**

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

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HOL (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

3. Описание Table

[[Файл:07 9.png]]

6. Параметры, общие для всех спрятанных объектов:

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

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

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без поля ''id игры'' (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:07 11.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

== Упражнение № 6 ==
Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]), машиной-комбо3 ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

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

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) отображает уровень прохождения игры.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор, машину-комбо3 и прогресс в хиденлисте «HL_01» ([[hiddenList]]).

== СЧЕТЧИК ==

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто).
</blockquote>

‎[[Файл:Coun (5).png]] ‎[[Файл:Coun (6).png]] [[Файл:Coun (7).png]] [[Файл:Coun (8).png]] ‎[[Файл:Coun (9).png]] [[Файл:Coun_(10).png]] ‎[[Файл:Coun (11).png]] ‎[[Файл:Coun (1).png]] ‎‎[[Файл:Coun (2).png]] ‎[[Файл:Coun (3).png]] ‎[[‎Файл:Coun (4).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель перетаскиваем в отдельную графу без анимации. Настройки для счетчика:

[[Файл:243.png]] [[Файл:33.png]]

== ТАЙМЕР ==

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие. Настройки для таймера:

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

== ПРОГРЕСС ==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходить уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую.
Настройки для прогресса :

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

Графика для Progress: [[Файл:666.png]]

Настройки для машины-Combo3c :

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

Во всех HiddenObject изменить параметры и свойства объекта combo3c [[Файл:1818.png]]

Настройки для машины-блокатора «ban_H» (machine) :

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

Настройки для hiddenList:

[[Файл:1010.png]] [[Файл:1011.png]]

Группа - звезды combo num =1 Количество быстро найденных объектов, нужное для получения звезды Combo combo time = 3000 Интервал между кликами, считающимися быстрыми для Combo accuracy = 0,85 Точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные) лимит ложных кликов =5 Лимит ложных кликов. Формула расчета количество верных кликов делим на общее количество получаем коэффициент если он равен или больше указного нами то в опции пишем параметр, если нет то не пишем.

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

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

Графика для Rectangle black : [[Файл:0101.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Графика для Rectangle black используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_5 — очки за уровень

уровень: Last_game.score30_level

2) счетчик 7_4_4 — бонус комбо

уровень: Last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность

уровень: Last_game.score30_accuracy

4) счетчик 7_4_2 — бонус за время

уровень: Last_game.score30_time

5) счетчик 7_4_1 — игровые очки

уровень: Last_game.score30_total

Настройки для машины — star1
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

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

Настройки для машины — star2
(если параметр accuracy=0)

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

Настройки для машины — star3
(если игра пройдена за указанное время)

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

Настройки для машины — win

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

Машина win считывает «read» показания счетчика и запускает star1 если игра пройдена.

Кнопка close закрывает окно вывода результатов изменением состояния обьекта win состоянием close.

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

----
{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 5]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 7]]
|}

[[Category:Learning]]

Создание игры «Hidden Object Game»

2016-08-10T07:55:31Z

Vgat: /* Детальная настройка объектов */

{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 6]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 8]]
|}
----
{{TOC right}}

'''Цель:''' Изучить настройки объектов HiddenObjectList, HiddenObject и Table для типа механики Hidden Object Game на базе создания уровня из игры Travel.

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

== Создание экрана и сцены в игровом проекте ==

Откроем проект lessons. Создадим экран Lesson_7. [[Файл:Lesson7_textbase.png|right]]
В экране Lesson_7 создадим новую сцену* stg_7 с разрешением 960*640 (по умолчанию), в которую (через ResourcesEditor) добавим графические ресурсы из папки Lesson_7. (см. подготовка к работе [[Создание проекта]])

* Для корректной работы на мобильном устройстве необходимо настроить параметр.

* Графические объекты должны разместиться точно на местах предназначенных для их «Прятанья».

Создадим папку Lesson_7 в базе текстовых описаний с помощью TextEditor. Добавим в неё 10 текстовых записей, соответствующих именам поисковых объектов. Заполним для каждой текстовой записи значение Word, Sentence-En, добавим графическое отображение поискового объекта. Сделать это можно вручную, перетащив картинку соответствующего объекта из редактора ресурсов и, по нажатию на картинке правой кнопкой мыши, выберем тип "icon1". Или же более быстрым [[Интерфейс TextEditor#Добавление иконок в текстовый элемент | способом]].

== Общая настройка объектов ==

1. Для всех поисковых графических объектов изменить тип с image на [[HiddenObject]].

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

2. Создать специальные объекты [[Table]] и [[HiddenList]]. Для этого необходимо перенести графическое изображение table с последующим изменением типа с image на Table. Название объекта изменить на HOT**

[[Файл:07 5.png]]

3. Для объекта HiddenList перенести любое графическое изображение с последующим изменением типа с image на HiddenList и удалением графического ресурса из поля настроек (res)*. Для данного типа объекта не требуется графический ресурс. Название объекта изменить на HOL**

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

'''**''' Имена для специальных объектов могут использоваться любые.

== Детальная настройка объектов ==

'''1. Описание HiddenObject.'''

''HiddenObject'' - это поисковый объект, взаимодействующий со списком HiddenList. Каждому поисковому объекту необходимо указать графический ресурс (картинку), идентификатор объекта HiddenList и идентификатор текстового ресурса (строки описания) в HiddenList.[[Файл:07 7.png|right]]

Необходимо выбрать используемый объект с именем HOL (тип HiddenObjectList) в поле list.

''текстID'' – название хидден-объекта, которое будет отображаться в списке. Перетаскивается мышкой из текстового редактора;

''текст'' – обычный текст (будет отображаться в таблице при отсутствии ТекстID, для быстрых экспериментов);

''list'' – ссылка на HiddenList, к которому будет подключен объект, для обеспечения связи между ними;

''flyer'' – объект типа flyer, который запустится в работу при нахождении поискового объекта. Неудачный клик обрабатывает HiddenList. Если параметр не задан, используется fly_ok объекта HiddenList.(objid);

''actor'' – объект, который отображает анимацию спрятанного объекта после удачного клика на него (обычно это машина состояния). Парметр необязателен. Актёры нужны тогда, когда отличается графика объекта, который непосредственно находится на сцене и который летит к таблице. Это может быть случай, когда на сцене лежит часть объекта, а летит целый. Или же на сцене - с тенью, а летит - без.

''тип'' – номер типа объекта, используется для логического разделения объектов при обработке HiddenList.

'''2. Описание HiddenObjectList.'''

HiddenList - это список поисковых объектов (Hidden), которые надо найти в хидден-сцене. [[Файл:07 8.png|right]] Каждый поисковый объект на сцене связывают со списком. Объектов может быть больше, чем будет показано в данной игровой сессии (поле "объектов"). В этом случае они выбираются случайным образом. Запоминаются те из них, по которым произошёл клик (увеличивается счетчик их кликов). При следующем заходе на сцену, поисковые слова сортируются по возрастанию числа кликов и снова активизируется количество спрятанных объектов, указанных в поле "количество".

HiddenList определяет основные параметры для настройки HiddenObject (скорость полета и т.п.). В дальнейшем, при необходимости, эти же параметры можно добавить в HiddenObject, чтобы для данного объекта они "перебивали" общие значения для всех.

Подготовка спрятанных объектов:

''num'' (поле "объектов") – максимальное количество объектов, участвующие в поиске. (int)

''hide'' (поле "прятать") – если 1, то делать невидимыми объекты, не участвующие в поиске. (int)

Визуальные параметры списка:

''table'' (поле "таблица") – идентификатор объекта Table. (objid)

''kind'' (внешний вид - поле "тип списка") – тип отображения объекта в списке (0-слово,1-ассоциация, 2-иконка, 3-иконка). (int)

''cross'' (внешний вид - поле "вычеркнуть") – зачеркивать найденный элемент списка. Eсли 0 (по умолчанию), то найденный элемент удаляется, иначе "зачеркивается".(int).

3. Описание Table

[[Файл:07 9.png]]

6. Параметры, общие для всех спрятанных объектов:

''die'' – тип исчезания при удачном клике на объект (если нет актера) (int):

0: просто исчезает;

1: летит к пункту с описанием в списке HiddenList;

2: улетает в случайном направлении;

3: улетает к заданным координатам (fx, fy).

vm - скорость движения при полете к списку предметов после клика в px/sec (float)

vr - скорость вращения при полете к списку предметов после клик в град/sec (float)

fw - финальная ширина к которой надо уменьшится при подлете к финальной точке (int)

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

fx - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

fy - финальная координата x, к которой объект должен перелететь, при удачном клике (см. тип исчезания). (int)

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' HiddenList не будет работать без объекта [[Редактор текстовых ресурсов#Упражнения|Options]], который вы должны были создать в предыдущем уроке, а так же без поля id игры (Очковая система -> id игры; для теста заполним его любой строкой).
</blockquote>

== Упражнения ==

1. Щелкнув правой кнопкой мыши по экрану Lesson_7, создать новый экран Lesson_7_1.

2. Создать новую сцену (с названием stg_7_1).

3. Скопировать все объекты из сцены stg_7 (экрана Lesson_7).

4. Вставить скопированые объекты в новую сцену stg_7_1.

[[Файл:07 11.png]]

5. В новой сцене:

a) добавить еще 3 графических ресурса и перевести в тип HiddenObject;

b) разместить на местах предназначенных для их «Прятанья»;

c) добавить текстовое описание в TextEditor;

e) установить время игры 20 секунд, паузу 2 секунды с переходом на экран Lesson_7_1.

6. Модифицировать экран Lesson_7 в полноценный уровень с выводом количества очков, игрой на время и графикой.

== Упражнение № 6 ==
Экран lesson_7 необходимо модифицировать в полноценный уровень.

Для этого первый экран дополняем 2 счетчиками ([[counter]]), таймером ([[timer]]), машиной-блокатором ([[machine]]), машиной-комбо3 ([[machine]]) и прогрессом ([[progress]]). Второй экран с выводом очков составим позже.

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

Счетчик «amt» ([[counter]]) показывает сколько объектов найдено. Счетчик «score_H» ([[counter]]) насчитывает баллы за собранные объекты. Таймер ([[timer]]) запускается при старте игры и отсчитывает заданное время на игру, машина-блокатор «ban_H» блокирует сцену при серии ошибочных кликов. Прогресс «progr» ([[progress]]) отображает уровень прохождения игры.

Чтобы всё заработало необходимо указать счетчики, таймер, машину-блокатор, машину-комбо3 и прогресс в хиденлисте «HL_01» ([[hiddenList]]).

== СЧЕТЧИК ==

В редакторе ресурсов выбираем анимацию и добавляем графику для счетчика.

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Если в редакторе ресурсов нету анимации, то [[Интерфейс_ResourceEditor#Анимация|создайте]] её - это просто).
</blockquote>

‎[[Файл:Coun (5).png]] ‎[[Файл:Coun (6).png]] [[Файл:Coun (7).png]] [[Файл:Coun (8).png]] ‎[[Файл:Coun (9).png]] [[Файл:Coun_(10).png]] ‎[[Файл:Coun (11).png]] ‎[[Файл:Coun (1).png]] ‎‎[[Файл:Coun (2).png]] ‎[[Файл:Coun (3).png]] ‎[[‎Файл:Coun (4).png]]

Создаем объект сцены с типом «[[counter]]», в поле res перетаскиваем анимацию с цифрами от 0 до 9, разделитель перетаскиваем в отдельную графу без анимации. Настройки для счетчика:

[[Файл:243.png]] [[Файл:33.png]]

== ТАЙМЕР ==

В свойствах таймера «[[timer]]» необходимо указать «значение» с которого начнется отсчет времени (18000 = 18 сек.).
В свойство «графика» из графического редактора перетаскиваем анимацию которую делали для счетчика и двоеточие. Настройки для таймера:

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

== ПРОГРЕСС ==

[[Progress]] используют для отображения каких либо ачивментов, например когда игрок проходить уровень он может получить 1,2,3 звезды или бронзовую, серебряную, золотую.
Настройки для прогресса :

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

Графика для Progress: [[Файл:666.png]]

Настройки для машины-Combo3c :

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

Во всех HiddenObject изменить параметры и свойства объекта combo3c [[Файл:1818.png]]

Настройки для машины-блокатора «ban_H» (machine) :

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

Настройки для hiddenList:

[[Файл:1010.png]] [[Файл:1011.png]]

Группа - звезды combo num =1 Количество быстро найденных объектов, нужное для получения звезды Combo combo time = 3000 Интервал между кликами, считающимися быстрыми для Combo accuracy = 0,85 Точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные) лимит ложных кликов =5 Лимит ложных кликов. Формула расчета количество верных кликов делим на общее количество получаем коэффициент если он равен или больше указного нами то в опции пишем параметр, если нет то не пишем.

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

Графика для Rectangle rec: [[Файл:0001.png]] [[Файл:0002.png]] [[Файл:0003.png]] [[Файл:0004.png]] [[Файл:0005.png]] [[Файл:0006.png]] [[Файл:0007.png]] [[Файл:0008.png]] [[Файл:0009.png]] [[Файл:00010.png]]

Графика для Rectangle black : [[Файл:0101.png]]

<blockquote>
[[файл:wrong.png|right|32px]]
'''Внимание!''' Графика для Rectangle black используется в качестве фона, на котором будет размещаться всплывающие окно с показаниями результата пройденной игры.
</blockquote>

[[Файл:1012.png]] [[Файл:0102.png]]

В свойствах счетчиков необходимо прописать уровень!

1) счетчик 7_4_5 — очки за уровень

уровень: Last_game.score30_level

2) счетчик 7_4_4 — бонус комбо

уровень: Last_game.score30_time

3) счетчик 7_4_3 — бонус за аккуратность

уровень: Last_game.score30_accuracy

4) счетчик 7_4_2 — бонус за время

уровень: Last_game.score30_time

5) счетчик 7_4_1 — игровые очки

уровень: Last_game.score30_total

Настройки для машины — star1
(проверка в опциях параметра last_game.last_star_accuracy0,
last_game.last_star_time0, )

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

Настройки для машины — star2
(если параметр accuracy=0)

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

Настройки для машины — star3
(если игра пройдена за указанное время)

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

Настройки для машины — win

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

Машина win считывает «read» показания счетчика и запускает star1 если игра пройдена.

Кнопка close закрывает окно вывода результатов изменением состояния обьекта win состоянием close.

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

----
{| width="100%"
| width="40%"|[[Редактор текстовых ресурсов|Урок 5]] <<
! width="20%"|[[Learning|Оглавление]]
| width="40%" align="right"| >> [[Настройка миниигр|Урок 7]]
|}

[[Category:Learning]]

HiddenList

2016-08-10T07:46:47Z

Vgat: /* Основные параметры */

{{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 '') - Скорость вращения в градусах в секунду.

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

*'''скалирование объектов''' ('' 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]] которые отображены в таблице, остальные нет!).
*'''распределять равномерно''' ('' undist '') - Равномерно распределять объекты по площади сцены.
*'''прятать актеров при старте''' ('' hideact '') - Устанавливать актерам видимость false при старте (по умолчанию - да)(То есть всем актерам которые находятся на сцене при запуске принудительно установиться vis = 0).
*'''аномалия''' ('' anom '') - для всех аномалий кроме текстовой [[HiddenObject]] и игровой фон должны быть подобъектами [[Effect]]):
:'''0''' - нет;
:'''1''' - текстовая;
:'''2''' - ночь; В машине которая выставляет эффект ночь, должны передавать сцене с объектом аномалия ( obj="scene"; par="drag"; val="0" ) и ( obj="scene"; st="update");
:'''3''' - трансформация цвета;
:'''4''' - дым.
*'''флурри''' ('' 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 кол-во.

'''Группа - звезды'''

*'''combo num''' ('' comboNum '') - Количество быстро найденных объектов, нужное для получения звезды Combo.
*'''combo time''' ('' comboInt '') - Интервал между кликами, считающимися быстрыми для Combo.
*'''accuracy''' ('' accuracy '') - Точность кликов для получения звезды Accuracy (1 = 100%, все клики должны быть только удачные).
*'''лимит ложных кликов''' ('' starWrAcc '') - Лимит ложных кликов.
Формула расчета проста, количество верных кликов делим на общее количество получаем коэффициент если он равен или больше указного нами то в опции пишем параметр, если нет то не пишем.

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

Состояния которые есть у листа. Мы можем передавать их с помощью различных объектов:
*'''invert''' - горизонтально отображает изображение;
*'''run''' - переводит хидден с состояние активности, если до этого был на паузе;
*'''pause''' -переводит хидден с состояние паузы, объекты не кликаются!

==Примечания==

*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|вьювер]]

== Пример ==

S:\!MOBILE\!!!EditorGames\Wiki_sample

HiddenList.rar

[[Category:Game mechanic]]

[[Category:Get Started]]

Object

2016-08-10T07:41:50Z

Vgat: /* Основные параметры */

'''Объект (Object)''' - находится и принадлежит сцене (наследует свойства сцены). Объектами можно назвать любой игровой элемент в редакторе.
 
Вложенные объекты наследуют свойства корневого объекта.
*Объекту может быть присвоен графический ресурс, но и без граф. ресурса он может существовать, как невидимый для данной сцены (пример options, hiddenlist, и т.д.).
*Объекты на сцене могут наследовать свойства и взаимодействовать с объектами данной сцены.
*Объекты могут изменять параметры других объектов

*Всем объектам, как видимым так и игровым присущи следующие параметры:

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

*'''id-объекта''' (id) - уникальный номер объекта
*'''тип''' (type) - Выбранный тип объекта определяет его функциональное назначение и его свойства
*'''имя''' (name) - Имя графического объекта в дереве проекта. Может быть произвольным. По умолчанию соответствует имени файла из базы ресурсов.
*'''синхронизация''' (sync)- Применяется для синхронизации между лейаутами, если указан параметр ''нет'' то объект будет активен только на текущем лейауте
*'''память''' (memo) - Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана).
*'''res''' - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования).

'''Группа - положение'''

*'''положение X''' (px) - Горизонтальная координата центра графического объекта (его точки пивота) в пикселях. Отсчитывается от точки пивота сцены.
*'''положение Y''' (py)- Вертикальная координата центра графического объекта (его точки пивота) в пикселях. Отсчитывается от точки пивота сцены.

'''Группа - размер'''
[[Файл:object1.png|400px|right]]
*'''размер -> W''' (w) - Ширина графического объекта в пикселях
*'''размер -> H''' (h)- Высота графического объекта в пикселях
** Точка пивота сцены как правило расположена в центре сцены [[Image|см.описание Image]]

'''Группа - модификаторы'''

*'''alpha''' (al) - Прозрачность: от 0 (прозрачен) до 1 (не прозрачен).
*'''blending''' (bl) - [[Alpha смешивание]]
*'''angle''' (ang) - Угол поворота в градусах (0 - не повёрнут). Отсчитывается от оси x вниз. Вверх - идут отрицательные углы.
*'''scale x''' (sx) - Масштаб по оси '''x''' (1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.).
*'''scale y''' (sy)- Масштаб по оси '''y''' (1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.).

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

'''Группа - [[позиционирование]]'''

*'''горизонтальное''' (alHor) - выравнивание по горизонтали (0 - нет выравнивания; 1 - прижать к левому краю; 2- центр; 3 - прижать к правому краю).
*'''вертикальное''' (alVer)- выравнивание по вертикали (0 - нет выравнивания; 1 - прижать к верхнему краю; 2- центр; 3 - прижать к нижнему краю).

== Пример ==

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

[[Category:Main objects|*]]

Slider

2016-08-10T07:39:22Z

Vgat: /* Основные параметры */

{{TOC right}}
'''Slider''' — встроенный [[Object|объект]] редактора, реализующий прокручивание списков, а так же даёт возможность создание различных ползунков для регулирования параметров ( к примеру регулятор громкости, музыки, яркости и т.д. )

== Общие параметры ==
[[Файл:Slider.png|right]]

*'''id-объекта'''( ''id'' ) - уникальный номер объекта
*'''тип''' ( ''type'' ) - Выбранный тип объекта определяет его функциональное назначение и его свойства
*'''имя'''( ''name'' ) - Имя графического объекта в дереве проекта. Может быть произвольным. По умолчанию соответствует имени файла из базы ресурсов.
*'''синхронизация''' ( ''sync'' )- Применяется для синхронизации между лейаутами, если указан параметр ''нет'' то объект будет активен только на текущем лейауте
*'''z''' - Параметр порядка рисования объекта. Сначала рисуются объекты с большим z, затем, поверх них - с меньшим.
*'''память''' ( ''memo'' ) - Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана).
*'''[[прокликиваемая]]''' ( ''passClk'' ) - Если 1, то картинка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то картинка сама обрабатывает клик, но и пропускает его дальше"
== Основные параметры ==

'''Группа - размер'''
[[Файл:object1.png|400px|right]]
*'''W''' ( ''w'' ) - Ширина графического объекта в пикселях
*'''H''' ( ''h'' )- Высота графического объекта в пикселях

'''Группа - модификаторы'''
*'''alpha''' ( ''al'' ) - Прозрачность: от 0 (прозрачен) до 1 (не прозрачен).
*'''blending''' ( ''bl'' ) - Alpha смешивание (parent - наследует alpha от родителя, blend - смешивание, add - добавление, sub - вычитание, none - ничего не происходит. (Подробнее о Alpha смешивании - здесь)).
*'''angle''' ( ''ang'' ) - Угол поворота в градусах (0 - не повёрнут). Отсчитывается от оси x вниз. Вверх - идут отрицательные углы.
*'''scale x''' ( ''sx'' ) - Масштаб по оси '''x''' (1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.).
*'''scale y''' ( ''sy'' )- Масштаб по оси '''y''' (1 - не изменен, 1.5 - увеличен в полтора раза, и т.д.).

''' Группа - размер ползунка ''':
*'''W''' ( ''handle_width'' ) - Ширина ползунка в пикселях.
*'''H''' ( ''handle_height'' )- Высота ползунка в пикселях.

'''Группа - дополнительные'''
*'''значение''' ( ''value'' ) - Текущее значение ползунка слайдера.
*'''шаг смещения''' ( ''shift_value'' ) - Смещение ползунка слайдера при установке состояния increase или decrease.
*'''вертикальный''' ( ''vertical'' ):
::'''0''' - горизонтальное размещение;
::'''1''' - вертикальное размещение слайдера.
*'''обратный''' ( ''reversed'' ):
::'''0''' - значение увеличивается вниз или вверх;
::'''1''' - значение увеличивается влево или вверх.
*'''ползунок''' ( ''handle_res'' ) - Ресурс, за который пользователь будет тянуть.
*'''полоса''' ( ''groove_res'' ) - Ресурс, который будет тайлиться для заполнения полосы прокрутки.
*'''начальная грань''' ( ''groove_begin_res'' ) - Ресурс, картинка левой или верхней грани полосы прокрутки.
*'''конечная грань''' ( ''groove_end_res'' ) - Ресурс, картинка правой или нижней грани полосы прокрутки.
*'''отступ''' ( ''groove_margin'' ) - Отступ от сторон полосы, в который ползунок упрётся центром, при достижении максимального значения.
*'''целевой объект''' ( ''target_object'' ) - Объект, который будет слушать изменения значения слайдера. Объект должен содержать реакцию на SAY_SCROLL.

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

[[Файл:+.png]] '''изменилось значение: изменить параметры объекта''' ( ''value_changed_param'' ) - После изменения значения слайдера изменить параметр объекта:
::'''объект''' ('' obj '') - этот объект меняет свой параметр;
::'''свойство''' ('' par '') - Параметр, который мы изменяем;
::'''значение''' ('' val '') - Новое значение параметра.

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

[[Файл:+.png]] '''достигнут минимум: изменить состояние объекта''' ( ''min_reached_state'' ):
::'''объект''' ('' obj '') - этот объект меняет свой параметр;
::'''состояние''' ('' st '') - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''достигнут максимум: изменить состояние объекта''' ( ''max_reached_state'' ):
::'''объект''' ('' obj '') - этот объект меняет свой параметр;
::'''состояние''' ('' st '') - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''покинут минимум: изменить состояние объекта''' ( ''min_left_state'' ):
::'''объект''' ('' obj '') - этот объект меняет свой параметр;
::'''состояние''' ('' st '') - Новое состояние для объекта из предыдущего поля.

[[Файл:+.png]] '''покинут максимум: изменить состояние объекта''' ( ''max_left_state'' ):
::'''объект''' ('' obj '') - этот объект меняет свой параметр;
::'''состояние''' ('' st '') - Новое состояние для объекта из предыдущего поля.

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

*'''increase''' - увеличить текущее значение слайдера на значение указанное в поле '''шаг смещения'''.
*'''decrease''' - уменьшить текущее значение слайдера на значение указанное в поле '''шаг смещения'''.

== Примечания ==

1) Если слайдеру следующие поля не задать, то приложение зависнет:
::*'''ползунок''';
::*'''полоса''';
::*'''начальная грань''';
::*'''конечная грань'''. 
2) Если объекту слайдер не задавать объект слежения ( целевой объект ), то в поле значение ( ''value'' ) будет находиться число от 0.00 до 1.00 в зависимости от положения ползунка. Это значение считываем как строку, иначе получим или 0 или 1. 

== Примеры реализации ==

==='''1. Слайдер как ползунок для регулировки громкости'''===

:В проекте имеем два объекта sounds ( ''slider'' ) и save_sounds ( ''mashine'' ).

[[Файл:Slider Tree.png|centre]]

:Слайдер реализует прокрутку, а машина при изменении значения слайдера переводит машину в состояние save ( записываем значение слайдера в опции ).

:Настройки объекта slider: 
[[Файл:Slider in option.png|centre]]

:Машина ''save_sounds'': 
[[Файл:Mashine for slider in option.png|centre]]

Состояния: 
::'''init''': выставляем текущее значение громкости звука объекту slider. (Почему в ините? Так как данная машина ребёнок слайдера, то проинититься машинка сразу после слайдера).
::'''save''': считываем значение slider и записываем в опции.

==='''2. Слайдер как скролл для прокрутки таблицы'''===

:Чтобы нашим слайдером прокручивать таблицу, мы должны указать в поле '''Целевой объект''' нужную таблицу. Выбор плоскости для прокручивания ( вертикально или горизонтально), выбирается исходя из ориентации слайдера (параметр '''вертикальный'''):

[[Файл:Slider table.png|centre]]

[[Category:Main objects]]

Flyer

2016-08-10T07:31:00Z

Vgat: /* Примечания */

[[Файл:flyer_fountain_property.JPG|right]]

'''Flyers '''(флаеры, партиклы)- летающие картинки, при помощи этого [[Object|объекта]] можно реализовывать различные эффекты: взрывы, падающие снежинки, дождь, фонтан, огонь, летающая пыль, дым, пар и т.п.

== Общие параметры ==

(см. описание [[Object|Object]])
*'''имя''' - Имя объекта Flyer в дереве проекта. Может быт произвольным.
*'''id-объекта''' - Уникальный номер объекта Flyer, который можно увидеть при наведении курсора на строку "имя".
*'''синхронизация''' - Применяется для синхронизации между лейаутами. Если указан параметр "нет", то объект будет активен только на текущем лейауте. По умолчанию указан параметр "да".
*'''сохранение параметров''' - Настройка этого параметра актуальна, если приложение в дальнейшем будет сворачиваться в системную панель («трей»). Выбирается значение этого параметра из выпадающего списка. Возможны следующие варианты: "нет", "только объект", "объект с подобъектами", "только подобъекты". При выходе из трэя будут восстановлены ранее измененные/установленные (при переходе с одного экрана на другой)параметры объектов или подобъектов в зависимости от выбранного варианта для этого параметра. По умолчанию указан параметр "нет". Следует помнить, что если выбирается для объекта некоторой сцены значения этого параметра отличное от "нет", то должно и предусматриваться соответствующее значение этого параметра и для этой сцены, и для экрана, содержащего эту сцену.
*'''z''' - Параметр порядка рисования объекта. Сначала рисуются объекты с большим z, затем, поверх них - с меньшим.
*'''память''' - Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана). По умолчанию значение этого параметра 0.
*'''тип''' - Тип флаера. Определяет его функциональное назначение и его свойства. Для флаера возможны следующие типы: "картинки", "текст". Выбирается подходящий тип из выпадающего списка. По умолчанию указан тип "картинки".

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

'''Группа - внешний вид'''

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

При выборе типа флаера "картинки" параметр "текст" игнорируется и наоборот. Вместе текст и картинка не существуют.

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

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

'''Группа - модификаторы'''

*'''alpha''' ''(al)'' - Изменяет прозрачность используемого ресурса: от 0 (прозрачен) до 1 (не прозрачен).
*'''blending''' ''(bl)'' - Alpha смешивание. Взаимодействие каждой новой частицы (source) с раннее отрисованными (dest). Значения данного параметра выбираются из выпадающего списка. Каждый отдельный цвет, который мы видим, создается с помощью комбинации трех цветов: красного (red), зеленого (green) и синего (blue). RGB - является их аббревиатурой . Разные значения модификатора "blending" отличаются способ вычисления значений RGB-каналов и значения прозрачности.

''' blend ''' - смешивание.

Rback = (Rsource * Ralpha) + (Rdest * (1 - Ralpha))

Gback = (Gsource * Galpha) + (Gdest * (1 - Galpha))

Bback = (Bsource * Balpha) + (Bdest * (1 - Balpha))

Aback = (Asource * Aalpha) + (Adest * (1 - Aalpha))

''' half ''' - деление пополам.

Rback = (Rsource + Rdest) / 2

Gback = (Gsource + Gdest) / 2

Bback = (Bsource + Bdest) / 2

Aback = (Asource + Adest) / 2

''' add ''' - добавление.

Rback = Rsource + Rdest

Gback = Gsource + Gdest

Bback = Bsource + Bdest

Aback = Asource + Adest

''' sub ''' - вычитание.

Rback = Rsource - Rdest

Gback = Gsource - Gdest

Bback = Bsource - Bdest

Aback = Asource - Adest

''' none ''' - ничего не происходит.
*'''angle''' ''(ang)'' - Изменяет угол наклона используемого ресурса. Отсчитывается по часовой стрелке. Против - отсчитываются отрицательные углы.
*'''scaleX/scaleY''' ''(sx/sy)'' – Изменяют масштаб используемого ресурса, но при этом изменяет и положение точки рождения флаера, что делает использование данного модификатора крайне неудобным.

Модификаторы становятся активными если установлен флаг «использовать модификаторы», в противном случае установленные параметры игнорируются.

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

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

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

*'''beg''' – Состояние в котором флаер начинает свой цикл жизни (включается).
*'''end''' – Состояние которое выключает флаер.
*'''stop_birth''' - Состояние заканчивает рождение. В по сути - "горшочек не вари"

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

'''Область рождения'''

*'''только контур''' ''(frame)'' - Если 1, то частицы будут рождаться только по контуру, описанному параметрами. Если 0, то по всей площади.
*'''радиус r''' ''(r)'' - Радиус области вокруг (х,у), где рождаются летуны.
*'''горизонтальная rx''' ''(rx)'' - Горизонтальная область рождения. Летуны будут рождаться внутри прямоугольника с шириной 2*rx.
*'''вертикальная ry''' ''(ry)'' - Вертикальная область рождения. Летуны будут рождаться внутри прямоугольника с высотой 2*ry.

Если все параметры области рождения равны нулю: r=rx=ry=0, то летуны будут рождаться из одной точки.
Центр области рождения задается стандартными для всех объектов координатами x,y из раздела "положение". Круг имеет приоритет над прямоугольником (если r не равно 0, то, не зависимо от значений rx или ry, рождение будет происходить внутри круга):
<center>
[[Файл:flyers_born.png]]
</center>

'''Начальная скорость'''

*'''минимальная''' - Минимальная скорость при рождении летуна в px/сек.
*'''максимальная''' - Максимальная скорость при рождении летуна в px/сек.
*'''от угла''' - Начальный угол сектора для направления скоростей.
*'''до угла''' - Конечный угол сектора для направления скоростей.
*'''угловая''' - Угловая скорость вращения одного летуна в градусах в секунду.

При рождении каждый флаер имеет определенную скорость, величина (по модулю) которой выбирается случайным образом из диапазона от v1 до v2. Скорость измеряется в пикселях за секунду. Типичные значения, обычно, не превышают 100.

По умолчанию вектор скорости направлен изотропно (равновероятно во всех направлениях). В разделе "начальная скорость" можно определить сегмент круга, внутри которого будет направлена начальная скорость флаера. Углы отсчитываются от оси x вниз (положительные углы) или вверх (отрицательные углы) и измеряется в градусах. Например, если a1=45, a2=135, то флаеры будут вылетать вниз веером в 90 градусов.
<center>
[[Файл:flyers_vel.png]]
</center>

Кроме линейной скорости можно задавать угловую скорость вращения - w, в градусах в секунду. Тогда при движении флаеры будут вращаться. Впрочем, увлекаться этим эффектом не стоит, так как это дополнительная нагрузка на ресурсы.

'''Цикл жизни'''

*'''на экране''' - Максимально количество летунов, которые видны на экране.
*'''всего''' - Общее число созданных летунов (с учетом того, что они могут умирать и создаваться до числа "на экране").
*'''каскадов''' - Число каскадных рождений (фейерверк).
*'''время''' - Каждый флаер рождается, живет и умирает. Соответственно, можно задать три параметра (tmBorn, tmLife, tmDie) в ms.
** ''' интенсивность ''' - Интенсивность рождения одного флаера в миллисекундах.
** ''' ограничения ''' - Не более штук в миллисекунду (борьба с пульсациями).
** ''' рождения ''' - За период рождения tmBorn прозрачность флаера увеличивается от нуля до заданной в общих настройках.
** ''' время жизни ''' - Длительность жизни одного летуна. tmLife может быть отрицательным. В этом случае флаер живет, пока живет его группа (т.е. у него бесконечное время жизни). Если tmLife положительно, то после истечения времени tmLife флаер умирает в течении времени смерти tmDie.
** ''' время смерти ''' - За это время он меняет свою прозрачность, от установленной в общих параметрах до указанной.
*'''до прозрачности''' - Прозрачность в конце периода умирания. По умолчанию равна нулю.

Когда флаер окончательно исчезает, вместо него в области рождения может появиться новый флаер. Это происходит, если число летающих к данному моменту флаеров не превышает параметра num (цикл жизни:на экране). Кроме этого, в процессе жизни группы флаеров подсчитывается общее число родившихся флаеров. Если их количество превышает параметр tot (цикл жизни:всего), то рождений больше не происходит. Если tot меньше 0, то подобное ограничение игнорируется.

Если параметры num и tot допускают рождение новых флаеров, то происходит это с интенсивностью, определяемой временем в миллисекундах на рождение одного флайера nms. Например, если число видимых флаеров равно num=100, а nms=10, то все 100 флаеров покажутся на экране через 1000 ms (одну секунду). Если при этом поставить время жизни tmLife=0, tmDie=1000, то получится файербол. Вообще, чтобы не было пульсаций при порождении флаеров, для интенсивности необходимо пользоваться формулой "общее время на количество":
<pre>
nms = (tmBorn+tmLife+tmDie)/ num
</pre>
Пульсации могут, тем не менее, происходить, даже при выполнении этой формулы, если параметр nms оказывается существенно меньше времени одного фрейма (вызова таймера). Поэтому надо стремиться к тому, чтобы nms был больше реального периода таймера. Впрочем, при помощи праметра "ограничение" (max) можно задавать максимальное число флаеров, которые могут рождаться в ms (тогда при большом тике таймера больше, чем разрешено не родиться).

'''Действующие силы'''

На каждый флаер может действовать одна из следующих сил:
*'''горизонтальная''' - Постоянная сила fx вдоль оси х, подобная силе ветра.
*'''вертикальная ''' - Постоянная сила fy вдоль оси у. Если она положительна, то это оказывает эффект силы тяжести (ось y направлена вниз!)
*'''радиальная''' - Постоянная радиальная сила fr. Она направлена к центру группы с координатами (x,y) и не зависит от расстояния до этого центра. Если fr положительна, то это сила отталкивания, если отрицательна - притяжения.
*'''конфайнмента''' - Радиальная сила конфайнмента fc. Сила притяжения стаи к центру. Аналогична fr, но её величина линейно растёт с увеличением расстояния от центра.
*'''к линии''' - Сила притяжения к вертикальной линии, проходящей через координаты центра рождения флаеров (из общих параметров).
*'''случайная''' - Амплитуда стохастического (случайного) воздействия fs. При каждом перемещении к компонентам скорости добавляется случайная велична в диапазоне от -fs до fs. Например, снежинки неплохо моделируются с fy=fs=2
*'''трения''' - Сила трения ff, уменьшающая скорость объектов. Измеряется в процентах уменьшения скорости за секунду: 0 - нет трения, 100 - за секунду остановится.
В результате воздействия сил, и при неконтролируемом подвисании компьютера (таймер получает большой интервал времени), возможно резкое увеличение скорости флаеров. Для контроля этих эффектов служит раздел "ограничения" по скорости (vMax, px/сек) и величине смещения по экрану (dMax, px)

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

Меню выбора ''Добавляемые параметры'' к объектам активируется по правой кнопки мыши.

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

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

== Советы ==

Для настройки флаеров необходимо контролировать множество параметров. Необходимо четко понимать смысл этих параметров и их возможное влияние на результат. Возможно, помогут следующие советы:
* Сначала надо определиться с базовыми параметрами - область рождения, величина и угол начальных скоростей.
* Затем определить направление и характер сил.
* Не стоит менять за один раз больше 2-х параметров
* На начальном этапе параметры необходимо менять решительно - в 2, в 10 раз и т.п.
* Необходимо экспериментировать с комбинацией цветов и размером флаеров.
* Запоминайте промежуточные, более или менее удачные, наборы параметров, чтобы к ним вернуться, если все "разрегулировалось".
* Если получился прикольный, но не нужный эффект - стоит запомнить его параметры, потом пригодится.

== Производительность ==

Флаеры сильно грузят быстродействие машины. Поэтому необходим самоконтроль по необходимости их использования и контроль длительности кадра (с проверкой его на реальных устройствах). Ниже идет ряд советов:
* Если можно нужный эффект реализовать кадрами анимации - часто, лучше анимация, чем флаеры.
* Стремиться реализовать нужный эффект с минимумом флаеров
* Искать баланс соотношения размера картинки и количества флаеров. Большие картинки (даже, если их и не много) - долго рисуются. Большое число маленьких картинок - также плохо, т.к. много ресурсов уходит на обсчет их физики.
* Не увлекаться без нужды вращением частицы - это требует дополнительных вычислений матрицы поворота.
* Сила конфайнмента (зависящая от расстояния) не содержит корня и чуть быстрее радиальной силы.
* Помнить, что хороший эффект может, в силу производительности, совсем не так хорошо выглядеть на мобильном устройстве.

== Примечания ==

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

Как уже говорилось, применение к объекту Flyer модификатора '''scale x/scale y''' нежелательно, так как это изменяет положение точки рождения флаера.
Возможное решение этой проблемы будет состоять в следующем: флаер сделать подобъектом другого объекта, например, объекта Image, и применять модификаторы уже к нему.

== Примеры ==

===Фонтан===

[[Файл:flyer_fountain_property.JPG|200px]][[Файл:Fontan2.JPG]]

===Рыбки ===

[[Файл:Flyer fish property.JPG|200px]][[Файл:Ribki2.JPG]]

===Дождь ===

[[Файл:Flyer_rain1_property.JPG|200px]][[Файл:Dojd2.JPG]]

===Снег ===

[[Файл:Sneg1.JPG|200px]][[Файл:Sneg2.JPG]]

===Фейерверк ===

[[Файл:Feyerverk1.JPG|200px]][[Файл:Feyerverk2.JPG]]

===Звезды ===

[[Файл:Zvezdi1.JPG|200px]][[Файл:Zvezdi2.JPG]]

===Файербол ===

[[Файл:Fireball1.JPG|200px]][[Файл:Fireball2.JPG]]

===Взрыв ===

[[Файл:Vzriv1.JPG|200px]][[Файл:Vzriv2.JPG]]

===Дым ===

[[Файл:Dim1.JPG|200px]][[Файл:Dim2.JPG]]

===Свеча ===

[[Файл:Svecha1.JPG|200px]][[Файл:Svecha2.JPG]]

===Огонь ===

[[Файл:Flyer fire 1 property.JPG|200px]][[Файл:Flyer_fire.JPG]]

===Летящие листья ===

[[Файл:Flyer leaf.JPG|200px]][[Файл:Flyer_leaf_2.JPG‎]]

===Стекающие капли ===

[[Файл:Flyer drop property.JPG|200px]][[Файл:Flyer_drop.JPG]]

===Косой дождь ===

Для изменения угла Flyer был сделан подобъектом объекта типа Image, к которому применялись модификаторы.

[[Файл:Flyer_rain_2_property.JPG|200px]][[Файл:Flyer_rain_2.JPG]]

===Парящие руны ===

[[Файл:Flyer symbol propety.JPG|200px]][[Файл:Flyer_symbol.JPG]]

===Летающий текст ===

[[Файл:Flyer_text_propety.JPG|200px]][[Файл:Flyer_text.JPG]]

===Использование модификатора ''"blending"'' ===

В данном примере использовались первые три значения этого модификатора: blend, half, add.

[[Файл:Flyer fire 3 property.JPG|200px]][[Файл:Flyer fire 3.JPG]]

== Пример ==

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

[[Category:Main objects]]

Интерфейс ResourceEditor

2016-08-10T07:25:21Z

Vgat: /* Анимация */

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

===Общее описание===
[[Файл:Ico_base.png|40px]]'''[[Редактор ресурсов]]''' - приложение, которое управляет базой графических, анимационных, видео и звуковых ресурсов проекта. [[Файл:New resource editor look.jpg|500px|right]]
Ресурсы проекта могут быть внесены и модифицированы только через Редактор ресурсов. 
Как и в редакторе сцен, вверху окна редактора ресурсов расположено меню и кнопки быстрого доступа: создать базу ресурсов, открыть уже существующую, добавить картинку (png, jpeg), анимацию, мелодию (mp3, ogg), видео (mp4). 
Ниже, в левой панели находятся папки, внутри которых можно найти различные графические ресурсы:
*Если в дереве папок активна данная папка, то на правой панели мы видим список графических ресурсов в виде иконок.
*Если же в дереве кликнуть на имя конкретной картинки, то в правой панели она будет представлена в натуральную величину.
*При клике на ресурс в левой нижней части окна редактора ресурсов появится панель с настройками ресурса в зависимости от его типа

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

====Меню File====
*New Project ('''Ctrl'''+'''N''') – создать новый проект с новой базой ресурсов. Возможно в качестве базы ресурсов выбрать уже существующий каталог ресурсов.
*Open Project ('''Ctrl'''+'''O''') - открыть базу ресурсов ранее созданного проекта
*Создать проект по папке — создать базу ресурсов по каталогу с ресурсами

====Меню View====
*Always on top - всегда отображать Редактор Ресурсов поверх всех окон
*Image Viewer - отобразить панель Image Viewer для просмотра ресурсов

====Меню Project====
*Add Root Base - создать еще одну базу ресурсов в текущем проекте
*Add images — добавить изображения в проект
*Add Animations — добавить анимацию в проект
*Add Sounds - добавить звук в проект
*AddVideos - добавить видео в проект
*Delete Resource — удалить ресурс
*Options — вызов окна настройки отображения изображений в редакторе
*Обрезать images в старом проекте — вызов функции удаления бордера изображения (у всех ресурсов) на указанную величину в параметре Transparent Border Size вкладки Cropping Settings из Options меню Project 

Кнопки Add images, Add Animations, Add Sounds , AddVideos, Delete Resource вызывается по клику правой кнопки мыши в дереве базы ресурсов

====Выбор платформы для настроек ресурсов и контейнеров====
[[Файл:Res_pros.png|300px|right]] 
Выпадающий список платформ для настройки ресурсов позволяет внести изменения для определенной платформы сборки. Эти настройки по умолчанию заданы одинаковыми (default) для всех платформ. Чтоб изменить параметр, например, для IOS, нужно выбрать его в выпадающем списке. Измененный параметр станет синего цвета. При экспорте проекта настройки для ресурсов подтягиваются автоматически.

====Область визуализации ресурсов Image Viewer====
В данной области визуализируется ресурс. Все виды ресурсов визуализируются как изображение.
По клику правой кнопкой мыши внутри области визуализации выпадает меню: 
''Center image by'' Предположим мы изменили точку пивота ресурса. 
*Если выберем Image Center to Center, то в центре Image Viewer отобразится ресурс.
* Если выберем Image Pivot to Center, то в центре Image Viewer отобразится точка пивота. (См. рисунок справа) 
[[Файл:RR_Pivot_1_.JPG|300px]] [[Файл:RR_Pivot_2.JPG|350px]] 
''Directory View Mode'' — Если мы выберем режим Full Source Image , то мы будем видеть изображение и пустую область вокруг него, равную размерам сцены, а если Cropped Images — то только изображение 

====Shape====
Для работы с объектами физического мира иногда требуется создать дополнительный контур вокруг объекта.
Физ_объектами могут быть не только прямоугольники. Шейп (Shape) можно задавать полигоном и кругом в Shape editor.
Количество вершин в полигоне должно быть от 3 до 8. Создавать новую шейп-фигуру можно несколькими полигонами.

[[Файл:Физика5.PNG|500px]] 

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

[[Файл:Circle shape.jpg|500px]] 

Для удаления нарисованного шейпа нажимаем Delete 

=== Создание базы графических ресурсов ===
1. Запустить редактор ресурсов ResourcesEditor.exe. В меню File выбрать New Project. 
2. В окне базы создания ресурсов в строке "Папка проекта" указать путь на ранее созданную пустую папку Resources, затем в строке "Имя базы ресурсов" вписать имя корневой базы Learning_Base. 
[[Файл:00_26.PNG]] 
3. В корневой базе создать папку Create New Folder (например, папка Lesson_01). 
4.Загрузить исходники графики из папки Sources → Lesson_01. 
[[Файл:00 27.png]] [[Файл:00 28.png]] [[Файл:00_29.PNG]] 
В папке ресурсов Resources автоматически создается папка с корневой базой (в нашем случае Learning_Base), в которой автоматически появляются папка с графическими ресурсами Lesson_01 (для урока 1) и файл Learning_Base.sirx 
[[Файл:00 30.png]] 
'''Внимание! Прямое изменение структуры файлов в папке Resources запрещено. Допускается работа только через редактор ресурсов.'''

=== Автоматическое создание базы ===

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

[[Файл:00_30a.PNG]] [[Файл:00_30b.PNG]]

=== Действия с ресурсами в Resources Editor ===
==== Общие свойства и действия с ресурсами====
'''После любых действий в редакторе ресурсов необходимо обновить базу ресурсов в Редакторе сцен!'''
*каждому ресурсу присваивается уникальный номер.
*при добавлении ресурса - присваивается следующий по порядку уникальный номер
*при экспорте экранов в текущий проект ресурсы добавляются автоматически в базу текущего проекта и присваиваются им следующие по порядку уникальные номера
*может существовать несколько ресурсов с одинаковыми именами
*ресурсы могут быть автоматически добавлены в текущий проект или добавлены из другой базы ресурсов
*ресурсы могут быть удалены, модифицированы 

==== Графические ресурсы====
В редактор ресурсов подгружаются графические форматы:
*JPEG - изображение, не имеющее прозрачности. Может использоваться для "облегчения веса", в качестве фонового изображения или для паззла;
*PNG - может поддерживать прозрачность, произвольные границы изображения. Сохраняет высокое качество изображения.
=====Создание бордера изображения=====
[[Файл:00_37.PNG|right]]
Для уменьшения вероятности появления графических артефактов вокруг изображений рекомендуется создавать прозрачную область вокруг изображения. Размеры бордера задаются в пикселях. 
Для создания прозрачной области кликаем по изображению и меняем параметр BorderSize на панели настройки ресурса(см. рисунок справа). После этого обязательно нажимаем '''Аpply''', иначе выбранное значение для бордера не сохранится. 
Для создания бордеров у всех ресурсов выбираем меню Projects – Options и на вкладке Cropping Settings параметру Transparent Border Size присваиваем нужное значение. 
[[Файл:00_46.PNG|00_46.PNG]] [[Файл:00_47.PNG]] 

=====Точка пивота=====
Иногда возникает необходимость сместить точку вращения объекта вокруг своей оси (точку пивота). 
Для этого в редакторе ресурсов выбираем редактируемый объект и в панели настроек ресурса изменим значения параметров Pivot. 
Если мы хотим произвольно задать координаты точки пивота, то ставим галочку Edit Pivot и после этого «таскаем» редактируемый ресурс по области визуализации ресурсов. Точка пивота находится в центре экрана (красный крестик)

=====Динамические ресурсы=====
Динамические ресурсы могут быть настроены разными способами. От способа настройки будет зависеть упаковка (или не упаковка) в текстуры.
[[Файл:Res_dyn_1.png]] [[Файл:Res_dyn_2.png]] [[Файл:Res_dyn_3.png]]

* Если выбрать ''Dynamic'' и ''Pack into texture'' в настройках контейнера, то все ресурсы упакуются в одну (или несколько) динамических текстур.

* Если выбрать только ''Dynamic'', то ресурсы будут отдельными динамическими картинками.

* Можно выбрать ''Dynamic'' для одного ресурса, тогда он так же будет отдельной динамической картинкой.

* Параметр ''Dynamic'' для звуков и музыки используется только при экспорте на Flash.

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

=====Настройки текстур=====
Параметр texture mode [[Файл:Resource editor texture.png]] определяет принадлежность картинки к текстуре.
*Если стоит -1, то картинка которая используется только на одном экране вместе с такими же картинками(которые используются только на том же экране что и выбранная) на этом экране будут упакованы в текстуру, если все картинки не поместятся в текстуру размером 1024х1024, то те картинки, которые не поместились попадут в 2-й файл текстуры.
*Если картинка используется на нескольких экранах, то в текстуру она не попадёт. Также она не попадет в текстуру, если используется в одном экране, но на нескольких принадлежащих ему сценах.
*Если стоит 1, 2, 3 и т.д до 100, то данная картинка объединится в текстуру вместе с картинками у которых стоит такое же значение в texture mode. Если все не поместятся в одну текстуру размером 1024х1024, то не поместившиеся изображения попадут в 2-ю текстуру и т.д..
В процессе упаковки ресурсов в текстуры картинки могут быть развернуты. Отказаться от этого можно, выбрав '''Do not rotate'''.

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

Контейнеры - это папки, содержащие ресурсы. Отличие от обычных папок состоит в том, что все попавшие в один контейнер файлы будут упакованы в одну текстуру. Причем текстура эта будет квадратной, а также будет дотягиваться до степени двойки.

====Настройка параметров контейнера====

Если принадлежащий контейнеру ресурс нигде не используется, то он никуда не попадёт: что не в текстуру контейнера, что не в ресурсы экспортированного проекта вообще. 

[[Файл:Container params.jpg]]

'''Размер текстуры'''

Для контейнера есть возможность выбирать размер текстуры, в которую упакуются его ресурсы: 1024*1024, 2048*2048. В случае, когда в одну текстуру не вместятся все ресурсы контейнера, будет создана еще одна текстура с таким же размером. 
Например, была создана текстура размера 1024*1024 с именем container_0000. Но остался один ресурс, который в нее не вместился. Независимо от размера этого ресурса будет создана еще одна текстура размера 1024*1024 с именем container_0001. 
Но если для контейнера был, допустим, выбран размер текстуры 1024*1024, а его ресурсы могут смело вместится в текстуре 512*512 (256*256, 128*128 и т.д), то будет создана текстура соответствующего размера.

'''Настройки качества и оптимизации'''

Можно настроить качество графики после экспорта и оптимизацию для скорости загрузки проекта или для уменьшения распакованного дистрибутива.
Также графику контейнера можно не упаковывать в текстуры, но при этом настройки качества графики и оптимизации всё равно будут применены.

'''Тип текстуры'''

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

[[Файл:Scene editor export window.jpg]] 

Но приоритетней считаются настройки, сделанные для контейнера.

'''Пример'''

Был создан проект, в котором ресурсы некоторого экрана находились в контейнере. Размер текстуре был задан 1024*1024. Поочередно для контейнера выбирались все возможные типы текстур. Результаты представлены ниже. 
1) None - текстура согласно настройкам экспорта.

2) Compressed (RGB) + Png (A) 
container_0000.png - 1,28 Mb, 
container_0000_а.png - 48,7 Kb 
[[Файл:Texture_type_2.png]]

3) Jpg (RGB) + Png (A) 
container_0000.jpg - 277 Kb, 
container_0000_а.png - 48,7 Kb 
[[Файл:Texture_type_3.png]]

4) Compressed (RGBA)+Hitmask 
container_0000.png - 1,51 Mb, 
container_0000.msk - 128 Kb 
[[Файл:Texture_type_4.png]]

5) Png (RGBA) 
container_0000.png - 1,51 Mb 
[[Файл:Texture_type_5.png]]

6) Jpg (RGB) 
container_0000.jpg - 266 Kb 
[[Файл:Texture_type_6.png]]

====Анимация====
Анимация создается путем вызова кнопки add_animations и выбором нескольких графических файлов из любой папки 
[[Файл:00_40.PNG]][[Файл:00_41.PNG|300px]] 
После загрузки анимации можно изменить ее параметры. Например, изменить скорость анимации (смены кадров) и зациклить, поставив галочку напротив Looped. 
В левой части нижнего окна анимации находится список загруженных изображений, в правой - последовательность изображений (кадров), которые можно менять местами, добавлять/удалять, загружать в прямом/обратном порядке. Таким образом, можно "уменьшить вес" анимации за счет использования меньшего количества исходных изображений. 
[[Файл:00_43.PNG]][[Файл:00_44.PNG]] [[Файл:00_45.PNG]]

'''!!! - Желательно использовать графические файлы одинакового разрешения.'''

====Звуковые файлы====
Звуковые файлы нам нужны для озвучки персонажей и не только. Используются файлы в форматах: 
*mp3 - используется как ресурс для длинного звука mus. Звуки такого формата могут воспроизводиться только последовательно.
*ogg - используется как ресурс для короткого звука snd (snd-звуки могут воспроизводиться параллельно) и для подключения голоса voice (если voice подключен к тексту, то воспроизводится последовательно). Имеет меньший объем, чем формат mp3.
Воспроизведение звуковых файлов устанавливают через различные объекты. Например, через состояния объекта Machine
[[Файл:00_48.PNG]] 

[[Category:AppSalute]]