1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
3.. _detect-controls:
4
5************************
6Detect Control Reference
7************************
8
9The Detect class includes controls for common features of various motion
10or object detection capable devices.
11
12
13.. _detect-control-id:
14
15Detect Control IDs
16==================
17
18``V4L2_CID_DETECT_CLASS (class)``
19    The Detect class descriptor. Calling
20    :ref:`VIDIOC_QUERYCTRL` for this control will
21    return a description of this control class.
22
23``V4L2_CID_DETECT_MD_MODE (menu)``
24    Sets the motion detection mode.
25
26.. tabularcolumns:: |p{7.7cm}|p{9.8cm}|
27
28.. flat-table::
29    :header-rows:  0
30    :stub-columns: 0
31
32    * - ``V4L2_DETECT_MD_MODE_DISABLED``
33      - Disable motion detection.
34    * - ``V4L2_DETECT_MD_MODE_GLOBAL``
35      - Use a single motion detection threshold.
36    * - ``V4L2_DETECT_MD_MODE_THRESHOLD_GRID``
37      - The image is divided into a grid, each cell with its own motion
38	detection threshold. These thresholds are set through the
39	``V4L2_CID_DETECT_MD_THRESHOLD_GRID`` matrix control.
40    * - ``V4L2_DETECT_MD_MODE_REGION_GRID``
41      - The image is divided into a grid, each cell with its own region
42	value that specifies which per-region motion detection thresholds
43	should be used. Each region has its own thresholds. How these
44	per-region thresholds are set up is driver-specific. The region
45	values for the grid are set through the
46	``V4L2_CID_DETECT_MD_REGION_GRID`` matrix control.
47
48
49
50``V4L2_CID_DETECT_MD_GLOBAL_THRESHOLD (integer)``
51    Sets the global motion detection threshold to be used with the
52    ``V4L2_DETECT_MD_MODE_GLOBAL`` motion detection mode.
53
54``V4L2_CID_DETECT_MD_THRESHOLD_GRID (__u16 matrix)``
55    Sets the motion detection thresholds for each cell in the grid. To
56    be used with the ``V4L2_DETECT_MD_MODE_THRESHOLD_GRID`` motion
57    detection mode. Matrix element (0, 0) represents the cell at the
58    top-left of the grid.
59
60``V4L2_CID_DETECT_MD_REGION_GRID (__u8 matrix)``
61    Sets the motion detection region value for each cell in the grid. To
62    be used with the ``V4L2_DETECT_MD_MODE_REGION_GRID`` motion
63    detection mode. Matrix element (0, 0) represents the cell at the
64    top-left of the grid.
65