~ubuntu-branches/ubuntu/feisty/kdetv/feisty

« back to all changes in this revision

Viewing changes to doc/nl/architecture.docbook

  • Committer: Bazaar Package Importer
  • Author(s): Jonathan Riddell
  • Date: 2005-09-17 23:25:16 UTC
  • Revision ID: james.westby@ubuntu.com-20050917232516-9wdsn3ckagbqieh8
Tags: upstream-0.8.8
ImportĀ upstreamĀ versionĀ 0.8.8

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
 
 
2
<para
 
3
>&kdetv; gebruikt een pluginsysteem zodat het gebruiksvriendelijk en flexibel is. Er zijn verschilende plugintypen, b.v. Video input, On-screen-display, Mixers en afbeeldingfilters. Waneer u &kdetv; voor het eerst start, ga dan naar het configuratiemenu om de benodige plugins te laden voor uw hardware. Erg belangrijk is dat u de juiste videoplugins gebruikt om te verkomen dat u niet tevreden bent over &kdetv;. Lees het gedeelte over de video-plugins voor meer informatie. </para>
 
4
 
 
5
<section id="device_names">
 
6
<title
 
7
>Video Device Names</title>
 
8
<para>
 
9
On most Linux systems, you will notice two kinds of device names in the device list:
 
10
<itemizedlist>
 
11
 
 
12
<listitem>
 
13
<para
 
14
>video4linux - XVideo port &lt;some_number&gt;</para>
 
15
<para>
 
16
These are the devices provided by the XVIDEO plugin. For more information about this
 
17
plugin's capabilities, refer to <link linkend="xvideo_plugin"
 
18
>XVIDEO Plugin</link
 
19
>.
 
20
</para>
 
21
</listitem>
 
22
 
 
23
<listitem>
 
24
<para
 
25
>&lt;Your video card's name&gt; Video4Linux (/dev/videoX)</para>
 
26
<para>
 
27
These are the devices provided by the Video4Linux plugin. For more information about this
 
28
plugin's capabilities, refer to <link linkend="v4l_plugin"
 
29
>Video4Linux Plugin</link
 
30
>.
 
31
</para>
 
32
</listitem>
 
33
 
 
34
</itemizedlist>
 
35
</para>
 
36
</section>
 
37
 
 
38
<section id="xvideo_plugin">
 
39
<title
 
40
>XVIDEO Plugin</title>
 
41
<para
 
42
>To find out whether you are using a XVIDEO plugin device, look here:
 
43
<link linkend="device_names"
 
44
>Video Device Names</link
 
45
></para>
 
46
<para
 
47
>How does it work?</para>
 
48
<para>
 
49
The plugin uses the X-Server to display video. It cooperates with an X-Server module that provides
 
50
video playback (the "v4l" module, a video4linux to XVIDEO bridge). The v4l bridge provides very
 
51
CPU efficient video playback because the video image is directly copied from the grabber card into
 
52
the video memory. On most modern hardware, the graphics card will scale the image to the desired
 
53
size. Some hardware even deinterlaces the image (the author of these lines uses a Radeon 9500 card
 
54
with the open-source XFree drivers, this combination provides deinterlacing). Since the v4l bridge
 
55
works in on the XFree server side, it can provide overlay video display without corrupting the
 
56
screen, as opposed to the Video4Linux plugin overlay mode.
 
57
</para>
 
58
 
 
59
<para
 
60
>What features does it provide?</para>
 
61
<para>
 
62
<itemizedlist>
 
63
<listitem
 
64
><para
 
65
>Low CPU usage</para
 
66
></listitem>
 
67
<listitem
 
68
><para
 
69
>Depending on the hardware, a quite good picture quality</para
 
70
></listitem>
 
71
</itemizedlist>
 
72
</para>
 
73
 
 
74
<para
 
75
>What features does it NOT provide? Why?</para>
 
76
<para>
 
77
<itemizedlist>
 
78
<listitem
 
79
><para
 
80
>Image filtering. The images are directly transferred to the graphics card,
 
81
there is no possibility to manipulate them in between.</para
 
82
></listitem>
 
83
<listitem
 
84
><para
 
85
>Snapshots. Reason: see above.</para
 
86
></listitem>
 
87
<listitem
 
88
><para
 
89
>Overscan. Reason: see above.</para
 
90
></listitem>
 
91
<listitem
 
92
><para
 
93
>Audio mode selection. This feature is not exposed by the XVIDEO
 
94
 XFree interface.</para
 
95
></listitem>
 
96
<listitem
 
97
><para
 
98
>Channel scanning without having the VBI decoder running. The feature to determine
 
99
 signal strength is not exposed by the XVIDEO XFree interface.</para
 
100
></listitem>
 
101
<listitem
 
102
><para
 
103
>Image scaling on some very old hardware (e.g. NVIDIA Riva 128).</para
 
104
></listitem>
 
105
</itemizedlist>
 
106
</para>
 
107
</section>
 
108
 
 
109
 
 
110
<section id="v4l_plugin">
 
111
<title
 
112
>Video4Linux Plugin</title>
 
113
<para
 
114
>To find out whether you are using a Video4Linux plugin device, look here:
 
115
<link linkend="device_names"
 
116
>Video Device Names</link
 
117
></para>
 
118
<para
 
119
>How does it work?</para>
 
120
<para>
 
121
This plugin has two operation modes:
 
122
<itemizedlist>
 
123
<listitem
 
124
><para
 
125
>Overlay</para>
 
126
<para>
 
127
It works in Overlay mode when you check the <guimenuitem
 
128
>Use overlay if possible</guimenuitem
 
129
> checkbox.
 
130
In this mode, the TV image is directly transferred into the graphics card. Since the video window can
 
131
only be updated AFTER it has been moved or resized (&kdetv; is an XFree client) you will notice display
 
132
corruption and heavy flicker whenever you move or resize the window. This is necessary to repaint the
 
133
desktop regions that were corrupted by the video stream. This mode uses almost no CPU resources, but
 
134
should only be used as a fallback if nothing else works.
 
135
</para>
 
136
<para
 
137
>What features does it provide?</para>
 
138
<para>
 
139
<itemizedlist>
 
140
<listitem
 
141
><para
 
142
>Low CPU usage</para
 
143
></listitem>
 
144
<listitem
 
145
><para
 
146
>Snapshots.</para
 
147
></listitem>
 
148
<listitem
 
149
><para
 
150
>Audio mode selection.</para
 
151
></listitem>
 
152
<listitem
 
153
><para
 
154
>Channel scanning without having the VBI decoder running.</para
 
155
></listitem>
 
156
</itemizedlist>
 
157
</para>
 
158
 
 
159
<para
 
160
>What features does it NOT provide? Why?</para>
 
161
<para>
 
162
<itemizedlist>
 
163
<listitem
 
164
><para
 
165
>Image filtering. The images are directly transferred to the graphics card,
 
166
there is no possibility to manipulate them in between.</para
 
167
></listitem>
 
168
<listitem
 
169
><para
 
170
>Overscan. Reason: see above.</para
 
171
></listitem>
 
172
<listitem
 
173
><para
 
174
>Image scaling. Most TV hardware (bt8X8 chips) does not support it.</para
 
175
></listitem>
 
176
</itemizedlist>
 
177
</para>
 
178
</listitem>
 
179
 
 
180
 
 
181
<listitem
 
182
><para
 
183
>Grab and Display</para>
 
184
<para>
 
185
This mode is active when the <guimenuitem
 
186
>Use overlay if possible</guimenuitem
 
187
> checkbox is NOT
 
188
checked. An image is grabbed from the TV card and stored in a local buffer. This buffer can be 
 
189
manipulated in arbitrary ways (deinterlacing, overscan, other filters) and is then being displayed 
 
190
using different methods (see below). This is the most flexible way, but also the most
 
191
CPU intensive way &kdetv; offers.
 
192
</para>
 
193
 
 
194
<para
 
195
>Tell me more about the different display modes</para>
 
196
<para>
 
197
<itemizedlist>
 
198
<listitem>
 
199
<para
 
200
>XVIDEO (with or without shared memory)</para>
 
201
<para>
 
202
The image is handed over to the graphics card in YUV422 format. Depending on the driver,
 
203
the graphics card or the CPU scale, the image is transformed to RGB with the display's color
 
204
depth and displayed. This is the fastest and most flexible way &kdetv; provides.
 
205
It is strongly recommended that you use this mode since it is the only mode that exposes
 
206
all of &kdetv;'s features. The usage of shared memory MAY yield a small performance benefit.
 
207
</para>
 
208
</listitem>
 
209
 
 
210
<listitem>
 
211
<para
 
212
>OpenGL</para>
 
213
<para>
 
214
The image is handed over to the graphics card in RGB format as a texture for a polygon.
 
215
If you have OpenGL hardware acceleration, the picture is scaled to the desired output
 
216
size by the graphics card, which causes a very low CPU usage. The drawback of this view mode
 
217
is that the OpenGL view mode seems to be unstable. Also, all good deinterlacers use the 
 
218
YUV422 image format, which would cause additional conversions that would nullify the hardware
 
219
acceleration effect.
 
220
</para>
 
221
</listitem>
 
222
 
 
223
<listitem>
 
224
<para
 
225
>X11 (with or without shared memory)</para>
 
226
<para>
 
227
The image is displayed using standard XFree mechanisms. This is VERY slow and does not
 
228
provide image scaling. Use it as a fallback if nothing else works. Since the video
 
229
image is grabbed in RGB format, all good deinterlacers will not work. The usage of
 
230
 shared memory MAY yield a small performance benefit.
 
231
</para>
 
232
</listitem>
 
233
</itemizedlist>
 
234
</para>
 
235
 
 
236
<para
 
237
>Framerate selection</para>
 
238
<para>
 
239
The plugins provide the option of selecting between full and half framerate. Full framerate is only
 
240
useful in conjunction with one of the "good" DScaler deinterlacers since they create
 
241
a new image from the two most recent fields. Full framerate provides "smoother" movement.
 
242
</para>
 
243
 
 
244
<para
 
245
>What features does it provide (assuming XVIDEO display mode is used)?</para>
 
246
<para>
 
247
<itemizedlist>
 
248
<listitem
 
249
><para
 
250
>Best picture quality;</para
 
251
></listitem>
 
252
<listitem
 
253
><para
 
254
>Image filtering in arbitrary ways, for example deinterlacing;</para
 
255
></listitem>
 
256
<listitem
 
257
><para
 
258
>Snapshots;</para
 
259
></listitem>
 
260
<listitem
 
261
><para
 
262
>Overscan;</para
 
263
></listitem>
 
264
<listitem
 
265
><para
 
266
>Audio mode selection;</para
 
267
></listitem>
 
268
<listitem
 
269
><para
 
270
>Channel scanning without having the VBI decoder running.</para
 
271
></listitem>
 
272
</itemizedlist>
 
273
</para>
 
274
 
 
275
<para
 
276
>What features does it NOT provide? Why?</para>
 
277
<para>
 
278
That depends on the display mode. See above. When using XVIDEO mode, all &kdetv; features are
 
279
available.
 
280
</para>
 
281
</listitem>
 
282
 
 
283
</itemizedlist>
 
284
</para>
 
285
</section>
 
286
 
 
287
<section id="mixers">
 
288
<title
 
289
>Mixer Plugins</title>
 
290
<para>
 
291
&kdetv; currently ships two mixer plugins (OSS and ALSA). These should work on all platforms
 
292
&kdetv; supports. Read the <link linkend="faq"
 
293
>FAQ</link
 
294
> when you have trouble adjusting
 
295
the volume.
 
296
</para>
 
297
</section>