Greg Kroah-Hartman
598cf27219
Link: https://lore.kernel.org/r/20260217200002.683975158@linuxfoundation.org Tested-by: Florian Fainelli <florian.fainelli@broadcom.com> Tested-by: Takeshi Ogasawara <takeshi.ogasawara@futuring-girl.com> Tested-by: Peter Schneider <pschneider1968@googlemail.com> Tested-by: Jon Hunter <jonathanh@nvidia.com> Tested-by: Salvatore Bonaccorso <carnil@debian.org> Tested-by: Brett A C Sheffield <bacs@librecast.net> Tested-by: Mark Brown <broonie@kernel.org> Tested-by: Luna Jernberg <droidbittin@gmail.com> Tested-by: Ronald Warsow <rwarsow@gmx.de> Tested-by: Justin M. Forbes <jforbes@fedoraproject.org> Tested-by: Ron Economos <re@w6rz.net> Tested-by: Miguel Ojeda <ojeda@kernel.org> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
66 lines
2.2 KiB
ReStructuredText
66 lines
2.2 KiB
ReStructuredText
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
|
|
.. c:namespace:: V4L
|
|
|
|
.. _detect-controls:
|
|
|
|
************************
|
|
Detect Control Reference
|
|
************************
|
|
|
|
The Detect class includes controls for common features of various motion
|
|
or object detection capable devices.
|
|
|
|
|
|
.. _detect-control-id:
|
|
|
|
Detect Control IDs
|
|
==================
|
|
|
|
``V4L2_CID_DETECT_CLASS (class)``
|
|
The Detect class descriptor. Calling
|
|
:ref:`VIDIOC_QUERYCTRL` for this control will
|
|
return a description of this control class.
|
|
|
|
``V4L2_CID_DETECT_MD_MODE (menu)``
|
|
Sets the motion detection mode.
|
|
|
|
.. tabularcolumns:: |p{7.7cm}|p{9.8cm}|
|
|
|
|
.. flat-table::
|
|
:header-rows: 0
|
|
:stub-columns: 0
|
|
|
|
* - ``V4L2_DETECT_MD_MODE_DISABLED``
|
|
- Disable motion detection.
|
|
* - ``V4L2_DETECT_MD_MODE_GLOBAL``
|
|
- Use a single motion detection threshold.
|
|
* - ``V4L2_DETECT_MD_MODE_THRESHOLD_GRID``
|
|
- The image is divided into a grid, each cell with its own motion
|
|
detection threshold. These thresholds are set through the
|
|
``V4L2_CID_DETECT_MD_THRESHOLD_GRID`` matrix control.
|
|
* - ``V4L2_DETECT_MD_MODE_REGION_GRID``
|
|
- The image is divided into a grid, each cell with its own region
|
|
value that specifies which per-region motion detection thresholds
|
|
should be used. Each region has its own thresholds. How these
|
|
per-region thresholds are set up is driver-specific. The region
|
|
values for the grid are set through the
|
|
``V4L2_CID_DETECT_MD_REGION_GRID`` matrix control.
|
|
|
|
|
|
|
|
``V4L2_CID_DETECT_MD_GLOBAL_THRESHOLD (integer)``
|
|
Sets the global motion detection threshold to be used with the
|
|
``V4L2_DETECT_MD_MODE_GLOBAL`` motion detection mode.
|
|
|
|
``V4L2_CID_DETECT_MD_THRESHOLD_GRID (__u16 matrix)``
|
|
Sets the motion detection thresholds for each cell in the grid. To
|
|
be used with the ``V4L2_DETECT_MD_MODE_THRESHOLD_GRID`` motion
|
|
detection mode. Matrix element (0, 0) represents the cell at the
|
|
top-left of the grid.
|
|
|
|
``V4L2_CID_DETECT_MD_REGION_GRID (__u8 matrix)``
|
|
Sets the motion detection region value for each cell in the grid. To
|
|
be used with the ``V4L2_DETECT_MD_MODE_REGION_GRID`` motion
|
|
detection mode. Matrix element (0, 0) represents the cell at the
|
|
top-left of the grid.
|