요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
3
.. _common:
5
###################
6
Common API Elements
7
###################
8
Programming a V4L2 device consists of these steps:
10
- Opening the device
12
- Changing device properties, selecting a video and audio input, video
13
standard, picture brightness a. o.
15
- Negotiating a data format
17
- Negotiating an input/output method
19
- The actual input/output loop
21
- Closing the device
23
In practice most steps are optional and can be executed out of order. It
24
depends on the V4L2 device type, you can read about the details in
25
:ref:`devices`. In this chapter we will discuss the basic concepts
26
applicable to all devices.
29
.. toctree::
30
:maxdepth: 1
32
open
33
querycap
34
app-pri
35
video
36
audio
37
tuner
38
standard
39
dv-timings
40
control
41
extended-controls
42
ext-ctrls-camera
43
ext-ctrls-flash
44
ext-ctrls-image-source
45
ext-ctrls-image-process
46
ext-ctrls-codec
47
ext-ctrls-codec-stateless
48
ext-ctrls-jpeg
49
ext-ctrls-dv
50
ext-ctrls-rf-tuner
51
ext-ctrls-fm-tx
52
ext-ctrls-fm-rx
53
ext-ctrls-detect
54
ext-ctrls-colorimetry
55
fourcc
56
format
57
planar-apis
58
selection-api
59
crop
60
streaming-par
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
V4L2 장치 프로그래밍 절차
1-26V4L2 장치 프로그래밍은 장치 열기, 속성과 입력·표준·밝기 변경, 데이터 형식 협상, I/O 방식 협상, 실제 I/O 루프, 장치 닫기의 여섯 단계로 설명할 수 있습니다.
실제로는 대부분 단계가 선택 사항이며 순서도 고정되지 않습니다. 필요한 절차는 V4L2 장치 유형에 따라 달라지고, `devices` 절에서 유형별 세부 동작을 설명합니다.
이 장은 특정 장치의 캡처·출력 동작보다 모든 V4L2 장치에 공통으로 적용되는 기본 개념과 ioctl 계약을 모읍니다.
장치 파일 열기→장치 속성·입력·표준·컨트롤 선택→데이터 형식 협상→입출력 메모리 방식 협상→실제 입력 또는 출력 루프→장치 파일 닫기
장치에 따라 일부 단계를 생략하거나 순서를 바꿀 수 있습니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. _common:
###################
Common API Elements
###################
Programming a V4L2 device consists of these steps:
- Opening the device
- Changing device properties, selecting a video and audio input, video
standard, picture brightness a. o.
- Negotiating a data format
- Negotiating an input/output method
- The actual input/output loop
- Closing the device
In practice most steps are optional and can be executed out of order. It
depends on the V4L2 device type, you can read about the details in
:ref:`devices`. In this chapter we will discuss the basic concepts
applicable to all devices.공통 API 문서 목차
27-60목차는 장치 접근과 capability 조회부터 우선순위, 입력·출력 선택, 컨트롤, 픽셀 형식, selection/crop, 스트리밍 파라미터까지 공통 API를 기능별로 연결합니다.
항목설명
openV4L2 장치 열기와 닫기
querycap장치 capability 조회
app-pri애플리케이션 우선순위
video비디오 입력과 출력
audio오디오 입력과 출력
tuner튜너와 모듈레이터
standard아날로그 비디오 표준
dv-timings디지털 비디오 타이밍
control기본 컨트롤 인터페이스
extended-controls확장 컨트롤 인터페이스
ext-ctrls-camera카메라 클래스 컨트롤
ext-ctrls-flash플래시 클래스 컨트롤
ext-ctrls-image-source이미지 소스 컨트롤
ext-ctrls-image-process이미지 처리 컨트롤
ext-ctrls-codec상태 저장 코덱 컨트롤
ext-ctrls-codec-stateless상태 비저장 코덱 컨트롤
ext-ctrls-jpegJPEG 컨트롤
ext-ctrls-dv디지털 비디오 컨트롤
ext-ctrls-rf-tunerRF 튜너 컨트롤
ext-ctrls-fm-txFM 송신 컨트롤
ext-ctrls-fm-rxFM 수신 컨트롤
ext-ctrls-detect신호 검출 컨트롤
ext-ctrls-colorimetry측색 관련 컨트롤
fourcc픽셀 형식 식별자 FourCC
format데이터 형식 협상
planar-apis단일·다중 평면 API
selection-apiselection API
crop레거시 crop API
streaming-par스트리밍 파라미터
각 toctree 항목이 다루는 주제입니다.
.. toctree::
:maxdepth: 1
open
querycap
app-pri
video
audio
tuner
standard
dv-timings
control
extended-controls
ext-ctrls-camera
ext-ctrls-flash
ext-ctrls-image-source
ext-ctrls-image-process
ext-ctrls-codec
ext-ctrls-codec-stateless
ext-ctrls-jpeg
ext-ctrls-dv
ext-ctrls-rf-tuner
ext-ctrls-fm-tx
ext-ctrls-fm-rx
ext-ctrls-detect
ext-ctrls-colorimetry
fourcc
format
planar-apis
selection-api
crop
streaming-par
요약·해설
common.rst:1-60장치 열기부터 형식과 I/O 협상, 실제 루프와 닫기까지의 공통 흐름과 각 세부 API 문서의 진입점입니다.