요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
3
.. _v4l2-selection-targets:
5
*****************
6
Selection targets
7
*****************
9
The precise meaning of the selection targets may be dependent on which
10
of the two interfaces they are used.
13
.. _v4l2-selection-targets-table:
15
.. raw:: latex
17
\small
19
.. tabularcolumns:: |p{6.2cm}|p{1.4cm}|p{7.3cm}|p{1.2cm}|p{0.8cm}|
21
.. cssclass:: longtable
23
.. flat-table:: Selection target definitions
24
:header-rows: 1
25
:stub-columns: 0
27
* - Target name
28
- id
29
- Definition
30
- Valid for V4L2
31
- Valid for V4L2 subdev
32
* - ``V4L2_SEL_TGT_CROP``
33
- 0x0000
34
- Crop rectangle. Defines the cropped area.
35
- Yes
36
- Yes
37
* - ``V4L2_SEL_TGT_CROP_DEFAULT``
38
- 0x0001
39
- Suggested cropping rectangle that covers the "whole picture".
40
This includes only active pixels and excludes other non-active
41
pixels such as black pixels.
42
- Yes
43
- Yes
44
* - ``V4L2_SEL_TGT_CROP_BOUNDS``
45
- 0x0002
46
- Bounds of the crop rectangle. All valid crop rectangles fit inside
47
the crop bounds rectangle.
48
- Yes
49
- Yes
50
* - ``V4L2_SEL_TGT_NATIVE_SIZE``
51
- 0x0003
52
- The native size of the device, e.g. a sensor's pixel array.
53
``left`` and ``top`` fields are zero for this target.
54
- Yes
55
- Yes
56
* - ``V4L2_SEL_TGT_COMPOSE``
57
- 0x0100
58
- Compose rectangle. Used to configure scaling and composition.
59
- Yes
60
- Yes
61
* - ``V4L2_SEL_TGT_COMPOSE_DEFAULT``
62
- 0x0101
63
- Suggested composition rectangle that covers the "whole picture".
64
- Yes
65
- No
66
* - ``V4L2_SEL_TGT_COMPOSE_BOUNDS``
67
- 0x0102
68
- Bounds of the compose rectangle. All valid compose rectangles fit
69
inside the compose bounds rectangle.
70
- Yes
71
- Yes
72
* - ``V4L2_SEL_TGT_COMPOSE_PADDED``
73
- 0x0103
74
- The active area and all padding pixels that are inserted or
75
modified by hardware.
76
- Yes
77
- No
79
.. raw:: latex
81
\normalsize
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
자르기·합성 사각형 대상
1-81선택 대상의 세부 의미는 일반 V4L2 선택 인터페이스와 V4L2 서브디바이스 선택 인터페이스 중 어디에서 사용하는지에 따라 달라질 수 있습니다.
대상id정의V4L2서브디바이스
V4L2_SEL_TGT_CROP0x0000실제 자르기 영역예예
V4L2_SEL_TGT_CROP_DEFAULT0x0001비활성 검정 픽셀을 제외한 전체 활성 화면의 권장 자르기 영역예예
V4L2_SEL_TGT_CROP_BOUNDS0x0002모든 유효 CROP 사각형이 들어가는 경계예예
V4L2_SEL_TGT_NATIVE_SIZE0x0003센서 픽셀 배열 같은 장치 고유 크기이며 left와 top은 0예예
V4L2_SEL_TGT_COMPOSE0x0100배율 조정과 합성에 사용하는 실제 합성 영역예예
V4L2_SEL_TGT_COMPOSE_DEFAULT0x0101전체 화면을 덮는 권장 합성 영역예아니요
V4L2_SEL_TGT_COMPOSE_BOUNDS0x0102모든 유효 COMPOSE 사각형이 들어가는 경계예예
V4L2_SEL_TGT_COMPOSE_PADDED0x0103활성 영역과 하드웨어가 삽입하거나 수정하는 모든 패딩 픽셀예아니요
원문 id와 두 인터페이스의 적용 가능 여부를 정리합니다.
DEFAULT는 권장 전체 화면, BOUNDS는 유효 사각형의 외곽 한계, PADDED는 활성 합성 영역 밖에서 하드웨어가 건드릴 수 있는 픽셀까지 포함한다는 차이가 있습니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. _v4l2-selection-targets:
*****************
Selection targets
*****************
The precise meaning of the selection targets may be dependent on which
of the two interfaces they are used.
.. _v4l2-selection-targets-table:
.. raw:: latex
\small
.. tabularcolumns:: |p{6.2cm}|p{1.4cm}|p{7.3cm}|p{1.2cm}|p{0.8cm}|
.. cssclass:: longtable
.. flat-table:: Selection target definitions
:header-rows: 1
:stub-columns: 0
* - Target name
- id
- Definition
- Valid for V4L2
- Valid for V4L2 subdev
* - ``V4L2_SEL_TGT_CROP``
- 0x0000
- Crop rectangle. Defines the cropped area.
- Yes
- Yes
* - ``V4L2_SEL_TGT_CROP_DEFAULT``
- 0x0001
- Suggested cropping rectangle that covers the "whole picture".
This includes only active pixels and excludes other non-active
pixels such as black pixels.
- Yes
- Yes
* - ``V4L2_SEL_TGT_CROP_BOUNDS``
- 0x0002
- Bounds of the crop rectangle. All valid crop rectangles fit inside
the crop bounds rectangle.
- Yes
- Yes
* - ``V4L2_SEL_TGT_NATIVE_SIZE``
- 0x0003
- The native size of the device, e.g. a sensor's pixel array.
``left`` and ``top`` fields are zero for this target.
- Yes
- Yes
* - ``V4L2_SEL_TGT_COMPOSE``
- 0x0100
- Compose rectangle. Used to configure scaling and composition.
- Yes
- Yes
* - ``V4L2_SEL_TGT_COMPOSE_DEFAULT``
- 0x0101
- Suggested composition rectangle that covers the "whole picture".
- Yes
- No
* - ``V4L2_SEL_TGT_COMPOSE_BOUNDS``
- 0x0102
- Bounds of the compose rectangle. All valid compose rectangles fit
inside the compose bounds rectangle.
- Yes
- Yes
* - ``V4L2_SEL_TGT_COMPOSE_PADDED``
- 0x0103
- The active area and all padding pixels that are inserted or
modified by hardware.
- Yes
- No
.. raw:: latex
\normalsize
요약·해설
v4l2-selection-targets.rst:1-81자르기·합성 사각형 대상과 일반·서브디바이스 적용 범위를 정의합니다.