[deliverable/linux.git] / Documentation / media / uapi / v4l / selections-common.rst

.. -*- coding: utf-8; mode: rst -*-

.. _v4l2-selections-common:

Common selection definitions
============================

While the :ref:`V4L2 selection API <selection-api>` and
:ref:`V4L2 subdev selection APIs <v4l2-subdev-selections>` are very
similar, there's one fundamental difference between the two. On
sub-device API, the selection rectangle refers to the media bus format,
and is bound to a sub-device's pad. On the V4L2 interface the selection
rectangles refer to the in-memory pixel format.

This section defines the common definitions of the selection interfaces
on the two APIs.


.. toctree::
    :maxdepth: 1

    v4l2-selection-targets
    v4l2-selection-flags
Commit	Line	Data
5377d91f MH	1	.. -- coding: utf-8; mode: rst --
	2
	3	.. _v4l2-selections-common:
	4
	5	Common selection definitions
	6	============================
	7
	8	While the :ref:`V4L2 selection API <selection-api>` and
	9	:ref:`V4L2 subdev selection APIs <v4l2-subdev-selections>` are very
	10	similar, there's one fundamental difference between the two. On
	11	sub-device API, the selection rectangle refers to the media bus format,
	12	and is bound to a sub-device's pad. On the V4L2 interface the selection
	13	rectangles refer to the in-memory pixel format.
	14
	15	This section defines the common definitions of the selection interfaces
	16	on the two APIs.
	17
	18
	19	.. toctree::
	20	:maxdepth: 1
	21
	22	v4l2-selection-targets
	23	v4l2-selection-flags