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