Update of /cvsroot/xine/xine-ui/doc In directory sc8-pr-cvs1:/tmp/cvs-serv25482/doc Modified Files: README.en.0.Introduction README.en.10.Remote_control README.en.15.MRLs README.en.20.DVD README.en.30.Advanced README.en.35.Legal_issues README.en.5.xine-ui Log Message: next wave of xine-ui documentation (the last missing chapter is VideoCD now) Index: README.en.0.Introduction =================================================================== RCS file: /cvsroot/xine/xine-ui/doc/README.en.0.Introduction,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- README.en.0.Introduction 27 Oct 2003 11:24:16 -0000 1.1 +++ README.en.0.Introduction 29 Oct 2003 20:56:56 -0000 1.2 @@ -22,7 +22,7 @@ There is also a developer's document available, called the xine hacker's guide. If you are going to help in extending xine or simply want to know, how xine -works inside, have a look at this. You should find it installed in your system +works inside, have a look at this. You should find it installed on your system in HTML form, but you can also browse the latest version at http://xinehq.de/. If all else fails and you still have questions, consult the xine-user mailing Index: README.en.10.Remote_control =================================================================== RCS file: /cvsroot/xine/xine-ui/doc/README.en.10.Remote_control,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- README.en.10.Remote_control 27 Oct 2003 11:24:16 -0000 1.1 +++ README.en.10.Remote_control 29 Oct 2003 20:56:56 -0000 1.2 @@ -35,9 +35,9 @@ It's yours to specify the remote name, and assign the button. -To Retrieve a playlist from a given input plugin, you can use the special -'PlaylistFrom:' keyword, followed by the plugin name (the same as the button -label in the xine panel): +To Retrieve an autoscan playlist from a given input plugin, you can use the +special 'PlaylistFrom:' keyword, followed by the plugin name (the same as the +button label in the xine panel): # Retrieve playlist from DVD plugin. begin Index: README.en.15.MRLs =================================================================== RCS file: /cvsroot/xine/xine-ui/doc/README.en.15.MRLs,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- README.en.15.MRLs 27 Oct 2003 11:24:16 -0000 1.1 +++ README.en.15.MRLs 29 Oct 2003 20:56:56 -0000 1.2 @@ -78,7 +78,7 @@ yourmovie.avi#subtitle:yoursubtitles.srt - plays the specified avi overlaying the + plays the specified avi overlayed with the subtitles from the given file http://some.server.org/stream.mpg#save:savedstream.mpg Index: README.en.20.DVD =================================================================== RCS file: /cvsroot/xine/xine-ui/doc/README.en.20.DVD,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- README.en.20.DVD 27 Oct 2003 11:24:16 -0000 1.1 +++ README.en.20.DVD 29 Oct 2003 20:56:56 -0000 1.2 @@ -1 +1,87 @@ -TODO: short description of the various pitfalls of DVD playback +In theory, DVD playback with xine should work out of the box. If it does for +you, consider yourself lucky and skip over to the next section. There is nothing +interesting for you in here. + +But in a lot of cases, it does not work that easily. This can have various +reasons. At first, make sure xine can find your DVD drive. There should be a +symbolic link called /dev/dvd pointing to the device node of your DVD drive. +When your drive is connected as the first IDE device on the second IDE channel, +this would usually be /dev/hdc. You need to have read and write access to that +device. If your xine installation was prepared for you by the distributor of +your Linux setup, this should all have been taken care of for you, but it is +never a bad idea to double check. +If you do not want to have the symbolic link, you can alternatively change the +config option input.dvd_device accordingly. + +The next set of problems you should be aware of comes with the various +restrictions the DVD officials try to enforce on us. + + +CSS +--- + +Almost all commercial DVDs are encrypted with a system called CSS, Content +Scrambling System. This is a quite weak cryptographic mechanism that was meant +as a way of copy control. Since circumventing copy protection mechanisms is +illegal in some countries, xine does not come with any means to break CSS. +Because of that, you will be unable to play commercial DVDs with an out-of-the- +box version of xine. You should inform yourself about the legal situation of +copy protection and bypassing it in the country you live in. If it is allowed +to you, install libdvdcss and xine will play those DVDs. + + +The region code +--------------- + +From a DVDs point of view, the world is divided into eight regions. The idea is +that drives bought in one region shall only play discs made for that region. +To ensure that, every DVD carries information, in which regions it wants to be +played. + +Older drives are so called RPC-I drives and do not check this region code at +all. If you have such a drive, treat it well and be happy. xine will be able to +play any disc on this planet for you without any trouble. + +Newer drives fall in the RPC-II category. They have an internal region setting, +which is checked against the region code of the DVD you insert. If they match, +everything will work just fine. If they don't it is up to the drive's firmware, +what exactly will happen. Some nicer drives just don't allow you to read the +parts of the disc where the cryptographic keys for CSS are stored. Most likely, +you will still be able to play the disc in that case. But there are more +restrictive drives, which deny any access to the disc. In that case you will be +out of luck. + +With RPC-II drives, it therefore seems to be a good idea to have the drives +internal region setting match that of the DVDs you intend to buy. There is a +Linux command line tool to modify this setting in the drive and the drive even +allows you to change this setting for a limited amount of times, usually five. + +But if you just bought a fresh RPC-II drive, do not be too hasty setting the +region. The factory default might be worth a look. Some drives already come +preset to a specific region. Bad luck, go ahead and set the right code, if the +preset does not fit your needs. But some drives come with a default setting of +region 0. This region does not exist on the globe, it generally means "region +code free". And with some drives you are really lucky, because with the +factory setting of 0, they will behave like RPC-I drives. You should do +everything to keep it that way. Be extremely careful, when using commercial +operating systems on the same machine. Some change the region code without +asking you. But unfortunately, other drives will simply not play any DVD when +set to region 0. This leaves you with no choice but to set the region code to +a setting you see fit. + + +Authentication +-------------- + +Most DVD drives need a step called "authentication" before they grant you access +to a DVD. This is a process, where the software tells the drive what it wants +and the drive decides whether to allow that or not. Unfortunately, this special +negotiation can in rare cases confuse the Linux kernel. Some drives cannot be +authenticated, when they are running in ide-scsi emulation. Others work only in +this mode, while a third group has no problems with either. It seems that USB +drives currently are not supported at all. + + +If you still have questions to these points or experience any problems not +mentioned here, have a look at the xine FAQ. If that still does not help you, +post your question on the xine-user mailinglist. Index: README.en.30.Advanced =================================================================== RCS file: /cvsroot/xine/xine-ui/doc/README.en.30.Advanced,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- README.en.30.Advanced 27 Oct 2003 11:24:16 -0000 1.1 +++ README.en.30.Advanced 29 Oct 2003 20:56:56 -0000 1.2 @@ -1 +1,14 @@ -TODO: pointers to documentation for advanced usage +The more advanced uses of xine will be discussed in separate documents to which +we will point you from here: + +For using xine from command line or controlling it over a network, read the +manpages of xine and xine-remote. + +For watching DVB (Digital Video Broadcast) television with xine, follow the +instructions written in README.dvb in the documentation directory of xine-lib. + +To use your DXR3 or Hollywood+ MPEG decoder card with xine, consult the file +README.dxr3 in the documentation directory of xine-lib. + +To play audio CDs or DVDs over a network, see the file README.network_dvd in the +documentation directory of xine-lib. Index: README.en.35.Legal_issues =================================================================== RCS file: /cvsroot/xine/xine-ui/doc/README.en.35.Legal_issues,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- README.en.35.Legal_issues 27 Oct 2003 11:24:16 -0000 1.1 +++ README.en.35.Legal_issues 29 Oct 2003 20:56:56 -0000 1.2 @@ -26,6 +26,6 @@ the movie industry that they are really annoying and unnecessarily unfair to customers as well as users and developers of free software), but including code to decrypt DVDs in xine won't solve this problem. We therefore invite all xine -users to fight decisions of their governments regarding the ciminalization of +users to fight decisions of their governments regarding the criminalization of DVD playback and fair use of information in general with all available means your legal system provides you with. Index: README.en.5.xine-ui =================================================================== RCS file: /cvsroot/xine/xine-ui/doc/README.en.5.xine-ui,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- README.en.5.xine-ui 27 Oct 2003 11:24:16 -0000 1.1 +++ README.en.5.xine-ui 29 Oct 2003 20:56:56 -0000 1.2 @@ -1 +1,89 @@ -TODO: short and easy introduction to xine-ui +What the user sees as "xine" really consists of two major parts: +* xine-lib or libxine is the so called engine, it contains all of xine's core + functionality like retrieving media from the various input sources supported, + video and audio decoding, synchronized playback and post processing. + This part of xine is only a mere accumulation of functionality, programmers + call this a library. End users cannot use this directly, since there is no + interface to interact with xine-lib. +* The second part is the so called frontend. This wraps a user interface around + xine-lib, making it usable for everyone. + +The benefit of this division is that you can choose between a variety of +different frontends. The one you are using now is known as "xine-ui". Some +interesting features of xine-ui are briefly noted below: + + +The menu +-------- + +All key functions of xine can be accessed through the main xine-ui menu which +you get by right-clicking in either the video window or the panel. +Most of the entries should be self explaining. + + +MRL browser +----------- + +xine's way of describing the media to play are MRLs. You can read more about +this interesting concept in the MRLs section. Due to their power, an ordinary +file selection dialog is not enough to tell xine, what stream to play. The +MRL browser therefore not only allows you to browse through your files, it also +lets you select other types of media input, which offer their own choice of +possible streams to play. You can open the MRL browser with the related icon in +your favourite skin or by selecting Open->Location from the menu. + +An ordinary file dialog is available as well, you can get it at Open->File in +the menu. + + +Playlists +--------- + +xine-ui also handles playlists, of course. The playlist editor, located at +Playlist->Editor or represented by a button in your current skin, allows you to +load, save and edit playlists. The mediamark editor allows you to edit the +current playlist entry in detail and attach further playback options, like a +separate subtitle file. By default, the mediamark editor can be opened by +pressing Ctrl-e. + + +Autoscan buttons +---------------- + +You find the autoscan buttons within the xine panel or in the playlist editor. +They are a shortcut to create a playlist for a certain, well-known media source +and, with the default settings, also starts to play it. For example, pressing +the autoscan button labeled "DVD" will do, what the name suggests: It starts +playing the DVD in your drive by creating a playlist best suited for this job. + + +Post effects +------------ + +xine also offers a growing set of post processing effects you can apply to your +video. From the menu, open Video->Postprocess->Chain reaction to open the Chain +reaction window, where you can create a stack of post effects to be applied to +the video. Choose from the drop down box to select a post filter and select and +modify the available options to tweak it to your liking. Click on "New filter" +to add another effect to the chain. + + +Media menu navigation +--------------------- + +Some types of media are interactive, the most common example today being DVDs, +where you can choose all sorts of options from sometimes quite elaborate menus. +xine offers multiple means to navigate within such interactive content. +* First, you can directly click with your mouse on items in the video window. +* Second, you can use the so called event sender panel, which you can open from + the menu under Menus->Naviagation. +* Third, you can use the menu entries under Menus to jump directly to various + submenus of your interactive medium. This will only have an effect, if the + source you play offers the designated menu. +* And last but not least, you can use the keyboard. By default, the arrow keys + on the numeric keypad will let you move the menu highlight and Enter will + select the highlighted button. + Some other interesting features are also available via the numeric keypad: + (The keys listed are those of the default key mapping.) + PgUp and PgDown will let you jump back and forth between chapters. + Home and End will select the angle to play in multiangle features.
Sign up for the SourceForge newsletter:No, thanks