  *************************************
   XINE: Un reproductor libre de vÃ­deo
  *************************************


TraducciÃ³n:                   
  Alfredo J. Delaiti (2002-05),
  Carlos E. Robinson (2008-02)



Ãndice general

    1 LA DOCUMENTACIÃN
        1.1 Alcance de este documento
    2 ACERCA DE XINE
        2.1 Plataformas soportadas y requisitos
        2.2 Software usado
        2.3 Desarrolladores de xine
        2.4 Uso
            2.4.1 Atajos de teclado
                Cambiando atajos:
                Siguiendo la pista a nombres de teclas en X11: 
                Mostrando los atajos activos/remapeados:
            2.4.2 Seleccionando los canales de sonido
            2.4.3 Seleccionando los subtÃ­tulos
            2.4.4 LIRC
                Lista de reproducciÃ³n
            2.4.5 Ajustando opciones de configuraciÃ³n en la lÃ­nea de Ã³rdenes
    3 Lo que queda por decir
        3.1 Libertad, DVDs y cosas...
    4 Contactando con el proyecto xine



1 LA DOCUMENTACIÃN

  1.1 Alcance de este documento

Este es el documento para el usuario final de xine-lib y xine-ui. 
EncontrarÃ¡ mÃ¡s documentaciÃ³n en el directorio doc/ de ambos paquetes. Mire 
tambiÃ©n el FAQ (preguntas frecuentes) incluido con el paquete xine-ui que 
pudiera tener las respuestas a sus preguntas.

2 ACERCA DE XINE

xine es un reproductor de vÃ­deo para sistemas tipo unix con licencia libre 
GPL. Soporta secuencias de vÃ­deo mpeg-2 y mpeg-1 (sonido + vÃ­deo 
multiplexado), secuencias elementales mpeg (sÃ³lo sonido/imagen, ej. 
archivos mp3), archivos AVI con varios formatos (algunos de ellos usando 
los codec en dlls de win32) y secuencias Vorbis OGG. Hay algÃºn soporte para 
secuencias quictime (pero la mayorÃ­a de los cÃ³decs quicktime de audio y 
vÃ­deo son altamente propietarios y por tanto no soportados).

xine reproduce secuencias de imÃ¡genes y sonidos y sincroniza la 
reproducciÃ³n de ambos. Dependiendo de las propiedades de la secuencia a 
reproducir, se necesitarÃ¡ mÃ¡s o menos potencia de procesador; se ha visto 
reproduciÃ³n con frecuencia de cuadro completa en sistemas con un P II a 400 
MHz. 

xine puede reproducir directamente VÃ­deo CDs, SVCDs y DVDs. 
Desgraciadamente el estado legal en la reproducciÃ³n de DVD bloqueados / 
encriptados en algunos paÃ­ses es incierta, por lo tanto no podemos incluir 
ningÃºn cÃ³digo de desencriptaciÃ³n/desbloqueo con xine. Para reproducir este 
tipo de DVDs necesitarÃ¡ programas externos o algo como un xine_dvd_plugin 
que pueda manejar autentificaciÃ³n / descodificaciÃ³n (descrambling) del DVD.

El projecto xine niega cualquier responsabilidad en tales usos de xine.

A partir de xine 0.5 hemos introducido un nueva arquitectura ofreciendo 
complementos (plugins) flexibles para varias tareas, asÃ­ varios otros tipos 
de secuencias y dispositivos de salida pueden ser soportados en un futuro.

2.1 Plataformas soportadas y requisitos

â¢ xine necesita un servidor X11 para la salida de vÃ­deo
  (de 8, 15, 16, 24 o 32 bit de profundidad de color)

â¢ xine puede detectar y usar X vÃ­deo del MIT y la extensiÃ³n de memoria 
  compartida de X para un mejor rendimiento

â¢ si no puede conseguir que Xv corra en su plataforma deberÃ­a usar una 
  profundidad de color de 16bpp para tener mejor velocidad. Xv parece 
  funcionar muy bien para cualquier profundidad de color.

â¢ si usted tiene un adaptador grÃ¡fico Matrox G200/G400/G450 puede 
  opcionalmente usar el controlador de salida de vÃ­deo sybcfb/teletux. Vea 
  README.syncfb para mÃ¡s detalles.

â¢ para la reproducciÃ³n de sonido se soportan OSS, ALSA, ESD y ARTSD.

â¢ aaxine usa aalib para la salida y puede correr en casi cualquier 
  terminal.

â¢ para construir xine se requieren GNU make, gcc y binutils bastante 
  recientes.

xine deberÃ­a correr en cualquier mÃ¡quina reciente compatible i386 (pentium 
y mÃ¡s) que use GNU/linux o FreeBSD. Dependiendo del tipo de flujo de vÃ­deo 
que quiera reproducir necesitarÃ¡ mÃ¡s o menos potencia de procesador para 
una reproducciÃ³n fluÃ­da. Por regla general, los DVDs funcionarÃ¡n bien en un 
Pentium II a 400 (o equivalente). Hay muchos factores en esta ecuaciÃ³n, asÃ­ 
que sus resultados pueden variar.

Tarjetas grÃ¡ficas comprobadas con Ã©xito (usando Xv) para PCs incluyen: 
nVidia Riva TNT (con manejador de cÃ³digo cerrado nvidia), nVidia Riva TNT 
2, Matrox G400, ATI AIW Rage128-16MB, 3dfx voodoo3 2000 PCI 16Mb.

Las siguientes tarjetas han sido reportadas como que funcionan, pero no 
estÃ¡ claro si funcionarÃ¡n con Xv o sÃ³lo con XShm (por favor, repÃ³rtelo en 
la lista de correo xine-user):

Trident 9660, ATI AIW M64-8Mb PCI, ATI RageII 8MB.

xine deberÃ­a ser capaz de mostrar vÃ­deo en cualquier tipo de servidor X que 
funcione, con cualquier tipo de tarjeta grÃ¡fica, pero con mucho peor 
rendimiento que con Xv.

Adicionalmente, xine funciona en plataformas i386-solaris, maquinas sparc 
ccorriendo linux o solaris (se sabe que Creator-3D framebuffer funciona), 
vea README.solaris por mÃ¡s informaciÃ³n. TambiÃ©n estÃ¡n soportados: algunos 
sistemas basados en powerpc (con linux) e IRIX en MIPS.

Por Ãºltimo pero no menos importante, xine ha sido reportado que funciona en 
mÃ¡quinas Alpha, IA-64 y S/390.

2.2 Software usado

xine usa cÃ³digo de los siguientes projectos de software libre externos:

â¢ liba52 por Aaron Holtzman y Michel Lespinasse

â¢ libmpeg2 por Aaron Holtzman y Michel Lespinasse

â¢ libmad por Robert Leslie

â¢ libffmpeg por Fabrice Bellard

Sin esas magnÃ­ficas obras de software, por supuesto que xine no estarÃ­a 
donde estÃ¡ ahora.

TambiÃ©n muchas gracias al proyecto de vÃ­deo linux y DVD âLiViDâ, de donde 
vinieron las ideas originales para el reproductor xine.

==> [http://www.linuxvideo.org/] 

2.3 Desarrolladores de xine

ProgramaciÃ³n principal de xine

   Guenter Bartsch <guenter@users.sourceforge.net>

Varias sugerencias, correcciÃ³n de gazapos y construcciones, complemento 
alsa, igu (gui )

   Daniel Caujolle-Bert <f1rmb@users.sourceforge.net>

Muchas correciones de gazapos y bloqueos muertos, detecciÃ³n de ritmo bit, 
desentrelazador en software, actualizaciones masivas de libwin32

   Miguel Freitas <miguel@cetuc.puc-rio.br>

MÃ³dulo de salida de vÃ­deo teletux/syncfb, varias correcciones de gazapos / 
revisiones, alsa

   Joachim Koenig <Joachim.Koenig@gmx.net>

Desarrollo liba52/libmpeg2

   Michel Lespinasse <walken@zoy.org>

Paquete Debian, soporte de usuario

   Siegfried Langauf <siggi@users.sourceforge.net>

Y varios contribuidores mÃ¡s, vea el fichero xine-lib/AUTHORS

2.4 Uso

Puede iniciar xine sin especificar ningÃºn parÃ¡metro en la lÃ­nea de Ã³rdenes 
o directamente especificando una o mÃ¡s secuencias de entrada. xine trata de 
detectar si puede usar la extensiÃ³n Xv y si no pasarÃ¡ a XShm, pero esa 
detecciÃ³n podrÃ­a fallar. Puede especificar el complemento para la salida de 
vÃ­deo usando la opciÃ³n "-V". ej.

xine -V Xshm



obliga a xine a usar XShm o X11 simple.

Si quiere enviar el sonido por una red con ESD, defina la variable de 
entorno ESPEAKER antes de iniciar xine.

El flujo de entrada puede ser un nombre de archivo o algo que llamamos 
"MediaResourceLocator" MRL (localizador de medios) que es similar similar a 
un URL. Primero especifique una fuente de entrada la cual es seguida por 
"://" y un identificador especÃ­fico de la fuente de entrada. QuÃ© fuentes de 
entrada pueda usar, depende los complemento de entrada que tenga (para 
ficheros simples puede omitir la identificaciÃ³n de la fuente de entrada). 

Pruebe:

$ xine --help

para tener informaciÃ³n mÃ¡s completa de su forma de uso.

xine soporta el protocolo xdnd (VersiÃ³n 3) asÃ­ que si tiene una aplicaciÃ³n 
navegador de ficheros que soporte ese protocolo (ej. gmc) puede dejar caer 
ficheros de vÃ­deo sobre xine para su reproducciÃ³n.

Reproducir la pista 3 de un VCD:

$ xine vcd://3

Ejemplo para acceso directo a un DVD:

$ xine dvd://VTS_01_1.VOB

2.4.1 Atajos de teclado



  
  Tecla                    AcciÃ³n                                                         
  [Intro]                  reproducciÃ³n                                                   
  [Espacio]                pausa                                                          
  [Arriba]/[Abajo]         avance rÃ¡pido / lento                                          
  0-9                      introduzca el dÃ­gito correspondiente                           
  /                        se desplaza el % relativo al dÃ­gito previamente introducido    
  [Izq][Der]               se desplaza Â±15 segs (+CTRL: 60 segs)                          
  f                        conmuta pantalla completa                                      
  a                        conmuta la razÃ³n de aspecto (AUTO/16:9/4:3/DVB)                
  i                        conmuta modo entrelazado                                       
  z / ^Z                   acercar zoom / alejar                                          
                           con Ctrl hace zoom horizontal y con Meta lo hace vertical      
  "<", ">"                 modificar el tamaÃ±o de la ventana de salida                    
  + -                      cambiar el canal de audio                                      
  , .                      cambiar el canal de subtÃ­tulos                                 
  n m                      ajustar sincronismo audio / vÃ­deo                              
  [HOME]                   reiniciar sincronismo a / v                                    
  [INSERT]                 conmutar la captura de ratÃ³n en la ventana de salida de vÃ­deo  
  q                        salir                                                          
  h                        esconder la ventana de vÃ­deo (util para reproducir mp3)        
  Y mÃ¡s que vendrÃ¡n :-)                                                                   


Haga clic derecho del ratÃ³n (o pulse 'g') en la ventana vÃ­deo para 
(des)activar la visualizaciÃ³n del panel.

  Cambiando atajos:

  Puede tambien cambiar uno/muchos/todos los atajos. Para esto, debe tener 
un mapa de teclado en su directorio $HOME/.xine/. La sintaxis de las teclas 
es:

WindowReduce {
  key = less
  modifier = none
}

La tecla deberÃ­a encajar con los nombres de teclas X11 (ver abajo). El 
modificador puede ser:

â¢ 'none' para no modificador,

â¢ 'control' (o 'ctrl') para la tecla de control,

â¢ 'meta' (o 'alt' en los PC) para la tecla meta,

â¢ 'mod3' o 'mod4' o 'mod5' sÃ³lo estÃ¡ disponible en algunas plataformas.

Los modificadores pueden mezclarse, separandolos con comas:

WindowReduce {
   key = less
   modifier = control, alt
}

Si no especifica una lÃ­nea modificadora eso equivale a especificar 'none' 
(ninguno).

Puede tambiÃ©n aÃ±adir alias de teclas, como:

Alias {
  entry = Pause
  key = p
}

Lo que significa que aÃ±ade otra pulsaciÃ³n de tecla a la entrada 'Pause', 
pulsando 'p', tambiÃ©n puede aÃ±adir una secciÃ³n modificadora (ver arriba). 
Si no la especifica, el modificador serÃ¡ el mismo que en la secciÃ³n 
original ('Pause' en este caso).

  Siguiendo la pista a nombres de teclas en X11: 

  Para saber el nombre de una tecla en X11, podrÃ­a usar 'xev', que se 
suministra con su paquete X11. Arranque 'xev' desde un xterm, dÃ©le el foco 
a la ventanita, y pulse la tecla que quiera especificar.

Entonces verÃ¡ algo como esto:

KeyRelease event, serial 27, synthetic NO, window 0x3200001,
         root 0x3c, subw 0x0, time 4144050914, (259,265), root:(272,319),
         state 0x0, keycode 81 (keysym 0xff9a, KP_Prior), same_screen YES,
                                               ^^^^^^^^
                                   Esto es lo que busca

Sobre el botÃ³n del ratÃ³n, por ejemplo para usar la rueda del ratÃ³n, tiene 
que seguir la pista a quÃ© botÃ³n se le asignarÃ¡ a una funciÃ³n, usando xev:

ButtonRelease event, serial 27, synthetic NO, window 0x1200001,
         root 0x3b, subw 0x0, time 2710360666, (107,87), root:(120,117),
         state 0x1000, button 5, same_screen YES
                       ^^^^^^^^
               Este es el botÃ³n

En este caso, tiene que poner "key = XButton_5". Las teclas modificadoras 
tambiÃ©n se soportan con el manejo de botÃ³n de ratÃ³n.

  Mostrando los atajos activos/remapeados:

PodrÃ­a usar 'xine --keymap' o 'xine --keymap=default' para mostrar los 
atajos por omisiÃ³n. Puede redirigir el resultado a un fichero, que puede 
convertirse en el propio ~/.xine/keymap

Para ver el resultado de un remapeado simplemente use 'xine 
--keymap=remapped'.

2.4.2 Seleccionando los canales de sonido

Proporcione la opciÃ³n -a para seleccionar la pista de sonido deseada:

xine --a 3 test.mpg

reproduce la tercera pista de sonido disponible (y por supuesto, la 
imagen).

Alternativamente el igu (gui) puede ser usado para seleccionar un canal de 
audio.

2.4.3 Seleccionando los subtÃ­tulos

Los subtÃ­tulos son incluidos en pistas diferentes como el sonido. En 
general, la pista 0 es el subtÃ­tulo del idioma por omisiÃ³n. Use la opciÃ³n 
-u para seleccionar la pista de subtÃ­tulo deseada:

xine --u 0 test.vob

muestra los subtÃ­tulos de la secuencia o flujo 0.

Alternativamente el igu (gui) puede ser usado para seleccionar un canal de 
subtÃ­tulos.

2.4.4 LIRC

xine puede ser controlado remotamente via infrarojos (IR). Para esto 
deberÃ­a tener instalado LIRC ([http://www.lirc.org]).

DeberÃ­a aÃ±adir algunas entradas en su ~/.lircrc, tales como 

begin
        remote = SAMSUNG
        button = Button_Play
        prog   = xine
        repeat = 0
        config = Play
end

begin
        remote = SAMSUNG
        button = Button_1
        prog   = xine
        repeat = 0
        config = SetPosition10%
end

xine puede autogenerar un borrador de configuraciÃ³n para lirc, usando 'xine 
--keymap=lirc', y entonces puede redirigir la salida a un fichero para 
afinar la configuraciÃ³n.

Cada entrada tendrÃ¡ este aspecto:

# Reduce the output window size.

begin
       remote = xxxxx
       button = xxxxx
       prog   = xine
       repeat = 0
       config = WindowReduce
end

Es todo suyo para especificar el nombre remoto y asignar el botÃ³n.

  Lista de reproducciÃ³n

Para recuperar una lista de reproducciÃ³n de un complemento de entrada dado, 
puede usar la plabra clave 'PlaylistFrom:', seguida del nombre del 
complemento (el mismo que en el botÃ³n de la ventana del panel[Nota al pie:
N. del T.: ObservaciÃ³n: es posible que algunos de estos nombres estÃ©n 
traducidos. Si esto supone un problema, me (nos) gustarÃ­a saberlo para 
corregirlo.
]):

# Retrieve playlist from NAV plugin.

begin
       remote = xxxxx
       button = xxxxx
       prog   = xine
       repeat = 0
       config = PlaylistFrom:NAV
end

2.4.5 Ajustando opciones de configuraciÃ³n en la lÃ­nea de Ã³rdenes

Puede cambiar cualquier opciÃ³n (vea README.config_en) desde la lÃ­nea de 
Ã³rdenes para anular el valor por omisiÃ³n en $HOME/.xine/config.

Por ejemplo, puede hacer algo como:

xine vcd://1 opt:media.vcd.device=/dev/cdrom2 vcd://1

para cambiar el vcd_device entre la mitad de la repoducciÃ³n de dos mrls.

Estos ajustes opcionales no se grabarÃ¡n en el fichero de configuraciÃ³n, son 
solo temporales.

3 Lo que queda por decir

3.1 Libertad, DVDs y cosas...

xine es software libre. âSoftware libreâ tiene que ver con ser âcÃ³digo 
abiertoâ. Sin embargo, el significado de âsoftware libreâ va mÃ¡s allÃ¡ de 
simplemente eso: es sobre la libertade de los usuarios de software 
(programas). Si tiene tiempo, por favor lea lo que la fundaciÃ³n del 
software libre dice acerca de las cuestiones de libertad y software

  => [http://www.gnu.org/philosophy/free-sw.html]

Hay una amenaza especial a la libertad cuando hablamos de DVDs: la 
industria del cine estÃ¡ haciendo enormes esfuerzos para restringir la 
reproducciÃ³n de DVDs a dispositivos controlados. La mayorÃ­a de los DVDs que 
se venden actualmente estÃ¡n encriptados de una manera propietaria - y en 
algunos paises (especialmente E.E.U.U.), es posiblemente ilegal 
descifrarlos - incluso para reproducciÃ³n privada. Esperanzadoramente, la 
mayorÃ­a de la gente estarÃ¡ de acuerdo de que es una manera muy questionable 
de tratar a los clientes. El proyecto xine condena estos esfuerzos de la 
industria del cine - intentar prevenir pÃ©rdida de beneficios de ventas de 
esa manera demuestra falta de respeto hacia todos sus clientes honestos. 
Por otra parte, el proyecto xine estÃ¡ en contra de violar la ley existente. 
Nadie sabe exactamente si es realmente ilegal en cualquier parte del mundo 
escribir, poseer y usar software para ver DVDs cifrados. Pero como esto es 
un tema no claro (que parece potencialmente muy peligroso), xine no 
contiene nigÃºn cÃ³digo especÃ­fico para descifrar DVDs. Parece, sin embargo, 
que terceras partes estÃ¡n trabajando en tales complementos. Posiblemente en 
algunas partes es legal usarlos. De cualquier forma - no podrÃ¡ reproducir 
DVDs con xine tal cual. Por favor, observe que esto no es un gazapo o una 
âfuncionalidad que falteâ, sino un problema genuinamente legal. SerÃ­a muy 
bueno solucionar el problema (p.e., convenciendo a E.E.U.U. y/o la 
industria del cine que estÃ¡n realmente molestando y siendo innecesariamente 
injustos con sus clientes y tambiÃ©n usuarios y desarrolladores de software 
libre), pero incluir cÃ³digo para descifrar DVDs en xine no solucionarÃ¡ este 
problema.

4 Contactando con el proyecto xine

El sitio web del proyecto xine es

  => [http://xine.sourceforge.net]

Reacciones u ofertas de ayuda serÃ¡n muy apreciadas, por favor contacte:

  => [mailto://xine-user@lists.sourceforge.net||la lista de usuarios de xine]

