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

Linux 6.18.37 · Userspace API / Media / V4L

V4L2 이미지 포맷

단일·다중 평면 이미지 구조체와 포맷 문서 구성을 안내합니다.

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

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

1. 요약·해설

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

요약·해설

pixfmt.rst:1-38

단일·다중 평면 이미지 구조체와 포맷 문서 구성을 안내합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
3 .. _pixfmt:
4
5 #############
6 Image Formats
7 #############
8 The V4L2 API was primarily designed for devices exchanging image data
9 with applications. The struct :c:type:`v4l2_pix_format` and
10 struct :c:type:`v4l2_pix_format_mplane` structures define the
11 format and layout of an image in memory. The former is used with the
12 single-planar API, while the latter is used with the multi-planar
13 version (see :ref:`planar-apis`). Image formats are negotiated with
14 the :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl. (The explanations here
15 focus on video capturing and output, for overlay frame buffer formats
16 see also :ref:`VIDIOC_G_FBUF <VIDIOC_G_FBUF>`.)
17
18
19 .. toctree::
20 :maxdepth: 1
21
22 pixfmt-v4l2
23 pixfmt-v4l2-mplane
24 pixfmt-intro
25 pixfmt-indexed
26 pixfmt-rgb
27 pixfmt-bayer
28 yuv-formats
29 hsv-formats
30 depth-formats
31 pixfmt-compressed
32 sdr-formats
33 tch-formats
34 meta-formats
35 pixfmt-reserved
36 colorspaces
37 colorspaces-defs
38 colorspaces-details
39

3. 한국어 전문 번역

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

V4L2 이미지 포맷과 하위 문서

1-38

V4L2 API는 주로 장치와 애플리케이션이 영상 데이터를 교환하도록 설계되었습니다. `v4l2_pix_format`은 단일 평면 API에서, `v4l2_pix_format_mplane`은 다중 평면 API에서 메모리 속 영상의 포맷과 배치를 정의합니다.

이미지 포맷은 `VIDIOC_S_FMT` ioctl로 협상합니다. 여기서는 비디오 캡처와 출력에 초점을 두며, 오버레이 프레임버퍼 포맷은 `VIDIOC_G_FBUF`도 참조해야 합니다.

이미지 포맷 문서 구성
하위 문서내용
pixfmt-v4l2단일 평면 포맷 구조체
pixfmt-v4l2-mplane다중 평면 포맷 구조체
pixfmt-intro픽셀 포맷 소개
pixfmt-indexed색인형 포맷
pixfmt-rgbRGB 포맷
pixfmt-bayerBayer 포맷
yuv-formatsYUV 포맷
hsv-formatsHSV 포맷
depth-formats깊이 포맷
pixfmt-compressed압축 포맷
sdr-formatsSDR 포맷
tch-formats터치 포맷
meta-formats메타데이터 포맷
pixfmt-reserved예약 포맷
colorspaces색공간
colorspaces-defs색공간 정의
colorspaces-details색공간 상세

원문 toctree의 하위 주제를 같은 순서로 정리합니다.

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

.. _pixfmt:

#############
Image Formats
#############
The V4L2 API was primarily designed for devices exchanging image data
with applications. The struct :c:type:`v4l2_pix_format` and
struct :c:type:`v4l2_pix_format_mplane` structures define the
format and layout of an image in memory. The former is used with the
single-planar API, while the latter is used with the multi-planar
version (see :ref:`planar-apis`). Image formats are negotiated with
the :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl. (The explanations here
focus on video capturing and output, for overlay frame buffer formats
see also :ref:`VIDIOC_G_FBUF <VIDIOC_G_FBUF>`.)


.. toctree::
    :maxdepth: 1

    pixfmt-v4l2
    pixfmt-v4l2-mplane
    pixfmt-intro
    pixfmt-indexed
    pixfmt-rgb
    pixfmt-bayer
    yuv-formats
    hsv-formats
    depth-formats
    pixfmt-compressed
    sdr-formats
    tch-formats
    meta-formats
    pixfmt-reserved
    colorspaces
    colorspaces-defs
    colorspaces-details