요약·해설과 원문, 전문 번역을 서로 분리했습니다. 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-flags:
5
***************
6
Selection flags
7
***************
9
.. _v4l2-selection-flags-table:
11
.. raw:: latex
13
\small
15
.. tabularcolumns:: |p{5.6cm}|p{2.0cm}|p{6.5cm}|p{1.2cm}|p{1.2cm}|
17
.. cssclass:: longtable
19
.. flat-table:: Selection flag definitions
20
:header-rows: 1
21
:stub-columns: 0
23
* - Flag name
24
- id
25
- Definition
26
- Valid for V4L2
27
- Valid for V4L2 subdev
28
* - ``V4L2_SEL_FLAG_GE``
29
- (1 << 0)
30
- Suggest the driver it should choose greater or equal rectangle (in
31
size) than was requested. Albeit the driver may choose a lesser
32
size, it will only do so due to hardware limitations. Without this
33
flag (and ``V4L2_SEL_FLAG_LE``) the behaviour is to choose the
34
closest possible rectangle.
35
- Yes
36
- Yes
37
* - ``V4L2_SEL_FLAG_LE``
38
- (1 << 1)
39
- Suggest the driver it should choose lesser or equal rectangle (in
40
size) than was requested. Albeit the driver may choose a greater
41
size, it will only do so due to hardware limitations.
42
- Yes
43
- Yes
44
* - ``V4L2_SEL_FLAG_KEEP_CONFIG``
45
- (1 << 2)
46
- The configuration must not be propagated to any further processing
47
steps. If this flag is not given, the configuration is propagated
48
inside the subdevice to all further processing steps.
49
- No
50
- Yes
52
.. raw:: latex
54
\normalsize
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
사각형 조정 및 전파 제약
1-54선택 플래그는 요청한 사각형을 하드웨어가 정확히 지원하지 못할 때 크기를 어느 방향으로 조정할지, 그리고 서브디바이스 내부의 후속 처리 단계로 설정을 전파할지를 지정합니다.
플래그id정의V4L2서브디바이스
V4L2_SEL_FLAG_GE1 << 0요청보다 크거나 같은 사각형을 권고합니다. 하드웨어 한계가 있을 때만 더 작게 선택할 수 있습니다.예예
V4L2_SEL_FLAG_LE1 << 1요청보다 작거나 같은 사각형을 권고합니다. 하드웨어 한계가 있을 때만 더 크게 선택할 수 있습니다.예예
V4L2_SEL_FLAG_KEEP_CONFIG1 << 2설정을 후속 처리 단계로 전파하지 않습니다. 플래그가 없으면 서브디바이스 내부의 이후 단계에 전파됩니다.아니요예
원문 id와 V4L2·서브디바이스 적용 범위를 보존합니다.
GE와 LE를 모두 지정하지 않으면 드라이버는 요청에 가장 가까운 사각형을 선택합니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. _v4l2-selection-flags:
***************
Selection flags
***************
.. _v4l2-selection-flags-table:
.. raw:: latex
\small
.. tabularcolumns:: |p{5.6cm}|p{2.0cm}|p{6.5cm}|p{1.2cm}|p{1.2cm}|
.. cssclass:: longtable
.. flat-table:: Selection flag definitions
:header-rows: 1
:stub-columns: 0
* - Flag name
- id
- Definition
- Valid for V4L2
- Valid for V4L2 subdev
* - ``V4L2_SEL_FLAG_GE``
- (1 << 0)
- Suggest the driver it should choose greater or equal rectangle (in
size) than was requested. Albeit the driver may choose a lesser
size, it will only do so due to hardware limitations. Without this
flag (and ``V4L2_SEL_FLAG_LE``) the behaviour is to choose the
closest possible rectangle.
- Yes
- Yes
* - ``V4L2_SEL_FLAG_LE``
- (1 << 1)
- Suggest the driver it should choose lesser or equal rectangle (in
size) than was requested. Albeit the driver may choose a greater
size, it will only do so due to hardware limitations.
- Yes
- Yes
* - ``V4L2_SEL_FLAG_KEEP_CONFIG``
- (1 << 2)
- The configuration must not be propagated to any further processing
steps. If this flag is not given, the configuration is propagated
inside the subdevice to all further processing steps.
- No
- Yes
.. raw:: latex
\normalsize
요약·해설
v4l2-selection-flags.rst:1-54선택 사각형의 크기 조정 방향과 설정 전파 플래그를 정의합니다.