<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN"
 "dtd/kdex.dtd" [
  <!ENTITY kappname "&aktion;">
  <!ENTITY package "kdemultimedia">
  <!ENTITY % Russian "INCLUDE" 
> <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">
]>

<book lang="&language;">

<bookinfo>
<title
>Справочное руководство по &aktion;</title>

<authorgroup>
<author
> <firstname
>Chris</firstname
> <othername
>D.</othername
> <surname
>Corbettis</surname
> <affiliation
> <address
><email
>chris@corbettis.fsnet.co.uk</email
></address
> </affiliation
> </author>

<othercredit role="developer">
<firstname
>Guillermo</firstname>
<othername
>P.</othername>
<surname
>Marotte</surname>
<affiliation
><address
><email
>g-marotte@usa.net</email
></address>
</affiliation>
<contrib
>Разработчик</contrib>
</othercredit>

<othercredit role="reviewer">
<firstname
>Lauri</firstname>
<surname
>Watts</surname>
<affiliation>
<address
><email
>lauri@kde.org</email
></address>
</affiliation>
<contrib
>Редактор</contrib>
</othercredit>

<othercredit role="translator"
><firstname
>Григорий</firstname
><surname
>Мохин</surname
><affiliation
><address
><email
>mok@kde.ru</email
></address
></affiliation
><contrib
>Перевод на русский</contrib
></othercredit>
</authorgroup>

<copyright>
<year
>2000</year>
<holder
>Chris D. Corbettis</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-02-04</date>
<releaseinfo
>1.99.00</releaseinfo>

<abstract>
<para
>&aktion; - это видеоплеер</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>aKtion</keyword>
<keyword
>kdemultimedia</keyword>
<keyword
>mpeg</keyword>
<keyword
>avi</keyword>
<keyword
>QuickTime</keyword>
<keyword
>gif</keyword>
<keyword
>xanim</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Введение</title>

<para
>&aktion; - это видеоплеер, служащий оболочкой для <application
>Xanim</application
>. Он поддерживает многочисленные распространенные в Интернет, видеокодеки, включая mpeg1, QuickTime и анимированный gif. Сообщайте о всех ошибках или пожеланиях в списки рассылки &kde;.</para>

</chapter>

<chapter id="using-aktion">
<title
>Использование &aktion;</title>

<screenshot
> <screeninfo
>Вот снимок работы &aktion;</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="aktion.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Снимок</phrase
> </textobject
> </mediaobject
> </screenshot>

<para
>Использовать &aktion; очень просто. Нажмите правую кнопку мыши в пределах окна, или кнопку <guiicon
>"открыть"</guiicon
> в панели инструментов, выберите видеофайл, который вы хотите посмотреть, и нажмите <guibutton
>OK</guibutton
>.</para>

<sect1 id="context-menu">
<title
>Контекстное меню</title>

<para
>Контекстное меню выпадает при нажатии <mousebutton
>правой</mousebutton
> кнопкой мыши в окне воспроизведения. Через него вы можете быстро изменить размер воспроизведения, открыть видеофайл или диалог сведений о видеофайле.</para
> 

<para
>Контекстное меню описано далее в разделе <xref linkend="video-context-menu"/>.</para>

</sect1>

<sect1 id="aktion-fullscreen">
<title
>Полноэкранный режим &aktion;</title>

<para
>Переход к воспроизведению на полном экране возможен при нажатии <mousebutton
>правой</mousebutton
> кнопки мыши в любом месте окна &aktion;. Выберите пункт <guimenuitem
>Полноэкранный режим</guimenuitem
>; вернуться обратно можно, нажав <mousebutton
>левую</mousebutton
> или <mousebutton
>правую</mousebutton
> кнопку в окне. Вам следует настроить эту возможность, если она еще не включена.</para>

<para
>Вам стоит воспользоваться расширениями XFree86 VidMode и DGA, если они доступны. Благодаря этим расширениям, приложение может подстраивать разрешение экрана для лучшего соответствия размеру видео. Обычное видео, скажем, разрешением 320x200 должно было бы быть отмасштабировано на дисплей 800x600. На такое масштабирование затрачиваются дополнительные ресурсы, а результат вовсе не впечатляет. В диалоге настройке есть два флажка:</para>

<variablelist
> <varlistentry
> <term
><guilabel
>Использовать расширение XFree86-VidMode, если оно доступно</guilabel
></term
> <listitem
><para
><action
>включает полноэкранный режим</action
></para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Захватить мышь</guilabel
></term
> <listitem
><para
>&aktion;<action
> захватывает мышь в полноэкранном режиме</action
></para
></listitem
> </varlistentry
> </variablelist>

</sect1>
</chapter>

<chapter id="commands">
<title
>Справочник по командам</title>

<sect1 id="video-context-menu">
<title
>Контекстное меню видео</title>

<para
>Контекстное меню видео выпадает при нажатии <mousebutton
>правой</mousebutton
> кнопкой мыши в окне воспроизведения, если уже открыт видеофайл. </para>

<variablelist
> <varlistentry
> <term
><guimenuitem
>Параметры видео</guimenuitem
></term
> <listitem
><para
>Выпадает окошко со сведениями об открытом файле, включая число кадров, тип кодирования и исходное разрешение.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Открыть файл</guimenuitem
></term
> <listitem
><para
>Открывается стандартный диалог &kde; <quote
>открыть файл</quote
> со включенными фильтрами для выбора типа файлов, поддерживаемых &aktion;.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Настройки</guimenuitem
></term
> <listitem
><para
>Открывается диалог <guilabel
>Настройки</guilabel
> для задания параметров для работы &aktion;.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Исходный размер</guimenuitem
></term
> <listitem
><para
>Восстанавливает окно воспроизведения &aktion; до размеров исходного файла. Очевидно, что это действие не оказывает никакого эффекта, если вы не изменяли размер окна.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Половинный размер</guimenuitem
></term
> <listitem
><para
>Уменьшает окно воспроизведения &aktion; вдвое по сравнению с размерами исходного файла.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Удвоенный размер</guimenuitem
></term
> <listitem
><para
>Увеличивает окно воспроизведения &aktion; вдвое по сравнению с размерами исходного файла.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Развернуть окно</guimenuitem
></term
> <listitem
><para
>Окно воспроизведения &aktion; будет распахнуто на весь экран. Масштаб воспроизведения (отношение ширины и высоты) искажаться не будет, поэтому широкоэкранный ролик так и останется широкоэкранным, занимая всю доступную часть экрана, не отведенную под особые приложения, такие как панель &kicker;.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guimenuitem
>Полноэкранный режим</guimenuitem
></term
> <listitem
><para
>Весь экран будет занят окном &aktion;.</para
> <para
>Дополнительные сведения можно будет почерпнуть в  <xref linkend="aktion-fullscreen"/></para
></listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="toolbar">
<title
>Панель инструментов</title>

<screenshot
> <screeninfo
>Панель инструментов &aktion;</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="aktiontoolbar.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Панели инструментов</phrase
> </textobject
> </mediaobject
> </screenshot>
			       
<para
>Панель инструментов располагается внизу окна &aktion;. В ней имеются следующие иконки:</para>

<variablelist
> <varlistentry
> <term
><guiicon
>Открыть</guiicon
></term
> <listitem
><para
>Открывается стандартный диалог &kde; <quote
>открыть файл</quote
> со включенными фильтрами для выбора типа файлов, поддерживаемых &aktion;.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Воспроизвести</guiicon
></term
> <listitem
><para
>Начать воспроизведение файла</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Стоп</guiicon
></term
> <listitem
><para
>Остановить воспроизведение</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Назад</guiicon
></term
> <listitem
><para
>Перемотать назад</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Вперед</guiicon
></term
> <listitem
><para
>Промотать вперед</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Настройки</guiicon
></term
> <listitem
><para
>Открыть диалог <link linkend="aktion-setup"
>Настройки</link
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guiicon
>Помощь</guiicon
></term
> <listitem
><para
>Открыть справочное руководство по &aktion; (этот документ)</para
></listitem
> </varlistentry
> </variablelist>

<para
>Справа и сверху над панелью &aktion; расположен регулятор громкости, с помощью которого вы можете изменять громкость звука.</para>

</sect1>

<sect1 id="aktion-setup">
<title
>Настройки &aktion;</title>

<para
>Диалог настроек содержит пять основных вкладок.</para>

<itemizedlist
> <listitem
><para
><link linkend="setup-audio"
><guilabel
>Аудио</guilabel
></link
></para
></listitem
> <listitem
><para
><link linkend="setup-color"
><guilabel
>Цветность</guilabel
></link
></para
></listitem
> <listitem
><para
><link linkend="setup-scaling"
><guilabel
>Масштабирование</guilabel
></link
></para
></listitem
> <listitem
><para
><link linkend="setup-capture"
><guilabel
>Захват изображения</guilabel
></link
></para
></listitem
> <listitem
><para
><link linkend="setup-others"
><guilabel
>Разное</guilabel
></link
></para
></listitem
> </itemizedlist>

<para
>В нем есть также стандартные кнопки <guibutton
>OK</guibutton
> <guibutton
>Отмена</guibutton
>. Нажав <guibutton
>OK</guibutton
>, вы сохраните все сделанные изменения, нажав <guibutton
>Отмена</guibutton
> - закроете диалог, не сохранив изменений.</para>

<sect2 id="setup-audio">
<title
>Настройки <guilabel
>аудио</guilabel
></title>

<para
>На этой вкладке настраивается звук.</para>

<variablelist
> <varlistentry
> <term
><guilabel
>Включить звук</guilabel
></term
> <listitem
><para
>Если снять этот флажок, воспроизведение будет идти без звука.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Пропускать кадры для синхронизации видео и звука</guilabel
></term
> <listitem
><para
>При включении этого флажка &aktion; будет пропускать отдельные кадры видео, если отображение видео не успевает за звуком. Это помогает на медленных машинах: оказывается, аудио и видео воспроизводятся с разной скоростью, и звук может закончиться, пока видео еще на полдороге. Включение этого флажка ухудшает качество видео, но вы можете этого и не заметить. На медленных машинах степень ухудшения качества будет зависеть в основном от ее тормознутости и объема памяти.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Показывать уровень громкости</guilabel
></term
> <listitem
><para
>Включает или отключает показ регулятора громкости справа от панели инструментов. По умолчанию он включен.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Начальная громкость (0-100):</guilabel
></term
> <listitem
><para
>Начальная громкость воспроизведения. Изменения громкости регулятором будут осуществляться относительно этого уровня. Введите число или используйте стрелочки.</para
></listitem
> </varlistentry
> </variablelist>

</sect2>

<sect2 id="setup-color">
<title
>Настройки <guilabel
>цветности</guilabel
></title>

<para
>На этой вкладке настраивается отображение цветов при воспроизведении.</para>

<variablelist
> <varlistentry
> <term
><guilabel
>Преобразование цветов (для не полноцветных дисплеев)</guilabel
></term
> <listitem
><para
>Эта вкладка применима только для дисплеев с цветностью менее чем TrueColor. Если у вас проблемы с цветом, возможно, стоит попробовать настроить эти опции.</para
> <variablelist
> <varlistentry
> <term
><guilabel
>Преобразовать TrueColor в HiColor (статические цвета)</guilabel
></term
> <listitem
><para
>При включении этого флажка &aktion; будет преобразовывать цвета и отображать их в виде Static322.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Использовать таблицу цветов</guilabel
></term
> <listitem
><para
>При включении этого флажка &aktion; будет формировать палитру и использовать ее в виде динамической таблицы цветности. Можно задать, сколько впереди идущих кадров будет просматриваться для создания этой таблицы, но большие значения требуют больше памяти. Значение по умолчанию - 5.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Преобразовать TrueColor в градации серого</guilabel
></term
> <listitem
><para
>При включении этого флажка &aktion; будет формировать черно-белое изображение (градации серого).</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Нет</guilabel
></term
> <listitem
><para
><guilabel
>Нет</guilabel
> - значение по умолчанию.&aktion; не будет никак преобразовывать цвета. Вам не стоит менять эту настройку, если нет проблем с отображением цветов.</para
></listitem
> </varlistentry
> </variablelist
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Гамма дисплея</guilabel
>:</term
> <listitem
><para
>Значение гаммы дисплея. Обычно значения, большие, чем 1.0, увеличивают яркость.</para
></listitem
> </varlistentry
> </variablelist>

</sect2>

<sect2 id="setup-scaling">
<title
>Настройки <guilabel
>масштабирования</guilabel
></title>

<para
>На этой вкладке настраивается размер воспроизведения.</para>

<variablelist
> <varlistentry
> <term
><guilabel
>Масштабирование изображения</guilabel
></term
> <listitem
><para
>Размер картинки по отношению к исходному размеру ролика</para
> <para
>Можно выбирать из следующих величин</para
> <simplelist
> <member
>Исходный размер</member
> <member
>Половинный размер</member
> <member
>Удвоенный размер</member
> <member
>Распахнуть</member
> <member
>Полноэкранный режим</member
> </simplelist
> </listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Полноэкранный режим</guilabel
></term
> <listitem
><para
>Параметры работы &aktion; в полноэкранном режиме.</para
> <variablelist
> <varlistentry
> <term
><guilabel
>Использовать расширение XFree86-VidMode, если оно доступно</guilabel
></term
> <listitem
><para
>Разрешает использование полноэкранного режима. Подробнее об этом см. в разделе <link linkend="aktion-fullscreen"
>Использование &aktion; в полноэкранном режиме</link
></para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Захватить мышь</guilabel
></term
> <listitem
><para
>Полностью захватывает мышь в полноэкранном режиме.</para
></listitem
> </varlistentry
> </variablelist
> </listitem
> </varlistentry
> </variablelist>

</sect2>

<sect2 id="setup-capture">
<title
>Настройки <guilabel
>захвата изображения</guilabel
></title>

<para
>&aktion; позволяет <quote
>захватывать</quote
> кадры из ролика. Для этого нажмите клавишу <keycap
>C</keycap
> при воспроизводении. На данной вкладке настраиваются соответствующие параметры.</para
> 

<variablelist
> <varlistentry
> <term
><guilabel
>Формат выходного файла:</guilabel
></term
> <listitem
><para
>Задайте формат, в котором будет сохраняться захваченный кадр. Выберите один из доступных графических форматов:</para
> <simplelist
> <member
>bmp</member
> <member
>jpeg</member
> <member
>pbm</member
> <member
>pgm</member
> <member
>png</member
> <member
>ppm</member
> <member
>xbm</member
> <member
>xpm</member
> </simplelist
> <para
>Формат по умолчанию это - png.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Каталог выходного файла</guilabel
>:</term
> <listitem
><para
>Каталог для сохранения захваченных кадров. По умолчанию это <filename
>~</filename
> (ваш домашний каталог.) Вы можете ввести путь в строке ввода или нажать <guibutton
>...</guibutton
>, чтобы выбрать другой каталог.</para
></listitem
> </varlistentry
> </variablelist>

</sect2>

<sect2 id="setup-others">
<title
><guilabel
>Разное</guilabel
></title>

<para
>На этой вкладке настраиваются прочие параметры.</para>

<variablelist
> <varlistentry
> <term
><guilabel
>Загрузка видеофайла</guilabel
></term
> <listitem
><para
>Параметры загрузки видеофайла. Можно выбрать:</para
> <variablelist
> <varlistentry
> <term
><guilabel
>Загружать в память</guilabel
></term
> <listitem
><para
>Весь ролик будет считываться в память перед началом воспроизведения.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Загружать в память и декодировать</guilabel
></term
> <listitem
><para
>Весь ролик будет считываться в память и декодироваться перед началом воспроизведения.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Загружать только необходимые участки</guilabel
></term
> <listitem
><para
>Ролик будет не считываться в память, а подгружаться с диска по мере необходимости в ходе воспроизведения.</para
></listitem
> </varlistentry
> </variablelist
> <para
>По умолчанию - <guilabel
>Загружать только необходимые участки</guilabel
></para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Использовать разделяемую память в X11</guilabel
></term
> <listitem
><para
>Эта опция недоступна, если выбран режим <guilabel
>Загружать в память и декодировать</guilabel
>. По умолчанию она отключена.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Использовать множественную буферизацию X11</guilabel
></term
> <listitem
><para
>Эта опция дает возможность &aktion; использовать двойную буферизацию X11 (если она доступна) для сглаживания воспроизведения. По умолчанию она включена.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Использовать Pixmap вместо Image в X11</guilabel
></term
> <listitem
><para
>При включении этой опции &aktion; будет использовать Pixmap вместо Image в разделяемой памяти X11. Этот флажок ни на что не влияет, если воспроизведение буферизуется.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Исходный каталог для загружаемых файлов</guilabel
></term
> <listitem
><para
>Задает исходный каталог для открытия видеофайлов. Введите путь или используйте кнопку <guibutton
>...</guibutton
>, чтобы выбрать другой каталог. Если здесь ничего не указать, &aktion; будет открывать ваш домашний каталог.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Воспроизводить в цикле</guilabel
></term
> <listitem
><para
>При включении этого флажка ролик, доиграв до конца, будет вновь показываться с самого начала, пока вы не нажмете кнопку <guiicon
>Стоп</guiicon
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Автоматически начинать воспроизводение видео при открытии файла</guilabel
></term
> <listitem
><para
>При включении этого флажка &aktion; начнет воспроизведение сразу, как только вы выберете файл. В противном случае воспроизведение будет начинаться при нажатии кнопки <guiicon
>Воспроизвести</guiicon
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Дополнительные параметры xanim</guilabel
></term
> <listitem
><para
>Укажите здесь все параметры, которые должны будут передаваться в <application
>XAnim</application
>.</para
></listitem
> </varlistentry
> </variablelist>

</sect2>

</sect1>

</chapter>

<chapter id="developers">
<title
>Справочник по разработке для &aktion;</title>

<para
>&aktion; построен на классе <classname
>KXAnim</classname
>, с помощью которого вы можете включать воспроизведение видео в ваши собственные программы.</para>

<!-- Use refentries to describe APIs.  Refentries are fairly complicated and you
should consult the docbook reference for further details. The example below was
taken from that reference and shortened a bit for readability. -->

<refentry id="re-1007-kanim">

<refmeta>
<refentrytitle
>KXAnim</refentrytitle>
<refmiscinfo
>KXAnim Class Reference</refmiscinfo>
</refmeta>

<refnamediv>
<refname
>KXAnimChildren</refname>
<refpurpose
>A xanim wrapper to allow video playing in your apps.</refpurpose>
</refnamediv>

<refsynopsisdiv>
<refsynopsisdivinfo>
<date
>18/08/2000</date>
</refsynopsisdivinfo>

<synopsis>
Public Members

      KXAnim (QWidget *parent, const char *name=0)
      ~KXAnim ()
      void setFile (QString file)
      void setAutoResize (bool val)
      bool getAutoResize ()
      void updateSize ()
      void setLoop (bool val)
      bool getLoop ()
      QString getVideoFileName ()
      int getVideoHeight ()
      int getVideoWidth ()
      float getVideoSpeed ()
      int getVideoFrames ()
      QString getVideoCodec ()
      QString getErrorCode ()
      QString getErrorString ()
      bool isPlaying ()
      bool isActive ()
      void resetXAnimDefaults ()
      void setAudio (bool val)
      void setAudioSync (bool val)
      void setInitialVolume (int val)
      enum colorMap { static332, lookupTable, grayScale, none }
      void setColorMapping (colorMap val)
      void setColorAhead (int val)
      void setGammaDisplay (float val)
      void setResizing (bool val)
      void setScaleFactor (float val)
      void setScaleHFactor (float val)
      void setScaleVFactor (float val)
      void setScaleWidth (int val)
      void setScaleHeight (int val)
      void setScaleDisplayToBuffer (bool val)
      void setScaleFactorB (float val)
      void setScaleHFactorB (float val)
      void setScaleVFactorB (float val)
      void setScaleWidthB (int val)
      void setScaleHeightB (int val)
      void setScaleBufferToDisplay (bool val)
      void setLoading (int val)
      void setX11Shared (bool val)
      void setMultiBuffer (bool val)
      void setUsePixmap (bool val)
      void setX11VisualClass ( const char *val)
      void setPauseAt (int val)
      void setExtraParameters (const char *val)
      void setExecutable (const char *val)

Public Slots

      void play ()
      void pause ()
      void stop ()
      void stepForward ()
      void stepBack ()
      void stepForwardWA ()
      void stepBackWA ()
      void toggleSound ()
      void volumeIncrement ()
      void volumeDecrement ()
      void setVolume (int v)
      void faster ()
      void slower ()
      void resetSpeed ()

Protected Members

      void changeProperty ( const char * c)
      virtual void closeEvent ( QCloseEvent *)
      virtual void mousePressEvent ( QMouseEvent *)

Signals

      void stopped ()
      void mouseClick ( QMouseEvent *)
</synopsis>
</refsynopsisdiv>

<refsect1>
<title
>Подробное описание <classname
>KXAnim</classname
></title>

<para
>#include &lt;kxanim.h&gt;</para>

<para
>Наследует: <classname
>QWidget</classname
></para>

<para
>Класс графического элемента (widget) для воспроизведения видео</para>

<para
>Этот графический элемент служит для использования функций <application
>xanim</application
> и включения воспроизведения видео в ваши программы.</para>

<variablelist
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
><function
>KXAnim</function
></funcdef
> <paramdef
>QWidget <parameter
>*parent</parameter
></paramdef
> <paramdef
>const char <parameter
>*name=0</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Конструктор. Аргумент parent <emphasis
>ДОЛЖЕН БЫТЬ</emphasis
> указан.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setFile</function
></funcdef
> <paramdef
>QString <parameter
>file</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Метод задает имя файла для воспроизведения. Файл не будет воспроизводиться, пока не будет вызван слот <function
>play()</function
>. Необходимо также вызвать функцию <function
>stop()</function
>, прежде чем задавать новое имя файла. </para
> <para
>Вызвав этот метод, вы должны дождаться сигнала stopped. После этого становятся доступными сведения о файле.</para
> <para
>См. также <returnvalue
>KXAnim::getErrorNumber</returnvalue
> и <function
>getErrorString</function
> для проверки на ошибки.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setAutoResize</function
></funcdef
> <paramdef
>bool <parameter
><replaceable
>val</replaceable
></parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Если <parameter
>val</parameter
>==<returnvalue
>true</returnvalue
>, виджет сам подберет свой размер для отображения видео после вызова функции <function
>setFile()</function
>. Если <parameter
>val</parameter
>==<returnvalue
>false</returnvalue
>, видео будет выводиться в размеры виджета.</para
> <para
>Размер виджета автоматически обновляется при вызове <function
>setFile</function
> и play. Но если вы хотите знать его размер до вызова функции <function
>play</function
>, следует вызвать функцию <function
>updateSize</function
>.</para
> <para
>По умолчанию - <returnvalue
>true</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>bool <function
>getAutoResize</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Возвращает значение auto-resize (см. <function
>setAutoResize</function
> ).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>updateSize</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
> <para
>Обновляет размер виджета, чтобы он соответствовалразмеру видео (с учетом фактора масштабирования) См. <function
>setAutoResize</function
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setLoop</function
></funcdef
> <paramdef
>bool <parameter
><replaceable
>val</replaceable
></parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
> <para
>Если <parameter
>val</parameter
>==<returnvalue
>true</returnvalue
>, воспроизведение будет осуществляться в цикле.</para
> <para
>По умолчанию - <returnvalue
>true</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>bool <function
>getLoop</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Возвращает значение цикличности воспроизведения ( см. <function
>setLoop</function
> ).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>QString <function
>getVideoFileName</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Возвращает имя файла (или пустую строку, если он не открыт).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>int <function
>getVideoHeight</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Возвращает вертикальный размер видео (в пикселах).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>int <function
>getVideoWidth</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Возвращает вертикальный размер видео (в пикселах).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>float <function
>getVideoSpeed</function
></funcdef
> <paramdef
></paramdef
> </funcprototype
></funcsynopsis
> [public] </term
> <listitem
><para
>Возвращает скорость воспроизведения видео (в кадрах/сек).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>int <function
>getVideoFrames</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Возвращает количество кадров в ролике.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>QString <function
>getVideoCodec</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Возвращает строку описания видеокодека.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>QString <function
>getErrorCode</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Возвращает код ошибки. Вы должны проверить его после вызова <function
>setFile</function
>. Код <returnvalue
>0</returnvalue
> означает отсутствие ошибок. Чтобы получить строку описания ошибки, см. <function
>getErrorString</function
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>QString <function
>getErrorString</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Возвращает строку описания ошибки после вызова <function
>setFile</function
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>bool <function
>isPlaying</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Возвращает <returnvalue
>true</returnvalue
>, если видео находится в режиме воспроизведения. В противном случае возвращает <returnvalue
>false</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>bool <function
>isActive</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Возвращает <returnvalue
>true</returnvalue
>, если виджет активен. В противном случае возвращает <returnvalue
>false</returnvalue
>. Виджет <emphasis
>НЕ</emphasis
> активен, только если видео остановлено. Поэтому используйте этот метод для проверки того, что видео действительно остановлено. </para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>resetXAnimDefaults</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Выставляет значения по умолчанию для всех параметров.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setAudio</function
></funcdef
> <paramdef
>bool <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Если <parameter
>val</parameter
>==<returnvalue
>true</returnvalue
>, включает вывод звука.</para
> <para
>По умолчанию - <returnvalue
>true</returnvalue
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setAudioSync</function
></funcdef
> <paramdef
>bool <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Если <parameter
>val</parameter
>==<returnvalue
>true</returnvalue
>, разрешает <application
>xanim</application
> пропускать кадры для синхронизации с видео.</para
> <para
>По умолчанию - <returnvalue
>true</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setInitialVolume</function
></funcdef
> <paramdef
>int <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Устанавливает начальный уровень громкости.</para
> <para
>По умолчанию <returnvalue
>40</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> enum colorMap ( static332, lookupTable, grayScale, none ) [public] </term
><listitem
> <para
>См. setColorMapping.</para
> </listitem
></varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setColorMapping</function
></funcdef
> <paramdef
>colorMap <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public]</term
> <listitem
><para
>Указывает <classname
>KXAnim</classname
> тип отображения цветов для не полноцветных дисплеев.</para
> <para
>Если <parameter
>val</parameter
>==<returnvalue
>KXAnim::static322</returnvalue
>, <application
>xanim</application
> будет преобразовывать truecolor в static322.</para
> <para
>Если <parameter
>val</parameter
>==<returnvalue
>KXAnim::lookupTable</returnvalue
>, <application
>xanim</application
> будет вычислять отображение truecolor цветов по будущим кадрам заранее и формировать таблицу цветности.</para
> <para
>Если <parameter
>val</parameter
>==<returnvalue
>KXAnim::grayScale</returnvalue
>, <application
>xanim</application
> будет преобразовывать TrueColor градации серого.</para
> <para
>Эти три параметра игнорируются для дисплеев TrueColor и DirectColor.</para
> <para
>Если <parameter
>val</parameter
>==<returnvalue
>KXAnim::none</returnvalue
>, <application
>xanim</application
> будет использовать отображение цветов по умолчанию.</para
> <para
>По умолчанию <returnvalue
>KXAnim::none</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setColorAhead</function
></funcdef
> <paramdef
>int <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Задает количество кадров для просмотра при формировании таблицы цветов, если в <function
>setColorMapping</function
> указано <returnvalue
>KXAnim::lookupTable</returnvalue
> .</para
> <para
>По умолчанию <returnvalue
>5</returnvalue
>.</para
> </listitem
></varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setGammaDisplay</function
></funcdef
> <paramdef
>float <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Значение гаммы дисплея. Обычно значения, большие, чем 1.0, увеличивают яркость.</para
> <para
>По умолчанию <returnvalue
>1.0</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void setResizing</funcdef
> <paramdef
>bool <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Если <parameter
>val</parameter
>==<returnvalue
>true</returnvalue
>, размер видео может меняться "на лету".</para
> <para
>По умолчанию - <returnvalue
>true</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleFactor</function
></funcdef
> <paramdef
>float <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Масштабировать размер видео согласно "<parameter
>val</parameter
>" перед воспроизведением.</para
> <para
>По умолчанию <returnvalue
>1.0</returnvalue
> (не масштабировать).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleHFactor</function
></funcdef
> <paramdef
>float <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public]</term
> <listitem
><para
>Масштабировать горизонтальный размер видео согласно "<parameter
>val</parameter
>" перед воспроизведением.</para
> <para
>По умолчанию <returnvalue
>1.0</returnvalue
> (не масштабировать).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleVFactor</function
></funcdef
> <paramdef
>float <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Масштабировать вертикальный размер видео согласно "<parameter
>val</parameter
>" перед воспроизведением.</para
> <para
>По умолчанию <returnvalue
>1.0</returnvalue
> (не масштабировать).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleWidth</function
></funcdef
> <paramdef
>int <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Задать горизонтальный размер видео "<parameter
>val</parameter
>" перед воспроизведением.</para
> <para
>По умолчанию <returnvalue
>0</returnvalue
> (размер не изменять).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleHeight</function
></funcdef
> <paramdef
>int <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Задать вертикальный размер видео "<parameter
>val</parameter
>" перед воспроизведением.</para
> <para
>По умолчанию <returnvalue
>0</returnvalue
> (размер не изменять).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleDisplayToBuffer</function
></funcdef
> <paramdef
>bool <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Скопировать факторы масштабирования дисплея в факторы масштабирования буфера.</para
> <para
>По умолчанию <returnvalue
>false</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleFactorB</function
></funcdef
> <paramdef
>float <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Масштабировать размер видео согласно "<parameter
>val</parameter
>" перед буферизацией.</para
> <para
>По умолчанию <returnvalue
>1.0</returnvalue
> (не масштабировать).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleHFactorB</function
></funcdef
> <paramdef
>float <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Масштабировать горизонтальный размер видео согласно "<parameter
>val</parameter
>" перед буферизацией.</para
> <para
>По умолчанию <returnvalue
>1.0</returnvalue
> (не масштабировать).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleVFactorB</function
></funcdef
> <paramdef
>float <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Масштабировать вертикальный размер видео согласно "<parameter
>val</parameter
>" перед буферизацией.</para
> <para
>По умолчанию <returnvalue
>1.0</returnvalue
> (не масштабировать).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleWidthB</function
></funcdef
> <paramdef
>int <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Задать горизонтальный размер видео "<parameter
>val</parameter
>" перед буферизацией.</para
> <para
>По умолчанию <returnvalue
>0</returnvalue
> (размер не изменять).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleHeightB</function
></funcdef
> <paramdef
>int <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Задать вертикальный размер видео "<parameter
>val</parameter
>" перед буферизацией.</para
> <para
>По умолчанию <returnvalue
>0</returnvalue
> (размер не изменять).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setScaleBufferToDisplay</function
></funcdef
> <paramdef
>bool <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Скопировать факторы масштабирования буфера в факторы масштабирования дисплея.</para
> <para
>По умолчанию <returnvalue
>false</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setLoading</function
></funcdef
> <paramdef
>int <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
><returnvalue
>0</returnvalue
>: <classname
>KXAnim</classname
> загружает весь ролик в память.</para
> <para
><returnvalue
>1</returnvalue
>: <classname
>KXAnim</classname
> загружает весь ролик в память и декодирует его перед началом воспроизведения.</para
> <para
><returnvalue
>2</returnvalue
>: <classname
>KXAnim</classname
> подгружает с диска участки ролика в память по мере необходимости.</para
> <para
>По умолчанию <returnvalue
>2</returnvalue
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setX11Shared</function
></funcdef
> <paramdef
>bool <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public]</term
> <listitem
><para
>Если <parameter
>val</parameter
>==<returnvalue
>true</returnvalue
>, <classname
>KXAnim</classname
> будет использовать разделяемую память X11 (взаимоисключаемо с <function
>setPreload</function
> .</para
> <para
>По умолчанию <returnvalue
>false</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setMultiBuffer</function
></funcdef
> <paramdef
>bool <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Если <parameter
>val</parameter
>==<returnvalue
>true</returnvalue
>, <classname
>KXAnim</classname
> будет использовать двойную буферизацию X11 (если она доступна) для сглаживания воспроизведения. </para
> <para
>По умолчанию - <returnvalue
>true</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setUsePixmap</function
></funcdef
> <paramdef
>bool <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Если <parameter
>val</parameter
>==<returnvalue
>true</returnvalue
>, <classname
>KXAnim</classname
> будет использовать Pixmap вместо Image в разделяемой памяти X11. Опция не имеет значения при включении буферизации.</para
> <para
>По умолчанию <returnvalue
>false</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setX11VisualClass</function
></funcdef
> <paramdef
>const char <parameter
>*val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Выбирает лучшее из доступного <quote
>X11 Visual of Class...</quote
> при отображении. val может принимать любые значения из следующего списка:</para
> <simplelist
> <member
><returnvalue
>default</returnvalue
></member
> <member
><returnvalue
>staticgray</returnvalue
></member
> <member
><returnvalue
>grayscale</returnvalue
></member
> <member
><returnvalue
>staticcolor</returnvalue
></member
> <member
><returnvalue
>pseudocolor</returnvalue
></member
> <member
><returnvalue
>truecolor</returnvalue
></member
> <member
><returnvalue
>directcolor</returnvalue
></member
> </simplelist
> <para
>По умолчанию - <returnvalue
>default</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setPauseAt</function
></funcdef
> <paramdef
>int <parameter
>val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Приостановить <application
>XAnim</application
> на кадре <parameter
>val</parameter
>. <parameter
>val</parameter
>=<returnvalue
>-1</returnvalue
> отключает эту опцию.</para
> <para
>По умолчанию - <returnvalue
>-1</returnvalue
> (нет паузы).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setExtraParameters</function
></funcdef
> <paramdef
>const char <parameter
>*val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Используйте этот метод, чтобы передать дополнительные параметры в <application
>xanim</application
> (separated by spaces).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setExecutable</function
></funcdef
> <paramdef
>const char <parameter
>*val</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public] </term
> <listitem
><para
>Используйте этот метод, чтобы задать имя исполняемого файла <application
>xanim</application
>. По умолчанию это "<returnvalue
>xanim</returnvalue
>", но вы можете это изменить, если <application
>xanim</application
> не входит в PATH.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>play</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Начать воспроизведение видео.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>pause</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Приостановить воспроизведение видео (но не выгружать <application
>xanim</application
>).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>stop</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Приостановить воспроизведение видео и выгрузить <application
>xanim</application
>. Это происходит без участия пользователя.</para
> <note
><para
>Вызов этого слота не означает немедленную остановку воспроизведения видео. Дождитесь сигнала <returnvalue
>stopped</returnvalue
>, чтобы удостовериться, что плеер перешел в неактивное состояние (см. <function
>isActive</function
> ). </para
></note
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>stepForward</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Вперед на один кадр. Приостанавливает воспроизведение.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>stepBack</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Назад на один кадр. Приостанавливает воспроизведение.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>stepForwardWA</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Вперед на один кадр, оставаясь на текущем(?). Приостанавливает воспроизведение.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>stepBackWA</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Назад на один кадр, оставаясь на текущем(?). Приостанавливает воспроизведение.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>toggleSound</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Включить/отключить звук.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>volumeIncrement</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Увеличить громкость на 1.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>volumeDecrement</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Уменьшить громкость на 1.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>setVolume</function
></funcdef
> <paramdef
>int <parameter
>v</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Задать громкость. Параметр <parameter
>v</parameter
> меняется в пределах от <returnvalue
>0</returnvalue
> до <returnvalue
>100</returnvalue
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>faster</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Увеличить значение скорости воспроизведения.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>slower</function
></funcdef
> <paramdef
></paramdef
> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Уменьшить значение скорости воспроизведения.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>resetSpeed</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [public slot] </term
> <listitem
><para
>Восстановить исходное значение скорости воспроизведения.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>changeProperty</function
></funcdef
> <paramdef
>const char <parameter
>*</parameter
> c</paramdef
> </funcprototype
> </funcsynopsis
> [protected] </term
> <listitem
><para
><emphasis
>Не используйте!</emphasis
> Функция служит для связи с <application
>xanim</application
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>stopped</function
></funcdef
><void/> </funcprototype
> </funcsynopsis
> [signal] </term
> <listitem
><para
>Сигнал посылается после вызова слота <function
>stop()</function
>, чтобы сообщить о том, что плеер <emphasis
>действительно</emphasis
> прекратил воспроизведение (и <application
>xanim</application
> остановлен) (см. <function
>stop</function
>).</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <funcsynopsis
> <funcprototype
> <funcdef
>void <function
>mouseClick</function
></funcdef
> <paramdef
>QMouseEvent <parameter
>*</parameter
></paramdef
> </funcprototype
> </funcsynopsis
> [signal] </term
> <listitem
><para
>Сигнал посылается, когда пользователь нажимает мышью на widget.</para
></listitem
> </varlistentry
> </variablelist>
</refsect1>

</refentry>

</chapter>

<chapter id="faq">
<title
>Вопросы и ответы</title>

<qandaset>
<qandaentry>
<question
><para
>Что означает "неподдерживаемый видеокодек"?</para
></question>
<answer
><para
>Это означает, что данный видеоформат невозможно воспроизвести. Возможно, у вас неполная установка <application
>xanim</application
>, см. следующий вопрос.</para>
<para
>Есть такие кодеки, поддержка которых не намечается в ближайшем будущем, в их числе Sorenson, используемый в QuickTime 4. </para
></answer>
</qandaentry>

<qandaentry>
<question
><para
>Как установить <application
>xanim</application
> со всеми его возможностями?</para
></question>
<answer
><para
>На домашней странице <application
>xanim</application
> есть инструкции по установке видеокодеков cinepak, indeo и creative. Возможно, потребуется пересобрать <application
>xanim</application
>, но прочитайте документацию вашего дистрибутива, поскольку некоторые из них установить проще, чем другие.</para
></answer>
</qandaentry>

<qandaentry>
<question
><para
>Как узнать, установлены ли расширения Х VidMode и DGA на моей системе?</para>
</question>
<answer
><para
>Это можно проверить двумя способами, в зависимости от того, как вы устанавливали &aktion;. </para>
<variablelist
> <varlistentry
> <term
>&aktion; устанавливался из исходников</term
> <listitem
><para
>Проверьте результат работы скрипта <command
>./configure</command
>, в нем должна быть строка <computeroutput
>"checking for VidMode extensions..."</computeroutput
>. Если скрипт пишет <computeroutput
>"no"</computeroutput
> после этой строки, то расширения не найдены.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>&aktion; устанавливался из пакетов (rpm или deb)</term
> <listitem
><para
>Если вы найдете файлы: <filename
>libXxf86vm.a</filename
> и <filename
>libXxf86dga.a</filename
>, то они-то вам и нужны.</para
></listitem
> </varlistentry
> </variablelist>
<para
>В обоих случаях проверьте, установлен ли пакет XFree86-devel rpm. Расширения входят в этот пакет.</para
></answer>
</qandaentry>

<qandaentry>
<question
><para
>Как узнать, работает ли расширение VidMode на моей системе?</para
></question>
<answer
><para
>Попробуйте переключить режимы с помощью <keycombo
><keycap
>CTRL</keycap
><keycap
>ALT</keycap
><keycap
>numpad +</keycap
></keycombo
>, и если ничего не происходит, то настройте дополнительные режимы, см. об этом далее.</para
></answer>
</qandaentry>

<qandaentry>
<question
><para
>Как настроить дополнительные видеорежимы?</para
></question>
<answer
><para
>В вашем дистрибутиве должна быть утилита настройки видеорежимов. Как минимум, всегда можно поправить <application
>XF86Config</application
>.</para>
<para
>Вы можете задать столько режимов, сколько вам нужно, но как минимум еще один, например, 640x400 в добавление к вашему обычному разрешению.</para
></answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

<title
>Благодарности и лицензии</title>

<para
>&aktion;</para>

<para
>Программирование: copyright 2000 Guillermo P. Marotte <email
>g-marotte@usa.net</email
></para>

<para
>Благодарности</para>
<itemizedlist
> <listitem
><para
>Benjamin Sher <email
>sher07@bellsouth.net</email
></para
></listitem
> </itemizedlist>

<para
>Автор Xanim:</para>
<itemizedlist
><listitem
><para
>Mark Podlipec</para
></listitem
> </itemizedlist>

<para
>Документация: copyright 2000 Chris D. Corbettis <email
>chris@corbettis.fsnet.co.uk</email
></para>
<para
>Перевод на русский Григорий Мохин<email
>mok@kde.ru</email
></para>

&underFDL;
&underGPL;

</chapter>

<appendix id="installation">
<title
>Установка</title>

<sect1 id="getting-aktion">
<title
>Откуда можно скачать &aktion;</title>

&install.intro.documentation;

</sect1>

<sect1 id="requirements">
<title
>Требования</title>

<para
>Для работы &aktion;, требуется &kde; 2 и <application
>xanim</application
> 2.70.7.0 или более свежий. Полноэкранный режим требует расширений Х <application
>VidMode</application
> и <abbrev
>DGA</abbrev
>.</para>

<para
>Все требуемые библиотеки и сам &aktion; можно скачать с домашних страниц <ulink url="ftp://ftp.kde.org"
>&aktion;</ulink
> и <ulink url="http://xanim.va.pubnix.com/home.html"
>Xanim</ulink
></para>

</sect1>

<sect1 id="compilation">
<title
>Сборка и установка</title>

&install.compile.documentation;

</sect1>

<sect1 id="configuration">
<title
>Настройка</title>

<para
>Не забудьте, что <application
>xanim</application
> должен быть установлен перед &aktion;.</para>

</sect1>

</appendix>


&documentation.index; 
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->
