aboutsummaryrefslogtreecommitdiffstats
path: root/docs/man/es/tvtime.xml.5
blob: 44e2a8dd6fec1261947b6faf04f26fc25e0901ea (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
.\" P�gina man para tvtime.xml en castellano.
.\" Copyright (c) 2003, 2004  Billy Biggs
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or (at
.\" your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
.\" General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.\"  Traducido al castellano por Iv�n Eixarch Calvo.
.\"  Env�en correcciones a: ivan@bonacamp.com
.\"
.\"  �ltima revisi�n: 6-1-2005 (Iv�n Eixarch Calvo).
.\"
.TH tvtime.xml 5 "October 2004" "tvtime 0.9.15"

.SH NOMBRE
tvtime.xml \- fichero de configuraci�n de tvtime

.SH SINOPSIS

.I ~/.tvtime/tvtime.xml
.br
.I /etc/tvtime/tvtime.xml
.br

.SH DESCRIPCI�N

El archivo
.I tvtime.xml
es el principal fichero de configuraci�n de
.BR tvtime .
Contiene todos los ajustes por defecto y las asociaciones de teclas. El archivo
.I tvtime.xml
es actualizado por
.B tvtime
en ejecuci�n, para conservar ajustes entre sesiones.  Por esta razon, no
debes editar el fichero
.I tvtime.xml
mientras
.B tvtime
est� en ejecuci�n, o tus cambios podr�an 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 m�s informaci�n sobre los archivos de
configuraci�n XML en
.nh
.UR http://tvtime.sourceforge.net/DTD/
http://tvtime.sourceforge.net/DTD/
.UE
.hy

.SH OPCIONES

.B 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, 
acompa�adas de una descripci�n de lo que la opci�n hace.

.TP
<option name="Verbose" value="0"/>
El modo verboso indica que debe mostrarse todos los mensajes informativos
y de precauci�n por stderr mientras ejecuta
.BR tvtime .
De otra forma, s�lo los errores cr�ticos ser�an mostrados.

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

.TP
<option name="V4LInput" value="0"/>
Establece la entrada de la capturadora que abre por defecto
.BR tvtime .
Por ejemplo, mi tarjeta WinTV tiene el sintonizador en
.IR 0 ,
y la entrada de video compuesto en
.IR 1 .
Las fuentes pueden cambiarse en tiempo de ejecuci�n usando el comando
.B toggle_input
cuya tecla asociada es \(lqi\(rq por defecto.

.TP
<option name="Norm" value="NTSC"/>
Establece la norma de TV por defecto. Valores v�lidos son:
.TS
nokeep tab (@);
l l.
\(bu@NTSC
\(bu@NTSC\-JP
\(bu@SECAM
\(bu@PAL
\(bu@PAL\-Nc
\(bu@PAL\-M
\(bu@PAL\-N
\(bu@PAL\-60
.TE

.TP
<option name="SaveAndRestorePictureSettings" value="1"/>
Esta opci�n indica si
.B
tvtime
deber�a guardar y restaurar sus propios ajustes de im�gen
tanto al arrancar como al cambiar de canal.

.TP
<option name="AudioMode" value="stereo"/>
.B
Esta opci�n guarda el �ltimo modo de audio usado. Se usar� para
recordar qu� modo de audio se usar� cuando la aplicaci�n sea
iniciada la pr�xima vez. Opciones v�lidas son "mono", "stereo",
"lang1", "lang2" o "sap".

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

.TP
<option name="ShowCC" value="0"/>
.B
Esta opci�n guarda el estado de la decodificaci�n "closed caption".
Se denomina "closed caption" a la trascripci�n textual de la se�al
de audio espec�fica de NTSC para los disminu�dos auditivos.

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

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

.TP
<option name="Frequencies" value="US-Cable"/>
Establece la tabla de frecuencias por defecto que se usar� por cualquier
sintonizador encontrado.
Las posibilidades son:
.TS
nokeep tab (@);
l l.
\(bu@us-cable
\(bu@us-broadcast
\(bu@japan-cable
\(bu@japan-broadcast
\(bu@europe
\(bu@australia
\(bu@australia-optus
\(bu@newzealand
\(bu@france
\(bu@russia
.TE

.TP
<option name="NTSCCableMode" value="Standard"/>
Existen dos est�ndar 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 raz�n de 1.25MHz (y
esto tambi�n ocurre en los canales 5 y 6). Usa esta opci�n
para establecer el modo de cable a
.IR Standard ,
.IR IRC ", or "
.IR HRC .
Es muy extra�o encontrar sistemas de cable que usen IRC o HRC.

.TP
<option name="CheckForSignal" value="1"/>
Establece si
.B tvtime
debe comprobar si detecta se�al cuando cambias de canal, etc.
Si tu tarjeta no apesta, no deber�as necesitar desactivarlo.
Deshabilitar esta opci�n deshabilitar� tambi�n el esc�ner de canales.

.TP
<option name="InputWidth" value="720"/>
Establece c�antos pixels por scanline son recogidas de la tarjeta capturadora.
A mayor muestreo mayor calidad de im�gen, mientras que con un muestreo menor
haremos menor trabajo y en consecuencia
.B tvtime
se ejecutar� m�s r�pido.  Si tienes una CPU lenta
(menor o igual a 500Mhz), valores de
.IR 480 \ or\  400
puede que te vayan bien.  Para la mejor calidad, escoge un valor alto como
.IR 720 \ or\  768 .
Muchas capturadoras no pueden muestrear m�s de
.I 768
pixels por scanline.

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

.TP
<option name="XMLTVLanguage" value="none"/>
Usa los datos de XMLTV en el lenguaje dado si est� disponible.
Los lenguajes se representan por dos letras que constituyen el
c�digo del lenguaje (por ejemplo, "es" de Espa�a). Si es "none"
o no est� configurada esta opci�n se usar� el lenguaje por defecto
del fichero.

.TP
<option name="UseXDS" value="0"/>
Establ�celo a
.I 1
para activar la decodificaci�n de informaci�n de canal XDS.
Esta opci�n es espec�fica para regiones NTSC.  XDS se utiliza para
enviar informaci�n sobre los canales incluyendo el nombre de la
red de trabajo y las cartas de llamadas, y algo de informaci�n
sobre el programa actual.

.TP
<option name="VBIDevice" value="/dev/vbi0"/>
Establece cual dispositivo se usar� para decodificaci�n VBI.

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

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

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

.TP
<option name="WindowGeometry" value="0x576"/>
Establece la geometr�a de la ventana. Un valor de anchura 0 significa
que ser� calculado el ancho apropiado para la altura indicada. Para una
escala 4:3 en una pantalla de pixel cuadrado es por defecto
.RI 768\[mu] 576
window.

.TP
<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 �rea de acci�n segura en una
televisi�n es un 10% para el overscan, pero es un poco restrictivo.
Si quieres que
.B tvtime
parezca una TV, un buen valor ser�a 6\[en]8%.  El valor se expresa
en porcentaje, as� que para un 8%, usa
.IR 8.0 .

.TP
<option name="Fullscreen" value="0"/>
Establ�celo a
.I 1
para que
.B tvtime
se inicie a pantalla completa.  Este ajuste se guarda en tiempo de ejecucion,
as� que cuando te sales de 
.B tvtime
en pantalla completa, al iniciar de nuevo estar�s en pantalla completa.

.TP
<option name="AlwaysOnTop" value="0"/>
Establ�celo a
.I 1
para que
.B tvtime
se inicie en modo "siempre visible" si lo soporta tu gestor de ventanas.
Este ajuste se guarda en tiempo de ejecucion, as� que cuando te sales de 
.B tvtime
en modo "siempre visible", al iniciar de nuevo estar�s en modo "siempre visible".

.TP
<option name="FullscreenPosition" value="Centre"/>
Establece la posici�n de la salida cuando est�s en pantalla completa:
.I top (arriba),
.I bottom (abajo)
o
.I centre (centrado).
Cuando escoges
.I top,
.B tvtime
en pantalla completa situar� su salida en la parte superior de la pantalla.
�salo si tienes un proyector para ayudar a
.B tvtime
a encajar la im�gen apropiadamente.

.TP
<option name="FramerateMode" value="0"/>
Establece la tasa de cuadros (framerate) mandadas a la salida por
.BR tvtime .
.RS
.TP 4
.I 0
Modo completo, cada cuadro es desentrelazado.
59.94fps para NTSC, 50fps para PAL.

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

.TP
.I 2
Modo medio, se desentrelazan todos los campos inferiores de un cuadro (BFF).
29.97fps para NTSC, 25fps para PAL.
.RE
.IP
Los dos modos con media tasa de cuadros son �tiles para el contenido
progresivo de las consolas de video-juegos.  Usa weave y selecciona TFF o BFF, 
el que no presente efectos de entrelazado.

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

.TP
<option name="ProcessPriority" value="-10"/>
Establece la prioridad de proceso. Por defecto,
.B tvtime
intenta asignarse a s� mismo una prioridad
.I \[en]10
la cual es mayor que las aplicaciones normales. Valores aceptables son desde
.IR \[en]20 " a " 20 ,
siendo el valor menor el que otorga una mayor prioridad.

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

.TP
<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.

.TP
.PD 0
<option name="ChannelTextFG" value="0xFFFFFF00"/>
.TP
.PD
<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 \(lqyellow\(rq
.RI ( 0xffffff00 ),
y el del texto circundante es \(lqwheat\(rq
.RI ( 0xfff5deb3 ).
El formato de color puede expresarse en hexadecimal o en decimal.
Si el canal alfa no es especificado vale, por defecto, \(lqopaque\(rq
.RI ( 255 ).

.RS
.TP 10
Ejemplos:
.IR 0xffaadd ,
.IR 0xff0000ff ,
.IR 0xff ,
.IR 0xffff ,
.IR "255 255 0" ,
.IR 0 ,
.IR 16777215 .
.RE

.TP
<option name="UnmuteVolume" value="-1"/>
Esta opci�n guarda el volumen antes de estar mudo entre sesiones.
No deber�as necesitar establecerlo nunca t� mismo.

.TP
<option name="Muted" value="0"/>
Esta opci�n guarda si tvtime estuvo mudo o no cuando saliste la �ltima
vez. No deber�as necesitar establecerlo nunca t� mismo.

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

.TP
<option name="PrevChannel" value="2"/>
Esta opci�n se guarda en ejecuci�n para recordar el canal previo.

.TP
<option name="Channel" value="2"/>
Esta opci�n se guarda en ejecuci�n para recordar el canal actual.

.TP
<option name="DeinterlaceMethod" value="AdaptiveAdvanced"/>
Esta opci�n se guarda en ejecuci�n para recordar el desentrelazador usado.

Desentrelazadores soportados son:
.RS
.TP 15
.PD 0
.I TelevisionFull
Television: Full Resolution
.TP
.I TelevisionHalf
Television: Half Resolution
.TP
.I BlurVertical
Blur: Vertical
.TP
.I BlurTemporal
Blur: Temporal
.TP
.I AdaptiveSearch
Motion Adaptive: Motion Search
.TP
.I AdaptiveAdvanced
Motion Adaptive: Advanced Detection
.TP
.I AdaptiveSimple
Motion Adaptive: Simple Detection
.TP
.I ProgressiveTFF
Progressive: Top Field First
.TP
.I ProgressiveBFF
Progressive: Bottom Field First
.PD
.RE

.SH BINDINGS

Tanto las pulsaciones de teclas como los clicks del rat�n pueden asociarse a comandos de
.B tvtime.  
Para encontrar una descripci�n de cada comando, consulta
.BR tvtime-command (1).

M�ltiples teclas y botones del rat�n pueden estar asociadas al mismo comando.
Por comodidad,
.B tvtime
provee alias para teclas especiales. Las teclas especiales reconocidas por 
.B tvtime
son:

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

Un ejemplo de asociaci�n de tecla podr�a ser para el comando
.IR CHANNEL_INC .
En este caso, tenemos dos teclas
.RI ( Up " and " k )
asociadas al comando, as� como el bot�n del rat�n
.RI ( 4 ).

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

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

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

.SH AUTOR

Billy Biggs.

.SH "V�ASE TAMBI�N"

.BR tvtime (1),
.BR tvtime-configure (1),
.BR tvtime-command (1),
.BR tvtime-scanner (1),
.IR stationlist.xml (5).

Privacy Policy