Provided by: xawtv_3.107-4_amd64 bug

NOMBRE

       xawtvrc -- fichero de configuración de programas de TV

SINOPSIS

       /etc/X11/xawtvrc
       $HOME/.xawtv

DESCRIPCIÓN

       xawtvrc  es  el  fichero  de  configuración  que originalmente usaba sólamente el xawtv (de ahí el nombre
       xawtvrc).  Ahora hay otros programas y utilidades de TV que lo leen también para obtener  información  de
       configuración.

       Estos  programas  usan  tanto  un fichero global (/etc/X11/xawtvrc) como uno personal ($HOME/.xawtv). Las
       opciones establecidas en el fichero personal tendrán preferencias sobre las globales.

   Programas
       Los siguientes programas usan estos ficheros de configuración:

       xawtv  El programa de TV clásico de X11.

       motv   Un mejorado GUI, basado en motif del xawtv ...

       fbtv   El programa para ver la tele en linux para la consola con framebuffer.

       ttv    Aplicación basada en aalib para ver la tele en cualquier terminal.

       v4lctl Herramienta de línea de comandos para controlar dispositivos video4linux.

   Crear el fichero de configuración
       Tanto xawtv como motv disponen de funciones para editar los canales y guardar la configuración.  Pero  la
       función para grabarla no conservará los comentarios que hubiera en el fichero de configuración ...

       También puede usar su editor de textos favorito y modificar el fichero de configuración directamente.

       También  es  posible  usar la utilidad de línea de comandos scantv para crear un fichero de configuración
       inicial.  scantv escaneará automáticamente todos los canales en busca de cadenas con emisión y  escribirá
       las que encuentre en el fichero de configuración.

SINTAXIS

       xawtvrc usa una sintaxis similar a la de smb.conf: las secciones empiezan con [nombre], seguida de líneas
       con parejas opción = valor.

       Hay  cuatro secciones especiales: [global], [launch], [eventmap] y [defaults].  Todas las demás secciones
       describen una cadena de TV cada una.

   Opciones de cadenas de TV.
       Las siguientes opciones son válidas para cadenas de TV y la  sección  [defaults].   Las  opciones  de  la
       sección  [defaults]  se  usan  --  como su nombre sugiere -- como valores por defecto para todoslos demás
       canales.  Puede poner todo lo que es común para todos los canales (como la norma de TV que se usa  en  su
       país) en la sección [defaults], de modo que ya no deberá especificarla para cada canal.

       Con una sección [defaults] razonable, sólo necesitará especificar el canal para cada cadena de TV de esta
       manera:

       [TVE]
       channel = 27

       El resto de opciones son:

       fine = n
              ajuste fino (lo mismo que las teclas cursor izq.+cursor der. hacen en el xawtv), por defecto: 0

       norm = pal | ntsc | secam
              la norma de TV, la opción por defecto es pal

       key = keysym
              Tecla  para  el  canal. Se permiten todas las teclas keysyms de X11.  Puede preceder una tecla con
              Modificador+, por ejemplo "Ctrl+F".

       capture = off | overlay | grabdisplay
              modo de captura: off, overlay (por defecto, tarjeta de TV => video, 0% cpu) o grabdisplay (tarjeta
              de TV => memoria principal => Servidor X => video, la proporción de cuadros por segundo depende de
              la carga y tamaño de la imagen).  Por defecto se usa overlay.  Si  no  es  posible  usar  el  modo
              overlay  por  alguna  razón  (display  remoto,  no  soportado  por  el  hardware,  lo que sea) las
              aplicaciones seleccionarán automáticamente el modo grabdisplay.

       input = Television | Composite1 | Composite2 | SVHS
              fuente de entrada.  Los valores válidos dependen del driver del hardware, los  valores  de  arriba
              son sólo ejemplos.  Puede usar "v4lctl list" para obtener una lista con las opciones válidas.

       color = n

       bright = n

       hue = n

       contrast = n
              El  rango  válido  va  de  0 a 65535, siendo 32768 el valor por defecto.  Añadiendo el símbolo del
              tanto por ciento cambia el rango de 0 a 100, por ejemplo "50%" es lo mismo que "32768".

       audio = mono | stereo | lang1 | lang2
              Establece el modo de audio para un determinado canal.

       freq = n
              Especifica la frecuencia para un determinado canal  (en  MHz,  el  transportador  de  video).   No
              debería necesitar esto para un uso normal, todos los canales deberían estar listado en la tabla de
              frecuencia de su zona (si no, envíeme un parche).  A no ser que quizás viva cerca de la frontera y
              el país vecino use un esquema de canales diferente.

       midi = nota
              Establece el evento midi de <nota> como tecla para el canal.

   Opciones globales
       Un número de opciones sin relación a los canales van en la sección "[global]":

       fullscreen = ancho x alto
              especifica  el  modo  de  video  que  se  debe  usar para el modo de pantalla completa.  Sólamente
              funciona con XFree, y por supuest es necesario un modeline válido para este  modo  en  su  fichero
              XF86Config.   También  debe  habilitar  la  extensión  VidMode  (opción  -vm, mire abajo) para que
              funcione.

       wm-off-by = [+-]x[+-]y
              Algunos gestores de ventanas no manejan correctamente la gravedad estática  (que  yo  sepa  mwm  y
              kwm).   Esto  es algo fastidioso en el modo a pantalla completa.  Con esta opción puede corregirlo
              mediante un desplazamiento para mover las ventanas.  Por ejemplo, wm-off-by = -4-24  soluciona  el
              problema en el kwm (el window manager del KDE1).

       freqtab =
              selecciona  el  mapeo de canal a frecuencia. La tabla de "Options window->Frequency" (en el xawtv)
              muestra un menú con todas  las  entradas  válidas  (y  permite  cambiar  de  tabla  en  tiempo  de
              ejecución).

       pixsize = ancho x alto
              tamaño  de  los  pixmaps  de  los canales (dentro de la ventana de canales).  0x0 deshabilita esta
              opción.

       pixcols = n
              número de columnas que se usarán en la ventana de canales. Por defecto: 1.

       mixer = ctl | device:ctl
              Esta opción permite controlar el volumen por medio del mezclador de la tarjeta de sonido.  ctl  es
              el  control  del  mezclador,  como por ejemplo "vol" para el volumen maestro. "line1" puede ser un
              buen candidato para la tarjeta de TV.  device es el dispositivo mezclador (sino se  especifica  se
              usará /dev/mixer).  El volumen se controla con las teclas del teclado numérico: + sube el volumen,
              - lo baja, Intro lo silencia.

       jpeg-quality = n
              establece el nivel de calidad para imágenes o cuadros (M)JPEG.  El rango válido es para n es [0 ..
              100] siendo 75 el valor por defecto.

       keypad-ntsc = on | off
              Configura el modo del teclado numérico.  Por defecto off.  Cuando se pone a on, los números que se
              tecleen en el teclado numérico serán interpretados como número de canales (así es como funciona el
              NTSC  TV).   De  otro  modo serán interpretados como canales programados, es decir, 1 es el primer
              canal del $HOME/.xawtv, ...

       keypad-partial = on | off
              Otro modo de configuración del teclado numérico. Por defectos on.  Cuando se pone a  off,  teclear
              un dígito en el teclado numérico no cambia el canal si hay canales de dos dígitos que empiezan por
              ese número.

       osd = on | off
              Habilita o deshabilita los textos en pantalla en el modo de pantalla completa.  Por defecto on.

       ratio = x:y
              Establece  un  aspect ratio fijo para la imagen de TV. El valor por defecto es 4:3.  Use 0:0 si no
              quiere un aspect ratio fijo.

       mov-driver = files | raw | avi | mov

       mov-video = ppm | pgm | jpeg | rgb | gray | 422 | 422p | rgb15 | rgb24 | mjpeg | jpeg | raw | mjpa | png

       mov-fps = fps

       mov-audio = mono8 | mono16 | stereo

       mov-rate = rate
              Establece los valores para grabaciones. No todas las combinaciones son  posibles.   "streamer  -h"
              mostrará una lista.

       midi = puerto
              Puede  especificar  un  puerto  ALSA por el cual xawtv recibirá eventos midi.  Configurado de este
              modo, puede programar las teclas de su teclado midi como teclas asignadas a canales y usar eventos
              del controlador midi para controlar los ajustes de volumen, brillo, etc.  Mire la  descripción  de
              la sección [eventmap] que hay más abajo para más detalles.

   La sección [launch]
       Es posible arrancar otros programas desde el xawtv.  Se configura con entradas en la sección "[launch]":

       label = tecla, línea de comandos
              La  tecla  especificada ejecutará el programa. También vale llamar la acción como "Launch(label)".
              Si quiere jugar con las tablas de traducción de Xt, siéntase libre de hacerlo.  Pero no  se  queje
              si rompe algo...

   La sección [eventmap]
       La  sección  eventmap  consiste simplemente en un número de líneas "evento = acción".  "acción" puede ser
       cualquier comando que el xawtv entienda (mire la página man del xawtv-remote para una  lista).   "evento"
       es  un evento generado por cualquier dispositivo de entrada de los que escucha el xawtv.  Un evento puede
       tener algún argumento, por ejemplo los eventos del midi-ctrl tienen uno.  Si está presente  el  argumento
       será añadido a la acción.

       Hay  mapeos  por defecto para eventos de entrada del lirc y del joystick, por tanto no será necesario que
       cree un eventmap para poder usarlos.  Pero en caso de que no le  guste  los  valores  por  defecto  puede
       cambiarlos fácilmente.

       A continuación hay una lista de eventos válidos:

       lirc-key-<nombre>
              Se ha pulsado la tecla <nombre> en el mando a distancia IR.

       joy-button-<n>
              Se pulsó el botón <n> del joystick.

       joy-axis-<left|right|up|down>
              El joystick se ha movido en la dirección especificada.

       midi-note-<n>
              Se ha recibido un evento de nota <n> (porque se ha pulsado una tecla en el teclado midi).

       midi-ctrl-<n>
              Se  ha  recibido  un  mensaje  del  controlador  midi  para  el control <n>.  Este evento tiene un
              argumento (el valor actual del control).

       kbd-key-<nombre>
              La tecla <nombre> se ha pulsado en el teclado.  Sólamente fbtv soporta esta opción.

   Ejemplo de fichero de configuración
       # esto es un comentario
       # las línea vacías también se ignoran

       [global]
       freqtab = europe-west
       #mixer   = line
       jpeg-quality = 75
       midi = 64:0
       fullscreen = 768x576

       # para el /etc/XF86Config
       # Modeline  "pal"  50.00  768 832 856 1000  576 590 595 630  -hsync -vsync

       [launch]
       mixer = M, gtkaumix
       AleVT = Ctrl+A, alevt

       [eventmap]
       midi-ctrl-7 = volume

       [defaults]
       input = television
       norm  = pal

       [TVE 1]
       channel=E11
       key=F1

       [La 2]
       channel = 43
       key = F2

       # las demás cadenas van aquí

       [Cámara]
       input = Composite1
       key = K

VEA TAMBIÉN

       scantv(1), xawtv(1), motv(1), fbtv(1), ttv(1), v4lctl(1)

TRADUCCIÓN

       Página traducida al español por Ricardo Villalba <rvm@escomposlinux.org>

                                                                                                      xawtvrc(5)