[media] diff-v4l.rst: Fix V4L version 1 references

The V4L ``VIDIOCGCAP`` ioctl is equivalent to V4L2's

:ref:`VIDIOC_QUERYCAP`.

The ``name`` field in struct :c:type:`struct video_capability` became

The ``name`` field in struct ``video_capability`` became

``card`` in struct :c:type:`v4l2_capability`, ``type``

was replaced by ``capabilities``. Note V4L2 does not distinguish between

device types like this, better think of basic video input, video output

=============

V4L provides the ``VIDIOCGCHAN`` and ``VIDIOCSCHAN`` ioctl using struct

:c:type:`struct video_channel` to enumerate the video inputs of a V4L

``video_channel`` to enumerate the video inputs of a V4L

device. The equivalent V4L2 ioctls are

:ref:`VIDIOC_ENUMINPUT`,

:ref:`VIDIOC_G_INPUT <VIDIOC_G_INPUT>` and

    -  .. row 1

       -  struct :c:type:`struct video_channel` ``type``

       -  struct ``video_channel`` ``type``

       -  struct :c:type:`v4l2_input` ``type``

======

The V4L ``VIDIOCGTUNER`` and ``VIDIOCSTUNER`` ioctl and struct

:c:type:`struct video_tuner` can be used to enumerate the tuners of a

``video_tuner`` can be used to enumerate the tuners of a

V4L TV or radio device. The equivalent V4L2 ioctls are

:ref:`VIDIOC_G_TUNER <VIDIOC_G_TUNER>` and

:ref:`VIDIOC_S_TUNER <VIDIOC_G_TUNER>` using struct

================

V4L2 has no equivalent of the ``VIDIOCGPICT`` and ``VIDIOCSPICT`` ioctl

and struct :c:type:`struct video_picture`. The following fields where

and struct ``video_picture``. The following fields where

replaced by V4L2 controls accessible with the

:ref:`VIDIOC_QUERYCTRL`,

:ref:`VIDIOC_G_CTRL <VIDIOC_G_CTRL>` and

    -  .. row 1

       -  struct :c:type:`struct video_picture`

       -  struct ``video_picture``

       -  V4L2 Control ID

    -  .. row 1

       -  struct :c:type:`struct video_picture` ``palette``

       -  struct ``video_picture`` ``palette``

       -  struct :c:type:`v4l2_pix_format` ``pixfmt``

=====

The ``VIDIOCGAUDIO`` and ``VIDIOCSAUDIO`` ioctl and struct

:c:type:`struct video_audio` are used to enumerate the audio inputs

``video_audio`` are used to enumerate the audio inputs

of a V4L device. The equivalent V4L2 ioctls are

:ref:`VIDIOC_G_AUDIO <VIDIOC_G_AUDIO>` and

:ref:`VIDIOC_S_AUDIO <VIDIOC_G_AUDIO>` using struct

    -  .. row 1

       -  struct :c:type:`struct video_audio`

       -  struct ``video_audio``

       -  V4L2 Control ID

``V4L2_CID_AUDIO_MUTE`` control.

All V4L2 controls have a ``step`` attribute replacing the struct

:c:type:`struct video_audio` ``step`` field. The V4L audio controls

``video_audio`` ``step`` field. The V4L audio controls

are assumed to range from 0 to 65535 with no particular reset value. The

V4L2 API permits arbitrary limits and defaults which can be queried with

the :ref:`VIDIOC_QUERYCTRL` ioctl. For general

The V4L2 ioctls equivalent to ``VIDIOCGFBUF`` and ``VIDIOCSFBUF`` are

:ref:`VIDIOC_G_FBUF <VIDIOC_G_FBUF>` and

:ref:`VIDIOC_S_FBUF <VIDIOC_G_FBUF>`. The ``base`` field of struct

:c:type:`struct video_buffer` remained unchanged, except V4L2 defines

``video_buffer`` remained unchanged, except V4L2 defines

a flag to indicate non-destructive overlays instead of a ``NULL``

pointer. All other fields moved into the struct

:c:type:`v4l2_pix_format` ``fmt`` substructure of

:c:type:`v4l2_window`.

The ``x``, ``y``, ``width`` and ``height`` fields of struct

:c:type:`struct video_window` moved into struct

``video_window`` moved into struct

:c:type:`v4l2_rect` substructure ``w`` of struct

:c:type:`struct v4l2_window`. The ``chromakey``, ``clips``, and

:c:type:`v4l2_window`. The ``chromakey``, ``clips``, and

``clipcount`` fields remained unchanged. Struct

:c:type:`struct video_clip` was renamed to struct

``video_clip`` was renamed to struct

:c:type:`v4l2_clip`, also containing a struct

:c:type:`struct v4l2_rect`, but the semantics are still the same.

:c:type:`v4l2_rect`, but the semantics are still the same.

The ``VIDEO_WINDOW_INTERLACE`` flag was dropped. Instead applications

must set the ``field`` field to ``V4L2_FIELD_ANY`` or

In V4L, storing a bitmap pointer in ``clips`` and setting ``clipcount``

to ``VIDEO_CLIP_BITMAP`` (-1) requests bitmap clipping, using a fixed

size bitmap of 1024 × 625 bits. Struct :c:type:`struct v4l2_window`

size bitmap of 1024 × 625 bits. Struct :c:type:`v4l2_window`

has a separate ``bitmap`` pointer field for this purpose and the bitmap

size is determined by ``w.width`` and ``w.height``.

To capture only a subsection of the full picture V4L defines the

``VIDIOCGCAPTURE`` and ``VIDIOCSCAPTURE`` ioctls using struct

:c:type:`struct video_capture`. The equivalent V4L2 ioctls are

``video_capture``. The equivalent V4L2 ioctls are

:ref:`VIDIOC_G_CROP <VIDIOC_G_CROP>` and

:ref:`VIDIOC_S_CROP <VIDIOC_G_CROP>` using struct

:c:type:`v4l2_crop`, and the related

The ``x``, ``y``, ``width`` and ``height`` fields moved into struct

:c:type:`v4l2_rect` substructure ``c`` of struct

:c:type:`struct v4l2_crop`. The ``decimation`` field was dropped. In

:c:type:`v4l2_crop`. The ``decimation`` field was dropped. In

the V4L2 API the scaling factor is implied by the size of the cropping

rectangle and the size of the captured or overlaid image.

Undocumented in the V4L specification, in Linux 2.3 the

``VIDIOCGVBIFMT`` and ``VIDIOCSVBIFMT`` ioctls using struct

:c:type:`struct vbi_format` were added to determine the VBI image

``vbi_format`` were added to determine the VBI image

parameters. These ioctls are only partially compatible with the V4L2 VBI

interface specified in :ref:`raw-vbi`.