Расширения.

Содержание

Дистрибутив расширений
PDN формат
Использование апплета

Дистрибутив расширений.

Расширения это архив с файлами, показывающими возможности добавления новой функциональности в программу Checkersland PC. Расширения работают на всех поддерживаемых программой операционных системах и содержат следующее: три внешних вида интерфейса программы, файлы с переводом интерфейса на различные языки, PDN файлы и пример создания собственного внешнего вида доски.

Информация о дистрибутиве:

Версия: 3.7
Дата выпуска: 26.01.2010
Размер: 2.5 Mb

Скачать: 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 файлов и информация о разновидностях шашек сохраняется всегда.

Использование апплета.

Вы можете использовать апплет на своем сайте для демонстрации партий или комбинаций. Для этого нужно вставить специальный код в страницу:

<applet code="ppa.checkersland.applet.Main.class"
    width="578" height="524"
    archive="http://checkersland.com/download/checkersland-applet.jar">
  <param name=language value="ru">
  <param name=color value="cccccc">
  <param name=notation value="around">
  <param name=movehighlighters value="false">
  <param name=rotateboard value="true">
  <param name=pdn value="[Date '2009.05.17']\n
    [White 'Иванов']\n[Black 'Петров']\n
    [Result '0-1']\n[GameType '25']\n
    1. c3-d4 d6-c5 2. b2-c3 f6-g5 3. c3-b4 g5-h4 4. b4xd6 e7xc5\n
    {Это хорошо известный дебют} 5. d2-c3 g7-f6 6. g3-f4 f6-g5\n
    7. c1-b2 f8-g7 8. c3-b4? {Проигрышный ход} h4-g3! 9. b4xd6\n
    (9. f2xf6 g7xa5 {Белые без шашки} 0-1) 9. ... g3xc3\n
    10. b2xd4 c7xc3 11. e3-f4 g5xe3 12. f2xb2 {Белые без шашки} 0-1">
  Ваш браузер не поддерживает апплеты.
</applet>

В примере используются следующие параметры:

width и height - ширина и высота апплета на странице. Для каждой разновидности шашек минимальная ширина и высота рассчитывается по следующей формуле:
width = 222 + 36 * N
height = 168 + 36 * N
где N - размер доски. Нетрудно подсчитать, что размеры апплета, поддерживающего все разновидности шашек, должны быть 654x600
language - язык интерфейса. Дополнительную инфомацию смотрите в разделе перевод интерфейса программы на различные языки
color - цвет фона апплета. Формат значения параметра RRGGBB, где RR - красный, GG - зеленый, BB - синий
notation - расположение нотации на доске. Доступны два значения:
around - нотация вокруг доски
onboard - нотация на клетках доски
При добавлении нотации вокруг доски необходимо также увеличить размеры апплета по ширине и высоте на 68
movehighlighters - настройка подсвечивания доступных ходов в текущей позиции. Значение должно быть либо true либо false
pdn - данные отображаемой партии в PDN формате, при этом все двойные кавычки нужно заменить на одинарные и вместо перевода строки использовать символы \n
rotateboard - перевернуть доску. Используется только если установлен параметр pdn.

После того, как вы установите код примера к себе на страницу, вы увидите апплет с партией как показано ниже:

Ваш браузер не поддерживает апплеты.

Язык:
Главная страница Школа шашек Программы Компьютер Мобильник Апплет Расширения Регистрация Правила шашек ЧаВо Участие Форум	Расширения. Содержание Дистрибутив расширений Внешние виды интерфейса Перевод интерфейса программы на различные языки Настройка внешнего вида доски PDN формат Использование апплета Дистрибутив расширений. Расширения это архив с файлами, показывающими возможности добавления новой функциональности в программу Checkersland PC. Расширения работают на всех поддерживаемых программой операционных системах и содержат следующее: три внешних вида интерфейса программы, файлы с переводом интерфейса на различные языки, PDN файлы и пример создания собственного внешнего вида доски. Информация о дистрибутиве: Версия: 3.7 Дата выпуска: 26.01.2010 Размер: 2.5 Mb Скачать: 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 файлов и информация о разновидностях шашек сохраняется всегда. Использование апплета. Вы можете использовать апплет на своем сайте для демонстрации партий или комбинаций. Для этого нужно вставить специальный код в страницу: <applet code="ppa.checkersland.applet.Main.class" width="578" height="524" archive="http://checkersland.com/download/checkersland-applet.jar"> <param name=language value="ru"> <param name=color value="cccccc"> <param name=notation value="around"> <param name=movehighlighters value="false"> <param name=rotateboard value="true"> <param name=pdn value="[Date '2009.05.17']\n [White 'Иванов']\n[Black 'Петров']\n [Result '0-1']\n[GameType '25']\n 1. c3-d4 d6-c5 2. b2-c3 f6-g5 3. c3-b4 g5-h4 4. b4xd6 e7xc5\n {Это хорошо известный дебют} 5. d2-c3 g7-f6 6. g3-f4 f6-g5\n 7. c1-b2 f8-g7 8. c3-b4? {Проигрышный ход} h4-g3! 9. b4xd6\n (9. f2xf6 g7xa5 {Белые без шашки} 0-1) 9. ... g3xc3\n 10. b2xd4 c7xc3 11. e3-f4 g5xe3 12. f2xb2 {Белые без шашки} 0-1"> Ваш браузер не поддерживает апплеты. </applet> В примере используются следующие параметры: `width` и `height` - ширина и высота апплета на странице. Для каждой разновидности шашек минимальная ширина и высота рассчитывается по следующей формуле: `width = 222 + 36 * N` `height = 168 + 36 * N` где `N` - размер доски. Нетрудно подсчитать, что размеры апплета, поддерживающего все разновидности шашек, должны быть 654x600 `language` - язык интерфейса. Дополнительную инфомацию смотрите в разделе перевод интерфейса программы на различные языки `color` - цвет фона апплета. Формат значения параметра RRGGBB, где RR - красный, GG - зеленый, BB - синий `notation` - расположение нотации на доске. Доступны два значения: `around` - нотация вокруг доски `onboard` - нотация на клетках доски При добавлении нотации вокруг доски необходимо также увеличить размеры апплета по ширине и высоте на 68 `movehighlighters` - настройка подсвечивания доступных ходов в текущей позиции. Значение должно быть либо `true` либо `false` `pdn` - данные отображаемой партии в PDN формате, при этом все двойные кавычки нужно заменить на одинарные и вместо перевода строки использовать символы `\n` `rotateboard` - перевернуть доску. Используется только если установлен параметр `pdn`. После того, как вы установите код примера к себе на страницу, вы увидите апплет с партией как показано ниже: Ваш браузер не поддерживает апплеты.
(c) Павел Порватов. Email: support@checkersland.com