1059b1c5bSMauro Carvalho Chehab.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later 254f38fcaSMauro Carvalho Chehab 354f38fcaSMauro Carvalho Chehab.. _image-process-controls: 454f38fcaSMauro Carvalho Chehab 554f38fcaSMauro Carvalho Chehab******************************* 654f38fcaSMauro Carvalho ChehabImage Process Control Reference 754f38fcaSMauro Carvalho Chehab******************************* 854f38fcaSMauro Carvalho Chehab 954f38fcaSMauro Carvalho ChehabThe Image Process control class is intended for low-level control of 1054f38fcaSMauro Carvalho Chehabimage processing functions. Unlike ``V4L2_CID_IMAGE_SOURCE_CLASS``, the 1154f38fcaSMauro Carvalho Chehabcontrols in this class affect processing the image, and do not control 1254f38fcaSMauro Carvalho Chehabcapturing of it. 1354f38fcaSMauro Carvalho Chehab 1454f38fcaSMauro Carvalho Chehab 1554f38fcaSMauro Carvalho Chehab.. _image-process-control-id: 1654f38fcaSMauro Carvalho Chehab 1754f38fcaSMauro Carvalho ChehabImage Process Control IDs 1854f38fcaSMauro Carvalho Chehab========================= 1954f38fcaSMauro Carvalho Chehab 2054f38fcaSMauro Carvalho Chehab``V4L2_CID_IMAGE_PROC_CLASS (class)`` 2154f38fcaSMauro Carvalho Chehab The IMAGE_PROC class descriptor. 2254f38fcaSMauro Carvalho Chehab 23b9a54336SSakari Ailus.. _v4l2-cid-link-freq: 24b9a54336SSakari Ailus 2554f38fcaSMauro Carvalho Chehab``V4L2_CID_LINK_FREQ (integer menu)`` 26*e5a466d4SSakari Ailus The frequency of the data bus (e.g. parallel or CSI-2). 2754f38fcaSMauro Carvalho Chehab 286f8f9fdeSSakari Ailus.. _v4l2-cid-pixel-rate: 296f8f9fdeSSakari Ailus 3054f38fcaSMauro Carvalho Chehab``V4L2_CID_PIXEL_RATE (64-bit integer)`` 318925b530SSakari Ailus Pixel sampling rate in the device's pixel array. This control is 3254f38fcaSMauro Carvalho Chehab read-only and its unit is pixels / second. 3354f38fcaSMauro Carvalho Chehab 34*e5a466d4SSakari Ailus Some devices use horizontal and vertical balanking to configure the frame 35*e5a466d4SSakari Ailus rate. The frame rate can be calculated from the pixel rate, analogue crop 36*e5a466d4SSakari Ailus rectangle as well as horizontal and vertical blanking. The pixel rate 37*e5a466d4SSakari Ailus control may be present in a different sub-device than the blanking controls 38*e5a466d4SSakari Ailus and the analogue crop rectangle configuration. 39*e5a466d4SSakari Ailus 40*e5a466d4SSakari Ailus The configuration of the frame rate is performed by selecting the desired 41*e5a466d4SSakari Ailus horizontal and vertical blanking. The unit of this control is Hz. 42*e5a466d4SSakari Ailus 4354f38fcaSMauro Carvalho Chehab``V4L2_CID_TEST_PATTERN (menu)`` 4454f38fcaSMauro Carvalho Chehab Some capture/display/sensor devices have the capability to generate 4554f38fcaSMauro Carvalho Chehab test pattern images. These hardware specific test patterns can be 4654f38fcaSMauro Carvalho Chehab used to test if a device is working properly. 4754f38fcaSMauro Carvalho Chehab 4854f38fcaSMauro Carvalho Chehab``V4L2_CID_DEINTERLACING_MODE (menu)`` 4954f38fcaSMauro Carvalho Chehab The video deinterlacing mode (such as Bob, Weave, ...). The menu items are 5032e2eae2SMauro Carvalho Chehab driver specific and are documented in :ref:`uapi-v4l-drivers`. 5154f38fcaSMauro Carvalho Chehab 5254f38fcaSMauro Carvalho Chehab``V4L2_CID_DIGITAL_GAIN (integer)`` 5354f38fcaSMauro Carvalho Chehab Digital gain is the value by which all colour components 5454f38fcaSMauro Carvalho Chehab are multiplied by. Typically the digital gain applied is the 5554f38fcaSMauro Carvalho Chehab control value divided by e.g. 0x100, meaning that to get no 5654f38fcaSMauro Carvalho Chehab digital gain the control value needs to be 0x100. The no-gain 5754f38fcaSMauro Carvalho Chehab configuration is also typically the default. 58