Руководство KTuberling
Руководство KTuberling
След.

Руководство KTuberling

Éric Bischoff

Paul E. Ahlquist, Jr.

Редактор: Lauri Watts
Перевод на русский язык: Кирилл Бирюков
Обновление перевода: Сергей Миронов
Издание 0.05.01 (2006-05-05)

Разрешается копировать, распространять и/или изменять этот документ на условиях лицензии GNU для свободной документации, версии 1.1 или более поздней, опубликованной Фондом Free Software Foundation; без неизменямых разделов, без текста на первой странице, без текста на последней странице. Копия лицензии находится здесь the section entitled "GNU Free Documentation License".

KTuberling — игра для малышей.


Глава 1. Введение
Введение
Пред.
След.

Глава 1. Введение

KTuberling — игра для малышей. Конечно, она подойдёт и взрослым, оставшимся в душе детьми.

Эта игра по сути — «редактор картофелины». Это означает, что на картофельный клубень можно приклеивать глаза, рты, усы, другие части лица и всякие прибамбасы. В игре также есть ещё есть пингвин и аквариум, на которые можно приклеивать другие предметы.

В этой игре нет ни победителей, ни проигравших. Её единственная цель — создавать забавные и весёлые лица.

В игре есть галерея (подобно Музею восковых фигур мадам Тюссо), где можно найти много забавных примеров украшенных картофелин, аквариумов и пингвинов. Конечно же, можно отправить и свои собственные творения автору программы, Éric Bischoff, и он, если найдёт свободную минутку, включит их в галерею.

Игра KTuberling может «разговаривать». Она произносит имена объектов, которые вы перетаскиваете. Игра будет «разговаривать» на языке по вашему выбору. Её даже можно использовать, чтобы немного поучить иностранные слова. В данный момент Клубень может «разговаривать» на датском, немецком, английском, испанском, французском, итальянском, голландском, португальском, румынском, сербском, словенском и шведском языках.

Пред.
След.
Начало


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Глава 2. Основные области экрана
Основные области экрана
Пред.
След.

Глава 2. Основные области экрана

Действия мышью

В главном окне есть две основные области:

  • Слева — «игровое поле».

  • Справа — поле «объекты», откуда вами выбираются объекты для переноса на игровое поле.


Основное окно

Размещение объектов

Чтобы разместить объект, подведите курсор мыши к расположенной справа области «объектов». Нажмите левой кнопкой мыши на нужном вам объекте и, не отпуская кнопку мыши, перетащите объект на «игровое поле» в то место, куда вы хочется, после чего отпустите кнопку мыши.

Перемещение объектов

Объект, уже помещённый в «игровое поле», может быть передвинут. Просто выберите объект мышью, щёлкнув по нему, и перетащите мышью на новое место. Если щёлкнуть по объекту, частично скрытому под другими объектами, то он будет поднят поверх всех объектов. Это свойство можно использовать, чтобы правильно разместить глаза и очки.

Удаление объекта

Чтобы удалить помещённый на «игровое поле» объект перетащите его с «игрового поля» обратно на область «объектов».

Панель инструментов
Панель инструментов

Панель инструментов


Панель инструментов

На панели инструментов расположены кнопки с часто используемыми функциями.

Таблица 2.1. Кнопки панели инструментов

КнопкаНазваниеЭквивалент в менюДействие
Кнопка новой игры Создать Игра->Создать Сброс «игрового поля». При этом все части игрового поля очищаются для создания нового украшения.
Кнопка загрузки Загрузить Игра->Загрузить... Открыть существующий файл из галереи или из других папок.
Кнопка сохранения Сохранить Игра->Сохранить Сохранить ваше творение в домашнюю или любую другую папку, например, в галерею. Созданное вами существо сохраняется в небольшом файле, куда записываются только координаты составляющих его объектов.
Кнопка печати Печать Игра->Печать Напечатать ваш рисунок на принтере.
Кнопка отмены действия Отменить действие Правка->Отменить действие Отменить последнее действие.
Кнопка повтора действия Повторить отменённое действие Правка->Повторить Повторить последнее отменённое действие.


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Пункты меню
Пункты меню

Пункты меню


Команды меню

Меню Игра


Меню Игра
Игра->Создать (Ctrl+N)

Очистить «игровое поле»

Игра->Загрузить... (Ctrl+O)

Отрыть существующий файл Клубня из галереи или из другого места.

Игра->Сохранить (Ctrl+S)

Сохранить ваше творение. Созданное вами существо сохраняется в небольшом файле, куда записываются только координаты составляющих его объектов.

Игра->Сохранить как изображение...

Создать графический файл, содержащий изображение созданного существа. Доступные форматы: XPM, JPEG, PNG и BMP.

Игра->Печать... (Ctrl+P)

Печать рисунка.

Игра->Выход (Ctrl+Q)

Выход из KTuberling.

Меню Правка


Меню Правка
Правка->Отменить действие (Ctrl+Z)

Отменить размещение последнего объекта.

Правка->Повторить (Ctrl+Shift+Z)

Повторить размещение последнего объекта. Этот пункт меню будет активен только в том случае, если вы до этого отменяли свои действия, используя пункт «Отменить действие».

Правка->Копировать (Ctrl+C)

Копировать игровое поле в буфер обмена.

Меню Персонаж


Меню Персонаж
Персонаж->Клубень

Создать игровое поле с картофельным клубнем. KTuberling запомнит тип выбранного игрового поля и будет его использовать при следующем запуске игры.

Персонаж->Пингвин

Создать игровое поле с пингвином. KTuberling запомнит тип выбранного игрового поля и будет его использовать при следующем запуске игры.

Персонаж->Аквариум

Создать игровое поле с аквариумом. KTuberling запомнит тип выбранного игрового поля и будет его использовать при следующем запуске игры.

Меню Звуки


Меню Звуки

Помните, чтобы услышать звуки, нужно установить пакет kdemultimedia и запустить artsd.

Звуки->Отключить

Включить или выключить звук. KTuberling сохранит это поведение и при следующем запуске игры.

Звуки->По-датски

Включить или отключить речь на датском языке. Этот пункт меню будет недоступен, если не установлены звуковые файлы на датском языке. KTuberling сохранит это поведение и при следующем запуске игры.

Звуки->По-немецки

Включить или отключить речь на немецком языке. Этот пункт меню будет недоступен, если не установлены звуковые файлы на немецком языке. KTuberling сохранит это поведение и при следующем запуске игры.

Звуки->По-английски

Включить или отключить речь на английском языке. Этот пункт меню будет недоступен, если не установлены звуковые файлы на английском языке. KTuberling сохранит это поведение и при следующем запуске игры.

и так далее...

То же и для других языков.

Меню Настройка


Меню Настройка
Настройка->Показать/Скрыть панель инструментов

Показать или скрыть панель инструментов.

Настройка->Комбинации клавиш...

Вызвать стандартное диалоговое окно настройки комбинаций клавиш KDE, в котором можно изменить комбинации клавиш, используемые в KTuberling.

Настройка->Панели инструментов...

Вызвать стандартное диалоговое окно настройки панели инструментов KDE.

Меню Справка


Меню Справка
Помощь->Содержание (F1)

Запускает Центр помощи KDE и открывает справочное руководство по KTuberling. (Этот документ вы и читаете).

Помощь->Что это? (Shift+F1)

Вид курсора меняется на стрелочку со знаком вопроса. Нажимая на различные элементы внутри KTuberling, вы увидите подсказку с объяснениями назначения и действия данного элемента (если она для него существует).

Помощь->Сообщить об ошибке...

Открывается диалог отправки сообщения об ошибке. Он служит для того, чтобы вы могли отправить сведения об обнаруженной вами ошибке в программе или свое «пожелание», чтобы какая-либо пока что отсутствующая возможность была реализована в будущих версиях программы.

Помощь->О программе KTuberling

Будут выведены сведения о версии и авторах программы.

Помощь->О KDE

Будут выведены сведения о версии KDE.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Пред.
След.
Начало


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Глава 3. Руководство разработчика
Руководство разработчика
Пред.
След.

Глава 3. Руководство разработчика

Éric Bischoff

Перевод на русский язык: Кирилл Бирюков
Обновление перевода: Сергей Миронов
Издание 0.05.01 (5 мая 2006)

KTuberling позволяет легко подключиться к разработке и улучшению KDE. Приложение может быть дополнено. Например, без всякого кода можно добавить новые рисунки игрового поля, изменив графические файлы. Добавив подходящие звуковые файлы переводчик может изменить звучание на его родной язык!

Если вы что-то разработали или добавили к игре, вышлите это автору Éric Bischoff для включения в следующие версии.

Художникам

Размер, форма игрового поля и количество объектов можно изменить. Для каждого игрового поля необходимо создать два графических файла: поле изображения поля и маску. В игре допускается до восьми игровых полей, из которых в настоящий момент используется только три.

В KTuberling используются шесть изображений:potato-game.png,potato-mask.png,penguin-game.png,penguin-mask.png,aquarium-game.png и aquarium-mask.png. Файлы размещаются в $KDEDIR/share/apps/ktuberling/pics/.

Первый тип рисунков, *-game.png, содержит изображения игрового поля и объектов, выбираемых пользователем. Это та графика, которую вы видите в процессе игры.

Второй тип рисунков, *-mask.png, содержит только маски объектов. Маски используются для установки границ объектов и в некоторых случаях позволяют объекту быть прозрачным (как, например, очки). Желательно, хотя и не обязательно, размещать объекты на тех же местах в файле игрового поля, что и в файле маски.

В той же папке находится файл layout.xml ($KDEDIR/share/apps/ktuberling/pics/layout.xml), который описывает используемые файлы, и связывает их с пунктами меню. Кроме того, он описывает позиционные параметры игрового поля и объектов в файлах игрового поля и маски. В том же файле объектам присваиваются звуки и производится объединение объектов в группы. Наконец, в нём описаны языки как наборы переведённых звуков. Файл layout.xml является стандартным файлом XML (подробнее смотрите ниже).

В этой же папке находится файл с именемlayout.i18n ($KDEDIR/share/apps/ktuberling/pics/layout.xml), содержащий строки из файла layout.xml, которые могут быть переведены:

  • Пункты меню, позволяющие выбирать игровое поле и язык

  • Названия категорий объектов

В папке выше находится другой файл XML ktuberlingui.rc ($KDEDIR/share/apps/ktuberling/ktuberlingui.rc), описывающий меню KTuberling. Он должен содержать один тег <action> (действие) на каждое игровое поле и язык. Символическое название действия в этом файле должно быть идентично символическому название действия в файле layout.xml.

Переводчику
Переводчику

Переводчику

Кроме обычного механизма перевода файла .po могут также быть локализованы названия и звуки в программе.

Звуковые файлы в формате .wav с названиями объектов на языке перевода могут быть помещены в подпапке соответствующего языка в основной папке звуков. Имя файла звука затем следует соотнести с названием в файле layout.xml. Например, если язык перевода русский, то необходимо поместить звуковые (.wav) файлы с названиями объектов в папку $KDEDIR/share/apps/ktuberling/sounds/ru. Затем нужно соотнести звук «hat» с файлом ru/шляпа.wav.

В будущей версии KTuberling будет использовать файлы OGG Vorbis rc3 для хранения звуков. В настоящий момент можно конвертировать файлы WAV в формат OGG Vorbis rc3 следующей командой:

$ oggenc -q 10 -o sound.ogg sound.wav

Информация о том, как переводить приложения KDE, доступна в Руководстве по переводу kde;.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Программистам
Программистам

Программистам

Программисту не трудно развить и дополнить функциональность KTuberling.

Классы C++

TopLevel

Окно верхнего уровня и основные функции управления программой

PlayGround

Описание одного из уровней игры

ToDraw

Описание одного из выводимых графических «объектов»

SoundFactory

Описание одного из языков и его звуков

Action

Действие пользователя, связанное с отменой/повтором

Структура файлов .tuberling

Файл .tuberling содержит всю необходимую для рисования информацию. Файл можно редактировать обычным текстовым редактором.

Первая строка содержит номер игрового поля.

Все остальные строки содержат по одному графическому объекту, в том порядке, в котором они должны быть нарисованы. Каждая строка содержит 5 чисел: идентификатор объекта и координаты прямоугольника (левая, верхняя, правая, нижняя), в которых будет нарисован объект. Числа разделяются пробелами или символами табуляции.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Структура файла layout.xml.
Структура файла layout.xml.

Структура файла layout.xml.

Тег верхнего уровня является уникальным и называется <ktuberling>. В нём содержится несколько тегов игровых полей <playground>, по одному на игровое поле, и <language> по одному на язык.

Тег <playground> имеет два атрибута: gameboard и masks. Эти атрибуты задают имена файлов, содержащих изображения. Тег <playground> также содержит один тег <menuitem>, один тег <editablearea>, несколько тегов <category> и несколько тегов <object>.

Тег <menuitem> описывает идентификатор действия в пункте меню, позволяющий выбрать положение области, в которую можно помещать объекты, а также название этого пункта меню. Этот идентификатор действия должен совпадать с идентификатором в файле ktuberlingui.rc.

Тег <editablearea> описывает положение области, в которую вы можете помещать объекты и имя соответствующего звукового файла.

Тег <category> указывает положение и текст, описывающий группу объектов. Например, им могут быть описаны положение и текст группы «Шляпы».

Тег <object> описывает положение (в игровом поле и в масках) объекта, и имя соответствующего звукового файла.

Тег <language> имеет один атрибут: code. Этот атрибут задаёт код языка. Тег <language> также содержит один тег <menuitem> и несколько тегов <sound>.

Здесь не описываются теги более низкого уровня, так как их названия говорят сами за себя. Если измените файл layout.xml, то не забывайте соответственно изменять и файлы layout.i18n и ktuberlingui.rc.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Пред.
След.
Начало


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Глава 4. Авторские права и лицензирование
Авторские права и лицензирование
Пред.
След.

Глава 4. Авторские права и лицензирование

KTuberling

  • Оригинальная идея, рисунки и звуки на английском языке: John Calhoun

  • Программирование под KDE: Éric Bischoff

  • Тестирование, советы и помощь: François-Xavier Duranceau

  • Изображение пингвина: Agnieszka Czajkowska

  • Переработка графики и изображение аквариума: Bas Willems

  • Настройка звуков: Roger Larsson

  • Обучающая графика для COR-EDUX: Dolores Almansa

  • Чтение и редактирование документации: Peter Silva

  • Исправление документации: Paul Ahlquist

Эта игра посвящена моей маленькой дочери Sunniva Bischoff

Благодарности: Apple Computer и проекту LinuxPPC™ за портирование на Mac® и на Linux®. KTuberling не мог быть создан без вас!

Перевод на русский язык: Кирилл Бирюков

Обновление перевода: Сергей В. Миронов

Этот документ распространяется на условиях GNU Free Documentation License.

Программа распространяется на условиях лицензии GNU General Public License.

Пред.
След.
Начало


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Приложение A. Установка
Установка
Пред.
След.

Приложение A. Установка

Как получить ktuberling

KTuberling - это часть проекта KDE http://www.kde.org/.

KTuberling входит в пакет kdegames на ftp://ftp.kde.org/pub/kde/, основном FTP-сервере KDE.

Требования
Требования

Требования

Для успешной сборки KTuberling требуется KDE версии не ниже 3.5. Все необходимые библиотеки, как и сам KTuberling, можно взять на сервере ftp://ftp.kde.org/pub/kde/.

Для поддержки звука вам понадобится пакет kdemultimedia.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Сборка и установка
Сборка и установка

Сборка и установка

Чтобы собрать и установить KTuberling, введите следующие команды в каталоге дистрибутива KTuberling:

% ./configure
% make
% make install

Поскольку KTuberling использует autoconf и automake, у вас не должно возникнуть никаких проблем. Если же у вас возникли ошибки, сообщите о них в списки рассылки KDE.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Пред.
След.
Начало


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

След.
 


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team