Расширения программы Checkersland.
Содержание
Дистрибутив расширений.
Расширения это архив с файлами, показывающими возможности добавления новой функциональности в программу Checkersland PC. Расширения работают на всех поддерживаемых программой операционных системах и содержат следующее: три внешних вида интерфейса программы, файлы с переводом интерфейса на различные языки, PDN файлы и пример создания собственного внешнего вида доски.
Информация о дистрибутиве:
- Версия: 2020.11.12
Скачать: extension.zip
Внешние виды интерфейса.
Для программ, написанных на языке java, создано немало различных вариантов внешнего вида интерфейса (в дальнейшем LaF - Look And Feel). В каталоге lafs находится три наиболее известных из них: jgoodies, napkin и substance. Запустив соответствующий файл с расширением bat (для Windows) или с расширением sh (для других операционных систем), вы увидите программу Checkersland с новым внешним видом интерфейса.
LaF: jgoodies
LaF: napkin
LaF: substance
Перевод интерфейса программы на различные языки.
При каждом старте программа Checkersland сканирует каталог languages на наличие файлов с переводом интерфейса и загружает их. Формат имени файла должен строго соответствовать шаблону i18n_XX.properties, где XX - двухсимвольный код языка. Содержимое файла должно соответствовать кодировке utf-8. После успешной загрузки новые языки будут добавлены в список доступных языков в окне настроек. Перевод на новый язык проще всего делать на основе уже существующего английского перевода i18n_en.properties, который можно найти в дистрибутиве.
Настройка внешнего вида доски.
Во время каждого старта программы Checkersland из каталога skins загружаются дополнительные внешние виды доски (в дальнейшем скины). Каждый скин должен находится в отдельном подкаталоге и состоит из набора картинок с определенными именами и файла skin.ini с дополнительными настройками. В дистрибутиве есть пример создания скина с подробным описанием каждой картинки. Все загруженные скины добавляются в список доступных типов доски окна настроек.
Скин: example
Скин: web
PDN формат.
PDN (Portable Draughts Notation) это самый популярный формат для хранения партий в текстовых файлах. Он позволяет сохранять любое количество партий в одном файле, при этом каждая партия может содержать множество дополнительной информации: имена игроков, турнир, место проведения, дата партии и т.п. Более подробную информацию о спецификации этого формата можно получить на английском языке здесь: http://en.wikipedia.org/wiki/Portable_Draughts_Notation.
Программа Checkersland позволяет просматривать загруженный PDN файл в виде списка партий и редактировать его. В списке некоторые партии могут быть подсвечены одним из двух цветов: красным - в данных партии отсутствует какая-либо необходимая информация (например информация о разновидности шашек) или история партии некорректна, синим - данные партии поменялись и запись будет изменена при сохранении всего списка.
Так же есть специальный режим просмотра круговых турниров. Программа автоматически определяет позиции игроков в таблице, количество набранных очков и занятые места в турнире, после чего рисуется таблица в первозданном виде. Пример файла с круговым турниром есть в файле pdn/towers/SPb_open.pdn дистрибутива расширений. При помощи программы можно загрузить любую партию (из списка или прямо из таблицы кругового турнира), посмотреть ее, отредактировать и сохранить изменения.
Есть множество программ поддерживающих этот формат. Так же существует огромное количество готовых PDN файлов для разнообразных видов шашек. Такие файлы обычно не содержат информацию о разновидности шашек, для которых эти партии предназначены. В таком случае, если вы попытаетесь загрузить файл, все партии будут подсвечены красным цветом. Для того чтобы этого не было, нужно перед загрузкой файла указать в настройках программы используемую по-умолчанию разновидность шашек (Опции > Настройки > PDN файлы > Разновидность шашек). Данная настройка не влияет на сохранение PDN файлов и информация о разновидностях шашек сохраняется всегда.