<!doctype linuxdoc system>
<article>
<title>EL "HOWTO" del Reproductor de Video Xine
<author>Rich Wareham, <tt>&lt;richwareham@users.sourceforge.net&gt;</tt>
<date>v1.01, 2001 May 17
<abstract>Este documento describe como instalar, configurar y usar el
Reproductor de Video Xine.
</abstract>

<toc>

<sect>Introduccion
<p>
Este documento ha sido escrito para proveer a los usuarios finales con informacion
sobre como usar el reproductor de video Xine para reproducir archivos de video y
discos DVDs sin encripcion.
Nota: Xine en su estado original sin modificar
no puede reproducir DVDs encriptados con CSS.

<sect1>Nuevas versiones de este documento
<p>
Las versiones nuevas de este documento pueden obtenerse de varios sitios incluyendo:

<itemize>
<item><htmlurl url="http://xine.sourceforge.net/">
<item><htmlurl url="http://www.srcf.ucam.org/~rjw57/xine">
</itemize>

Finalmente, la version mas actualizada de este documento tambien esta disponible en
varios formatos en:
<htmlurl url="http://www.srcf.ucam.org/~rjw57/xine">

<sect1>Retroalimentacion
<p>
Todos los comentarios, reportes de error, informacion adicional y criticas de
todos tipos respecto a este documento deben ser dirigidas (en ingles) a:
<verb>
  richwareham@users.sourceforge.net
</verb>
<p>
Todos los comentarios, reportes de error, informacion adicional y criticas de
todos tipos respecto a la traduccion de este documento deben ser dirigidas (en
ingles o español) a:
<verb>
  jeroot@angloamericano.ed.cr
</verb>

<sect1>Terminos de Uso
<p>
No se acepta la responsabilidad por los contenidos de estos documentos.  El uso
de los conceptos, ejemplos y otros es bajo su propio riesgo.
Adicionalmente, esta es una version temprana, con muchas posibilidades de
inexactitudes y errores.

Se describira una de los muchas posibles formas. En el mundo GNU/Linux,
usualmente hay varias maneras de lograr las cosas.

Hasta donde se, todos los programas mencionados aqui estan protegidos bajo
la Licencia Publica General GNU ("GNU General Public License") o la Licencia
Menos Publica GNU ("Lesser GNU Public License").

<sect1>Informacion de Copyright
<p>

Este documento es copyright &copy;2001 El Proyecto Xine y es distribuido bajo los
siguientes terminos:

<itemize>
<item>Este documento puede ser reproducido y distribuido completo o
en parte, en cualquier medio fisico o electronico, siempre y cuando
esta aviso de copyright sea mantenido en todas las copias. La redistribucion
comercial esta permitida y es apoyada; sin embargo, al autor le gustaria
ser notificado de tales distribuciones.

<item>Todas las traducciones, trabajos derivativos o trabajos agregados
que incorporen cualquier parte de este documento deben estar cubiertos bajo
este aviso de copyright.  Eso es, usted no puede producir un trabajo derivado
de este "HOWTO" e imponer restricciones adicionales acerca de su distribucion.
</itemize>

<!--<sect1>Como mando cambios o adiciones a el HOWTO?
<p>
El metodo preferido es editando el archivo Xine-HOWTO.sgml para
incorporar los cambios, crear un archivo "diff" de la siguiente manera
<verb>
  diff -uw original-file new-file
</verb>

y enviandolo a <tt>richwareham@users.sourceforge.net</tt>.  Si usted no
sabe SGML, no importa.  Cambios o informacion nueva en cualquier forma sera
aceptada.  Crear el archivo "diff" tan solo lo hace mas facil para el encargado
del HOWTO.  <tt>:-)</tt>!-->

<sect>Acerca de Xine
<p>
Xine es un reproductor de video libre para sistemas tipo Unix bajo la licencia
Licencia Publica General GNU ("GNU General Public License", GPL).
Soporta archivos de videos MPEG-2 y MPEG-1 (audio + video multiplexado),
archivos de audio MPEG (como MP3) y archivos AVI (usando algunos archivos
DLL de Windows).

Xine reproduce los datos de video y de audio del archivo y sincroniza
la reproducion de ambos. Dependiendo de las propiedades del archivo,
la reproduccion necesitara mas o menos poder de procesador. La visualizacion
correcta de video MPEG 2 ha sido posible en un sistema PII a 400 MHz.

Xine puede reproducir Video CDs, SVCDs y DVDs directamente. Desafortunadamente
el estatus legal de la reproduccion de DVDs encriptados/bloquedos no esta clara
en algunos paises, por lo que no podemos incluir ningun codigo de desbloqueo/decripcion
de DVDs con Xine. Para reproducir estos DVDs usted necesitara programas externos o un
"plugin" especial para Xine. Mas detalles pueden encontrarse en la seccion sobre
Reproduccion de DVDs.

Xine trata de ser facilmente entendible y efectivo. Ningun efecto
especial o caracteristicas avanzadas estan siendo desarrolladas en en este momento.
La meta principal es el lograr una buena reproduccion de video.

<sect1>Donde puedo obtener Xine?
<p>
Xine puede obtenerse desde <htmlurl url="http://xine.sourceforge.net/">.
La version mas actual en el momento que se escribio este HOWTO es la 0.4.1.
Xine esta disponible como archivo <tt>tar.gz</tt> y paquetes binarios
de Debian y RPM.

<sect1>Plataformas soportadas y requerimientos
<p>
Xine necesita un dispositivo de graficos y un monitor conectados localmente
(la reproduccion sobre una sesion de red de X no esta soportada por el momento
y probablemente nunca va a ser realmente util por la enorme cantidad de ancho
de banda requerida por los archivos de video decodificados).

Xine necesita o MIT-SHM (La Extension de Memoria Compartida del MIT, MIT
Shared Memory Extension), la cual ha estado soportada en XFree86 desde
hace bastante tiempo (3.3.x y superiores), o la Extencion X-Video (Xv) la
cual es mas rapida y soporta operacion en modo de pantalla completa pero
solo es provista por algunos manejadores del XFree86 4.x.

Para mas informacion sobre Xv (y si es soportada por su tarjeta de video),
refierase a la seccion sobre incrementar el rendimiento de Xine, mas abajo
o busque en el sitio de la organizacion XFree86 (<htmlurl url="http://www.xfree86.org/">).

Es recomendado que, si usted no usa Xv, ponga la profundidad de color de
su pantalla a 16 bits-por-pixel (bpp) por razones de velocidad. Xv parece funcionar
bien en 16bpp o 24bpp.

Si usted tiene un adaptador grafico Matrox G200 or G400, puede opcionalmente
usar el manejador de salida de video sybcfb/teletux. Vea el archivo README.syncfb
incluido en la distribucion de Xine para mas detalles. La mayor ventaja de
usar este manejador es la sincronizacion del video con el refrescamiento de
su monitor, quitando los efectos de 'desgarrado' que pueden ocurrir en escenas
de movimiento rapido.

Necesita una tarjeta de sonido que sea soportada por los manejadores OSS o ALSA.
El demonio de sonido ESD tambien esta soportado. Lo que resta de este "HOWTO"
asume que usted ya ha instalado y configurado correctamente su tarjeta de sonido
y su servidor X.

Xine ha sido probado exitosamente hasta el momento en los siguientes sistemas:
<itemize>
<item> Linux en una Pentium III 667
  usando XFree86 4.01 con una nVidia Riva TNT 2
<item> Linux en una Pentium II 400
  usando XFree86 3.3.6, 4.0, 4.01 y 4.02 con una nVidia Riva TNT
<item> FreeBSD 4.1-Release en una Celeron 400
  usando XFree86 3.3.6 y 4.0.1 con una Matrox G400
<item> Linux en una Pentium 120 (sin MMX)
  usando XFree86 3.3.5 con una Trident 9660
<item> Linux en una AMD K6-266
  usando XFree86 3.3.5 con una ATI AIW M64-8Mb PCI
<item> Linux en una AMD K6-III 450
  usando XFree86 3.3.6 con una ATI RageII 8MB
<item> Linux en una Celeron 633
  usando XFree86 4.0.1 con una ATI AIW Rage128-16MB
<item> Linux en una Amd K7@550
  usando Xfree 4.0.1 con una Ati Rage 128 16 Mb
  (Xv funciona en esta configuracion con los manejadores del proyecto GATOS)
<item> Linux en una Celeron 667
  usando XFree86 4.0.2 con una Riva TNT 16Mb
  (Xv funciona en esta configuracion con los manejadores propietarios
  version 0.9.5 de NVidia).
<item> Linux en una Pentium III 500
  usando XFree86 4.0.2 con una Matrox G400.
</itemize>

El desarrollo para las plataformas no-Intel ya ha comenzado pero todavia esta
en sus etapas tempranas. Se ha reportado que Xine ha funcionado exitosamente
con Linux/PPC en una Mac.

<sect1>Donde puedo hacer preguntas acerca de, o reportar pulgas de Xine?
<p>
Hay una lista de correo llamada <tt>xine-user</tt> provista por
Sourceforge en la que usted puede hacer preguntas. Detalles completos estan
disponibles en el sitio web de Xine (<htmlurl url="http://xine.sourceforge.net/">).

Tambien hay una sala de chat en IRC, <tt>#xine</tt> la cual esta en
<tt>irc.openprojects.net</tt>.

<sect>Compilando e Instalando Xine<label id="compiling">
<p>
Las siguientes instrucciones asumen que usted esta instalando desde los archivos
de codigo fuente disponibles en el sitio web de Xine (llamados algo asi como
<tt>xine-xx.xx.xx.tar.gz</tt>). Vea mas adelante si desea instrucciones sobre otros
paquetes.

Descargue el archivo a algun directorio. Abra una terminal y entre
a ese directorio. Por ejemplo, si bajo el archivo a el directorio <tt>/home/rich/src/</tt>,
teclee lo siguiente:
<verb>
  $ cd /home/rich/src/
</verb>

Ahora teclee lo siguiente. Esto extraera el conjunto de archivos de codigo fuente
de Xine en el directorio de codigo fuente de xine.
<verb>
  $ tar xvzf xine-*.tar.gz
  $ cd xine
</verb>

<sect1>Donde estan las instrucciones de instalacion?
<p>
Las instrucciones completas de instalacion estan incluidas en el archivo <tt>INSTALL</tt>.
Lo que sigue es una version breve de las instrucciones.

<sect1>Guia de instalacion de comienzo-rapido
<p>
Extraiga el archivo de fuentes de Xine como se dijo en la seccion titulada
<ref id="compiling" name="Compilando e Instalando Xine">. Configure el codigo fuente
para su maquina y compile tecleando:
<verb>
  $ ./configure
  $ make
</verb>

Ahora, como el usuario <tt>root</tt>, introduzca el siguiente comando:
<verb>
  $ make install
</verb>

<sect1>Instalando Xine en un directorio diferente
<p>
Para instalar Xine en, por ejemplo, el directorio <tt>/usr/local/xine</tt>, ponga lo siguiente
<verb>
  $ ./configure --prefix=/usr/local/xine
</verb>

y, como <tt>root</tt> introduzca:
<verb>
  $ make install
</verb>

<sect1>Como puedo proveerle "banderas" adicionales al compilador de C?
<p>
Usted puede hacerlo al especificar la variable <tt>GLOBAL_CFLAGS</tt> y despues
ejecutar <tt>./configure</tt> de nuevo.

Esto puede ser util para especificar rutas adicionales de "include" o rutas
de librerias. Por ejemplo:
<verb>
  $ export GLOBAL_CFLAGS="-I/usr/include -L/home/guenter/xine_libs"
</verb>

<sect1>Tengo un procesador K7, como puedo compilar Xine para que aproveche esto?
<p>
Si usted tiene un gcc reciente puede tratar de compilar ''mas'' soporte para K7
(especialmente mejor agendizacion de instrucciones). Si el "script" <tt>configure</tt>
falla a la hora de detectar su procesador/gcc, trate poniendo la variable de entorno
<tt>XINE_BUILD</tt> explicitamente a una cadena de caracteres de descripcion valida para
su configuracion, ej.
<verb>
  $ export XINE_BUILD=k7-pc-linux-gnu
  $ rm -f config.cache
  $ ./autogen.sh
  $ make
  $ make install
</verb>

<sect1>Binarios Pre-construidos
<p>
Si no desea compilar Xine desde el codigo fuente, hay varios 'paquetes'
pre-construidos disponibles desde el sitio web de Xine.

Nota: existen otros metodos para instalar paquetes, puede que usted
prefiera usar un programa grafico como <tt>kpackage</tt>.

<sect2>Paquetes de Debian (.deb)
<p>
Si usted esta usando la rama 'inestable' de Debian, puede instalar Xine
usando el siguiente comando como <tt>root</tt>:
<verb>
  $ apt-get install xine
</verb>

Alternativamente, si usted ha descargado el archivo <tt>.deb</tt> entonces introduzca
el siguiente comando, substiyendo "xine-x.x.x.deb" con el nombre del archivo que bajo.
<verb>
  $ dpkg -i xine-x.x.x.deb
</verb>

<sect2>Paquetes de Red-Hat (.rpm)
<p>
Descargue el RPM desde el sitio web Xine y teclee el siguiente comando
como <tt>root</tt>, substituyendo "xine-x.x.x.rpm" con el nombre del archivo que bajo.
<verb>
  $ rpm -ivh xine-x.x.x.rpm
</verb>

<sect>Usando Xine
<p>
Usted puede ejecutar Xine con o sin parametros de linea de comando. Si usted desea
reproducir un VCD o DVD, el metodo mas simple es ejecutar Xine con el siguiente
comando:
<verb>
  $ xine
</verb>

Despues haga click en el boton de DVD o VCD en el panel de control. Esto hace que Xine
rastree la unidad en busca de un DVD o de un VCD segun corresponda. Si Xine encuentra alguno,
usted puede presionar el boton 'play' para empezar la pelicula.

Cuando Xine es iniciado, la ventana principal (negra con el logo de Xine en ella) es
desplegada . Hacer click con el boton <bf>derecho</bf> del raton en la ventana
activa/desactiva el despliegue del panel de control de Xine.

El panel de control de Xine tiene una seleccion de controles familiares, parecidos a los de un VCR,
para reproducir, pausar, detener y moverse al principio o al final del archivo segun corresponda.

Para un resumen de uso, teclee lo siguiente:
<verb>
  $ xine --help
</verb>

<sect1>Especificando una fuente de video desde la linea de comando.
<p>
Xine especifica la fuente del video utilizando un <it>Localizador de Recursos de Medios</it>
("media resource locator", MRL). Algunos MRLs validos son:

<itemize>
<item><tt>file://algun/archivo.vob</tt> - Especifica el archivo <tt>/algun/archivo.vob</tt>.
<item><tt>fifo://[[mpeg1:mpeg2]:/]algun/fifo</tt> - Xine adquiere el video del
conducto ("pipe") especial <tt>/algun/fifo</tt>. Por defecto, Xine asume que el video es mpeg-2,
use <tt>mpeg1</tt> o <tt>mpeg2</tt> en el MRL para especificarlo explicitamente.
<item><tt>stdin://[mpeg1:mpeg2]</tt> - Xine toma el video de "stdin". Como con el MRL
<tt>fifo://</tt>, Xine asume mpeg2 a menos que se le indique lo contrario.
<item><tt>dvd://VTS_xx_y.VOB</tt> - Use el archivo VOB de un DVD especificado. Esto es
diferente a usar el MRL <tt>file://</tt> porque Xine lee los datos directamente del DVD
en lugar de usar el sistema de archivos de Unix.
<item><tt>vcd://pista</tt> - Reproduce la pista especificada de un VCD.
</itemize>

En todos los casos, Xine es invocado por
<verb>
  $ xine &lt;mrl>
</verb>

Por ejemplo, para reproducir el archivo <tt>/algun/lugar/foo.vob</tt>:
<verb>
  $ xine file://algun/lugar/foo.vob
</verb>

Ademas de este metodo, usted puede especificar un archivo directamente, por ejemplo:
<verb>
  $ xine /algun/lugar/foo.vob
</verb>

Usted tambien puede obviar el MRL <tt>stdin://mpeg2</tt> utilizando, en su lugar:
<verb>
  $ xine -
</verb>

<sect2>Ejemplos
<p>
Los siguientes MRLs reproducen el archivo <tt>/ruta/foo.vob</tt>:
<verb>
  $ xine /ruta/foo.vob
  $ xine file://ruta/foo.vob
</verb>

Xine soporta el protocol xdnd (Version 3) asi que si usted tiene una aplicacion
administradora de archivos que soporte ese protocolo (como gmc), usted puede soltar
archivos de video sobre xine para reproducirlos.

Reproduciendo la pista 3 de un VCD:
<verb>
  $ xine vcd://3
</verb>

Ejemplo de acceso directo al DVD:
<verb>
  $ xine dvd://VTS_01_1.VOB
</verb>

<sect1>Seleccionando pistas de Audio
<p>
Algunos archivos de video pueden tener multiples pistas de audio (como los DVDs). Hay dos
formas de seleccionar las pistas de audio. La mas simple es usar las flechas al lado del icono
de pista de audio (usualmente un parlante) en el panel de control de Xine.

Alternativamente, usted puede usar el paramatro de linea de comando <tt>-a</tt>. Por ejemplo, para
reproducir la tercera pista de audio en el archivo <tt>/ruta/foo.mpg</tt>:
<verb>
  $ xine -a 3 /ruta/foo.mpg
</verb>

Para video MPEG-1, solo audio  tipo mpeg esta soportado (capa 1, 2 y 3).

Sin embargo los videos MPEG-2 pueden tener diferentes tipos de audio.
Xine soporta sonido AC3 (dolby digital), mpeg y LPCM. Estos
estan mapeados a las siguientes pistas:

<verb>
  Pista    tipo de audio seleccionado

   0- 7    AC3 pistas 0-7
   8-15    Audio MPG pistas 0-7
  16-23    Audio PCM pistas 0-7
</verb>

Por ejemplo, para reproducir la pista 0 de Audio PCM use
<verb>
  $ xine -a 16 archivo.vob
</verb>

<sect2>Salida SPDIF
<p>
Algunas tarjetas de sonido soportan una salida digital llamada SPDIF. Si el parametro
de linea de comando <tt>-S</tt> es especificado, Xine intentara usar esta caracteristica. Note que
esto solo funciona si usted tiene su sistema listo para usar manejadores ALSA
y sus manejadores ALSA lo soportan. Por ejemplo:
<verb>
  $ xine -S archivo.vob
</verb>

<sect1>Desplegando subtitulos
<p>
Los DVDs y los archivos VOB pueden contener informacion de subtitulos que Xine puede usar
para desplegar subtitulos sobre el video. Esta caracteristica esta desactivada por defecto
pero uno la puede activar cambiando el numero de pista de subtitulo a la derecha del icono
de subtitulo en el panel de control de Xine.

Alternativamente, usted puede usar el parametro de linea de comando <tt>-u</tt>. Por ejemplo,
para desplegar los subtitulos con el id 0, use:
<verb>
  $ xine -u 0 &lt;archivo o MRL>
</verb>

<sect1>Forzando el despliegue con MIT-SHM (XShm)
<p>
Xine intenta autodetectar el mejor metodo de despliegue que su monitor soporta. Para
forzar el uso del metodo de despliegue MIT-SHM en lugar del metodo Xv use la bandera
("flag") <tt>-s</tt>. Por ejemplo:
<verb>
  $ xine -s /ruta/archivo.mpg
</verb>

<sect1>Forzando el uso de un manejador de audio en particular
<p>
El paramatro de linea de comando <tt>-A</tt> puede ser usado para seleccionar el manejador de salida
OSS (<tt>oss</tt>), ALSA (<tt>alsa</tt>), ESD (<tt>esd</tt>) o NULL (<tt>null</tt>). Por ejemplo,
para forzar el uso del manejador ALSA:
<verb>
  $ xine -A alsa /ruta/archivo.mpg
</verb>

El manejador NULL no usa ningun hardware de sonido y es casi siempre usado para pruebas.

<sect1>Auto-reproduccion
<p>
Xine puede ser configurado para reproducir automaticamente, apenas es ejecutado, a traves del uso
de el parametro de la linea de comandos <tt>-p</tt>. Por ejemplo:
<verb>
  $ xine -p /ruta/archivo.mpg
</verb>

El parametro <tt>-p</tt> tambien acepta un caracter unico opcional para controlar Xine un poco mas:
<itemize>
<item><tt>f</tt> - Inicie Xine en modo de Pantalla Completa (solo con Xv).
<item><tt>h</tt> - Esconda el panel de control.
<item><tt>q</tt> - Salgase de Xine cuando termine de reproducir el video.
<item><tt>d</tt> - Trate de tomar la lista de reproduccion desde un DVD.
<item><tt>v</tt> - Trate de tomar la lista de reproduccion desde un VCD.
</itemize>

Por ejemplo, para auto-reproducir, en modo de pantalla completa y tratar de tomar la lista de
reproduccion desde un DVD:
<verb>
  $ xine -pfhd
</verb>

<sect1>Controlando Xine a traves de un control remoto
<p>
<bf>FIXME: Incluir el mensaje de Tob Jaffey acerca de LIRC</bf>

<sect1>Pistas y trucos
<p>
Las siguientes pistas y trucos son para sacarle el maximo provecho a Xine.

<sect2>Desactivar el salvapantallas ("screensaver")
<p>
Actualmente Xine no desactiva su salvapantallas o su borrador de pantalla ("screen blanker", DPMS)
cuando cambia a modo de pantalla completa. Para hacer
esto de forma manual, use el comando <tt>xset</tt>:
<verb>
  $ xset s off     # Desactiva el salvapantallas
  $ xset -dpms     # Desactiva DPMS.
</verb>

<sect2>Desactivando la salida a la consola
<p>
Como Xine todavia se encuentra en una etapa temprana de desarrollo, despliega mucha informacion
a la consola cuando es ejecutado. Para evitar esta informacion inice Xine asi:
<verb>
  $ xine mrl 2>&1 >/dev/null
</verb>

<sect2>Haciendo esto automaticamente
<p>
Usted puede utilizar este simple guion ("script") de shell para hacer esto
automaticamente cuando se carga Xine.
<verb>
  #!/bin/sh
  xset s off -dpms
  xine "$1" 2>&1 >/dev/null
  xset s on +dpms
</verb>

<sect>Reproduciendo DVDs con Xine
<p>
Xine, recien salido del horno, tiene soporte para DVDs <it>desencriptados</it>. La mayoria
de los DVDs son encriptados utilizando un sistema conocido como Sistema de Revolvimiento de Contenidos
("Content Scrambling System", CSS). Actualmente el autor y los publicadores de un paquete de software
diseñado para romper esta encripcion son el centro de un caso legal muy controversial. Debido
al incierto estatus legal del codigo relacionado con CSS, Xine no viene con esta funcionalidad. Para
obtenerla, usted debe descargar un <it>plugin</it> especial. Existen dos plugins comunmente
disponibles, el plugin <tt>captain_css</tt> y el plugin <tt>libcss</tt>.

El plugin captain_css esta completo y se puede obtener desde
<htmlurl url="http://members.nbci.com/captain_css/">.

El plugin libcss requiere la libreria libcss la cual es parte del proyecto LiViD
(<htmlurl url="http://www.linuxvideo.org/">). El plugin esta disponible desde
<htmlurl url="http://www.kuroyi.net/xine/xine_dvd_libcss_plugin-clut.tar.gz">.
La libreria libcss puede ser sacada del CVS de LiViD de la siguiente manera:
<verb>
  $ export CVSROOT=:pserver:anonymous@cvs.linuxvideo.org:/cvs/livid
  $ cvs login (no se necesita contraseña - solo presione la tecla retorno)
  $ cvs -z3 co libcss
</verb>

Si el plugin no puede encontrar <tt>libcss.so</tt> en tiempo de ejecucion, asegurese
de que <tt>/usr/local/lib</tt> esta en el archivo <tt>/etc/ld.so.conf</tt> y que usted
ha ejecutado <tt>ldconfig</tt> como el usuario <tt>root</tt>.

Usted tambien debe tener un archivo <tt>/dev/dvd</tt> que apunte a su dispositivo de DVD. Si
usted usa su unidad de DVD como su CDROM principal (p.e. la aplicacion de reproduccion de
CDs usa la unidad de DVD), entonces trate el siguiente comando como <tt>root</tt>:
<verb>
  $ ln -s /dev/cdrom /dev/dvd
</verb>

Alternativamente, si usted sabe cual unidad es la de DVD (p.e. <tt>/dev/hdc</tt>) entonces
puede usar el siguiente comando:
<verb>
  $ ln -s /dev/hdc /dev/dvd
</verb>

<sect>Viendo archivos AVI con Xine
<p>
Desde la version 0.3.6 en adelante, Xine ha podido reproducir archivos AVI de Windows sin ninguna
modificacion adicional. Para hacer esto, Xine usa los archivos manejadores de Windows
(DLLs) para reproducir las peliculas. Por defecto, Xine espera encontrar estos archivos
en el directorio <tt>/usr/lib/win32</tt>. Un archivo Zip que contiene estos DLLs para
ver la mayoria de los archivos AVI (incluyendo el popular formato DivX ;-)) esta
disponible desde <htmlurl url="http://bpinaud.free.fr/video"> y
<htmlurl url="http://divx.euro.ru/">
(el archivo se llama <tt>binaries.zip</tt>).

<sect1>Que hago si Xine se cae cuando trato de reproducir archivos AVI
<p>
El codec Win32 (soporte para archivos AVI) todavia es experimental. Deberia funcionar bien
si su sistema llena estos requerimientos:
<itemize>
<item>El manejador Xv esta funcionando.
<item>El archivo AVI contiene tipos de audio y video soportados por los DLLs
que usted posee.
<item>Usted tiene los DLLs apropiados en <tt>/usr/lib/win32/</tt>
</itemize>

pero por el momento puede caerse por cualquier razon no especifica. Hay problemas conocidos
con archivos que tienen pistas de audio extrañas.

<sect>Notas Especificas de Plataforma y Requerimientos
<p>
<sect1>FreeBSD
<p>
<sect2>Xine falla al asignar imagenes
<p>
Asegurese de que tiene suficiente memoria compartida disponible. Esta es
bastante limitada por defecto.

Edite el archivo <tt>/etc/sysctl.conf</tt>:
<verb>
  kern.ipc.shmmax=67108864
  kern.ipc.shmall=32768
</verb>

<sect2>Reproduciendo Video CDs
<p>
Actualmente (por problemas con el kernel de FreeBSD) Xine solo puede
reproducir VCDs desde unidades de cdrom ATAPI, no desde unidades SCSI.

Actualmente (Enero 2001), FreeBSD-stable (y por lo tanto tambien los
lanzamientos actuales) necesita un parche para las fuentes del kernel
para hacer que los VCDs funcionen (por favor revise la documentacion
de FreeBSD si usted no esta seguro sobre como construir un kernel
personalizado con este parche incluido).

El archivo que usted deber parchear es <tt>/sys/dev/ata/atapi-cd.c</tt> y
el parche esta incluido en el archivo <tt>README.freebsd</tt> que viene
con la distribucion del codigo fuente de Xine.

<sect>Incrementando el Rendimiento<label id="rendimiento">
<p>
Reproducir videos (especialmente DVDs) es <it>muy</it> arduo para el procesador.
Para ayudar a la reproduccion uniforme, Xine intenta usar varias formas de
aceleracion de hardware. La siguiente informacion es mayormente relevante para
las PCs x86 y Linux, asi que por favor envie cualquier recomendacion para otras
arquitecturas/Unices.

<sect1>Hardware
<p> Esta seccion lista algunos dispositivos que son utiles.
<sect2>Bus  y tarjeta de video AGP.
<p>
Una tarjeta grafica AGP permite a la computadora enviar los datos de video mas
eficientemente hacia la tarjeta. Consecuentemente esto permite video mas uniforme.
Es sumamente recomendado que usted tenga una.

<sect2>Acelerando la RAM (solo para expertos!)
<p>
Si a usted le gusta jugar con el BIOS, puede tratar poniendo todas las
opciones relacionadas con tiempos de RAM (como CAS delay, RAS to CAS
delay, ect) en el BIOS a 2.
Usted puede querer tratar algunos trucos bastante sucios, como se
explica en (por ejemplo)
<htmlurl url="http://www.overclockers.com/tips105/index03.asp">.
  Este sitio web se centra alrededor de una herramienta para Windows
  para ajustar ("tweak") el chipset, usted puede hacer lo mismo en
  FreeBSD con pciconf. En algunas distribuciones de Linux hay
  herramientas parecidas.
  Por favor contacte a heiko (<tt>heiko@users.sourceforge.net</tt>)
si usted tiene problemas o trucos sobre el ajustado del chipset
via apollo pro.

<p>Una utilidad de ajuste tambien puede ser encontrada en
<htmlurl url="http://powertweak.sourceforge.net">.

  Mas informacion acerca de esto puede ser encontrada en
<htmlurl url="http://oreilly.linux.com/pub/a/linux/2000/06/29/hdparm.html">

<sect1>Configure y utilize dispositivos 'crudos' ("raw devices") para accesar el dvd
<p>
  Los dispositivos crudos estan disponibles en el kernel de linux 2.4.x y hay
  parches para kernels mas viejos disponibles desde
<htmlurl url="ftp://ftp.kernel.org/pub/linux/kernel/people/sct/raw-io/">.
Para usar dispositivos crudos, primero conecte un dispositivo crudo libre a su dispositvo
de dvd, algo como
<verb>
  $ raw /dev/raw1 /dev/hdc
</verb>
  despues cree un ligue llamado "rdvd" apuntando al dispositivo crudo
<verb>
  $ ln -s /dev/raw1 /dev/rdvd
</verb>

<sect1>La extension XVideo
<p>
La extension XVideo es una caracterisitica del servidor-X XFree86 de la
version 4.0 en adelante. Actualmente es soportada en las siguientes tarjetas:
<descrip>
<tag/3DFX Voodoo 3/ El manejador 3dfx trabaja en
XFree86 version 4.0.3 y superior.
<tag/nVidia GeForce/ Xv solo funciona con los manejadores propios de nVidia. El lugar para
preguntar es las sala de IRC <tt>#nvidia</tt> en <tt>irc.openprojects.net</tt>. Pueden ser
descargados de <htmlurl url="http://www.nvidia.com/">
<tag/nVidia TNT2 y TNT1/ Como con la GeForce, solo los manejadores de NVidia funcionan.
<tag/Tarjetas ATI/ Ha sido reportado que Xv funciona con tarjetas basadas en Rage 128 y Mach64
con manejadores del proyecto GATOS (<htmlurl url="http://www.linuxvideo.org/">).
<tag/Tarjetas Matrox Gx00/ Xv funciona 'recien salido del horno'.
<tag/Intel i810 y i815/ Xv funciona 'recien salido del horno'.
<tag/Chips Savage/ Ha sido reportado que Xv funciona con algunas tarjetas Savages
usando un modulo del manejador modificado. Mas informacion y una lista de tarjetas
que funcionan estan disponibles en <htmlurl url="http://www.probo.com/timr/savage40.html">.
</descrip>

Si la extension Xv esta correctamente instalada,
la salida del programa <tt>xvinfo</tt> deberia ser algo similar a
lo siguiente:
<verb>
  Adaptor #1: "Matrox G-Series Backend Scaler"
    number of ports: 1
    port base: 47
    operations supported: PutImage
    supported visuals:
      depth 16, visualID 0x23
      depth 16, visualID 0x24
      depth 16, visualID 0x25
      depth 16, visualID 0x26
    number of attributes: 3
      "XV_COLORKEY" (range 0 to 16777215)
              client settable attribute
              client gettable attribute (current value is 2110)
      "XV_BRIGHTNESS" (range -128 to 127)
              client settable attribute
              client gettable attribute (current value is 0)
      "XV_CONTRAST" (range 0 to 255)
              client settable attribute
              client gettable attribute (current value is 128)
    maximum XvImage size: 1024 x 1024
    Number of image formats: 0
</verb>

Tambien puede ser que necesite cargar la extension v4l ("Video4Linux") para X. Teclee
<tt>xdpyingo | grep XV</tt>. Si '<tt>XVideo</tt>' forma parte de la salida, entonces usted
lo tiene. Si no, agregue '<tt>load "v4l"</tt>' en la seccion <tt>Modules</tt> de su
archivo XF86Config (normalmente <tt>/etc/X11/XF86Config</tt>) e intente de nuevo.
Despues intente el comando '<tt>xvinfo</tt>'. Si la salida es 'no adapter present', usted
no tiene soporte para XV. Revise si su tarjeta de video es soportada en el sitio web de
XFree86 (<htmlurl url="http://www.xfree86.org/">), instale cualquier software necesario
e intente de nuevo.

<sect1>MTRR (Linux)
<p>
De la documentacion del Kernel de Linux:
<verb>
  En la familia de procesadores P6 de Intel (Pentium Pro, Pentium II
  y posteriores) los Registros de Rango del Tipo de Memoria ("Memory
  Type Range Registers", MTRRs) pueden ser usados para controlar el
  acceso del procesador a los rangos de memoria. Esto es mas util cuando
  tiene una tarjeta de video (VGA) en un bus PCI o AGP. El activar la
  combinacion de escritura permite que las transferencias de escritura
  de bus sean combinadas para formar una transferencia mas grande antes
  de imprimirlo al bus PCI/AGP. Esto puede aumentar el rendimiento
  de las operaciones de escritura de imagenes unas 2.5 veces o mas.

  Los procesadores 6x86, 6x86MX y M II de Cyrix tienen Registros
  de Rango de Direciones ("Address Range Registers", ARRs) que proveen
  una funcionalidad similar a los MTRRs. Para estos procesadores, los ARRs son
  usados para emular los MTRRs.

  Los procesadores K6-2 (stepping 8 y mejores) y K6-3 de AMD tienen dos
  MTRRs. Estos son soportados.

  El Centaur C6 (WinChip) tiene 8 MCRs, permitiendo la combinacion de escritura. Estos
  son soportados.
</verb>

El asegurarse que los MTRRs estan configurados correctamente puede mejorar
<it>considerablemente</it> la uniformeidad de reproduccion cuando se usa el
metodo de salida XShm. Para revisar que su kernel soporta MTRR, revise la
presencia del archivo <tt>/proc/mtrr</tt>.

Teclee <tt>cat /proc/mtrr</tt> y verifique que hay una entrada relacionada con
la memoria de su tarjeta de video. Si no, entonces consulte el archivo <tt>mtrr.txt</tt>
en la documentacion del codigo fuente del kernel de Linux.

<sect1>Optimizando el acceso a las unidades
<p>
Lo siguiente aplica solo a unidades de disco IDE. Primeramente asegurese que su
tarjeta madre suporta el protocolo UDMA/33 (o un protocolo con un numero  de UDMA mayor).
Puede usar la utilidad <tt>hdparm</tt> para hacer que Linux utilize esta interfaz
para optimizar las transferencias de datos desde y hacia la unidad.

Mas detalles acerca de <tt>hdparm</tt> estan diponibles desde <htmlurl url="http://oreilly.linux.com/pub/a/linux/2000/06/29/hdparm.html">

<bf>Advertencia:</bf> <tt>hdparm</tt> es una utilidad peligrosa y el uso incorrecto
puede impactar en la habilidad de su computadora para leer desde la unidad. Usela
bajo su propio riesgo.

Revise que la salida de <tt>hdparm drive_device</tt> incluya la siguiente
linea:
<verb>
  S hdparm /dev/dvd
  ...
    using_dma    = 1 (on)
  ...
</verb>

Si esta apagado ("off") o si quiere cambiar cualquier opcion consulte la pagina
de manual de <tt>hdparm</tt> para mas detalles.

<sect>Resolucion de Problemas
<p>
La seccion siguiente lista algunos problemas comunes y sus soluciones. Si usted
es un usuario regular de Xine y siente que hay un problema comun que no esta aqui,
por favor envie un mensaje (en ingles) al administrador del HOWTO:
<verb>
  richwareham@users.sourceforge.net
</verb>
o si lo prefiere, en español a:
<verb>
  jeroot@angloamericano.ed.cr
</verb>

<sect1>No me aparece un boton "DVD" en Xine
<p>
Asegurese que el archivo <tt>/dev/dvd</tt> esta configurado correctamente (vea la
seccion sobre reproduccion de DVDs, mas atras).

<sect1>Todo parece bien pero a medio camino de un DVD la reproduccion para o
se repite.
<p>
Existe una pulga en el kernel 2.4.1. Necesitara actualizar.

<sect1>Me sale este mensaje: <tt>demux error! 00 00 00 (should be 0x000001)</tt>
<p>
Probablemente xine no puede accesar su fuente de entrada. Muy comunmente esto
pasa cuando se esta tratando de reproducir DVDs bloqueados/encriptados. Xine
no puede reproducir esos DVDs recien-sacado-del-horno (por razones legales).

Usted podria usar un plugin de entrada de DVD con soporte CSS para evitar esto.
Mas informacion esta disponible en <htmlurl url="http://xine.cjb.net/">. Note
que reproducir DVDs encriptados con CSS no es una caracteristica oficial
de Xine.

Usted puede tambien haber montado su unidad de DVD. Xine trata de sobrepasar
el sistema de archivos normal de Linux y por lo tanto no funcionara si el
DVD esta montado. Trate desmontandolo con el comando <tt>umount</tt>.

Otra razon podria ser que su unidad (RPC-2) DVD no esta configurada
para la region correcta.

<sect1>Me salen un monton de ``200 frames delivered, 200 frames skipped, 0 frames discarded''
<p>
Usted pudo haber elegido el canal de audio incorrecto o esta tratando
de reproducir un archivo que usa caracteristicas que Xine no soporta (todavia).

<sect1>Cuando reproduzco un archivo particular, Xine muestra algunas imagenes pero no hay audio
<p>
Trate otro canal de audio:
<verb>
  $ xine -a canal archivo.vob
</verb>

algunos archivos .VOB tienen audio en canales extraños (p.e. 3, 7, 10)

<sect1>Estoy teniendo problemas reproduciendo un SVCD
<p>
Xine <it>puede</it> reproducir SVCDs pero usted tendra que experimentar con los canales de audio.
Normalmente, deberia encontrar una pista de audio #8 y, para SVCDs bilingues, en #9, asi que
<verb>
  $ xine -a 8
</verb>

deberia permitirle presionar el boton ''vcd'' y reproducir sus SVCDs

<sect1>Xine pierde gran cantidad de recuadros
<p>

Su hardware puede ser demasiado lento para Xine.
Asegurese de activar todas las opciones
de optimizacion de velocidad.
Vea la seccion titulada <ref id="rendimiento" name="Incrementando el Rendimiento de Xine">
para mas detalles.

<sect1>El modo de Pantalla Completa no funciona
<p>
Revise que la extension Xv esta funcionando apropiadamente.

<sect1>El AC3 via S/PDIF no funciona con mi tarjeta de sonido
<p>
El AC3 via S/PDIF es soportado por ALSA solo para tarjetas de sonido
con chips Trident 4DWaveNX y YMF. Asi que si usted tiene una tarjeta
de sonido con uno de estos chips utilice
<verb>
  $ xine -S -A alsa
</verb>

El "switch" <tt>-S</tt> desabilita el decodificador AC3 interno. Para maquinas
muy lentas, esto podria mejorar la reproduccion de video (sin sonido)
cuando inicia Xine de esta forma:
<verb>
  $ xine -S -A null
</verb>

<sect1>Donde y como puedo obtener la ultima version en desarrollo?
<p>
Primero una frase de advertencia: la version en desarrollo es tan solo eso. Esta hecha
para desarrolladores. Puede que nisiquiera compile y puede no funcionar correctamente
si compilara. Si usted <it>tiene</it> que estar en el filo del habismo del desarrollo
entonces tomela de nuestro CVS:
<verb>
  $ cvs -d :pserver:anonymous@cvs.xine.sourceforge.net:/cvsroot/xine login
  (entre una contraseña vacia)
  $ cvs -d :pserver:anonymous@cvs.xine.sourceforge.net:/cvsroot/xine co xine
</verb>

<sect1>Como uso el plugin de dvd y/o el MRL <tt>dvd://</tt>?
<p>
El plugin de DVD que viene con Xine actualmente no soporta la reproduccion
de DVDs encriptados y/o bloqueados. Refierase a la seccion sobre Reproduccion
de DVDs para mas detalles sobre como obtener un 'plugin' especial para Xine
que permite la reproduccion de estos DVDs.
Dada la situacion legal incierta sobre la encripcion CSS nosotros no
incluimos nada de esa naturaleza en la distribucion de Xine, ni
apoyamos generalmente el uso de tal software (usted deberia revisar
si el uso de ese software es legal donde usted vive).
Nosotros esperamos que esta situacion cambie pronto.

Para dvds desbloqueados/desencriptados es una buena idea revisar
primero que archivos hay en el dvd, montandolo. Los archivos se llaman
algo como <tt>.../VIDEO_TS/VTS_xx_x.VOB</tt>, donde x son numeros.
Si usted ve los archivos .VOB grandes en un dvd, es probable que
la pelicula se encuentre en estos. Actualmente no soportamos la
reproduccion de peliculas completas sin cortes  - usted va a
tener que reproducir cada una de sus partes individualmente.

Para reproducir ese archivo VOB utilice algo como
<verb>
  $ xine dvd://VTS_xx_x.VOB
</verb>

Asegurese de no poner ninguna ruta (sin VIDEO_TS/).

Xine trata de abrir el dvd usando /dev/dvd. En FreeBSD esto solo
funcionara si usted crea un ligue simbolico a su nodo-dispositivo de
dvd.

<sect1>Me sale el mensaje "unable to open dvd drive (/dev/dvd)" o
Xine no es capaz de detectar mi reproductor de DVD
<p>
Usted probablemente no tiene /dev/dvd (revise eso). Si es asi,
simplemente cree un link /dev/dvd que apunte a su dispositivo
de DVD.
Los comandos
<verb>
  $ cd /dev
  $ ln -s hdc dvd
</verb>
deberian encargarse de eso.

<sect1>La razon de aspecto ("aspect ratio") es incorrecta!
<p>
Intente presionando "A" (preferiblemente cuando xine esta detenido,
de lo contrario podria experimentar una falla de segmentacion).

<sect1>Como reproduzco videos desde la STDIN?
<p>
usando algo como
<verb>
  $ cat archivo.mpg | xine stdin://mpeg1
</verb>

o, si usted tiene un video mpeg-2, use
<verb>
  $ cat archivo.vob | xine stdin://mpeg2
</verb>

<sect1>Como cambio la piel ("skin")?
<p>
Xine tiene la habilidad de personalizar su interfaz de usuario a traves de 'pieles'.
Eventualmente usted podra cambiar la piel desde el panel de control, pero por
ahora tendra que editar un archivo.

Ejecute xine al menos una vez - con eso deberia escribir el
archivo de configuracion <tt>.xinerc</tt> en su directorio
home. Ahora edite el archivo y cambie la linea "skin:default"
para que refleje la piel que desea usar.

<sect1>Como puedo cambiar el color/brillo/contraste?
<p>
Por el momento esto solo esta soportado en algunos manejadores Xv.
Usted encontrara tres entradas en su ~/.xinerc:
<verb>
  brightness:0
  saturation:0
  contrast:128
</verb>

los valores y posibles rangos dependen de su manejador Xv asi que tendra
que experimentar un poco para conseguir una buena imagen.

<sect1>Algunas partes de mi Escritorio X se ponen transparentes cuando Xine reproduce video!
<p>
Parece que algunos colores en su GUI concuerdan con la llave de color
que Xv usa. Puede cambiar el valor de la llave de color para evitar esto.
Deberia haber una linea como
<verb>
  colorkey:2110
</verb>

en su <tt>~/.xinerc</tt> donde puede cambiar el color que esta siendo usado por Xine para
la sobreposicion de video.

<sect1>No obtengo sonido, sino ''audio driver 'oss' failed, using null driver instead.''
<p>
Primero que todo, asegurese que sus manejadores de Audio OSS estan funcionando
(p.e. si puede oir musica con otro software).

La razon mas comun para esto es que otro programa esta accesando su
dispositivo de audio. Si esta usando linux, el comando ''<tt>fuser /dev/dsp</tt>''
deberia darle el PID del proceso.

<sect1>Despues de ejecutar xine varias veces, falla en repartir la memoria compartida
<p>
Esto deberia ser corregido en Xine 0.3.3 o posterior. Sin embargo, esto solo
funciona si usted sale de Xine de la forma "correcta" (p.e. usando el panel
o presionando "q"). <bf>NO</bf> cierre simplemente la ventana de salida de
video usando su manejador de ventanas - xine no soltara la memoria compartida
en este caso (!).

<sect1>Tengo problemas cuando uso Xine en FreeBSD
<p>
Revise si puede encontrar lo que esta buscando en el archivo README.freebsd
el cual es distribuido con el codigo fuente de Xine.

<sect1>Creo que estoy pronunciando Xine incorrectamente
<p>
Se pronuncia [ksi:n]. ksi como en la 'ks' en 'knocks' y n como la
'een' en 'been'.

<sect1>Creo que encontre una pulga!
<p>
Xine esta en su etapa de desarrollo temprano. Por favor sea paciente.
Si tiene tiempo, por favor contactenos y envienos un reporte de pulga
completo.
<bf>Por favor incluya toda la salida a consola de xine y algunos detalles
sobre su hardware y sistema operativo.</bf> Un reporte de pulga del tipo
'No puedo ver el DVD <it>x</it>' no sirve de mucho.

Nos puede contactar via email:
<verb>
  Lista de Correo de Xine <xine-user@lists.sourceforge.net>
</verb>

<sect>Contribuyendo a Xine
<p>
Xine esta en desarrollo continuo. Si usted esta interesado en involucrarse,
entonces obtenga la version en desarrollo del CVS y revise la lista en
el archivo <tt>TODO</tt>.

Por favor envie los parches a
<verb>
  Lista de Correo de Xine &lt;xine-user@lists.sourceforge.net>
</verb>

Recuerde que Xine es un esfuerzo voluntario y por lo tanto puede tomarle cierto
tiempo a los desarrolladores el responder sus mensajes.

<sect>Mas recursos
<p>
<sect1>Informacion sobre DVD
<p>
Usted puede encontrar informacion sobre cosas relacionadas con DVD en los siguientes sitios
<itemize>
<item><htmlurl url="http://www.linuxvideo.org/"> - Otro proyecto de codigo abierto sobre DVD.
Contiene mucha informacion y recursos para las aplicaciones de Video de Linux.
<item><htmlurl url="http://www.videolan.org/"> - Sitio frances (en ingles) que tiene como
proposito proveer software para distribuir video MPEG2 y DVD sobre una LAN.
<item><htmlurl url="http://www.opendvd.org/"> - Buen sitio que contiene mucha informacion sobre
las politicas del software de DVD.
</itemize>

<sect1>Recursos para los Desarrrolladores
<p>
<itemize>
<item><htmlurl url="http://www.linuxtv.org/"> - Grandes cantidades de codigo fuente e informacion
relacionada con la TV Digital y el DVD.
</itemize>

</article>
