<!DOCTYPE book PUBLIC  "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
  <!ENTITY kappname "&aktion;" -- this only *seems* redundant -->
  <!ENTITY % German "INCLUDE">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Documentation V1.0//EN">
  %ents;
]>

<book lang="&language;">
  
  <bookinfo>
    <title>Das &aktion; Handbuch</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>Entwickler</contrib>
      </othercredit>
      
      <othercredit role="reviewer">
	<firstname>Lauri</firstname>
	<surname>Watts</surname>
	<affiliation>
	  <address><email>vampyr@atconnex.net</email></address>
	</affiliation>
	<contrib>Gegengelesen von</contrib>
      </othercredit>
      
      <othercredit role="translator">
	<firstname>Frank</firstname>
	<surname>Sch&uuml;tte</surname>
	<affiliation>
	  <address><email>F.Schuette@t-online.de</email></address>
	</affiliation>
	<contrib>Deutsche &Uuml;bersetzung</contrib>
      </othercredit>
      
    </authorgroup>
    
    <copyright>
      <year>2000</year>
      <holder>Chris D. Corbettis</holder>
    </copyright>
    
    <legalnotice>&FDLNotice;</legalnotice>
    
    <date>16/12/2000</date>
    <releaseinfo>1.0</releaseinfo>

    <abstract>
      <para>&aktion; ist ein Videospieler f&uuml;r KDE.</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>
      <keyword>Video</keyword>
      <keyword>Videospieler</keyword>
    </keywordset>
  </bookinfo>
  <chapter id="introduction">
    <title>Einleitung</title>

    <para>Der Videospieler &aktion; steuert das Videoprogramm 
<application>Xanim</application>. Er unterst&uuml;tzt die im Internet gebr&auml;uchlichen Videoformate,
 unter anderem MPEG1, QuickTime und animierte GIF-Grafiken.
Falls Sie Probleme mit &aktion; haben oder W&uuml;nsche f&uuml;r Erweiterungen, wenden
Sie sich bitte an eine der KDE-Mailinglisten.</para>

<sect1 id="kapp-revhistory">
<title>&aktion; Entwicklungsgeschichte</title>

	  <itemizedlist>
	    <listitem><para>1.0 - Erste &ouml;ffentliche Version</para></listitem>
	  </itemizedlist>
	</sect1>
  </chapter>


  <chapter id="using-kapp">
    <title>Benutzung von &aktion;</title>

    <screenshot>
      <screeninfo>So sieht das &aktion; Anwendungsfenster aus.</screeninfo>
      <mediaobject>
	<imageobject>
	  <imagedata fileref="aktion.png" format="PNG">
	</imageobject>
	<textobject>
	  <phrase>Anwendungsfenster</phrase>
	</textobject>
      </mediaobject>
    </screenshot>

    <para>Die grundlegende Bedienung von &aktion; ist unkompliziert. Klicken Sie
<mousebutton>rechts</mousebutton> mit der Maus auf das Hauptfenster oder
w&auml;hlen Sie das Symbol f&uuml;r <guiicon>Datei &ouml;ffnen</guiicon> aus der Werkzeugleiste,
w&auml;hlen Sie den gew&uuml;nschten Film aus und klicken Sie auf
<guibutton>OK</guibutton>.</para>

    <sect1 id="context-menu">
      <title>Das Kontextmen&uuml;</title>

      <para>Sie k&ouml;nnen das Kontextmen&uuml; aktivieren, indem Sie mit der rechten Maustaste
auf das Wiedergabefenster klicken und die Taste gedr&uuml;ckt halten. Das Kontextmen&uuml; enth&auml;lt
Funktionen, um die Wiedergabegr&ouml;&szlig;e zu &auml;ndern, den Filmdateidialog zu &ouml;ffnen und
Informationen zum aktuellen Film anzeigen zu lassen.</para>

      <para>Das Kontextmen&uuml; wird in <xref linkend="video-context-menu">
 n&auml;her beschrieben.</para>

    </sect1>

    <sect1 id="aktion-fullscreen">
      <title>&aktion; als Vollbild</title>

      <para>Sie k&ouml;nnen Filme in Vollbild-Darstellung ansehen, indem Sie im Hauptfenster
von &aktion; <mousebutton>rechts</mousebutton> klicken und
<guimenuitem>Ganzer Bildschirm</guimenuitem> ausw&auml;hlen. Um die Vollbild-Darstellung
zu beenden, klicken Sie <mousebutton>links</mousebutton> oder
 <mousebutton>rechts</mousebutton> auf den Bildschirm. Falls diese Eigenschaft von
&aktion; nicht funktioniert, m&uuml;ssen Sie sie vorher aktivieren.</para>

      <para>Verwenden Sie m&ouml;glichst die XFree86 VidMode- und DGA-Erweiterungen. Diese
Erweiterungen erlauben &aktion;, die Bildschirmaufl&ouml;sung an die Videoaufl&ouml;sung anzupassen.
&Uuml;blicherweise wird ein 320x200-Video bei einer 800x600-Bildschirmaufl&ouml;sung vergr&ouml;&szlig;ert
dargestellt. Diese Vergr&ouml;&szlig;erung erfordert zus&auml;tzlichen Rechenaufwand und das
erzielte Resultat ist wenig ansprechend. In den Einstellungen im Abschnitt Skalieren gibt es zwei
Ankreuzfelder, die dieses Verhalten beeinflussen.
</para>

      <variablelist>
	<varlistentry>
	  <term><guilabel>XFree86-VidModeExtensions verwenden, falls verf&uuml;gbar</guilabel></term>
	  <listitem><para><action>Verwendet die XFree86 VidMod-Erweiterungen, falls
diese installiert sind.</action></para></listitem>
	</varlistentry>
	<varlistentry>
	  <term><guilabel>Maus &uuml;bernehmen</guilabel></term>
	  <listitem><para>&aktion;<action> verwendet die Maus in der Vollbild-Darstellung.</action></para></listitem>
	</varlistentry>
      </variablelist>

    </sect1>
  </chapter>

  <chapter id="commands">
    <title>Befehlsreferenz</title>

    <sect1 id="video-context-menu">
      <title>Das Video-Kontextmen&uuml;</title>

      <para>Sie k&ouml;nnen das Kontextmen&uuml; aufrufen, indem Sie die <mousebutton>rechte</mousebutton>
Maustaste innerhalb eines geladenen Videofensters bet&auml;tigen.</para> 

      <variablelist>
	<varlistentry>
	  <term><guimenuitem>Video-Information</guimenuitem></term>
	  <listitem><para>Zeigt verschiedene Informationen &uuml;ber den aktuell geladenen Film an. Unter
anderem wird die Anzahl der Bilder pro Sekunde, das Videoformat und die 
Originalgr&ouml;&szlig;e angezeigt.</para></listitem>
	</varlistentry>
	
	<varlistentry>
	  <term><guimenuitem>Datei &ouml;ffnen...</guimenuitem></term>
	  <listitem><para>&Ouml;ffnet den KDE-Dateidialog mit einem Filter, der die von &aktion; unterst&uuml;tzten 
Videoformate enth&auml;lt.
</para></listitem>
	</varlistentry>

	<varlistentry>
	  <term><guimenuitem>Einrichtung...</guimenuitem></term>
<listitem><para>&Ouml;ffnet den Dialog <guilabel>Einrichtung</guilabel>, mit dem Sie die
Arbeitsweise von &aktion; beeinflussen k&ouml;nnen.</para></listitem>
</varlistentry>

	<varlistentry>
	  <term><guimenuitem>Originalgr&ouml;&szlig;e</guimenuitem></term>
	  <listitem><para>&Auml;ndert die Fenstergr&ouml;&szlig;e von &aktion; auf die Originalgr&ouml;&szlig;e des Films.
Dieser Men&uuml;eintrag hat keine Auswirkungen, solange Sie nicht vorher die Gr&ouml;&szlig;e des Fensters
ver&auml;ndert haben.</para></listitem>
	</varlistentry>

	<varlistentry>
	  <term><guimenuitem>Halbiert</guimenuitem></term>
	  <listitem><para>&Auml;ndert die Fenstergr&ouml;&szlig;e von &aktion; auf die halbe H&ouml;he und Breite der
 Originalgr&ouml;&szlig;e des Videofilms.</para></listitem>
	</varlistentry>

	<varlistentry>
	  <term><guimenuitem>Doppelte Gr&ouml;&szlig;e</guimenuitem></term>
	  <listitem><para>&Auml;ndert die Fenstergr&ouml;&szlig;e von &aktion; auf die doppelte H&ouml;he und Breite der
Originalgr&ouml;&szlig;e des Videofilms.</para></listitem>
	</varlistentry>

	<varlistentry>
	  <term><guimenuitem>Maximiert</guimenuitem></term>
	  <listitem><para>&Auml;ndert die Fenstergr&ouml;&szlig;e von &aktion; auf die maximal ohne Verzerrung darstellbare Gr&ouml;&szlig;e. 
Das L&auml;ngenverh&auml;ltnis von H&ouml;he und Breite wird dabei nicht ver&auml;ndert. So bleibt ein hoher schmaler
Videofilm weiterhin hoch und schmal. Er wird lediglich soweit vergr&ouml;&szlig;ert, bis eine der beiden
Dimensionen die R&auml;nder des Bildschirms erreicht, mit Ausnahme der st&auml;ndig auf dem Bildschirm
vorhandenen Bedienelemente der Arbeitsfl&auml;che, wie <abbrev>z.B.</abbrev>
der <application>Kontrollleiste</application>.</para></listitem>
	</varlistentry>

	<varlistentry>
	  <term><guimenuitem>Ganzer Bildschirm</guimenuitem></term>
	  <listitem><para>Durch diese Einstellung &uuml;bernimmt &aktion; die Bildschirmkontrolle.</para>
	    <para>Weitere Informationen &uuml;ber diese Einstellung finden Sie in 
<xref linkend="aktion-fullscreen"></para></listitem>
	</varlistentry>
      </variablelist>

    </sect1>


    <sect1 id="toolbar">
      <title>Die Werkzeugleiste</title>

      <screenshot>
	<screeninfo>Die Werkzeugleiste von &aktion;.</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="aktiontoolbar.png" format="png">
          </imageobject>
	  <textobject>
	    <phrase>Werkzeugleiste</phrase>
	  </textobject>
	</mediaobject>
      </screenshot>
			       
      <para>Die Werkzeugleiste befindet sich am unteren Rand des &aktion;-Fensters. Sie
enth&auml;lt folgende Symbole:</para>
      
      <variablelist>
	<varlistentry>
	  <term><guiicon>Datei &ouml;ffnen</guiicon></term>
	  <listitem><para>&Ouml;ffnet den KDE-Dateidialog mit einer Einschr&auml;nkung auf die von
&aktion; unterst&uuml;tzten Videodateiformate.</para></listitem>
	</varlistentry>
	
	<varlistentry>
	  <term><guiicon>Abspielen</guiicon></term>
	  <listitem><para>Startet die Wiedergabe des geladenen Videofilms.</para></listitem>
	</varlistentry>
	
	<varlistentry>
	  <term><guiicon>Halt</guiicon></term>
	  <listitem><para>Stoppt die Wiedergabe des geladenen Videofilms.</para></listitem>
	</varlistentry>
	
	<varlistentry>
	  <term><guiicon>R&uuml;ckw&auml;rts spulen</guiicon></term>
	  <listitem><para>Spult den geladenen Videofilm zur&uuml;ck an den Anfang.</para></listitem>
	</varlistentry>

	<varlistentry>
	  <term><guiicon>Vorw&auml;rts spulen</guiicon></term>
	  <listitem><para>Spult den geladenen Videofilm an das Ende.</para></listitem>
	</varlistentry>

	<varlistentry>
	  <term><guiicon>Einrichtung</guiicon></term>
	  <listitem><para>&Ouml;ffnet den Dialog <link linkend="aktion-setup">Einrichtung</link>.
</para></listitem>
	</varlistentry>
	
	<varlistentry>
	  <term><guiicon>Hilfe</guiicon></term>
	  <listitem><para>&Ouml;ffnet die Hilfedatei zu &aktion; (diese Datei).</para></listitem>
	</varlistentry>
      </variablelist>

      <para>Oberhalb der Werkzeugleiste befindet sich auf der rechten Seite ein Schieberegler f&uuml;r
die Lautst&auml;rke. Die Wiedergabelautst&auml;rke des Films kann von leise (nach links) bis laut (nach
rechts) eingestellt werden.</para>

    </sect1>

    <sect1 id="aktion-setup">
      <title>&aktion; Einrichtungsdialog</title>

      <para>Der Einrichtungsdialog hat f&uuml;nf Karteikarten:</para>

      <itemizedlist>
	<listitem><para>
<link linkend="setup-audio"><guilabel>Audio</guilabel></link></para></listitem>
	<listitem><para>
<link linkend="setup-color"><guilabel>Farbe</guilabel></link></para></listitem>
	<listitem><para>
<link linkend="setup-scaling"><guilabel>Skalieren</guilabel></link></para></listitem>
	<listitem><para><link 
linkend="setup-capture"><guilabel>Bildschirmphoto</guilabel></link></para></listitem>
<listitem><para><link 
linkend="setup-others"><guilabel>Sonstiges</guilabel></link></para></listitem>
</itemizedlist>

<para>Der Einrichtungsdialog hat Standardkn&ouml;pfe f&uuml;r <guibutton>OK</guibutton> und
<guibutton>Abbrechen</guibutton>.  Klicken Sie auf <guibutton>OK</guibutton>, um den
Dialog zu schlie&szlig;en und alle &Auml;nderungen zu sichern. Klicken Sie auf 
<guibutton>Abbrechen</guibutton>, um den Dialog zu schlie&szlig;en und alle &Auml;nderungen zu
verwerfen.</para>

<sect2 id="setup-audio">
<title>Audio-Einrichtung</title>

<para>Auf dieser Karteikarte befinden sich die Einstellungen zur Audiowiedergabe.</para>

<variablelist>
<varlistentry>
<term><guilabel>Audio aktivieren</guilabel></term>
<listitem><para>Aktiviert die Audiowiedergabe. Ist dieses Ankreuzfeld nicht markiert, so werden
keine Kl&auml;nge bei der Filmwiedergabe abgespielt.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Bilder f&uuml;r Audiosynchronisierung &uuml;berspringen</guilabel></term>
<listitem><para>Markieren Sie dieses Ankreuzfeld, um &aktion; das &Uuml;berspringen von
Einzelbildern des Videofilms zur Synchronisation mit der Audiowiedergabe zu erlauben.
Das kann sinnvoll sein, wenn Sie einen langsamen Computer verwenden und
feststellen, dass Video und Audio in unterschiedlicher Geschwindigkeit ablaufen. H&auml;ufig ist
in einem solchen Fall die Tonspur bereits zu Ende, w&auml;hrend der Videofilm noch l&auml;uft.
Dieses Ankreuzfeld verringert die Qualit&auml;t der Videowiedergabe. Der Qualit&auml;tsverlust ist
allerdings so gering, das er sich, abh&auml;ngig von der Leistungsf&auml;higkeit Ihres Computers und
der Gr&ouml;&szlig;e des Arbeitsspeichers,  zwischen unmerklich und beinahe unmerklich bewegt.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Lautst&auml;rkeregler anzeigen</guilabel></term>
<listitem><para>Markieren Sie dieses Ankreuzfeld, wenn der Lautst&auml;rkeschieberegler dargestellt
werden soll. Standardm&auml;&szlig;ig ist dieses Ankreuzfeld markiert.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Anfangslautst&auml;rke (0-100)</guilabel></term>
<listitem><para>Legt die Lautst&auml;rke fest, mit der &aktion; gestartet wird. &Auml;nderungen des
Lautst&auml;rkereglers beziehen sich auf diese Einstellung. Sie k&ouml;nnen die Drehregler zu einer
&Auml;nderung verwenden oder einen Wert direkt in das Eingabefeld eintragen.
</para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="setup-color">
<title>Einrichtung der <guilabel>Farbe</guilabel></title>

<para>Hier k&ouml;nnen Sie die Farbwiedergabe von &aktion; ver&auml;ndern.</para>

<variablelist>
<varlistentry>
<term><guilabel>Farbzuordnung (f&uuml;r Anzeigen ohne Echtfarben)</guilabel></term>
<listitem><para>Dieser Bereich findet nur Verwendung auf Anzeigen mit einer
geringeren Farbtiefe als der Standard TrueColor (Echtfarben: 16 Bit Farbtiefe).
Falls Sie Probleme mit ungew&ouml;hnlichen oder falschen Videofarben haben, &auml;ndern Sie
diese Einstellungen.</para>

<variablelist>
<varlistentry>
<term><guilabel>Echtfarben auf 322 (statische Farben)</guilabel></term>
<listitem><para>Diese Option veranlasst &aktion; die Farben vor der Darstellung an die
Static322-Farbreferenztafel anzupassen.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Farbreferenztafel</guilabel></term>
<listitem><para>Diese Option veranlasst &aktion;, eine eigene Farbreferenztafel anzulegen.
Sie k&ouml;nnen die Anzahl der Bilder festlegen, die f&uuml;r die Erstellung der Farbtafel gepuffert werden
sollen. Je h&ouml;her dieser Wert ist, desto mehr Speicher ben&ouml;tigt &aktion;. Der Standardwert betr&auml;gt
5 Bilder.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Echtfarben in Graustufen umwandeln</guilabel></term>
<listitem><para>Diese Option veranlasst &aktion;, den Film in Graustufendarstellung umzuwandeln.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Keine</guilabel></term>
<listitem><para>Die Standardoption ist "<guilabel>keine</guilabel>" Farbzuordnung.
Diese Option veranlasst &aktion;, keine Farbzuordnung vorzunehmen. Verwenden Sie die
anderen Optionen nur dann, wenn &aktion; Schwierigkeiten bei der Farbwiedergabe hat.
</para></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Gammawert der Anzeige</guilabel>:</term>
<listitem><para>Legen Sie den Gammawert des Bildschirms fest. Gammawerte gr&ouml;&szlig;er als 1.0
hellen die Darstellung auf.
</para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="setup-scaling">
<title><guilabel>Skalieren</guilabel></title>

<para>Diese Karteikarte enth&auml;lt Einstellungen zur Gr&ouml;&szlig;e der Filmdarstellung.</para>

<variablelist>
<varlistentry>
<term><guilabel>Anzeige-Skalierung</guilabel></term>
<listitem><para>Legt die Anzeigegr&ouml;&szlig;e des Films in Relation zur Originalgr&ouml;&szlig;e fest.
</para>
<para>Sie k&ouml;nnen einen der folgenden Werte ausw&auml;hlen:</para>
<simplelist>
<member>Originalgr&ouml;&szlig;e</member>
<member>Halbiert</member>
<member>Doppelte Gr&ouml;&szlig;e</member>
<member>Maximiert</member>
<member>Ganzer Bildschirm</member>
</simplelist>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Ganzer Bildschirm</guilabel></term>
<listitem><para>Weitere Einstellm&ouml;glichkeiten zur Vollbilddarstellung von Filmen.
</para>
<variablelist>
<varlistentry>
<term><guilabel>XFree86-VidModeExtensions verwenden, falls verf&uuml;gbar</guilabel></term>
<listitem><para>Aktiviert die Vollbilddarstellung. Weitere Informationen finden Sie unter
<link linkend="aktion-fullscreen">Vollbildanzeige von &aktion; verwenden.</link>
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Maus &uuml;bernehmen</guilabel></term>
<listitem><para>&aktion; verwendet die Maus in der Vollbilddarstellung.</para></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="setup-capture">
<title>Einrichtung <guilabel>Bildschirmphoto</guilabel></title>

<para>&aktion; erm&ouml;glicht die Abspeicherung von Einzelbildern des Filmes w&auml;hrend der 
Wiedergabe. Dr&uuml;cken Sie dazu einfach die Taste <keycap>C</keycap> (f&uuml;r <!--quote-->"capture"<!--/quote-->).  
Auf dieser Karteikarte finden Sie Einstellm&ouml;glichkeiten f&uuml;r diese Programmfunktion.
</para>

<variablelist>
<varlistentry>
<term><guilabel>Format der Ausgabedatei</guilabel>:</term>
<listitem><para>Legen Sie das Ausgabedateiformat des Bildschirmphotos fest. Sie k&ouml;nnen unter
folgenden Formaten w&auml;hlen:</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>Die Standardeinstellung ist PNG</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Verzeichnis der Ausgabedatei</guilabel>:</term>
<listitem><para>Hier k&ouml;nnen Sie das Verzeichnis angeben, in dem die Bildschirmphotos 
gespeichert werden. Die Standardeinstellung ist <filename>~</filename> 
(f&uuml;r Ihr pers&ouml;nliches Verzeichnis). Sie k&ouml;nnen einen Dateipfad in das Textfeld eintippen oder
Sie k&ouml;nnen auf <guibutton>...</guibutton> klicken, um einen Dateidialog zu &ouml;ffnen und das
gew&uuml;nschte Verzeichnis auszuw&auml;hlen.
</para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="setup-others">
<title><guilabel>Sonstiges</guilabel></title>

<para>Diese Karteikarte enth&auml;lt verschiedene Einstellungen, die sich keiner der anderen
Karteikarten zuordnen lassen.</para>

<variablelist>
<varlistentry>
<term><guilabel>Video laden</guilabel></term>
<listitem><para>Dieser Abschnitt enth&auml;lt verschiedene Vorgehensweisen von &aktion; zum
Laden von Filmen. Sie k&ouml;nnen eine der folgenden M&ouml;glichkeiten w&auml;hlen:
</para>
<variablelist>
<varlistentry>
<term><guilabel>Animation vorab in Speicher laden</guilabel></term>
<listitem><para>&aktion; l&auml;dt die gesamte Animation in den Arbeitsspeicher, bevor mit der Wiedergabe
begonnen wird.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Animation vorab laden und dekomprimieren</guilabel></term>
<listitem><para>&aktion; l&auml;dt die gesamte Animation in den Arbeitsspeicher und dekomprimiert die
Animation, bevor die Wiedergabe begonnen wird.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Jeden Sektor nur bei Bedarf lesen</guilabel></term>
<listitem><para>&aktion; f&uuml;hrt kein vorheriges Laden der Animation durch, sondern l&auml;dt die Abschnitte
der Animation nach Bedarf von der Festplatte w&auml;hrend der Wiedergabe.</para></listitem>
</varlistentry>
</variablelist>
<para>Die Standardeinstellung ist: <guilabel>Jeden Sektor nur bei Bedarf lesen</guilabel>
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Gemeinsamen Speicher von X11 benutzen</guilabel></term>
<listitem><para>Dieses Ankreuzfeld ist deaktiviert, falls Sie weiter oben
<guilabel>Animation vorab laden und dekomprimieren</guilabel> ausgew&auml;hlt haben. Es ist
standardm&auml;&szlig;ig nicht markiert.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>X11-Multi-Pufferspeicher benutzen</guilabel></term>
<listitem><para>Wenn Sie dieses Ankreuzfeld markieren, verwendet &aktion; X11-Pufferspeicher (falls
vorhanden), um Animationen durch Doppelpufferung zu gl&auml;tten. Dieses Feld ist standardm&auml;&szlig;ig markiert.
</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Pixmap statt Image in X11 benutzen</guilabel></term>
<listitem><para>Wenn Sie dieses Ankreuzfeld markieren, verwendet &aktion; Pixmaps statt Images
in X11. Dieses Ankreuzfeld ist wirkungslos, wenn die Animation gepuffert wird.
</para></listitem> 
</varlistentry>
<varlistentry>
<term><guilabel>Anfangsverzeichnis</guilabel></term>
<listitem><para>Hier k&ouml;nnen Sie ein Standardverzeichnis f&uuml;r Filme festlegen. Es wird angezeigt,
wenn Sie einen neuen Film &ouml;ffnen m&ouml;chten. Sie k&ouml;nnen entweder ein Verzeichnis in das Textfeld
eintragen oder durch klicken auf <guibutton>...</guibutton>
ein Verzeichnis aus dem Dateidialog ausw&auml;hlen. Sie k&ouml;nnen selbstverst&auml;ndlich aus jedem anderen
Verzeichnis einen Film laden. Standardm&auml;&szlig;ig ist dieses Feld leer, sodass &aktion; Ihnen in der Regel
Ihr pers&ouml;nliches Verzeichnis zur Filmauswahl anbietet.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Schleifen-Animation</guilabel></term>
<listitem><para>Wenn Sie dieses Ankreuzfeld markieren, beginnt der Film am Ende der Wiedergabe
automatisch wieder von vorn, solange Sie nicht auf den Knopf <guiicon>Halt</guiicon>
klicken.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Video automatisch abspielen</guilabel></term>
<listitem><para>Wenn Sie dieses Ankreuzfeld markieren, startet &aktion; einen Film, sobald Sie ihn
ge&ouml;ffnet haben. Wenn dieses Feld nicht markiert ist, m&uuml;ssen Sie zum Abspielen eines Filmes
auf <guiicon>Abspielen</guiicon> klicken.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Extra XAnim-Parameter</guilabel></term>

<listitem><para>Sie k&ouml;nnen weitere Parameter an das zugrunde liegende Programm
<application>XAnim</application> &uuml;bergeben, indem Sie sie in diesem Textfeld
eintragen.</para></listitem>
</varlistentry>
</variablelist>

</sect2>

</sect1>

</chapter>

<chapter id="developers">
<title>Entwicklerdokumentation f&uuml;r &aktion; (in Englisch)</title>
<para>Anmerkung des &Uuml;bersetzers: Ich habe diesen Teil nicht &uuml;bersetzt, da man f&uuml;r die
Entwicklung von Programmen wohl sowieso nicht um die englische Sprache 
herumkommt und sich das allermeiste auch nicht &uuml;bersetzen l&auml;sst (<abbrev>z.B.</abbrev>
Methodenbezeichner). Besteht dennoch der Wunsch nach einer &Uuml;bersetzung, bitte ich um
eine Mitteilung.
</para>

<para>&aktion; includes the <classname>KXAnim</classname> widget wrapper, with it
you can include video playback in your own programs.</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>Ein XAnim-Wrapper, damit Sie das Abspielen von Videos in Ihre Anwendungen integrieren k&ouml;nnen.</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>Detailed Description of <classname>KXAnim</classname></title>

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

<para>Inherits: <classname>QWidget</classname></para>

<para>Widget class for video playing</para>

<para>This widget is an <application>xanim</application> wrapper to easily allow
the video playing on your applications.</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>Constructor. The parent argument is <emphasis>NOT</emphasis>
optional.</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>Use this method to tell the player the name of the file to
play. The file will not start to play until you call the
<function>play()</function> slot. You need to call <function>stop()</function>
before you can set a new filename. </para> 
<para>After call this method, you should wait for an stopped signal. Just then,
the information about the file will be available.</para>
<para>Also check for <returnvalue>KXAnim::getErrorNumber</returnvalue> and
<function>getErrorString</function> to know if there was some
error.</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>If <parameter>val</parameter>==<returnvalue>true</returnvalue>,
the widget will resize by himself after the <function>setFile()</function> to
fit to the size of the video. If
<parameter>val</parameter>==<returnvalue>false</returnvalue>, the video size
will be adjusted to fit to the widget size.</para> 
<para>The size of the widget is automatically updated by
<function>setFile</function> and play But if you need to know the effective size
of the widget *before* you call <function>play</function>, you need to call
<function>updateSize</function> manually.</para>
<para>Default is <returnvalue>true</returnvalue></para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>getAutoResize</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public] </term>
<listitem><para>Returns the auto-resize state (see
<function>setAutoResize</function> ).</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>updateSize</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public] </term>
<listitem>
<para>Updates the widget size to fit video size (taking care of the scale
factors that applies). See <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>If <parameter>val</parameter>==<returnvalue>true</returnvalue>, the video
will loop forever.</para> 
<para>Default is <returnvalue>true</returnvalue></para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>getLoop</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public] </term>
<listitem><para>Returns the loop state ( see <function>setLoop</function>
).</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>QString <function>getVideoFileName</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public] </term>
<listitem><para>Returns the current video file name (or an empty string, if
there's no video yet).</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>getVideoHeight</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public] </term>
<listitem><para>Returns the video height (in pixels).</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>getVideoWidth</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public] </term>
<listitem><para>Returns the video height (in pixels).</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>float <function>getVideoSpeed</function></funcdef>
<paramdef></paramdef>
</funcprototype></funcsynopsis> [public] </term>
<listitem><para>Returns the video playback speed (in frames per
second).</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>getVideoFrames</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public] </term>
<listitem><para>Returns the number of frames in the video.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>QString <function>getVideoCodec</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public] </term>
<listitem><para>Returns the string that describes the video
codec.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>QString <function>getErrorCode</function></funcdef>
<paramdef></paramdef> 
</funcprototype>
</funcsynopsis> [public] </term>
<listitem><para>Returns the the error code number. You should check this number
after a <function>setFile</function>. If the code is
<returnvalue>zero</returnvalue> , the there were no errors. To get a string
containing a description see
<function>getErrorCode</function>.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>QString <function>getErrorString</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public] </term>
<listitem><para>Returns the string that describes the error during
<function>setFile</function>.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>isPlaying</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public] </term>
<listitem><para>Returns <returnvalue>true</returnvalue> is the video is in play
mode. Otherwise it returns <returnvalue>false</returnvalue>.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>isActive</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public] </term>
<listitem><para>Returns <returnvalue>true</returnvalue> is the video is
active. Otherwise it returns <returnvalue>false</returnvalue>. The widget is
<emphasis>NOT</emphasis> Active only when it's stopped. Therefore, you can use
this method to check if the video is REALLY stopped. </para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>resetXAnimDefaults</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public] </term>
<listitem><para>This method reset all the configuration parameters to their
default values.</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>If <parameter>val</parameter>==<returnvalue>true</returnvalue>,
enables sound output.</para> 
<para>Default is <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>If <parameter>val</parameter>==<returnvalue>true</returnvalue>,
allows <application>xanim</application> skip video frames for audio sync.</para>
<para>Default is <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>Sets the initial audio volume.</para>
<para>Default is <returnvalue>40</returnvalue></para></listitem>
</varlistentry>

<varlistentry>
<term>
<!-- Lauri: find out how to do this one!! -->
enum colorMap ( static332, lookupTable, grayScale, none ) [public]
</term><listitem>
<para>See 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>Tells <classname>KXAnim</classname> which type of color mapping
to use for non truecolor displays.</para>
<para>If
<parameter>val</parameter>==<returnvalue>KXAnim::static322</returnvalue>,
<application>xanim</application> will convert truecolor anims to
static322.</para>
<para>If
<parameter>val</parameter>==<returnvalue>KXAnim::lookupTable</returnvalue>,
<application>xanim</application> will sample the color of truecolor animations
ahead of time and forms a color lookup table.</para>
<para>If
<parameter>val</parameter>==<returnvalue>KXAnim::grayScale</returnvalue>,
<application>xanim</application> will convert TrueColor animations to gray
scale.</para>
<para>Those three option are ignored for TrueColor and DirectColor
displays.</para>
<para>if <parameter>val</parameter>==<returnvalue>KXAnim::none</returnvalue>,
<application>xanim</application> will use the default color mapping.</para>
<para>Default is <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>This sets the number of frames ahead to use for the look up
table when using <returnvalue>KXAnim::lookupTable</returnvalue> in
<function>setColorMapping</function>.</para>
<para>Default is <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>Set gamma of display. Gamma's greater than 1.0 typically
brighten the animation.</para>
<para>Default is <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>If <parameter>val</parameter>==<returnvalue>true</returnvalue>,
the video size can be changed "on the fly".</para>
<para>Default is <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>Scale the size of anim by "<parameter>val</parameter>" before
displaying.</para>
<para>Default is <returnvalue>1.0</returnvalue> (no scaling)</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>Scale the horizontal size of anim by
"<parameter>val</parameter>" before displaying.</para>
<para>Default is <returnvalue>1.0</returnvalue> (no scaling)</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>Scale the vertical size of anim by "<parameter>val</parameter>"
before displaying.</para>
<para>Default is <returnvalue>1.0</returnvalue> (no scaling)</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>Scale the animation to have width "<parameter>val</parameter>"
before displaying.</para>
<para>Default is <returnvalue>0</returnvalue> (no scaling)</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>Scale the animation to have height "<parameter>val</parameter>"
before displaying.</para>
<para>Default is <returnvalue>0</returnvalue> (no scaling)</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>Copy display scaling factors to buffering scaling
factors.</para>
<para>Default is <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>Scale the size of anim by "<parameter>val</parameter>" before
buffering it.</para>
<para>Default is <returnvalue>1.0</returnvalue> (no scaling)</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>Scale the horizontal size of anim by
"<parameter>val</parameter>" before buffering it.</para>
<para>Default is <returnvalue>1.0</returnvalue> (no scaling)</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>Scale the vertical size of anim by "<parameter>val</parameter>"
before buffering it.</para>
<para>Default is <returnvalue>1.0</returnvalue> (no scaling)</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>Scale the animation to have width "<parameter>val</parameter>"
before buffering it.</para>
<para>Default is <returnvalue>0</returnvalue> (no scaling)</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>Scale the animation to have height "<parameter>val</parameter>"
before buffering it.</para>
<para>Default is <returnvalue>0</returnvalue> (no scaling)</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>Copy buffering scaling factors to display scaling
factors.</para>
<para>Default is <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> will
load the entire video into memory.</para>
<para><returnvalue>1</returnvalue>: <classname>KXAnim</classname> will load and
decompress the animation entirely into memory before displaying.</para>
<para><returnvalue>2</returnvalue>: <classname>KXAnim</classname> will read each
sector only when needed</para>
<para>Default is <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>If <parameter>val</parameter>==<returnvalue>true</returnvalue>,
<classname>KXAnim</classname> will use X11 shared memory (this is mutually
exclusive with <function>setPreload</function> .</para>
<para>Default is <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>If <parameter>val</parameter>==<returnvalue>true</returnvalue>,
<classname>KXAnim</classname> will use X11 Buffering (if present) to smooth
animations by double-buffering. </para> 
<para>Default is <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>If <parameter>val</parameter>==<returnvalue>true</returnvalue>,
<classname>KXAnim</classname> will use Pixmap instead of Image in
X11shared. This option has no effect if the animation is buffered.</para>
<para>Default is <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>Select the best "X11 Visual of Class..." when displaying the
animation. val can be anyone of the following strings and is case
insensitive:</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>Default is "<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>This will pause <application>XAnim</application> at frame
"<parameter>val</parameter>".
<parameter>val</parameter>=<returnvalue>-1</returnvalue> disables this
option.</para>
<para>Default is <returnvalue>-1</returnvalue> (no pause).</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>Use this method to pass any extra parameters you want to
<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>Use this method to set the executable name for
<application>xanim</application>. Default is "<returnvalue>xanim</returnvalue>",
but you can change it, for instance, if you don't have
<application>xanim</application> in the path.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>play</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public slot] </term>
<listitem><para>Start playing the video.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>pause</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public slot] </term>
<listitem><para>Pauses the video playing (<application>xanim</application> is
still runnig).</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>stop</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public slot] </term>
<listitem><para>Stops the video and exit <application>xanim</application> (don't
worry about it, it's transparent for the class user).</para>
<note><para>Calling this slot doesn't mean that the video will stop
immediately. Use the <returnvalue>stopped</returnvalue> signal to know exactly
when the player is set to the inactive mode (see <function>isActive</function>
). </para></note></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>stepForward</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public slot] </term>
<listitem><para>Single step forward one frame. Pauses the video
playing.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>stepBack</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public slot] </term>
<listitem><para>Single step back one frame. Pauses the video
playing.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>stepForwardWA</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public slot] </term>
<listitem><para>Single step forward one frame staying with anim. Pauses the
video playing.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>stepBackWA</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public slot] </term>
<listitem><para>Single step back one frame staying with anim. Pauses the video
playing.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>toggleSound</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public slot] </term>
<listitem><para>Toggle sound between ON/OFF.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>volumeIncrement</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public slot] </term>
<listitem><para>Increment volume by 1.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>volumeDecrement</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public slot] </term>
<listitem><para>Decrement volume by 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>Setup volume where <parameter>v</parameter> is a number from
<returnvalue>0</returnvalue> to
<returnvalue>100</returnvalue>.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>faster</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public slot] </term>
<listitem><para>Increase animation playback speed.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>slower</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public slot] </term>
<listitem><para>Decrease animation playback speed.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>resetSpeed</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [public slot] </term>
<listitem><para>Reset animation playback speed to original
values.</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>Don't use it!</emphasis> This is internally used for
the communication with <application>xanim</application>.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>stopped</function></funcdef>
<paramdef></paramdef>
</funcprototype>
</funcsynopsis> [signal] </term>
<listitem><para>This signal is emitted after a call to the
<function>stop()</function> slot, and means that the player has
<emphasis>really</emphasis> stopped playing (that
<application>xanim</application> is inactive) (see
<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>This signal is emitted when the user clicks into the
widget.</para></listitem> 
</varlistentry>
</variablelist>
</refsect1>

</refentry>

  </chapter>

  <chapter id="faq">
    <title>Fragen und Antworten</title>

    <qandaset>
      <qandaentry>
	<question><para>Was bedeutet die Meldung "Nicht unterst&uuml;tzter Video-Codec"?
</para></question>
	<answer><para>Das Videoformat kann nicht angezeigt werden. Der Grund daf&uuml;r kann 
sein, dass Sie <application>xanim</application> nicht mit allen Funktionen installiert haben. Weitere
 Details erfahren Sie in der n&auml;chsten Antwort.</para>

	  <para>Einige Codecs werden auch in der n&auml;chsten Zukunft nicht unterst&uuml;tzt werden. Der wichtigste
davon ist der Sorenson-Codec, der in QuickTime 4 verwendet wird.</para></answer>
</qandaentry>

<qandaentry>
<question><para>Wie installiere ich <application>xanim</application> mit allen Funktionen?</para>
</question>
<answer><para>Begeben Sie sich zur <application>xanim-Homepage</application>
und befolgen Sie dort die Hinweise zur Installation der Codecs Cinepak, Indeo und Creative Video.
Eventuell m&uuml;ssen Sie <application>xanim</application> neu &uuml;bersetzen.
Lesen Sie die Dokumentation, die mitgeliefert wird, da die Installation der Codecs unterschiedlich kompliziert
ist.</para></answer>
</qandaentry>

<qandaentry>
<question><para>Wie erkenne ich, ob die VidMode- und DGA-Erweiterungen auf meinem System
verf&uuml;gbar sind?</para>
</question>
<answer><para>Es gibt zwei M&ouml;glichkeiten. Welche davon zutrifft, h&auml;ngt davon ab, auf welche Art
Sie &aktion; installiert haben.</para>
<variablelist>
<varlistentry>
<term>Installation von &aktion; aus den Quelltexten</term>
<listitem><para>&Uuml;berpr&uuml;fen Sie die Meldungen von <command>./configure</command>. Es sollte
eine Meldung <computeroutput>"checking for VidMode extensions..."</computeroutput> geben.
Wenn das Skript ein <computeroutput>"no"</computeroutput> ausgibt, dann sind die
Erweiterungen nicht verf&uuml;gbar.</para></listitem>
</varlistentry>
<varlistentry>
<term>Installation von &aktion; aus einer Bin&auml;rdistribution (rpm oder deb)</term>
<listitem><para>Suche Sie auf Ihrem System die zwei Dateien
<filename>libXxf86vm.a</filename> und <filename>libXxf86dga.a</filename>. Falls Sie
vorhanden sind, ist alles in Ordnung.</para></listitem>
</varlistentry>
</variablelist>
<para>F&uuml;r beide F&auml;lle gilt: Falls die Erweiterungen nicht vorhanden sind, m&uuml;ssen Sie das Paket
XFree86-devel.rpm Ihrer Linux-Distribution installieren. Die Erweiterungen sind in diesem Paket 
enthalten.</para></answer>
</qandaentry>

<qandaentry>
<question><para>Woran merke ich, dass die VidMode-Erweiterungen funktionieren?</para></question>
<answer><para>Versuchen Sie den Bildschirmmodus durch dr&uuml;cken von
<keycombo><keycap>CTRL</keycap><keycap>ALT</keycap><keycap>Ziffernblock
+</keycap></keycombo> umzuschalten. Falls nichts passiert, m&uuml;ssen Sie vermutlich weitere
Bildschirmaufl&ouml;sungen definieren. Weitere Details dazu in der n&auml;chsten Antwort.
</para></answer>
</qandaentry>

<qandaentry>
<question><para>Wie definiere ich weitere Bildschirmaufl&ouml;sungen?</para></question>
<answer><para>Ihre Distribution sollte ein Bildschirmkonfigurationsprogramm enthalten. Falls nicht,
k&ouml;nnen Sie immer <application>XF86Config</application> verwenden.</para>

<para>Aktivieren Sie so viele Bildschirmaufl&ouml;sungen wie m&ouml;glich, mindestens aber die Aufl&ouml;sung
640x400 zus&auml;tzlich zu Ihrer Standardaufl&ouml;sung.</para></answer>
      </qandaentry>
    </qandaset>
  </chapter>

  <chapter id="credits">

    <title>Mitwirkende und Lizenz</title>

    <para>&aktion;</para>

    <para>Programm Copyright 2000 Guillermo P. Marotte
<email>g-marotte@usa.net</email></para>

    <para>Mitwirkende:</para>
    <itemizedlist>
      <listitem><para>Benjamin Sher <email>sher07@bellsouth.net</email></para></listitem>
    </itemizedlist>
    
    <para>Xanim Autor:</para>
    <itemizedlist><listitem><para>Mark Podlipec</para></listitem>
    </itemizedlist>

    <para>Dokumentation Copyright 2000 Chris D. Corbettis
<email>chris@corbettis.fsnet.co.uk</email></para>

    <para>Deutsche &Uuml;bersetzung Frank Sch&uuml;tte 
<email>F.Schuette@t-online.de</email></para>

&underFDL;
&underGPL;

  </chapter>

  <appendix id="installation">
    <title>Installation</title>

    <sect1 id="getting-kapp">
      <title>Wie bekommen Sie &aktion;?</title>

      <para>&aktion; ist Teil des KDE-Projektes <ulink
url="http://www.kde.org">http://www.kde.org</ulink>.  &aktion; geh&ouml;rt zum Paket
kdemultimedia auf <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, 
der Zentralstelle f&uuml;r Dateien des KDE-Projektes.</para>

    </sect1>

    <sect1 id="requirements">
      <title>Voraussetzungen</title>

      <para>&aktion; ben&ouml;tigt KDE 2 und mindestens die Version 2.70.7.0 von
<application>xanim</application>. Vollbild-Darstellung erfordert die
<application>VidMode</application>- und <abbrev>DGA</abbrev>-Erweiterungen zu X11.
</para>

      <para>Alle ben&ouml;tigten Bibliotheken und &aktion; selbst k&ouml;nnen Sie auf der
<ulink url="ftp://ftp.kde.org">&aktion;-Homepage</ulink> und der 
<ulink url="http://xanim.va.pubnix.com/home.html">Xanim-Homepage</ulink> finden.</para>

</sect1>

    <sect1 id="compilation">
      <title>&Uuml;bersetzung und Installation</title>

      <para>Um &aktion; f&uuml;r Ihr System zu &uuml;bersetzen und zu installieren, m&uuml;ssen Sie
folgende Befehle im Hauptverzeichnis der &aktion;-Distribution ausf&uuml;hren:
</para>

      <screen width="40">
<prompt>%</prompt> <command>./configure</command>
<prompt>%</prompt> <command>make</command>
<prompt>%</prompt> <command>make <option>install</option></command>
</screen>

      <para>&aktion; verwendet <application>autoconf</application> und
<application>automake</application>. Daher sollten Sie keine Probleme
haben, &aktion; f&uuml;r Ihr System zu &uuml;bersetzen und zu installieren. Sollten dennoch Probleme
auftreten, setzen Sie sich mit einer der KDE-Mailinglisten in Verbindung.
</para>

    </sect1>

    <sect1 id="configuration">
      <title>Konfiguration</title>

      <para>Vergessen Sie nicht,  <application>xanim</application> vor
&aktion; zu installieren.</para>

    </sect1>

  </appendix>



<![ %addindex; [ &kdedocindex; ]]>
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->
