요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
3
.. _image-process-controls:
5
*******************************
6
Image Process Control Reference
7
*******************************
9
The Image Process control class is intended for low-level control of
10
image processing functions. Unlike ``V4L2_CID_IMAGE_SOURCE_CLASS``, the
11
controls in this class affect processing the image, and do not control
12
capturing of it.
15
.. _image-process-control-id:
17
Image Process Control IDs
18
=========================
20
``V4L2_CID_IMAGE_PROC_CLASS (class)``
21
The IMAGE_PROC class descriptor.
23
.. _v4l2-cid-link-freq:
25
``V4L2_CID_LINK_FREQ (integer menu)``
26
The frequency of the data bus (e.g. parallel or CSI-2).
28
.. _v4l2-cid-pixel-rate:
30
``V4L2_CID_PIXEL_RATE (64-bit integer)``
31
Pixel sampling rate in the device's pixel array. This control is
32
read-only and its unit is pixels / second.
34
Some devices use horizontal and vertical blanking to configure the frame
35
rate. The frame rate can be calculated from the pixel rate, analogue crop
36
rectangle as well as horizontal and vertical blanking. The pixel rate
37
control may be present in a different sub-device than the blanking controls
38
and the analogue crop rectangle configuration.
40
The configuration of the frame rate is performed by selecting the desired
41
horizontal and vertical blanking. The unit of this control is Hz.
43
``V4L2_CID_TEST_PATTERN (menu)``
44
Some capture/display/sensor devices have the capability to generate
45
test pattern images. These hardware specific test patterns can be
46
used to test if a device is working properly.
48
``V4L2_CID_DEINTERLACING_MODE (menu)``
49
The video deinterlacing mode (such as Bob, Weave, ...). The menu items are
50
driver specific and are documented in :ref:`uapi-v4l-drivers`.
52
``V4L2_CID_DIGITAL_GAIN (integer)``
53
Digital gain is the value by which all colour components
54
are multiplied by. Typically the digital gain applied is the
55
control value divided by e.g. 0x100, meaning that to get no
56
digital gain the control value needs to be 0x100. The no-gain
57
configuration is also typically the default.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
저수준 이미지 처리 클래스
1-19Image Process 제어 클래스는 저수준 이미지 처리 기능을 다룹니다. 이미지 획득 자체를 제어하는 `V4L2_CID_IMAGE_SOURCE_CLASS`와 달리, 이 클래스의 제어는 획득한 이미지에 적용되는 처리에 영향을 줍니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. _image-process-controls:
*******************************
Image Process Control Reference
*******************************
The Image Process control class is intended for low-level control of
image processing functions. Unlike ``V4L2_CID_IMAGE_SOURCE_CLASS``, the
controls in this class affect processing the image, and do not control
capturing of it.
.. _image-process-control-id:
Image Process Control IDs
=========================
Bus, pixel rate와 처리 기능
20-57`V4L2_CID_IMAGE_PROC_CLASS`는 IMAGE_PROC 클래스 설명자입니다. `V4L2_CID_LINK_FREQ`는 parallel bus나 CSI-2 같은 데이터 버스의 주파수를 integer menu로 제공합니다.
`V4L2_CID_PIXEL_RATE`는 장치 pixel array의 sampling rate를 나타내는 읽기 전용 64-bit 정수이며 단위는 pixels/second입니다. Frame rate는 pixel rate, analogue crop rectangle, horizontal blanking과 vertical blanking으로 계산할 수 있고, 이 설정들이 서로 다른 sub-device에 존재할 수도 있습니다. 원하는 H/V blanking을 선택해 frame rate를 구성하며 이 제어의 단위 표기는 Hz입니다.
항목설명
`V4L2_CID_LINK_FREQ`Parallel 또는 CSI-2 데이터 버스 주파수입니다.
`V4L2_CID_PIXEL_RATE`읽기 전용 pixel sampling rate이며 frame timing 계산에 사용합니다.
`V4L2_CID_TEST_PATTERN`장치 동작 검증용 hardware-specific test pattern을 선택합니다.
`V4L2_CID_DEINTERLACING_MODE`Bob, Weave 등 driver-specific deinterlacing 방식을 선택합니다.
`V4L2_CID_DIGITAL_GAIN`모든 색 성분에 곱하는 digital gain을 지정합니다.
센서 링크와 후처리 블록의 저수준 동작을 구성합니다.
Digital gain은 흔히 제어값을 0x100으로 나눈 배율로 적용합니다. 따라서 gain을 적용하지 않는 unity 값과 기본값은 일반적으로 0x100입니다. Test pattern과 deinterlacing menu 항목은 hardware 및 드라이버별이며 해당 V4L 드라이버 문서에 정의됩니다.
``V4L2_CID_IMAGE_PROC_CLASS (class)``
The IMAGE_PROC class descriptor.
.. _v4l2-cid-link-freq:
``V4L2_CID_LINK_FREQ (integer menu)``
The frequency of the data bus (e.g. parallel or CSI-2).
.. _v4l2-cid-pixel-rate:
``V4L2_CID_PIXEL_RATE (64-bit integer)``
Pixel sampling rate in the device's pixel array. This control is
read-only and its unit is pixels / second.
Some devices use horizontal and vertical blanking to configure the frame
rate. The frame rate can be calculated from the pixel rate, analogue crop
rectangle as well as horizontal and vertical blanking. The pixel rate
control may be present in a different sub-device than the blanking controls
and the analogue crop rectangle configuration.
The configuration of the frame rate is performed by selecting the desired
horizontal and vertical blanking. The unit of this control is Hz.
``V4L2_CID_TEST_PATTERN (menu)``
Some capture/display/sensor devices have the capability to generate
test pattern images. These hardware specific test patterns can be
used to test if a device is working properly.
``V4L2_CID_DEINTERLACING_MODE (menu)``
The video deinterlacing mode (such as Bob, Weave, ...). The menu items are
driver specific and are documented in :ref:`uapi-v4l-drivers`.
``V4L2_CID_DIGITAL_GAIN (integer)``
Digital gain is the value by which all colour components
are multiplied by. Typically the digital gain applied is the
control value divided by e.g. 0x100, meaning that to get no
digital gain the control value needs to be 0x100. The no-gain
configuration is also typically the default.
요약·해설
ext-ctrls-image-process.rst:1-57Image Process class는 획득 자체가 아니라 bus timing과 획득 후 이미지 처리 기능을 다루며 pixel rate와 blanking의 관계가 frame rate 계산의 핵심입니다.