Progress

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

Стандартные свойства

res — в качестве графического ресурса исп. анимация с нужным на количеством кадров
количество — количество прогресс баров
dx — расстояние между прогресс барами по X, если их больше 1
dy — расстояние между прогресс барами по Y, если их больше 1
вертикальный – если 1, то прогресс бар будет размножен вертикально

Как работает

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

Ниже приведена запись из опций:

<last_game/>
  <pk1>
     <pz01 lv0="2" lv1="1"/>
  </pk1>

У нас есть два значения lv0="2" и lv1="1"

Напомню что у нас есть такое поле как количество

В этом примере параметр игра равен "pk1.pz01", а параметр уровень равен "lv". Прогрессбар сам добавляет число после уровня в соответствии с внутренним порядковым номером(см количество), который отсчитывается от 0. То есть, если в параметре количество задать 1, то к уровню будет приписан 0, если задать 2, то будет приписана 1. Первый прогресс бара будет считывать значение в lv0, 2-й будет считывать значение в lv1. Параметры игра и уровень можно задавать как в самом прогрессбаре, так и внешними объектами, такими как кнопки, или машины состояний. Для пазлов в анимации графического ресурса прогрессбара должно быть 3 кадра, например пустая звезда, серебряная и золотая. Запись lv0="1" или lv0="2" впазлах присваивается, в зависимости от того, превысило или нет число ходов в пазле значение лучший счетчик. Если lv0="1" - это "серебряная звёздочка", lv0="2" - "золотая". Для отображения результата текущей игры в пазлах можно прогрессбару задать в поле игра значение last_game, а в поле уровень значение star.
В общем случае для прогрессбара кадров анимации в его графическом ресурсе должно быть столько же сколько возможных отображаемых состояний у прогресбара.
Также прогресбару можно указать с помощью кнопки или машины состояний определённый кадр анимации из графического ресурса заданного прогрессбару. Для этого в надо задать игру и уровень через точку, и значение при этом указать явно которому из прогресбаров(см количество) мы указываем кадр, например game.level0, а в прогрессбаре указать в поле игра game, а в поле level – level.