| 1 | |
| 2 |
|
| 3 | .. _legacy_dvb_decoder_api:
|
| 4 |
|
| 5 | ============================
|
| 6 | Legacy DVB MPEG Decoder APIs
|
| 7 | ============================
|
| 8 |
|
| 9 | .. _legacy_dvb_decoder_notes:
|
| 10 |
|
| 11 | General Notes
|
| 12 | =============
|
| 13 |
|
| 14 | This API has originally been designed for DVB only and is therefore limited to
|
| 15 | the :ref:`legacy_dvb_decoder_formats` used in such digital TV-broadcastsystems.
|
| 16 |
|
| 17 | To circumvent this limitations the more versatile :ref:`V4L2 <v4l2spec>` API has
|
| 18 | been designed. Which replaces this part of the DVB API.
|
| 19 |
|
| 20 | Nevertheless there have been projects build around this API.
|
| 21 | To ensure compatibility this API is kept as it is.
|
| 22 |
|
| 23 | .. attention:: Do **not** use this API in new drivers!
|
| 24 |
|
| 25 | For audio and video use the :ref:`V4L2 <v4l2spec>` and ALSA APIs.
|
| 26 |
|
| 27 | Pipelines should be set up using the :ref:`Media Controller API<media_controller>`.
|
| 28 |
|
| 29 | Practically the decoders seem to be treated differently. The application typically
|
| 30 | knows which decoder is in use or it is specially written for one decoder type.
|
| 31 | Querying capabilities are rarely used because they are already known.
|
| 32 |
|
| 33 |
|
| 34 | .. _legacy_dvb_decoder_formats:
|
| 35 |
|
| 36 | Data Formats
|
| 37 | ============
|
| 38 |
|
| 39 | The API has been designed for DVB and compatible broadcastsystems.
|
| 40 | Because of that fact the only supported data formats are ISO/IEC 13818-1
|
| 41 | compatible MPEG streams. The supported payloads may vary depending on the
|
| 42 | used decoder.
|
| 43 |
|
| 44 | Timestamps are always MPEG PTS as defined in ITU T-REC-H.222.0 /
|
| 45 | ISO/IEC 13818-1, if not otherwise noted.
|
| 46 |
|
| 47 | For storing recordings typically TS streams are used, in lesser extent PES.
|
| 48 | Both variants are commonly accepted for playback, but it may be driver dependent.
|
| 49 |
|
| 50 |
|
| 51 |
|
| 52 |
|
| 53 | Table of Contents
|
| 54 | =================
|
| 55 |
|
| 56 | .. toctree::
|
| 57 | :maxdepth: 2
|
| 58 |
|
| 59 | legacy_dvb_video
|
| 60 | legacy_dvb_audio
|
| 61 | legacy_dvb_osd
|