Sophie

Sophie

distrib > Mandriva > 8.2 > i586 > by-pkgid > e8d08eb3cff1436007bbb219942ba67b > files > 8

xine-dvdnav-0.9.8-0.beta.1mdk.i586.rpm

xine_dvdnav - DVD Navigator plugin for Xine

Introduction
~~~~~~~~~~~~

This is the Xine-DVDNAV plugin for the Xine media player. Its aim is to
add the full compliment of advanced DVD features to Xine, including branching,
menus and angles.

Currently the plugin is in a beta phase being mostly feature complete.

Updates to this plugin normally go hand-in-hand with updates to Xine itself
so normally one should fetch the latest xine-lib and xine-ui from Xine's
CVS. Releases of the plugin follow the same versioning scheme as Xine itself,
so if you have version x.y.z of Xine, the x.y.z release of the dvdnav plugin
should work with it.

This plugin WILL NOT WORK with versions of Xine 0.4.x and below.

Please see KNOWN-BUGS for current issues before posting bug reports to the 
list.

Also, if you are worried that this plugin allows you to view encrypted content
on DVDs, please read the IMPORTANT_README file.

Software  Requirements
~~~~~~~~~~~~~~~~~~~~~~

 * A version of xine-lib and xine-ui which matches the version number of this
   release.
 * libdvdread (0.9.0 or higher recommended) which may be downloaded from
   http://www.dtek.chalmers.se/groups/dvd/downloads.shtml
 * For CSS-decryption, a copy of libdvdcss from the VideoLan project's
   homepage (http://www.videolan.org/).


Usage
~~~~~

The plugin adds the 'dvdnav://' MRL-type to Xine. To launch Xine from the
command line and make it play the DVD in /dev/dvd fullscreen, simply use

  $ xine -f -g -pq dvdnav://

Alternatively, start Xine, click on the 'NAV' button and press 'play'.

If all goes well, any copyright notices on the DVD will be displayed followed
by the main DVD menu. You can move the mouse to move the highlight and
clicking the mouse will activate the currently highlighted button.

Alternatively, you may use the KEYPAD arrowkeys to move the highlight and
KEYPAD Enter to select the currently highlighted button.

The default keybindings of xine-ui provide the following features:

 * Keypad 9/3 -- Next/previous chapter (ensure NumLock is on).
 * Keypad 7/1 -- Next/previous angle (ensure NumLock is on).

If you look at the Xine GUI, the plugin displays, when appropriate, the
current title, chapter and (if present) angle. The Subtitle and Audio
languages are shown in terms of its two-letter code (e.g. English is
'en', Trad. Chinese is 'zh' and French is 'fr').

Advanced usage
~~~~~~~~~~~~~~

A useful feature of the plugin is the ability to specify a title/chapter
from the MRL. The MRL takes the following form:

  dvdnav://[path to dvd device][:title[.chapter]]

So, for example dvdnav:///dev/dvd2:3.4 would play chapter 4 of title 3 from
the DVD in /dev/dvd2. Note the three '/'s in the MRL.

Acknowledgements
~~~~~~~~~~~~~~~~

The plugin would be next to useless without the great work of the Xine 
project (http://xine.sf.net/).

Portions of this software originated from the Ogle DVD player project
(http://www.dtek.chalmers.se/groups/dvd/) and I hereby thank all the
authors involved in that project.

Copyright
~~~~~~~~~

Copyright (C) 2000,2001 Richard J Wareham
Portions of this code originated from the Ogle and Xine projects.

xine_dvdnav is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

Comments are welcome.

	- Richard J Wareham <richwareham@users.sourceforge.net>