aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--Documentation/media/uapi/v4l/field-order.rst16
1 files changed, 7 insertions, 9 deletions
diff --git a/Documentation/media/uapi/v4l/field-order.rst b/Documentation/media/uapi/v4l/field-order.rst
index 3fb473e3b8e2..d640e922a974 100644
--- a/Documentation/media/uapi/v4l/field-order.rst
+++ b/Documentation/media/uapi/v4l/field-order.rst
@@ -75,12 +75,11 @@ enum v4l2_field
75 75
76 * - ``V4L2_FIELD_ANY`` 76 * - ``V4L2_FIELD_ANY``
77 - 0 77 - 0
78 - Applications request this field order when any one of the 78 - Applications request this field order when any field format
79 ``V4L2_FIELD_NONE``, ``V4L2_FIELD_TOP``, ``V4L2_FIELD_BOTTOM``, or 79 is acceptable. Drivers choose depending on hardware capabilities or
80 ``V4L2_FIELD_INTERLACED`` formats is acceptable. Drivers choose 80 e.g. the requested image size, and return the actual field order.
81 depending on hardware capabilities or e. g. the requested image 81 Drivers must never return ``V4L2_FIELD_ANY``.
82 size, and return the actual field order. Drivers must never return 82 If multiple field orders are possible the
83 ``V4L2_FIELD_ANY``. If multiple field orders are possible the
84 driver must choose one of the possible field orders during 83 driver must choose one of the possible field orders during
85 :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` or 84 :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` or
86 :ref:`VIDIOC_TRY_FMT <VIDIOC_G_FMT>`. struct 85 :ref:`VIDIOC_TRY_FMT <VIDIOC_G_FMT>`. struct
@@ -88,9 +87,8 @@ enum v4l2_field
88 ``V4L2_FIELD_ANY``. 87 ``V4L2_FIELD_ANY``.
89 * - ``V4L2_FIELD_NONE`` 88 * - ``V4L2_FIELD_NONE``
90 - 1 89 - 1
91 - Images are in progressive format, not interlaced. The driver may 90 - Images are in progressive (frame-based) format, not interlaced
92 also indicate this order when it cannot distinguish between 91 (field-based).
93 ``V4L2_FIELD_TOP`` and ``V4L2_FIELD_BOTTOM``.
94 * - ``V4L2_FIELD_TOP`` 92 * - ``V4L2_FIELD_TOP``
95 - 2 93 - 2
96 - Images consist of the top (aka odd) field only. 94 - Images consist of the top (aka odd) field only.