Provided by: xawtv_3.102-3_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)