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

Linux 6.18.37 · Userspace API / Media / V4L

V4L2_PIX_FMT_INZI

Intel SR300의 Y10 infrared plane과 Z16 depth plane 연속 배치를 설명합니다.

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

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

1. 요약·해설

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

요약·해설

pixfmt-inzi.rst:1-82

INZI는 같은 크기의 Y10 infrared와 Z16 depth plane을 차례로 저장하며 각 sample은 16-bit little-endian cell입니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
3 .. _V4L2-PIX-FMT-INZI:
4
5 **************************
6 V4L2_PIX_FMT_INZI ('INZI')
7 **************************
8
9 Infrared 10-bit linked with Depth 16-bit images
10
11
12 Description
13 ===========
14
15 Proprietary multi-planar format used by Intel SR300 Depth cameras, comprise of
16 Infrared image followed by Depth data. The pixel definition is 32-bpp,
17 with the Depth and Infrared Data split into separate continuous planes of
18 identical dimensions.
19
20
21
22 The first plane - Infrared data - is stored according to
23 :ref:`V4L2_PIX_FMT_Y10 <V4L2-PIX-FMT-Y10>` greyscale format.
24 Each pixel is 16-bit cell, with actual data stored in the 10 LSBs
25 with values in range 0 to 1023.
26 The six remaining MSBs are padded with zeros.
27
28
29 The second plane provides 16-bit per-pixel Depth data arranged in
30 :ref:`V4L2-PIX-FMT-Z16 <V4L2-PIX-FMT-Z16>` format.
31
32
33 **Frame Structure.**
34 Each cell is a 16-bit word with more significant data stored at higher
35 memory address (byte order is little-endian).
36
37
38 .. raw:: latex
39
40 \small
41
42 .. tabularcolumns:: |p{2.5cm}|p{2.5cm}|p{2.5cm}|p{2.5cm}|p{2.5cm}|p{2.5cm}|
43
44 .. flat-table::
45 :header-rows: 0
46 :stub-columns: 1
47 :widths: 1 1 1 1 1 1
48
49 * - Ir\ :sub:`0,0`
50 - Ir\ :sub:`0,1`
51 - Ir\ :sub:`0,2`
52 - ...
53 - ...
54 - ...
55 * - :cspan:`5` ...
56 * - :cspan:`5` Infrared Data
57 * - :cspan:`5` ...
58 * - ...
59 - ...
60 - ...
61 - Ir\ :sub:`n-1,n-3`
62 - Ir\ :sub:`n-1,n-2`
63 - Ir\ :sub:`n-1,n-1`
64 * - Depth\ :sub:`0,0`
65 - Depth\ :sub:`0,1`
66 - Depth\ :sub:`0,2`
67 - ...
68 - ...
69 - ...
70 * - :cspan:`5` ...
71 * - :cspan:`5` Depth Data
72 * - :cspan:`5` ...
73 * - ...
74 - ...
75 - ...
76 - Depth\ :sub:`n-1,n-3`
77 - Depth\ :sub:`n-1,n-2`
78 - Depth\ :sub:`n-1,n-1`
79
80 .. raw:: latex
81
82 \normalsize
83

3. 한국어 전문 번역

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

10-bit infrared와 16-bit depth plane

1-35

`V4L2_PIX_FMT_INZI`는 Intel SR300 depth camera가 사용하는 proprietary multi-planar 형식입니다. 같은 크기의 연속 plane 두 개에 Infrared image를 먼저, Depth data를 이어서 두며 pixel 정의는 합계 32-bpp입니다.

첫 plane의 infrared data는 `V4L2_PIX_FMT_Y10` greyscale 형식입니다. Pixel마다 16-bit cell을 쓰지만 실제 값 0~1023는 하위 10 bit에 저장하고 남은 상위 6 bit는 0으로 padding합니다.

둘째 plane은 pixel마다 16-bit인 `V4L2_PIX_FMT_Z16` depth data입니다. 모든 cell은 16-bit word이며 더 중요한 byte가 더 높은 memory address에 놓이는 little-endian 순서를 사용합니다.

INZI plane 규약
항목설명
Plane 0Infrared, Y10, 16-bit cell의 LSB 10 bit 사용, MSB 6 bit는 0
Plane 1Depth, Z16, pixel당 16 bit
Byte order16-bit little-endian
총 pixel 정의두 plane을 합쳐 32-bpp

두 plane은 width와 height가 동일합니다.

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

.. _V4L2-PIX-FMT-INZI:

**************************
V4L2_PIX_FMT_INZI ('INZI')
**************************

Infrared 10-bit linked with Depth 16-bit images


Description
===========

Proprietary multi-planar format used by Intel SR300 Depth cameras, comprise of
Infrared image followed by Depth data. The pixel definition is 32-bpp,
with the Depth and Infrared Data split into separate continuous planes of
identical dimensions.



The first plane - Infrared data - is stored according to
:ref:`V4L2_PIX_FMT_Y10 <V4L2-PIX-FMT-Y10>` greyscale format.
Each pixel is 16-bit cell, with actual data stored in the 10 LSBs
with values in range 0 to 1023.
The six remaining MSBs are padded with zeros.


The second plane provides 16-bit per-pixel Depth data arranged in
:ref:`V4L2-PIX-FMT-Z16 <V4L2-PIX-FMT-Z16>` format.


**Frame Structure.**
Each cell is a 16-bit word with more significant data stored at higher
memory address (byte order is little-endian).

Frame 연속 배치

36-82

Frame memory는 Infrared plane 전체가 끝난 뒤 Depth plane 전체가 시작됩니다. 각 plane 안에서는 `(row, column)` 순서로 왼쪽에서 오른쪽, 위에서 아래로 진행하며 두 plane의 좌표는 서로 대응합니다.

INZI frame 구조
Infrared plane 시작: `Ir[0,0]`, `Ir[0,1]`, `Ir[0,2]`, ...Infrared의 모든 행을 `Ir[n-1,n-1]`까지 저장Depth plane 시작: `Depth[0,0]`, `Depth[0,1]`, `Depth[0,2]`, ...Depth의 모든 행을 `Depth[n-1,n-1]`까지 저장

원문의 큰 표를 같은 의미의 구조화 도식으로 다시 그렸습니다.

동일 좌표 대응
항목설명
`Ir[y,x]`좌표 `(x,y)`의 10-bit infrared sample
`Depth[y,x]`같은 좌표 `(x,y)`의 16-bit depth sample
plane 경계마지막 infrared sample 다음에 첫 depth sample

두 plane은 동일한 image dimensions를 사용합니다.



.. raw:: latex

    \small

.. tabularcolumns:: |p{2.5cm}|p{2.5cm}|p{2.5cm}|p{2.5cm}|p{2.5cm}|p{2.5cm}|

.. flat-table::
    :header-rows:  0
    :stub-columns: 1
    :widths:    1 1 1 1 1 1

    * - Ir\ :sub:`0,0`
      - Ir\ :sub:`0,1`
      - Ir\ :sub:`0,2`
      - ...
      - ...
      - ...
    * - :cspan:`5` ...
    * - :cspan:`5` Infrared Data
    * - :cspan:`5` ...
    * - ...
      - ...
      - ...
      - Ir\ :sub:`n-1,n-3`
      - Ir\ :sub:`n-1,n-2`
      - Ir\ :sub:`n-1,n-1`
    * - Depth\ :sub:`0,0`
      - Depth\ :sub:`0,1`
      - Depth\ :sub:`0,2`
      - ...
      - ...
      - ...
    * - :cspan:`5` ...
    * - :cspan:`5` Depth Data
    * - :cspan:`5` ...
    * - ...
      - ...
      - ...
      - Depth\ :sub:`n-1,n-3`
      - Depth\ :sub:`n-1,n-2`
      - Depth\ :sub:`n-1,n-1`

.. raw:: latex

    \normalsize