Pentamino

Pentamino - объект для реализации механики игры в пентамино.

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

Положение - координата верхнего левого угла объекта на сцене

Игровое поле - разметка области внутри объекта, в которой будет располагаться игровое поле

• Положение поля ( xf , yf ) - координаты верхнего левого угла поля (точкой отсчета является положение самого pentamino (т.е. левая верхняя точка объекта)
• Размер поля ( wf , hf ) - размер игрового поля, считается вправо-вниз от его положения

Инвентарь - разметка области внутри объекта, в которой будет располагаться инвентарь, в котором будут находиться "детали" головоломки

• Положение инвентаря ( xPF , yPF ) - координаты верхнего левого угла поля (точкой отсчета является положение самого pentamino (т.е. левая верхняя точка объекта)
• Размер инвентаря ( wPF , hPF ) - размер иинвентаря, считается вправо-вниз от его положения

Графика

• Подложка ( background ) - графика подложки ячеек
• Рамки
  • поля ( fld_res ) - ресурс для рамки клетки поля
  • особая ( fldal_res ) - специальная рамочка, которая подсвечивает место, куда ляжет пентамино
  • пентамино ( frm_res ) - ресурс для рамки клетки пентамино
• пентамино ( pent_res ) - ресурс(ы) для тайлинга фигур (клипами анимации)
• пустая ячейка ( emp_res ) - ресурс для ячейки в которой не могут размещаться фигуры
• прозрачность рамки ( alpha_cell ) - с заданной прозрачностью будут отображаться выделенные в файле уровней рамка поля

Машины состояний и анимации

• установка фигуры ( aDrop ) - Анимация, которая будет переходить в состояние beg при установки фигуры
• таскание фигуры ( aFly ) - Анимация, которая будет переходить в состояние beg при таскание фигуры
• неправильная установка фигуры ( objid ) - Анимация, которая будет переходить в состояние beg, если фигура установлена неправильно и будет возвращена в инвентарь

Звуки

• поднял фигуру ( snd_take ) - звук, который воспроизводится при поднятии фигуры
• бросил правильно ( snd_drop ) - звук, который воспроизводится при правильном броске фигуры
• бросил мимо поля ( snd_miss_drop ) - звук, который воспроизводится при броске фигуры мимо поля
• возврат в инвентарь ( snd_inv ) - звук, который воспроизводится при возврате фигуры в инвентарь

Уровни

• файл уровня ( levelFile ) - Имя файла с уровнями
• номер уровня ( levelNum ) - Номер загружаемого уровня из файла уровней

Хинт

• альфа хинта ( alpha_hint ) - с заданной прозрачностью будет отображаться хинт
• время хинта ( tm_hint ) - за данное время хинт от непрозрачного дойдет до заданной прозрачности

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

подняли фишку - при изъятии фигуры из инвентаря или игрового поля:

• машина - Машина, реагирующая на подьем фигуры
• состояние - Переводим машину в указанное состояние
• параметр - Изменяем указанный параметр машины
• значение параметра - Изменяем параметр на указанное значение

опустили фишку - при отпускании фишки:

• машина - Машина, реагирующая на опускание фигуры
• состояние - Переводим машину в указанное состояние
• параметр - Изменяем указанный параметр машины
• значение параметра - Изменяем параметр на указанное значение

победа - если поле полностью собрано (на поле нет пустых ячеек):

• машина - Машина, реагирующая на собранное поле (победа)
• состояние - Переводим машину в указанное состояние
• параметр - Изменяем указанный параметр машины
• значение параметра - Изменяем параметр на указанное значение

Состояния

(TODO)

• nextlevel - загружает следующий уровень. Если текущий уровень последний, то запускается первый.

Примечания

• Координаты игрового поля и инвентаря отсчитываются от левого верхнего угла объекта pentamino.

Уровни пентамино

Уровни для пентамино хранятся в xml файле со следующей структурой:

<levels>
 <level id="0" col="4" row="4" len="111">
  <field>
   0000
   00*0
   0*00
   0000
  </field>
 </level>
</levels>

levels - основной тег, must have level - параметры и структура уровня

• id - идентификатор уровня, используется в поле Уровни - номер уровня
• col - кол-во столбцов, считываемых из поля field
• row - кол-во строк, считываемых из поля field
• len - (?) средний\предпочитаемый размер фигуры (кол-во элементов в одной фигуре)

field - хранилище игрового поля; возможна запись одной строкой. 0 - свободная ячейка, * - недоступная ячейка

Пример

(TODO)