File: settings.xml

package info (click to toggle)
zapping 0.10~cvs6-9
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 10,956 kB
  • ctags: 13,278
  • sloc: ansic: 111,145; asm: 11,770; sh: 9,816; xml: 2,742; makefile: 1,255; perl: 488
file content (647 lines) | stat: -rw-r--r-- 38,466 bytes parent folder | download | duplicates (6)
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
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
  <sect1 id="zapping-settings"> 
    <title>Settings</title> 

    <para>To configure Zapping choose <menuchoice> 
	<guimenu>Edit</guimenu> 
	<guimenuitem>Preferences</guimenuitem> 
      </menuchoice>. The <guilabel>Preferences</guilabel> dialog contains the following sections.</para>

    <sect2 id="zapping-settings-video-device">
      <title>Video Device</title>

      <para>In this section you can select the device file name of
the kernel device to be used in <link linkend="zapping-video-modes">capture mode</link>. On Linux common names are:<!-- simplelist not working? -->
      <itemizedlist>
        <listitem><para><filename>/dev/video</filename></para></listitem>
        <listitem><para><filename>/dev/video0</filename></para></listitem>
        <listitem><para><filename>/dev/video1</filename></para></listitem>
        <listitem><para><filename>/dev/video2</filename></para></listitem>
        <listitem><para><filename>/dev/v4l/video</filename></para></listitem>
        <listitem><para><filename>/dev/v4l/video0</filename></para></listitem>
      </itemizedlist></para>
      <para>On FreeBSD: <itemizedlist>
        <listitem><para><filename>/dev/bktr</filename></para></listitem>
        <listitem><para><filename>/dev/bktr0</filename></para></listitem>
        <listitem><para><filename>/dev/bktr1</filename></para></listitem>
        <listitem><para><filename>/dev/bktr2</filename></para></listitem>
      </itemizedlist></para>
      <para>Changes will take place after you quit and restart Zapping.</para>
      <para>There is no dialog to select an XVideo device, Zapping uses the first device it finds. This will be corrected in a future version.</para>
    </sect2>

    <sect2 id="zapping-settings-audio-device">
      <title>Audio Device</title>

      <para>Here you can select an audio device to <link linkend="zapping-record">record sound</link>. Usually a kernel device is the best choice. If your TV card has audio sampling hardware and the driver supports this, you can also select the TV card as recording device. This will free the soundcard to record from other sources.</para>
      <para>Common kernel device names are: <itemizedlist>
        <listitem><para><filename>/dev/dsp</filename></para></listitem>
        <listitem><para><filename>/dev/dsp0</filename></para></listitem>
        <listitem><para><filename>/dev/dsp1</filename></para></listitem>
      </itemizedlist> and so on. Click on the down arrow of the device file entry to see a list of devices found by Zapping.</para>
      <para>If the audio output of your TV card connects to an audio input of your soundcard, or when your TV card has no audio capabilities, you will want to select <guilabel>Control volume with soundcard mixer</guilabel>. This has two advantages:</para>
      <itemizedlist>
        <listitem>
          <para>Zapping will properly set the volume control on the soundcard mixer <emphasis>and</emphasis> the TV card, you will not have to start a mixer application.</para>
        </listitem>
        <listitem>
          <para>When you change the volume or mute audio, recording is not affected.</para>
        </listitem>
      </itemizedlist>
      <para>When you select a kernel device as audio recording device, you should also enable this option to determine the correct audio input line.</para>
      <para>Common mixer device names are: <itemizedlist>
        <listitem><para><filename>/dev/mixer</filename></para></listitem>
        <listitem><para><filename>/dev/mixer0</filename></para></listitem>
        <listitem><para><filename>/dev/mixer1</filename></para></listitem>
      </itemizedlist> and so on. Click on the down arrow of the device file entry to see a list of devices found by Zapping.</para>
    </sect2>

    <sect2 id="zapping-settings-vbi-device">
      <title>VBI Device</title>

      <para>In this section you can select the source of Teletext and
Closed Caption data. The DVB PES format is used for digital TV VBI
transmissions in Europe. Zapping does not support digital TV yet, but
it can read DVB files. For normal operation however you should choose
a kernel device. Common device names are: <itemizedlist>
          <listitem><para><filename>/dev/vbi</filename></para></listitem>
          <listitem><para><filename>/dev/vbi0</filename></para></listitem>
          <listitem><para><filename>/dev/vbi1</filename></para></listitem>
          <listitem><para><filename>/dev/vbi2</filename></para></listitem>
      </itemizedlist></para>
      <para>And on Linux only: <itemizedlist>
          <listitem><para><filename>/dev/v4l/vbi</filename></para></listitem>
          <listitem><para><filename>/dev/v4l/vbi0</filename></para></listitem>
      </itemizedlist></para>
      <para>The VBI device name should match the video device name.
When for example the video device is <filename>/dev/video2</filename>
or <filename>/dev/bktr2</filename> the corresponding VBI device is
usually <filename>/dev/vbi2</filename>.</para>
      <para>A VBI proxy allows two or more applications to read from
the same VBI device, for example Zapping and Nextvepg. When this
option is selected Zapping will access the chosen VBI device through
the proxy, or directly if the proxy is not installed or is not
running. The proxy is a service of the ZVBI library, currently it
works only on Linux.</para>
    </sect2>

    <sect2 id="zapping-settings-main">
      <title>Main Window</title>

      <para>You can set the following preferences:</para>
      <variablelist>
        <varlistentry>
          <term><guilabel>Save window geometry</guilabel></term>
          <listitem>
            <para>Zapping does not support session management yet. When this option is selected, it will save the window geometry on exit and restore on startup in a non-standard way.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Show tooltips</guilabel></term>
          <listitem>
            <para>Whether to show tooltips.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Disable screensaver</guilabel></term>
          <listitem>
            <para>In video mode (not it Teletext mode) disable the screensaver from blanking the screen.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Save control values per channel</guilabel></term>
          <listitem>
            <para>When this option is selected Zapping saves and restores brightness, contrast, audio volume and other settings when you switch channels.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Enter channels by</guilabel></term>
          <listitem>
            <para>When you enter channel numbers on the numeric keypad or with your remote control, Zapping can interpret the numbers differently. In the United States you will want to choose by RF channel number (1 to 125). You can also choose by the number of the channel in the channel list, the first channel has number 0.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Title bar contents</guilabel></term>
          <listitem>
            <para>Here you can customize the appearance of the main window title bar. You can enter a string which is displayed literally, except for the following jokers:</para>
            <variablelist>
              <varlistentry>
                <term><userinput>$(alias)</userinput></term>
                <listitem>
                  <para>Name of the current channel, e.g. BBC1</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term><userinput>$(index)</userinput></term>
                <listitem>
                  <para>Number in the channel list</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term><userinput>$(id)</userinput></term>
                <listitem>
                  <para>RF channel name, e.g. S02</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term><userinput>$(freq)</userinput></term>
                <listitem>
                  <para>Tuning frequency</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term><userinput>$(standard)</userinput></term>
                <listitem>
                  <para>Video standard (PAL, NTSC, SECAM, &hellip;)</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term><userinput>$(input)</userinput></term>
                <listitem>
                  <para>Current video input on the TV card</para>
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>

    <sect2 id="zapping-settings-video-options">
      <title>Video Options</title>

      <para>You can set the following preferences:</para>
      <variablelist>
        <varlistentry>
          <term><guilabel>Fullscreen video resolution</guilabel></term>
          <listitem>
            <para>When switching to <link
            linkend="zapping-video-modes">fullscreen or background mode</link>, Zapping may not be able to enlarge the video to cover the whole screen, but it can change the display resolution to approximate the size of the video. Here you can select a particular resolution, automatic selection, or no change of display resolution.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Capture size under XVideo</guilabel></term>
          <listitem>
            <para>With the XVideo extension the image scaling hardware of your graphics card can be used to display captured video at almost any size. Here you can select the size of the <emphasis>captured</emphasis> video when using XVideo:</para>
            <variablelist>
              <varlistentry>
                <term><guilabel>320 &times; 240</guilabel></term>
                <listitem>
                  <para>Fixed size 320 &times; 240 pixels.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term><guilabel>Interlaced (window size)</guilabel></term>
                <listitem>
                  <para>The largest size supported by the video capture hardware, or the window size if smaller. You may want to enable the deinterlacer (see below) to reduce interlace artefacts.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term><guilabel>Biggest noninterlaced</guilabel></term>
                <listitem>
                  <para>Interlaced video looks strange when scaled. This mode is similar to <guilabel>Interlaced</guilabel>, except noninterlaced video will be captured.</para>
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Favorite picture sizes</guilabel></term>
          <listitem>
            <para>Here you can customize the <guimenu>Appearance</guimenu> submenu of the video window context menu. To add new line, click on the <guibutton>Add</guibutton> button. To remove a line, click on the line and then the <guibutton>Remove</guibutton> button. To change values, click on a line and then the desired column.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Resize using fixed increments</guilabel></term>
          <listitem>
            <para>When you select this option, the video window can only assume sizes which are a multiple of 32 pixels.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>

    <sect2 id="zapping-settings-keyboard">
      <title>Keyboard</title>

      <para>In this section you can customize accelerators. Note that built-in accelerators such as those associated with menus or channel number entering on the numeric keypad take precedence over user configured ones.</para>

      <para>To add new accelerator, click on the <guibutton>Add</guibutton> button. To remove an accelerator click on the line and then the <guibutton>Remove</guibutton> button. To change a command, click on the line and type a new command in the command entry. Click on the down arrow to see a list of commands. To change a keyboard shortcut, click on the line and column.</para>
    </sect2>

    <sect2 id="zapping-settings-audio-options">
      <title>Audio Options</title>

      <para>Here you can select whether Zapping should automatically mute audio when the application starts, or before it quits.</para>
    </sect2>

    <sect2 id="zapping-settings-osd">
      <title>OSD Options</title>

      <para>Some operations such as entering a channel number or changing the audio volume by keyboard can display a status message. Here you can customize this On Screen Display.</para>
      <variablelist>
        <varlistentry>
          <term><guilabel>Display mode</guilabel></term>
          <listitem>
            <para>Whether to display messages superimposed onto the video (OSD), in a status bar of the video window, in a separate console window, or not at all.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Remove after</guilabel></term>
          <listitem>
            <para>How long the message remains visible in OSD mode.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Font</guilabel></term>
          <listitem>
            <para>Font to be used in OSD mode.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Foreground color</guilabel></term>
          <listitem>
            <para>Foreground (text) color to be used in OSD mode.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Background color</guilabel></term>
          <listitem>
            <para>Background color to be used in OSD mode.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>

    <sect2 id="zapping-settings-vbi">
      <title>VBI Options</title>

      <variablelist>
        <varlistentry>
          <term><guilabel>Enable VBI decoding</guilabel></term>
          <listitem>
            <para>When this option is selected, Zapping will capture and decode VBI data transmitted by the current TV station. This enables Teletext browsing, Teletext subtitles, Closed Caption, and Zapping can automatically name the station (if the information is transmitted, respectively).</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Device file</guilabel></term>
          <listitem>
            <para>A dedicated kernel device is necessary to capture
VBI data. If this is supported by your TV card and its driver, you can
select the VBI device here. Common names are: <itemizedlist>
                <listitem><para><filename>/dev/vbi</filename></para></listitem>
                <listitem><para><filename>/dev/vbi0</filename></para></listitem>
                <listitem><para><filename>/dev/vbi1</filename></para></listitem>
                <listitem><para><filename>/dev/vbi2</filename></para></listitem>
                <listitem><para><filename>/dev/v4l/vbi</filename></para></listitem>
                <listitem><para><filename>/dev/v4l/vbi0</filename></para></listitem>
            </itemizedlist></para>
            <para>The device should correspond to the selected kernel
video device. Zapping will try to find it automatically, but this may
fail. Changes will take place after you quit and restart
Zapping.</para>
            <para>XVideo does not support VBI data capturing. You will
be able to use VBI services only if your device also has a kernel
driver.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>

    <sect2 id="zapping-settings-teletext">
      <title>Teletext plugin</title>
      <variablelist>
        <varlistentry>
          <term><guilabel>Teletext implementation</guilabel></term>
          <listitem>
            <para>The Teletext standard knows different implementation
levels. The built-in Teletext browser supports them all, but you can
choose to see pages as displayed by simpler decoders. Note most
stations still only transmit at the basic levels 1.0 or 1.5.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Default encoding</guilabel></term>
          <listitem>
            <para>Some stations fail to transmit a complete character set code, so the Teletext viewer may not display the correct font or national characters. You can select your geographical region as an additional hint.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Page memory size</guilabel></term>
          <listitem>
            <para>With this option you can limit the size of the page cache in memory. A complete set of pages of one station will require around 1000 KiB. When the limit is reached, Zapzilla will remove the last recently used pages and you must wait for retransmission to see them. Frequently visited pages like page 100 or subpages which take longer to reload get priority.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Number of channels in page memory</guilabel></term>
          <listitem>
            <para>The page memory can contain pages of more than one channel. When the limit is reached, Zapzilla will remove pages of the last recently used channel first.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Brightness and contrast</guilabel></term>
          <listitem>
            <para>These values change the brightness and contrast of the text in Teletext windows or the main window.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Scaling</guilabel></term>
          <listitem>
            <para>You can freely resize Teletext windows. There are different ways to scale the image, some give better visual results, others are faster.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>

    <sect2 id="zapping-settings-recording">
      <title>Recording plugin</title>

      <para>In this section you can create different named recording configurations.</para>
      <sect3 id="zapping-settings-recording-vbi">
        <title>Caption and subtitle recording</title>

        <para>Zapping can record caption and subtitles as text files. To enable this select <guilabel>Subtitle file</guilabel> and the desired format and encoding. The name of the file will be the same as that of the audio/video file, with an appropriate extension (for example <filename>.sub</filename> for the MPSub format).</para>
        <para>The <guilabel>Update live caption at line breaks</guilabel> option applies to real time Closed Caption, which does not appear page by page on the screen but as typed by the captioner. Zapping records the caption accordingly. However when this option is selected caption will appear line by line when played back, which may look better.</para>
        <para>You can record the displayed subtitles or one channel or page of your choice. Closed Caption channels are numbered 1-8, Teletext pages 100-899. Multilingual recording is not supported yet.</para>
      </sect3>
    </sect2>

    <sect2 id="zapping-settings-subtitle">
      <title>Subtitle plugin</title>
      <variablelist>
        <varlistentry>
          <term><guilabel>Teletext default encoding</guilabel></term>
          <listitem>
            <para>Some stations fail to transmit a complete character set code, so the Teletext subtitle viewer may not display the correct font or national characters. You can select your geographical region as an additional hint.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Show double height characters</guilabel></term>
          <listitem>
            <para>Often Teletext subtitles are transmitted with double height characters. They may be more readable but also cover a larger area of the screen. When this option is selected Zapping shows Teletext subtitles as transmitted, otherwise it converts the subtitles to normal height.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Closed Caption foreground and background color</guilabel></term>
          <listitem>
            <para>With these settings you can override the default white on black color of Closed Caption. They have no effect when the station transmits other colors.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Roll live caption</guilabel></term>
          <listitem>
            <para>When this option is selected real time caption rolls smoothly, otherwise it rolls line by line. In overlay mode smooth rolling would flicker excessively, is therefore always disabled.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Brightness and contrast</guilabel></term>
          <listitem>
            <para>These values change the brightness and contrast of caption and subtitles.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Scaling</guilabel></term>
          <listitem>
            <para>You can freely resize subtitles. There are different ways to scale the image, some give better visual results, others are faster.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>

    <sect2 id="zapping-settings-screenshot">
      <title>Screenshot plugin</title>

      <para>In this section you can customize the screenshot plugin.</para>
      <variablelist>
        <varlistentry>
          <term><guilabel>Completion command</guilabel></term>
          <listitem>
            <para>A shell command to execute after the image has been saved. The following environment variables will be set:</para>
            <variablelist>
              <varlistentry>
                <term><varname>$SCREENSHOT_PATH</varname></term>
                <listitem>
                  <para>The fully qualified filename of the saved image, e.&nbsp;g. <filename>/home/my/shots/image2.jpg</filename></para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term><varname>$CHANNEL_ALIAS</varname></term>
                <listitem>
                  <para>Name of the current channel, &eg; BBC1</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term><varname>$CHANNEL_ID</varname></term>
                <listitem>
                  <para>RF channel name, &eg; S02</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term><varname>$CURRENT_STANDARD</varname></term>
                <listitem>
                  <para>Video standard (PAL, NTSC, SECAM, &hellip;)</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term><varname>$CURRENT_INPUT</varname></term>
                <listitem>
                  <para>Current video input on the TV card</para>
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Skip x pictures before grabbing</guilabel></term>
          <listitem>
            <para></para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guilabel>Grab on clicking ok</guilabel></term>
          <listitem>
            <para>By default a screenshot is taken when you open the screenshot dialog. When this option is selected, it will be taken when you click the <guibutton>OK</guibutton> button of the dialog.</para>
          </listitem>
        </varlistentry>	 
        <varlistentry>
          <term><guilabel>Add toolbar button</guilabel></term>
          <listitem>
            <para>Add a button to the main window toolbar which opens the screenshot dialog.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>

    <sect2 id="zapping-settings-deinterlace">
      <title>Deinterlace plugin</title>

      <para>Zapping has a deinterlace plugin based on code from the Windows TV application DScaler. Currently deinterlacing is only possible with Video4Linux2 drivers on x86 CPUs with MMX. In this section you can customize the plugin. To enable deinterlacing choose a method from the top menu list:</para>
      <variablelist>
        <varlistentry>
          <term>Video Deinterlace (Bob)</term>
          <listitem>
            <para>This method is based on Gunnar Thalin's VirtualDub filter. If it detects weaving artifacts in the current image it uses bob to get rid of them. This method has a tendency to bob rather too much and gives poor results on fine static images. It uses the most recent two frames for the calculations and is not as CPU intensive as the more recent Greedy methods. Options:</para>
            <variablelist>
              <varlistentry>
                <term>Resolution</term>
                <listitem>
                  <para>Horizontal resolution of images. Choosing a lower resolution may help if your CPU is too slow. This option is available for all methods.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Weave Edge Detect</term>
                <listitem>
                  <para>Weight used to help detect edges. Higher values makes edge detection stronger.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Weave Jaggie Threshold</term>
                <listitem>
                  <para>Threshold used to determone if pixel should be bobed.  Higher values mean fewer bobed pixels.</para>
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Video Deinterlace (Weave)</term>
          <listitem>
            <para>This was one of the earliest video deinterlace methods. It used three fields in the calculation and works well on slow moving material but tends to comb on fast moving material.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Video Deinterlace (2-Frame)</term>
          <listitem>
            <para>This method uses the current frame and the last two to determine whether to bob or weave a given pixel. This gives better results on both stationary and moving images than the above two methods however it uses more CPU.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Simple Weave</term>
          <listitem>
            <para>This method just combines the most recent even and odd fields. This causes motion artifacts and is provided for comparison. <!-- This method can also be used as part of the adaptive method with static images. --></para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Simple Bob</term>
          <listitem>
            <para>This uses only the most recent field and fills the lines in between with interpolated pixels. This method has in may ways been superceded by Scaler Bob.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Scaler Bob</term>
          <listitem>
            <para>Uses the current field and lets the video card scaler size the picture to fit the screen. Produces reasonable results for fast moving images. This method uses very little CPU and is recommended on lower spec machines.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Even Scanlines Only</term>
          <listitem>
            <para>This method displays only the even fields and uses hardware scaling. It reduces bob artifacts at the cost of loss of information. This method was originally intended to be used with game consoles.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Odd Scanlines Only</term>
          <listitem>
            <para>Like Even Scanlines Only, but displays only odd fields.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Blended Clip</term>
          <listitem>
            <para>This method is designed mostly for experimentation by those interested in what works for video deinterlacing. It is probably not the single best method for anything but it can be used to create custom deinterlace methods for special purposes. Somewhat CPU intensive</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Video (Greedy, Low Motion)</term>
          <listitem>
            <para>The Greedy Low Motion deinterlace method is designed to give good results on low motion video source, using less CPU than some others. Good on slower machines but it will give awful results on high motion video material like sports. Quite by accident, it can also do a decent job on poorly mastered 3:2 or 2:2 pull down film source material like some anime movies, regardless of low or high motion.</para>
            <!-- Try it if you have a movie source that is not giving good results with normal Auto Pull Down processing. -->
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Video (Greedy, High Motion)</term>
          <listitem>
            <para>This method works at two levels. By default, at the Basic Level, it is a normal deinterlace method, with the following features:</para>
            <itemizedlist>
              <listitem><para>A merge of Blended Clip, Greedy Low Motion, and some new stuff</para></listitem>
              <listitem><para>Greedy implied pulldown, like the Greedy Low Motion method</para></listitem>
              <listitem><para>Parm blending like the Blended Clip method, for less sizzling.</para></listitem>
              <listitem><para>Lookahead motion detection</para></listitem>
              <listitem><para>Diagonal Jaggie Reduction to smooth out the stair step effect in moving diagonal lines. This is accomplish by horizontally smoothing only the rapidly moving pixels, leaving the stationary ones alone. If a diagonal edge is not moving then it won't be jagged anyway under Greedy High Motion.</para></listitem>
              <listitem><para>Slider adjustments for Max Comb, Motion Threshold, and Motion Sensitivity. However the defaults should be okay for most cases.</para></listitem>
            </itemizedlist>
            <para>Basic Level is compatible with all MMX, Pentium II, AMD K6-II, K6-III, Celeron and above machines. Performance will probably be about that of the Greedy 2-Frame method.</para>
            <para>There is also an Advanced Level (experimental) which is invoked if you check any of the boxes in the panel. A machine supporting the Intel SSE instruction set is needed. The Advanced options should run on Athlons, Intel P-III, P4, and the faster Celerons.</para>
            <!-- When using the Advanced Features Greedy (HM) maintains its own internal history of the last 4 video input fields. This means it must be able to examine every field and you can't use it at the same time as DScaler's regular Auto_Pulldown option. So if you are going to use the advanced options, please first be sure the Settings/Deinterlace/Auto_Pulldown option is not checked. -->
            <para>Using the Advanced Options is <!-- also --> very sensitive to machine performance and dropped frames, so you may have to lower your Resolution if you get jerkiness. <!-- It's also best to have Hurry_When_Late=0 in the DScaler.ini file. --></para>
            <para>The new check box enabled features are:</para>
            <itemizedlist>
              <listitem><para>Built in 3:2, 2:2, and n:m Pulldown. This does pulldown matching, not removal, so all frames are displayed. I think this eventually will work better with video overlays and live TV viewing that is extensively edited, but it still needs improvement.</para></listitem>
              <listitem><para>In-Between Frames. This gives judder reduction for those of us with fixed 60 HZ RTPV's. In a 3:2 pulldown situation it will select an appropriate pair of fields to average once out of every 5 frames. This can effectively display every new input frame 2 1/ 2 times. It will cause a small amount of motion blur every fifth frame but I personally leave it turned on all the time now for a smoother film picture sequence. It will also work with 2:2 pulldown (I think) but there one half of the frames will be averaged and the motion blur may not be acceptable.</para></listitem>
              <listitem><para>Adjustable Edge Enhancement. This is due to an idea posted by this forum's MR. Wigggles. It enhances only a small amount, on the horizontal axis. When turned on you can use a slider to adjust it.</para></listitem>
              <listitem><para>Adjustable Median Filter. Also due to Mr. Wigggles, this can help filter noise. However if set over about 3-5 it will also cause motion artifacts on fast moving scenes. Also has a slider.</para></listitem>
              <listitem><para>Vertical Filter. This is a post-deinterlace software vertical filter that can remove both noise and some leftover deinterlace artifacts. It gives results similar to the hardware version available on the Advanced Video Flags screen, but not so extreme and without the jitter.</para></listitem>
            </itemizedlist>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Greedy 2 Frame</term>
          <listitem>
            <para>This method tries to combine the best features of the 2-frame algorithm with the looking ahead ability of the greedy method. I find this methods works well on sports and other high motion material. With static images and low quality sources there may be unacceptable levels of bobbing. This method uses four fields and has a configuarable motion detect. Motion is detected on a two pixel basis. This is the current default method for faster processors as it gives the best all round performance. Options:</para>
            <variablelist>
              <varlistentry>
                <term>Greedy 2 Frame Luma Threshold</term>
                <listitem>
                  <para>Luma differences above this will be interpreted as movement.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Greedy 2 Frame Chroma Threshold</term>
                <listitem>
                  <para>Chroma differences above this will be interpreted as movement.</para>
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Video (TomsMoComp)</term>
          <listitem>
            <para>This method is the latest and greatest method from Tom Barry. This new method improves on some of the older methods in two important ways. Where there is motion, the bob pixels are generated by looking along a series of diagonals as well as simple the ones above and below. Also when there is motion the code will try and spot slowly moving objects and will try and maintain the detail on those objects. The combined effect of these two searches is a big jump in picture quality and also a big jump in CPU usage. A 1 GHz CPU is required to use this method. Options:</para>
            <variablelist>
              <varlistentry>
                <term>Search Effort</term>
                <listitem>
                  <para>This setting controls how much CPU is used by the method by controlling how big an area the method will search looking for matches. A Search effort (SE) of 0 means that all pixels are smart bobbed and is not recommended. SE = 1 does no motion compensation, but doesn benefit from the diagonal bob interpolation. SE > 1 starts to do true MoComp with increasing CPU demands. You should use the highest value that allows you to run any other filters etc without dropped frames.</para>
                </listitem>
              </varlistentry>
              <varlistentry>
                <term>Use Strange Bob</term>
                <listitem>
                  <para>This was some test code added by John Adcock to try and reduce the number of errors in the diagonal searches. It is not recommended.</para>
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Video (MoComp2)</term>
          <listitem>
            <para>This is a new method that should be considered a work in progress. At the moment it is a motion adaptive method with diagonal interpolation based on: T. Chen, H.R. Wu; &amp; Z.H. Yu, "Efficient deinterlacing algorithm using edge-based line average interpolation" Optical Engineering, Volume 39, Issue 8, (2000). This method also incorporates built in chroma smoothing to help disguise MPEG chroma problems.</para>
            <para>The method should be a general use one but at the moment most consider TomsMoComp to give a better picture. As this method uses less CPU than TomsMoComp it may be well suited to those who run a lot of filters. Note the built in chroma smoother means that this method may give better results with digital sourced material such as DVD or DVB.</para>
          </listitem>
        </varlistentry>

      </variablelist>

    </sect2>

  </sect1>

  <!--
Local Variables:
mode: sgml
coding: utf-8
sgml-parent-document: "zapping.xml"
comment-auto-fill-only-comments: t
indent-tabs-mode: nil
End:
  -->