HiddenList

Общие сведения

HiddenList является менеджером поисковых объектов. Для корректного подсчета очков (если он требуется). HiddenList должен располагаться в дереве - ниже всех своих поисковых объектов. На сегодня HiddenList не просто управляет объектами на сцене, он отвечает за все штрафы, поощрения, а в связке с такими объектами как HiddenHint + Effect можно реализовать графические эффекты: "ночь", "трансформация цвета" и т.д. с одним набором графики, а также систему подсказок.

Параметры

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

Ниже приведен список параматров и свойств листа которые мы можем найти на картинках справа.

• группа - объект группе которого принадлежит текущий объект
  
• память - Если 1, то при повторном открытии экрана объект не обновляет свои параметры (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)
  
• картинка - Графический ресурс для отображения объекта. Перетаскивается мышкой из редактора ресурсов (поле должно находится в состоянии редактирования). Обычно не используется, а применяется для отображения table
  
• таблица - Объект, типа table который является визуальным отображением списка. Должна быть обязательно
  
• Подсказка — объект типа HiddenHint, который является менеджером хинтов.
  
• Счетчик — объект типа Counter, который отображает количество найденных объектов.
  

В самом счетчике в параметрах нужно указать val = 0, поскольку изначально нет найденных объектов.

• Таймер — объект типа Timer, который отображает время игры.

При инициализации листа он передаст состояние "start" таймеру.

Внешний вид

• вычеркнуть - Если 1, то найденный объект вычеркивается, оставаясь в списке(таблице), иначе он удаляется из списка.
  
• листать - Если 1, то список можно листать (скролировать), иначе ищутся только те, кто сейчас в нём виден.
  
• тип списка - Тип поиска объектов: 1 - слово, 2-предложение, 3-удаляемая пиктограмма, 4-пиктограмма, 5-поиск различий.
  

Звуки при нахождении хидденов

• обычный - Звук при нахождении обычного HiddenObject
• коллекционный - Звук при нахождении коллекционного HiddenObject(объекту должна быть установлена коллекция)

Параметры поиска

Основные

• объектов - Максимальное количество доступных для поиска объектов в одной игровой сессии. (ВАЖНО!!! Таблице нужно установить общее количество ячеек равное(или больше) количеству доступных для поиска объектов.)
  
• одного типа - Максимальное количество объектов одного типа - поле тип в hiddenObject или хидден объекты с одинаковыми текстовыми ID могут считаться объектами одного типа (если -1 то игнорируется)
• прятать - Делать невидимыми объекты, не участвующие в поиске
• оставлять - Оставлять найденный объект на месте (вызывая только флаеры) при удачном клике
• актёр-иконка - если "да", то во время полёта найденного хидден-объекта вместо него летит иконка которая помечена как "main picture" и указана в текстовом id хидден-объекта.
  

Скорость

Отвечают за скорость перемещения найденного объекта.

• полета - Скорость полета в пикселях в секунду.
• вращения - Скорость вращения в градусах в секунду.

Другие

• скалирование объектов - При нахождении во время полета объект будет скалироватся: 0 - отключено, 1 - включено
• пропадание объектов - При нахождении во время полета объект будет менять альфу: 0 - отключено, 1 - включено
• реагировать на отпускание - Объекты связанные с этим хидденлистом будут реагировать на отпускание, а не на нажатие. 0 - отключено, 1 - включено (То есть реагировать на четкий клик, если кликнули и сместили область клика объект не реагирует!)
• задержка срабатывания - только для реакции на нажатие. Время между нажатием и реакцией списка объектов.
• объединять одинаковые тексты - Объекты с одинаковым текстом будут жить в одной ячейке таблицы с добавлением множителя xN. 0 - отключено, 1 - включено
• множитель для иконок - Графический ресурс(анимация) для отображения множителя у иконок для типа списка 4(поиск по иконкам) и включенного объединения одинаковых текстов. Первый фрейм - х2, второй - х3 и т.д.
• исключать одинаковые тексты - исключает или не исключает из поиска объекты с одинаковыми txtID, используется совместно с одного типа.
• вероятность пассивного предпочитаемого объекта - вероятность выпадения пассивного объекта, если у объекта стоит параметр "предпочитаемый" используется при исключении объектов с одинаковыми текстовыми ID
• вероятность активного предпочитаемого объекта - вероятность выпадения активного объекта, если у объекта стоит параметр "предпочитаемый" используется при исключении объектов с одинаковыми текстовыми ID
• реагировать на невидимые - реагировать или нет на объекты, которые в момент игры не видны в таблице. (Кликаются только те hiddenObject которые отображены в таблице, остальные нет!)
• распределять равномерно - Равномерно распределять объекты по площади сцены.
• прятать актеров при старте - Устанавливать актерам видимость false при старте (по умолчаинию - да)(То есть всем актерам которые находятся на сцене при запуске принудительно установиться vis = 0)
• аномалия - нет, текстовая, ночь, трансформация цвета, дым (Можно передавать параметром "anom", val = 0,1,2,3,4 соответственно)

Сессии

Время

игры - Общее время игры (если -1, то игнорируется). Если оно истекает, идет переход на экран [время вышло] (см.ниже)

прерывать - Если 1, то по окончанию времени игра будет прервана, иначе - продолжится, но переход все равно будет на неудачную ветку

паузы - Время перед закрытием окна после разбора (для осмысления результата)

Другие параметры

разбор: если был экран - При нахождении всех объектов, переходим на определенный экран, если некоторый экран был уже хотя бы раз посещен

был экран - Экран, который мы проверяем на то, был ли он уже открыт хотя бы один раз

перейти на - Переходим на этот экран, если экран из предыдущего поля уже открывался

разбор: изменить состояние объекта - При нахождении всех объектов, перевести объект в новое состояние

объект - Перевести объект в состояние из следующего поля

состояние - Новое состояние для объекта из предыдущего поля

разбор: изменить параметр объекта - При нахождении всех объектов, изменить параметр объекта

объект - этот объект меняет свой параметр

свойство - Параметр, который мы изменяем

значение - Новое значение параметра

не успел: если был экран - Если вышло время, а объекты не найдены, переходим на определенный экран, если некоторый экран был уже хотя бы раз посещен

был экран - Экран, который мы проверяем на то, был ли он уже открыт хотя бы один раз

перейти на - Переходим на этот экран, если экран из предыдущего поля уже открывался

не успел: изменить состояние объекта - Если вышло время, а объекты не найдены, перевести объект в новое состояние

объект - перевести объект в состояние из следующего поля

состояние - Новое состояние для объекта из предыдущего поля

не успел: изменить параметр объекта - Если вышло время, а объекты не найдены, изменить параметр объекта

объект - этот объект меняет свой параметр

свойство - Параметр, который мы изменяем

значение - Новое значение параметра

сохранять в профиль - Если =1, то значение будет сохранено в текущий профиль, если 0 - то глобально

счётчик очков - дополнительный счётчик очков

группа extra bonus. Используется для economics, при находжении объекта с некой вероятностью может выпасть бонус. Объект который анимирует появление бонуса должен иметь состояние show, время на наимацию бонуса - 10 секунд.

монетки объект - объект который анимирует получение монет

монетки вероятность - вероятность по нахождению объекта получить дополнительно монетки

опыт объект - объект который анимирует получение опыта

опыт вероятность - вероятность по нахождению объекта получить дополнительно опыт

энергия объект - объект который анимирует получение энергии

энергия вероятность - вероятность по нахождению объекта получить дополнительно энергию

Состояния

invert - горизонтально отображает изображение

Цвета

• Цвет обязательных — цвет текста для обязательных объектов, указывается код цвета, если строку не заполнять цвет не используется
• Цвет найденных — цвет текста для найденных объектов, указывается код цвета, если строку не заполнять цвет не используется

Система очков

Счетчик — счетчик, отображающий набранные очки

ID пака — строковый идентификатор пака; используется для вытаскивания суммарных очков в счетчики

ID игры — строковый идентификатор игры (сцены); используется для вытаскивания результатов игры в счетчики.

Обязательно должен иметь префиксом ID пака. Например, если pack_id = "pack1", то game_id = "pack1.game1"

Очки — количество очков, которые даются за каждый найденный хидден

Бонус за скорость — бонус за быстро найденный хидден

Бонусный интервал — время, за которое нужно найти хидден для бонуса

бонус за время - Очковый бонус за оставшееся время игры

Бонусный мультипликатор — Если 1, то умножать очки за второй быстро найденный предмет на 2, за третий на 3, и т. д.

Количество кликов для штрафа — количество неверных кликов, после которых будет штраф

Интервал для штрафа — время, за которое эти клики нужно совершить

Штраф (очки) — штраф в очках

Штраф (время) — штраф во времени

блокатор - Объект, блокирующий сцену при серии ошибочных кликов

время блокировки - Время блокировки при серии ошибочных кликов

аниматор очков - машина, которая анимирует полученные очки, должна иметь состояние anim

коэффициент комбо - коэфициент для расчёта очков за комбо

счётчик очков за объект - счётчик который показывает очки за полученный объект

счётчик комбо-очков - счётчик очков полученных за комбо-серию, сумарный

счётчик комбо-серий - счётчик который показывает комбо-серию (комбо из 2-х, 3-х и т.д. найденых объектов)

Звезды

combo num - Количество быстро найденных объектов, нужное для получения звезды Combo

combo time - Интервал между кликами, считающимися быстрыми для Combo

accuracy - Точность кликов для получения звезды Accuracy