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

Linux 6.18.37 · Userspace API / Media / V4L

V4L2_PIX_FMT_CNF4

Intel RealSense depth confidence를 픽셀당 4비트로 packing하는 형식을 설명합니다.

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

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

1. 요약·해설

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

요약·해설

pixfmt-cnf4.rst:1-31

CNF4는 0~15 depth confidence 두 개를 한 바이트의 low/high nibble에 순서대로 저장합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 .. -*- coding: utf-8; mode: rst -*-
2
3 .. _V4L2-PIX-FMT-CNF4:
4
5 ******************************
6 V4L2_PIX_FMT_CNF4 ('CNF4')
7 ******************************
8
9 Depth sensor confidence information as a 4 bits per pixel packed array
10
11 Description
12 ===========
13
14 Proprietary format used by Intel RealSense Depth cameras containing depth
15 confidence information in range 0-15 with 0 indicating that the sensor was
16 unable to resolve any signal and 15 indicating maximum level of confidence for
17 the specific sensor (actual error margins might change from sensor to sensor).
18
19 Every two consecutive pixels are packed into a single byte.
20 Bits 0-3 of byte n refer to confidence value of depth pixel 2*n,
21 bits 4-7 to confidence value of depth pixel 2*n+1.
22
23 **Bit-packed representation.**
24
25 .. flat-table::
26 :header-rows: 0
27 :stub-columns: 0
28 :widths: 64 64
29
30 * - Y'\ :sub:`01[3:0]`\ (bits 7--4) Y'\ :sub:`00[3:0]`\ (bits 3--0)
31 - Y'\ :sub:`03[3:0]`\ (bits 7--4) Y'\ :sub:`02[3:0]`\ (bits 3--0)
32

3. 한국어 전문 번역

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

두 픽셀을 한 바이트에 packing

1-31

`V4L2_PIX_FMT_CNF4`는 Intel RealSense depth camera의 전용 confidence 형식입니다. 깊이 픽셀마다 0~15 값을 저장하며 0은 sensor가 신호를 해석하지 못했음을, 15는 해당 sensor 기준 최고 confidence를 뜻합니다. 실제 오차 범위는 sensor마다 다를 수 있습니다.

연속한 픽셀 두 개를 한 바이트에 넣습니다. byte n의 bits 0~3은 depth pixel `2*n`, bits 4~7은 depth pixel `2*n+1`의 confidence입니다.

CNF4 bit-packed 구조
항목설명
byte 0 bits 3:0pixel 0 confidence `Y'00[3:0]`
byte 0 bits 7:4pixel 1 confidence `Y'01[3:0]`
byte 1 bits 3:0pixel 2 confidence `Y'02[3:0]`
byte 1 bits 7:4pixel 3 confidence `Y'03[3:0]`

원문의 두 바이트 예제를 nibble 순서로 구조화했습니다.

.. -*- coding: utf-8; mode: rst -*-

.. _V4L2-PIX-FMT-CNF4:

******************************
V4L2_PIX_FMT_CNF4 ('CNF4')
******************************

Depth sensor confidence information as a 4 bits per pixel packed array

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

Proprietary format used by Intel RealSense Depth cameras containing depth
confidence information in range 0-15 with 0 indicating that the sensor was
unable to resolve any signal and 15 indicating maximum level of confidence for
the specific sensor (actual error margins might change from sensor to sensor).

Every two consecutive pixels are packed into a single byte.
Bits 0-3 of byte n refer to confidence value of depth pixel 2*n,
bits 4-7 to confidence value of depth pixel 2*n+1.

**Bit-packed representation.**

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

    * - Y'\ :sub:`01[3:0]`\ (bits 7--4) Y'\ :sub:`00[3:0]`\ (bits 3--0)
      - Y'\ :sub:`03[3:0]`\ (bits 7--4) Y'\ :sub:`02[3:0]`\ (bits 3--0)