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