comparison DOCS/xml/ru/skin.xml @ 29263:0f1b5b68af32

whitespace cosmetics: Remove all trailing whitespace.

29262:7d545a6b8aff

<sect1 id="skin-overview">
<title>Обзор</title>

<para>
На самом деле с форматом скинов уже нет необходимости что-либо делать, но вам
следует знать, что <application>MPlayer</application> 
<emphasis role="bold">не имеет</emphasis> встроенного скина, так что 
<emphasis role="bold">как минимум один скин должен быть установлен, для 
возможности использовать GUI.</emphasis>
</para>

<!-- ********** -->

<para>Изображениями должны быть truecolor (24 или 32 бит/пиксел) PNG.</para>
<para>
В главном окне и полосе воспроизведения (смотрите ниже) можно использовать
изображения с 'прозрачностью': Области, заполненные цветом #FF00FF (magenta) полностью
прозрачны при просмотре программой <application>MPlayer</application>. Это значит, что
если ваш X сервер поддерживает расширение XShape, вы сможете получить даже 
окна произвольной формы.
</para>
</sect2>

<sect2 id="skin-overview-components">

имеющих формат фиксированный), так что зависит исключительно от вас, выйдет ли
у вас что-то грандиозное.
</para>

<para>
В данный момент могут быть оформлены четыре окна: 
<link linkend="skin-file-main">главное окно</link>, 
<link linkend="skin-file-subwindow">вспомогательное окно</link>, 
<link linkend="skin-file-main">полоса воспроизведения</link>, and the
<link linkend="skin-file-menu">меню со скинами</link> (активирующееся правым щелчком
мыши).

<itemizedlist>
<listitem>
  <para>
  <emphasis role="bold">Главное окно</emphasis> и/или 
  <emphasis role="bold">полоса воспроизведения</emphasis> - те, через которые вы
  управляете <application>MPlayer</application>. Фон окна - это изображение.
  Различные элементы могут (и должны) размещаться в окне: 
  <emphasis>кнопки</emphasis>,   <emphasis>ползунки</emphasis> и 
  <emphasis>надписи</emphasis>.
  Для каждого элемента должен быть задан размер и положение.
  </para>
  
  <para>
  <emphasis role="bold">Кнопка</emphasis> имеет три состояния (нажата, отпущена,
  отключена), таким образом, ее изображение должно быть разделено вертикально на три части. 
  Смотрите элемент <link linkend="skin-button">кнопка</link> для подробностей.
  </para>
  
  <para>
  <emphasis role="bold">Ползунок</emphasis> (в основном используется для полосы перемещения
  и управления громкостью/балансом) может иметь любое количество положений, задаваемых делением
  его изображения на различные части одна под другой. Смотрите
  <link linkend="skin-hpotmeter">hpotmeter</link> и
  <link linkend="skin-potmeter">potmeter</link> для подробностей.
  </para>
  
  <para>
  <emphasis role="bold">Надписи</emphasis> чуть особеннее: Символы, необходимые для их
  отрисовки, берутся из графического файла, и задаются
  <link linkend="skin-fonts">файлом описания шрифта</link>.
  Последний - это текстовый файл, указывающий x,y положения и размер каждого символа 
  в файле с изображением (файл изображения и файл описания шрифта 
  <emphasis>вместе</emphasis> формируют шрифт). Смотрите 
  <link linkend="skin-dlabel">dlabel</link>
  и <link linkend="skin-slabel">slabel</link> для подробностей.
  </para>

  <note><para>Все изображения могут быть полностью прозрачными, как описано в разделе, 
  посвященном <link linkend="skin-overview-formats">форматам изображений</link>. Если X 
  сервер не поддерживает расширение XShape, части, помеченные как прозрачные, будут черными.
  Если вам нравится использовать эту возможность, ширина фона главного окна должна 
  делиться на 8.
  </para></note>
</listitem>

<listitem><para>
  <emphasis role="bold">Вспомогательное окно</emphasis>  - это то, где появляется фильм. 
  Оно может отображать указанную картинку, если  никакого фильма не загружено (пустое окно 
  немного надоедает :-)) <emphasis role="bold">Замечание:</emphasis> прозрачность здесь
  <emphasis role="bold">не допускается</emphasis>.
</para></listitem>

<listitem>
  <para>
  <emphasis role="bold">Меню со скинами</emphasis> - всего лишь способ управлять 
  <application>MPlayer</application> в понятиях элементов меню. Для меню требуются 
  два изображения: одно из них - основное, показывает меню в обычном режиме,
  другое используется для отображения выбранных элементов. Когда появляется меню, 
  отображается первое. Если вы перемещаете мышь над элементами меню,
  выбранный элемент копируется из второго изображения поверх элемента меню под указателем мыши
  (второе изображение никогда не отображается целиком).
  </para>
  <para>

</itemizedlist>
</para>

<para>
Важная вещь, не упомянутая выше: Чтобы работали кнопки, ползунки и элементы меню,
<application>MPlayer</application> должен знать, что делать, если на них 
щелкнули мышью. Это делается при помощи <link linkend="skin-gui">сообщений</link>
(событий). Для этих элементов вы должны определить сообщения, генерируемые, когда
на них щелкают мышью.
</para>
</sect2>

</para></listitem>
<listitem><para>
  Фоновое изображение главного окна.
</para></listitem>
<listitem><para>
  Изображения элементов главного окна (включая один или более файлов описания шрифтов, 
  необходимых для отрисовки надписей.
</para></listitem>
<listitem><para>
  Изображение, показываемое во вспомогательном окне (необязательно).
</para></listitem>
<listitem><para>
  Два изображения для меню со скинами (нужны, только если вы хотите создавать меню).
</para></listitem>
</itemizedlist>
  Все файлы, за исключением skin, могут быть названы так, как вам захочется
  (но заметьте, что файлы описания шрифтов должны иметь расширение 
  a <filename>.fnt</filename>).
</para>
</sect2>
</sect1>

<sect1 id="skin-file">
<title>Файл skin</title>
<para>
Как описано выше, это файл конфигурации скина. он строчно-орентирован:
строки комментариев начинаются с символа '<literal>;</literal>' в начале 
строки (только пробелы и табуляция допускается перед символом '<literal>;</literal>').
</para>

<para>
Файл создается из разделов. Каждый описывает скин для приложения и 
имеет следующую форму:
<programlisting>
section = <replaceable>название раздела</replaceable>
.
.

end
</programlisting>
</para>

<para>
В данный момент приложение одно, так что вам потребуется только один раздел: его название 
<emphasis role="bold">movieplayer</emphasis>.
</para>

<para>
В пределах раздела каждое окно описывается блоком следующей структуры:

end
</programlisting>
</para>

<para>
Название файла с изображением  должно указываться без лидирующих каталогов - 
изображения ищутся в каталоге <filename class="directory">skins</filename>.
Вы можете (но не обязаны) указать расширение файла. Если файл не существует,
<application>MPlayer</application> пытается загрузить файл
<filename>&lt;filename&gt;.&lt;ext&gt;</filename>, где <literal>png</literal>
и <literal>PNG</literal> пробуются вместо <filename>&lt;ext&gt;</filename>

  <term><literal>
  <anchor id="skin-main-base"/>base = image, X, Y
  </literal></term>
  <listitem>
  <para>
  Позволяет вам указать фоновое изображение, используемое в главном окне.  
  Окно будет появляться в указанной <literal>X,Y</literal> позиции на экране и
  иметь размер изображения.
  </para>
  <note><para>
  Эти координаты пока не работают для окна отображения.

  <anchor id="skin-button"/>button = image, X, Y, width, height, message
  </literal></term>
  <listitem>
  <para>
  Размещает кнопку размера <literal>width</literal> * <literal>height</literal> на
  позиции <literal>X,Y</literal>. Указанное сообщение <literal>message</literal> 
  генерируется при щелчке на кнопку. Изображение <literal>image</literal>,
  должно иметь три части одна ниже другой (в соответствии с возможными состояниями
  кнопки), как здесь:
  </para>
  <informalfigure>

  <term><literal>
  <anchor id="skin-decoration"/>decoration = enable|disable
  </literal></term>
  <listitem>
  <para>
  Включает или выключает декорации главного окна, осуществляемые window manager . По-умолчанию 
  <emphasis role="bold">disable</emphasis>.
  </para>
  <note><para>
  Это не работает для окна отображения, в этом нет надобности.
  </para></note>

  <term><literal>
  <anchor id="skin-vpotmeter"/>vpotmeter = button, bwidth, bheight, phases, numphases, default, X, Y, width, height, message
  </literal></term>
  <listitem><para>
  Размещает горизонтальный (hpotmeter) или вертикальный (vpotmeter) ползунок размера
  <literal>width</literal> * <literal>height</literal> на позиции 
  <literal>X,Y</literal>. Изображение может быть разделено на разные части для
  указания различных положений ползунка (например, вы можете иметь регулятор для 
  управления громкостью звука, изменяющийся с красного на зеленый при изменении его
  уровня с минимального на максимальный.). <literal>hpotmeter</literal> может иметь
  кнопку, которую можно таскать горизонтально. Параметры:
  <itemizedlist>
  <listitem><para>
    <literal>button</literal> - изображение, используемое для 
    кнопки (должно иметь три части одна под другой, как в случае 
    <link linkend="skin-button">кнопки</link>)
  </para></listitem>
  <listitem><para>
    <literal>bwidth</literal>, <literal>bheight</literal> - размер кнопки
  </para></listitem>
  <listitem><para>
    <literal>phases</literal> - изображение, используемое для 
    различных положений hpotmeter. Специальное значение <literal>NULL</literal>
    может использоваться, если подобное изображение вам не нужно. Изображение
    должно быть разделено вертикально на 
    <literal>numphases</literal> частей, как указано ниже:
    <informalfigure><screen>
+--------------+
| положение #1 |
+--------------+

<varlistentry>
  <term><literal>
  <anchor id="skin-potmeter"/>potmeter = phases, numphases, default, X, Y, width, height, message
  </literal></term>
  <listitem><para>
  <literal>hpotmeter</literal> без кнопки. 
  (Я предполагаю, что это означает повернутый вокруг,
  но он реагирует только на перетаскивание по горизонтали.) Для описания параметров смотрите 
  <link linkend="skin-hpotmeter">hpotmeter</link>.
  <literal>phases</literal> может быть равен <literal>NULL</literal>, но это совершенно 
  бесполезно, поскольку вы не сможете определить в каком положении 
  находится <literal>potmeter</literal>.
  </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-font"/>font = fontfile, fontid
  </literal></term>
  <listitem><para>
  Определяет шрифт. <literal>fontfile</literal> - это название файла описания шрифта 
  с расширением <filename>.fnt</filename> (не указывайте расширение здесь).
  <literal>fontid</literal> используется для ссылки на шрифт 
  (смотрите <link linkend="skin-dlabel">dlabel</link> и 
  <link linkend="skin-slabel">slabel</link>). Может быть определено до 25 шрифтов.
  </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-slabel"/>slabel = X, Y, fontid, "text"
  </literal></term>
  <listitem><para>
  Размещает  статическую метку на позиции <literal>X,Y</literal>. <literal>text</literal>
  отображается, используя шрифт, определенный по <literal>fontid</literal>. 
  Текст - просто обычная строка (<literal>$x</literal> переменные не работают), которая должна
  быть заключена в двойные кавычки (но символ " не может быть частью текста). 
  Метка отображается, используя шрифт определенный по <literal>fontid</literal>.
  </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-dlabel"/>dlabel = X, Y, length, align, fontid, "text"
  </literal></term>
  <listitem>
  <para>
  Размещает динамическую метку на позиции <literal>X,Y</literal>. Метка зовется 
  динамической, потому что ее текст периодически обновляется. Максимальная длина 
  метки задается параметром <literal>length</literal> (ее высота равна высоте символа).
  Если отображаемый текст шире этого значения, он будет скроллироваться,
  иначе он выравнивается в пределах указанного пространства в соответствии со
  значением параметра 
  <literal>align</literal>: <literal>0</literal> - вправо,
  <literal>1</literal> - по центру, <literal>2</literal> - влево.
  </para>
  <para>
  Отображаемый текст задается параметром <literal>text</literal>: Он должен быть
  заключен в двойные кавычки (но символ " не может быть частью текста).
  Метка отображается, используя шрифт, определяемый по <literal>fontid</literal>. 
  Вы можете использовать следующие переменные в тексте:
  </para>

  <informaltable>
  <tgroup cols="2">

  </row>
  <row>
    <entry>$T</entry>
    <entry>
    символ, соответствующий типу потока (файл: <literal>f</literal>,
    Video CD: <literal>v</literal>, DVD: <literal>d</literal>, 
    URL: <literal>u</literal>)
    </entry>
  </row>
  <row>
    <entry>$p</entry>
    <entry>
    символ <keycap>p</keycap> (если фильм воспроизводится и шрифт имеет 
    символ <keycap>p</keycap>)
    </entry>
  </row>
  <row>
    <entry>$s</entry>
    <entry>
    символ <keycap>s</keycap> (если фильм остановлен и шрифт имеет 
    символ <keycap>s</keycap>)
    </entry>
  </row>
  <row>
    <entry>$e</entry>
    <entry>
    символ <keycap>e</keycap> (если фильм на паузе и шрифт имеет 
    символ <keycap>e</keycap>)
    </entry>
  </row>
  <row>
    <entry>$x</entry>

  </informaltable>

  <note><para>
  Переменные <literal>$a, $T, $p, $s</literal> и <literal>$e</literal> все
  возвращают символы, которые должны быть отображены в качестве специальных значков
  (например, <keycap>e</keycap> - для значка паузы, который обычно выглядит как ||). 
  Вы должны иметь шрифт для обычных символов и отличающийся шрифт для значков.
  Смотрите раздел о <link linkend="skin-fonts-symbols">значках</link>
  для дополнительной информации.
  </para></note>
  </listitem>

<varlistentry>
  <term><literal>
  <anchor id="skin-sub-base"/>base = image, X, Y, width, height
  </literal></term>
  <listitem><para>
  Изображение, отображаемое в окне. Окно будет появляться в указанной позиции 
  <literal>X,Y</literal> экрана (<literal>0,0</literal> - верхний левый угол). 
  Вы можете указать <literal>-1</literal> для центра и <literal>-2</literal>
  для правого (<literal>X</literal>) и нижнего (<literal>Y</literal>) края. 
  Окно будет того же размера, что и изображение. <literal>width</literal> и 
  <literal>height</literal> означают размер окна; они необязательны
  (если отсутствуют, окно будет иметь те же размеры, что и изображение).
  </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-background"/>background = R, G, B
  </literal></term>
  <listitem><para>
  Позволяет указать цвет фона. Это полезно, если изображение меньше окна. 
  <literal>R</literal>, <literal>G</literal> и <literal>B</literal>
  указывают красную, зеленую и синюю составляющие цвета (каждое из них -
  десятичное число от 0 до 255).
  </para></listitem>
</varlistentry>

указанного элементом <literal>selected</literal>. Вы должны определить позицию и
размер каждого элемента меню.
</para>

<para>
Следующие элементы можно использовать в блоке 
'<literal>window = menu</literal>'. . .'<literal>end</literal>'.
</para>

<variablelist>
<varlistentry>

  <term><literal>
  <anchor id="skin-menu"/>menu = X, Y, width, height, message
  </literal></term>
  <listitem><para>
  Определяет позицию <literal>X,Y</literal> и размер элемента меню в изображении.
  <literal>message</literal> - это сообщение, генерируемое, когда кнопка мыши будет отпущена 
  над элементом меню.
  </para></listitem>
</varlistentry>
</variablelist>
</sect2>

<para>
Файл описания шрифта (с расширением <filename>.fnt</filename>) может иметь комментарии,
начинающиеся с '<literal>;</literal>'. Файл должен иметь строку вида
<anchor id="skin-font-image"/>
<programlisting>image = <replaceable>image</replaceable></programlisting>,
где <literal><replaceable>image</replaceable></literal> - это название 
файла с изображением, используемым для шрифта (расширение указывать необязательно).
<anchor id="skin-font-char"/>
<programlisting>"char" = X, Y, width, height</programlisting>
Здесь <literal>X</literal> и <literal>Y</literal> указывают позицию символа 
<literal>char</literal> в изображении (<literal>0,0</literal> - верхний левый угол),
<literal>width</literal> и <literal>height</literal> - размеры символа в пикселах.
</para>

<para>

  <listitem><para>
  Вместе с <literal>evPlaySwitchToPause</literal> формирует переключатель паузы.
  Может быть использовано для общей кнопки воспроизведение/пауза. Оба сообщения
  должны быть назначены кнопкам, находящимся практически в одной точке окна.
  Это сообщение ставит воспроизведение на паузу и показывает изображение кнопки с
  назначенным сообщением <literal>evPlaySwitchToPause</literal> 
  (чтобы показать, что кнопка может быть нажата для продолжения воспроизведения).
  </para></listitem>
</varlistentry>

<varlistentry>

</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evPlaySwitchToPause</emphasis></term>
  <listitem><para>
  Противоположность <literal>evPauseSwitchToPlay</literal>. Это сообщение 
  запускает воспроизведение и показывает изображение кнопки с
  назначенным сообщением <literal>evPauseSwitchToPlay</literal>
  (чтобы показать, что кнопка может быть нажата для включения паузы).
  </para></listitem>
</varlistentry>

</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evSetMoviePosition</emphasis></term>
  <listitem><para>
  Перемещается к позиции (может использоваться ползунком; 
  используется относительное (0-100%) положение ползунка).
  </para></listitem>
</varlistentry>
</variablelist>

</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evLoadPlay</emphasis></term>
  <listitem><para>
  Делает то же, что и <literal>evLoad</literal>, но запускает вопроизведение файла 
  автоматически после его загрузки.
  </para></listitem>
</varlistentry>

<varlistentry>

<para>
Итак, вы прочитали о создании скина для
<application>MPlayer</application> GUI, прекрасно нарисовали все в
<application>Gimp</application> и желаете отправить скин нам?
Прочтите некоторые руководства для избежания основных ошибок и 
создания высококачественного скина.
</para>

<para>
Мы хотим, чтобы скины, добавляемые нами в репозиторий, удовлетворяли 
некоторым стандартам качества. Есть также несколько вещей,
сделающих вашу жизнь проще.
</para>

<para>

начиная с версии 1.5, он удовлетворяет всем критериям, указанным ниже.
</para>

<itemizedlist>
  <listitem><para>
  Каждый скин должна идти с файлом 
  <filename>README</filename>, содержащим информацию о вас, авторе,
  правах на копирование, лицензионным уведомлением и всем другим,
  что вам захочется добавить. Если хотите иметь историю изменений, то 
  этот файл - хорошее место для нее.
  </para></listitem>

  <listitem><para>
  Должен быть файл <filename>VERSION</filename>,
  содержащий только номер версии скина в одной строке
  (например 1.0).
  </para></listitem>

  <listitem><para>
  Горизонтальные и вертикальные элементы управления 
  (такие как ползунки громкости или положения) должны иметь
  кнопку-ползунок точно отцентрированную по центру самого ползунка. 
  Должно быть возможно двигать кнопку к обоим концам ползунка,
  но не выходить за них.
  </para></listitem>

  <listitem><para>

29263:0f1b5b68af32

<sect1 id="skin-overview">
<title>Обзор</title>

<para>
На самом деле с форматом скинов уже нет необходимости что-либо делать, но вам
следует знать, что <application>MPlayer</application>
<emphasis role="bold">не имеет</emphasis> встроенного скина, так что
<emphasis role="bold">как минимум один скин должен быть установлен, для
возможности использовать GUI.</emphasis>
</para>

<!-- ********** -->

<para>Изображениями должны быть truecolor (24 или 32 бит/пиксел) PNG.</para>
<para>
В главном окне и полосе воспроизведения (смотрите ниже) можно использовать
изображения с 'прозрачностью': Области, заполненные цветом #FF00FF (magenta) полностью
прозрачны при просмотре программой <application>MPlayer</application>. Это значит, что
если ваш X сервер поддерживает расширение XShape, вы сможете получить даже
окна произвольной формы.
</para>
</sect2>

<sect2 id="skin-overview-components">

имеющих формат фиксированный), так что зависит исключительно от вас, выйдет ли
у вас что-то грандиозное.
</para>

<para>
В данный момент могут быть оформлены четыре окна:
<link linkend="skin-file-main">главное окно</link>,
<link linkend="skin-file-subwindow">вспомогательное окно</link>,
<link linkend="skin-file-main">полоса воспроизведения</link>, and the
<link linkend="skin-file-menu">меню со скинами</link> (активирующееся правым щелчком
мыши).

<itemizedlist>
<listitem>
  <para>
  <emphasis role="bold">Главное окно</emphasis> и/или
  <emphasis role="bold">полоса воспроизведения</emphasis> - те, через которые вы
  управляете <application>MPlayer</application>. Фон окна - это изображение.
  Различные элементы могут (и должны) размещаться в окне:
  <emphasis>кнопки</emphasis>,   <emphasis>ползунки</emphasis> и
  <emphasis>надписи</emphasis>.
  Для каждого элемента должен быть задан размер и положение.
  </para>

  <para>
  <emphasis role="bold">Кнопка</emphasis> имеет три состояния (нажата, отпущена,
  отключена), таким образом, ее изображение должно быть разделено вертикально на три части.
  Смотрите элемент <link linkend="skin-button">кнопка</link> для подробностей.
  </para>

  <para>
  <emphasis role="bold">Ползунок</emphasis> (в основном используется для полосы перемещения
  и управления громкостью/балансом) может иметь любое количество положений, задаваемых делением
  его изображения на различные части одна под другой. Смотрите
  <link linkend="skin-hpotmeter">hpotmeter</link> и
  <link linkend="skin-potmeter">potmeter</link> для подробностей.
  </para>

  <para>
  <emphasis role="bold">Надписи</emphasis> чуть особеннее: Символы, необходимые для их
  отрисовки, берутся из графического файла, и задаются
  <link linkend="skin-fonts">файлом описания шрифта</link>.
  Последний - это текстовый файл, указывающий x,y положения и размер каждого символа
  в файле с изображением (файл изображения и файл описания шрифта
  <emphasis>вместе</emphasis> формируют шрифт). Смотрите
  <link linkend="skin-dlabel">dlabel</link>
  и <link linkend="skin-slabel">slabel</link> для подробностей.
  </para>

  <note><para>Все изображения могут быть полностью прозрачными, как описано в разделе,
  посвященном <link linkend="skin-overview-formats">форматам изображений</link>. Если X
  сервер не поддерживает расширение XShape, части, помеченные как прозрачные, будут черными.
  Если вам нравится использовать эту возможность, ширина фона главного окна должна
  делиться на 8.
  </para></note>
</listitem>

<listitem><para>
  <emphasis role="bold">Вспомогательное окно</emphasis>  - это то, где появляется фильм.
  Оно может отображать указанную картинку, если  никакого фильма не загружено (пустое окно
  немного надоедает :-)) <emphasis role="bold">Замечание:</emphasis> прозрачность здесь
  <emphasis role="bold">не допускается</emphasis>.
</para></listitem>

<listitem>
  <para>
  <emphasis role="bold">Меню со скинами</emphasis> - всего лишь способ управлять
  <application>MPlayer</application> в понятиях элементов меню. Для меню требуются
  два изображения: одно из них - основное, показывает меню в обычном режиме,
  другое используется для отображения выбранных элементов. Когда появляется меню,
  отображается первое. Если вы перемещаете мышь над элементами меню,
  выбранный элемент копируется из второго изображения поверх элемента меню под указателем мыши
  (второе изображение никогда не отображается целиком).
  </para>
  <para>

</itemizedlist>
</para>

<para>
Важная вещь, не упомянутая выше: Чтобы работали кнопки, ползунки и элементы меню,
<application>MPlayer</application> должен знать, что делать, если на них
щелкнули мышью. Это делается при помощи <link linkend="skin-gui">сообщений</link>
(событий). Для этих элементов вы должны определить сообщения, генерируемые, когда
на них щелкают мышью.
</para>
</sect2>

</para></listitem>
<listitem><para>
  Фоновое изображение главного окна.
</para></listitem>
<listitem><para>
  Изображения элементов главного окна (включая один или более файлов описания шрифтов,
  необходимых для отрисовки надписей.
</para></listitem>
<listitem><para>
  Изображение, показываемое во вспомогательном окне (необязательно).
</para></listitem>
<listitem><para>
  Два изображения для меню со скинами (нужны, только если вы хотите создавать меню).
</para></listitem>
</itemizedlist>
  Все файлы, за исключением skin, могут быть названы так, как вам захочется
  (но заметьте, что файлы описания шрифтов должны иметь расширение
  a <filename>.fnt</filename>).
</para>
</sect2>
</sect1>

<sect1 id="skin-file">
<title>Файл skin</title>
<para>
Как описано выше, это файл конфигурации скина. он строчно-орентирован:
строки комментариев начинаются с символа '<literal>;</literal>' в начале
строки (только пробелы и табуляция допускается перед символом '<literal>;</literal>').
</para>

<para>
Файл создается из разделов. Каждый описывает скин для приложения и
имеет следующую форму:
<programlisting>
section = <replaceable>название раздела</replaceable>
.
.

end
</programlisting>
</para>

<para>
В данный момент приложение одно, так что вам потребуется только один раздел: его название
<emphasis role="bold">movieplayer</emphasis>.
</para>

<para>
В пределах раздела каждое окно описывается блоком следующей структуры:

end
</programlisting>
</para>

<para>
Название файла с изображением  должно указываться без лидирующих каталогов -
изображения ищутся в каталоге <filename class="directory">skins</filename>.
Вы можете (но не обязаны) указать расширение файла. Если файл не существует,
<application>MPlayer</application> пытается загрузить файл
<filename>&lt;filename&gt;.&lt;ext&gt;</filename>, где <literal>png</literal>
и <literal>PNG</literal> пробуются вместо <filename>&lt;ext&gt;</filename>

  <term><literal>
  <anchor id="skin-main-base"/>base = image, X, Y
  </literal></term>
  <listitem>
  <para>
  Позволяет вам указать фоновое изображение, используемое в главном окне.
  Окно будет появляться в указанной <literal>X,Y</literal> позиции на экране и
  иметь размер изображения.
  </para>
  <note><para>
  Эти координаты пока не работают для окна отображения.

  <anchor id="skin-button"/>button = image, X, Y, width, height, message
  </literal></term>
  <listitem>
  <para>
  Размещает кнопку размера <literal>width</literal> * <literal>height</literal> на
  позиции <literal>X,Y</literal>. Указанное сообщение <literal>message</literal>
  генерируется при щелчке на кнопку. Изображение <literal>image</literal>,
  должно иметь три части одна ниже другой (в соответствии с возможными состояниями
  кнопки), как здесь:
  </para>
  <informalfigure>

  <term><literal>
  <anchor id="skin-decoration"/>decoration = enable|disable
  </literal></term>
  <listitem>
  <para>
  Включает или выключает декорации главного окна, осуществляемые window manager . По-умолчанию
  <emphasis role="bold">disable</emphasis>.
  </para>
  <note><para>
  Это не работает для окна отображения, в этом нет надобности.
  </para></note>

  <term><literal>
  <anchor id="skin-vpotmeter"/>vpotmeter = button, bwidth, bheight, phases, numphases, default, X, Y, width, height, message
  </literal></term>
  <listitem><para>
  Размещает горизонтальный (hpotmeter) или вертикальный (vpotmeter) ползунок размера
  <literal>width</literal> * <literal>height</literal> на позиции
  <literal>X,Y</literal>. Изображение может быть разделено на разные части для
  указания различных положений ползунка (например, вы можете иметь регулятор для
  управления громкостью звука, изменяющийся с красного на зеленый при изменении его
  уровня с минимального на максимальный.). <literal>hpotmeter</literal> может иметь
  кнопку, которую можно таскать горизонтально. Параметры:
  <itemizedlist>
  <listitem><para>
    <literal>button</literal> - изображение, используемое для
    кнопки (должно иметь три части одна под другой, как в случае
    <link linkend="skin-button">кнопки</link>)
  </para></listitem>
  <listitem><para>
    <literal>bwidth</literal>, <literal>bheight</literal> - размер кнопки
  </para></listitem>
  <listitem><para>
    <literal>phases</literal> - изображение, используемое для
    различных положений hpotmeter. Специальное значение <literal>NULL</literal>
    может использоваться, если подобное изображение вам не нужно. Изображение
    должно быть разделено вертикально на
    <literal>numphases</literal> частей, как указано ниже:
    <informalfigure><screen>
+--------------+
| положение #1 |
+--------------+

<varlistentry>
  <term><literal>
  <anchor id="skin-potmeter"/>potmeter = phases, numphases, default, X, Y, width, height, message
  </literal></term>
  <listitem><para>
  <literal>hpotmeter</literal> без кнопки.
  (Я предполагаю, что это означает повернутый вокруг,
  но он реагирует только на перетаскивание по горизонтали.) Для описания параметров смотрите
  <link linkend="skin-hpotmeter">hpotmeter</link>.
  <literal>phases</literal> может быть равен <literal>NULL</literal>, но это совершенно
  бесполезно, поскольку вы не сможете определить в каком положении
  находится <literal>potmeter</literal>.
  </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-font"/>font = fontfile, fontid
  </literal></term>
  <listitem><para>
  Определяет шрифт. <literal>fontfile</literal> - это название файла описания шрифта
  с расширением <filename>.fnt</filename> (не указывайте расширение здесь).
  <literal>fontid</literal> используется для ссылки на шрифт
  (смотрите <link linkend="skin-dlabel">dlabel</link> и
  <link linkend="skin-slabel">slabel</link>). Может быть определено до 25 шрифтов.
  </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-slabel"/>slabel = X, Y, fontid, "text"
  </literal></term>
  <listitem><para>
  Размещает  статическую метку на позиции <literal>X,Y</literal>. <literal>text</literal>
  отображается, используя шрифт, определенный по <literal>fontid</literal>.
  Текст - просто обычная строка (<literal>$x</literal> переменные не работают), которая должна
  быть заключена в двойные кавычки (но символ " не может быть частью текста).
  Метка отображается, используя шрифт определенный по <literal>fontid</literal>.
  </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-dlabel"/>dlabel = X, Y, length, align, fontid, "text"
  </literal></term>
  <listitem>
  <para>
  Размещает динамическую метку на позиции <literal>X,Y</literal>. Метка зовется
  динамической, потому что ее текст периодически обновляется. Максимальная длина
  метки задается параметром <literal>length</literal> (ее высота равна высоте символа).
  Если отображаемый текст шире этого значения, он будет скроллироваться,
  иначе он выравнивается в пределах указанного пространства в соответствии со
  значением параметра
  <literal>align</literal>: <literal>0</literal> - вправо,
  <literal>1</literal> - по центру, <literal>2</literal> - влево.
  </para>
  <para>
  Отображаемый текст задается параметром <literal>text</literal>: Он должен быть
  заключен в двойные кавычки (но символ " не может быть частью текста).
  Метка отображается, используя шрифт, определяемый по <literal>fontid</literal>.
  Вы можете использовать следующие переменные в тексте:
  </para>

  <informaltable>
  <tgroup cols="2">

  </row>
  <row>
    <entry>$T</entry>
    <entry>
    символ, соответствующий типу потока (файл: <literal>f</literal>,
    Video CD: <literal>v</literal>, DVD: <literal>d</literal>,
    URL: <literal>u</literal>)
    </entry>
  </row>
  <row>
    <entry>$p</entry>
    <entry>
    символ <keycap>p</keycap> (если фильм воспроизводится и шрифт имеет
    символ <keycap>p</keycap>)
    </entry>
  </row>
  <row>
    <entry>$s</entry>
    <entry>
    символ <keycap>s</keycap> (если фильм остановлен и шрифт имеет
    символ <keycap>s</keycap>)
    </entry>
  </row>
  <row>
    <entry>$e</entry>
    <entry>
    символ <keycap>e</keycap> (если фильм на паузе и шрифт имеет
    символ <keycap>e</keycap>)
    </entry>
  </row>
  <row>
    <entry>$x</entry>

  </informaltable>

  <note><para>
  Переменные <literal>$a, $T, $p, $s</literal> и <literal>$e</literal> все
  возвращают символы, которые должны быть отображены в качестве специальных значков
  (например, <keycap>e</keycap> - для значка паузы, который обычно выглядит как ||).
  Вы должны иметь шрифт для обычных символов и отличающийся шрифт для значков.
  Смотрите раздел о <link linkend="skin-fonts-symbols">значках</link>
  для дополнительной информации.
  </para></note>
  </listitem>

<varlistentry>
  <term><literal>
  <anchor id="skin-sub-base"/>base = image, X, Y, width, height
  </literal></term>
  <listitem><para>
  Изображение, отображаемое в окне. Окно будет появляться в указанной позиции
  <literal>X,Y</literal> экрана (<literal>0,0</literal> - верхний левый угол).
  Вы можете указать <literal>-1</literal> для центра и <literal>-2</literal>
  для правого (<literal>X</literal>) и нижнего (<literal>Y</literal>) края.
  Окно будет того же размера, что и изображение. <literal>width</literal> и
  <literal>height</literal> означают размер окна; они необязательны
  (если отсутствуют, окно будет иметь те же размеры, что и изображение).
  </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-background"/>background = R, G, B
  </literal></term>
  <listitem><para>
  Позволяет указать цвет фона. Это полезно, если изображение меньше окна.
  <literal>R</literal>, <literal>G</literal> и <literal>B</literal>
  указывают красную, зеленую и синюю составляющие цвета (каждое из них -
  десятичное число от 0 до 255).
  </para></listitem>
</varlistentry>

указанного элементом <literal>selected</literal>. Вы должны определить позицию и
размер каждого элемента меню.
</para>

<para>
Следующие элементы можно использовать в блоке
'<literal>window = menu</literal>'. . .'<literal>end</literal>'.
</para>

<variablelist>
<varlistentry>

  <term><literal>
  <anchor id="skin-menu"/>menu = X, Y, width, height, message
  </literal></term>
  <listitem><para>
  Определяет позицию <literal>X,Y</literal> и размер элемента меню в изображении.
  <literal>message</literal> - это сообщение, генерируемое, когда кнопка мыши будет отпущена
  над элементом меню.
  </para></listitem>
</varlistentry>
</variablelist>
</sect2>

<para>
Файл описания шрифта (с расширением <filename>.fnt</filename>) может иметь комментарии,
начинающиеся с '<literal>;</literal>'. Файл должен иметь строку вида
<anchor id="skin-font-image"/>
<programlisting>image = <replaceable>image</replaceable></programlisting>,
где <literal><replaceable>image</replaceable></literal> - это название
файла с изображением, используемым для шрифта (расширение указывать необязательно).
<anchor id="skin-font-char"/>
<programlisting>"char" = X, Y, width, height</programlisting>
Здесь <literal>X</literal> и <literal>Y</literal> указывают позицию символа
<literal>char</literal> в изображении (<literal>0,0</literal> - верхний левый угол),
<literal>width</literal> и <literal>height</literal> - размеры символа в пикселах.
</para>

<para>

  <listitem><para>
  Вместе с <literal>evPlaySwitchToPause</literal> формирует переключатель паузы.
  Может быть использовано для общей кнопки воспроизведение/пауза. Оба сообщения
  должны быть назначены кнопкам, находящимся практически в одной точке окна.
  Это сообщение ставит воспроизведение на паузу и показывает изображение кнопки с
  назначенным сообщением <literal>evPlaySwitchToPause</literal>
  (чтобы показать, что кнопка может быть нажата для продолжения воспроизведения).
  </para></listitem>
</varlistentry>

<varlistentry>

</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evPlaySwitchToPause</emphasis></term>
  <listitem><para>
  Противоположность <literal>evPauseSwitchToPlay</literal>. Это сообщение
  запускает воспроизведение и показывает изображение кнопки с
  назначенным сообщением <literal>evPauseSwitchToPlay</literal>
  (чтобы показать, что кнопка может быть нажата для включения паузы).
  </para></listitem>
</varlistentry>

</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evSetMoviePosition</emphasis></term>
  <listitem><para>
  Перемещается к позиции (может использоваться ползунком;
  используется относительное (0-100%) положение ползунка).
  </para></listitem>
</varlistentry>
</variablelist>

</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evLoadPlay</emphasis></term>
  <listitem><para>
  Делает то же, что и <literal>evLoad</literal>, но запускает вопроизведение файла
  автоматически после его загрузки.
  </para></listitem>
</varlistentry>

<varlistentry>

<para>
Итак, вы прочитали о создании скина для
<application>MPlayer</application> GUI, прекрасно нарисовали все в
<application>Gimp</application> и желаете отправить скин нам?
Прочтите некоторые руководства для избежания основных ошибок и
создания высококачественного скина.
</para>

<para>
Мы хотим, чтобы скины, добавляемые нами в репозиторий, удовлетворяли
некоторым стандартам качества. Есть также несколько вещей,
сделающих вашу жизнь проще.
</para>

<para>

начиная с версии 1.5, он удовлетворяет всем критериям, указанным ниже.
</para>

<itemizedlist>
  <listitem><para>
  Каждый скин должна идти с файлом
  <filename>README</filename>, содержащим информацию о вас, авторе,
  правах на копирование, лицензионным уведомлением и всем другим,
  что вам захочется добавить. Если хотите иметь историю изменений, то
  этот файл - хорошее место для нее.
  </para></listitem>

  <listitem><para>
  Должен быть файл <filename>VERSION</filename>,
  содержащий только номер версии скина в одной строке
  (например 1.0).
  </para></listitem>

  <listitem><para>
  Горизонтальные и вертикальные элементы управления
  (такие как ползунки громкости или положения) должны иметь
  кнопку-ползунок точно отцентрированную по центру самого ползунка.
  Должно быть возможно двигать кнопку к обоим концам ползунка,
  но не выходить за них.
  </para></listitem>

  <listitem><para>