Merge tag 'gcc-plugins-v4.9-rc4' of git://git.kernel.org/pub/scm/linux/kernel/git...
[cascardo/linux.git] / Documentation / media / uapi / dvb / video.rst
1 .. -*- coding: utf-8; mode: rst -*-
2
3 .. _dvb_video:
4
5 ################
6 DVB Video Device
7 ################
8 The DVB video device controls the MPEG2 video decoder of the DVB
9 hardware. It can be accessed through **/dev/dvb/adapter0/video0**. Data
10 types and and ioctl definitions can be accessed by including
11 **linux/dvb/video.h** in your application.
12
13 Note that the DVB video device only controls decoding of the MPEG video
14 stream, not its presentation on the TV or computer screen. On PCs this
15 is typically handled by an associated video4linux device, e.g.
16 **/dev/video**, which allows scaling and defining output windows.
17
18 Some DVB cards don’t have their own MPEG decoder, which results in the
19 omission of the audio and video device as well as the video4linux
20 device.
21
22 The ioctls that deal with SPUs (sub picture units) and navigation
23 packets are only supported on some MPEG decoders made for DVD playback.
24
25 These ioctls were also used by V4L2 to control MPEG decoders implemented
26 in V4L2. The use of these ioctls for that purpose has been made obsolete
27 and proper V4L2 ioctls or controls have been created to replace that
28 functionality.
29
30
31 .. toctree::
32     :maxdepth: 1
33
34     video_types
35     video_function_calls