Commit a82c3149 authored by Steve Longerbeam's avatar Steve Longerbeam Committed by Mauro Carvalho Chehab

media: docs-rst: Clarify older field vs. first transmitted field

Add a paragraph to make it more clear that video equipment will transmit
fields in the same order the fields were captured, and replace some of
the "is transmitted first" language with "is the older field", since the
latter is the important info for motion compensation applications.
Signed-off-by: default avatarSteve Longerbeam <slongerbeam@gmail.com>
Signed-off-by: default avatarHans Verkuil <hverkuil-cisco@xs4all.nl>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+samsung@kernel.org>
parent 0783525f
...@@ -51,6 +51,11 @@ determined by the video standard. Hence the distinction between temporal ...@@ -51,6 +51,11 @@ determined by the video standard. Hence the distinction between temporal
and spatial order of fields. The diagrams below should make this and spatial order of fields. The diagrams below should make this
clearer. clearer.
In V4L it is assumed that all video cameras transmit fields on the media
bus in the same order they were captured, so if the top field was
captured first (is the older field), the top field is also transmitted
first on the bus.
All video capture and output devices must report the current field All video capture and output devices must report the current field
order. Some drivers may permit the selection of a different order, to order. Some drivers may permit the selection of a different order, to
this end applications initialize the ``field`` field of struct this end applications initialize the ``field`` field of struct
...@@ -101,10 +106,10 @@ enum v4l2_field ...@@ -101,10 +106,10 @@ enum v4l2_field
* - ``V4L2_FIELD_INTERLACED`` * - ``V4L2_FIELD_INTERLACED``
- 4 - 4
- Images contain both fields, interleaved line by line. The temporal - Images contain both fields, interleaved line by line. The temporal
order of the fields (whether the top or bottom field is first order of the fields (whether the top or bottom field is older)
transmitted) depends on the current video standard. M/NTSC depends on the current video standard. In M/NTSC the bottom
transmits the bottom field first, all other standards the top field is the older field. In all other standards the top field
field first. is the older field.
* - ``V4L2_FIELD_SEQ_TB`` * - ``V4L2_FIELD_SEQ_TB``
- 5 - 5
- Images contain both fields, the top field lines are stored first - Images contain both fields, the top field lines are stored first
...@@ -135,11 +140,11 @@ enum v4l2_field ...@@ -135,11 +140,11 @@ enum v4l2_field
* - ``V4L2_FIELD_INTERLACED_TB`` * - ``V4L2_FIELD_INTERLACED_TB``
- 8 - 8
- Images contain both fields, interleaved line by line, top field - Images contain both fields, interleaved line by line, top field
first. The top field is transmitted first. first. The top field is the older field.
* - ``V4L2_FIELD_INTERLACED_BT`` * - ``V4L2_FIELD_INTERLACED_BT``
- 9 - 9
- Images contain both fields, interleaved line by line, top field - Images contain both fields, interleaved line by line, top field
first. The bottom field is transmitted first. first. The bottom field is the older field.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment