tvtime.xml(5)                 File Formats Manual                tvtime.xml(5)



NOMBRE
       tvtime.xml - fichero de configuracion de tvtime


SINOPSIS
       ~/.tvtime/tvtime.xml
       /etc/tvtime/tvtime.xml


DESCRIPCION
       El archivo tvtime.xml es el principal fichero de configuracion de
       tvtime.  Contiene todos los ajustes por defecto y las asociaciones de
       teclas. El archivo tvtime.xml es actualizado por tvtime en ejecucion,
       para conservar ajustes entre sesiones.  Por esta razon, no debes editar
       el fichero tvtime.xml mientras tvtime esta en ejecucion, o tus cambios
       podrian ser sobre-escritos.

       La sintaxis global es como sigue:

           <?xml version="1.0"?>
           <!DOCTYPE tvtime PUBLIC "-//tvtime//DTD tvtime 1.0//EN"
             "http://tvtime.sourceforge.net/DTD/tvtime1.dtd">
           <tvtime xmlns="http://tvtime.sourceforge.net/DTD/">
           </tvtime>

       Puedes encontrar el DTD y mas informacion sobre los archivos de
       configuracion XML en http://tvtime.sourceforge.net/DTD/
       <http://tvtime.sourceforge.net/DTD/>


OPCIONES
       tvtime soporta multitud de opciones. La etiqueta <option> debe estar
       contenida dentro de una etiqueta <tvtime>

       Lo siguiente es una lista de opciones y sus valores por defecto,
       acompanadas de una descripcion de lo que la opcion hace.


       <option name="Verbose" value="0"/>
              El modo verboso indica que debe mostrarse todos los mensajes
              informativos y de precaucion por stderr mientras ejecuta tvtime.
              De otra forma, solo los errores criticos serian mostrados.


       <option name="V4LDevice" value="/dev/video0"/>
              Establece el dispositivo de captura por defecto.


       <option name="V4LInput" value="0"/>
              Establece la entrada de la capturadora que abre por defecto
              tvtime.  Por ejemplo, mi tarjeta WinTV tiene el sintonizador en
              0, y la entrada de video compuesto en 1.  Las fuentes pueden
              cambiarse en tiempo de ejecucion usando el comando toggle_input
              cuya tecla asociada es "i" por defecto.


       <option name="Norm" value="NTSC"/>
              Establece la norma de TV por defecto. Valores validos son:

              o     NTSC
              o     NTSC-JP
              o     SECAM
              o     PAL
              o     PAL-Nc
              o     PAL-M
              o     PAL-N
              o     PAL-60


       <option name="SaveAndRestorePictureSettings" value="1"/>
              Esta opcion indica si tvtime deberia guardar y restaurar sus
              propios ajustes de imagen tanto al arrancar como al cambiar de
              canal.


       <option name="AudioMode" value="stereo"/>
              Esta opcion guarda el ultimo modo de audio usado. Se usara para
              recordar que modo de audio se usara cuando la aplicacion sea
              iniciada la proxima vez. Opciones validas son "mono", "stereo",
              "lang1", "lang2" o "sap".


       <option name="AudioBoost" value="-1"/>
              Esta opcion establece la amplificacion de audio. Se trata de un
              porcentaje que establece el nivel de volumen procedente de la
              tarjeta capturadora. Por defecto, tvtime no utiliza esta
              amplificacion.  Sin embargo, como a veces el volumen por defecto
              de la capturadora no es idoneo o ha sido establecido por otra
              aplicacion, puedes usar este valor para tener siempre tu volumen
              preferido. Usa -1 para que tvtime no utilice esta amplificacion.


       <option name="ShowCC" value="0"/>
              Esta opcion guarda el estado de la decodificacion "closed
              caption".  Se denomina "closed caption" a la trascripcion
              textual de la senal de audio especifica de NTSC para los
              disminuidos auditivos.


       <option name="ColourInvert" value="0"/>
              Este valor guarda el estado (activado-desactivado) del filtro de
              inversion de color entre sesiones.


       <option name="MirrorInput" value="0"/>
              Este valor guarda el estado (activado-desactivado) del filtro
              espejo entre sesiones.


       <option name="Frequencies" value="US-Cable"/>
              Establece la tabla de frecuencias por defecto que se usara por
              cualquier sintonizador encontrado.  Las posibilidades son:

              o     us-cable
              o     us-broadcast
              o     japan-cable
              o     japan-broadcast
              o     europe
              o     australia
              o     australia-optus
              o     newzealand
              o     france
              o     russia


       <option name="NTSCCableMode" value="Standard"/>
              Existen dos estandar de cable especiales NTSC en EEUU: IRC y
              HRC.  En IRC, los canales 5 y 6 operan sobre frecuencias
              diferentes y el modo HRC cambia todas las frecuencias a razon de
              1.25MHz (y esto tambien ocurre en los canales 5 y 6). Usa esta
              opcion para establecer el modo de cable a Standard, IRC, or
              HRC.  Es muy extrano encontrar sistemas de cable que usen IRC o
              HRC.


       <option name="CheckForSignal" value="1"/>
              Establece si tvtime debe comprobar si detecta senal cuando
              cambias de canal, etc.  Si tu tarjeta no apesta, no deberias
              necesitar desactivarlo.  Deshabilitar esta opcion deshabilitara
              tambien el escaner de canales.


       <option name="InputWidth" value="720"/>
              Establece cuantos pixels por scanline son recogidas de la
              tarjeta capturadora.  A mayor muestreo mayor calidad de imagen,
              mientras que con un muestreo menor haremos menor trabajo y en
              consecuencia tvtime se ejecutara mas rapido.  Si tienes una CPU
              lenta (menor o igual a 500Mhz), valores de 480 or 400 puede que
              te vayan bien.  Para la mejor calidad, escoge un valor alto como
              720 or 768.  Muchas capturadoras no pueden muestrear mas de 768
              pixels por scanline.


       <option name="XMLTVFile" value="none"/>
              Establece el fichero xmltv del que se obtendran los listados de
              programas.  Selecciona "none" si no quieres usar xmltv.


       <option name="XMLTVLanguage" value="none"/>
              Usa los datos de XMLTV en el lenguaje dado si esta disponible.
              Los lenguajes se representan por dos letras que constituyen el
              codigo del lenguaje (por ejemplo, "es" de Espana). Si es "none"
              o no esta configurada esta opcion se usara el lenguaje por
              defecto del fichero.


       <option name="UseXDS" value="0"/>
              Establecelo a 1 para activar la decodificacion de informacion de
              canal XDS.  Esta opcion es especifica para regiones NTSC.  XDS
              se utiliza para enviar informacion sobre los canales incluyendo
              el nombre de la red de trabajo y las cartas de llamadas, y algo
              de informacion sobre el programa actual.


       <option name="VBIDevice" value="/dev/vbi0"/>
              Establece cual dispositivo se usara para decodificacion VBI.


       <option name="MixerDevice" value="/dev/mixer:line"/>
              Establece el dispositivo mezclador y el canal. El formato es
              nombre dispositivo: nombre canal. Canales validos son:

              vol, bass, treble, synth, pcm, speaker,  line, mic, cd, mix,
              pcm2, rec,  igain, ogain, line1, line2, line3,  dig1, dig2,
              dig3, phin, phout, video,  radio, monitor


       <option name="Widescreen" value="0"/>
              Esta opcion activa el modo 16:9 por defecto al arrancar.


       <option name="WindowGeometry" value="0x576"/>
              Establece la geometria de la ventana. Un valor de anchura 0
              significa que sera calculado el ancho apropiado para la altura
              indicada. Para una escala 4:3 en una pantalla de pixel cuadrado
              es por defecto 768x576 window.


       <option name="Overscan" value="0.0"/>
              Establece el porcentaje de los lados que se reservan al
              overscan, esto es, no se muestran por completo. Un area de
              accion segura en una television es un 10% para el overscan, pero
              es un poco restrictivo.  Si quieres que tvtime parezca una TV,
              un buen valor seria 6-8%.  El valor se expresa en porcentaje,
              asi que para un 8%, usa 8.0.


       <option name="Fullscreen" value="0"/>
              Establecelo a 1 para que tvtime se inicie a pantalla completa.
              Este ajuste se guarda en tiempo de ejecucion, asi que cuando te
              sales de tvtime en pantalla completa, al iniciar de nuevo
              estaras en pantalla completa.


       <option name="AlwaysOnTop" value="0"/>
              Establecelo a 1 para que tvtime se inicie en modo "siempre
              visible" si lo soporta tu gestor de ventanas.  Este ajuste se
              guarda en tiempo de ejecucion, asi que cuando te sales de tvtime
              en modo "siempre visible", al iniciar de nuevo estaras en modo
              "siempre visible".


       <option name="FullscreenPosition" value="Centre"/>
              Establece la posicion de la salida cuando estas en pantalla
              completa: top (arriba), bottom (abajo) o centre (centrado).
              Cuando escoges top, tvtime en pantalla completa situara su
              salida en la parte superior de la pantalla.  Usalo si tienes un
              proyector para ayudar a tvtime a encajar la imagen
              apropiadamente.


       <option name="FramerateMode" value="0"/>
              Establece la tasa de cuadros (framerate) mandadas a la salida
              por tvtime.

              0   Modo completo, cada cuadro es desentrelazado.  59.94fps para
                  NTSC, 50fps para PAL.


              1   Modo medio, se desentrelazan todos los campos superiores de
                  un cuadro (TFF).  29.97fps para NTSC, 25fps para PAL.


              2   Modo medio, se desentrelazan todos los campos inferiores de
                  un cuadro (BFF).  29.97fps para NTSC, 25fps para PAL.

              Los dos modos con media tasa de cuadros son utiles para el
              contenido progresivo de las consolas de video-juegos.  Usa weave
              y selecciona TFF o BFF, el que no presente efectos de
              entrelazado.


       <option name="QuietScreenshots" value="0"/>
              Cuando activas esta opcion, las capturas de pantalla no se
              anuncian en el OSD. Esto es util si tomas muchas capturas de
              pantalla y no quieres que el texto aparezca en ninguna.


       <option name="ProcessPriority" value="-10"/>
              Establece la prioridad de proceso. Por defecto, tvtime intenta
              asignarse a si mismo una prioridad -10 la cual es mayor que las
              aplicaciones normales. Valores aceptables son desde -20 a 20,
              siendo el valor menor el que otorga una mayor prioridad.


       <option name="TimeFormat" value="%X"/>
              Establece el formato de hora que es sobreimpresionado por
              tvtime.  El formato es un string con el mismo formato que
              strftime(3).  Se usa el formato de hora de tu region (locale)
              por defecto.


       <option name="ScreenShotDir" value="~"/>
              Es el directorio en el que son situadas las capturas de
              pantalla.  El home de usuario es el valor por defecto.


       <option name="ChannelTextFG" value="0xFFFFFF00"/>
       <option name="OtherTextFG" value="0xFFF5DEB3"/>
              Estas opciones establecen los colores ARGB que se usan para el
              texto sobreimpresionado. El color por defecto para el nombre del
              canal es "yellow" (0xffffff00), y el del texto circundante es
              "wheat" (0xfff5deb3).  El formato de color puede expresarse en
              hexadecimal o en decimal.  Si el canal alfa no es especificado
              vale, por defecto, "opaque" (255).


              Ejemplos: 0xffaadd, 0xff0000ff, 0xff, 0xffff, 255 255 0, 0,
                        16777215.


       <option name="UnmuteVolume" value="-1"/>
              Esta opcion guarda el volumen antes de estar mudo entre
              sesiones.  No deberias necesitar establecerlo nunca tu mismo.


       <option name="Muted" value="0"/>
              Esta opcion guarda si tvtime estuvo mudo o no cuando saliste la
              ultima vez. No deberias necesitar establecerlo nunca tu mismo.


       <option name="MuteOnExit" value="1"/>
              Esta opcion controla si tvtime deberia silenciar su dispositivo
              mezclador al salir. Por defecto, tvtime silencia el dispositivo
              mezclador para trabajar con tarjetas capturadoras ruidosas.
              Desactivar esta opcion puede tener efectos adversos en otras
              aplicaciones.


       <option name="PrevChannel" value="2"/>
              Esta opcion se guarda en ejecucion para recordar el canal
              previo.


       <option name="Channel" value="2"/>
              Esta opcion se guarda en ejecucion para recordar el canal
              actual.


       <option name="DeinterlaceMethod" value="AdaptiveAdvanced"/>
              Esta opcion se guarda en ejecucion para recordar el
              desentrelazador usado.

              Desentrelazadores soportados son:

              TelevisionFull Television: Full Resolution
              TelevisionHalf Television: Half Resolution
              BlurVertical   Blur: Vertical
              BlurTemporal   Blur: Temporal
              AdaptiveSearch Motion Adaptive: Motion Search
              AdaptiveAdvanced
                             Motion Adaptive: Advanced Detection
              AdaptiveSimple Motion Adaptive: Simple Detection
              ProgressiveTFF Progressive: Top Field First
              ProgressiveBFF Progressive: Bottom Field First


BINDINGS
       Tanto las pulsaciones de teclas como los clicks del raton pueden
       asociarse a comandos de tvtime.  Para encontrar una descripcion de cada
       comando, consulta tvtime-command(1).

       Multiples teclas y botones del raton pueden estar asociadas al mismo
       comando.  Por comodidad, tvtime provee alias para teclas especiales.
       Las teclas especiales reconocidas por tvtime son:

       Up, Down, Left, Right, Insert, Home, End,R  PageUp, PageDown, F1, F2,
       F3, F4, F5,  F6, F7, F8, F9, F10, F11, F12, F13,  F14, F15, Backspace,
       Escape, Enter, Print, Menu

       Un ejemplo de asociacion de tecla podria ser para el comando
       CHANNEL_INC.  En este caso, tenemos dos teclas (Up and k) asociadas al
       comando, asi como el boton del raton (4).

           <bind command="channel_inc">
             <keyboard key="up"/>
             <keyboard key="k"/>
             <mouse button="4"/>
           </bind>

       Algunos comandos pueden recibir argumentos; por ejemplo, el comando
       SCREENSHOT puede coger como argumento el nombre del fichero. Los
       argumentos pueden ser enviados a una asociacion de tecla como sigue:

           <bind command="screenshot" argument="/tmp/last-screenshot.png">
             <keyboard key="s"/>
           </bind>


AUTOR
       Billy Biggs.


VEASE TAMBIEN
       tvtime(1), tvtime-configure(1), tvtime-command(1), tvtime-scanner(1),
       stationlist.xml(5).

tvtime 0.9.15                    October 2004                    tvtime.xml(5)