65 lines · plain
1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later2 3.. _detect-controls:4 5************************6Detect Control Reference7************************8 9The Detect class includes controls for common features of various motion10or object detection capable devices.11 12 13.. _detect-control-id:14 15Detect Control IDs16==================17 18``V4L2_CID_DETECT_CLASS (class)``19 The Detect class descriptor. Calling20 :ref:`VIDIOC_QUERYCTRL` for this control will21 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: 030 :stub-columns: 031 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 motion38 detection threshold. These thresholds are set through the39 ``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 region42 value that specifies which per-region motion detection thresholds43 should be used. Each region has its own thresholds. How these44 per-region thresholds are set up is driver-specific. The region45 values for the grid are set through the46 ``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 the52 ``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. To56 be used with the ``V4L2_DETECT_MD_MODE_THRESHOLD_GRID`` motion57 detection mode. Matrix element (0, 0) represents the cell at the58 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. To62 be used with the ``V4L2_DETECT_MD_MODE_REGION_GRID`` motion63 detection mode. Matrix element (0, 0) represents the cell at the64 top-left of the grid.65