[media] DocBook/video.xml: Fix section references with video.h.xml

Make the reference links at video.h.xml to match the ones at video.xml.

Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
This commit is contained in:
Mauro Carvalho Chehab 2011-06-08 15:39:05 -03:00
Родитель ec77f15cae
Коммит dc05e57172
2 изменённых файлов: 93 добавлений и 84 удалений

Просмотреть файл

@ -146,7 +146,7 @@ DVB_DOCUMENTED = \
-e "s,\(define\s\+\)\(DTV_[A-Z0-9_]\+\)\(\s\+[0-9]\+\),\1\<link linkend=\"\2\">\2\<\/link\>\3,g" \ -e "s,\(define\s\+\)\(DTV_[A-Z0-9_]\+\)\(\s\+[0-9]\+\),\1\<link linkend=\"\2\">\2\<\/link\>\3,g" \
-e "s,<link\s\+linkend=\".*\">\(DTV_IOCTL_MAX_MSGS\|dtv_cmds_h\|__.*_old\)<\/link>,\1,g" \ -e "s,<link\s\+linkend=\".*\">\(DTV_IOCTL_MAX_MSGS\|dtv_cmds_h\|__.*_old\)<\/link>,\1,g" \
-e ":a;s/\(linkend=\".*\)_\(.*\">\)/\1-\2/;ta" \ -e ":a;s/\(linkend=\".*\)_\(.*\">\)/\1-\2/;ta" \
-e "s,\(audio-mixer\|audio-karaoke\|audio-status\|ca-slot-info\|ca-descr-info\|ca-caps\|ca-msg\|ca-descr\|ca-pid\|dmx-filter\|dmx-caps\)-t,\1,g" \ -e "s,\(audio-mixer\|audio-karaoke\|audio-status\|ca-slot-info\|ca-descr-info\|ca-caps\|ca-msg\|ca-descr\|ca-pid\|dmx-filter\|dmx-caps\|video-system\|video-highlight\|video-spu\|video-spu-palette\|video-navi-pack\)-t,\1,g" \
-e "s,DTV-ISDBT-LAYER[A-C],DTV-ISDBT-LAYER,g" \ -e "s,DTV-ISDBT-LAYER[A-C],DTV-ISDBT-LAYER,g" \
-e "s,\(define\s\+\)\([A-Z0-9_]\+\)\(\s\+_IO\),\1\<link linkend=\"\2\">\2\<\/link\>\3,g" \ -e "s,\(define\s\+\)\([A-Z0-9_]\+\)\(\s\+_IO\),\1\<link linkend=\"\2\">\2\<\/link\>\3,g" \
-e "s,<link\s\+linkend=\".*\">\(__.*_OLD\)<\/link>,\1,g" \ -e "s,<link\s\+linkend=\".*\">\(__.*_OLD\)<\/link>,\1,g" \

Просмотреть файл

@ -18,14 +18,15 @@ supported on some MPEG decoders made for DVD playback.
<section id="video_types"> <section id="video_types">
<title>Video Data Types</title> <title>Video Data Types</title>
<section id="video_format_t"> <section id="video-format-t">
<title>video_format_t</title> <title>video_format_t</title>
<para>The <emphasis role="tt">video_format_t</emphasis> data type defined by <para>The <emphasis role="tt">video_format_t</emphasis> data type defined by
</para> </para>
<programlisting> <programlisting>
typedef enum { typedef enum {
VIDEO_FORMAT_4_3, VIDEO_FORMAT_4_3, /&#x22C6; Select 4:3 format &#x22C6;/
VIDEO_FORMAT_16_9 VIDEO_FORMAT_16_9, /&#x22C6; Select 16:9 format. &#x22C6;/
VIDEO_FORMAT_221_1 /&#x22C6; 2.21:1 &#x22C6;/
} video_format_t; } video_format_t;
</programlisting> </programlisting>
<para>is used in the VIDEO_SET_FORMAT function (??) to tell the driver which aspect ratio <para>is used in the VIDEO_SET_FORMAT function (??) to tell the driver which aspect ratio
@ -36,7 +37,7 @@ stream.
</para> </para>
</section> </section>
<section id="video_display_format_t"> <section id="video-display-format-t">
<title>video_display_format_t</title> <title>video_display_format_t</title>
<para>In case the display format of the video stream and of the display hardware differ the <para>In case the display format of the video stream and of the display hardware differ the
application has to specify how to handle the cropping of the picture. This can be done using application has to specify how to handle the cropping of the picture. This can be done using
@ -44,16 +45,16 @@ the VIDEO_SET_DISPLAY_FORMAT call (??) which accepts
</para> </para>
<programlisting> <programlisting>
typedef enum { typedef enum {
VIDEO_PAN_SCAN, VIDEO_PAN_SCAN, /&#x22C6; use pan and scan format &#x22C6;/
VIDEO_LETTER_BOX, VIDEO_LETTER_BOX, /&#x22C6; use letterbox format &#x22C6;/
VIDEO_CENTER_CUT_OUT VIDEO_CENTER_CUT_OUT /&#x22C6; use center cut out format &#x22C6;/
} video_display_format_t; } video_displayformat_t;
</programlisting> </programlisting>
<para>as argument. <para>as argument.
</para> </para>
</section> </section>
<section id="video_stream_source"> <section id="video-stream-source-t">
<title>video stream source</title> <title>video stream source</title>
<para>The video stream source is set through the VIDEO_SELECT_SOURCE call and can take <para>The video stream source is set through the VIDEO_SELECT_SOURCE call and can take
the following values, depending on whether we are replaying from an internal (demuxer) or the following values, depending on whether we are replaying from an internal (demuxer) or
@ -61,8 +62,10 @@ external (user write) source.
</para> </para>
<programlisting> <programlisting>
typedef enum { typedef enum {
VIDEO_SOURCE_DEMUX, VIDEO_SOURCE_DEMUX, /&#x22C6; Select the demux as the main source &#x22C6;/
VIDEO_SOURCE_MEMORY VIDEO_SOURCE_MEMORY /&#x22C6; If this source is selected, the stream
comes from the user through the write
system call &#x22C6;/
} video_stream_source_t; } video_stream_source_t;
</programlisting> </programlisting>
<para>VIDEO_SOURCE_DEMUX selects the demultiplexer (fed either by the frontend or the <para>VIDEO_SOURCE_DEMUX selects the demultiplexer (fed either by the frontend or the
@ -72,48 +75,54 @@ call.
</para> </para>
</section> </section>
<section id="video_play_state"> <section id="video-play-state-t">
<title>video play state</title> <title>video play state</title>
<para>The following values can be returned by the VIDEO_GET_STATUS call representing the <para>The following values can be returned by the VIDEO_GET_STATUS call representing the
state of video playback. state of video playback.
</para> </para>
<programlisting> <programlisting>
typedef enum { typedef enum {
VIDEO_STOPPED, VIDEO_STOPPED, /&#x22C6; Video is stopped &#x22C6;/
VIDEO_PLAYING, VIDEO_PLAYING, /&#x22C6; Video is currently playing &#x22C6;/
VIDEO_FREEZED VIDEO_FREEZED /&#x22C6; Video is freezed &#x22C6;/
} video_play_state_t; } video_play_state_t;
</programlisting> </programlisting>
</section> </section>
<section id="video_event"> <section id="video-event">
<title>struct video_event</title> <title>struct video_event</title>
<para>The following is the structure of a video event as it is returned by the VIDEO_GET_EVENT <para>The following is the structure of a video event as it is returned by the VIDEO_GET_EVENT
call. call.
</para> </para>
<programlisting> <programlisting>
struct video_event { struct video_event {
int32_t type; __s32 type;
time_t timestamp; #define VIDEO_EVENT_SIZE_CHANGED 1
#define VIDEO_EVENT_FRAME_RATE_CHANGED 2
#define VIDEO_EVENT_DECODER_STOPPED 3
#define VIDEO_EVENT_VSYNC 4
__kernel_time_t timestamp;
union { union {
video_format_t video_format; video_size_t size;
unsigned int frame_rate; /&#x22C6; in frames per 1000sec &#x22C6;/
unsigned char vsync_field; /&#x22C6; unknown/odd/even/progressive &#x22C6;/
} u; } u;
}; };
</programlisting> </programlisting>
</section> </section>
<section id="video_status"> <section id="video-status">
<title>struct video_status</title> <title>struct video_status</title>
<para>The VIDEO_GET_STATUS call returns the following structure informing about various <para>The VIDEO_GET_STATUS call returns the following structure informing about various
states of the playback operation. states of the playback operation.
</para> </para>
<programlisting> <programlisting>
struct video_status { struct video_status {
boolean video_blank; int video_blank; /&#x22C6; blank video on freeze? &#x22C6;/
video_play_state_t play_state; video_play_state_t play_state; /&#x22C6; current state of playback &#x22C6;/
video_stream_source_t stream_source; video_stream_source_t stream_source; /&#x22C6; current source (demux/memory) &#x22C6;/
video_format_t video_format; video_format_t video_format; /&#x22C6; current aspect ratio of stream &#x22C6;/
video_displayformat_t display_format; video_displayformat_t display_format;/&#x22C6; selected cropping mode &#x22C6;/
}; };
</programlisting> </programlisting>
<para>If video_blank is set video will be blanked out if the channel is changed or if playback is <para>If video_blank is set video will be blanked out if the channel is changed or if playback is
@ -127,7 +136,7 @@ device.
</para> </para>
</section> </section>
<section id="video_still_picture"> <section id="video-still-picture">
<title>struct video_still_picture</title> <title>struct video_still_picture</title>
<para>An I-frame displayed via the VIDEO_STILLPICTURE call is passed on within the <para>An I-frame displayed via the VIDEO_STILLPICTURE call is passed on within the
following structure. following structure.
@ -135,7 +144,7 @@ following structure.
<programlisting> <programlisting>
/&#x22C6; pointer to and size of a single iframe in memory &#x22C6;/ /&#x22C6; pointer to and size of a single iframe in memory &#x22C6;/
struct video_still_picture { struct video_still_picture {
char &#x22C6;iFrame; char &#x22C6;iFrame; /&#x22C6; pointer to a single iframe in memory &#x22C6;/
int32_t size; int32_t size;
}; };
</programlisting> </programlisting>
@ -164,7 +173,7 @@ bits set according to the hardwares capabilities.
</programlisting> </programlisting>
</section> </section>
<section id="video_system"> <section id="video-system">
<title>video system</title> <title>video system</title>
<para>A call to VIDEO_SET_SYSTEM sets the desired video system for TV output. The <para>A call to VIDEO_SET_SYSTEM sets the desired video system for TV output. The
following system types can be set: following system types can be set:
@ -183,7 +192,7 @@ following system types can be set:
</programlisting> </programlisting>
</section> </section>
<section id="video_highlight"> <section id="video-highlight">
<title>struct video_highlight</title> <title>struct video_highlight</title>
<para>Calling the ioctl VIDEO_SET_HIGHLIGHTS posts the SPU highlight information. The <para>Calling the ioctl VIDEO_SET_HIGHLIGHTS posts the SPU highlight information. The
call expects the following format for that information: call expects the following format for that information:
@ -210,7 +219,7 @@ call expects the following format for that information:
</programlisting> </programlisting>
</section> </section>
<section id="video_spu"> <section id="video-spu">
<title>video SPU</title> <title>video SPU</title>
<para>Calling VIDEO_SET_SPU deactivates or activates SPU decoding, according to the <para>Calling VIDEO_SET_SPU deactivates or activates SPU decoding, according to the
following format: following format:
@ -224,7 +233,7 @@ following format:
</programlisting> </programlisting>
</section> </section>
<section id="video_spu_palette"> <section id="video-spu-palette">
<title>video SPU palette</title> <title>video SPU palette</title>
<para>The following structure is used to set the SPU palette by calling VIDEO_SPU_PALETTE: <para>The following structure is used to set the SPU palette by calling VIDEO_SPU_PALETTE:
</para> </para>
@ -237,7 +246,7 @@ following format:
</programlisting> </programlisting>
</section> </section>
<section id="video_navi_pack"> <section id="video-navi-pack">
<title>video NAVI pack</title> <title>video NAVI pack</title>
<para>In order to get the navigational data the following structure has to be passed to the ioctl <para>In order to get the navigational data the following structure has to be passed to the ioctl
VIDEO_GET_NAVI: VIDEO_GET_NAVI:
@ -252,7 +261,7 @@ VIDEO_GET_NAVI:
</section> </section>
<section id="video_attributes"> <section id="video-attributes-t">
<title>video attributes</title> <title>video attributes</title>
<para>The following attributes can be set by a call to VIDEO_SET_ATTRIBUTES: <para>The following attributes can be set by a call to VIDEO_SET_ATTRIBUTES:
</para> </para>
@ -488,7 +497,7 @@ VIDEO_GET_NAVI:
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_STOP"
role="subsection"><title>VIDEO_STOP</title> role="subsection"><title>VIDEO_STOP</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -562,7 +571,7 @@ role="subsection"><title>VIDEO_STOP</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_PLAY"
role="subsection"><title>VIDEO_PLAY</title> role="subsection"><title>VIDEO_PLAY</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -615,7 +624,7 @@ role="subsection"><title>VIDEO_PLAY</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_FREEZE"
role="subsection"><title>VIDEO_FREEZE</title> role="subsection"><title>VIDEO_FREEZE</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -672,7 +681,7 @@ role="subsection"><title>VIDEO_FREEZE</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_CONTINUE"
role="subsection"><title>VIDEO_CONTINUE</title> role="subsection"><title>VIDEO_CONTINUE</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -725,7 +734,7 @@ role="subsection"><title>VIDEO_CONTINUE</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_SELECT_SOURCE"
role="subsection"><title>VIDEO_SELECT_SOURCE</title> role="subsection"><title>VIDEO_SELECT_SOURCE</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -788,7 +797,7 @@ role="subsection"><title>VIDEO_SELECT_SOURCE</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_SET_BLANK"
role="subsection"><title>VIDEO_SET_BLANK</title> role="subsection"><title>VIDEO_SET_BLANK</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -861,7 +870,7 @@ role="subsection"><title>VIDEO_SET_BLANK</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_GET_STATUS"
role="subsection"><title>VIDEO_GET_STATUS</title> role="subsection"><title>VIDEO_GET_STATUS</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -929,7 +938,7 @@ role="subsection"><title>VIDEO_GET_STATUS</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_GET_EVENT"
role="subsection"><title>VIDEO_GET_EVENT</title> role="subsection"><title>VIDEO_GET_EVENT</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -1018,7 +1027,7 @@ role="subsection"><title>VIDEO_GET_EVENT</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_SET_DISPLAY_FORMAT"
role="subsection"><title>VIDEO_SET_DISPLAY_FORMAT</title> role="subsection"><title>VIDEO_SET_DISPLAY_FORMAT</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -1088,7 +1097,7 @@ role="subsection"><title>VIDEO_SET_DISPLAY_FORMAT</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_STILLPICTURE"
role="subsection"><title>VIDEO_STILLPICTURE</title> role="subsection"><title>VIDEO_STILLPICTURE</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -1158,7 +1167,7 @@ role="subsection"><title>VIDEO_STILLPICTURE</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_FAST_FORWARD"
role="subsection"><title>VIDEO_FAST_FORWARD</title> role="subsection"><title>VIDEO_FAST_FORWARD</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -1232,7 +1241,7 @@ role="subsection"><title>VIDEO_FAST_FORWARD</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_SLOWMOTION"
role="subsection"><title>VIDEO_SLOWMOTION</title> role="subsection"><title>VIDEO_SLOWMOTION</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -1306,7 +1315,7 @@ role="subsection"><title>VIDEO_SLOWMOTION</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_GET_CAPABILITIES"
role="subsection"><title>VIDEO_GET_CAPABILITIES</title> role="subsection"><title>VIDEO_GET_CAPABILITIES</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -1368,7 +1377,7 @@ role="subsection"><title>VIDEO_GET_CAPABILITIES</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_SET_ID"
role="subsection"><title>VIDEO_SET_ID</title> role="subsection"><title>VIDEO_SET_ID</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -1435,7 +1444,7 @@ role="subsection"><title>VIDEO_SET_ID</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_CLEAR_BUFFER"
role="subsection"><title>VIDEO_CLEAR_BUFFER</title> role="subsection"><title>VIDEO_CLEAR_BUFFER</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -1479,7 +1488,7 @@ role="subsection"><title>VIDEO_CLEAR_BUFFER</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_SET_STREAMTYPE"
role="subsection"><title>VIDEO_SET_STREAMTYPE</title> role="subsection"><title>VIDEO_SET_STREAMTYPE</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -1540,7 +1549,7 @@ role="subsection"><title>VIDEO_SET_STREAMTYPE</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_SET_FORMAT"
role="subsection"><title>VIDEO_SET_FORMAT</title> role="subsection"><title>VIDEO_SET_FORMAT</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -1601,7 +1610,7 @@ role="subsection"><title>VIDEO_SET_FORMAT</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_SET_SYSTEM"
role="subsection"><title>VIDEO_SET_SYSTEM</title> role="subsection"><title>VIDEO_SET_SYSTEM</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -1663,7 +1672,7 @@ role="subsection"><title>VIDEO_SET_SYSTEM</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_SET_HIGHLIGHT"
role="subsection"><title>VIDEO_SET_HIGHLIGHT</title> role="subsection"><title>VIDEO_SET_HIGHLIGHT</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -1723,7 +1732,7 @@ role="subsection"><title>VIDEO_SET_HIGHLIGHT</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_SET_SPU"
role="subsection"><title>VIDEO_SET_SPU</title> role="subsection"><title>VIDEO_SET_SPU</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -1785,7 +1794,7 @@ role="subsection"><title>VIDEO_SET_SPU</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_SET_SPU_PALETTE"
role="subsection"><title>VIDEO_SET_SPU_PALETTE</title> role="subsection"><title>VIDEO_SET_SPU_PALETTE</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -1845,7 +1854,7 @@ role="subsection"><title>VIDEO_SET_SPU_PALETTE</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_GET_NAVI"
role="subsection"><title>VIDEO_GET_NAVI</title> role="subsection"><title>VIDEO_GET_NAVI</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>
@ -1907,7 +1916,7 @@ role="subsection"><title>VIDEO_GET_NAVI</title>
</entry> </entry>
</row></tbody></tgroup></informaltable> </row></tbody></tgroup></informaltable>
</section><section </section><section id="VIDEO_SET_ATTRIBUTES"
role="subsection"><title>VIDEO_SET_ATTRIBUTES</title> role="subsection"><title>VIDEO_SET_ATTRIBUTES</title>
<para>DESCRIPTION <para>DESCRIPTION
</para> </para>