[media] Document decoder controls

Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>

diff --git a/Documentation/DocBook/media/v4l/controls.xml b/Documentation/DocBook/media/v4l/controls.xml
index a1be378..3f3d2e2 100644 (file)
--- a/Documentation/DocBook/media/v4l/controls.xml
+++ b/Documentation/DocBook/media/v4l/controls.xml
@@ -1284,6 +1284,49 @@ values are:</entry>
 capturing. This is not done by muting audio hardware, which can still
 produce a slight hiss, but in the encoder itself, guaranteeing a fixed
 and reproducible audio bitstream. 0 = unmuted, 1 = muted.</entry>
+             </row>
+             <row><entry></entry></row>
+             <row id="v4l2-mpeg-audio-dec-playback">
+               <entry spanname="id"><constant>V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK</constant>&nbsp;</entry>
+               <entry>enum&nbsp;v4l2_mpeg_audio_dec_playback</entry>
+             </row><row><entry spanname="descr">Determines how monolingual audio should be played back.
+Possible values are:</entry>
+             </row>
+             <row>
+               <entrytbl spanname="descr" cols="2">
+                 <tbody valign="top">
+                   <row>
+                     <entry><constant>V4L2_MPEG_AUDIO_DEC_PLAYBACK_AUTO</constant>&nbsp;</entry>
+                     <entry>Automatically determines the best playback mode.</entry>
+                   </row>
+                   <row>
+                     <entry><constant>V4L2_MPEG_AUDIO_DEC_PLAYBACK_STEREO</constant>&nbsp;</entry>
+                     <entry>Stereo playback.</entry>
+                   </row>
+                   <row>
+                     <entry><constant>V4L2_MPEG_AUDIO_DEC_PLAYBACK_LEFT</constant>&nbsp;</entry>
+                     <entry>Left channel playback.</entry>
+                   </row>
+                   <row>
+                     <entry><constant>V4L2_MPEG_AUDIO_DEC_PLAYBACK_RIGHT</constant>&nbsp;</entry>
+                     <entry>Right channel playback.</entry>
+                   </row>
+                   <row>
+                     <entry><constant>V4L2_MPEG_AUDIO_DEC_PLAYBACK_MONO</constant>&nbsp;</entry>
+                     <entry>Mono playback.</entry>
+                   </row>
+                   <row>
+                     <entry><constant>V4L2_MPEG_AUDIO_DEC_PLAYBACK_SWAPPED_STEREO</constant>&nbsp;</entry>
+                     <entry>Stereo playback with swapped left and right channels.</entry>
+                   </row>
+                 </tbody>
+               </entrytbl>
+             </row>
+             <row><entry></entry></row>
+             <row id="v4l2-mpeg-audio-dec-multilingual-playback">
+               <entry spanname="id"><constant>V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK</constant>&nbsp;</entry>
+               <entry>enum&nbsp;v4l2_mpeg_audio_dec_playback</entry>
+             </row><row><entry spanname="descr">Determines how multilingual audio should be played back.</entry>
              </row>
              <row><entry></entry></row>
              <row id="v4l2-mpeg-video-encoding">
@@ -1447,6 +1490,22 @@ of the video. The supplied 32-bit integer is interpreted as follows (bit
                  </tbody>
                </entrytbl>
              </row>
+             <row><entry></entry></row>
+             <row id="v4l2-mpeg-video-dec-pts">
+               <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_DEC_PTS</constant>&nbsp;</entry>
+               <entry>integer64</entry>
+             </row><row><entry spanname="descr">This read-only control returns the
+33-bit video Presentation Time Stamp as defined in ITU T-REC-H.222.0 and ISO/IEC 13818-1 of
+the currently displayed frame. This is the same PTS as is used in &VIDIOC-DECODER-CMD;.</entry>
+             </row>
+             <row><entry></entry></row>
+             <row id="v4l2-mpeg-video-dec-frame">
+               <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_DEC_FRAME</constant>&nbsp;</entry>
+               <entry>integer64</entry>
+             </row><row><entry spanname="descr">This read-only control returns the
+frame counter of the frame that is currently displayed (decoded). This value is reset to 0 whenever
+the decoder is started.</entry>
+             </row>
 
 
              <row><entry></entry></row>