← Documents Documentation/userspace-api/media/v4l/selections-common.rst GitHub 원문 ↗

Linux 6.18.37 · Userspace API / Media / V4L

V4L2 선택 공통 정의

일반 V4L2와 서브디바이스 선택 API가 공유하는 대상과 플래그를 안내합니다.

Source pathDocumentation/userspace-api/media/v4l/selections-common.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약·해설

selections-common.rst:1-23

일반 V4L2와 서브디바이스 선택 API가 공유하는 대상과 플래그를 안내합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
3 .. _v4l2-selections-common:
4
5 Common selection definitions
6 ============================
7
8 While the :ref:`V4L2 selection API <selection-api>` and
9 :ref:`V4L2 subdev selection APIs <v4l2-subdev-selections>` are very
10 similar, there's one fundamental difference between the two. On
11 sub-device API, the selection rectangle refers to the media bus format,
12 and is bound to a sub-device's pad. On the V4L2 interface the selection
13 rectangles refer to the in-memory pixel format.
14
15 This section defines the common definitions of the selection interfaces
16 on the two APIs.
17
18
19 .. toctree::
20 :maxdepth: 1
21
22 v4l2-selection-targets
23 v4l2-selection-flags
24

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

V4L2와 서브디바이스 선택의 공통점과 차이

1-23

V4L2 선택 API와 서브디바이스 선택 API는 매우 비슷하지만 사각형이 참조하는 데이터 계층이 다릅니다. 서브디바이스 선택 사각형은 미디어 버스 형식을 기준으로 하며 특정 서브디바이스 패드에 결합됩니다. 일반 V4L 인터페이스의 사각형은 메모리 안의 픽셀 형식을 기준으로 합니다.

두 API가 공유하는 선택 대상과 제약 플래그 정의는 각각 `v4l2-selection-targets`와 `v4l2-selection-flags` 문서에서 설명합니다.

공통 선택 정의
문서정의
v4l2-selection-targetsCROP, COMPOSE, BOUNDS, DEFAULT, PADDED 대상 상수
v4l2-selection-flags사각형 조정 방향과 제약 조건 플래그

두 인터페이스가 함께 사용하는 하위 정의입니다.

.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later

.. _v4l2-selections-common:

Common selection definitions
============================

While the :ref:`V4L2 selection API <selection-api>` and
:ref:`V4L2 subdev selection APIs <v4l2-subdev-selections>` are very
similar, there's one fundamental difference between the two. On
sub-device API, the selection rectangle refers to the media bus format,
and is bound to a sub-device's pad. On the V4L2 interface the selection
rectangles refer to the in-memory pixel format.

This section defines the common definitions of the selection interfaces
on the two APIs.


.. toctree::
    :maxdepth: 1

    v4l2-selection-targets
    v4l2-selection-flags