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
.\" Pgina 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 Ivn Eixarch Calvo.
.\"  Enven correcciones a: ivan@bonacamp.com
.\"
.\"  ltima revisin: 6-1-2005 (Ivn Eixarch Calvo).
.\"
.TH tvtime.xml 5 "October 2004" "tvtime 0.9.15"

.SH NOMBRE
tvtime.xml \- fichero de configuracin de tvtime

.SH SINOPSIS

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

.SH DESCRIPCIN

El archivo
.I tvtime.xml
es el principal fichero de configuracin 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 ejecucin, para conservar ajustes entre sesiones.  Por esta razon, no
debes editar el fichero
.I tvtime.xml
mientras
.B tvtime
est en ejecucin, o tus cambios podran 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 ms informacin sobre los archivos de
configuracin 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, 
acompaadas de una descripcin de lo que la opcin hace.

.TP
<option name="Verbose" value="0"/>
El modo verboso indica que debe mostrarse todos los mensajes informativos
y de precaucin por stderr mientras ejecuta
.BR tvtime .
De otra forma, slo los errores crticos seran 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 ejecucin 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 vlidos 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 opcin indica si
.B
tvtime
debera guardar y restaurar sus propios ajustes de imgen
tanto al arrancar como al cambiar de canal.

.TP
<option name="AudioMode" value="stereo"/>
.B
Esta opcin guarda el ltimo modo de audio usado. Se usar para
recordar qu modo de audio se usar cuando la aplicacin sea
iniciada la prxima vez. Opciones vlidas son "mono", "stereo",
"lang1", "lang2" o "sap".

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

.TP
<option name="ShowCC" value="0"/>
.B
Esta opcin guarda el estado de la decodificacin "closed caption".
Se denomina "closed caption" a la trascripcin textual de la seal
de audio especfica de NTSC para los disminudos auditivos.

.TP
<option name="ColourInvert" value="0"/>
.B
Este valor guarda el estado (activado-desactivado) del filtro de 
inversin 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 estndar 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 razn de 1.25MHz (y
esto tambin ocurre en los canales 5 y 6). Usa esta opcin
para establecer el modo de cable a
.IR Standard ,
.IR IRC ", or "
.IR HRC .
Es muy extrao encontrar sistemas de cable que usen IRC o HRC.

.TP
<option name="CheckForSignal" value="1"/>
Establece si
.B tvtime
debe comprobar si detecta seal cuando cambias de canal, etc.
Si tu tarjeta no apesta, no deberas necesitar desactivarlo.
Deshabilitar esta opcin deshabilitar tambin el escner de canales.

.TP
<option name="InputWidth" value="720"/>
Establece cantos pixels por scanline son recogidas de la tarjeta capturadora.
A mayor muestreo mayor calidad de imgen, mientras que con un muestreo menor
haremos menor trabajo y en consecuencia
.B tvtime
se ejecutar ms rpido.  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 ms de
.I 768
pixels por scanline.

.TP
<option name="XMLTVFile" value="none"/>
Establece el fichero xmltv del que se obtendrn 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
cdigo del lenguaje (por ejemplo, "es" de Espaa). Si es "none"
o no est configurada esta opcin se usar el lenguaje por defecto
del fichero.

.TP
<option name="UseXDS" value="0"/>
Establcelo a
.I 1
para activar la decodificacin de informacin de canal XDS.
Esta opcin es especfica para regiones NTSC.  XDS se utiliza para
enviar informacin sobre los canales incluyendo el nombre de la
red de trabajo y las cartas de llamadas, y algo de informacin
sobre el programa actual.

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

.TP
<option name="MixerDevice" value="/dev/mixer:line"/>
Establece el dispositivo mezclador y el canal. El formato es
nombre dispositivo: nombre canal. Canales vlidos 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 opcin activa el modo 16:9 por defecto al arrancar.

.TP
<option name="WindowGeometry" value="0x576"/>
Establece la geometra 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 accin segura en una
televisin es un 10% para el overscan, pero es un poco restrictivo.
Si quieres que
.B tvtime
parezca una TV, un buen valor sera 6\[en]8%.  El valor se expresa
en porcentaje, as que para un 8%, usa
.IR 8.0 .

.TP
<option name="Fullscreen" value="0"/>
Establcelo 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 estars en pantalla completa.

.TP
<option name="AlwaysOnTop" value="0"/>
Establcelo 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 estars en modo "siempre visible".

.TP
<option name="FullscreenPosition" value="Centre"/>
Establece la posicin de la salida cuando ests 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 imgen 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 opcin, 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 regin (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 opcin guarda el volumen antes de estar mudo entre sesiones.
No deberas necesitar establecerlo nunca t mismo.

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

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

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

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

.TP
<option name="DeinterlaceMethod" value="AdaptiveAdvanced"/>
Esta opcin se guarda en ejecucin 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 ratn pueden asociarse a comandos de
.B tvtime.  
Para encontrar una descripcin de cada comando, consulta
.BR tvtime-command (1).

Mltiples teclas y botones del ratn 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 asociacin de tecla podra ser para el comando
.IR CHANNEL_INC .
En este caso, tenemos dos teclas
.RI ( Up " and " k )
asociadas al comando, as como el botn del ratn
.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 asociacin de tecla como sigue:

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

.SH AUTOR

Billy Biggs.

.SH "VASE TAMBIN"

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

Privacy Policy