You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tde-i18n/tde-i18n-ru/docs/tdebase/ksplashml/index.docbook

1088 lines
51 KiB

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY kappname "&ksplash;">
<!ENTITY package "tdebase">
<!ENTITY % addindex "IGNORE">
<!ENTITY % Russian "INCLUDE">
]>
<book lang="&language;">
<bookinfo>
<title>Руководство пользователя &ksplash;</title>
<authorgroup>
<author>&Teemu.Rytilahti; &Teemu.Rytilahti.mail; </author>
<othercredit role="developer">&Brian.C.Ledbetter; &Brian.C.Ledbetter.mail; </othercredit>
<othercredit role="developer">&Ravikiran.Rajagopal; &Ravikiran.Rajagopal.mail; </othercredit>
<othercredit role="translator"><firstname>Иван</firstname><surname>Кашуков</surname><affiliation><address><email>dolphin210@yandex.ru</email></address></affiliation><contrib>Перевод на русский язык</contrib></othercredit><othercredit role="translator"><firstname>Николай</firstname><surname>Шафоростов</surname><affiliation><address><email>shafff@ukr.net</email></address></affiliation><contrib>Обновление перевода</contrib></othercredit> <othercredit role="translator"><firstname>Виктор</firstname><surname>Ерёмин </surname><affiliation><address><email>ErV2005@rambler.ru</email></address></affiliation><contrib>Перевод на русский язык</contrib></othercredit>
</authorgroup>
<copyright>
<year>2003</year>
<holder>Teemu Rytilahti</holder>
</copyright>
<copyright>
<year>2003-04</year>
<holder>Ravikiran Rajagopal</holder>
</copyright>
<legalnotice>&FDLNotice;</legalnotice>
<date>2003-01-10</date>
<releaseinfo>1.01.00</releaseinfo>
<abstract>
<para>&ksplash; &mdash; симпатичный экран, показывающий процесс загрузки среды KDE.</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>tdebase</keyword>
<keyword>ksplash</keyword>
<keyword>ksplashml</keyword>
<keyword>заставка</keyword>
<keyword>украшение</keyword>
</keywordset>
</bookinfo>
<chapter id="introduction">
<title>Введение</title>
<para>&ksplash; &mdash; симпатичный экран, показывающий процесс загрузки KDE. Вопросы и пожелания отправляйте в списки рассылки &kde;. Отличительные особенности &ksplash;: </para>
<simplelist>
<member>Возможность применения тем</member>
<member>Высокая гибкость в настройке обеспечивается использованием подключаемых модулей</member>
<member>Программа может быть использована любым приложением, которое работает с DCOP</member>
</simplelist>
<para>Это руководство объясняет, как создавать темы для использования с уже доступными подключаемыми модулями. Если ни один из доступных модулей не удовлетворяет вашему вкусу, вы можете научиться полностью настраивать внешний вид &ksplash;, создавая подключаемые модули на C++. </para>
</chapter>
<chapter id="using-themes">
<title>Использование тем</title>
<para>Чтобы использовать темы с <ulink url="http://www.kde-look.org">KDE-Look</ulink>, скопируйте их в <filename>~/.trinity/apps/ksplash/Themes/</filename> (для одного пользователя) или в <filename>$<envar>TDEDIR</envar>/share/apps/ksplash/Themes/</filename> (чтобы сделать их доступными для всех пользователей вашей системы).</para>
<para>Чтобы сделать это автоматически, используйте модуль <guilabel>Заставка</guilabel> раздела <guilabel>Внешний вид и темы</guilabel> Центра управления &kde;.</para>
<sect1 id="using-kcontrol-module">
<title>Модуль Центра управления</title>
<para>Этот модуль позволяет устанавливать, проверять и удалять темы &ksplash;.</para>
<para>Внизу расположен список доступных тем &ksplash;. При выборе одной из последних, её предварительный просмотр появится в соответствующей части окна. Чтобы активировать тему, нажмите <guibutton>OK</guibutton> или <guibutton>Применить</guibutton>.</para>
<para>Чтобы установить новые модули, нажмите <guibutton>Добавить...</guibutton>. Не нужно распаковывать файлы тем, они могут обрабатываться и в сжатом виде.</para>
<para>Для просмотра анимации темы, нажмите кнопку<guibutton>Тест</guibutton>.</para>
<para>Чтобы удалить тему, воспользуйтесь кнопкой <guibutton>Удалить</guibutton>. Если тема установлена для всех пользователей, то удалять её нужно с правами администратора. Также, мы не рекомендуем удалять тему «<guilabel>По умолчанию</guilabel>».</para>
</sect1>
</chapter>
<chapter id="themes">
<title>Как создавать темы для &ksplash;</title>
<sect1 id="themes-general">
<title>Основные положения</title>
<para>Создавать свои собственные темы для &ksplash; достаточно легко. Когда вы закончили свою тему, вы можете отправить её на <ulink url="http://www.kde-look.org">KDE-Look</ulink>, чтобы её могли использовать другие.</para>
<sect2 id="theme-syntax">
<title>Определение своей темы</title>
<para>Давайте создадим тему под названием <literal>MyCoolTheme</literal>. Чтобы тема была найдена &ksplash;, следует поместить её в папку <filename class="directory">MyCoolTheme</filename> в папке <filename class="directory">~/.trinity/apps/ksplash/Themes/</filename>. В ней должен содержаться файл <filename>Theme.rc</filename>, содержащий настройки темы. Вы можете установить множество особенностей для темы, изменить движок подключаемых модулей и т. д. Не обязательно использовать все доступные параметры, обычно используются только некоторые. Синтаксис записей файла <filename>Theme.rc</filename>: <literal>[параметр] = [значение]</literal>. Параметры описаны в следующих разделах.</para>
<example>
<title>Простой файл <filename>Theme.rc</filename></title>
<programlisting>[KSplash Theme: MyCoolTheme]
Name = MyCoolTheme
Description = Симпатичная тема, использующая движок XpLike
Version = 1.0
Author = Имя автора &lt;realmail@mail.com&gt;
## Используйте движок XpLike для этой темы.
Engine = XpLike
Show Icon = false
Welcome Text = Загрузка KDE
</programlisting>
</example>
<para>После того как вы задали имя, описание и автора темы, вам следует выбрать движок темы (подключаемый модуль). Затем вы сможете настроить разнообразные характеристики движка темы, устанавливая пары параметр=значение, как в вышеприведённом файле.</para>
<important>
<para>Важно, чтобы имя папки, в которой хранятся файлы темы (<filename class="directory">~/.trinity/apps/ksplash/Themes/MyCoolTheme</filename> в данном примере) и идентификатор (<literal>[KSplash Theme: MyCoolTheme] </literal> в данном примере) в <filename>Theme.rc</filename> совпадали. В противном случае, &ksplash; не распознает тему.</para>
</important>
</sect2>
<sect2 id="theme-files">
<title>Файлы фона</title>
<para>При запуске &ksplash; пытается найти файл фона, соответствующий текущему разрешению экрана (если файл используется движком темы). Формат названия файла фона: <filename>Background-<replaceable>WWWxHHH</replaceable>.png</filename>, где WWW-ширина, а HHH-высота изображения.</para>
<para>Например, вам надо использовать файл <filename>Background-1024x768</filename>. Если файл, соответствующий текущему разрешению экрана, не найден, программа пытается изменить размер файла <filename>Background.png</filename> (или другого, заданного в <filename>Theme.rc</filename>) так, чтобы он соответствовал разрешению. Изменение размера <quote>на лету</quote> занимает некоторое время, так что вам следует создать файлы как минимум для следующих разрешений экрана: 1280x1024, 1024x768 и 800x600.</para>
</sect2>
</sect1>
<sect1 id="theme-engines">
<title>Параметры движков тем</title>
<sect2 id="default-themes">
<title>Тема, используемая по умолчанию</title>
<table>
<title>Настройка темы по умолчанию</title>
<tgroup cols="3">
<tbody>
<row>
<entry>Параметр</entry>
<entry>Значение</entry>
<entry>Описание</entry>
</row>
<!-- Statusbar -->
<row>
<entry>Always Show Progress</entry>
<entry>[true/false]</entry>
<entry>Определяет, будет ли показан прогресс загрузки. Значение по умолчанию &mdash; true.</entry>
</row>
<row>
<entry>Label Foreground</entry>
<entry>[цвет]</entry>
<entry>Цвет текста индикатора состояния. Значение по умолчанию &mdash; white (белый, #FFFFFF).</entry>
</row>
<!-- Misc. things -->
<row>
<entry>Icons Flashing</entry>
<entry>[true/false]</entry>
<entry>Определяет, будут ли мерцать значки. По умолчанию — true (да).</entry>
</row>
</tbody>
</tgroup>
</table>
</sect2>
<sect2 id="standard-themes">
<title>Стандартная тема</title>
<table>
<title>Параметры стандартной темы</title>
<tgroup cols="3">
<tbody>
<row>
<entry>Параметр</entry>
<entry>Значение</entry>
<entry>Описание</entry>
</row>
<!-- Statusbar -->
<row>
<entry>Statusbar Position</entry>
<entry>[top/bottom]</entry>
<entry>Определяет расположение индикатора состояния на экране. Значение по умолчанию &mdash; bottom (внизу).</entry>
</row>
<row>
<entry>Statusbar Visible</entry>
<entry>[true/false]</entry>
<entry>Определяет, будет ли индикатор состояния видимым. Значение по умолчанию &mdash; true (да).</entry>
</row>
<row>
<entry>Progress Visible</entry>
<entry>[true/false]</entry>
<entry>Определяет, будет ли показан прогресс загрузки. Значение по умолчанию &mdash; true.</entry>
</row>
<!-- Fonts -->
<row>
<entry>Statusbar Font</entry>
<entry>[шрифт]</entry>
<entry>Шрифт, используемый в индикаторе состояния. Значение по умолчанию &mdash; Helvetica.</entry>
</row>
<row>
<entry>Statusbar Font Size</entry>
<entry>[размер]</entry>
<entry>Размер шрифта индикатора состояния. Значение по умолчанию &mdash; 16 пт.</entry>
</row>
<row>
<entry>Statusbar Font Bold</entry>
<entry>[true/false]</entry>
<entry>Определяет, будет ли шрифт индикатора состояния полужирным. Значение по умолчанию &mdash; true (да).</entry>
</row>
<row>
<entry>Statusbar Font Italic</entry>
<entry>[true/false]</entry>
<entry>Определяет, будет ли шрифт индикатора состояния курсивным. Значение по умолчанию &mdash; false (нет).</entry>
</row>
<!-- Misc. things -->
<row>
<entry>Statusbar Foreground</entry>
<entry>[цвет]</entry>
<entry>Цвет переднего плана индикатора состояния. Значение по умолчанию &mdash; white (белый).</entry>
</row>
<row>
<entry>Statusbar Background</entry>
<entry>[цвет]</entry>
<entry>Цвет фона индикатора состояния. Значение по умолчанию &mdash; black (чёрный).</entry>
</row>
<row>
<entry>Statusbar Icon</entry>
<entry>[true/false]</entry>
<entry>Определяет, будет ли значок у индикатора состояния.</entry>
</row>
<row>
<entry>Icons Visible</entry>
<entry>[true/false]</entry>
<entry>Определяет, будут ли значки видимыми. Значение по умолчанию &mdash; true (да).</entry>
</row>
<row>
<entry>Icons Jumping</entry>
<entry>[true/false]</entry>
<entry>Определяет, будут ли прыгать значки. Значение по умолчанию &mdash; true (да).</entry>
</row>
<row>
<entry>Icon Position</entry>
<entry>[0-3, 10-13]</entry>
<entry>Расположение значков. Значение по умолчанию &mdash; вверху слева.</entry>
</row>
<row>
<entry>Splash Screen</entry>
<entry>[название]</entry>
<entry>Название заставки.</entry>
</row>
</tbody>
</tgroup>
</table>
</sect2>
<sect2 id="redmond-themes">
<title>Тема Redmond</title>
<table>
<title>Параметры темы Redmond</title>
<tgroup cols="3">
<tbody>
<row>
<entry>Параметр</entry>
<entry>Значение</entry>
<entry>Описание</entry>
</row>
<!-- Main elements -->
<row>
<entry>Background Image</entry>
<entry>[имя_файла]</entry>
<entry>Определяемое пользователем фоновое изображение.</entry>
</row>
<row>
<entry>User Icon</entry>
<entry>[имя_значка]</entry>
<entry>Имя значка пользователя. Значение по умолчанию &mdash; <constant>go</constant>.</entry>
</row>
<row>
<entry>Welcome Text</entry>
<entry>[текст]</entry>
<entry>Текст, показываемый на экране. Значение по умолчанию &mdash; «Добро пожаловать».</entry>
</row>
<row>
<entry>Username Text</entry>
<entry>[текст]</entry>
<entry>Текст, замещающий имя пользователя.</entry>
</row>
<!-- Positioning elements -->
<row>
<entry>Welcome Text Position</entry>
<entry>[x,y]</entry>
<entry>Область экрана, в которой показывается текст приглашения (определяемый параметром «Welcome Text»).</entry>
</row>
<row>
<entry>Username Text Position</entry>
<entry>[x,y]</entry>
<entry>Область экрана, в которой показывается имя пользователя.</entry>
</row>
<row>
<entry>Action Text Position</entry>
<entry>[x,y]</entry>
<entry>Область экрана, в которой показывается текущее действие.</entry>
</row>
<row>
<entry>Icon Position</entry>
<entry>[x,y]</entry>
<entry>Область экрана, в которой показывается значок пользователя.</entry>
</row>
<!-- Show to show.. -->
<row>
<entry>Show Welcome Text</entry>
<entry>[true/false]</entry>
<entry>Определяет, будет ли показываться текст приглашения. Значение по умолчанию &mdash; true (да).</entry>
</row>
<row>
<entry>Show Welcome Shadow</entry>
<entry>[true/false]</entry>
<entry>Определяет, будет ли показываться тень под текстом приглашения. Значение по умолчанию &mdash; true (да).</entry>
</row>
<row>
<entry>Show Username</entry>
<entry>[true/false]</entry>
<entry>Определяет, будет ли показываться имя пользователя. Значение по умолчанию &mdash; true (да).</entry>
</row>
<row>
<entry>Show Action</entry>
<entry>[true/false]</entry>
<entry>Определяет, будет ли показываться действие, выполняемое в данный момент. Значение по умолчанию &mdash; true (да).</entry>
</row>
<row>
<entry>Show Icon</entry>
<entry>[true/false]</entry>
<entry>Определяет, будет ли показываться значок пользователя. Значение по умолчанию &mdash; true (да).</entry>
</row>
<row>
<entry>Use TDM User Icon</entry>
<entry>[true/false]</entry>
<entry>Определяет, будет ли использоваться значок, соответствующий пользователю при входе в систему. Значение по умолчанию &mdash; true (да).</entry>
</row>
</tbody>
</tgroup>
</table>
</sect2>
<sect2 id="macx-themes">
<title>Тема MacX</title>
<table>
<title>Параметры темы MacX</title>
<tgroup cols="3">
<tbody>
<row>
<entry>Параметр</entry>
<entry>Значение</entry>
<entry>Описание</entry>
</row>
<row>
<entry>Icon Size Minimum</entry>
<entry>[размер]</entry>
<entry>Минимальный размер значков. Значение по умолчанию &mdash; 16 пикселей.</entry>
</row>
<row>
<entry>Icon Size Maximum</entry>
<entry>[размер]</entry>
<entry>Максимальный размер значков. Значение по умолчанию &mdash; 64 пикселя.</entry>
</row>
<row>
<entry>Optimized Icon Rendering</entry>
<entry>[true/false]</entry>
<entry>Будет ли оптимизироваться отрисовка значков. Значение по умолчанию &mdash; true (да).</entry>
</row>
<row>
<entry>Progress Bar Visible</entry>
<entry>[true/false]</entry>
<entry>По умолчанию &mdash; true (да).</entry>
</row>
<row>
<entry>Progress Bar Position</entry>
<entry>[top/bottom]</entry>
<entry>Определяет расположение индикатора состояния (внизу или вверху). По умолчанию - bottom (внизу).</entry>
</row>
<row>
<entry>Icons Jumping</entry>
<entry>[true/false]</entry>
<entry>Определяет, будут ли прыгать значки. Значение по умолчанию &mdash; false (нет).</entry>
</row>
</tbody>
</tgroup>
</table>
</sect2>
<sect2 id="mac-classic-themes">
<title>Тема MacClassic</title>
<table>
<title>Параметры темы MacClassic</title>
<tgroup cols="3">
<tbody>
<row>
<entry>Параметр</entry>
<entry>Значение</entry>
<entry>Описание</entry>
</row>
<row>
<entry>Icon Position</entry>
<entry>[0-3, 10-13]</entry>
<entry>Расположение значков на экране. Значение по умолчанию &mdash; внизу слева.</entry>
</row>
<row>
<entry>Icons Jumping</entry>
<entry>[true/false]</entry>
<entry>Определяет, будут ли прыгать значки. Значение по умолчанию &mdash; false (нет).</entry>
</row>
<row>
<entry>Icons Visible</entry>
<entry>[true/false]</entry>
<entry>Определяет, будут ли значки видимыми. Значение по умолчанию &mdash; true (да).</entry>
</row>
<row>
<entry>Splash Screen</entry>
<entry>[название]</entry>
<entry>Название заставки.</entry>
</row>
</tbody>
</tgroup>
</table>
</sect2>
<sect2 id="themes-2k">
<title>Тема 2k</title>
<table>
<title>Параметры темы 2k</title>
<tgroup cols="3">
<tbody>
<row>
<entry>Параметр</entry>
<entry>Значение</entry>
<entry>Описание</entry>
</row>
<row>
<entry>Title Background Color</entry>
<entry>[цвет]</entry>
<entry>Фоновый цвет заголовка. Значение по умолчанию &mdash; dark blue (тёмно-синий).</entry>
</row>
<row>
<entry>Title Foreground Color</entry>
<entry>[цвет]</entry>
<entry>Цвет переднего плана заголовка. Значение по умолчанию &mdash; white (белый).</entry>
</row>
<row>
<entry>Status Text Color</entry>
<entry>[цвет]</entry>
<entry>Цвет текста состояния. По умолчанию соответствует фоновому тексту заголовка (определяемому параметром «Title Background Color»).</entry>
</row>
<row>
<entry>Rotator Color 1</entry>
<entry>[цвет]</entry>
<entry>Определяет цвет индикатора 1. Значение по умолчанию &mdash; dark blue (тёмно-синий).</entry>
</row>
<row>
<entry>Rotator Color 2</entry>
<entry>[цвет]</entry>
<entry>Определяет цвет индикатора 2. Значение по умолчанию &mdash; cyan (циан).</entry>
</row>
<row>
<entry>Rotator Speed</entry>
<entry>[значение]</entry>
<entry>Определяет скорость индикатора. Значение по умолчанию &mdash; 30.</entry>
</row>
<row>
<entry>Window Title</entry>
<entry>[текст]</entry>
<entry>Определяет текст заголовка окна.</entry>
</row>
<row>
<entry>Logo File</entry>
<entry>[имя_файла]</entry>
<entry>Определяет используемый логотип.</entry>
</row>
</tbody>
</tgroup>
</table>
</sect2>
</sect1>
</chapter>
<chapter id="from-other-applications">
<title>Использование &ksplash; в вашем собственном приложении</title>
<para>В этой главе описывается простой метод использования &ksplash; в качестве заставки для вашего приложения &kde;. Если вы не разрабатываете приложения для &kde;, вы можете опустить эту главу.</para>
<sect1 id="basic-other-reqs">
<title>Основные требования</title>
<para>Ваше приложение &kde; должно работать с &DCOP;. &DCOP; &mdash; это технология &kde;, использующаяся для коммуникации между приложениями. Если вы используете <ulink url="http://developer.kde.org">стандартную структуру приложения &kde;</ulink>, это обеспечивается автоматически. Чтобы получить информацию о &DCOP; и связанных технологиях &kde;, посетите <ulink url="http://developer.kde.org">сайт разработчиков &kde;</ulink>.</para>
</sect1>
<sect1 id="other-using">
<title>Запуск &ksplash;</title>
<para>До того, как ваше приложение начнёт вычисления, загрузку подключаемых модулей и т.д., запустите &ksplash;. Образец:</para>
<programlisting>DCOPClient *c = kapp-&gt;dcopClient();
QString error;
QCString KSplashName;
int pid = 0;
QStringList args;
args &lt;&lt; "--theme=MyCoolTheme" &lt;&lt; "--managed";
if (kapp-&gt;startServiceByDesktopName("ksplash", args, &amp;error,
&amp;KSplashName, &amp;pid))
{
KMessageBox::sorry(0, error, "Невозможно запустить KSplash");
//обработка ошибок.
}
</programlisting>
<para>Мы предполагаем, что запущено только одно окно &ksplash;. Другие случаи немного более сложны. Разъяснения смотрите в документации &DCOP;.</para>
</sect1>
<sect1 id="show-messages">
<title>Показ сообщений</title>
<para>Перед показом сообщений вам необходимо установить число шагов. Например, процедура запуска &kde; включает 7 этапов.</para>
<programlisting>QByteArray data;
QDataStream arg(data,IO_WriteOnly);
arg &lt;&lt; someNumber;
if (!(c-&gt;send(KSplashName, "KSplashIface", "setStartupItemCount(int)",
data))
// Обработка ошибок.
</programlisting>
<para>Если вы хотите, чтобы сообщение связывалось с соответствующим значком или без него, используйте</para>
<programlisting>arg &lt;&lt; QString("имя_значка") &lt;&lt; QString("название_программы") &lt;&lt;
QString("какое-то описание");
if (!(c-&gt;send(KSplashName, "KSplashIface",
"programStarted(QString,QString,QString)", data))
{
// Обработка ошибок.
}
</programlisting>
<para>Каждый раз, когда вы вызываете <constant>programStarted</constant>, шаги заканчиваются. Когда ваша программа закончила запуск, выполните следующие команды, чтобы убрать заставку:</para>
<programlisting>if (!(c-&gt;send(KSplashName, "KSplashIface", "startupComplete()", data))
{
// Обработка ошибок.
}
</programlisting>
<para>Это всё, что вам необходимо, чтобы использовать все преимущества &ksplash;.</para>
</sect1>
</chapter>
<!-- FIXME: Better to leave this out until it's written, or the translators -->
<!-- will have to still translate it ... -->
<chapter id="wrplugins">
<title>Создание новых подключаемых модулей &ksplash;</title>
<para>Создавать подключаемые модули &ksplash; нетрудно. В этой главе мы напишем простой модуль, который эмулирует экран загрузки одной очень известной операционной системы. Предполагается, что вы знакомы с основами языка C++ и хотя бы немного &mdash; с программированием для KDE/Qt.</para>
<sect1 id="basic-requirements">
<title>Основные требования</title>
<para>Мы создадим модуль с названием <literal>2k</literal>. Название используется во многих местах. Важно не исказить его, чтобы модуль был распознан &ksplash;. Модули &ksplash; являются динамически загружаемыми библиотеками со следующими объявлениями: </para>
<simplelist>
<member>Библиотеку следует называть по образцу: <filename>ksplash+названиеемы_в_нижнем_регистре</filename>. В нашем случае название будет <filename>ksplash2k</filename>.</member>
<member>Тема должна иметь свой файл desktop, который следует назвать <filename>ksplash+названиеемы_в_нижнем_регистре.desktop</filename>. В нашем случае &mdash; <filename>ksplash2k.desktop</filename>. </member>
<member>Наконец, библиотека должна возвращать класс с названием <literal>Theme+названиеемы</literal>, в нашем случае &mdash; <literal>Theme2k</literal>.</member>
</simplelist>
<para>Не беспокойтесь, если вы не поняли всё вышесказанное. Далее мы рассмотрим каждый шаг в деталях. Важной деталью является то, что класс модуля вы должны взять из <literal>ThemeEngine</literal>. </para>
</sect1>
<sect1 id="skeleton">
<title>Создание основы</title>
<para>При создании модуля мы будем использовать основу для приложения &kde;, которая обеспечит независимость от платформы во всех частях нашей работы. Убедитесь, что в вашей системе установлен пакет <filename>tdesdk</filename>. Выполните команду <literal>kapptemplate</literal>, чтобы создать приложение с названием "2k". Будет создана папка, содержащая основные файлы (такие как AUTHORS и т.п.). Нам нужна подпапка <filename class="directory">2k</filename>. Удалите все файлы в ней, и основа готова. </para>
<para>На следующем этапе вы должны создать файл <filename>.desktop</filename>, который, после установки, сообщит &ksplash;, что подключаемый модуль доступен. В соответствии с правилами наименования файлов, которые даны <link linkend="basic-requirements">в предыдущей секции</link>, создайте файл <filename>ksplash2k.desktop</filename>. Он должен содержать следующие строки: </para>
<programlisting><literal>
[Desktop Entry]
Encoding=UTF-8
Type=Service
Comment=KSplash Plugin
Name=KSplash2k
ServiceTypes=KSplash/Plugin
X-TDE-Library=ksplash2k
X-KSplash-Default=true
X-KSplash-PluginName=2k
X-KSplash-ObjectName=Theme2k
</literal>
</programlisting>
<para>Параметры <literal>Encoding</literal>, <literal>Type</literal>, <literal>Comment</literal> и <literal>ServiceTypes</literal> одинаковы для всех подключаемых модулей. Название модуля и библиотеки следуют вышеописанным правилам. Параметр <literal>X-KSplash-Default</literal> может принимать одно из двух значений (true или false). Он определяет, будет ли этот модуль показан в Центре управления KDE. За исключением некоторых очень редких случаев, его значение должно быть <constant>true</constant>. </para>
</sect1>
<sect1 id="headerfile">
<title>Объявление класса подключаемого модуля</title>
<para>Теперь, когда мы закончили подготовительную работу, начинается действительно интересная часть &mdash; создание класса, который обеспечивает нужное поведение модуля. Хотя мы вольны делать с этим классом всё, что хотим, существует несколько ограничений.</para>
<orderedlist>
<listitem><para>Классы модуля должны наследоваться от класса <constant>ThemeEngine</constant>.</para></listitem>
<listitem><para>Классы модуля следует называть в соответствии с правилом: <classname>Theme+названиеодуля</classname>.</para></listitem>
<listitem><para>Классы модуля должны обеспечивать <literal>статическую</literal> функцию с названием <function>names</function>, которая возвращает список названий, под которыми она может быть задействована.</para></listitem>
<listitem><para>Чтобы модуль можно было настраивать из Центра управления KDE, он должен включать класс, основанный на классе <literal>ThemeEngineConfig</literal>.</para></listitem>
<listitem><para>Классы модуля должны перекрывать хотя бы одну из следующих виртуальных функций: <function>slotSetText</function>, <function>slotSetPixmap</function>, <function>slotUpdateProgress</function> и <function>slotUpdateSteps</function>, чтобы обеспечить возможность использования.</para></listitem>
<listitem><para>Разработчик должен создать конструктор <literal>ThemeEngine( QWidget *parent, const char *name, const QStringList &amp;args )</literal>, чтобы модуль можно было использовать из <classname>KGenericFactory</classname>.</para></listitem>
</orderedlist>
<para>Последнее требование может показаться сложным, но, как мы увидим позже, вы можете обычно игнорировать его, добавив одну строку к исходному коду.</para>
</sect1>
<sect1 id="headercode">
<title>Код файла заголовка</title>
<para>Присвоив значения константам, мы увидим, что файл заголовков <filename>theme2k.h</filename> приобретёт вид вроде этого:</para>
<example>
<title>Файл <filename>theme2k.h</filename></title>
<programlisting>#ifndef __THEME2K_H__
#define __THEME2K_H__
#include &lt;qlabel.h&gt;
#include &lt;qwidget.h&gt;
#include &lt;kdialogbase.h&gt;
#include &lt;kpixmap.h&gt;
#include &lt;ksplash/themeengine.h&gt;
class RotWidget;
class Cfg2k: public ThemeEngineConfig
{
Q_OBJECT
public:
Cfg2k( TDEConfig * );
};
class ObjKsTheme;
class Theme2k: public ThemeEngine
{
Q_OBJECT
public:
Theme2k( QWidget *, const char *, const QStringList&amp; );
inline const QString name()
{
return( QString("KSplash2k") );
}
inline const KDialogBase *config( TDEConfig *kc )
{
return new Cfg2k( kc );
}
static QStringList names()
{
QStringList Names;
Names &lt;&lt; "KSplash2k";
Names &lt;&lt; "ks2k";
Names &lt;&lt; "2k";
Names &lt;&lt; "2000";
return( Names );
};
public slots:
inline void slotSetText( const QString&amp; s )
{
if( mText &amp;&amp; mText-&gt;text() != s ) mText-&gt;setText( s );
};
private:
void initUi();
void readSettings();
QLabel *mText;
RotWidget *mRotator;
QColor mTBgColor, mTFgColor, mRotColor1, mRotColor2, mStatusColor;
int mRotSpeed;
QString mWndTitle, mLogoFile;
};
#endif
</programlisting>
</example>
<para>Давайте проанализируем вышеприведённое. Класс <classname>Theme2k</classname>, унаследованный от <classname>ThemeEngine</classname> удовлетворяет объявлениям. Он обеспечивает метод <methodname>Theme2k::names()</methodname>, и имеет конструктор, который принимает необходимые параметры: <function>Theme2k( QWidget *, const char *, const QStringList&amp; );</function>, и к тому же обеспечивает простой метод <methodname>Theme2k::slotSetText()</methodname>. На данном этапе вам не следует беспокоиться насчёт класса <classname>RotWidget</classname>. Это небольшой элемент графического интерфейса, который делает программу более наглядной для пользователя. Наш подключаемый модуль очень прост: он не показывает ни значков, ни индикатора загрузки. Если вы хотите использовать значки, перекройте функцию <function>slotSetPixmap</function>. Подобные функции есть для установки индикатора загрузки (<function>slotUpdateSteps</function>) и увеличения счётчика (<function>slotUpdateProgress</function>) текущего шага. </para>
</sect1>
<sect1 id="Implementation">
<title>Реализация подключаемого модуля</title>
<para>Мы проверим только связанные части реализации. В приложении находится описание всей реализации. В первую очередь нам необходимо удовлетворить требованиям библиотеки:</para>
<example>
<title>Требования библиотеки</title>
<programlisting>K_EXPORT_COMPONENT_FACTORY( ksplash2k, KGenericFactory&lt;Theme2k&gt; );
</programlisting>
</example>
<para>Объявление макроса <constant>K_EXPORT_COMPONENT_FACTORY</constant> содержится в файле <filename>kgenericfactory.h</filename>. Теперь перейдём к конструктору. Так как подключаемый модуль совсем прост, конструктор тоже несложен.</para>
<example>
<title>Конструктор подключаемого модуля</title>
<programlisting>Theme2k::Theme2k( QWidget *parent, const char *name, const QStringList &amp;args
)
:ThemeEngine( parent, name, args )
{
readSettings();
initUi();
}
</programlisting>
</example>
<para>Метод <function>readSettings()</function> является иллюстрацией подходящего способа получить параметры темы (вы ведь хотите, чтобы люди могли использовать ваш модуль для своих тем?)</para>
<example>
<title>Получение параметров темы</title>
<programlisting>void Theme2k::readSettings()
{
if( !mTheme )
return;
TDEConfig *cfg = mTheme-&gt;themeConfig();
if( !cfg )
return;
cfg-&gt;setGroup( QString("KSplash Theme: %1").arg(mTheme-&gt;theme()) );
QColor DefaultTBgColor( Qt::darkBlue );
QColor DefaultTFgColor( Qt::white );
mTBgColor = cfg-&gt;readColorEntry( "Title Background Color",
&amp;DefaultTBgColor );
mTFgColor = cfg-&gt;readColorEntry( "Title Foreground Color",
&amp;DefaultTFgColor );
mStatusColor = cfg-&gt;readColorEntry("Status Text Color", &amp;mTBgColor );
QColor DefaultRot1( Qt::darkBlue );
QColor DefaultRot2( Qt::cyan );
mRotColor1 = cfg-&gt;readColorEntry( "Rotator Color 1", &amp;DefaultRot1 );
mRotColor2 = cfg-&gt;readColorEntry( "Rotator Color 2", &amp;DefaultRot2 );
mRotSpeed = cfg-&gt;readNumEntry( "Rotator Speed", 30 );
mWndTitle = cfg-&gt;readEntry( "Window Title", i18n("Please wait...") );
mLogoFile = cfg-&gt;readEntry( "Logo File", QString::null );
}
</programlisting>
</example>
<para>Так как мы работаем для пользователей, следует обеспечить подходящие параметры по умолчанию для параметров, которые не представлены в файле темы. Обратите внимание, что группу следует устанавливать следующим образом: "KSplash Theme: названиеемы", чтобы обеспечить совместимость с будущими спецификациями темы. Метод <function>initUI()</function> не представляет большого интереса, он просто организует элементы графического интерфейса. Детали указаны в приложении. </para>
</sect1>
<sect1 id="compilingfile">
<title>Компиляция подключаемого модуля</title>
<para>Для компиляции модуля мы решили использовать основу &kde;, поэтому необходимо создать файл <filename>Makefile.am</filename>. Он должен выглядеть следующим образом:</para>
<example>
<title>Файл <filename>Makefile.am</filename></title>
<programlisting>INCLUDES = $(all_includes)
kde_module_LTLIBRARIES = ksplash2k.la
ksplash2k_la_SOURCES = theme2k.cpp rotwidget.cpp
ksplash2k_la_LDFLAGS = $(all_libraries) $(KDE_RPATH)
ksplash2k_la_LIBADD = $(LIB_TDEUI) -lksplashthemes
METASOURCES = AUTO
noinst_HEADERS = theme2k.h rotwidget.h
servicesdir = $(kde_servicesdir)
services_DATA = ksplash2k.desktop
themedir = $(kde_datadir)/ksplash/Themes/2k
theme_DATA = Theme.rc Preview.png
</programlisting>
</example>
<para>Чтобы получить дальнейшую информацию по созданию <filename>Makefile.am</filename>, загляните на <ulink url="http://developer.kde.org/documentation/other/makefile_am_howto.html">веб-сайт</ulink> разработчиков &kde;. Заметим, что мы создаём тему по умолчанию, основанную на этом модуле, и прилагаем к нему графический файл фона. В качестве жеста доброй воли по отношению к пользователям создайте файл <filename>Theme.rc</filename>, иллюстрирующий примеры использования различных параметров.</para>
</sect1>
</chapter>
<chapter id="faq">
<title>Вопросы и ответы</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para>Я не могу найти ни одной темы, которая работала бы с &ksplash;. Почему?</para>
</question>
<answer>
<para>Возможно, у вас нет соответствующих подключаемых модулей для тем. Модули содержатся в пакете <literal>tdeartwork</literal>. Скачайте, установите его и попытайтесь запустить темы снова.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para>Что такое файл <filename>Theme.rc</filename> и как его создать?</para>
</question>
<answer>
<para><filename>Theme.rc</filename> &mdash; это файл, где вы можете задать параметры темы. Информация по нему находится в разделе <link linkend="themes">Как создавать темы для &ksplash;</link>. </para>
</answer>
</qandaentry>
</qandaset>
</chapter>
<chapter id="credits">
<title>Благодарности и лицензирование</title>
<para>&ksplash;</para>
<para>Программа: &copy; &Ravikiran.Rajagopal; &Ravikiran.Rajagopal.mail;, 2003.</para>
<itemizedlist>
<title>Помощь в разработке</title>
<listitem><para>&Brian.C.Ledbetter; &Brian.C.Ledbetter.mail;</para>
</listitem>
</itemizedlist>
<para>Документация: &copy; &Teemu.Rytilahti; &Teemu.Rytilahti.mail;, 2003.</para>
&underFDL; &underGPL; </chapter>
<appendix id="installation">
<title>Установка</title>
<sect1 id="requirements">
<title>Системные требования</title>
<para>Чтобы иметь возможность использовать возможности &ksplash; вам необходим &kde; версии 3.2 или выше. Если тема не работает, свяжитесь с её автором, чтобы выяснить, где можно взять подходящий подключаемый модуль.</para>
</sect1>
<sect1 id="compilation">
<title>Сборка и установка</title>
&install.compile.documentation; </sect1>
</appendix>
<appendix id="srccode">
<title>Исходные коды</title>
<sect1 id="theme2kcpp">
<title>Файл <filename>theme2k.cpp</filename></title>
<programlisting>#include &lt;qlabel.h&gt;
#include &lt;qwidget.h&gt;
#include &lt;tdeapplication.h&gt;
#include &lt;tdeconfig.h&gt;
#include &lt;kdebug.h&gt;
#include &lt;kdialogbase.h&gt;
#include &lt;kgenericfactory.h&gt;
#include &lt;tdeglobalsettings.h&gt;
#include &lt;tdelocale.h&gt;
#include &lt;ksplash/objkstheme.h&gt;
#include &lt;kstandarddirs.h&gt;
#include "rotwidget.h"
#include "theme2k.h"
#include "theme2k.moc"
K_EXPORT_COMPONENT_FACTORY( ksplash2k, KGenericFactory&lt;Theme2k&gt; );
Cfg2k::Cfg2k( TDEConfig * )
{}
Theme2k::Theme2k( QWidget *parent, const char *name, const QStringList &amp;args
)
:ThemeEngine( parent, name, args )
{
readSettings();
initUi();
}
void Theme2k::initUi()
{
QVBox *vbox = new QVBox( this );
vbox-&gt;setFrameShape( QFrame::WinPanel );
vbox-&gt;setFrameShadow( QFrame::Raised );
QHBox *labelBox = new QHBox( vbox );
labelBox-&gt;setPalette( mTBgColor );
labelBox-&gt;setMargin( 1 );
QLabel *lbl = new QLabel( mWndTitle, labelBox );
lbl-&gt;setFont( QFont( "Arial", 12, QFont::Bold ) );
lbl-&gt;setPaletteForegroundColor( mTFgColor );
QLabel *logo = new QLabel( vbox );
logo-&gt;setPalette( Qt::white );
QString px( locate( "appdata", mTheme-&gt;themeDir() +
(mLogoFile.isNull()?QString("/Logo.png"):mLogoFile) ) );
if (px.isNull())
px = locate("appdata","Themes/Default/splash_top.png");
if( !px.isNull() )
{
QPixmap pix( px );
logo-&gt;setPixmap( pix );
}
else
{
logo-&gt;setText( "&lt;B&gt;KDE&lt;/B&gt;2000" );
logo-&gt;setAlignment( AlignCenter|AlignVCenter );
}
mRotator = new RotWidget( vbox, mRotColor1, mRotColor2, mRotSpeed );
QHBox *hbox = new QHBox( vbox );
labelBox-&gt;setSpacing( 4 );
labelBox-&gt;setMargin( 4 );
mText = new QLabel( hbox );
mText-&gt;setPaletteForegroundColor( mStatusColor );
mText-&gt;setPaletteBackgroundColor( mTFgColor );
mText-&gt;setText( mWndTitle );
mText-&gt;setFixedHeight( 48 );
setFixedSize( vbox-&gt;sizeHint() );
QRect rect(TDEGlobalSettings::splashScreenDesktopGeometry());
move( rect.x() + (rect.width() - size().width())/2,
rect.y() + (rect.height() - size().height())/2 );
}
void Theme2k::readSettings()
{
if( !mTheme )
return;
TDEConfig *cfg = mTheme-&gt;themeConfig();
if( !cfg )
return;
cfg-&gt;setGroup( QString("KSplash Theme: %1").arg(mTheme-&gt;theme()) );
QColor DefaultTBgColor( Qt::darkBlue );
QColor DefaultTFgColor( Qt::white );
mTBgColor = cfg-&gt;readColorEntry( "Title Background Color",
&amp;DefaultTBgColor );
mTFgColor = cfg-&gt;readColorEntry( "Title Foreground Color",
&amp;DefaultTFgColor );
mStatusColor = cfg-&gt;readColorEntry("Status Text Color", &amp;mTBgColor );
QColor DefaultRot1( Qt::darkBlue );
QColor DefaultRot2( Qt::cyan );
mRotColor1 = cfg-&gt;readColorEntry( "Rotator Color 1", &amp;DefaultRot1 );
mRotColor2 = cfg-&gt;readColorEntry( "Rotator Color 2", &amp;DefaultRot2 );
mRotSpeed = cfg-&gt;readNumEntry( "Rotator Speed", 30 );
mWndTitle = cfg-&gt;readEntry( "Window Title", i18n("Please wait...") );
mLogoFile = cfg-&gt;readEntry( "Logo File", QString::null );
}
</programlisting>
</sect1>
<sect1 id="rotwidgeth">
<title>Файл <filename>rotwidget.h</filename></title>
<programlisting>#ifndef __ROTWIDGET_H__
#define __ROTWIDGET_H__
#include &lt;qlabel.h&gt;
#include &lt;qtimer.h&gt;
#include &lt;qwidget.h&gt;
#include &lt;kdialogbase.h&gt;
#include &lt;kpixmap.h&gt;
/**
* @short Display a rotating-gradient widget.
*/
class RotWidget: public QWidget
{
Q_OBJECT
public:
RotWidget( QWidget *, const QColor&amp;, const QColor&amp;, int );
~RotWidget();
private slots:
void stepEvent();
protected:
void preparePixmap( int );
void paintEvent( QPaintEvent * );
void resizeEvent( QResizeEvent * );
QColor m_color1, m_color2;
int m_step, m_speed;
QTimer *m_stepTimer;
QList&lt;KPixmap&gt; m_stepPixmap;
};
#endif
</programlisting>
</sect1>
<sect1 id="rotwidgetcpp">
<title>Файл <filename>rotwidget.cpp</filename></title>
<programlisting>#include &lt;kdebug.h&gt;
#include &lt;kdialogbase.h&gt;
#include &lt;kpixmapeffect.h&gt;
#include &lt;qlabel.h&gt;
#include &lt;qpainter.h&gt;
#include &lt;qwidget.h&gt;
#include "rotwidget.h"
#include "rotwidget.moc"
RotWidget::RotWidget( QWidget *parent, const QColor&amp; c1, const QColor&amp;
c2, int sp )
:QWidget(parent), m_color1(c1), m_color2(c2), m_step(0), m_speed(sp)
{
if( (m_speed &lt;= 0) || (m_speed &gt; 20) )
m_speed = 1;
setFixedHeight( 6 );
for( int i = 0; i &lt;= width(); i++ )
preparePixmap( i );
m_stepTimer = new QTimer( this );
connect(m_stepTimer, SIGNAL(timeout()), this, SLOT(stepEvent()));
m_stepTimer-&gt;start( 50 );
}
RotWidget::~RotWidget()
{
}
void RotWidget::stepEvent()
{
// This is inefficient as we create too many pixmaps, optimize later.
m_step += m_speed;
if( m_step &gt; width() )
m_step = 0;
repaint( true );
}
// Todo: Optimize drawing.
void RotWidget::paintEvent( QPaintEvent *pe )
{
QPainter p;
p.begin( this );
QRect r = pe-&gt;rect();
if( m_stepPixmap.at( m_step ) )
bitBlt( this, r.x(), r.y(), m_stepPixmap.at( m_step ), r.x(), r.y(),
r.width(), r.height() );
else
p.fillRect( rect(), Qt::black );
p.end();
}
void RotWidget::resizeEvent( QResizeEvent *re )
{
m_stepPixmap.clear();
for( int i = 0; i &lt;= re-&gt;size().width(); i++ )
preparePixmap( i );
}
void RotWidget::preparePixmap( int step )
{
if( step &lt; 0 )
return;
// Explicitly draw our first pixmap. The rest we will bitBlt() from here.
if( step == 0 )
{
KPixmap tmp; tmp.resize( size().width() / 2, size().height() );
KPixmap tmp2(tmp);
KPixmapEffect::gradient( tmp, m_color1, m_color2,
KPixmapEffect::HorizontalGradient );
KPixmapEffect::gradient( tmp2, m_color2, m_color1,
KPixmapEffect::HorizontalGradient );
KPixmap *px = new KPixmap( size() );
QPainter p;
p.begin( px );
p.drawPixmap( 0, 0, tmp );
p.drawPixmap( size().width()/2, 0, tmp2 );
p.end();
m_stepPixmap.append( px );
}
else if( m_stepPixmap.at( step-1 ) )
{
QPixmap *prev = m_stepPixmap.at( step-1 );
QPixmap next; next.resize( size() );
// convert
// prev = "[------------]"
// to
// next = "------------]["
bitBlt( &amp;next, 0, 0, prev, 1, 0, prev-&gt;width()-1, prev-&gt;height()
);
bitBlt( &amp;next, width()-1, 0, prev, 0, 0, 1, prev-&gt;height() );
KPixmap *n = new KPixmap( next );
m_stepPixmap.append( n );
}
}
</programlisting>
</sect1>
</appendix>
&documentation.index;
</book>
<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
vim:tabstop=2:shiftwidth=2:expandtab
-->