
  gxine, ein GTK+ Frontend für xine
  ===============================

(C) 2001-2004 Guenter Bartsch
(C) 2004-2007 Darren Salt
(C) 2001-2017 the xine project team

gxine ist unter der GPL veröffentlichte freie Software.


Über
----

gxine ist eine GTK+ basierte grafische Benuztungsoberfläche für die xine-lib
Video-Player Bibliothek.  Es ist ein Medienplayer, der alle Audio/Video-Formate
abspielen kann, die libxine unterstützt.  Mementan beinhaltet dies MPEG1/2,
einige AVI- und Quicktime-Dateien, einige Netzwerk-Streaming-Methoden und
optische Median (VCD, SVCD, DVD).  Eine vollständigere Liste kann unter
http://www.xine-project.org/ gefunden werden.

* Die im folgenden Text referenzierten Beispieldateien können im misc/
  Unterverzeichnis des gxine Quellcodes oder im Dokumentationsverzeichnis
  gefunden werden, typischerweise /usr/share/doc/gxine falls eine Distribution
  verwendet wird.


Allgemeine Benutzung
--------------------

Einige Dinge sind evtl. nicht sofort offensichtlich:

- Die Werkzeugleiste kann durch das Betätigen der mittleren Maustaste über dem
  Videofenster verdeckt und angezeigt werden. (Im Fenstermodus kann dies nur
  über die separate Werkzeugleiste umgeschaltet werden.)

- Die Menüs können immer durch Rechtsklicken im Videofenster aufgerufen werden.

Es wird ein Fenstermanager benötigt, der Vollbildfenster unterstützt. Wenn
einer ohne Unterstützung benutzt wird, funktioniert der Vollbildmodus nicht.


LIRC-Unterstützung
------------------

gxine hat volle LIRC Unterstützung. Eine der folgenden Dateien muß vorhanden,
sein, um LIRC zu benutzen:
  ~/.gxine/lircrc
  ~/.lircrc
Die Dateien werden in dieser Reihenfolge gelesen; Deklarationen werden *nicht*
"uberschrieben.

Eine Beispiel lircrc-Datei ist beigefügt. Diese muß sicherlich angepasst
werden.

gxine kann beliebigen Javascript-Code bei LIRC-Eingaben ausführen :-)


Javascript
----------

gxine läßt sich fast vollständig per Javascript steuern. Tasten können mir
Javascript-Fragmenten (einfache Befehle, Folgen von Befehlen) verknüpft werden.
Für weitere Informationen einfach mal ein Blick auf das Tastenbelegungsfenster
werfen, daß über das Datei-Menü erreichbar ist.

Ab Version 0.5.0 werden auch Startskripte unterstützt: ein globales, ein
benutzerdefiniertes. Beide werden beim Start von gxine ausgeführt; zuerst das
globale.

Hier ist ein Beispiel, das für Fenster- und Vollbildmodus unabhängige
Zoomeinstellungen realisiert. Die Tastenbelegung muß entsprechend geändert
werden.

  // swap_zoom() vorgeschlagene Benutzung:
  //   Fenstermodus:
  //     if (vo_fullscreen.v) swap_zoom (); vo_fullscreen.v = false;
  //   Vollbildmodus:
  //     swap_zoom (); vo_fullscreen.toggle ();
  function swap_zoom ()
  {
    var tmp = vo_zoom.v;
    vo_zoom.v = zoom_other;
    zoom_other = tmp;
  }
  var zoom_other = 100;


VDR-Unterstützung
-----------------

Ab Version 0.4.0 hat gxine VDR-Unterstützung. Zur Benutzung müssen vdr,
vdr-xine und eine angepasste Version von xine-lib vorhanden sein. (Siehe
vdr-xine-Dokumentation für nähere Hinweise.)

Falls ~/.gxine bereits existiert und eine Tastenbelegungsdatei einer älteren
Version von gxine beinhaltet:

 * Die Tastenbelegungen werden automatisch aktualisiert. Jede Belegung mit
   Befehlen, die nicht der Standardeinstellung entspricht oder bereis
   Beschreibungen besitzt (ebenfalls neu in 0.4.0), wird nicht verändert -
   diese müssen selbständig überprüft werden.

 * Es gibt einige neue Belegungen für VDR. Diese werden zur selben Zeit
   hinzugefügt.


GNOME VFS-Unterstützung
-----------------------

Dies steht automatisch zur Verfügung, falls die GNOME VFS-Bibliothek auf dem
momentanen System installiert ist.


GTK Themes
----------

Falls andere Lautsprecher-Icons verwendet werden sollen, müssen knopfgroße
Bilder (normalerweise 20x20) für die Einträge "gxine-media-speaker" und
"gxine-media-speaker-mute" zur Verfügung gestellt werden. Die Richtung,
Größe und Zustand sollten Platzhalter sein.

Das Aussehen der Zeitanzeige und der Informationsleiste werden von den
folgenden Dateien (höchste Priorität zuletzt) beeinflusst:
  gxine's standard-gtkrc-Datei (typischerweise /usr/share/gxine/gtkrc)
  gxine's gtkrc Konfigurationsdatei (typischerweise /etc/gxine/gtkrc)
  ~/.gtkrc-2.0
  ~/.gxine/gtkrc


Werkzeugleisten und Tastenfeldfenster
-------------------------------------

gxine hat drei Dateien, die das Aussehen und den Inhalt der Werkzeugleisten
(Fenster- und Vollbildmodus werden separat gehandhabt) und des
Tastenfeldfensters festlegen. Die Standardvorgabe kann durch folgende Dateien
überschrieben werden:

  ~/.gxine/keypad.xml
  ~/.gxine/toolbar-fullscreen.xml
  ~/.gxine/toolbar-window.xml

Diese Dateien können übersetzbare Beschriftungen und Hinweistexte enthalten;
diesen ist ein "~" vorangestellt. (Wird normalerweise nicht benötig.)

Die Tastenfelddefinition ist eine vollständige Fensterdefinition; die anderen
Definitionen erfordern einen einzigen nicht-Fenster Kontainer an oberster
Stelle. Die Menüleiste und das Videofenster sind feste Bestandteile.

(Eine vollständige Beschreibung dieser Dateien muß noch geschrieben werden.)


Fehlerberichte und Wünsche nach Erweiterungen
---------------------------------------------

* Falls gxine einer Distribution installiert ist:

  Fehlerberichte und Wünsche nach Erweiterungen sollten über die Distribution
  abgewickelt werdeb.

* Falls gxine im Quellcode von Sourceforge installiert ist:

  Zuerst sollte überprüft werden, ob die neuste Version benutzt wird und ob das
  Problem in dieser Version immer noch vorhanden ist. Nur wenn beides zutrifft
  sollten Sie http://bugs.xine-project.org/ besuchen.

* Falls gxine von einer anderen, dritten Quelle installiert ist:

  Kontaktieren Sie den Verwalter dieser Quelle.


Falls das Problem bereits bekannt oder die Erweiterung schon von anderen
gewünscht wird, macht es keinen Sinn, einen weiteren neuen Eintrag anzulegen.
Nur falls weitere Informationen vorliegen, die beim Lösen des Problems helfen
können, sollten diese dem existierenden Eintrag hinzugefügt werden.

Falls Sie sich unsicher sind, können Sie sich an die xine-user-Mailingliste
wenden. (Aber durchsuchen Sie zunächst das Archiv!)
