Panzer City — установка на PocketBook
=====================================

Содержимое пакета
-----------------
  applications/panzer.app                        игра (ARM, InkView)
  applications/icons/desktop_app_panzer.bmp      иконка (8 бит, 128x128)
  applications/icons/desktop_app_panzer_f.bmp    иконка в фокусе
  INSTALL.txt                                    этот файл

Установка
---------
1. Подключите читалку кабелем (режим «Связь с ПК»).
2. Скопируйте папку applications из пакета в КОРЕНЬ памяти читалки,
   согласившись на объединение с существующей папкой applications.
   Должно получиться:
       /applications/panzer.app
       /applications/icons/desktop_app_panzer.bmp
       /applications/icons/desktop_app_panzer_f.bmp
3. Если копировали с Mac — выполните в Терминале (иначе в списке
   появится второй, неработающий «panzer», см. следующий раздел):

       dot_clean -m "/Volumes/<имя читалки>/applications"

4. Отключите кабель. Игра появится в разделе «Приложения».

Чтобы приложение НЕ двоилось в списке
-------------------------------------
Раздел «Приложения» строится из всего, что прошивка находит в папках
applications. Пункт задваивается в четырёх типичных случаях:

  * копирование с Mac — самый частый. Память читалки отформатирована в
    FAT, а в FAT негде хранить расширенные атрибуты, которые macOS
    вешает на файлы. Поэтому при копировании (хоть через Finder, хоть
    через cp) рядом с panzer.app появляется служебный файл
    ._panzer.app. Прошивка делает пунктом списка ВСЁ, что лежит в
    applications/, — вот вам и второй «panzer», который не
    запускается: это 4 КБ служебных данных, а не программа. Лечится
    одной командой в Терминале (путь — имя читалки, как оно видно в
    Finder):

        dot_clean -m "/Volumes/Basic 3/applications"

    Файлы ._* можно и просто удалить, полезного в них ничего нет.
    Сборка из исходников (make install) чистит их сама.

  * .app лежит в двух местах сразу — например, во внутренней памяти И
    на microSD-карте, или вторая копия осталась в другой папке
    (скажем, вы скопировали на читалку весь каталог build/). Держите
    ровно ОДНУ копию panzer.app — только в applications/ одного
    накопителя.

  * посторонние файлы в applications/ — на старых прошивках каждый
    файл этой папки становится пунктом списка. Поэтому иконки лежат в
    подпапке applications/icons/, а не рядом с .app. Ничего, кроме
    *.app, в саму папку applications не кладите.

  * на новых прошивках (6.x) — пункт для приложения добавлен в
    system/config/desktop/view.json с именем, которое НЕ совпадает с
    именем приложения: тогда прошивка показывает и свой автоматический
    пункт, и ваш. Имя после "U_" обязано совпадать с именем .app (см.
    ниже), тогда записи объединяются.

Иконка
------
* Прошивки 6.x (новые модели): добавьте в
  /system/config/desktop/view.json, в раздел "applications", блок:

      "U_panzer": {
        "path": "/mnt/ext1/applications/panzer.app",
        "title": "Panzer City",
        "icon": "/mnt/ext1/applications/icons/desktop_app_panzer.bmp",
        "focused_icon": "/mnt/ext1/applications/icons/desktop_app_panzer_f.bmp"
      }

  и упомяните "U_panzer" в нужной группе того же файла. После правки
  проверьте JSON на валидность (например, jsonlint.com) — синтаксическая
  ошибка ломает весь рабочий стол.

* Прошивка 5.x (PocketBook 614W и другие кнопочные модели): подключать
  иконку нечем — файла system/config/desktop/view.json на этих
  прошивках просто нет, он появился только в 6.x, а другого места, где
  сторонняя программа могла бы назначить себе значок, прошивка не
  предоставляет. Игра отображается со стандартным значком под именем
  "panzer". Файлы иконок при этом не мешают (лежат в подпапке) и
  пригодятся на более новой модели.

Управление в игре
-----------------
  танк едет сам и не останавливается
  стрелки        сменить направление
  OK и листалки  выстрел
  долгое OK      пауза и меню (продолжить/заново/тест клавиш/выход)

Плавное движение
----------------
В меню паузы есть пункт «Плавное движение». Выключенный (так по
умолчанию), танк переставляется сразу на клетку — так игра просит от
экрана ровно столько же, сколько версия 1.0. Включённый, ход рисуется
промежуточными положениями: смотрится заметно лучше, но экран получает
примерно на четверть больше обновлений, и на медленной панели игра
пойдёт медленнее. Попробуйте включить: настройка запоминается.

Если кнопки не совпали: «Меню -> Тест клавиш» покажет код каждой
кнопки; коды правятся одной строкой в build_keymap() (src/main.c).

Удаление
--------
Удалите /applications/panzer.app (и иконки из /applications/icons/),
затем /system/config/panzer.cfg — там хранятся прогресс и рекорд.
