diff options
| -rw-r--r-- | Documentation/media/uapi/v4l/field-order.rst | 16 |
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. |
