Provided by: xawtv_3.102-3_i386 bug

NOMBRE

       xawtvrc -- fichero de configuracion de programas de TV

SINOPSIS

       /etc/X11/xawtvrc
       $HOME/.xawtv

DESCRIPCI'ON

       xawtvrc   es  el  fichero  de  configuracion  que  originalmente  usaba
       solamente el xawtv  (de  ahi  el  nombre  xawtvrc).   Ahora  hay  otros
       programas  y  utilidades  de  TV  que  lo  leen  tambien  para  obtener
       informacion de configuracion.

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

   Programas
       Los siguientes programas usan estos ficheros de configuracion:

       xawtv  El programa de TV clasico 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    Aplicacion  basada  en  aalib  para  ver  la  tele  en cualquier
              terminal.

       v4lctl Herramienta de linea de  comandos  para  controlar  dispositivos
              video4linux.

   Crear el fichero de configuraci'on
       Tanto  xawtv  como motv disponen de funciones para editar los canales y
       guardar la configuracion.  Pero la funcion para grabarla no  conservara
       los comentarios que hubiera en el fichero de configuracion ...

       Tambien  puede usar su editor de textos favorito y modificar el fichero
       de configuracion directamente.

       Tambien es posible usar la utilidad de linea de  comandos  scantv  para
       crear   un   fichero   de   configuracion  inicial.   scantv  escaneara
       automaticamente todos los canales en busca de  cadenas  con  emision  y
       escribira las que encuentre en el fichero de configuracion.

SINTAXIS

       xawtvrc  usa  una  sintaxis  similar  a  la  de smb.conf: las secciones
       empiezan con [nombre], seguida de lineas con parejas opcion = valor.

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

   Opciones de cadenas de TV.
       Las siguientes opciones son validas para cadenas de  TV  y  la  seccion
       [defaults].   Las  opciones de la seccion [defaults] se usan -- como su
       nombre sugiere -- como valores por defecto para todoslos demas canales.
       Puede  poner todo lo que es comun para todos los canales (como la norma
       de TV que se usa en su pais) en la seccion [defaults], de modo  que  ya
       no debera especificarla para cada canal.

       Con  una  seccion  [defaults] razonable, solo necesitara 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 opcion 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 proporcion de cuadros por segundo
              depende de la carga y tamano de la imagen).  Por defecto se  usa
              overlay.  Si no es posible usar el modo overlay por alguna razon
              (display remoto, no soportado por el hardware, lo que  sea)  las
              aplicaciones seleccionaran automaticamente el modo grabdisplay.

       input = Television | Composite1 | Composite2 | SVHS
              fuente  de entrada.  Los valores validos dependen del driver del
              hardware, los valores de arriba son solo ejemplos.   Puede  usar
              "v4lctl list" para obtener una lista con las opciones validas.

       color = n

       bright = n

       hue = n

       contrast = n
              El  rango  valido  va  de  0  a 65535, siendo 32768 el valor por
              defecto.  Anadiendo el simbolo 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 deberia necesitar esto para un  uso
              normal,  todos los canales deberian estar listado en la tabla de
              frecuencia de su zona (si no, envieme un parche).  A no ser  que
              quizas viva cerca de la frontera y el pais vecino use un esquema
              de canales diferente.

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

   Opciones globales
       Un numero de opciones sin relacion a los  canales  van  en  la  seccion
       "[global]":

       fullscreen = ancho x alto
              especifica  el  modo  de  video que se debe usar para el modo de
              pantalla completa.  Solamente funciona con XFree, y por  supuest
              es  necesario  un  modeline  valido para este modo en su fichero
              XF86Config.  Tambien debe habilitar la extension VidMode (opcion
              -vm, mire abajo) para que funcione.

       wm-off-by = [+-]x[+-]y
              Algunos   gestores  de  ventanas  no  manejan  correctamente  la
              gravedad estatica (que  yo  sepa  mwm  y  kwm).   Esto  es  algo
              fastidioso  en  el  modo  a  pantalla completa.  Con esta opcion
              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 menu con todas las
              entradas validas (y  permite  cambiar  de  tabla  en  tiempo  de
              ejecucion).

       pixsize = ancho x alto
              tamano  de  los  pixmaps de los canales (dentro de la ventana de
              canales).  0x0 deshabilita esta opcion.

       pixcols = n
              numero de columnas que se usaran en la ventana de  canales.  Por
              defecto: 1.

       mixer = ctl | device:ctl
              Esta opcion 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 usara /dev/mixer).  El volumen
              se controla con las teclas  del  teclado  numerico:  +  sube  el
              volumen, - lo baja, Intro lo silencia.

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

       keypad-ntsc = on | off
              Configura  el  modo  del  teclado  numerico.   Por  defecto off.
              Cuando se pone a on, los numeros que se tecleen  en  el  teclado
              numerico seran interpretados como numero de canales (asi es como
              funciona el NTSC TV).  De otro  modo  seran  interpretados  como
              canales  programados,  es  decir,  1  es  el  primer  canal  del
              $HOME/.xawtv, ...

       keypad-partial = on | off
              Otro modo de configuracion del teclado  numerico.  Por  defectos
              on.   Cuando  se  pone  a  off,  teclear un digito en el teclado
              numerico no cambia el canal si hay canales de  dos  digitos  que
              empiezan por ese numero.

       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" mostrara una lista.

       midi = puerto
              Puede  especificar  un  puerto  ALSA  por el cual xawtv recibira
              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  descripcion  de  la  seccion
              [eventmap] que hay mas abajo para mas detalles.

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

       label = tecla, l'inea de comandos
              La tecla especificada ejecutara el programa. Tambien vale llamar
              la accion como "Launch(label)".  Si quiere jugar con las  tablas
              de  traduccion  de  Xt,  sientase  libre de hacerlo.  Pero no se
              queje si rompe algo...

   La secci'on [eventmap]
       La seccion eventmap consiste simplemente en un numero de lineas "evento
       =  accion".  "accion" puede ser cualquier comando que el xawtv entienda
       (mire la pagina 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  algun  argumento,  por  ejemplo  los
       eventos  del  midi-ctrl tienen uno.  Si esta presente el argumento sera
       anadido a la accion.

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

       A continuacion hay una lista de eventos validos:

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

       joy-button-<n>
              Se pulso el boton <n> del joystick.

       joy-axis-<left|right|up|down>
              El joystick se ha movido en la direccion 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.   Solamente  fbtv
              soporta esta opcion.

   Ejemplo de fichero de configuraci'on
       # esto es un comentario
       # las linea vacias tambien 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 demas cadenas van aqui

       [Camara]
       input = Composite1
       key = K

VEA TAMBI'EN

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

TRADUCCI'ON

       Pagina     traducida     al     espanol     por     Ricardo    Villalba
       <rvm@escomposlinux.org>

                                                                    xawtvrc(5)