diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/FAQ-lib | 75 | ||||
| -rw-r--r-- | doc/FAQ-lib_es | 74 | ||||
| -rw-r--r-- | doc/FAQ_es.in | 471 | ||||
| -rw-r--r-- | doc/Makefile.am | 2 | ||||
| -rw-r--r-- | doc/README | 343 | ||||
| -rw-r--r-- | doc/README-lib.solaris | 14 | ||||
| -rw-r--r-- | doc/README.freebsd | 93 | ||||
| -rw-r--r-- | doc/README.solaris | 30 | ||||
| -rw-r--r-- | doc/README.syncfb | 144 | ||||
| -rw-r--r-- | doc/bug_report_form | 62 | ||||
| -rw-r--r-- | doc/man/en/Makefile.am | 6 | ||||
| -rw-r--r-- | doc/man/en/xine-lib.3.in (renamed from doc/man/en/xine.1.in) | 2 | ||||
| -rw-r--r-- | doc/man/fr/Makefile.am | 20 | ||||
| -rw-r--r-- | doc/man/fr/xine-lib.3.in (renamed from doc/man/fr/xine.1.in) | 2 |
14 files changed, 179 insertions, 1159 deletions
diff --git a/doc/FAQ-lib b/doc/FAQ-lib new file mode 100644 index 000000000..3e2e4861f --- /dev/null +++ b/doc/FAQ-lib @@ -0,0 +1,75 @@ + + ---------------------- + 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 + +<empty password> + +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 <xine-user@lists.sourceforge.net> diff --git a/doc/FAQ-lib_es b/doc/FAQ-lib_es new file mode 100644 index 000000000..45a4eb7c8 --- /dev/null +++ b/doc/FAQ-lib_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). + +./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) <xine-user@lists.sourceforge.net> + + +*********************************************************************** +*** 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.in b/doc/FAQ_es.in deleted file mode 100644 index c6df6d67c..000000000 --- a/doc/FAQ_es.in +++ /dev/null @@ -1,471 +0,0 @@ - - ---------------------- - Xine 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 -./autogen.sh -make -make install - - -Xine falla diciendo: "no video port found" (no se encontró puerto de vídeo) ---------------------------------------------------------------------------- - -Usted tiene la extensión de vídeo Xv, pero su driver de la tarjeta de vídeo -no lo soporta. Primero trate de encontrar un driver para sus hardware que -soporte Xv (chequee en su vendedor de su placa de vídeo). Si su driver tiene -soporte para Xv pero no puede hacerlo funcionar, intente bajar más la -resolución (una resolución de 1024x768 es todavía bastante buena para -anamorphic mpeg-2). - -Si todo falla, use la opción "-s" que forzara a Xine a usar la salida con -Xshm (recuerde cambiar la profundidad de color a 16bpp para tener velocidad). - -xine -s foo.vob - - -Xine falla quejándose de los dispositivos/drivers de audio ----------------------------------------------------------- - -Pude seleccionar el driver de audio usando la opción -A . Pruebe así: - -xine -A null - -Si tiene los drivers ALSA instalados, pruebe: - -xine -A alsa - - -¿ Xine muestra su logo pero no veo mi vídeo ? ---------------------------------------------- - -Use el botón de play del reproductor o presione RETORNO ó ENTRADA para -REPRODUCIR. - - -Xine reproduce el audio pero no veo la película ------------------------------------------------ - -Si ve algunos mensajes de "rechazo" , es porque su hardware no esta bien -configurado para Xine. Podría ser que su placa de sonido no soporte las -característica en "tiempo real" (Xine cuando se inicia realiza pruebas, -podría mirar de nuevo estos mensajes que da). Pruebe entonces encontrar los -mejores drivers. - -Tal vez su hardware sea simplemente lento - vea si le da los siguientes -mensajes para la velocidad: "Xine drops a lot of frames" (Xine descartó algunos -cuadros). - -Si esta usando Xv y la salida de vídeo se queda en blanco, pruebe mover la -ventana alrededor de la pantalla o llevarla a pantalla completa (tecla "F"). -Hay una bug (falla) en la configuración del revestimiento [Repárame]. - - -¿ Dónde debo poner lo códigos dlls de windows para Xine ? ---------------------------------------------------------- - -guárdelos en: - -@w32_path@ - -Xine se cuelga cuando intento reproducir archivos AVI ------------------------------------------------------ - -El soporte para los códigos win32 es todavía experimental. Debería funcionar -bien si su sistema reúne esto requisitos: - -- Funciona el driver par Xv -- Los archivos AVI contienen audio en formato mpeg -- Tiene los codecs instalados correctamente en: @w32_path@ - - -Obtengo el siguiente mensaje: demux error! 00 00 00 (should be 0x000001) ------------------------------------------------------------------------- - -Probablemente Xine no puede acceder a su fuente de entrada. La mayoría de las -veces esto pasa cuando está intentado reproducir DVDs cerrados/encriptados -(protección de zona). Recuerde que Xine no puede reproducir estos DVDs de una -< sin tener que hacer ningún otro trabajo> (por razones legales). - -Podría usar una entrada para el DVD con un plugin css-enabled (habilitador css) -para evitar esto. - -Otra razón podría ser que su (RPC-2) de su reproductor de DVD no este ajustado -a la región correcta. - - -Obtengo mensajes como los siguientes: "Ouch! lastPTS : 100657583 current -pts : 100652798" ------------------------------------------------------------------------- - -Apunte sus miradas al driver de su placa de sonido, falla el driver al -proporcionar en tiempo exacto la información. Intente encontrar mejores -drivers (oss <-> alsa). - -Si esta usando alsa, asegúrese de que Xine este usando el alsa nativo API y no -la emulación del oss. Use: - -xine -A alsa - -Me pone lo siguiente varias veces: "200 frames delivered, 200 frames skipped, -0 frames discarded" ("200 cuadros liberados", 200 cuadros saltados, 0 cuadros -descartados") ------------------------------------------------------------------------------ - -Observe que ha seleccionado mal un canal de audio o está intentando reproducir -un stream (secuencia de cuadros) que usa características que Xine no soporta -(por ahora). - - -Cuando reproduzco un stream, Xine muestra algunos cuadros pero no hay sonido ----------------------------------------------------------------------------- - -Pruebe otro canal de sonido: - -xine -a channel stream.vob - -Algunos archivos .vob tienen el sonido en canales extraños (ej. 3, 7, 10) - - -¿ Puede Xine reproducir SVCDs ? -------------------------------- - -Si, pero tendrá que experimentar con los canales de sonido - -xine -a channel VCD://<track number> (número de pista) - -Normalmente, encontrara el canal de sonido en la pista (track) #8 y, para -SVCDs bilingües en la #9, así - -xine -a 8 - -Apretando el botón de "vcd" le permitirá reproducir sus SVCDs - - -Xine pierde algunos de los cuadros ----------------------------------- - -Su hardware es demasiado lento para Xine. Asegúrese de activar todas las -opciones de optimización de velocidad. Unos pocos puntos deberá constatar: - -- usar un kernel reciente optimizado para su hardware - -- usar el último gas/gcc - -- cerrar otras aplicaciones (use una herramienta como "top" para encontrar que - aplicaciones están usando su CPU) - -- si no esta usando Xv, asegúrese de tener ajustada la resolución de la placa - de vídeo en 16bpp y no en 24 o superior (reducen el ancho de banda) - -- asegúrese que la unidad de disco duro que proporciona los datos de vídeo esta - en modo DMA (si lo soporta) - Bajo linux, puede usar hdparm para verificar esto, por ejemplo: - - hdparm /dev/hda - - => - ... - using_dma = 1 (on) - - más información sobre esto la puede encontrará aquí: - - http://oreilly.linux.com/pub/a/linux/2000/06/29/hdparm.html - -- Xine necesita memorias de acceso de alta velocidad que dependen de su chip - set. - Asegúrese de habilitar todas las opciones que permitan mejorar la velocidad. - - Especialmente el chipset via apollo pro es conocido a pesar de ser un poco - raro, (la mayoría de mis motherboard gigabyte). Si no puede configurar la - ram accediendo a la bios podría querer realmente probar algunos trucos sucios, - como explico más adelante (por ejemplo) - http://www.overclockers.com/tips105/index03.asp - este sitio web se centra sobre herramientas bajo Windows para tocar el - chipset, puede hacer lo mismo en FreeBSD con pciconf. En algunas - distribuciones de linux hay herramientas similares. - - Por favor contáctese con Heiko si tiene cualquier problema o consejos sobre - omo tocar el chipset via apollo pro. - -- Una buena herramienta para mejorar el desempeño la puede encontrar aquí: - - http://powertweak.sourceforge.net - -- habilite el soporte para MTRR en su kernel. Si esta usando todavía el XFree - 3.x, tendrá que decirle al kernel donde esta la memoria gráfica. - Encontrará detalles sobre esto en el howto para dvd de linux. - - Si está usando XFree 4.x habilitando el soporte para MTRR debería ser - suficiente. - - Pruebe cat /proc/mtrr - si el archivo existe y encuentra una entrada - correspondiente a la cantidad de memoria que posee su placa de vídeo, todo - debería estar bien. - -- configure y use dispositivos raw para acceder al dvd - - dispositivos raw deben estar disponibles en linux con kernel 2.4.x y hay - parches para kernels viejos disponibles en: - - ftp://ftp.kernel.org/pub/linux/kernel/people/sct/raw-io/ - - para usar dispositivos raw, primero conecte un dispositivo raw libre a su - dispositivo dvd, use algo como: - - raw /dev/raw1 /dev/hdc - - luego cree un enlace (link) llamado "rdvd" que apunte a ese dispositivo raw - - ln -s /dev/raw1 /dev/rdvd - - -¿ Como hago que la extensión Xv trabaje ? ------------------------------------------ - -Primero necesita instalar/usar el XFree 4.x. Una vez que los tenga asegúrese -que los drivers del Xfree que esta usando están soportando Xv en su hardware. -Aquí están algunos lugares donde buscar los drivers convenientes: - -g200/g400 : xfree 4.x suporta a estas de una (sin tener que hacer ningún - otro trabajo) -placas nvidia: www.nvidia.com (tiene los drivers binarios) -placas ATI : GATOS www.linuxvideo.org/gatos/ -i815 : el último código xfree 4.x soporta a estos -3dfx (voodoo): el último código xfree 4.x soporta a estos - - -El AC3 vía S/PDIF no funciona con mi placa de sonido ----------------------------------------------------- - -El AC3 vía S/PDIF es soportado por ALSA solo en placas de sonido con chips -Trident 4DWaveNX y YMF. Entonces si posee una placa de sonido con uno de esos -chips use: - -xine -S -A alsa - -La opción -S deshabilita el decodificador interno AC3. En máquinas muy lentas -puede mejorar la reproducción del vídeo (sacando el sonido) cuando inicializa -Xine con: - -xine -S -A null - - - -¿ Dónde y como obtengo la última versión de desarrollo ? --------------------------------------------------------- - -consulte fuera de nuestra CVS: - -cvs -d :pserver:anonymous@cvs.xine.sourceforge.net:/cvsroot/xine login - -<empty password> - -cvs -d :pserver:anonymous@cvs.xine.sourceforge.net:/cvsroot/xine co xine - - - -¿ Cómo uso el plugin para el dvd ? ----------------------------------- - -Lo primero de todo: -El plugin para dvd entregado actualmente con Xine no soporta la reproducción de -dvds cerrados y/o encriptados. Necesitara programas externos o algo "mejor" -como el Xine_dvd_plugin para ver éstos DVDs directamente con Xine. Por supuesto -podrá reproducir archivos mpeg2 tras la desencriptación (hablando técnicamente) -que es la película en el dvd usando Xine con la ayuda de unos programas -adicionales. -Debido a la situación incierta con respecto al la legalidad de la encriptación -del css nosotros no hemos incluido nada de esta naturaleza en la distribución -de Xine, ni tampoco hacemos apoyo del uso de dicho software (deberá verificar -si el uso de dicho software es legal donde usted vive). -Nosotros esperamos que esta situación cambie pronto. - -Para dvds abiertos/no encriptados es una buena idea primero verificar que -archivos hay en el dvd montándolo. Los archivos se llaman algo así como -.../VIDEO_TS/VTS_xx_x.VOB, donde las x son números. -Si busca los archivos que terminan con mayúsculas .VOB en el dvd, probablemente -estas sean las películas dentro de él. Actualmente no se soporta la unión (de -los capítulos) en la reproducción de las películas - deberá reproducir -individualmente cada una de las partes. - -Para reproducir estos archivos VOB use algo como lo siguiente: - -xine dvd://VTS_xx_x.VOB - -Asegúrese de no proporcionar ningún nombre de camino (no VIDEO_TS/) y use -letras mayúsculas para los nombres de los archivos. - -Xine trata de abrir el dvd usando /dev/cdrom. En freebsd solamente funcionara -por el momento si crea un enlace simbólico entre su dvd y el nodo del -dispositivo. - - -Incapacidad de abrir el dispositivo dvd (/dev/dvd) --------------------------------------------------- - -Probablemente no tenga /dev/dvd (verifique esto). En este caso, simplemente -cree un enlace /dev/dvd que apunte a su dispositivo DVD. -Algo como - -cd /dev -ln -s hdc dvd - -debería hacer el trabajo. - - -¡ La relación de aspecto es incorrecta ! ----------------------------------------- - -Pruebe apretando "A" (preferiblemente cuando Xine esta detenido, de lo -contrario puede experimentar un fallo de segmentación). - - -¿ Como puedo reproducir desde STDIN ? -------------------------------------- - -use algo como lo siguiente - -cat stream.mpg | xine stdin://mpeg1 - -o, si tiene archivos mpeg-2 use - -cat stream.vob | xine stdin://mpeg2 - - -¿ Como puedo cambiarle la apariencia (skin) ? ---------------------------------------------- - -Ejecute por lo menos una vez Xine - escribirá su archivo de configuración -.xinerc en su directorio home. Ahora edite ese archivo y cambie la linea -"skin:default" para que corresponda a la apariencia que le gustaría que use. - - -¿ Como puedo cambiar el color/brillo/contraste ? ------------------------------------------------- - -Por el momento esto solo es soportado por algunos drivers Xv. Encontrará tres -entradas en su ~/.xinerc como estas: - -brightness:0 -saturation:0 -contrast:128 - -los valores y los rangos posibles dependen de su driver Xv, así tendrá que -experimentar un poco para obtener una buena imagen. - - -¡ Algunas partes de mi Escritorio (X Desktop) se ponen transparentes cuando -Xine reproduce el vídeo ! ---------------------------------------------------------------------------- - -Mire un poco los colores de su GUI correspondientes a la llave de color(en -inglés colorkey = color especial usado por mecanismos de overlay para -reemplazar partes de un cuadro) usados por Xv. Puede cambiar la valoración -de esta llave de color para evitar esto. Tiene que haber una línea como: - -colorkey:2110 - -en su ~/.xinerc donde puede cambiar el color usado por Xine para el -revestimiento de vídeo. - - -No consigo sonido, pero "el driver de audio 'oss' fallo, uso entonces los -drivers nulos." -------------------------------------------------------------------------- - -Antes de nada, asegúrese que su drivers de Audio OSS esta funcionando (por -ejemplo reproduce música con otro software). - -La razón mas común de esto es que otro programa esta accediendo a su -dispositivo de audio. Si esta usando linux, el comando "fuser /dev/dsp" debe -dar el PID del proceso. - -Si esta usando GNOME, las oportunidades son, que esto este causado por esd. -Simplemente desactive esd (temporalmente), clikeando con el botón derecho en -el programa (applet) de control de sonido y seleccionado "Place Esound in -standby" (Ponga en espera a Esound). Todos lo sonido de GNOME serán -desactivados. Pero probablemente quiera escuchar su película, de cualquier -manera ;-) - - -Después de correr Xine varias veces falla en ubicar la memoria asignada! ------------------------------------------------------------------------- - -Esto debe arreglarse en Xine 0.3.3 o superior. Sin embargo, eso solo puede -funcionar si se sale de Xine de la manera "correcta" (ej. usando el panel o -presionando la tecla "q"). -No cierre simplemente la ventana de salida de vídeo usando su manejador de -ventanas (window manager) - Xine no liberará la memoria compartida en ese -caso (!). - - -Tengo problemas cuando uso Xine en BSD --------------------------------------- - -Verifique si encuentra lo que está buscando en el archivo README.freebsd - - -¡ 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) <xine-user@lists.sourceforge.net> - - -*********************************************************************** -*** 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 c5a66f068..4396f0a48 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -4,7 +4,7 @@ SUBDIRS = man EXTRA_DIST = $(docs_DOCS) MRL.txt dataflow.dia xine-lib-API.cfg docdir = $(prefix)/share/doc/xine -docs_DOCS = README README.syncfb README.freebsd FAQ bug_report_form +docs_DOCS = README-lib.solaris FAQ-lib FAQ-lib_es install-data-local: diff --git a/doc/README b/doc/README deleted file mode 100644 index 50d81b40e..000000000 --- a/doc/README +++ /dev/null @@ -1,343 +0,0 @@ - - ---------------------- - xine - ---------------------- - - a unix video player - - - -about xine: ------------ - -xine is a free gpl-licensed video player for unix-like systems. -We support mpeg-2 and mpeg-1 system (audio + video multiplexed) streams, -mpg audio files and AVI files (using win32 codec dlls). - -xine plays the video and audio data of the stream and synchronizes -the playback of both. Depending on the properties of the stream, -playback will need more or less processor power, full frame rate -for mpeg-2 has been seen on a 400 MHz P II system. - -xine can play Video CDs, SVCDs and DVDs directly. Unfortunately the legal -status of encrypted/locked DVD playback is uncertain in some countries -so we cannot include any DVD unlock/decrypt code with xine. To play back -such DVDs you'll need external programs or something like a -xine_dvd_plugin that can handle DVD authentification/descrambling. - -xine tries to be straightforward and effective. ...no bells and -whistles are being developed at this time ;-) first we want to achieve -good playback of video. - - -supported platforms / requirements: ----------------------------------- - -- xine needs a locally attached graphics device and monitor (playback over - x is not supported at the moment and will probably never be really useful - because of the enormous bandwidth of decoded video streams). -- xine needs either MIT-SHM (The MIT Shared Memory Extension), which is - supported in XFree86 for quite some time (3.3.x will be fine), - or X-Video Extension (Xv) which is faster and supports fullscreen - operation but is only provided by some XFree86 4.x drivers. - nVidia chips and Matrox G200 and G400 are known to work. -- if you can't get Xv to run on your platform you should use 16bpp - colordepth for speed. Xv seems to work nicely for 16 and 24bpp. -- if you have a mga 200 / 400 graphics adaptor you can optionally - use the sybcfb/teletux video ouput driver. See README.syncfb for - details. -- you need a sound driver that is realtime capable (not all - OSS/ALSA drivers support that feature) or ESD - -xine has so far been sucessfully used on the following systems: - -- Linux on a Pentium III 667 - using XFree86 4.01 on a nVidia Riva TNT 2 -- Linux on a Pentium II 400 - using XFree86 3.3.6, 4.0, 4.01 and 4.02 on a nVidia Riva TNT -- FreeBSD 4.1-Release on a Celeron 400 - using XFree86 3.3.6 and 4.0.1 on a Matrox G400 -- Linux on a Pentium 120 (no MMX) - using XFree86 3.3.5 on a Trident 9660 -- Linux on an AMD K6-266 - using XFree86 3.3.5 on a ATI AIW M64-8Mb PCI -- Linux on an AMD K6-III 450 - using XFree86 3.3.6 on a ATI RageII 8MB -- Linux on a Celeron 633 - using XFree86 4.0.1 on a ATI AIW Rage128-16MB -- Linux on a Amd K7@550 - using Xfree 4.0.1 on a Ati Rage 128 16 Mb - (Xv is working on this configuration with drivers from GATOS project) -- Linux on a Celeron 667 - using XFree86 4.0.2 on a Riva TNT 16Mb - (Xv is working on this configuration with closed-sources drivers - version 0.9.5 from NVidia). -- Linux on a Amd K6-2@475 - using XFree86 4.1.0 on a 3dfx voodoo3 2000 PCI 16Mb - (Xv is working on this configuration) -- Solaris 8 on Intel - using Xsun on a ATI Xpert@Work & Xpert98 (3D RAGE PRO) - see README.solaris for more infomation - -non-intel platforms: -- Solaris 8 on SPARC - using Xsun on a Creator-3D framebuffer - see README.solaris for more infomation - -usage: ------- - -You can start xine without any command line parameters or you can -specify one or more input streams directly. Xine tries to detect wheter -it can use the Xv extension and will fall back to XShm, but that -detection might fail. -If you don't see any video, first check your X11 drivers (for example -only the binary drivers from nVidia have Xv support for their chips). -If you can't get Xv to work, use the "-s" option and xine will be -forced to use Xshm. -If you get very sloppy video ouput your sound driver may not be -realtime capable. Try to use ALSA instead or, if you're already using -ALSA you might want to give OSS a try. -If you want to send the sound over a network with ESD, set the ESPEAKER -environment variable before starting xine. - -The input stream can be a filename or something we call -"MediaResourceLocator" MRL, which looks similar to a URL. First you -specify an input source which is followed by "://" and an input-source -specific identifier. What input sources you can use depends on the -input plugins you have (for plain files you can omit the input-source -identifier). Try - -$ xine --help - -to get the complete usage. - -Unfortunately the gui does not yet support the MRL concept to any -great extend, so to use any other input source than plain files you'll -have to use the command line at the moment. That will change soon :-) - -Example usage: - -$ xine - -$ xine /path/foo.vob - -$ xine -s /foo/test.mpg - -xine supports the xdnd protocol (Version 3) so if you have a file browser -application supporting that protocol (e.g. gmc) you can drop video files -on xine for playback. - -Playing track 3 from a VCD: - -$ xine vcd://3 - -Example for direct DVD access: - -$ xine dvd://VTS_01_1.VOB - -Keyboard shortcuts: -------------------- - -Key action - -RETURN play -F toggle fullscreen mode -Q quit -0 jump start of current stream -1-9 jump to 10-90% of current stream -SPACE pause -PgUp/Prior jump to previous playlist entry -PgDown/Next jump to next playlist entry -A toggle aspect ratio (AUTO/16:9/4:3/DVB) -Ctrl show/hide mouse cursor - -more to come. - -Click right on the video window to toggle panel visibility. - -selecting audio channels: -------------------------- - -Supply the -a option to select the desired audio track: - -xine -a 3 test.mpg - -plays the third mpg audio track (and the video, of course). - -For mpeg-1, only mpeg audio (layer 1, 2 and 3) is supported. - -Mpeg-2 streams can have different types of audio streams, though. -Xine supports ac3 (dolby digital), mpeg and LPCM sound. These -are mapped to the following tracks: - -Track selected audio stream - - 0- 7 ac3 stream 0-7 - 8-15 mpg audio stream 0-7 -16-23 pcm audio stram 0-7 - -example: to play pcm stream 0 use - -xine -a 16 file.vob - -selecting subtitles: --------------------- - -Subtitles are embedded in different tracks like audio. In general, -track 0 is the default language subtitle. Use the -u option to -select the desired subtitle track: - -xine -u 0 test.vob - -displays the subtitles from stream 0. - -controlling xine via CORBA: ---------------------------- - -Xine implements a CORBA server interface to enable remote control and -scripting. For this, you need ORBit which should already be installed if -you are using GNOME. Otherwise you can get it from - - http://orbit-resource.sourceforge.net/ - -Any version of ORBit >= 0.4.0 should work fine. - -To enable the CORBA interface, you need to supply the "--enable-corba" -argument to the ./configure script and recompile xine. - -The xine server interface definition can be found in "corba/xine.idl" which -gets installed to "/usr/share/idl/xine.idl" by default. - -To communicate with xine via CORBA, you need to get its IOR (Interoperable -Object Reference). Upon startup, xine writes it to the file ~/.xine.ior -where you can read it from. If the ORBit name service is running, xine -also registers itself there under the name "Xine". Unfortunately, the -ORBit name server is usually not activated by default. You have to run -it manually like this: - - orbit-name-server >/tmp/name-service-ior & - -See the ORBit docs for more information. - -Two example client programs are provided: - 1. "xine-remote" is an example client written in C which can be used to - send play/stop/pause commands to a running instance of xine - 2. "example.py" is a small Python script that demonstrates how to easily - control xine from a scripting language - -using LIRC with xine: ---------------------- - -Xine can be remotly controlled with by IR. For this, you should have -LIRC installed (http://www.lirc.org), you should get latest CVS snapshot -if you're running latest Linux kernels (2.2 or 2.4 series). - -You should add some entries in your ~/.lircrc, like this: -begin - remote = SAMSUNG - button = Button_Play - prog = xine - repeat = 0 - config = PLAY -end -begin - remote = SAMSUNG - button = Button_Src - prog = xine - repeat = 0 - config = DVD -end -begin - remote = SAMSUNG - button = Button_1 - prog = xine - repeat = 0 - config = 10% -end -... - -All valids strings orders are: - - - for quiting: - quit - - for set the current position in current stream playback: - 0%, 10%, 20%, 30%, 40%, 50%, 60%, 70%, 80%, 90% - - for play or stop: - play - - for pausing: - pause - - for eject: - eject - - for next/previous MRL in the playlist: - next, prev - - for next/previous audio track selection: - audio+, audio- - - for next/previous sub-title selection: - spu+, spu- - - to get the playlist from a DVD/VCD: - dvd, vcd - - to hide/show the GUI, the output video window: - hidegui, hideoutput - - to toggle the output video window<->fullscreen - fullscr - -All of orders are not case sensitive. - -used software: --------------- - -xine uses software from the following free software projects: - -- libac3 by Aaron Holtzman -- libmpeg2 by Aaron Holtzman -- libmpg123 of the mpg123 project by Michael Hipp - (see http://www.mpg123.de/) - -...without these great pieces of software xine would of course not -be where it is now. - -also many thanks to the Linux Video and DVD Project "LiViD" -(http://www.linuxvideo.org/), where the original ideas for the xine -video player came from. - -developers of xine: -------------------- - - main xine developer: - Guenter Bartsch - - various suggestions, bug and build fixes, alsa plugin, gui - Daniel Caujolle-Bert <f1rmb@users.sourceforge.net> - - audio programming - Siegfried Langauf <siggi@users.sourceforge.net> - - contributes great libmpeg2 hacks: - Michael Lespinasse - - ...plus various other contributors, see the AUTHORS file - - -contacting the xine project: ----------------------------- - - the xine project website is - - http://xine.sourceforge.net - - feedback or offers for help are greatly appreciated, please contact - - - The Xine User Mailing List <xine-user@lists.sourceforge.net> - ================================= - - - If, for some reason, you can't post to the list, you may contact the authors - directly: - - Guenter Bartsch <guenter@users.sourceforge.net> - Daniel Caujolle-Bert <f1rmb@users.sourceforge.net> - Siegfried Langauf <siggi@users.sourceforge.net> - - $Id: README,v 1.4 2001/06/22 10:40:46 jkeil Exp $ diff --git a/doc/README-lib.solaris b/doc/README-lib.solaris new file mode 100644 index 000000000..4926d2e3d --- /dev/null +++ b/doc/README-lib.solaris @@ -0,0 +1,14 @@ +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.freebsd b/doc/README.freebsd deleted file mode 100644 index 72d5f2e65..000000000 --- a/doc/README.freebsd +++ /dev/null @@ -1,93 +0,0 @@ -xine fails when allocating images ---------------------------------- - -Make sure you have enough shared memory enabled. This is very -limited by default. - -Edit your /etc/sysctl.conf: - -kern.ipc.shmmax=67108864 -kern.ipc.shmall=32768 - - -mtrr on freebsd ---------------- - -setting up the caching behaviour of the memory on the graphics board. - -what is being done with the mtrr support on linux is to set the caching -type of the memory of the graphics board to 'write-combine' mode. -that way the performance of big writes into this memory should be faster. - -it seems that the same can be achieved on freebsd by executing: - - memcontrol set -b <base-address> -l <length> write-combine - -for example on my system i executed: - - memcontrol set -n 0xd8000000 -l 0x02000000 write-combine - -i got the base-adress by executing 'startx' and looking at the output. - -it seems to be dangerous to change the cache setting of the graphics memory -while xfree is running - at least i managed to have my system freeze that -way. so better do it on the commandline. - -this tip is still subject of research, so it might be incorrect - please -report any further information on this topic to the xine-user list. -please also report success or non-success on xine-user if you have the time. - - -playing video cd on freebsd ---------------------------- - -currently (because of issues with the freebsd kernel) xine can only -play video cd from atapi cdrom drives. not for scsi drives! - -currently (Jan 2001), FreeBSD-stable (and thus the current releases also) -needs a patch to the kernel sources to make video cd work (please check -the freebsd documentation if you are unsure on how to build a custom -kernel with this patch included). - -the file you have to patch is /sys/dev/ata/atapi-cd.c: - -*** atapi-cd.c.orig Sun Jan 21 14:42:57 2001 ---- atapi-cd.c Sun Jan 21 14:47:13 2001 -*************** -*** 1163,1174 **** - return; - } - } -! if (blocksize == 2048) -! ccb[0] = ATAPI_READ_BIG; -! else { -! ccb[0] = ATAPI_READ_CD; -! ccb[9] = 0x10; -! } - } - else - ccb[0] = ATAPI_WRITE_BIG; ---- 1163,1182 ---- - return; - } - } -! switch (blocksize) { -! case 2048: -! ccb[0] = ATAPI_READ_BIG; -! break; -! -! case 2352: -! ccb[0] = ATAPI_READ_CD; -! ccb[9] = 0xf8; -! break; -! -! default: -! ccb[0] = ATAPI_READ_CD; -! ccb[9] = 0x10; -! } - } - else - ccb[0] = ATAPI_WRITE_BIG; - ------------------------------------------------------------------------- - diff --git a/doc/README.solaris b/doc/README.solaris deleted file mode 100644 index b177bc3f9..000000000 --- a/doc/README.solaris +++ /dev/null @@ -1,30 +0,0 @@ -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. diff --git a/doc/README.syncfb b/doc/README.syncfb deleted file mode 100644 index 092188eb3..000000000 --- a/doc/README.syncfb +++ /dev/null @@ -1,144 +0,0 @@ - - ===== ===== - XINE video output plugin for MATROX G400 / G200 cards *only* - ===== ===== - - - -* WHAT IS THIS PLUGIN ABOUT and WHY SHOULD I EVEN CONSIDER TO USE IT? :) - - This XINE video output plugin uses the so called Teletux driver which - provides special hardware features of the Matrox G400 and G200 cards - like deinterlacing, scaling and YUV data to RGB conversion --- just to - name a few. The plugin makes all those features available to XINE and - because all this tasks are done by the graphics card there is no need - for XINE to do them in software -- so you save precious CPU time which - you may gonna need for other things. :-) - - Another feature of this plugin is the synchronisation of the video - picture with the refresh of your screen. Before you ask why you would - need that - here the explanation... :) - - In order to have an optimal DVD playback the update of the image needs - to be syncronized with the refresh of the screen. Otherwise you will - sometimes see part of frame n and part of frame n+1 during an refresh. - This results in tearing artefacts on moving objects. - - When using this plugin the update of the screen is done in the V-SYNC - phase of your screen - and the tearing artefacts are gone forever. - - -* AND HOW DOES IT WORK? - - The Teletux driver is a module you will have to load that makes a - special device (/dev/syncfb) available which is opened by the plugin - and controlled with certain ioctl calls. Quite easy, isn't it? ;) - - That module is based on the mga_vid driver from Aaron Holzmann and was - advanced (and reworked) by Matthias Oelmann. - - -* OK I HEARD ENOUGH - HOW DO I INSTALL and USE IT? :) - - First of all you will need to get the Teletux driver itself. It's - available at http://teletux.sourceforge.net. Once you downloaded it, - unpack it to some directory of your choice, please read the README and - compile it (a normal "make" should work out-of-the-box). Now there are - only a few things left for you to do... - - 1) Become root. Hey now you can take over the world *evil laugh* :-))) - 2) Create a device called /dev/syncfb ===> mknod /dev/syncfb c 178 0 - 3) Copy the file "syncfb.o" to your modules directory (usually this is - /lib/modules/YOUR_KERNEL_VERSION/) and do a "depmod -a". - - This should be it. In order to use the Teletux driver you will have to - load it with the command "insmod syncfb.o" - please note that you will - have to load it every time you reboot if you wanna use the driver. - - XINE autodetects the driver and automaticly uses this plugin. - - It is possible now that the image during video playback is jerking. - This could be caused by the syncronisiation of the video image with - your screen refresh. You can easily fix that by switching your monitor - to the appropriate refresh rates (50 Hz for PAL, 60 Hz for NTSC). You - will need to add so called modelines to your XFree86 config to make - those 50 Hz/60 Hz modes available. - - Here is is a short listing of some sample modelines. Please add only - those two lines (for NTSC and PAL) which exactly fit the screensize - you are running your X Server with. You need to add those lines to the - monitor section of your XF86Config file as well as include their names - in the screen section (subsection display of the color depth your are - using). - - USE THE FOLLOWING MODELINES AT YOUR OWN RISK. THEY COULD DAMAGE YOUR - MONITOR PERMANTELY - PLEASE TAKE CAUTION AND DON'T BLAME US. YOU HAVE - BEEN WARNED. - - So much for the standard disclaimer. :) - - Note: If you want to be on the safe side, generate your very own - modelines with an application like kvideogen or use a service - like http://zaph.com/Modeline/ on the web. - - Also the modelines may need some fine tuning for your setup. You - can use xvidtune (comes with XFree86) to do that. - - # 1024x768 - - Modeline "1024x768pal" 64.94 1024 1040 1216 1328 768 768 775 802 - Modeline "1024x768ntsc" 54.32 1024 1040 1216 1328 768 768 774 802 - - # 1152x864 - - Modeline "1152x864pal" 68.82 1152 1168 1384 1496 864 864 871 902 - Modeline "1152x864ntsc" 80.93 1152 1168 1384 1496 864 864 872 902 - - # 1280x1024 - - none yet - will be added soon - - So before you run XINE please turn to the appropriate refresh rate and - the jerking should be gone. - - -* WHAT SCREENSIZE SHOULD I PREFER? - - Well. It is important that the screensize you choose for DVD playback - is exactly the same screensize you're starting up your X Server with. - So you shouldn't switch down to 1024x768 if you are running 1280x1024 - because that gives you a virtual screensize of 1280x1024 in a - resolution of 1024x768 - and the plugin cannot handle that yet. - - Now back to the question. A screensize of 1024x768 should be it. A DVD - is always 720x576 for pal and 720x480 for ntsc. If you've an anamorphe - DVD the image only has to be horizontally scaled to get back to the - original geometry of 16:9 which is easier to be done. - - -* WHERE IS THE WINDOW A VIDEO IS USUALLY DISPLAYED IN? - - The Teletux driver is writing directly to the video memory of the G400 - or G200 card and bypasses your X server. Getting that overlay into a - real window isn't as easy as you might think. - - For now a borderless window is being used which lays under the overlay - so you can click on the overlay (for the panel to appear) or issue any - command XINE supports by keyboard while you're over the overlay with - your mouse cursor. - - -* WHAT IS ON THE TODO LIST? - - The plugin does not yet activate the hardware deinterlacing. - The mouse cursor doesn't disappear yet when it should be disappearing. - Prevent the panel from hidding behind the overlay by moving it out of range. - Bug fixes, new features and optimizations. :-) - - -* CONTACTS and FEEDBACK - - Joachim Koening <joachim.koenig@gmx.net> - Matthias Dahl <matthew2k@web.de> - - or use the XINE User Mailinglist. (more infos see the general README) diff --git a/doc/bug_report_form b/doc/bug_report_form deleted file mode 100644 index 054071117..000000000 --- a/doc/bug_report_form +++ /dev/null @@ -1,62 +0,0 @@ -this is a generic bug report form that should help you making bug reports -(e.g. to post them on the xine-user mailing list at - <xine-user@lists.sourceforge.net>) - -Just use it as a checklist or copy/paste it into your bug report and replace -the quoted lines ("> ...") with the corresponding information! - - -> subject -> ------- -> -> _please_ give a meaningful subject! Something like "horizontal bars while -> playing" is good, something like "xine bug" is not. - - -bug description ---------------- - -> short, but complete, problem description - - -xine console output -------------------- - -> please _always_ include the complete console output xine produces. -> It contains important information about the hardware xine detected and -> what modules are used for audio/video output on your configuration. - -> you can produce a suitable log file with these command(s): -> xine [options] 2>&1 |tee /tmp/xine.log -> if the resulting /tmp/xine.log is very big, you may compress it with -> "gzip -9 /tmp/xine.log" before attaching it to your bug report. - - -xine version used ------------------ - -> release/CVS ? is it a debug version (did you a make debug?) -> Is the bug new with this release? -> If you don't use the current release: Why not?/Please recheck with the -> current version, first! - - -information about your operating system/software ------------------------------------------------- - -> operating system, e.g. linux, kernel 2.2.16 - -> X server, e.g. xfree 4.01, mga drivers - -> audio driver, e.g. alsa 0.5.9d - - -information about your hardware configuration ---------------------------------------------- - -> CPU, e.g. P II 400 - -> graphics card, e.g. Matrox G400, 32 MB RAM - -> sound card, e.g. SB Live - diff --git a/doc/man/en/Makefile.am b/doc/man/en/Makefile.am index b70881881..10c1637dc 100644 --- a/doc/man/en/Makefile.am +++ b/doc/man/en/Makefile.am @@ -1,6 +1,6 @@ -man_MANS = xine.1 +man_MANS = xine-lib.3 -EXTRA_DIST = $(man_MANS) xine.1.in +EXTRA_DIST = $(man_MANS) xine-lib.3.in mostlyclean-generic: -rm -f *~ \#* .*~ .\#* @@ -8,4 +8,4 @@ mostlyclean-generic: maintainer-clean-generic: -@echo "This command is intended for maintainers to use;" -@echo "it deletes files that may require special tools to rebuild." - -rm -f Makefile.in xine.1 + -rm -f Makefile.in xine-lib.3 diff --git a/doc/man/en/xine.1.in b/doc/man/en/xine-lib.3.in index 2739c44c0..ed4428128 100644 --- a/doc/man/en/xine.1.in +++ b/doc/man/en/xine-lib.3.in @@ -1,6 +1,6 @@ .\" -*-Nroff-*- .\"" -.TH XINE 1x 2000-11-19 "The xine project" +.TH XINE 3x 2000-11-19 "The xine project" .\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection .\" other parms are allowed: see man(7), man(1) .\"" diff --git a/doc/man/fr/Makefile.am b/doc/man/fr/Makefile.am index 0335fd786..b40770a30 100644 --- a/doc/man/fr/Makefile.am +++ b/doc/man/fr/Makefile.am @@ -1,15 +1,15 @@ -mansubdir=/fr/man1 +mansubdir=/fr/man3 -man_MANS = xine.1 +man_MANS = xine-lib.3 -EXTRA_DIST = $(man_MANS) xine.1.in +EXTRA_DIST = $(man_MANS) xine-lib.3.in -install-man1: +install-man3: $(mkinstalldirs) $(DESTDIR)$(mandir)$(mansubdir) - @list='$(man1_MANS)'; \ + @list='$(man3_MANS)'; \ l2='$(man_MANS)'; for i in $$l2; do \ case "$$i" in \ - *.1*) list="$$list $$i" ;; \ + *.3*) list="$$list $$i" ;; \ esac; \ done; \ for i in $$list; do \ @@ -22,11 +22,11 @@ install-man1: $(INSTALL_DATA) $$file $(DESTDIR)$(mandir)$(mansubdir)/$$inst; \ done -uninstall-man1: - @list='$(man1_MANS)'; \ +uninstall-man3: + @list='$(man3_MANS)'; \ l2='$(man_MANS)'; for i in $$l2; do \ case "$$i" in \ - *.1*) list="$$list $$i" ;; \ + *.3*) list="$$list $$i" ;; \ esac; \ done; \ for i in $$list; do \ @@ -43,4 +43,4 @@ mostlyclean-generic: maintainer-clean-generic: -@echo "This command is intended for maintainers to use;" -@echo "it deletes files that may require special tools to rebuild." - -rm -f Makefile.in xine.1 + -rm -f Makefile.in xine-lib.3 diff --git a/doc/man/fr/xine.1.in b/doc/man/fr/xine-lib.3.in index 708880d67..ef019da07 100644 --- a/doc/man/fr/xine.1.in +++ b/doc/man/fr/xine-lib.3.in @@ -1,6 +1,6 @@ .\" -*-Nroff-*- .\"" -.TH XINE 1x 2000-11-19 "Le projet xine" +.TH XINE 3x 2000-11-19 "Le projet xine" .SH NOM xine \- Lecteur audio/vidéo MPEG2/MPEG1. .SH SYNOPSIS |