← Documents Documentation/userspace-api/media/v4l/selection-api-intro.rst GitHub 원문 ↗

Linux 6.18.37 · Userspace API / Media / V4L

V4L2 선택 API 소개

자르기, 배율 조정, 합성의 개념과 캡처 및 출력 방향의 차이를 설명합니다.

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

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

1. 요약·해설

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

요약·해설

selection-api-intro.rst:1-28

자르기, 배율 조정, 합성의 개념과 캡처 및 출력 방향의 차이를 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
3 ************
4 Introduction
5 ************
6
7 Some video capture devices can sample a subsection of a picture and
8 shrink or enlarge it to an image of arbitrary size. Next, the devices
9 can insert the image into larger one. Some video output devices can crop
10 part of an input image, scale it up or down and insert it at an
11 arbitrary scan line and horizontal offset into a video signal. We call
12 these abilities cropping, scaling and composing.
13
14 On a video *capture* device the source is a video signal, and the
15 cropping target determine the area actually sampled. The sink is an
16 image stored in a memory buffer. The composing area specifies which part
17 of the buffer is actually written to by the hardware.
18
19 On a video *output* device the source is an image in a memory buffer,
20 and the cropping target is a part of an image to be shown on a display.
21 The sink is the display or the graphics screen. The application may
22 select the part of display where the image should be displayed. The size
23 and position of such a window is controlled by the compose target.
24
25 Rectangles for all cropping and composing targets are defined even if
26 the device does supports neither cropping nor composing. Their size and
27 position will be fixed in such a case. If the device does not support
28 scaling then the cropping and composing rectangles have the same size.
29

3. 한국어 전문 번역

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

자르기, 배율 조정, 합성

1-28

일부 캡처 장치는 입력 신호의 일부만 샘플링하고 크기를 바꾼 뒤 더 큰 메모리 이미지의 특정 위치에 넣을 수 있습니다. 출력 장치는 반대로 메모리 이미지의 일부를 잘라 크기를 바꾸고 출력 주사선이나 화면 오프셋에 맞춰 배치할 수 있습니다. 이 세 단계를 각각 자르기, 배율 조정, 합성이라고 합니다.

캡처와 출력의 좌표 의미
방향CROPCOMPOSE
캡처입력 비디오 신호에서 실제 샘플링할 영역메모리 버퍼에서 결과를 기록할 영역
출력메모리 이미지에서 표시할 영역출력 비디오 신호나 화면에서 표시할 창

같은 CROP과 COMPOSE 대상이 데이터 흐름 방향에 따라 서로 다른 매체를 가리킵니다.

장치가 자르기나 합성을 지원하지 않더라도 모든 사각형은 정의되어 있으며 이 경우 값이 고정됩니다. 배율 조정을 지원하지 않으면 CROP과 COMPOSE의 크기가 같습니다.

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

************
Introduction
************

Some video capture devices can sample a subsection of a picture and
shrink or enlarge it to an image of arbitrary size. Next, the devices
can insert the image into larger one. Some video output devices can crop
part of an input image, scale it up or down and insert it at an
arbitrary scan line and horizontal offset into a video signal. We call
these abilities cropping, scaling and composing.

On a video *capture* device the source is a video signal, and the
cropping target determine the area actually sampled. The sink is an
image stored in a memory buffer. The composing area specifies which part
of the buffer is actually written to by the hardware.

On a video *output* device the source is an image in a memory buffer,
and the cropping target is a part of an image to be shown on a display.
The sink is the display or the graphics screen. The application may
select the part of display where the image should be displayed. The size
and position of such a window is controlled by the compose target.

Rectangles for all cropping and composing targets are defined even if
the device does supports neither cropping nor composing. Their size and
position will be fixed in such a case. If the device does not support
scaling then the cropping and composing rectangles have the same size.