62 lines
1.8 KiB
ReStructuredText
62 lines
1.8 KiB
ReStructuredText
|
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later OR GPL-2.0
|
||
|
|
|
||
|
|
.. _legacy_dvb_decoder_api:
|
||
|
|
|
||
|
|
============================
|
||
|
|
Legacy DVB MPEG Decoder APIs
|
||
|
|
============================
|
||
|
|
|
||
|
|
.. _legacy_dvb_decoder_notes:
|
||
|
|
|
||
|
|
General Notes
|
||
|
|
=============
|
||
|
|
|
||
|
|
This API has originally been designed for DVB only and is therefore limited to
|
||
|
|
the :ref:`legacy_dvb_decoder_formats` used in such digital TV-broadcastsystems.
|
||
|
|
|
||
|
|
To circumvent this limitations the more versatile :ref:`V4L2 <v4l2spec>` API has
|
||
|
|
been designed. Which replaces this part of the DVB API.
|
||
|
|
|
||
|
|
Nevertheless there have been projects build around this API.
|
||
|
|
To ensure compatibility this API is kept as it is.
|
||
|
|
|
||
|
|
.. attention:: Do **not** use this API in new drivers!
|
||
|
|
|
||
|
|
For audio and video use the :ref:`V4L2 <v4l2spec>` and ALSA APIs.
|
||
|
|
|
||
|
|
Pipelines should be set up using the :ref:`Media Controller API<media_controller>`.
|
||
|
|
|
||
|
|
Practically the decoders seem to be treated differently. The application typically
|
||
|
|
knows which decoder is in use or it is specially written for one decoder type.
|
||
|
|
Querying capabilities are rarely used because they are already known.
|
||
|
|
|
||
|
|
|
||
|
|
.. _legacy_dvb_decoder_formats:
|
||
|
|
|
||
|
|
Data Formats
|
||
|
|
============
|
||
|
|
|
||
|
|
The API has been designed for DVB and compatible broadcastsystems.
|
||
|
|
Because of that fact the only supported data formats are ISO/IEC 13818-1
|
||
|
|
compatible MPEG streams. The supported payloads may vary depending on the
|
||
|
|
used decoder.
|
||
|
|
|
||
|
|
Timestamps are always MPEG PTS as defined in ITU T-REC-H.222.0 /
|
||
|
|
ISO/IEC 13818-1, if not otherwise noted.
|
||
|
|
|
||
|
|
For storing recordings typically TS streams are used, in lesser extent PES.
|
||
|
|
Both variants are commonly accepted for playback, but it may be driver dependent.
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
Table of Contents
|
||
|
|
=================
|
||
|
|
|
||
|
|
.. toctree::
|
||
|
|
:maxdepth: 2
|
||
|
|
|
||
|
|
legacy_dvb_video
|
||
|
|
legacy_dvb_audio
|
||
|
|
legacy_dvb_osd
|