From 8d2216a2097f2df48e4db1548a4303856787bde6 Mon Sep 17 00:00:00 2001 From: Daniel Caujolle-Bert Date: Sat, 21 Jul 2001 23:06:54 +0000 Subject: Move FAQ to doc dir, rename some doc files. All current docs aren't installed by xine-lib but xine-ui. CVS patchset: 318 CVS date: 2001/07/21 23:06:54 --- doc/FAQ | 470 +++++++++++++++++++++++++++++++++++++++++++++++++ doc/FAQ-lib | 75 -------- doc/FAQ-lib_es | 74 -------- doc/FAQ_es | 74 ++++++++ doc/Makefile.am | 4 +- doc/README-lib.solaris | 14 -- doc/README.solaris | 30 ++++ 7 files changed, 576 insertions(+), 165 deletions(-) create mode 100644 doc/FAQ delete mode 100644 doc/FAQ-lib delete mode 100644 doc/FAQ-lib_es create mode 100644 doc/FAQ_es delete mode 100644 doc/README-lib.solaris create mode 100644 doc/README.solaris (limited to 'doc') diff --git a/doc/FAQ b/doc/FAQ new file mode 100644 index 000000000..f426854b7 --- /dev/null +++ b/doc/FAQ @@ -0,0 +1,470 @@ + + ---------------------- + xine FAQ + ---------------------- + + +scope of this FAQ +----------------- + +this FAQ covers xine version 0.5 and newer, it covers both xine-lib +(the xine engine and default plugins) and xine-ui (xlib and console +user interface implementations). + + +how do I build this beast? +-------------------------- + +first make sure you use a stable, official release of gcc to compile. +You can try patched gcc versions, but these are not supported and will +probably not work (pgcc for example is known to make libmpeg break). + +You'll have to use gnu make to compile xine, on most GNU/Linux systems +make is gnu make, on other platforms use "gmake" instead. + +If you want to have Xv support compiled in, make sure you have a shared +Xv library on your system, e.g. ls /usr/X11R6/lib/libXv* should give you +some .so libs, like this: + +/usr/X11R6/lib/libXv.a /usr/X11R6/lib/libXv.so /usr/X11R6/lib/libXv.so.1 + +if you only got libXv.a 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 + +now you should be ready to build xine on your system: + +xine comes in two (official) parts now, xine-lib and xine-ui. + +First you have to build and install xine-lib: + +./cvscompile.sh <--- only neccessary if you checked xine out of CVS +./configure +make +make install + +if you have installed xine-lib to a non-standard prefix, make +sure you have /bin in your PATH and your linker will +find libs in /libs, in bash you can use something like + +export PATH="/bin:$PATH" +export LD_LIBRARY_PATH="/lib:$LD_LIBRARY_PATH" + +to make sure this works. + +Now you can build and install xine-ui, same procedure as for xine-lib: + +./cvscompile.sh <--- only neccessary if you checked xine out of CVS +./configure +make +make install + + +how can I supply additional CFLAGS for the compilation ? +-------------------------------------------------------- + +you can do so by setting the GLOBAL_CFLAGS variable and then run +configure again. + +This can be usefull to specify additional include paths or library +paths to the compiler. Example: + +export GLOBAL_CFLAGS="-I/usr/include -L/home/guenter/xine_libs" + + +are there binaries for my K7 available? Can I build them? +--------------------------------------------------------- + +At the moment we do not provide K7 binaries, since the latest +stable gcc version (2.92.2 at the time of this writing) doesn't +have K7 support. Use the 686 binaries instead. These binaries +should run ok and will use 3DNow! + +If you have a newer gcc you can try to compile "more" k7 support +in (esp. better instruction sheduling). If the configure script +should fail to detect your processor/gcc correctly, try setting the +XINE_BUILD envvar explicitly to a valid description string for +your configuration, e.g. + +export XINE_BUILD=k7-pc-linux-gnu +rm -f config.cache +./cvscompile.sh +make +make install + + +how can I make xine use the Xv extension? +----------------------------------------- + +xine -V Xv foo.mpg + +xine fails with "no video port found" +------------------------------------- + +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 your graphics card vendor). If your driver +has Xv support but you can't get it working, try at a lower +resultion (1024x768 is still enough even for anamorphic mpeg-2). + +If all that fails, you can still use plain X11/XShm + +xine -V XShm foo.vob + + +xine fails complaining about audio drivers/devices +-------------------------------------------------- + +you can select the audio driver using the -A option. So try + +xine -A null + +if you have ALSA drivers installed, try + +xine -A alsa + +if you run ESD, try + +xine -A esd + +if you run artsd, try + +xine -A arts + + +xine displays it's logo but I don't see my video? +------------------------------------------------- + +use the play button of the gui or press RETURN for PLAY. + + +xine plays audio but I don't see a picture +------------------------------------------ + +If you see lot's of "rejected" messages, your hardware isn't +set up right for xine. It might be your sound card doesn't +support the "realtime" feature (xine tests that on startup +so you might want to look at the messages again). Try to +find better drivers then. + +Perhaps your hardware is simply to slow - see "xine drops a +lot of frames" below for speed tips. + + +where should I put the windows codec dlls for xine? +--------------------------------------------------- + +xine uses + +/usr/lib/win32 + +by default to search for dlls, but you can change this in your +.xinerc by editing + +win32_path:/usr/lib/win32 + + +I get this message: demux error! 00 00 00 (should be 0x000001) +-------------------------------------------------------------- + +Probably xine can't access your input source. Most commonly this happens +when you're trying to play locked/encrypted DVDs. Remember that xine +can't play such DVDs out-of-the box (for legal reasons). + +You could use an css-enabled DVD input plugin to avoid this. + +Another reason could be that your (RPC-2) DVD drive isn't set up +for the right region. + + +when I play this stream, xine shows some pictures but there's no audio +---------------------------------------------------------------------- + +Try another audio channel: + +xine -a channel stream.vob + +some .vob files have audio on strange channels (e.g. 3, 7, 10) + + +can xine play (S)VCDs ? +--------------------- + +Yes, use a MRL like + +xine VCD:// + + +xine drops a lot of frames +-------------------------- + +Your hardware is too slow for xine. Make sure you turn on all +speed optimizing options. A few point you should check: + +- use a recent kernel optimized for your hardware + +- use the latest gas/gcc + +- close other applications (use a tool like "top" to find out + what applications are using up CPU power) + +- if you are not using Xv, make sure your display is set up + to 16bpp, not 24 or higher (reduces memory bandwith) + +- make sure the hard drive which supplies the video data + is in DMA mode (if supported) + Under linux, you can use hdparm to check this, for example + + hdparm /dev/hda + + => + ... + using_dma = 1 (on) + + more information about this may be found here: + + http://oreilly.linux.com/pub/a/linux/2000/06/29/hdparm.html + +- xine needs high speed memory access which depends on your chip set. + Make sure you enable all speed-improving options. + + especially the via apollo pro chipset is known to be quite weird, + (most of all on my gigabyte board). If you can't configure the ram + access thoroughly using the bios you might want to try some really + nasty tricks, as explained on (for example) + http://www.overclockers.com/tips105/index03.asp + this website centers around a windows-tool to tweak the chipset, + you can do the same on FreeBSD with pciconf. On some linux + distributions there are similar tools. + + please contact heiko if you have any problems or tips about via + apollo pro chipset tweaking. + +- a nice performance tuning tool can be found here: + + http://powertweak.sourceforge.net + +- enable MTRR support in your kernel. If you are still using XFree 3.x, + you'll have to tell the kernel yourself where the graphics memory is. + You'll find details about that in the linux dvd howto. + + If you're using XFree 4.x enabling MTRR support should be enough. + + Try a cat /proc/mtrr - if the file exists and you find an entry + corresponding to the amount of graphics memory you have, everything + should be fine. + +- set up and use raw devices for dvd access + + raw devices should be available in linux kernel 2.4.x and there + are patches for older kernels available from + + ftp://ftp.kernel.org/pub/linux/kernel/people/sct/raw-io/ + + to use raw devices, first connect a free raw device to your dvd + device, use something like + + raw /dev/raw1 /dev/hdc + + then create a link named "rdvd" pointing to that raw device + + ln -s /dev/raw1 /dev/rdvd + + +now how do I get this Xv extension to work? +------------------------------------------- + +First you need to install/use XFree 4.x. Once you got that you have to +make sure the XFree drivers you're using are supporting Xv on your +hardware. Here are some locations to look for suitable drivers: + +g200/g400 : xfree 4.x supports these out-of-the-box +nvidia cards : www.nvidia.com (the've got binary drivers) +ATI cards : GATOS www.linuxvideo.org/gatos/ +i815 : the latest xfree 4.x code supports these +3dfx (voodoo): the latest xfree 4.x code supports these +savage : http://www.probo.com/timr/savage40.html + + +can xine produce 4-/5-channel surround audio output? +---------------------------------------------------- + +yep, xine 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 audio driver, e.g: + +audio_oss_out : supported modes are mono stereo (4-channel not enabled in .xiner +c) (ac3-pass-through not enabled in .xinerc) + +on this machine 4-channel surround would be possible. However, +since xine cannot detect if there are actually speakers connected +to the additional channels, you'll have to manually enable this mode +in your ~/.xinerc: + +four_channel:1 + + +what about ac3 output via spdif to an external ac3 decoder? +----------------------------------------------------------- + +xine can do that too. Pretty much the same story as for 4-/5-channel +surround here, you'll have to enable it in your ~/.xinerc: + +ac3_pass_through:1 + + +where and how do I get the latest development version? +------------------------------------------------------ + +check it out of our CVS: + +cvs -d :pserver:anonymous@cvs.xine.sourceforge.net:/cvsroot/xine login + + + +cvs -d :pserver:anonymous@cvs.xine.sourceforge.net:/cvsroot/xine co xine-lib +cvs -d :pserver:anonymous@cvs.xine.sourceforge.net:/cvsroot/xine co xine-ui + + + +how do I use the dvd plugin? +---------------------------- + +First of all: +The dvd plugin delivered with xine currently does not support playback +of locked and/or encrypted dvds. You will need external programs +or something like an "improved" xine_dvd_plugin to view these +DVDs with xine directly. Of course you could +play back the decrypted mpeg2 stream (technically speaking) that is the +movie on the dvd with xine with the help of additional programs. +Due to the uncertain legal situation regarding css encryption we do +not include anything of that nature in the xine distribution, nor do +we generally endorse the use of such software (you should check if +the use of such software is legal where you live). +We hope that this situation will change soon. + +For unlocked/unencrypted dvds it is a good idea first to check what +files are on the dvd by mounting it. The files are called something +like .../VIDEO_TS/VTS_xx_x.VOB, where x are numbers. +If you look for the big .VOB files on a dvd these are probably where the +movie is in. Currently we don't support seamless playback of complete +movies - you will have to play back all of its individual parts. + +To play that VOB file use something like + +xine dvd://VTS_xx_x.VOB + +make sure you do not supply any path name (no VIDEO_TS/) and use +capital letters for the file name. + +xine tries to open the dvd using /dev/cdrom. On freebsd this will only +work if you create a symlink to your dvd-devicenode for the time being. + + +unable to open dvd drive (/dev/dvd) +----------------------------------- + +You probalby don't have /dev/dvd (check that). If so, simply +create a link /dev/dvd that points to your DVD device. +Something like + +cd /dev +ln -s hdc dvd + +should do the job. + + +the aspect ratio is wrong! +-------------------------- + +Try pressing "A" to toggle the aspect ratio + + + +how do I play streams from STDIN ? +---------------------------------- + +use something like + +cat stream.mpg | xine stdin://mpeg1 + +or, if you've got an mpeg-2 stream use + +cat stream.vob | xine stdin://mpeg2 + + +how do I change the skin? +------------------------- + +Run xine at least once - it should write it's config file +.xinerc to your home directory. Now edit that file and change +the line "skin:default" to mach the skin you would like to use. + + +how can I change color/brightness/contrast? +------------------------------------------- + +At the moment this is only supported on some Xv drivers. You'll find +three entries like these in our ~/.xinerc: + +brightness:0 +saturation:0 +contrast:128 + +the values and possible ranges depend on your Xv driver so you'll have +to experiment a bit to get a good picture. + + +some parts of my X Desktop get transparent when xine plays the video! +--------------------------------------------------------------------- + +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 + +colorkey:2110 + +to your ~/.xinerc where you can change the color that's used by xine +for the video overlay. + + +i get no sound, but "audio driver 'oss' failed, using null driver instead." +--------------------------------------------------------------------------- + +First of all, make sure that your OSS Audio drivers are working (ie you can +play music with other software). + +The most common reason for this is that some other program is accesing your +audio device. If you're using linux, the command "fuser /dev/dsp" should give +you the PID of the process. + +If you are using GNOME, chances are, that this is caused by ESD. Now you +have two possibilities. Either deactivate ESD (temporarily) by right +clicking on the sound monitor applet and selecting "Place Esound in +standby". Then xine will use OSS audio output. The other method is to make +xine use ESD for audio output with + +xine -A esd + +This may result in more jerkier playback, so the first method is the +preferred one. + + +i have problems when using xine on FreeBSD, Solaris +--------------------------------------------------- + +check out the the corresponding README files in the doc directory + + +i think I found a bug! +---------------------- + +xine is still under heavy developement. Please be patient. +If you got time, please contact us and send us a full bug report. +Please include all xine console output and some details about +your hardware and operating system. + +You can reach us via email: + + Xine Mailing List diff --git a/doc/FAQ-lib b/doc/FAQ-lib deleted file mode 100644 index 3e2e4861f..000000000 --- a/doc/FAQ-lib +++ /dev/null @@ -1,75 +0,0 @@ - - ---------------------- - xine-lib FAQ - ---------------------- - - -how do I build this beast? --------------------------- - -first make sure you use a stable, official release of gcc to compile. -You can try patched gcc versions, but these are not supported and will -probably not work (pgcc for example is known to make libmpeg break). - -./cvscompile.sh <--- only neccessary if you checked xine out of CVS -./configure -make -make install - - -how can I supply additional CFLAGS for the compilation ? --------------------------------------------------------- - -you can do so by setting the GLOBAL_CFLAGS variable and then run -configure again. - -This can be usefull to specify additional include paths or library -paths to the compiler. Example: - -export GLOBAL_CFLAGS="-I/usr/include -L/home/guenter/xine_libs" - - -Are there binaries for my K7 available? Can I build them? ---------------------------------------------------------- - -At the moment we do not provide K7 binaries, since the latest -stable gcc version (2.92.2 at the time of this writing) doesn't -have K7 support. Use the 686 binaries instead. These binaries -should run ok and will use 3DNow! - -If you have a newer gcc you can try to compile "more" k7 support -in (esp. better instruction sheduling). If the configure script -should fail to detect your processor/gcc correctly, try setting the -XINE_BUILD envvar explicitly to a valid description string for -your configuration, e.g. - -export XINE_BUILD=k7-pc-linux-gnu -rm -f config.cache -./autogen.sh -make -make install - - -where and how do I get the latest development version? ------------------------------------------------------- - -check it out of our CVS: - -cvs -d :pserver:anonymous@cvs.xine.sourceforge.net:/cvsroot/xine login - - - -cvs -d :pserver:anonymous@cvs.xine.sourceforge.net:/cvsroot/xine co xine-lib - - -I think I found a bug! ----------------------- - -xine is in it's early developement stages. Please be patient. -If you got time, please contact us and send us a full bug report. -Please include all xine console output and some details about -your hardware and operating system. - -You can reach us via email: - - Xine Mailing List diff --git a/doc/FAQ-lib_es b/doc/FAQ-lib_es deleted file mode 100644 index 45a4eb7c8..000000000 --- a/doc/FAQ-lib_es +++ /dev/null @@ -1,74 +0,0 @@ - - ---------------------- - Xine-lib FAQ - ---------------------- - - -¿ cómo construyo esta bestia ? ------------------------------- - -Primero asegúrese de usar un gcc estable, una bajada oficial del gcc para -compilar. -Puede probar versiones del gcc remendadas (patched), pero estas no son -soportadas y probablemente no funcionen (por ejemplo el pgcc conocido para -hacer libmpeg falla). - -./autogen.sh <--- solo necesario si comprobara Xine sin CVS -./configure -make -make install - - -¿ Como puedo proporcionar los CFLAGS adicionales para la recompilación ? -------------------------------------------------------------------------- - -Puede poner el GLOBAL_CFLAGS variable y configurarlo de nuevo. - -Éste puede ser usado par especificaciones adicionales que incluyan paths o -paths de bibliotecas ( library paths) al recompilar. Ejemplo: - -export GLOBAL_CFLAGS="-I/usr/include -L/home/guenter/xine_libs" - - -¿ Hay binarios disponibles para mi K7 ? ¿ Puedo construirlos ? --------------------------------------------------------------- - -Por el momento nosotros no proporcionamos binarios para el K7, no hay soporte -para K7 desde la última versión estable del gcc (2.92.2 cuando se escribió esto). -Use en cambio los binarios para el 686. ¡Estos binarios funcionan bien y usan -3DNow! - -Si tiene un gcc más nuevo puede intentar compilar par el K7 obteniendo "más" -soporte (especialmente mejor cobertura de instrucciones). Si la configuración -del script falla al detectar su procesador/gcc correctamente pruebe configurar -XINE_BUILD explícitamente para validar la descripción del string para su -configuración por ej.:. - -export XINE_BUILD=k7-pc-linux-gnu -rm -f config.cache -./cvscompile.sh -make -make install - - - -¡ Creo que encontré un error (bug) ! ------------------------------------- - -Xine esta en una fase temprana de desarrollo. Por favor sea paciente. -Si tiene tiempo, por favor contáctenos y envíenos un reporte completo sobre -el error. -Por favor incluya completamente toda la salida de la consola de Xine y algunos -detalles sobre su hardware y sistema operativo. - -Puede localizarnos vía correo electrónico: - - Lista de correo de Xine (Xine Mailing List) - - -*********************************************************************** -*** Nota del traductor: he tratado de mantener la fidelidad del *** -*** artículo original en inglés lo mayor posible, por comentarios *** -*** sobre la traducción, comunicarse con Alfredo J. Delaiti *** -*** alfredodelaiti@netscape.net *** -*********************************************************************** diff --git a/doc/FAQ_es b/doc/FAQ_es new file mode 100644 index 000000000..30d04af35 --- /dev/null +++ b/doc/FAQ_es @@ -0,0 +1,74 @@ + + ---------------------- + Xine-lib FAQ + ---------------------- + + +¿ cómo construyo esta bestia ? +------------------------------ + +Primero asegúrese de usar un gcc estable, una bajada oficial del gcc para +compilar. +Puede probar versiones del gcc remendadas (patched), pero estas no son +soportadas y probablemente no funcionen (por ejemplo el pgcc conocido para +hacer libmpeg falla). + +./cvscompile.sh <--- solo necesario si comprobara Xine sin CVS +./configure +make +make install + + +¿ Como puedo proporcionar los CFLAGS adicionales para la recompilación ? +------------------------------------------------------------------------- + +Puede poner el GLOBAL_CFLAGS variable y configurarlo de nuevo. + +Éste puede ser usado par especificaciones adicionales que incluyan paths o +paths de bibliotecas ( library paths) al recompilar. Ejemplo: + +export GLOBAL_CFLAGS="-I/usr/include -L/home/guenter/xine_libs" + + +¿ Hay binarios disponibles para mi K7 ? ¿ Puedo construirlos ? +-------------------------------------------------------------- + +Por el momento nosotros no proporcionamos binarios para el K7, no hay soporte +para K7 desde la última versión estable del gcc (2.92.2 cuando se escribió esto). +Use en cambio los binarios para el 686. ¡Estos binarios funcionan bien y usan +3DNow! + +Si tiene un gcc más nuevo puede intentar compilar par el K7 obteniendo "más" +soporte (especialmente mejor cobertura de instrucciones). Si la configuración +del script falla al detectar su procesador/gcc correctamente pruebe configurar +XINE_BUILD explícitamente para validar la descripción del string para su +configuración por ej.:. + +export XINE_BUILD=k7-pc-linux-gnu +rm -f config.cache +./cvscompile.sh +make +make install + + + +¡ Creo que encontré un error (bug) ! +------------------------------------ + +Xine esta en una fase temprana de desarrollo. Por favor sea paciente. +Si tiene tiempo, por favor contáctenos y envíenos un reporte completo sobre +el error. +Por favor incluya completamente toda la salida de la consola de Xine y algunos +detalles sobre su hardware y sistema operativo. + +Puede localizarnos vía correo electrónico: + + Lista de correo de Xine (Xine Mailing List) + + +*********************************************************************** +*** Nota del traductor: he tratado de mantener la fidelidad del *** +*** artículo original en inglés lo mayor posible, por comentarios *** +*** sobre la traducción, comunicarse con Alfredo J. Delaiti *** +*** alfredodelaiti@netscape.net *** +*********************************************************************** diff --git a/doc/Makefile.am b/doc/Makefile.am index 4396f0a48..08224940b 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -1,10 +1,10 @@ SUBDIRS = man -EXTRA_DIST = $(docs_DOCS) MRL.txt dataflow.dia xine-lib-API.cfg +EXTRA_DIST = $(docs_DOCS) FAQ FAQ_es MRL.txt README.solaris dataflow.dia xine-lib-API.cfg docdir = $(prefix)/share/doc/xine -docs_DOCS = README-lib.solaris FAQ-lib FAQ-lib_es +docs_DOCS = install-data-local: diff --git a/doc/README-lib.solaris b/doc/README-lib.solaris deleted file mode 100644 index 4926d2e3d..000000000 --- a/doc/README-lib.solaris +++ /dev/null @@ -1,14 +0,0 @@ -building xine-lib on solaris ----------------------------- - -* Compile xine with GNU make (gmake, /opt/sfw/bin/gmake) - -* If you get a "fatal: relocation error" ... "symbol __divdi3: - referenced symbol not found" error when running xine, re-configure - xine-lib with gcc as the linker command (env LD=gcc configure ...) - -* To get VIS accelerated MPEG decoding and colour space conversion - on Solaris SPARC, download and install Sun's mediaLib 2.0, available - here: - - http://www.sun.com/sparc/vis/mediaLib.html diff --git a/doc/README.solaris b/doc/README.solaris new file mode 100644 index 000000000..b177bc3f9 --- /dev/null +++ b/doc/README.solaris @@ -0,0 +1,30 @@ +building xine on solaris +------------------------ + +* Compile xine with GNU make (gmake, /opt/sfw/bin/gmake) + +* If you get a "fatal: relocation error" ... "symbol __divdi3: + referenced symbol not found" error when running xine, re-configure + xine-lib with gcc as the linker command (env LD=gcc configure ...) + +* To get VIS accelerated MPEG decoding and colour space conversion + on Solaris SPARC, download and install Sun's mediaLib 2.0, available + here: + + http://www.sun.com/sparc/vis/mediaLib.html + + +Known Problems +-------------- + +* Can't use MIT shared memory for local video display + + The default value for the maximum allowed shared memory segment size + (1MByte) is very small on solaris. You may want to increase the + max. allowed shared memory segment size. Add the following line to + /etc/system to increase the shmmax parameter to 8MBytes: + + set shmsys:shminfo_shmmax=8388608 + + Reboot the machine after modifying /etc/system to activate the new + default. -- cgit v1.2.3