diff options
Diffstat (limited to 'lib/libdvd/libdvdnav/README')
| -rw-r--r-- | lib/libdvd/libdvdnav/README | 57 |
1 files changed, 0 insertions, 57 deletions
diff --git a/lib/libdvd/libdvdnav/README b/lib/libdvd/libdvdnav/README deleted file mode 100644 index de3422c849..0000000000 --- a/lib/libdvd/libdvdnav/README +++ /dev/null @@ -1,57 +0,0 @@ -What is this all about? ------------------------ - -libdvdnav is a library that allows easy use of sophisticated DVD navigation -features such as DVD menus, multiangle playback and even interactive DVD games. -All this functionality is provided through a simple API which provides the -DVD playback as a single logical stream of blocks, intermitted by special -dvdnav events to report certain conditions. The main usage of libdvdnav is a -loop regularly calling a function to get the next block, surrounded by -additional calls to tell the library of user interaction. -The whole DVD virtual machine and internal playback states are completely -encapsulated. - -Where does it come from? ------------------------- - -This library is based on a lot of code and expertise from the Ogle project. -Ogle was the first DVD player who implemented free DVD navigation. The -libdvdnav developers wish to express their gratitude to the Ogle people -for all the valuable research work they have done. - -Initially, the dvdnav code was part of a plugin to the xine media player -called xine-dvdnav. Later on, the DVD VM specific code was split -from xine-dvdnav and went into the first version of libdvdnav. - -Where is it now? ----------------- - -libdvdnav is hosted at http://dvdnav.mplayerhq.hu/ . -Please report bugs to the developers mailinglist at -mailto:dvdnav-discuss@mplayerhq.hu . - -We are still in beta stage, but libdvdnav is already quite usable. With -regular DVD playback, there should not be any serious issues. The library -also makes some limited effort to handle error situations gracefully, but -there are still assertions in the code that may trigger on some DVDs. Please -send a report to the developer mailinglist, if you encounter such problems. - -How can I use it? ------------------ - -libdvdnav is completely licensed under GPL. You may use it at wish within the -bounds of this license. See the file "COPYING" for a copy of the GPL. - -Sources for documentation on libdvdnav are: -* the examples directory contains a simple program using libdvdnav - this one is well-commented and therefore a good starting point -* the public header dvdnav.h documents the API -* the public header dvdnav_events.h documents the dvdnav events -* doc/library_layout contains some info on the internal working of libdvdnav - -Sources for documentation on DVD terminology, structure and surrounding concepts: -* doc/dvd_structures briefly explains DVD terms and organization -* a more detailed description of DVD structures is available at - http://www.mpucoder.com/dvd/ -* the ifo_types.h and nav_types.h headers are also interesting if you - are already used to the sometimes cryptical abbreviations |