summaryrefslogtreecommitdiff
path: root/doc/faq
diff options
context:
space:
mode:
Diffstat (limited to 'doc/faq')
-rw-r--r--doc/faq/faq.html470
-rw-r--r--doc/faq/faq.sgml151
-rw-r--r--doc/faq/faq.txt28
3 files changed, 419 insertions, 230 deletions
diff --git a/doc/faq/faq.html b/doc/faq/faq.html
index d2dbf131d..82da42d43 100644
--- a/doc/faq/faq.html
+++ b/doc/faq/faq.html
@@ -4,22 +4,25 @@
>The xine engine FAQ</TITLE
><META
NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
-"></HEAD
+CONTENT="Modular DocBook HTML Stylesheet Version 1.77+"></HEAD
><BODY
CLASS="BOOK"
><DIV
CLASS="BOOK"
><A
-NAME="AEN1"><DIV
+NAME="AEN1"
+></A
+><DIV
CLASS="TITLEPAGE"
><H1
CLASS="TITLE"
><A
-NAME="AEN2">The xine engine FAQ</H1
+NAME="AEN2"
+></A
+>The xine engine FAQ</H1
><P
CLASS="COPYRIGHT"
->Copyright &copy; 2001-2003 by the xine project team</P
+>Copyright &copy; 2001-2003 the xine project team</P
><HR></DIV
><DIV
CLASS="TOC"
@@ -37,32 +40,32 @@ HREF="#GENERAL"
><DL
><DT
><A
-HREF="#AEN10"
+HREF="#ABOUT"
>What is the xine engine?</A
></DT
><DT
><A
-HREF="#AEN13"
+HREF="#SCOPE"
>What's the aim and scope of this text?</A
></DT
><DT
><A
-HREF="#AEN16"
+HREF="#WHERETOGETHELP"
>My question is not yet covered here - where can I ask for help?</A
></DT
><DT
><A
-HREF="#AEN24"
+HREF="#MODULES"
>What are those xine-lib, xine-ui, gxine, ... modules in cvs for?</A
></DT
><DT
><A
-HREF="#AEN33"
+HREF="#CVS"
>Where and how do I get the latest development version?</A
></DT
><DT
><A
-HREF="#AEN45"
+HREF="#BINARIES"
>Where can I find pre-compiled binaries, e.g. RPMs?</A
></DT
></DL
@@ -76,86 +79,81 @@ HREF="#BUILDING"
><DL
><DT
><A
-HREF="#AEN51"
+HREF="#BUILDREQUIREMENTS"
>What do I need to compile everything properly?</A
></DT
><DT
><A
-HREF="#AEN60"
+HREF="#AEN61"
>How do I compile xine?</A
></DT
><DD
><DL
><DT
><A
-HREF="#AEN62"
+HREF="#SIMPLEBUILDINSTR"
>Simple build instructions for beginners</A
></DT
><DT
><A
-HREF="#AEN76"
+HREF="#COMPLETEBUILDINSTR"
>Complete build instructions</A
></DT
></DL
></DD
><DT
><A
-HREF="#AEN87"
+HREF="#RPMBUILD"
>Making your own RPM packages (xine-lib, xine-ui)</A
></DT
><DT
><A
-HREF="#AEN100"
+HREF="#CFLAGS"
>Can I provide additional CFLAGS for compilation?</A
></DT
><DT
><A
-HREF="#AEN106"
+HREF="#ATHLONFLAGS"
>Are there binaries for my AMD K7 (Athlon (TM) ) available? Can I build them?</A
></DT
><DT
><A
-HREF="#AEN110"
+HREF="#AEN111"
>Build problems: xine engine (xine-lib)</A
></DT
><DD
><DL
><DT
><A
-HREF="#AEN112"
+HREF="#DOESNTCOMPILE"
>The package doesn't compile at all!</A
></DT
><DT
><A
-HREF="#AEN117"
+HREF="#XVPLUGINFAILSTOBUILD"
>The Xv video-out plugin fails to compile!</A
></DT
></DL
></DD
><DT
><A
-HREF="#AEN125"
+HREF="#AEN126"
>Build problems: frontend (gxine/xine-ui/...)</A
></DT
><DD
><DL
><DT
><A
-HREF="#AEN127"
+HREF="#XINELIBNOTFOUND"
>I have installed xine-lib but the frontend complains about not finding it!</A
></DT
></DL
></DD
><DT
><A
-HREF="#AEN134"
+HREF="#NONROOTBUILD"
>Can I install xine in my home directory (without being root) ?</A
></DT
-><DT
-><A
-HREF="#AEN145"
-></A
-></DT
></DL
></DD
><DT
@@ -167,75 +165,75 @@ HREF="#PLAYBACK"
><DL
><DT
><A
-HREF="#AEN151"
+HREF="#AEN148"
>DVD Playback with xine</A
></DT
><DD
><DL
><DT
><A
-HREF="#AEN153"
+HREF="#DVDPLAYBACK"
>How do I play back DVDs with xine?</A
></DT
><DT
><A
-HREF="#AEN177"
+HREF="#DVDLONGWAIT"
>DVD playback works, but it takes a long time until playback starts</A
></DT
><DT
><A
-HREF="#AEN183"
+HREF="#REGIONSET"
>I have problems setting up my RPC-2 drive for the right region!</A
></DT
></DL
></DD
><DT
><A
-HREF="#AEN188"
+HREF="#VCDSUPPORT"
>Can I watch Video CDs (VCDs)? SVCDS ? CD-i?</A
></DT
><DT
><A
-HREF="#AEN195"
+HREF="#QUICKTIME"
>Can I watch Quicktime (.mov, .mp4) files using xine?</A
></DT
><DT
><A
-HREF="#AEN202"
+HREF="#AEN199"
>Real Network files/streams</A
></DT
><DD
><DL
><DT
><A
-HREF="#AEN204"
+HREF="#REALFILEPLAYBACK"
>Can I watch Real (.rm, .ram) files using xine ?</A
></DT
><DT
><A
-HREF="#AEN213"
+HREF="#REALNETWORKSTREAMS"
>What about (live) network streams (pnm://, rtsp:// style urls) ?</A
></DT
></DL
></DD
><DT
><A
-HREF="#AEN216"
+HREF="#WMV"
>Can I watch Windows Media (.asf/.wmv) files using xine?</A
></DT
><DT
><A
-HREF="#AEN223"
+HREF="#DVB"
>Can I watch Digital TV (Digital Video Broadcast) using xine ?</A
></DT
><DT
><A
-HREF="#AEN227"
+HREF="#STDIN"
>How do I play streams from STDIN?</A
></DT
><DT
><A
-HREF="#AEN231"
+HREF="#AVISUBTITLES"
>How can I watch files with external AVI subtitles?</A
></DT
></DL
@@ -249,22 +247,22 @@ HREF="#RUNNING"
><DL
><DT
><A
-HREF="#AEN237"
+HREF="#SPEEDUP"
>I have a lot of dropped frames - what can I do?</A
></DT
><DT
><A
-HREF="#AEN294"
+HREF="#PORTS"
>I have problems when using xine on FreeBSD, Solaris, ... !</A
></DT
><DT
><A
-HREF="#AEN298"
+HREF="#AAXINE"
>What is aalib? How do I use it in xine?</A
></DT
><DT
><A
-HREF="#AEN305"
+HREF="#CONFIGOPTIONS"
>What do all these <TT
CLASS="FILENAME"
>~/.xine/config</TT
@@ -284,37 +282,37 @@ HREF="#AUDIO"
><DL
><DT
><A
-HREF="#AEN313"
+HREF="#AUDIODRIVERS"
>What audio drivers does xine support? OSS? Alsa? Arts? Esd?</A
></DT
><DT
><A
-HREF="#AEN316"
+HREF="#COMPRESSOR"
>When I'm watching a movie, the sound effects are much higher volume than the voices</A
></DT
><DT
><A
-HREF="#AEN326"
+HREF="#NOAUDIO"
>When I play this stream, xine shows video but there's no audio!</A
></DT
><DT
><A
-HREF="#AEN334"
+HREF="#SURROUNDSOUND"
>Can xine produce 4-/5-channel surround audio output?</A
></DT
><DT
><A
-HREF="#AEN343"
+HREF="#SPDIF"
>What about ac3 output via spdif to an external ac3 decoder?</A
></DT
><DT
><A
-HREF="#AEN349"
+HREF="#VOLUMECONTROL"
>Changing the volume with the GUI control has no effect! What's up!?</A
></DT
><DT
><A
-HREF="#AEN353"
+HREF="#STUTTERING"
>Audio is stuttering and i see a lot of "metronom: fixing sound card drift by -2115 pts" on the console output</A
></DT
></DL
@@ -328,37 +326,37 @@ HREF="#VIDEO"
><DL
><DT
><A
-HREF="#AEN360"
+HREF="#NOVIDEO"
>I can hear the audio - but I don't see a picture!</A
></DT
><DT
><A
-HREF="#AEN364"
+HREF="#XVEXTENSION"
>How can I make xine use the Xv extension and what drivers do I need?</A
></DT
><DT
><A
-HREF="#AEN399"
+HREF="#COLORKEY"
>Some parts of my X Desktop get transparent when xine plays the video!</A
></DT
><DT
><A
-HREF="#AEN404"
+HREF="#ASPECTRATIO"
>The aspect ratio of the video is wrong!</A
></DT
><DT
><A
-HREF="#AEN407"
+HREF="#DISCARDEDSKIPPED"
>What is the difference between discarded and skipped frames?</A
></DT
><DT
><A
-HREF="#AEN415"
+HREF="#CONTRASTBRIGHTNESSSATURATION"
>My xine is runing in black and white! / I only get a gray video output!</A
></DT
><DT
><A
-HREF="#AEN420"
+HREF="#VIDEODRIVER"
>Which is the best video driver to use?</A
></DT
></DL
@@ -372,47 +370,47 @@ HREF="#ERRORS"
><DL
><DT
><A
-HREF="#AEN429"
+HREF="#AUDIODRIVERERR"
>Starting xine fails with complains about audio drivers/devices!</A
></DT
><DT
><A
-HREF="#AEN436"
+HREF="#NOVIDEOPORTFOUND"
>"no video port found"</A
></DT
><DT
><A
-HREF="#AEN441"
+HREF="#UNABLETOOPENDVDDRIVE"
>"Unable to open dvd drive (/dev/dvd)"</A
></DT
><DT
><A
-HREF="#AEN445"
+HREF="#DEMUXERROR0000"
>"demux error! 00 00 00 (should be 0x000001)"</A
></DT
><DT
><A
-HREF="#AEN450"
+HREF="#OSSFAILED"
>"audio driver 'oss' failed, using null driver instead"</A
></DT
><DT
><A
-HREF="#AEN461"
+HREF="#THROWINGAWARIMAGE"
>"video_out: throwing away image with pts xxx because it's too old"</A
></DT
><DT
><A
-HREF="#AEN464"
+HREF="#NOVIDEOPLUGINAVAILABLE"
>"No video plugin available to decode 'xxxxxx'."</A
></DT
><DT
><A
-HREF="#AEN468"
+HREF="#DEMUXERFAILEDTOSTART"
>"w32codec: decoder failed to start. Is 'xxxxxx' installed?"</A
></DT
><DT
><A
-HREF="#AEN471"
+HREF="#XINECRASHED"
>xine just crashed on me - i didn't get any error message</A
></DT
></DL
@@ -423,13 +421,17 @@ HREF="#AEN471"
CLASS="CHAPTER"
><HR><H1
><A
-NAME="GENERAL">Chapter 1. General questions about xine and this document</H1
+NAME="GENERAL"
+></A
+>Chapter 1. General questions about xine and this document</H1
><DIV
CLASS="SECT1"
><H2
CLASS="SECT1"
><A
-NAME="AEN10">What is the xine engine?</H2
+NAME="ABOUT"
+></A
+>What is the xine engine?</H2
><P
>
The xine engine is a free media player engine. It comes in the form of
@@ -443,7 +445,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN13">What's the aim and scope of this text?</H2
+NAME="SCOPE"
+></A
+>What's the aim and scope of this text?</H2
><P
> The primary goal of this FAQ is to cover all recurring questions related
to the xine engine. Frontend specific questions are not covered here.
@@ -454,7 +458,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN16">My question is not yet covered here - where can I ask for help?</H2
+NAME="WHERETOGETHELP"
+></A
+>My question is not yet covered here - where can I ask for help?</H2
><P
> First of all be sure that your question is really not covered here and
that you haven't just been a bit too lazy to read through all of this
@@ -497,7 +503,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN24">What are those xine-lib, xine-ui, gxine, ... modules in cvs for?</H2
+NAME="MODULES"
+></A
+>What are those xine-lib, xine-ui, gxine, ... modules in cvs for?</H2
><P
> Some time ago xine just became too complex to be just one big program.
Therefore it was split into two major parts.
@@ -528,7 +536,9 @@ NAME="AEN24">What are those xine-lib, xine-ui, gxine, ... modules in cvs for?</H
CLASS="FILENAME"
>xine-plugin</TT
> a mozilla browser plugin
- for streaming media playback using xine, <TT
+ for streaming media playback using xine (at the time of this writing
+ unmaintained and somewhat obsoleted by gxine's browser plugin),
+ <TT
CLASS="FILENAME"
>xine-www</TT
> the
@@ -540,7 +550,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN33">Where and how do I get the latest development version?</H2
+NAME="CVS"
+></A
+>Where and how do I get the latest development version?</H2
><P
> Be advised that end-users should stick to the official xine releases.
CVS is only intended for developers.
@@ -580,14 +592,21 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN45">Where can I find pre-compiled binaries, e.g. RPMs?</H2
+NAME="BINARIES"
+></A
+>Where can I find pre-compiled binaries, e.g. RPMs?</H2
><P
> The xine project does not provide pre-compiled binaries for legal
reasons (some parts of xine may be covered by patents in some countries).
Some OS projects/vendors (e.g. debian, freebsd, ...) offer binaries
for their distributions - please contact them for further info.
You can also find links to third parties providing xine RPMs on
- the xine homepage.
+ the xine homepage :
+ <A
+HREF="http://xine.sf.net/index.php/about"
+TARGET="_top"
+>http://xine.sf.net/index.php/about</A
+>
</P
><P
> See the next chapter of this FAQ for instructions on how to build xine
@@ -599,13 +618,17 @@ NAME="AEN45">Where can I find pre-compiled binaries, e.g. RPMs?</H2
CLASS="CHAPTER"
><HR><H1
><A
-NAME="BUILDING">Chapter 2. Building and installing xine from source </H1
+NAME="BUILDING"
+></A
+>Chapter 2. Building and installing xine from source </H1
><DIV
CLASS="SECT1"
><H2
CLASS="SECT1"
><A
-NAME="AEN51">What do I need to compile everything properly?</H2
+NAME="BUILDREQUIREMENTS"
+></A
+>What do I need to compile everything properly?</H2
><P
> First of all an official and stable release of gcc. Also be aware
that patched gcc versions may break parts of xine and are therefore
@@ -646,13 +669,17 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN60">How do I compile xine?</H2
+NAME="AEN61"
+></A
+>How do I compile xine?</H2
><DIV
CLASS="SECT2"
><H3
CLASS="SECT2"
><A
-NAME="AEN62">Simple build instructions for beginners</H3
+NAME="SIMPLEBUILDINSTR"
+></A
+>Simple build instructions for beginners</H3
><P
> Download the latest xine-lib and gxine/xine-ui tarballs, then follow
these instruction. To unpack a tarball, use:
@@ -740,7 +767,9 @@ CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
-NAME="AEN76">Complete build instructions</H3
+NAME="COMPLETEBUILDINSTR"
+></A
+>Complete build instructions</H3
><P
> The build process is the same for all of the xine modules.
</P
@@ -805,7 +834,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN87">Making your own RPM packages (xine-lib, xine-ui)</H2
+NAME="RPMBUILD"
+></A
+>Making your own RPM packages (xine-lib, xine-ui)</H2
><P
> Basically you will only have to issue one command, if you have just
downloaded a source tarball from our web site:
@@ -852,7 +883,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN100">Can I provide additional CFLAGS for compilation?</H2
+NAME="CFLAGS"
+></A
+>Can I provide additional CFLAGS for compilation?</H2
><P
> Yes, you can do so by setting the CFLAGS variable and then run
configure again.
@@ -873,7 +906,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN106">Are there binaries for my AMD K7 (Athlon (TM) ) available? Can I build them?</H2
+NAME="ATHLONFLAGS"
+></A
+>Are there binaries for my AMD K7 (Athlon (TM) ) available? Can I build them?</H2
><P
> If you have a recent gcc you can try to compile "more" k7 support in (esp.
better instruction scheduling). If the configure script should fail to
@@ -903,13 +938,17 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN110">Build problems: xine engine (xine-lib)</H2
+NAME="AEN111"
+></A
+>Build problems: xine engine (xine-lib)</H2
><DIV
CLASS="SECT2"
><H3
CLASS="SECT2"
><A
-NAME="AEN112">The package doesn't compile at all!</H3
+NAME="DOESNTCOMPILE"
+></A
+>The package doesn't compile at all!</H3
><P
> In order to be able to compile xine-lib, you need (amongst other things)
the zlib compression library plus the appropriate headers, which are
@@ -931,7 +970,9 @@ CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
-NAME="AEN117">The Xv video-out plugin fails to compile!</H3
+NAME="XVPLUGINFAILSTOBUILD"
+></A
+>The Xv video-out plugin fails to compile!</H3
><P
> If you want to have Xv support compiled in, make sure you either have
a shared Xv library on your system, e.g.
@@ -958,8 +999,8 @@ CLASS="PROGRAMLISTING"
>
</P
><P
-> Alternatively you need to have libtool 1.4 or newer installed. If not
- and you only got libXv.a you can create the shared versions yourself:
+> Alternatively you need to have libtool 1.4 or newer installed, then
+ libXv.a is sufficient. Otherwise you can create the shared versions yourself:
<TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
@@ -987,13 +1028,17 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN125">Build problems: frontend (gxine/xine-ui/...)</H2
+NAME="AEN126"
+></A
+>Build problems: frontend (gxine/xine-ui/...)</H2
><DIV
CLASS="SECT2"
><H3
CLASS="SECT2"
><A
-NAME="AEN127">I have installed xine-lib but the frontend complains about not finding it!</H3
+NAME="XINELIBNOTFOUND"
+></A
+>I have installed xine-lib but the frontend complains about not finding it!</H3
><P
> First of all take a closer look at the compilation instructions above again.
You will probably find your answer there right away.
@@ -1023,7 +1068,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN134">Can I install xine in my home directory (without being root) ?</H2
+NAME="NONROOTBUILD"
+></A
+>Can I install xine in my home directory (without being root) ?</H2
><P
> yes. first set up a subdir where you install your private software, eg
</P
@@ -1088,35 +1135,30 @@ CLASS="PROGRAMLISTING"
></TR
></TABLE
></DIV
-><DIV
-CLASS="SECT1"
-><HR><H2
-CLASS="SECT1"
-><A
-NAME="AEN145"></H2
-><P
-> </P
-><P
-> </P
-></DIV
></DIV
><DIV
CLASS="CHAPTER"
><HR><H1
><A
-NAME="PLAYBACK">Chapter 3. Playback of various stream types</H1
+NAME="PLAYBACK"
+></A
+>Chapter 3. Playback of various stream types</H1
><DIV
CLASS="SECT1"
><H2
CLASS="SECT1"
><A
-NAME="AEN151">DVD Playback with xine</H2
+NAME="AEN148"
+></A
+>DVD Playback with xine</H2
><DIV
CLASS="SECT2"
><H3
CLASS="SECT2"
><A
-NAME="AEN153">How do I play back DVDs with xine?</H3
+NAME="DVDPLAYBACK"
+></A
+>How do I play back DVDs with xine?</H3
><P
> Newer xine (1.0.x) releases come with a full-featured
DVD plugin that should be able to handle any unencrypted,
@@ -1232,7 +1274,9 @@ CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
-NAME="AEN177">DVD playback works, but it takes a long time until playback starts</H3
+NAME="DVDLONGWAIT"
+></A
+>DVD playback works, but it takes a long time until playback starts</H3
><P
> This points to a region code problem. Some versions of libdvdcss can play
back DVDs from other regions than the RPC-2 DVD drive is set up for,
@@ -1259,7 +1303,9 @@ CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
-NAME="AEN183">I have problems setting up my RPC-2 drive for the right region!</H3
+NAME="REGIONSET"
+></A
+>I have problems setting up my RPC-2 drive for the right region!</H3
><P
> You can download a tool to set the region code of RPC-Drives here:
<A
@@ -1281,7 +1327,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN188">Can I watch Video CDs (VCDs)? SVCDS ? CD-i?</H2
+NAME="VCDSUPPORT"
+></A
+>Can I watch Video CDs (VCDs)? SVCDS ? CD-i?</H2
><P
> xine supports VCD and SVCD playback out-of-the box. Similar to DVDs,
make sure you have a <TT
@@ -1318,7 +1366,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN195">Can I watch Quicktime (.mov, .mp4) files using xine?</H2
+NAME="QUICKTIME"
+></A
+>Can I watch Quicktime (.mov, .mp4) files using xine?</H2
><P
> Quicktime is just a system layer (container format) which can contain various
different audio and video formats. The system layer itself is fully supported
@@ -1356,13 +1406,17 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN202">Real Network files/streams</H2
+NAME="AEN199"
+></A
+>Real Network files/streams</H2
><DIV
CLASS="SECT2"
><H3
CLASS="SECT2"
><A
-NAME="AEN204">Can I watch Real (.rm, .ram) files using xine ?</H3
+NAME="REALFILEPLAYBACK"
+></A
+>Can I watch Real (.rm, .ram) files using xine ?</H3
><P
> The situation with real files and streams is pretty similar to the situation
with Quicktime Streams (see above). Most newer real audio and video formats
@@ -1404,7 +1458,9 @@ CLASS="SECT2"
><HR><H3
CLASS="SECT2"
><A
-NAME="AEN213">What about (live) network streams (pnm://, rtsp:// style urls) ?</H3
+NAME="REALNETWORKSTREAMS"
+></A
+>What about (live) network streams (pnm://, rtsp:// style urls) ?</H3
><P
> xine supports both pnm and rtsp streaming. However, digging out the actual
pnm/rtsp url can be tricky as they're often packed into heavy JavaScript and
@@ -1424,7 +1480,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN216">Can I watch Windows Media (.asf/.wmv) files using xine?</H2
+NAME="WMV"
+></A
+>Can I watch Windows Media (.asf/.wmv) files using xine?</H2
><P
> While the container format (system layer) ASF (wmv is just an alias)
is fully supported in xine, for newer windows media 8 and 9 based streams
@@ -1459,7 +1517,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN223">Can I watch Digital TV (Digital Video Broadcast) using xine ?</H2
+NAME="DVB"
+></A
+>Can I watch Digital TV (Digital Video Broadcast) using xine ?</H2
><P
> At the time of this writing DVB support is a very new and experimental
feature in xine. The number of supported cards is pretty limited at the moment.
@@ -1474,7 +1534,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN227">How do I play streams from STDIN?</H2
+NAME="STDIN"
+></A
+>How do I play streams from STDIN?</H2
><P
> Use something like:
<TABLE
@@ -1498,7 +1560,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN231">How can I watch files with external AVI subtitles?</H2
+NAME="AVISUBTITLES"
+></A
+>How can I watch files with external AVI subtitles?</H2
><P
> This is not supported in current xine 1.0.x releases (but it is being
actively worked on, so please be patient :) ). In xine 0.9.13
@@ -1524,13 +1588,17 @@ CLASS="PROGRAMLISTING"
CLASS="CHAPTER"
><HR><H1
><A
-NAME="RUNNING">Chapter 4. Running xine </H1
+NAME="RUNNING"
+></A
+>Chapter 4. Running xine </H1
><DIV
CLASS="SECT1"
><H2
CLASS="SECT1"
><A
-NAME="AEN237">I have a lot of dropped frames - what can I do?</H2
+NAME="SPEEDUP"
+></A
+>I have a lot of dropped frames - what can I do?</H2
><P
> Your hardware might be too slow for xine. Make sure you turn on all
speed optimizing options. A few things you should check (in order of
@@ -1651,6 +1719,38 @@ CLASS="PROGRAMLISTING"
></TR
></TABLE
>
+ In some cases where this fails it helps to specify the dma mode
+ to use, for example:
+ <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+> hdparm -d1 -X 66 device_of_your_drive_that_supplies_video_data
+ </PRE
+></TD
+></TR
+></TABLE
+>
+ In RedHat 8.0 an additional entry in /etc/modules.conf
+ <TABLE
+BORDER="0"
+BGCOLOR="#E0E0E0"
+WIDTH="90%"
+><TR
+><TD
+><PRE
+CLASS="PROGRAMLISTING"
+> options ide-cd dma=1
+ </PRE
+></TD
+></TR
+></TABLE
+>
+ should help (reboot for this change to take effect).
</P
><P
> More information about this may be found here:
@@ -1838,7 +1938,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN294">I have problems when using xine on FreeBSD, Solaris, ... !</H2
+NAME="PORTS"
+></A
+>I have problems when using xine on FreeBSD, Solaris, ... !</H2
><P
> Check out the the corresponding README files in the directory <TT
CLASS="FILENAME"
@@ -1851,7 +1953,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN298">What is aalib? How do I use it in xine?</H2
+NAME="AAXINE"
+></A
+>What is aalib? How do I use it in xine?</H2
><P
> aalib is an ascii art library. xine comes with an aalib video output
plugin so you can watch movies in your xterm, on the console or on your
@@ -1891,7 +1995,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN305">What do all these <TT
+NAME="CONFIGOPTIONS"
+></A
+>What do all these <TT
CLASS="FILENAME"
>~/.xine/config</TT
> (<TT
@@ -1914,13 +2020,17 @@ CLASS="FILENAME"
CLASS="CHAPTER"
><HR><H1
><A
-NAME="AUDIO">Chapter 5. Audio related questions </H1
+NAME="AUDIO"
+></A
+>Chapter 5. Audio related questions </H1
><DIV
CLASS="SECT1"
><H2
CLASS="SECT1"
><A
-NAME="AEN313">What audio drivers does xine support? OSS? Alsa? Arts? Esd?</H2
+NAME="AUDIODRIVERS"
+></A
+>What audio drivers does xine support? OSS? Alsa? Arts? Esd?</H2
><P
> Currently xine support audio output via OSS (kernel audio drivers),
ALSA 0.9.x (ALSA 0.5.x is no longer supported), arts (KDE's sound daemon)
@@ -1933,7 +2043,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN316">When I'm watching a movie, the sound effects are much higher volume than the voices</H2
+NAME="COMPRESSOR"
+></A
+>When I'm watching a movie, the sound effects are much higher volume than the voices</H2
><P
> Congratulations, you seem to have an original movie audio track there.
</P
@@ -1983,7 +2095,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN326">When I play this stream, xine shows video but there's no audio!</H2
+NAME="NOAUDIO"
+></A
+>When I play this stream, xine shows video but there's no audio!</H2
><P
> Well, first try a different audio driver (<B
CLASS="COMMAND"
@@ -2015,7 +2129,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN334">Can xine produce 4-/5-channel surround audio output?</H2
+NAME="SURROUNDSOUND"
+></A
+>Can xine produce 4-/5-channel surround audio output?</H2
><P
> Yep, it can do that using OSS or ALSA drivers, provided that the driver
supports it. On startup xine tells you what modes are supported by your
@@ -2082,7 +2198,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN343">What about ac3 output via spdif to an external ac3 decoder?</H2
+NAME="SPDIF"
+></A
+>What about ac3 output via spdif to an external ac3 decoder?</H2
><P
> xine can do that too. Pretty much the same story as for 4-/5-channel
surround (see above). You can either use the config dialog or edit
@@ -2115,7 +2233,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN349">Changing the volume with the GUI control has no effect! What's up!?</H2
+NAME="VOLUMECONTROL"
+></A
+>Changing the volume with the GUI control has no effect! What's up!?</H2
><P
> Some xine drivers do not support volume changing although the GUI
will show the volume bar. Usually this is not xine's fault: aRts C
@@ -2134,7 +2254,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN353">Audio is stuttering and i see a lot of "metronom: fixing sound card drift by -2115 pts" on the console output</H2
+NAME="STUTTERING"
+></A
+>Audio is stuttering and i see a lot of "metronom: fixing sound card drift by -2115 pts" on the console output</H2
><P
> Might be a soundcard problem, if it only comes in longer intervals.
Your soundcard does not keep it's sampling frequency accurately
@@ -2159,13 +2281,17 @@ NAME="AEN353">Audio is stuttering and i see a lot of "metronom: fixing sound car
CLASS="CHAPTER"
><HR><H1
><A
-NAME="VIDEO">Chapter 6. Video related questions </H1
+NAME="VIDEO"
+></A
+>Chapter 6. Video related questions </H1
><DIV
CLASS="SECT1"
><H2
CLASS="SECT1"
><A
-NAME="AEN360">I can hear the audio - but I don't see a picture!</H2
+NAME="NOVIDEO"
+></A
+>I can hear the audio - but I don't see a picture!</H2
><P
> Probably your hardware is simply too slow - see above for some
hints on how to speed things up.
@@ -2180,7 +2306,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN364">How can I make xine use the Xv extension and what drivers do I need?</H2
+NAME="XVEXTENSION"
+></A
+>How can I make xine use the Xv extension and what drivers do I need?</H2
><P
> xine will normally use Xv by default if it is available. In some cases
you might need to choose Xv playback manually (when the <TT
@@ -2312,6 +2440,13 @@ TARGET="_top"
SiliconMotion: certain controllers (more info needed!) have Xv support in Xfree 4.x
</P
></LI
+><LI
+><P
+>
+ Matrox: G200 or newer (but not Parhelia) have Xv support in XFree 4.x.
+ For parhelia, use the binary only drivers available from matrox' website.
+ </P
+></LI
></UL
>
</P
@@ -2321,7 +2456,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN399">Some parts of my X Desktop get transparent when xine plays the video!</H2
+NAME="COLORKEY"
+></A
+>Some parts of my X Desktop get transparent when xine plays the video!</H2
><P
> Looks like some colors on your GUI match the colorkey Xv uses. You can
change the colorkey value to avoid this. There should be a line like:
@@ -2351,7 +2488,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN404">The aspect ratio of the video is wrong!</H2
+NAME="ASPECTRATIO"
+></A
+>The aspect ratio of the video is wrong!</H2
><P
> Try pressing "a" to change the aspect ratio.
</P
@@ -2361,7 +2500,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN407">What is the difference between discarded and skipped frames?</H2
+NAME="DISCARDEDSKIPPED"
+></A
+>What is the difference between discarded and skipped frames?</H2
><P
> Sometimes xine will output a message like that:
<TABLE
@@ -2410,7 +2551,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN415">My xine is runing in black and white! / I only get a gray video output!</H2
+NAME="CONTRASTBRIGHTNESSSATURATION"
+></A
+>My xine is runing in black and white! / I only get a gray video output!</H2
><P
> This frequently happens with new Xv drivers or when switching to a
different video card. Background is that different Xv drivers often
@@ -2431,7 +2574,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN420">Which is the best video driver to use?</H2
+NAME="VIDEODRIVER"
+></A
+>Which is the best video driver to use?</H2
><P
> xine support several video drivers for outputing the image. These will
differ on how the frames are copied to the video card memory, whether
@@ -2467,13 +2612,17 @@ NAME="AEN420">Which is the best video driver to use?</H2
CLASS="CHAPTER"
><HR><H1
><A
-NAME="ERRORS">Chapter 7. Error Messages: What they mean and what you can do</H1
+NAME="ERRORS"
+></A
+>Chapter 7. Error Messages: What they mean and what you can do</H1
><DIV
CLASS="SECT1"
><H2
CLASS="SECT1"
><A
-NAME="AEN429">Starting xine fails with complains about audio drivers/devices!</H2
+NAME="AUDIODRIVERERR"
+></A
+>Starting xine fails with complains about audio drivers/devices!</H2
><P
> You can select the audio driver using the -A option. So try:
<TABLE
@@ -2542,7 +2691,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN436">"no video port found"</H2
+NAME="NOVIDEOPORTFOUND"
+></A
+>"no video port found"</H2
><P
> You got the Xv extension, but your video card driver doesn't support it.
First try to find a driver that does support Xv on your hardware (check
@@ -2573,7 +2724,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN441">"Unable to open dvd drive (/dev/dvd)"</H2
+NAME="UNABLETOOPENDVDDRIVE"
+></A
+>"Unable to open dvd drive (/dev/dvd)"</H2
><P
> You probably don't have /dev/dvd (check that). If so, simply create a
link /dev/dvd that points to your DVD device. Something like...
@@ -2594,6 +2747,11 @@ CLASS="PROGRAMLISTING"
>
...should do the job. Also make sure you have read access on
the device the symlink points to.
+ See the <A
+HREF="#DVDPLAYBACK"
+>dvd playback section</A
+>
+ for more information.
</P
></DIV
><DIV
@@ -2601,7 +2759,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN445">"demux error! 00 00 00 (should be 0x000001)"</H2
+NAME="DEMUXERROR0000"
+></A
+>"demux error! 00 00 00 (should be 0x000001)"</H2
><P
> Probably xine can't access your input source. Most commonly this happens
when you're trying to play locked/encrypted DVDs. Remember that xine
@@ -2622,7 +2782,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN450">"audio driver 'oss' failed, using null driver instead"</H2
+NAME="OSSFAILED"
+></A
+>"audio driver 'oss' failed, using null driver instead"</H2
><P
> First of all, make sure that your OSS Audio drivers are working (i.e.
you can play music with other software). Maybe you're using alsa?
@@ -2697,7 +2859,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN461">"video_out: throwing away image with pts xxx because it's too old"</H2
+NAME="THROWINGAWARIMAGE"
+></A
+>"video_out: throwing away image with pts xxx because it's too old"</H2
><P
> This is a performance related problem.
@@ -2711,7 +2875,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN464">"No video plugin available to decode 'xxxxxx'."</H2
+NAME="NOVIDEOPLUGINAVAILABLE"
+></A
+>"No video plugin available to decode 'xxxxxx'."</H2
><P
> You have tried to play a stream using a unknown or unhandled codec.
Possibly the file uses some obscure proprietary format and no
@@ -2728,7 +2894,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN468">"w32codec: decoder failed to start. Is 'xxxxxx' installed?"</H2
+NAME="DEMUXERFAILEDTOSTART"
+></A
+>"w32codec: decoder failed to start. Is 'xxxxxx' installed?"</H2
><P
> You probably don't have the win32 dll needed to decode this file.
</P
@@ -2738,7 +2906,9 @@ CLASS="SECT1"
><HR><H2
CLASS="SECT1"
><A
-NAME="AEN471">xine just crashed on me - i didn't get any error message</H2
+NAME="XINECRASHED"
+></A
+>xine just crashed on me - i didn't get any error message</H2
><P
> OK, yes, that shouldn't happen and you're upset. We can understand that.
But, to help you and of course to fix this, we need some information.
diff --git a/doc/faq/faq.sgml b/doc/faq/faq.sgml
index a1a2ac07f..cdb2c5afc 100644
--- a/doc/faq/faq.sgml
+++ b/doc/faq/faq.sgml
@@ -17,7 +17,7 @@
<title>General questions about xine and this document</title>
- <sect1>
+ <sect1 id="about">
<title>What is the xine engine?</title>
@@ -30,7 +30,7 @@
</sect1>
- <sect1>
+ <sect1 id="scope">
<title> What's the aim and scope of this text? </title>
@@ -41,7 +41,7 @@
</sect1>
- <sect1>
+ <sect1 id="wheretogethelp">
<title> My question is not yet covered here - where can I ask for help? </title>
@@ -70,7 +70,7 @@
</sect1>
- <sect1>
+ <sect1 id="modules">
<title> What are those xine-lib, xine-ui, gxine, ... modules in cvs for? </title>
@@ -105,13 +105,15 @@
<para>
Other modules in CVS: <filename>xine-plugin</filename> a mozilla browser plugin
- for streaming media playback using xine, <filename>xine-www</filename> the
+ for streaming media playback using xine (at the time of this writing
+ unmaintained and somewhat obsoleted by gxine's browser plugin),
+ <filename>xine-www</filename> the
xine project website sources.
</para>
</sect1>
- <sect1>
+ <sect1 id="cvs">
<title> Where and how do I get the latest development version? </title>
@@ -137,7 +139,7 @@
</sect1>
- <sect1>
+ <sect1 id="binaries">
<title> Where can I find pre-compiled binaries, e.g. RPMs? </title>
@@ -147,7 +149,8 @@
Some OS projects/vendors (e.g. debian, freebsd, ...) offer binaries
for their distributions - please contact them for further info.
You can also find links to third parties providing xine RPMs on
- the xine homepage.
+ the xine homepage :
+ <ulink url="http://xine.sf.net/index.php/about">http://xine.sf.net/index.php/about</ulink>
</para>
<para>
@@ -163,7 +166,7 @@
<title> Building and installing xine from source </title>
- <sect1>
+ <sect1 id="buildrequirements">
<title> What do I need to compile everything properly? </title>
@@ -209,7 +212,7 @@
<title> How do I compile xine? </title>
- <sect2>
+ <sect2 id="simplebuildinstr">
<title> Simple build instructions for beginners </title>
@@ -248,7 +251,7 @@
</sect2>
- <sect2>
+ <sect2 id="completebuildinstr">
<title> Complete build instructions </title>
@@ -288,7 +291,7 @@
</sect1>
- <sect1>
+ <sect1 id="rpmbuild">
<title> Making your own RPM packages (xine-lib, xine-ui) </title>
@@ -325,7 +328,7 @@
</sect1>
- <sect1>
+ <sect1 id="cflags">
<title> Can I provide additional CFLAGS for compilation? </title>
@@ -345,7 +348,7 @@
</sect1>
- <sect1>
+ <sect1 id="athlonflags">
<title> Are there binaries for my AMD K7 (Athlon (TM) ) available? Can I build them? </title>
@@ -370,7 +373,7 @@
<title> Build problems: xine engine (xine-lib) </title>
- <sect2>
+ <sect2 id="doesntcompile">
<title> The package doesn't compile at all! </title>
@@ -389,7 +392,7 @@
</para>
</sect2>
- <sect2>
+ <sect2 id="xvpluginfailstobuild">
<title> The Xv video-out plugin fails to compile! </title>
@@ -406,8 +409,8 @@
</para>
<para>
- Alternatively you need to have libtool 1.4 or newer installed. If not
- and you only got libXv.a you can create the shared versions yourself:
+ Alternatively you need to have libtool 1.4 or newer installed, then
+ libXv.a is sufficient. Otherwise you can create the shared versions yourself:
<programlisting>
ld --whole-archive -shared -o libXv.so.1 libXv.a
ln -s libXv.so.1 libXv.so
@@ -427,7 +430,7 @@
<title> Build problems: frontend (gxine/xine-ui/...) </title>
- <sect2>
+ <sect2 id="xinelibnotfound">
<title> I have installed xine-lib but the frontend complains about not finding it!</title>
@@ -449,7 +452,7 @@
</sect2>
</sect1>
- <sect1>
+ <sect1 id="nonrootbuild">
<title> Can I install xine in my home directory (without being root) ? </title>
@@ -479,19 +482,6 @@
</programlisting>
</sect1>
- <sect1>
-
- <title> </title>
-
- <para>
- </para>
-
- <para>
- </para>
-
- </sect1>
-
-
</chapter>
<chapter id="playback">
@@ -502,7 +492,7 @@
<title>DVD Playback with xine</title>
- <sect2>
+ <sect2 id="dvdplayback">
<title>How do I play back DVDs with xine?</title>
@@ -582,7 +572,7 @@
</sect2>
- <sect2>
+ <sect2 id="dvdlongwait">
<title> DVD playback works, but it takes a long time until playback starts </title>
<para>
This points to a region code problem. Some versions of libdvdcss can play
@@ -605,7 +595,7 @@
</para>
</sect2>
- <sect2>
+ <sect2 id="regionset">
<title> I have problems setting up my RPC-2 drive for the right region! </title>
<para>
You can download a tool to set the region code of RPC-Drives here:
@@ -622,7 +612,7 @@
</sect2>
</sect1>
- <sect1>
+ <sect1 id="vcdsupport">
<title> Can I watch Video CDs (VCDs)? SVCDS ? CD-i?</title>
@@ -647,7 +637,7 @@
</sect1>
- <sect1>
+ <sect1 id="quicktime">
<title> Can I watch Quicktime (.mov, .mp4) files using xine? </title>
@@ -679,7 +669,7 @@
<title> Real Network files/streams </title>
- <sect2>
+ <sect2 id="realfileplayback">
<title> Can I watch Real (.rm, .ram) files using xine ? </title>
<para>
@@ -704,7 +694,7 @@
</sect2>
- <sect2>
+ <sect2 id="realnetworkstreams">
<title> What about (live) network streams (pnm://, rtsp:// style urls) ? </title>
<para>
@@ -724,7 +714,7 @@
</sect1>
- <sect1>
+ <sect1 id="wmv">
<title> Can I watch Windows Media (.asf/.wmv) files using xine? </title>
@@ -749,7 +739,7 @@
</sect1>
- <sect1>
+ <sect1 id="dvb">
<title> Can I watch Digital TV (Digital Video Broadcast) using xine ? </title>
@@ -761,7 +751,7 @@
</sect1>
- <sect1>
+ <sect1 id="stdin">
<title>How do I play streams from STDIN?</title>
@@ -773,7 +763,7 @@
</para>
</sect1>
- <sect1>
+ <sect1 id="avisubtitles">
<title> How can I watch files with external AVI subtitles?</title>
@@ -793,7 +783,7 @@
<title> Running xine </title>
- <sect1>
+ <sect1 id="speedup">
<title>I have a lot of dropped frames - what can I do?</title>
@@ -873,6 +863,16 @@
<programlisting>
hdparm -d1 device_of_your_drive_that_supplies_video_data
</programlisting>
+ In some cases where this fails it helps to specify the dma mode
+ to use, for example:
+ <programlisting>
+ hdparm -d1 -X 66 device_of_your_drive_that_supplies_video_data
+ </programlisting>
+ In RedHat 8.0 an additional entry in /etc/modules.conf
+ <programlisting>
+ options ide-cd dma=1
+ </programlisting>
+ should help (reboot for this change to take effect).
</para>
<para>
More information about this may be found here:
@@ -1000,7 +1000,7 @@
</sect1>
- <sect1>
+ <sect1 id="ports">
<title>I have problems when using xine on FreeBSD, Solaris, ... !</title>
@@ -1010,7 +1010,7 @@
</sect1>
- <sect1>
+ <sect1 id="aaxine">
<title> What is aalib? How do I use it in xine? </title>
@@ -1032,7 +1032,7 @@
</para>
</sect1>
- <sect1>
+ <sect1 id="configoptions">
<title>What do all these <filename>~/.xine/config</filename> (<filename>~/.gxine/config</filename>) entries mean?</title>
@@ -1050,7 +1050,7 @@
<title> Audio related questions </title>
- <sect1>
+ <sect1 id="audiodrivers">
<title>What audio drivers does xine support? OSS? Alsa? Arts? Esd?</title>
@@ -1062,7 +1062,7 @@
</para>
</sect1>
- <sect1>
+ <sect1 id="compressor">
<title> When I'm watching a movie, the sound effects are much higher volume than the voices</title>
@@ -1096,7 +1096,7 @@
</para>
</sect1>
- <sect1>
+ <sect1 id="noaudio">
<title> When I play this stream, xine shows video but there's no audio!</title>
@@ -1117,7 +1117,7 @@
a test stream available somewhere for developers to download and try.
</para>
</sect1>
- <sect1>
+ <sect1 id="surroundsound">
<title>Can xine produce 4-/5-channel surround audio output?</title>
@@ -1154,7 +1154,7 @@
</programlisting>
</para>
</sect1>
- <sect1>
+ <sect1 id="spdif">
<title>What about ac3 output via spdif to an external ac3 decoder?</title>
@@ -1168,7 +1168,7 @@
</programlisting>
</para>
</sect1>
- <sect1>
+ <sect1 id="volumecontrol">
<title>Changing the volume with the GUI control has no effect! What's up!?</title>
@@ -1186,7 +1186,7 @@
</para>
</sect1>
- <sect1>
+ <sect1 id="stuttering">
<title> Audio is stuttering and i see a lot of "metronom: fixing sound card drift by -2115 pts" on the console output </title>
<para>
@@ -1213,7 +1213,7 @@
<chapter id="video">
<title> Video related questions </title>
- <sect1>
+ <sect1 id="novideo">
<title>I can hear the audio - but I don't see a picture!</title>
@@ -1227,7 +1227,7 @@
</para>
</sect1>
- <sect1>
+ <sect1 id="xvextension">
<title>How can I make xine use the Xv extension and what drivers do I need?</title>
@@ -1323,10 +1323,16 @@
SiliconMotion: certain controllers (more info needed!) have Xv support in Xfree 4.x
</para>
</listitem>
+ <listitem>
+ <para>
+ Matrox: G200 or newer (but not Parhelia) have Xv support in XFree 4.x.
+ For parhelia, use the binary only drivers available from matrox' website.
+ </para>
+ </listitem>
</itemizedlist>
</para>
</sect1>
- <sect1>
+ <sect1 id="colorkey">
<title>Some parts of my X Desktop get transparent when xine plays the video!</title>
@@ -1340,7 +1346,7 @@
by xine for the video overlay.
</para>
</sect1>
- <sect1>
+ <sect1 id="aspectratio">
<title>The aspect ratio of the video is wrong!</title>
@@ -1348,7 +1354,7 @@
Try pressing "a" to change the aspect ratio.
</para>
</sect1>
- <sect1>
+ <sect1 id="discardedskipped">
<title>What is the difference between discarded and skipped frames?</title>
@@ -1384,7 +1390,7 @@
never see frames skipped (they would be all discarded).
</para>
</sect1>
- <sect1>
+ <sect1 id="contrastbrightnesssaturation">
<title>My xine is runing in black and white! / I only get a gray video output!</title>
@@ -1404,7 +1410,7 @@
</para>
</sect1>
- <sect1>
+ <sect1 id="videodriver">
<title>Which is the best video driver to use?</title>
@@ -1443,7 +1449,7 @@
<chapter id="errors">
<title> Error Messages: What they mean and what you can do</title>
- <sect1>
+ <sect1 id="audiodrivererr">
<title>Starting xine fails with complains about audio drivers/devices!</title>
@@ -1466,7 +1472,7 @@
</programlisting>
</para>
</sect1>
- <sect1>
+ <sect1 id="novideoportfound">
<title>"no video port found"</title>
@@ -1484,7 +1490,7 @@
</programlisting>
</para>
</sect1>
- <sect1>
+ <sect1 id="unabletoopendvddrive">
<title>"Unable to open dvd drive (/dev/dvd)" </title>
@@ -1497,9 +1503,11 @@
</programlisting>
...should do the job. Also make sure you have read access on
the device the symlink points to.
+ See the <link linkend="dvdplayback">dvd playback section</link>
+ for more information.
</para>
</sect1>
- <sect1>
+ <sect1 id="demuxerror0000">
<title>"demux error! 00 00 00 (should be 0x000001)"</title>
@@ -1518,7 +1526,7 @@
for the right region (see above).
</para>
</sect1>
- <sect1>
+ <sect1 id="ossfailed">
<title>"audio driver 'oss' failed, using null driver instead"</title>
@@ -1563,7 +1571,7 @@
however you will loose the ability to do four/five channel audio output.
</para>
</sect1>
- <sect1>
+ <sect1 id="throwingawarimage">
<title>"video_out: throwing away image with pts xxx because it's too old"</title>
@@ -1575,7 +1583,7 @@
DMA enabled.
</para>
</sect1>
- <sect1>
+ <sect1 id="novideopluginavailable">
<title>"No video plugin available to decode 'xxxxxx'."</title>
@@ -1590,7 +1598,7 @@
quicktime codecs (see above).
</para>
</sect1>
- <sect1>
+ <sect1 id="demuxerfailedtostart">
<title>"w32codec: decoder failed to start. Is 'xxxxxx' installed?"</title>
@@ -1598,7 +1606,7 @@
You probably don't have the win32 dll needed to decode this file.
</para>
</sect1>
- <sect1>
+ <sect1 id="xinecrashed">
<title>xine just crashed on me - i didn't get any error message</title>
@@ -1670,3 +1678,4 @@
</sect1>
</chapter>
+</book>
diff --git a/doc/faq/faq.txt b/doc/faq/faq.txt
index 474abc32a..410f440d7 100644
--- a/doc/faq/faq.txt
+++ b/doc/faq/faq.txt
@@ -1,6 +1,6 @@
The xine engine FAQ
-Copyright © 2001-2003 by the xine project team
+Copyright © 2001-2003 the xine project team
-------------------------------------------------------------------------------
@@ -37,7 +37,6 @@ Table of Contents
it!
Can I install xine in my home directory (without being root) ?
-
3. Playback of various stream types
@@ -160,7 +159,9 @@ If you simply want a media/dvd player, you'll need to install xine-lib first
and then choose and install a player frontend like xine-ui or gxine.
Other modules in CVS: xine-plugin a mozilla browser plugin for streaming media
-playback using xine, xine-www the xine project website sources.
+playback using xine (at the time of this writing unmaintained and somewhat
+obsoleted by gxine's browser plugin), xine-www the xine project website
+sources.
-------------------------------------------------------------------------------
@@ -186,7 +187,7 @@ The xine project does not provide pre-compiled binaries for legal reasons (some
parts of xine may be covered by patents in some countries). Some OS projects/
vendors (e.g. debian, freebsd, ...) offer binaries for their distributions -
please contact them for further info. You can also find links to third parties
-providing xine RPMs on the xine homepage.
+providing xine RPMs on the xine homepage : http://xine.sf.net/index.php/about
See the next chapter of this FAQ for instructions on how to build xine from
source.
@@ -358,8 +359,8 @@ Xv library on your system, e.g. ls /usr/X11R6/lib/libXv* should give you some
/usr/X11R6/lib/libXv.so.1
-Alternatively you need to have libtool 1.4 or newer installed. If not and you
-only got libXv.a you can create the shared versions yourself:
+Alternatively you need to have libtool 1.4 or newer installed, then libXv.a is
+sufficient. Otherwise you can create the shared versions yourself:
ld --whole-archive -shared -o libXv.so.1 libXv.a
ln -s libXv.so.1 libXv.so
ldconfig
@@ -408,8 +409,6 @@ and do a
-------------------------------------------------------------------------------
--------------------------------------------------------------------------------
-
Chapter 3. Playback of various stream types
DVD Playback with xine
@@ -660,6 +659,14 @@ optimizing options. A few things you should check (in order of importance):
You can enable DMA mode with the following command:
hdparm -d1 device_of_your_drive_that_supplies_video_data
+ In some cases where this fails it helps to specify the dma mode to use, for
+ example:
+ hdparm -d1 -X 66 device_of_your_drive_that_supplies_video_data
+
+ In RedHat 8.0 an additional entry in /etc/modules.conf
+ options ide-cd dma=1
+
+ should help (reboot for this change to take effect).
More information about this may be found here: http://oreilly.linux.com/pub
/a/linux/2000/06/29/hdparm.html
@@ -946,6 +953,9 @@ are some hints for individual gfx chips:
* SiliconMotion: certain controllers (more info needed!) have Xv support in
Xfree 4.x
+ * Matrox: G200 or newer (but not Parhelia) have Xv support in XFree 4.x. For
+ parhelia, use the binary only drivers available from matrox' website.
+
-------------------------------------------------------------------------------
Some parts of my X Desktop get transparent when xine plays the video!
@@ -1075,7 +1085,7 @@ You probably don't have /dev/dvd (check that). If so, simply create a link /dev
ln -s hdc dvd
...should do the job. Also make sure you have read access on the device the
-symlink points to.
+symlink points to. See the dvd playback section for more information.
-------------------------------------------------------------------------------