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