Provided by: xawtv_3.95.dfsg.1-8ubuntu2_i386 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)