Merge branch 'for-linus-4.21-rc1' of git://git.kernel.org/pub/scm/linux/kernel/git...
[sfrench/cifs-2.6.git] / Documentation / media / uapi / dvb / video.rst
1 .. Permission is granted to copy, distribute and/or modify this
2 .. document under the terms of the GNU Free Documentation License,
3 .. Version 1.1 or any later version published by the Free Software
4 .. Foundation, with no Invariant Sections, no Front-Cover Texts
5 .. and no Back-Cover Texts. A copy of the license is included at
6 .. Documentation/media/uapi/fdl-appendix.rst.
7 ..
8 .. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
9
10 .. _dvb_video:
11
12 #######################
13 Digital TV Video Device
14 #######################
15
16 The Digital TV video device controls the MPEG2 video decoder of the Digital
17 TV hardware. It can be accessed through **/dev/dvb/adapter0/video0**. Data
18 types and and ioctl definitions can be accessed by including
19 **linux/dvb/video.h** in your application.
20
21 Note that the Digital TV video device only controls decoding of the MPEG video
22 stream, not its presentation on the TV or computer screen. On PCs this
23 is typically handled by an associated video4linux device, e.g.
24 **/dev/video**, which allows scaling and defining output windows.
25
26 Some Digital TV cards don’t have their own MPEG decoder, which results in the
27 omission of the audio and video device as well as the video4linux
28 device.
29
30 The ioctls that deal with SPUs (sub picture units) and navigation
31 packets are only supported on some MPEG decoders made for DVD playback.
32
33 These ioctls were also used by V4L2 to control MPEG decoders implemented
34 in V4L2. The use of these ioctls for that purpose has been made obsolete
35 and proper V4L2 ioctls or controls have been created to replace that
36 functionality.
37
38
39 .. toctree::
40     :maxdepth: 1
41
42     video_types
43     video_function_calls