Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 12c78e66 authored by Hans Verkuil's avatar Hans Verkuil Committed by Mauro Carvalho Chehab
Browse files

[media] DocBook media: document new VBI defines 



Add defines for the start line numbers of each field for both
525 and 625 line formats.

Signed-off-by: default avatarHans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: default avatarMauro Carvalho Chehab <m.chehab@samsung.com>
parent 273886b4

Documentation/DocBook/media/v4l/dev-raw-vbi.xml

+9 −3
Original line number Diff line number Diff line
@@ -150,9 +150,15 @@ signal. Drivers shall not convert the sample format by software.</para></entry> 
	      <entry>This is the scanning system line number

associated with the first line of the VBI image, of the first and the

second field respectively. See <xref linkend="vbi-525" /> and

<xref linkend="vbi-625" /> for valid values. VBI input drivers can

return start values 0 if the hardware cannot reliable identify

scanning lines, VBI acquisition may not require this

<xref linkend="vbi-625" /> for valid values.

The <constant>V4L2_VBI_ITU_525_F1_START</constant>,

<constant>V4L2_VBI_ITU_525_F2_START</constant>,

<constant>V4L2_VBI_ITU_625_F1_START</constant> and

<constant>V4L2_VBI_ITU_625_F2_START</constant> defines give the start line

numbers for each field for each 525 or 625 line format as a convenience.

Don't forget that ITU line numbering starts at 1, not 0.

VBI input drivers can return start values 0 if the hardware cannot

reliable identify scanning lines, VBI acquisition may not require this

information.</entry>

	    </row>

	    <row>

Documentation/DocBook/media/v4l/dev-sliced-vbi.xml

+8 −1
Original line number Diff line number Diff line
@@ -185,7 +185,14 @@ tables, sigh. --></para></entry> 
	    <entry></entry>

	    <entry spanname="hspan">Drivers must set

<structfield>service_lines</structfield>[0][0] and

<structfield>service_lines</structfield>[1][0] to zero.</entry>

<structfield>service_lines</structfield>[1][0] to zero.

The <constant>V4L2_VBI_ITU_525_F1_START</constant>,

<constant>V4L2_VBI_ITU_525_F2_START</constant>,

<constant>V4L2_VBI_ITU_625_F1_START</constant> and

<constant>V4L2_VBI_ITU_625_F2_START</constant> defines give the start

line numbers for each field for each 525 or 625 line format as a

convenience.  Don't forget that ITU line numbering starts at 1, not 0.

</entry>

	  </row>

	  <row>

	    <entry>__u32</entry>