| Message ID | 20201116185207.13208-22-laurent.pinchart@ideasonboard.com (mailing list archive) |
|---|---|
| State | New, archived |
| Headers | show |
| Series | media: Add new pixel formats for Xilinx v-frmbuf | expand |
Hi Laurent, On 2020-11-16 19:52, Laurent Pinchart wrote: > Add semi-planar YUV formats with 10, 12 and 16 bits per components, in > both 4:2:0 (NV12) and 4:2:2 (NV16) subsampling, and with both chroma > orderings. They are used by the Xilinx Video Frame Buffer Read/Write IP > cores. > > Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com> > --- > Changes since v2: > > - Replace 'Cr, Cr' with 'Cr, Cb' > --- > .../media/v4l/pixfmt-yuv-planar.rst | 574 +++++++++++++++++- > include/uapi/linux/videodev2.h | 12 + > 2 files changed, 580 insertions(+), 6 deletions(-) > > diff --git a/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst b/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst > index 7d4d39201a3f..4ac4c6a0290b 100644 > --- a/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst > +++ b/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst > @@ -48,6 +48,11 @@ relationship between the luma and chroma line padding and stride. > > All components are stored with the same number of bits per component. > > +Formats with more than 8 bits per component pack, within each plane, multiple > +samples in a word (padded as necessary to reach a multiple of 8 bits), which is > +then stored in memory in little endian byte order. They are named with a suffix > +indicating the number of bits per component and the number of samples per word. The use of "word" here is a little bit of confusing, the NV12 format as defined by Microsoft at [1] is using unsigned char (uint8_t) and unsigned WORD (uint16_t) to describe component/sample size. Also, the use of NV12 in a format name that is not 8-bit is a bit confusing, the 12 indicate the number of bits required for a single pixel, for the 10-bit format NV12_10_3 16-bits is required for a single pixel at optimal resolution. NV12 (4x2 pixels): 8 y * 8 bits + 2 uv * 16 bits = 96 bits for 8 pixels -> 12 bits / pixel NV12_10_3 (6x2 pixels): (12/3) * 32 bits + ((12/4)/3) * 64 bits = 192 bits for 12 pixels -> 16 bits / pixel How would you describe the format NV15/NV20 added in [2], as they may not fully abiding by the "padded as necessary to reach a multiple of 8 bits" if I understand this description correctly? (NV15 has already been added to uapi drm_fourcc.h) NV15 (8x2 pixels): 16 y * 10 bits + 4 uv * 20 bits = 240 bits for 16 pixels -> 15 bits / pixel [1] https://docs.microsoft.com/en-us/windows/win32/medfound/recommended-8-bit-yuv-formats-for-video-rendering#nv12 [2] https://patchwork.linuxtv.org/project/linux-media/patch/20200701215616.30874-7-jonas@kwiboo.se/ Best regards, Jonas > + > .. flat-table:: Overview of Semi-Planar YUV Formats > :header-rows: 1 > :stub-columns: 0 > @@ -70,7 +75,7 @@ All components are stored with the same number of bits per component. > - 'NV21' > - 8 > - 4:2:0 > - - Cr, Cr > + - Cr, Cb > - Yes > - Linear > * - V4L2_PIX_FMT_NV12M > @@ -84,7 +89,7 @@ All components are stored with the same number of bits per component. > - 'NM21' > - 8 > - 4:2:0 > - - Cr, Cr > + - Cr, Cb > - No > - Linear > * - V4L2_PIX_FMT_NV12MT > @@ -114,7 +119,7 @@ All components are stored with the same number of bits per component. > - 'NV61' > - 8 > - 4:2:2 > - - Cr, Cr > + - Cr, Cb > - Yes > - Linear > * - V4L2_PIX_FMT_NV16M > @@ -128,7 +133,7 @@ All components are stored with the same number of bits per component. > - 'NM61' > - 8 > - 4:2:2 > - - Cr, Cr > + - Cr, Cb > - No > - Linear > * - V4L2_PIX_FMT_NV24 > @@ -142,7 +147,91 @@ All components are stored with the same number of bits per component. > - 'NV42' > - 8 > - 4:4:4 > - - Cr, Cr > + - Cr, Cb > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV12_10_3 > + - 'N012' > + - 10 > + - 4:2:0 > + - Cb, Cr > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV21_10_3 > + - 'N061' > + - 10 > + - 4:2:0 > + - Cr, Cb > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV16_10_3 > + - 'N016' > + - 10 > + - 4:2:2 > + - Cb, Cr > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV61_10_3 > + - 'N061' > + - 10 > + - 4:2:2 > + - Cr, Cb > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV12_12_2 > + - 'N212' > + - 12 > + - 4:2:0 > + - Cb, Cr > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV21_12_2 > + - 'N261' > + - 12 > + - 4:2:0 > + - Cr, Cb > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV16_12_2 > + - 'N216' > + - 12 > + - 4:2:2 > + - Cb, Cr > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV61_12_2 > + - 'N261' > + - 12 > + - 4:2:2 > + - Cr, Cb > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV12_16_1 > + - 'N612' > + - 16 > + - 4:2:0 > + - Cb, Cr > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV21_16_1 > + - 'N661' > + - 16 > + - 4:2:0 > + - Cr, Cb > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV16_16_1 > + - 'N616' > + - 16 > + - 4:2:2 > + - Cb, Cr > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV61_16_1 > + - 'N661' > + - 16 > + - 4:2:2 > + - Cr, Cb > - Yes > - Linear > > @@ -153,7 +242,6 @@ All components are stored with the same number of bits per component. > disjoint > .. [3] Macroblock size in pixels > > - > **Color Sample Location:** > Chroma samples are :ref:`interstitially sited<yuv-chroma-centered>` > horizontally. > @@ -463,6 +551,480 @@ number of lines as the luma plane. > - Cr\ :sub:`33` > > > +.. _V4L2-PIX-FMT-NV12-10-3: > +.. _V4L2-PIX-FMT-NV21-10-3: > +.. _V4L2-PIX-FMT-NV16-10-3: > +.. _V4L2-PIX-FMT-NV61-10-3: > + > +NV12_10_3, NV21_10_3, NV16_10_3 and NV61_10_3 > +--------------------------------------------- > + > +Semi-planar YUV 4:2:0 and 4:2:2 formats with 10 bits per component, stored with > +3 samples packed in 4 bytes. > + > +Within a plane, 3 samples are packed in a 32-bit word, with 2 padding bits. > +The bits are organized as follows for the first three samples of a luma line > +and a chroma line. > + > +.. flat-table:: > + :header-rows: 0 > + :stub-columns: 0 > + > + * - 31:30 > + - 29:20 > + - 19:10 > + - 9:0 > + * - `-`\ [1:0] > + - Y'\ :sub:`2`\ [9:0] > + - Y'\ :sub:`1`\ [9:0] > + - Y'\ :sub:`0`\ [9:0] > + > +.. flat-table:: > + :header-rows: 0 > + :stub-columns: 0 > + > + * - 31:30 > + - 29:20 > + - 19:10 > + - 9:0 > + * - `-`\ [1:0] > + - Cb\ :sub:`2`\ [9:0] > + - Cr\ :sub:`0`\ [9:0] > + - Cb\ :sub:`0`\ [9:0] > + > +Words are then stored in memory in little endian format. Due to a chroma word > +storing an odd number of samples, the image width must be a multiple of 6 > +pixels. > + > +.. flat-table:: Sample 6x4 NV12_10_3 Image > + :header-rows: 0 > + :stub-columns: 0 > + > + * - start + 0: > + - Y'\ :sub:`00`\ [7:0] > + - Y'\ :sub:`01`\ [5:0] Y'\ :sub:`00`\ [9:8] > + - Y'\ :sub:`02`\ [3:0] Y'\ :sub:`01`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`02`\ [9:4] > + - Y'\ :sub:`03`\ [7:0] > + - Y'\ :sub:`04`\ [5:0] Y'\ :sub:`04`\ [9:8] > + - Y'\ :sub:`05`\ [3:0] Y'\ :sub:`05`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`05`\ [9:4] > + * - start + 8: > + - Y'\ :sub:`10`\ [7:0] > + - Y'\ :sub:`11`\ [5:0] Y'\ :sub:`10`\ [9:8] > + - Y'\ :sub:`12`\ [3:0] Y'\ :sub:`11`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`12`\ [9:4] > + - Y'\ :sub:`13`\ [7:0] > + - Y'\ :sub:`14`\ [5:0] Y'\ :sub:`14`\ [9:8] > + - Y'\ :sub:`15`\ [3:0] Y'\ :sub:`15`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`15`\ [9:4] > + * - start + 16: > + - Y'\ :sub:`20`\ [7:0] > + - Y'\ :sub:`21`\ [5:0] Y'\ :sub:`20`\ [9:8] > + - Y'\ :sub:`22`\ [3:0] Y'\ :sub:`21`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`22`\ [9:4] > + - Y'\ :sub:`23`\ [7:0] > + - Y'\ :sub:`24`\ [5:0] Y'\ :sub:`24`\ [9:8] > + - Y'\ :sub:`25`\ [3:0] Y'\ :sub:`25`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`25`\ [9:4] > + * - start + 24: > + - Y'\ :sub:`20`\ [7:0] > + - Y'\ :sub:`21`\ [5:0] Y'\ :sub:`20`\ [9:8] > + - Y'\ :sub:`22`\ [3:0] Y'\ :sub:`21`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`22`\ [9:4] > + - Y'\ :sub:`23`\ [7:0] > + - Y'\ :sub:`24`\ [5:0] Y'\ :sub:`24`\ [9:8] > + - Y'\ :sub:`25`\ [3:0] Y'\ :sub:`25`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`25`\ [9:4] > + * - start + 32: > + - Cb\ :sub:`00`\ [7:0] > + - Cr\ :sub:`00`\ [5:0] Cb\ :sub:`00`\ [9:8] > + - Cb\ :sub:`02`\ [3:0] Cr\ :sub:`00`\ [9:6] > + - `-`\ [1:0] Cb\ :sub:`02`\ [9:4] > + - Cr\ :sub:`02`\ [7:0] > + - Cb\ :sub:`04`\ [5:0] Cr\ :sub:`02`\ [9:8] > + - Cr\ :sub:`04`\ [3:0] Cb\ :sub:`04`\ [9:6] > + - `-`\ [1:0] Cr\ :sub:`04`\ [9:4] > + * - start + 40: > + - Cb\ :sub:`20`\ [7:0] > + - Cr\ :sub:`20`\ [5:0] Cb\ :sub:`20`\ [9:8] > + - Cb\ :sub:`22`\ [3:0] Cr\ :sub:`20`\ [9:6] > + - `-`\ [1:0] Cb\ :sub:`22`\ [9:4] > + - Cr\ :sub:`22`\ [7:0] > + - Cb\ :sub:`24`\ [5:0] Cr\ :sub:`22`\ [9:8] > + - Cr\ :sub:`24`\ [3:0] Cb\ :sub:`24`\ [9:6] > + - `-`\ [1:0] Cr\ :sub:`24`\ [9:4] > + > +.. flat-table:: Sample 6x4 NV16_10_3 Image > + :header-rows: 0 > + :stub-columns: 0 > + > + * - start + 0: > + - Y'\ :sub:`00`\ [7:0] > + - Y'\ :sub:`01`\ [5:0] Y'\ :sub:`00`\ [9:8] > + - Y'\ :sub:`02`\ [3:0] Y'\ :sub:`01`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`02`\ [9:4] > + - Y'\ :sub:`03`\ [7:0] > + - Y'\ :sub:`04`\ [5:0] Y'\ :sub:`04`\ [9:8] > + - Y'\ :sub:`05`\ [3:0] Y'\ :sub:`05`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`05`\ [9:4] > + * - start + 8: > + - Y'\ :sub:`10`\ [7:0] > + - Y'\ :sub:`11`\ [5:0] Y'\ :sub:`10`\ [9:8] > + - Y'\ :sub:`12`\ [3:0] Y'\ :sub:`11`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`12`\ [9:4] > + - Y'\ :sub:`13`\ [7:0] > + - Y'\ :sub:`14`\ [5:0] Y'\ :sub:`14`\ [9:8] > + - Y'\ :sub:`15`\ [3:0] Y'\ :sub:`15`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`15`\ [9:4] > + * - start + 16: > + - Y'\ :sub:`20`\ [7:0] > + - Y'\ :sub:`21`\ [5:0] Y'\ :sub:`20`\ [9:8] > + - Y'\ :sub:`22`\ [3:0] Y'\ :sub:`21`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`22`\ [9:4] > + - Y'\ :sub:`23`\ [7:0] > + - Y'\ :sub:`24`\ [5:0] Y'\ :sub:`24`\ [9:8] > + - Y'\ :sub:`25`\ [3:0] Y'\ :sub:`25`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`25`\ [9:4] > + * - start + 24: > + - Y'\ :sub:`20`\ [7:0] > + - Y'\ :sub:`21`\ [5:0] Y'\ :sub:`20`\ [9:8] > + - Y'\ :sub:`22`\ [3:0] Y'\ :sub:`21`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`22`\ [9:4] > + - Y'\ :sub:`23`\ [7:0] > + - Y'\ :sub:`24`\ [5:0] Y'\ :sub:`24`\ [9:8] > + - Y'\ :sub:`25`\ [3:0] Y'\ :sub:`25`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`25`\ [9:4] > + * - start + 32: > + - Cb\ :sub:`00`\ [7:0] > + - Cr\ :sub:`00`\ [5:0] Cb\ :sub:`00`\ [9:8] > + - Cb\ :sub:`02`\ [3:0] Cr\ :sub:`00`\ [9:6] > + - `-`\ [1:0] Cb\ :sub:`02`\ [9:4] > + - Cr\ :sub:`02`\ [7:0] > + - Cb\ :sub:`04`\ [5:0] Cr\ :sub:`02`\ [9:8] > + - Cr\ :sub:`04`\ [3:0] Cb\ :sub:`04`\ [9:6] > + - `-`\ [1:0] Cr\ :sub:`04`\ [9:4] > + * - start + 40: > + - Cb\ :sub:`10`\ [7:0] > + - Cr\ :sub:`10`\ [5:0] Cb\ :sub:`10`\ [9:8] > + - Cb\ :sub:`12`\ [3:0] Cr\ :sub:`10`\ [9:6] > + - `-`\ [1:0] Cb\ :sub:`12`\ [9:4] > + - Cr\ :sub:`12`\ [7:0] > + - Cb\ :sub:`14`\ [5:0] Cr\ :sub:`12`\ [9:8] > + - Cr\ :sub:`14`\ [3:0] Cb\ :sub:`14`\ [9:6] > + - `-`\ [1:0] Cr\ :sub:`14`\ [9:4] > + * - start + 48: > + - Cb\ :sub:`20`\ [7:0] > + - Cr\ :sub:`20`\ [5:0] Cb\ :sub:`20`\ [9:8] > + - Cb\ :sub:`22`\ [3:0] Cr\ :sub:`20`\ [9:6] > + - `-`\ [1:0] Cb\ :sub:`22`\ [9:4] > + - Cr\ :sub:`22`\ [7:0] > + - Cb\ :sub:`24`\ [5:0] Cr\ :sub:`22`\ [9:8] > + - Cr\ :sub:`24`\ [3:0] Cb\ :sub:`24`\ [9:6] > + - `-`\ [1:0] Cr\ :sub:`24`\ [9:4] > + * - start + 56: > + - Cb\ :sub:`30`\ [7:0] > + - Cr\ :sub:`30`\ [5:0] Cb\ :sub:`30`\ [9:8] > + - Cb\ :sub:`32`\ [3:0] Cr\ :sub:`30`\ [9:6] > + - `-`\ [1:0] Cb\ :sub:`32`\ [9:4] > + - Cr\ :sub:`32`\ [7:0] > + - Cb\ :sub:`34`\ [5:0] Cr\ :sub:`32`\ [9:8] > + - Cr\ :sub:`34`\ [3:0] Cb\ :sub:`34`\ [9:6] > + - `-`\ [1:0] Cr\ :sub:`34`\ [9:4] > + > + > +.. _V4L2-PIX-FMT-NV12-12-2: > +.. _V4L2-PIX-FMT-NV21-12-2: > +.. _V4L2-PIX-FMT-NV16-12-2: > +.. _V4L2-PIX-FMT-NV61-12-2: > + > +NV12_12_2, NV21_12_2, NV16_12_2 and NV61_12_2 > +--------------------------------------------- > + > +Semi-planar YUV 4:2:0 and 4:2:2 formats with 12 bits per component, stored with > +2 samples packed in 3 bytes. > + > +Within a plane, 2 samples are packed in a 24-bit word, with no padding bits. > +The bits are organized as follows for the first two samples of a luma line > +and a chroma line. > + > +.. flat-table:: > + :header-rows: 0 > + :stub-columns: 0 > + > + * - 23:12 > + - 11:0 > + * - Y'\ :sub:`1`\ [11:0] > + - Y'\ :sub:`0`\ [11:0] > + > +.. flat-table:: > + :header-rows: 0 > + :stub-columns: 0 > + > + * - 23:12 > + - 11:0 > + * - Cr\ :sub:`0`\ [11:0] > + - Cb\ :sub:`0`\ [11:0] > + > +Words are then stored in memory in little endian format. > + > +.. flat-table:: Sample 4x4 NV12_12_2 Image > + :header-rows: 0 > + :stub-columns: 0 > + > + * - start + 0: > + - Y'\ :sub:`00`\ [7:0] > + - Y'\ :sub:`01`\ [3:0] Y'\ :sub:`00`\ [11:8] > + - Y'\ :sub:`01`\ [11:4] > + - Y'\ :sub:`02`\ [7:0] > + - Y'\ :sub:`03`\ [3:0] Y'\ :sub:`02`\ [11:8] > + - Y'\ :sub:`03`\ [11:4] > + * - start + 6: > + - Y'\ :sub:`10`\ [7:0] > + - Y'\ :sub:`11`\ [3:0] Y'\ :sub:`10`\ [11:8] > + - Y'\ :sub:`11`\ [11:4] > + - Y'\ :sub:`12`\ [7:0] > + - Y'\ :sub:`13`\ [3:0] Y'\ :sub:`12`\ [11:8] > + - Y'\ :sub:`13`\ [11:4] > + * - start + 12: > + - Y'\ :sub:`20`\ [7:0] > + - Y'\ :sub:`21`\ [3:0] Y'\ :sub:`20`\ [11:8] > + - Y'\ :sub:`21`\ [11:4] > + - Y'\ :sub:`22`\ [7:0] > + - Y'\ :sub:`23`\ [3:0] Y'\ :sub:`22`\ [11:8] > + - Y'\ :sub:`23`\ [11:4] > + * - start + 18: > + - Y'\ :sub:`30`\ [7:0] > + - Y'\ :sub:`31`\ [3:0] Y'\ :sub:`30`\ [11:8] > + - Y'\ :sub:`31`\ [11:4] > + - Y'\ :sub:`32`\ [7:0] > + - Y'\ :sub:`33`\ [3:0] Y'\ :sub:`32`\ [11:8] > + - Y'\ :sub:`33`\ [11:4] > + * - start + 24: > + - Cb\ :sub:`00`\ [7:0] > + - Cr\ :sub:`00`\ [3:0] Cb\ :sub:`00`\ [11:8] > + - Cr\ :sub:`00`\ [11:4] > + - Cb\ :sub:`02`\ [7:0] > + - Cr\ :sub:`02`\ [3:0] Cb\ :sub:`02`\ [11:8] > + - Cr\ :sub:`02`\ [11:4] > + * - start + 30: > + - Cb\ :sub:`20`\ [7:0] > + - Cr\ :sub:`20`\ [3:0] Cb\ :sub:`20`\ [11:8] > + - Cr\ :sub:`20`\ [11:4] > + - Cb\ :sub:`22`\ [7:0] > + - Cr\ :sub:`22`\ [3:0] Cb\ :sub:`22`\ [11:8] > + - Cr\ :sub:`22`\ [11:4] > + > +.. flat-table:: Sample 4x4 NV16_12_2 Image > + :header-rows: 0 > + :stub-columns: 0 > + > + * - start + 0: > + - Y'\ :sub:`00`\ [7:0] > + - Y'\ :sub:`01`\ [3:0] Y'\ :sub:`00`\ [11:8] > + - Y'\ :sub:`01`\ [11:4] > + - Y'\ :sub:`02`\ [7:0] > + - Y'\ :sub:`03`\ [3:0] Y'\ :sub:`02`\ [11:8] > + - Y'\ :sub:`03`\ [11:4] > + * - start + 6: > + - Y'\ :sub:`10`\ [7:0] > + - Y'\ :sub:`11`\ [3:0] Y'\ :sub:`10`\ [11:8] > + - Y'\ :sub:`11`\ [11:4] > + - Y'\ :sub:`12`\ [7:0] > + - Y'\ :sub:`13`\ [3:0] Y'\ :sub:`12`\ [11:8] > + - Y'\ :sub:`13`\ [11:4] > + * - start + 12: > + - Y'\ :sub:`20`\ [7:0] > + - Y'\ :sub:`21`\ [3:0] Y'\ :sub:`20`\ [11:8] > + - Y'\ :sub:`21`\ [11:4] > + - Y'\ :sub:`22`\ [7:0] > + - Y'\ :sub:`23`\ [3:0] Y'\ :sub:`22`\ [11:8] > + - Y'\ :sub:`23`\ [11:4] > + * - start + 18: > + - Y'\ :sub:`30`\ [7:0] > + - Y'\ :sub:`31`\ [3:0] Y'\ :sub:`30`\ [11:8] > + - Y'\ :sub:`31`\ [11:4] > + - Y'\ :sub:`32`\ [7:0] > + - Y'\ :sub:`33`\ [3:0] Y'\ :sub:`32`\ [11:8] > + - Y'\ :sub:`33`\ [11:4] > + * - start + 24: > + - Cb\ :sub:`00`\ [7:0] > + - Cr\ :sub:`00`\ [3:0] Cb\ :sub:`00`\ [11:8] > + - Cr\ :sub:`00`\ [11:4] > + - Cb\ :sub:`02`\ [7:0] > + - Cr\ :sub:`02`\ [3:0] Cb\ :sub:`02`\ [11:8] > + - Cr\ :sub:`02`\ [11:4] > + * - start + 30: > + - Cb\ :sub:`10`\ [7:0] > + - Cr\ :sub:`10`\ [3:0] Cb\ :sub:`10`\ [11:8] > + - Cr\ :sub:`10`\ [11:4] > + - Cb\ :sub:`12`\ [7:0] > + - Cr\ :sub:`12`\ [3:0] Cb\ :sub:`12`\ [11:8] > + - Cr\ :sub:`12`\ [11:4] > + * - start + 36: > + - Cb\ :sub:`20`\ [7:0] > + - Cr\ :sub:`20`\ [3:0] Cb\ :sub:`20`\ [11:8] > + - Cr\ :sub:`20`\ [11:4] > + - Cb\ :sub:`22`\ [7:0] > + - Cr\ :sub:`22`\ [3:0] Cb\ :sub:`22`\ [11:8] > + - Cr\ :sub:`22`\ [11:4] > + * - start + 42: > + - Cb\ :sub:`30`\ [7:0] > + - Cr\ :sub:`30`\ [3:0] Cb\ :sub:`30`\ [11:8] > + - Cr\ :sub:`30`\ [11:4] > + - Cb\ :sub:`32`\ [7:0] > + - Cr\ :sub:`32`\ [3:0] Cb\ :sub:`32`\ [11:8] > + - Cr\ :sub:`32`\ [11:4] > + > + > +.. _V4L2-PIX-FMT-NV12-16-1: > +.. _V4L2-PIX-FMT-NV21-16-1: > +.. _V4L2-PIX-FMT-NV16-16-1: > +.. _V4L2-PIX-FMT-NV61-16-1: > + > +NV12_16_1, NV21_16_1, NV16_16_1 and NV61_16_1 > +--------------------------------------------- > + > +Semi-planar YUV 4:2:0 and 4:2:2 formats with 16 bits per component. 16-bit > +samples are stored in memory in little endian format. > + > +.. flat-table:: Sample 4x4 NV12_16_1 Image > + :header-rows: 0 > + :stub-columns: 0 > + > + * - start + 0: > + - Y'\ :sub:`00`\ [7:0] > + - Y'\ :sub:`00`\ [15:8] > + - Y'\ :sub:`01`\ [7:0] > + - Y'\ :sub:`01`\ [15:8] > + - Y'\ :sub:`02`\ [7:0] > + - Y'\ :sub:`02`\ [15:8] > + - Y'\ :sub:`03`\ [7:0] > + - Y'\ :sub:`03`\ [15:8] > + * - start + 8: > + - Y'\ :sub:`10`\ [7:0] > + - Y'\ :sub:`10`\ [15:8] > + - Y'\ :sub:`11`\ [7:0] > + - Y'\ :sub:`11`\ [15:8] > + - Y'\ :sub:`12`\ [7:0] > + - Y'\ :sub:`12`\ [15:8] > + - Y'\ :sub:`13`\ [7:0] > + - Y'\ :sub:`13`\ [15:8] > + * - start + 16: > + - Y'\ :sub:`20`\ [7:0] > + - Y'\ :sub:`20`\ [15:8] > + - Y'\ :sub:`21`\ [7:0] > + - Y'\ :sub:`21`\ [15:8] > + - Y'\ :sub:`22`\ [7:0] > + - Y'\ :sub:`22`\ [15:8] > + - Y'\ :sub:`23`\ [7:0] > + - Y'\ :sub:`23`\ [15:8] > + * - start + 24: > + - Y'\ :sub:`30`\ [7:0] > + - Y'\ :sub:`30`\ [15:8] > + - Y'\ :sub:`31`\ [7:0] > + - Y'\ :sub:`31`\ [15:8] > + - Y'\ :sub:`32`\ [7:0] > + - Y'\ :sub:`32`\ [15:8] > + - Y'\ :sub:`33`\ [7:0] > + - Y'\ :sub:`33`\ [15:8] > + * - start + 32: > + - Cb\ :sub:`00`\ [7:0] > + - Cb\ :sub:`00`\ [15:8] > + - Cr\ :sub:`00`\ [7:0] > + - Cr\ :sub:`00`\ [15:8] > + - Cb\ :sub:`02`\ [7:0] > + - Cb\ :sub:`02`\ [15:8] > + - Cr\ :sub:`02`\ [7:0] > + - Cr\ :sub:`02`\ [15:8] > + * - start + 40: > + - Cb\ :sub:`20`\ [7:0] > + - Cb\ :sub:`20`\ [15:8] > + - Cr\ :sub:`20`\ [7:0] > + - Cr\ :sub:`20`\ [15:8] > + - Cb\ :sub:`22`\ [7:0] > + - Cb\ :sub:`22`\ [15:8] > + - Cr\ :sub:`22`\ [7:0] > + - Cr\ :sub:`22`\ [15:8] > + > +.. flat-table:: Sample 4x4 NV16_16_1 Image > + :header-rows: 0 > + :stub-columns: 0 > + > + * - start + 0: > + - Y'\ :sub:`00`\ [7:0] > + - Y'\ :sub:`00`\ [15:8] > + - Y'\ :sub:`01`\ [7:0] > + - Y'\ :sub:`01`\ [15:8] > + - Y'\ :sub:`02`\ [7:0] > + - Y'\ :sub:`02`\ [15:8] > + - Y'\ :sub:`03`\ [7:0] > + - Y'\ :sub:`03`\ [15:8] > + * - start + 8: > + - Y'\ :sub:`10`\ [7:0] > + - Y'\ :sub:`10`\ [15:8] > + - Y'\ :sub:`11`\ [7:0] > + - Y'\ :sub:`11`\ [15:8] > + - Y'\ :sub:`12`\ [7:0] > + - Y'\ :sub:`12`\ [15:8] > + - Y'\ :sub:`13`\ [7:0] > + - Y'\ :sub:`13`\ [15:8] > + * - start + 16: > + - Y'\ :sub:`20`\ [7:0] > + - Y'\ :sub:`20`\ [15:8] > + - Y'\ :sub:`21`\ [7:0] > + - Y'\ :sub:`21`\ [15:8] > + - Y'\ :sub:`22`\ [7:0] > + - Y'\ :sub:`22`\ [15:8] > + - Y'\ :sub:`23`\ [7:0] > + - Y'\ :sub:`23`\ [15:8] > + * - start + 24: > + - Y'\ :sub:`30`\ [7:0] > + - Y'\ :sub:`30`\ [15:8] > + - Y'\ :sub:`31`\ [7:0] > + - Y'\ :sub:`31`\ [15:8] > + - Y'\ :sub:`32`\ [7:0] > + - Y'\ :sub:`32`\ [15:8] > + - Y'\ :sub:`33`\ [7:0] > + - Y'\ :sub:`33`\ [15:8] > + * - start + 32: > + - Cb\ :sub:`00`\ [7:0] > + - Cb\ :sub:`00`\ [15:8] > + - Cr\ :sub:`00`\ [7:0] > + - Cr\ :sub:`00`\ [15:8] > + - Cb\ :sub:`02`\ [7:0] > + - Cb\ :sub:`02`\ [15:8] > + - Cr\ :sub:`02`\ [7:0] > + - Cr\ :sub:`02`\ [15:8] > + * - start + 40: > + - Cb\ :sub:`10`\ [7:0] > + - Cb\ :sub:`10`\ [15:8] > + - Cr\ :sub:`10`\ [7:0] > + - Cr\ :sub:`10`\ [15:8] > + - Cb\ :sub:`12`\ [7:0] > + - Cb\ :sub:`12`\ [15:8] > + - Cr\ :sub:`12`\ [7:0] > + - Cr\ :sub:`12`\ [15:8] > + * - start + 48: > + - Cb\ :sub:`20`\ [7:0] > + - Cb\ :sub:`20`\ [15:8] > + - Cr\ :sub:`20`\ [7:0] > + - Cr\ :sub:`20`\ [15:8] > + - Cb\ :sub:`22`\ [7:0] > + - Cb\ :sub:`22`\ [15:8] > + - Cr\ :sub:`22`\ [7:0] > + - Cr\ :sub:`22`\ [15:8] > + * - start + 56: > + - Cb\ :sub:`30`\ [7:0] > + - Cb\ :sub:`30`\ [15:8] > + - Cr\ :sub:`30`\ [7:0] > + - Cr\ :sub:`30`\ [15:8] > + - Cb\ :sub:`32`\ [7:0] > + - Cb\ :sub:`32`\ [15:8] > + - Cr\ :sub:`32`\ [7:0] > + - Cr\ :sub:`32`\ [15:8] > + > + > Fully Planar YUV Formats > ======================== > > diff --git a/include/uapi/linux/videodev2.h b/include/uapi/linux/videodev2.h > index cf9288d270c6..3c4609ff83d6 100644 > --- a/include/uapi/linux/videodev2.h > +++ b/include/uapi/linux/videodev2.h > @@ -616,6 +616,18 @@ struct v4l2_pix_format { > #define V4L2_PIX_FMT_NV24 v4l2_fourcc('N', 'V', '2', '4') /* 24 Y/CbCr 4:4:4 */ > #define V4L2_PIX_FMT_NV42 v4l2_fourcc('N', 'V', '4', '2') /* 24 Y/CrCb 4:4:4 */ > #define V4L2_PIX_FMT_HM12 v4l2_fourcc('H', 'M', '1', '2') /* 8 YUV 4:2:0 16x16 macroblocks */ > +#define V4L2_PIX_FMT_NV12_10_3 v4l2_fourcc('N', '0', '1', '2') /* 16 Y/CbCr 4:2:0 10b */ > +#define V4L2_PIX_FMT_NV21_10_3 v4l2_fourcc('N', '0', '2', '1') /* 16 Y/CrCb 4:2:0 10b */ > +#define V4L2_PIX_FMT_NV16_10_3 v4l2_fourcc('N', '0', '1', '6') /* 64/3 Y/CbCr 4:2:2 10b */ > +#define V4L2_PIX_FMT_NV61_10_3 v4l2_fourcc('N', '0', '6', '1') /* 64/3 Y/CrCb 4:2:2 10b */ > +#define V4L2_PIX_FMT_NV12_12_2 v4l2_fourcc('N', '2', '1', '2') /* 18 Y/CbCr 4:2:0 12b */ > +#define V4L2_PIX_FMT_NV21_12_2 v4l2_fourcc('N', '2', '2', '1') /* 18 Y/CrCb 4:2:0 12b */ > +#define V4L2_PIX_FMT_NV16_12_2 v4l2_fourcc('N', '2', '1', '6') /* 24 Y/CbCr 4:2:2 12b */ > +#define V4L2_PIX_FMT_NV61_12_2 v4l2_fourcc('N', '2', '6', '1') /* 24 Y/CrCb 4:2:2 12b */ > +#define V4L2_PIX_FMT_NV12_16_1 v4l2_fourcc('N', '6', '1', '2') /* 24 Y/CbCr 4:2:0 16b */ > +#define V4L2_PIX_FMT_NV21_16_1 v4l2_fourcc('N', '6', '2', '1') /* 24 Y/CrCb 4:2:0 16b */ > +#define V4L2_PIX_FMT_NV16_16_1 v4l2_fourcc('N', '6', '1', '6') /* 32 Y/CbCr 4:2:2 16b */ > +#define V4L2_PIX_FMT_NV61_16_1 v4l2_fourcc('N', '6', '6', '1') /* 32 Y/CrCb 4:2:2 16b */ > > /* two non contiguous planes - one Y, one Cr + Cb interleaved */ > #define V4L2_PIX_FMT_NV12M v4l2_fourcc('N', 'M', '1', '2') /* 12 Y/CbCr 4:2:0 */ >
On 16/11/2020 19:52, Laurent Pinchart wrote: > Add semi-planar YUV formats with 10, 12 and 16 bits per components, in > both 4:2:0 (NV12) and 4:2:2 (NV16) subsampling, and with both chroma > orderings. They are used by the Xilinx Video Frame Buffer Read/Write IP > cores. > > Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com> > --- > Changes since v2: > > - Replace 'Cr, Cr' with 'Cr, Cb' > --- > .../media/v4l/pixfmt-yuv-planar.rst | 574 +++++++++++++++++- > include/uapi/linux/videodev2.h | 12 + > 2 files changed, 580 insertions(+), 6 deletions(-) > > diff --git a/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst b/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst > index 7d4d39201a3f..4ac4c6a0290b 100644 > --- a/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst > +++ b/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst > @@ -48,6 +48,11 @@ relationship between the luma and chroma line padding and stride. > > All components are stored with the same number of bits per component. > > +Formats with more than 8 bits per component pack, within each plane, multiple > +samples in a word (padded as necessary to reach a multiple of 8 bits), which is > +then stored in memory in little endian byte order. They are named with a suffix > +indicating the number of bits per component and the number of samples per word. > + > .. flat-table:: Overview of Semi-Planar YUV Formats > :header-rows: 1 > :stub-columns: 0 > @@ -70,7 +75,7 @@ All components are stored with the same number of bits per component. > - 'NV21' > - 8 > - 4:2:0 > - - Cr, Cr > + - Cr, Cb > - Yes > - Linear > * - V4L2_PIX_FMT_NV12M > @@ -84,7 +89,7 @@ All components are stored with the same number of bits per component. > - 'NM21' > - 8 > - 4:2:0 > - - Cr, Cr > + - Cr, Cb > - No > - Linear > * - V4L2_PIX_FMT_NV12MT > @@ -114,7 +119,7 @@ All components are stored with the same number of bits per component. > - 'NV61' > - 8 > - 4:2:2 > - - Cr, Cr > + - Cr, Cb > - Yes > - Linear > * - V4L2_PIX_FMT_NV16M > @@ -128,7 +133,7 @@ All components are stored with the same number of bits per component. > - 'NM61' > - 8 > - 4:2:2 > - - Cr, Cr > + - Cr, Cb > - No > - Linear > * - V4L2_PIX_FMT_NV24 > @@ -142,7 +147,91 @@ All components are stored with the same number of bits per component. > - 'NV42' > - 8 > - 4:4:4 > - - Cr, Cr > + - Cr, Cb > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV12_10_3 > + - 'N012' > + - 10 > + - 4:2:0 > + - Cb, Cr > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV21_10_3 > + - 'N061' > + - 10 > + - 4:2:0 > + - Cr, Cb > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV16_10_3 > + - 'N016' > + - 10 > + - 4:2:2 > + - Cb, Cr > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV61_10_3 > + - 'N061' > + - 10 > + - 4:2:2 > + - Cr, Cb > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV12_12_2 > + - 'N212' > + - 12 > + - 4:2:0 > + - Cb, Cr > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV21_12_2 > + - 'N261' > + - 12 > + - 4:2:0 > + - Cr, Cb > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV16_12_2 > + - 'N216' > + - 12 > + - 4:2:2 > + - Cb, Cr > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV61_12_2 > + - 'N261' > + - 12 > + - 4:2:2 > + - Cr, Cb > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV12_16_1 > + - 'N612' > + - 16 > + - 4:2:0 > + - Cb, Cr > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV21_16_1 > + - 'N661' > + - 16 > + - 4:2:0 > + - Cr, Cb > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV16_16_1 > + - 'N616' > + - 16 > + - 4:2:2 > + - Cb, Cr > + - Yes > + - Linear > + * - V4L2_PIX_FMT_NV61_16_1 > + - 'N661' > + - 16 > + - 4:2:2 > + - Cr, Cb > - Yes > - Linear > > @@ -153,7 +242,6 @@ All components are stored with the same number of bits per component. > disjoint > .. [3] Macroblock size in pixels > > - > **Color Sample Location:** > Chroma samples are :ref:`interstitially sited<yuv-chroma-centered>` > horizontally. > @@ -463,6 +551,480 @@ number of lines as the luma plane. > - Cr\ :sub:`33` > > > +.. _V4L2-PIX-FMT-NV12-10-3: > +.. _V4L2-PIX-FMT-NV21-10-3: > +.. _V4L2-PIX-FMT-NV16-10-3: > +.. _V4L2-PIX-FMT-NV61-10-3: > + > +NV12_10_3, NV21_10_3, NV16_10_3 and NV61_10_3 > +--------------------------------------------- > + > +Semi-planar YUV 4:2:0 and 4:2:2 formats with 10 bits per component, stored with > +3 samples packed in 4 bytes. > + > +Within a plane, 3 samples are packed in a 32-bit word, with 2 padding bits. > +The bits are organized as follows for the first three samples of a luma line > +and a chroma line. > + > +.. flat-table:: > + :header-rows: 0 > + :stub-columns: 0 > + > + * - 31:30 > + - 29:20 > + - 19:10 > + - 9:0 > + * - `-`\ [1:0] `-` -> X Repeat this many times below. This section probably needs a similar note at the top of the "Packed YUV formats" section about the meaning of 'X'. Regards, Hans > + - Y'\ :sub:`2`\ [9:0] > + - Y'\ :sub:`1`\ [9:0] > + - Y'\ :sub:`0`\ [9:0] > + > +.. flat-table:: > + :header-rows: 0 > + :stub-columns: 0 > + > + * - 31:30 > + - 29:20 > + - 19:10 > + - 9:0 > + * - `-`\ [1:0] > + - Cb\ :sub:`2`\ [9:0] > + - Cr\ :sub:`0`\ [9:0] > + - Cb\ :sub:`0`\ [9:0] > + > +Words are then stored in memory in little endian format. Due to a chroma word > +storing an odd number of samples, the image width must be a multiple of 6 > +pixels. > + > +.. flat-table:: Sample 6x4 NV12_10_3 Image > + :header-rows: 0 > + :stub-columns: 0 > + > + * - start + 0: > + - Y'\ :sub:`00`\ [7:0] > + - Y'\ :sub:`01`\ [5:0] Y'\ :sub:`00`\ [9:8] > + - Y'\ :sub:`02`\ [3:0] Y'\ :sub:`01`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`02`\ [9:4] > + - Y'\ :sub:`03`\ [7:0] > + - Y'\ :sub:`04`\ [5:0] Y'\ :sub:`04`\ [9:8] > + - Y'\ :sub:`05`\ [3:0] Y'\ :sub:`05`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`05`\ [9:4] > + * - start + 8: > + - Y'\ :sub:`10`\ [7:0] > + - Y'\ :sub:`11`\ [5:0] Y'\ :sub:`10`\ [9:8] > + - Y'\ :sub:`12`\ [3:0] Y'\ :sub:`11`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`12`\ [9:4] > + - Y'\ :sub:`13`\ [7:0] > + - Y'\ :sub:`14`\ [5:0] Y'\ :sub:`14`\ [9:8] > + - Y'\ :sub:`15`\ [3:0] Y'\ :sub:`15`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`15`\ [9:4] > + * - start + 16: > + - Y'\ :sub:`20`\ [7:0] > + - Y'\ :sub:`21`\ [5:0] Y'\ :sub:`20`\ [9:8] > + - Y'\ :sub:`22`\ [3:0] Y'\ :sub:`21`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`22`\ [9:4] > + - Y'\ :sub:`23`\ [7:0] > + - Y'\ :sub:`24`\ [5:0] Y'\ :sub:`24`\ [9:8] > + - Y'\ :sub:`25`\ [3:0] Y'\ :sub:`25`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`25`\ [9:4] > + * - start + 24: > + - Y'\ :sub:`20`\ [7:0] > + - Y'\ :sub:`21`\ [5:0] Y'\ :sub:`20`\ [9:8] > + - Y'\ :sub:`22`\ [3:0] Y'\ :sub:`21`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`22`\ [9:4] > + - Y'\ :sub:`23`\ [7:0] > + - Y'\ :sub:`24`\ [5:0] Y'\ :sub:`24`\ [9:8] > + - Y'\ :sub:`25`\ [3:0] Y'\ :sub:`25`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`25`\ [9:4] > + * - start + 32: > + - Cb\ :sub:`00`\ [7:0] > + - Cr\ :sub:`00`\ [5:0] Cb\ :sub:`00`\ [9:8] > + - Cb\ :sub:`02`\ [3:0] Cr\ :sub:`00`\ [9:6] > + - `-`\ [1:0] Cb\ :sub:`02`\ [9:4] > + - Cr\ :sub:`02`\ [7:0] > + - Cb\ :sub:`04`\ [5:0] Cr\ :sub:`02`\ [9:8] > + - Cr\ :sub:`04`\ [3:0] Cb\ :sub:`04`\ [9:6] > + - `-`\ [1:0] Cr\ :sub:`04`\ [9:4] > + * - start + 40: > + - Cb\ :sub:`20`\ [7:0] > + - Cr\ :sub:`20`\ [5:0] Cb\ :sub:`20`\ [9:8] > + - Cb\ :sub:`22`\ [3:0] Cr\ :sub:`20`\ [9:6] > + - `-`\ [1:0] Cb\ :sub:`22`\ [9:4] > + - Cr\ :sub:`22`\ [7:0] > + - Cb\ :sub:`24`\ [5:0] Cr\ :sub:`22`\ [9:8] > + - Cr\ :sub:`24`\ [3:0] Cb\ :sub:`24`\ [9:6] > + - `-`\ [1:0] Cr\ :sub:`24`\ [9:4] > + > +.. flat-table:: Sample 6x4 NV16_10_3 Image > + :header-rows: 0 > + :stub-columns: 0 > + > + * - start + 0: > + - Y'\ :sub:`00`\ [7:0] > + - Y'\ :sub:`01`\ [5:0] Y'\ :sub:`00`\ [9:8] > + - Y'\ :sub:`02`\ [3:0] Y'\ :sub:`01`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`02`\ [9:4] > + - Y'\ :sub:`03`\ [7:0] > + - Y'\ :sub:`04`\ [5:0] Y'\ :sub:`04`\ [9:8] > + - Y'\ :sub:`05`\ [3:0] Y'\ :sub:`05`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`05`\ [9:4] > + * - start + 8: > + - Y'\ :sub:`10`\ [7:0] > + - Y'\ :sub:`11`\ [5:0] Y'\ :sub:`10`\ [9:8] > + - Y'\ :sub:`12`\ [3:0] Y'\ :sub:`11`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`12`\ [9:4] > + - Y'\ :sub:`13`\ [7:0] > + - Y'\ :sub:`14`\ [5:0] Y'\ :sub:`14`\ [9:8] > + - Y'\ :sub:`15`\ [3:0] Y'\ :sub:`15`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`15`\ [9:4] > + * - start + 16: > + - Y'\ :sub:`20`\ [7:0] > + - Y'\ :sub:`21`\ [5:0] Y'\ :sub:`20`\ [9:8] > + - Y'\ :sub:`22`\ [3:0] Y'\ :sub:`21`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`22`\ [9:4] > + - Y'\ :sub:`23`\ [7:0] > + - Y'\ :sub:`24`\ [5:0] Y'\ :sub:`24`\ [9:8] > + - Y'\ :sub:`25`\ [3:0] Y'\ :sub:`25`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`25`\ [9:4] > + * - start + 24: > + - Y'\ :sub:`20`\ [7:0] > + - Y'\ :sub:`21`\ [5:0] Y'\ :sub:`20`\ [9:8] > + - Y'\ :sub:`22`\ [3:0] Y'\ :sub:`21`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`22`\ [9:4] > + - Y'\ :sub:`23`\ [7:0] > + - Y'\ :sub:`24`\ [5:0] Y'\ :sub:`24`\ [9:8] > + - Y'\ :sub:`25`\ [3:0] Y'\ :sub:`25`\ [9:6] > + - `-`\ [1:0] Y'\ :sub:`25`\ [9:4] > + * - start + 32: > + - Cb\ :sub:`00`\ [7:0] > + - Cr\ :sub:`00`\ [5:0] Cb\ :sub:`00`\ [9:8] > + - Cb\ :sub:`02`\ [3:0] Cr\ :sub:`00`\ [9:6] > + - `-`\ [1:0] Cb\ :sub:`02`\ [9:4] > + - Cr\ :sub:`02`\ [7:0] > + - Cb\ :sub:`04`\ [5:0] Cr\ :sub:`02`\ [9:8] > + - Cr\ :sub:`04`\ [3:0] Cb\ :sub:`04`\ [9:6] > + - `-`\ [1:0] Cr\ :sub:`04`\ [9:4] > + * - start + 40: > + - Cb\ :sub:`10`\ [7:0] > + - Cr\ :sub:`10`\ [5:0] Cb\ :sub:`10`\ [9:8] > + - Cb\ :sub:`12`\ [3:0] Cr\ :sub:`10`\ [9:6] > + - `-`\ [1:0] Cb\ :sub:`12`\ [9:4] > + - Cr\ :sub:`12`\ [7:0] > + - Cb\ :sub:`14`\ [5:0] Cr\ :sub:`12`\ [9:8] > + - Cr\ :sub:`14`\ [3:0] Cb\ :sub:`14`\ [9:6] > + - `-`\ [1:0] Cr\ :sub:`14`\ [9:4] > + * - start + 48: > + - Cb\ :sub:`20`\ [7:0] > + - Cr\ :sub:`20`\ [5:0] Cb\ :sub:`20`\ [9:8] > + - Cb\ :sub:`22`\ [3:0] Cr\ :sub:`20`\ [9:6] > + - `-`\ [1:0] Cb\ :sub:`22`\ [9:4] > + - Cr\ :sub:`22`\ [7:0] > + - Cb\ :sub:`24`\ [5:0] Cr\ :sub:`22`\ [9:8] > + - Cr\ :sub:`24`\ [3:0] Cb\ :sub:`24`\ [9:6] > + - `-`\ [1:0] Cr\ :sub:`24`\ [9:4] > + * - start + 56: > + - Cb\ :sub:`30`\ [7:0] > + - Cr\ :sub:`30`\ [5:0] Cb\ :sub:`30`\ [9:8] > + - Cb\ :sub:`32`\ [3:0] Cr\ :sub:`30`\ [9:6] > + - `-`\ [1:0] Cb\ :sub:`32`\ [9:4] > + - Cr\ :sub:`32`\ [7:0] > + - Cb\ :sub:`34`\ [5:0] Cr\ :sub:`32`\ [9:8] > + - Cr\ :sub:`34`\ [3:0] Cb\ :sub:`34`\ [9:6] > + - `-`\ [1:0] Cr\ :sub:`34`\ [9:4] > + > + > +.. _V4L2-PIX-FMT-NV12-12-2: > +.. _V4L2-PIX-FMT-NV21-12-2: > +.. _V4L2-PIX-FMT-NV16-12-2: > +.. _V4L2-PIX-FMT-NV61-12-2: > + > +NV12_12_2, NV21_12_2, NV16_12_2 and NV61_12_2 > +--------------------------------------------- > + > +Semi-planar YUV 4:2:0 and 4:2:2 formats with 12 bits per component, stored with > +2 samples packed in 3 bytes. > + > +Within a plane, 2 samples are packed in a 24-bit word, with no padding bits. > +The bits are organized as follows for the first two samples of a luma line > +and a chroma line. > + > +.. flat-table:: > + :header-rows: 0 > + :stub-columns: 0 > + > + * - 23:12 > + - 11:0 > + * - Y'\ :sub:`1`\ [11:0] > + - Y'\ :sub:`0`\ [11:0] > + > +.. flat-table:: > + :header-rows: 0 > + :stub-columns: 0 > + > + * - 23:12 > + - 11:0 > + * - Cr\ :sub:`0`\ [11:0] > + - Cb\ :sub:`0`\ [11:0] > + > +Words are then stored in memory in little endian format. > + > +.. flat-table:: Sample 4x4 NV12_12_2 Image > + :header-rows: 0 > + :stub-columns: 0 > + > + * - start + 0: > + - Y'\ :sub:`00`\ [7:0] > + - Y'\ :sub:`01`\ [3:0] Y'\ :sub:`00`\ [11:8] > + - Y'\ :sub:`01`\ [11:4] > + - Y'\ :sub:`02`\ [7:0] > + - Y'\ :sub:`03`\ [3:0] Y'\ :sub:`02`\ [11:8] > + - Y'\ :sub:`03`\ [11:4] > + * - start + 6: > + - Y'\ :sub:`10`\ [7:0] > + - Y'\ :sub:`11`\ [3:0] Y'\ :sub:`10`\ [11:8] > + - Y'\ :sub:`11`\ [11:4] > + - Y'\ :sub:`12`\ [7:0] > + - Y'\ :sub:`13`\ [3:0] Y'\ :sub:`12`\ [11:8] > + - Y'\ :sub:`13`\ [11:4] > + * - start + 12: > + - Y'\ :sub:`20`\ [7:0] > + - Y'\ :sub:`21`\ [3:0] Y'\ :sub:`20`\ [11:8] > + - Y'\ :sub:`21`\ [11:4] > + - Y'\ :sub:`22`\ [7:0] > + - Y'\ :sub:`23`\ [3:0] Y'\ :sub:`22`\ [11:8] > + - Y'\ :sub:`23`\ [11:4] > + * - start + 18: > + - Y'\ :sub:`30`\ [7:0] > + - Y'\ :sub:`31`\ [3:0] Y'\ :sub:`30`\ [11:8] > + - Y'\ :sub:`31`\ [11:4] > + - Y'\ :sub:`32`\ [7:0] > + - Y'\ :sub:`33`\ [3:0] Y'\ :sub:`32`\ [11:8] > + - Y'\ :sub:`33`\ [11:4] > + * - start + 24: > + - Cb\ :sub:`00`\ [7:0] > + - Cr\ :sub:`00`\ [3:0] Cb\ :sub:`00`\ [11:8] > + - Cr\ :sub:`00`\ [11:4] > + - Cb\ :sub:`02`\ [7:0] > + - Cr\ :sub:`02`\ [3:0] Cb\ :sub:`02`\ [11:8] > + - Cr\ :sub:`02`\ [11:4] > + * - start + 30: > + - Cb\ :sub:`20`\ [7:0] > + - Cr\ :sub:`20`\ [3:0] Cb\ :sub:`20`\ [11:8] > + - Cr\ :sub:`20`\ [11:4] > + - Cb\ :sub:`22`\ [7:0] > + - Cr\ :sub:`22`\ [3:0] Cb\ :sub:`22`\ [11:8] > + - Cr\ :sub:`22`\ [11:4] > + > +.. flat-table:: Sample 4x4 NV16_12_2 Image > + :header-rows: 0 > + :stub-columns: 0 > + > + * - start + 0: > + - Y'\ :sub:`00`\ [7:0] > + - Y'\ :sub:`01`\ [3:0] Y'\ :sub:`00`\ [11:8] > + - Y'\ :sub:`01`\ [11:4] > + - Y'\ :sub:`02`\ [7:0] > + - Y'\ :sub:`03`\ [3:0] Y'\ :sub:`02`\ [11:8] > + - Y'\ :sub:`03`\ [11:4] > + * - start + 6: > + - Y'\ :sub:`10`\ [7:0] > + - Y'\ :sub:`11`\ [3:0] Y'\ :sub:`10`\ [11:8] > + - Y'\ :sub:`11`\ [11:4] > + - Y'\ :sub:`12`\ [7:0] > + - Y'\ :sub:`13`\ [3:0] Y'\ :sub:`12`\ [11:8] > + - Y'\ :sub:`13`\ [11:4] > + * - start + 12: > + - Y'\ :sub:`20`\ [7:0] > + - Y'\ :sub:`21`\ [3:0] Y'\ :sub:`20`\ [11:8] > + - Y'\ :sub:`21`\ [11:4] > + - Y'\ :sub:`22`\ [7:0] > + - Y'\ :sub:`23`\ [3:0] Y'\ :sub:`22`\ [11:8] > + - Y'\ :sub:`23`\ [11:4] > + * - start + 18: > + - Y'\ :sub:`30`\ [7:0] > + - Y'\ :sub:`31`\ [3:0] Y'\ :sub:`30`\ [11:8] > + - Y'\ :sub:`31`\ [11:4] > + - Y'\ :sub:`32`\ [7:0] > + - Y'\ :sub:`33`\ [3:0] Y'\ :sub:`32`\ [11:8] > + - Y'\ :sub:`33`\ [11:4] > + * - start + 24: > + - Cb\ :sub:`00`\ [7:0] > + - Cr\ :sub:`00`\ [3:0] Cb\ :sub:`00`\ [11:8] > + - Cr\ :sub:`00`\ [11:4] > + - Cb\ :sub:`02`\ [7:0] > + - Cr\ :sub:`02`\ [3:0] Cb\ :sub:`02`\ [11:8] > + - Cr\ :sub:`02`\ [11:4] > + * - start + 30: > + - Cb\ :sub:`10`\ [7:0] > + - Cr\ :sub:`10`\ [3:0] Cb\ :sub:`10`\ [11:8] > + - Cr\ :sub:`10`\ [11:4] > + - Cb\ :sub:`12`\ [7:0] > + - Cr\ :sub:`12`\ [3:0] Cb\ :sub:`12`\ [11:8] > + - Cr\ :sub:`12`\ [11:4] > + * - start + 36: > + - Cb\ :sub:`20`\ [7:0] > + - Cr\ :sub:`20`\ [3:0] Cb\ :sub:`20`\ [11:8] > + - Cr\ :sub:`20`\ [11:4] > + - Cb\ :sub:`22`\ [7:0] > + - Cr\ :sub:`22`\ [3:0] Cb\ :sub:`22`\ [11:8] > + - Cr\ :sub:`22`\ [11:4] > + * - start + 42: > + - Cb\ :sub:`30`\ [7:0] > + - Cr\ :sub:`30`\ [3:0] Cb\ :sub:`30`\ [11:8] > + - Cr\ :sub:`30`\ [11:4] > + - Cb\ :sub:`32`\ [7:0] > + - Cr\ :sub:`32`\ [3:0] Cb\ :sub:`32`\ [11:8] > + - Cr\ :sub:`32`\ [11:4] > + > + > +.. _V4L2-PIX-FMT-NV12-16-1: > +.. _V4L2-PIX-FMT-NV21-16-1: > +.. _V4L2-PIX-FMT-NV16-16-1: > +.. _V4L2-PIX-FMT-NV61-16-1: > + > +NV12_16_1, NV21_16_1, NV16_16_1 and NV61_16_1 > +--------------------------------------------- > + > +Semi-planar YUV 4:2:0 and 4:2:2 formats with 16 bits per component. 16-bit > +samples are stored in memory in little endian format. > + > +.. flat-table:: Sample 4x4 NV12_16_1 Image > + :header-rows: 0 > + :stub-columns: 0 > + > + * - start + 0: > + - Y'\ :sub:`00`\ [7:0] > + - Y'\ :sub:`00`\ [15:8] > + - Y'\ :sub:`01`\ [7:0] > + - Y'\ :sub:`01`\ [15:8] > + - Y'\ :sub:`02`\ [7:0] > + - Y'\ :sub:`02`\ [15:8] > + - Y'\ :sub:`03`\ [7:0] > + - Y'\ :sub:`03`\ [15:8] > + * - start + 8: > + - Y'\ :sub:`10`\ [7:0] > + - Y'\ :sub:`10`\ [15:8] > + - Y'\ :sub:`11`\ [7:0] > + - Y'\ :sub:`11`\ [15:8] > + - Y'\ :sub:`12`\ [7:0] > + - Y'\ :sub:`12`\ [15:8] > + - Y'\ :sub:`13`\ [7:0] > + - Y'\ :sub:`13`\ [15:8] > + * - start + 16: > + - Y'\ :sub:`20`\ [7:0] > + - Y'\ :sub:`20`\ [15:8] > + - Y'\ :sub:`21`\ [7:0] > + - Y'\ :sub:`21`\ [15:8] > + - Y'\ :sub:`22`\ [7:0] > + - Y'\ :sub:`22`\ [15:8] > + - Y'\ :sub:`23`\ [7:0] > + - Y'\ :sub:`23`\ [15:8] > + * - start + 24: > + - Y'\ :sub:`30`\ [7:0] > + - Y'\ :sub:`30`\ [15:8] > + - Y'\ :sub:`31`\ [7:0] > + - Y'\ :sub:`31`\ [15:8] > + - Y'\ :sub:`32`\ [7:0] > + - Y'\ :sub:`32`\ [15:8] > + - Y'\ :sub:`33`\ [7:0] > + - Y'\ :sub:`33`\ [15:8] > + * - start + 32: > + - Cb\ :sub:`00`\ [7:0] > + - Cb\ :sub:`00`\ [15:8] > + - Cr\ :sub:`00`\ [7:0] > + - Cr\ :sub:`00`\ [15:8] > + - Cb\ :sub:`02`\ [7:0] > + - Cb\ :sub:`02`\ [15:8] > + - Cr\ :sub:`02`\ [7:0] > + - Cr\ :sub:`02`\ [15:8] > + * - start + 40: > + - Cb\ :sub:`20`\ [7:0] > + - Cb\ :sub:`20`\ [15:8] > + - Cr\ :sub:`20`\ [7:0] > + - Cr\ :sub:`20`\ [15:8] > + - Cb\ :sub:`22`\ [7:0] > + - Cb\ :sub:`22`\ [15:8] > + - Cr\ :sub:`22`\ [7:0] > + - Cr\ :sub:`22`\ [15:8] > + > +.. flat-table:: Sample 4x4 NV16_16_1 Image > + :header-rows: 0 > + :stub-columns: 0 > + > + * - start + 0: > + - Y'\ :sub:`00`\ [7:0] > + - Y'\ :sub:`00`\ [15:8] > + - Y'\ :sub:`01`\ [7:0] > + - Y'\ :sub:`01`\ [15:8] > + - Y'\ :sub:`02`\ [7:0] > + - Y'\ :sub:`02`\ [15:8] > + - Y'\ :sub:`03`\ [7:0] > + - Y'\ :sub:`03`\ [15:8] > + * - start + 8: > + - Y'\ :sub:`10`\ [7:0] > + - Y'\ :sub:`10`\ [15:8] > + - Y'\ :sub:`11`\ [7:0] > + - Y'\ :sub:`11`\ [15:8] > + - Y'\ :sub:`12`\ [7:0] > + - Y'\ :sub:`12`\ [15:8] > + - Y'\ :sub:`13`\ [7:0] > + - Y'\ :sub:`13`\ [15:8] > + * - start + 16: > + - Y'\ :sub:`20`\ [7:0] > + - Y'\ :sub:`20`\ [15:8] > + - Y'\ :sub:`21`\ [7:0] > + - Y'\ :sub:`21`\ [15:8] > + - Y'\ :sub:`22`\ [7:0] > + - Y'\ :sub:`22`\ [15:8] > + - Y'\ :sub:`23`\ [7:0] > + - Y'\ :sub:`23`\ [15:8] > + * - start + 24: > + - Y'\ :sub:`30`\ [7:0] > + - Y'\ :sub:`30`\ [15:8] > + - Y'\ :sub:`31`\ [7:0] > + - Y'\ :sub:`31`\ [15:8] > + - Y'\ :sub:`32`\ [7:0] > + - Y'\ :sub:`32`\ [15:8] > + - Y'\ :sub:`33`\ [7:0] > + - Y'\ :sub:`33`\ [15:8] > + * - start + 32: > + - Cb\ :sub:`00`\ [7:0] > + - Cb\ :sub:`00`\ [15:8] > + - Cr\ :sub:`00`\ [7:0] > + - Cr\ :sub:`00`\ [15:8] > + - Cb\ :sub:`02`\ [7:0] > + - Cb\ :sub:`02`\ [15:8] > + - Cr\ :sub:`02`\ [7:0] > + - Cr\ :sub:`02`\ [15:8] > + * - start + 40: > + - Cb\ :sub:`10`\ [7:0] > + - Cb\ :sub:`10`\ [15:8] > + - Cr\ :sub:`10`\ [7:0] > + - Cr\ :sub:`10`\ [15:8] > + - Cb\ :sub:`12`\ [7:0] > + - Cb\ :sub:`12`\ [15:8] > + - Cr\ :sub:`12`\ [7:0] > + - Cr\ :sub:`12`\ [15:8] > + * - start + 48: > + - Cb\ :sub:`20`\ [7:0] > + - Cb\ :sub:`20`\ [15:8] > + - Cr\ :sub:`20`\ [7:0] > + - Cr\ :sub:`20`\ [15:8] > + - Cb\ :sub:`22`\ [7:0] > + - Cb\ :sub:`22`\ [15:8] > + - Cr\ :sub:`22`\ [7:0] > + - Cr\ :sub:`22`\ [15:8] > + * - start + 56: > + - Cb\ :sub:`30`\ [7:0] > + - Cb\ :sub:`30`\ [15:8] > + - Cr\ :sub:`30`\ [7:0] > + - Cr\ :sub:`30`\ [15:8] > + - Cb\ :sub:`32`\ [7:0] > + - Cb\ :sub:`32`\ [15:8] > + - Cr\ :sub:`32`\ [7:0] > + - Cr\ :sub:`32`\ [15:8] > + > + > Fully Planar YUV Formats > ======================== > > diff --git a/include/uapi/linux/videodev2.h b/include/uapi/linux/videodev2.h > index cf9288d270c6..3c4609ff83d6 100644 > --- a/include/uapi/linux/videodev2.h > +++ b/include/uapi/linux/videodev2.h > @@ -616,6 +616,18 @@ struct v4l2_pix_format { > #define V4L2_PIX_FMT_NV24 v4l2_fourcc('N', 'V', '2', '4') /* 24 Y/CbCr 4:4:4 */ > #define V4L2_PIX_FMT_NV42 v4l2_fourcc('N', 'V', '4', '2') /* 24 Y/CrCb 4:4:4 */ > #define V4L2_PIX_FMT_HM12 v4l2_fourcc('H', 'M', '1', '2') /* 8 YUV 4:2:0 16x16 macroblocks */ > +#define V4L2_PIX_FMT_NV12_10_3 v4l2_fourcc('N', '0', '1', '2') /* 16 Y/CbCr 4:2:0 10b */ > +#define V4L2_PIX_FMT_NV21_10_3 v4l2_fourcc('N', '0', '2', '1') /* 16 Y/CrCb 4:2:0 10b */ > +#define V4L2_PIX_FMT_NV16_10_3 v4l2_fourcc('N', '0', '1', '6') /* 64/3 Y/CbCr 4:2:2 10b */ > +#define V4L2_PIX_FMT_NV61_10_3 v4l2_fourcc('N', '0', '6', '1') /* 64/3 Y/CrCb 4:2:2 10b */ > +#define V4L2_PIX_FMT_NV12_12_2 v4l2_fourcc('N', '2', '1', '2') /* 18 Y/CbCr 4:2:0 12b */ > +#define V4L2_PIX_FMT_NV21_12_2 v4l2_fourcc('N', '2', '2', '1') /* 18 Y/CrCb 4:2:0 12b */ > +#define V4L2_PIX_FMT_NV16_12_2 v4l2_fourcc('N', '2', '1', '6') /* 24 Y/CbCr 4:2:2 12b */ > +#define V4L2_PIX_FMT_NV61_12_2 v4l2_fourcc('N', '2', '6', '1') /* 24 Y/CrCb 4:2:2 12b */ > +#define V4L2_PIX_FMT_NV12_16_1 v4l2_fourcc('N', '6', '1', '2') /* 24 Y/CbCr 4:2:0 16b */ > +#define V4L2_PIX_FMT_NV21_16_1 v4l2_fourcc('N', '6', '2', '1') /* 24 Y/CrCb 4:2:0 16b */ > +#define V4L2_PIX_FMT_NV16_16_1 v4l2_fourcc('N', '6', '1', '6') /* 32 Y/CbCr 4:2:2 16b */ > +#define V4L2_PIX_FMT_NV61_16_1 v4l2_fourcc('N', '6', '6', '1') /* 32 Y/CrCb 4:2:2 16b */ > > /* two non contiguous planes - one Y, one Cr + Cb interleaved */ > #define V4L2_PIX_FMT_NV12M v4l2_fourcc('N', 'M', '1', '2') /* 12 Y/CbCr 4:2:0 */ >
diff --git a/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst b/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst index 7d4d39201a3f..4ac4c6a0290b 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst @@ -48,6 +48,11 @@ relationship between the luma and chroma line padding and stride. All components are stored with the same number of bits per component. +Formats with more than 8 bits per component pack, within each plane, multiple +samples in a word (padded as necessary to reach a multiple of 8 bits), which is +then stored in memory in little endian byte order. They are named with a suffix +indicating the number of bits per component and the number of samples per word. + .. flat-table:: Overview of Semi-Planar YUV Formats :header-rows: 1 :stub-columns: 0 @@ -70,7 +75,7 @@ All components are stored with the same number of bits per component. - 'NV21' - 8 - 4:2:0 - - Cr, Cr + - Cr, Cb - Yes - Linear * - V4L2_PIX_FMT_NV12M @@ -84,7 +89,7 @@ All components are stored with the same number of bits per component. - 'NM21' - 8 - 4:2:0 - - Cr, Cr + - Cr, Cb - No - Linear * - V4L2_PIX_FMT_NV12MT @@ -114,7 +119,7 @@ All components are stored with the same number of bits per component. - 'NV61' - 8 - 4:2:2 - - Cr, Cr + - Cr, Cb - Yes - Linear * - V4L2_PIX_FMT_NV16M @@ -128,7 +133,7 @@ All components are stored with the same number of bits per component. - 'NM61' - 8 - 4:2:2 - - Cr, Cr + - Cr, Cb - No - Linear * - V4L2_PIX_FMT_NV24 @@ -142,7 +147,91 @@ All components are stored with the same number of bits per component. - 'NV42' - 8 - 4:4:4 - - Cr, Cr + - Cr, Cb + - Yes + - Linear + * - V4L2_PIX_FMT_NV12_10_3 + - 'N012' + - 10 + - 4:2:0 + - Cb, Cr + - Yes + - Linear + * - V4L2_PIX_FMT_NV21_10_3 + - 'N061' + - 10 + - 4:2:0 + - Cr, Cb + - Yes + - Linear + * - V4L2_PIX_FMT_NV16_10_3 + - 'N016' + - 10 + - 4:2:2 + - Cb, Cr + - Yes + - Linear + * - V4L2_PIX_FMT_NV61_10_3 + - 'N061' + - 10 + - 4:2:2 + - Cr, Cb + - Yes + - Linear + * - V4L2_PIX_FMT_NV12_12_2 + - 'N212' + - 12 + - 4:2:0 + - Cb, Cr + - Yes + - Linear + * - V4L2_PIX_FMT_NV21_12_2 + - 'N261' + - 12 + - 4:2:0 + - Cr, Cb + - Yes + - Linear + * - V4L2_PIX_FMT_NV16_12_2 + - 'N216' + - 12 + - 4:2:2 + - Cb, Cr + - Yes + - Linear + * - V4L2_PIX_FMT_NV61_12_2 + - 'N261' + - 12 + - 4:2:2 + - Cr, Cb + - Yes + - Linear + * - V4L2_PIX_FMT_NV12_16_1 + - 'N612' + - 16 + - 4:2:0 + - Cb, Cr + - Yes + - Linear + * - V4L2_PIX_FMT_NV21_16_1 + - 'N661' + - 16 + - 4:2:0 + - Cr, Cb + - Yes + - Linear + * - V4L2_PIX_FMT_NV16_16_1 + - 'N616' + - 16 + - 4:2:2 + - Cb, Cr + - Yes + - Linear + * - V4L2_PIX_FMT_NV61_16_1 + - 'N661' + - 16 + - 4:2:2 + - Cr, Cb - Yes - Linear @@ -153,7 +242,6 @@ All components are stored with the same number of bits per component. disjoint .. [3] Macroblock size in pixels - **Color Sample Location:** Chroma samples are :ref:`interstitially sited<yuv-chroma-centered>` horizontally. @@ -463,6 +551,480 @@ number of lines as the luma plane. - Cr\ :sub:`33` +.. _V4L2-PIX-FMT-NV12-10-3: +.. _V4L2-PIX-FMT-NV21-10-3: +.. _V4L2-PIX-FMT-NV16-10-3: +.. _V4L2-PIX-FMT-NV61-10-3: + +NV12_10_3, NV21_10_3, NV16_10_3 and NV61_10_3 +--------------------------------------------- + +Semi-planar YUV 4:2:0 and 4:2:2 formats with 10 bits per component, stored with +3 samples packed in 4 bytes. + +Within a plane, 3 samples are packed in a 32-bit word, with 2 padding bits. +The bits are organized as follows for the first three samples of a luma line +and a chroma line. + +.. flat-table:: + :header-rows: 0 + :stub-columns: 0 + + * - 31:30 + - 29:20 + - 19:10 + - 9:0 + * - `-`\ [1:0] + - Y'\ :sub:`2`\ [9:0] + - Y'\ :sub:`1`\ [9:0] + - Y'\ :sub:`0`\ [9:0] + +.. flat-table:: + :header-rows: 0 + :stub-columns: 0 + + * - 31:30 + - 29:20 + - 19:10 + - 9:0 + * - `-`\ [1:0] + - Cb\ :sub:`2`\ [9:0] + - Cr\ :sub:`0`\ [9:0] + - Cb\ :sub:`0`\ [9:0] + +Words are then stored in memory in little endian format. Due to a chroma word +storing an odd number of samples, the image width must be a multiple of 6 +pixels. + +.. flat-table:: Sample 6x4 NV12_10_3 Image + :header-rows: 0 + :stub-columns: 0 + + * - start + 0: + - Y'\ :sub:`00`\ [7:0] + - Y'\ :sub:`01`\ [5:0] Y'\ :sub:`00`\ [9:8] + - Y'\ :sub:`02`\ [3:0] Y'\ :sub:`01`\ [9:6] + - `-`\ [1:0] Y'\ :sub:`02`\ [9:4] + - Y'\ :sub:`03`\ [7:0] + - Y'\ :sub:`04`\ [5:0] Y'\ :sub:`04`\ [9:8] + - Y'\ :sub:`05`\ [3:0] Y'\ :sub:`05`\ [9:6] + - `-`\ [1:0] Y'\ :sub:`05`\ [9:4] + * - start + 8: + - Y'\ :sub:`10`\ [7:0] + - Y'\ :sub:`11`\ [5:0] Y'\ :sub:`10`\ [9:8] + - Y'\ :sub:`12`\ [3:0] Y'\ :sub:`11`\ [9:6] + - `-`\ [1:0] Y'\ :sub:`12`\ [9:4] + - Y'\ :sub:`13`\ [7:0] + - Y'\ :sub:`14`\ [5:0] Y'\ :sub:`14`\ [9:8] + - Y'\ :sub:`15`\ [3:0] Y'\ :sub:`15`\ [9:6] + - `-`\ [1:0] Y'\ :sub:`15`\ [9:4] + * - start + 16: + - Y'\ :sub:`20`\ [7:0] + - Y'\ :sub:`21`\ [5:0] Y'\ :sub:`20`\ [9:8] + - Y'\ :sub:`22`\ [3:0] Y'\ :sub:`21`\ [9:6] + - `-`\ [1:0] Y'\ :sub:`22`\ [9:4] + - Y'\ :sub:`23`\ [7:0] + - Y'\ :sub:`24`\ [5:0] Y'\ :sub:`24`\ [9:8] + - Y'\ :sub:`25`\ [3:0] Y'\ :sub:`25`\ [9:6] + - `-`\ [1:0] Y'\ :sub:`25`\ [9:4] + * - start + 24: + - Y'\ :sub:`20`\ [7:0] + - Y'\ :sub:`21`\ [5:0] Y'\ :sub:`20`\ [9:8] + - Y'\ :sub:`22`\ [3:0] Y'\ :sub:`21`\ [9:6] + - `-`\ [1:0] Y'\ :sub:`22`\ [9:4] + - Y'\ :sub:`23`\ [7:0] + - Y'\ :sub:`24`\ [5:0] Y'\ :sub:`24`\ [9:8] + - Y'\ :sub:`25`\ [3:0] Y'\ :sub:`25`\ [9:6] + - `-`\ [1:0] Y'\ :sub:`25`\ [9:4] + * - start + 32: + - Cb\ :sub:`00`\ [7:0] + - Cr\ :sub:`00`\ [5:0] Cb\ :sub:`00`\ [9:8] + - Cb\ :sub:`02`\ [3:0] Cr\ :sub:`00`\ [9:6] + - `-`\ [1:0] Cb\ :sub:`02`\ [9:4] + - Cr\ :sub:`02`\ [7:0] + - Cb\ :sub:`04`\ [5:0] Cr\ :sub:`02`\ [9:8] + - Cr\ :sub:`04`\ [3:0] Cb\ :sub:`04`\ [9:6] + - `-`\ [1:0] Cr\ :sub:`04`\ [9:4] + * - start + 40: + - Cb\ :sub:`20`\ [7:0] + - Cr\ :sub:`20`\ [5:0] Cb\ :sub:`20`\ [9:8] + - Cb\ :sub:`22`\ [3:0] Cr\ :sub:`20`\ [9:6] + - `-`\ [1:0] Cb\ :sub:`22`\ [9:4] + - Cr\ :sub:`22`\ [7:0] + - Cb\ :sub:`24`\ [5:0] Cr\ :sub:`22`\ [9:8] + - Cr\ :sub:`24`\ [3:0] Cb\ :sub:`24`\ [9:6] + - `-`\ [1:0] Cr\ :sub:`24`\ [9:4] + +.. flat-table:: Sample 6x4 NV16_10_3 Image + :header-rows: 0 + :stub-columns: 0 + + * - start + 0: + - Y'\ :sub:`00`\ [7:0] + - Y'\ :sub:`01`\ [5:0] Y'\ :sub:`00`\ [9:8] + - Y'\ :sub:`02`\ [3:0] Y'\ :sub:`01`\ [9:6] + - `-`\ [1:0] Y'\ :sub:`02`\ [9:4] + - Y'\ :sub:`03`\ [7:0] + - Y'\ :sub:`04`\ [5:0] Y'\ :sub:`04`\ [9:8] + - Y'\ :sub:`05`\ [3:0] Y'\ :sub:`05`\ [9:6] + - `-`\ [1:0] Y'\ :sub:`05`\ [9:4] + * - start + 8: + - Y'\ :sub:`10`\ [7:0] + - Y'\ :sub:`11`\ [5:0] Y'\ :sub:`10`\ [9:8] + - Y'\ :sub:`12`\ [3:0] Y'\ :sub:`11`\ [9:6] + - `-`\ [1:0] Y'\ :sub:`12`\ [9:4] + - Y'\ :sub:`13`\ [7:0] + - Y'\ :sub:`14`\ [5:0] Y'\ :sub:`14`\ [9:8] + - Y'\ :sub:`15`\ [3:0] Y'\ :sub:`15`\ [9:6] + - `-`\ [1:0] Y'\ :sub:`15`\ [9:4] + * - start + 16: + - Y'\ :sub:`20`\ [7:0] + - Y'\ :sub:`21`\ [5:0] Y'\ :sub:`20`\ [9:8] + - Y'\ :sub:`22`\ [3:0] Y'\ :sub:`21`\ [9:6] + - `-`\ [1:0] Y'\ :sub:`22`\ [9:4] + - Y'\ :sub:`23`\ [7:0] + - Y'\ :sub:`24`\ [5:0] Y'\ :sub:`24`\ [9:8] + - Y'\ :sub:`25`\ [3:0] Y'\ :sub:`25`\ [9:6] + - `-`\ [1:0] Y'\ :sub:`25`\ [9:4] + * - start + 24: + - Y'\ :sub:`20`\ [7:0] + - Y'\ :sub:`21`\ [5:0] Y'\ :sub:`20`\ [9:8] + - Y'\ :sub:`22`\ [3:0] Y'\ :sub:`21`\ [9:6] + - `-`\ [1:0] Y'\ :sub:`22`\ [9:4] + - Y'\ :sub:`23`\ [7:0] + - Y'\ :sub:`24`\ [5:0] Y'\ :sub:`24`\ [9:8] + - Y'\ :sub:`25`\ [3:0] Y'\ :sub:`25`\ [9:6] + - `-`\ [1:0] Y'\ :sub:`25`\ [9:4] + * - start + 32: + - Cb\ :sub:`00`\ [7:0] + - Cr\ :sub:`00`\ [5:0] Cb\ :sub:`00`\ [9:8] + - Cb\ :sub:`02`\ [3:0] Cr\ :sub:`00`\ [9:6] + - `-`\ [1:0] Cb\ :sub:`02`\ [9:4] + - Cr\ :sub:`02`\ [7:0] + - Cb\ :sub:`04`\ [5:0] Cr\ :sub:`02`\ [9:8] + - Cr\ :sub:`04`\ [3:0] Cb\ :sub:`04`\ [9:6] + - `-`\ [1:0] Cr\ :sub:`04`\ [9:4] + * - start + 40: + - Cb\ :sub:`10`\ [7:0] + - Cr\ :sub:`10`\ [5:0] Cb\ :sub:`10`\ [9:8] + - Cb\ :sub:`12`\ [3:0] Cr\ :sub:`10`\ [9:6] + - `-`\ [1:0] Cb\ :sub:`12`\ [9:4] + - Cr\ :sub:`12`\ [7:0] + - Cb\ :sub:`14`\ [5:0] Cr\ :sub:`12`\ [9:8] + - Cr\ :sub:`14`\ [3:0] Cb\ :sub:`14`\ [9:6] + - `-`\ [1:0] Cr\ :sub:`14`\ [9:4] + * - start + 48: + - Cb\ :sub:`20`\ [7:0] + - Cr\ :sub:`20`\ [5:0] Cb\ :sub:`20`\ [9:8] + - Cb\ :sub:`22`\ [3:0] Cr\ :sub:`20`\ [9:6] + - `-`\ [1:0] Cb\ :sub:`22`\ [9:4] + - Cr\ :sub:`22`\ [7:0] + - Cb\ :sub:`24`\ [5:0] Cr\ :sub:`22`\ [9:8] + - Cr\ :sub:`24`\ [3:0] Cb\ :sub:`24`\ [9:6] + - `-`\ [1:0] Cr\ :sub:`24`\ [9:4] + * - start + 56: + - Cb\ :sub:`30`\ [7:0] + - Cr\ :sub:`30`\ [5:0] Cb\ :sub:`30`\ [9:8] + - Cb\ :sub:`32`\ [3:0] Cr\ :sub:`30`\ [9:6] + - `-`\ [1:0] Cb\ :sub:`32`\ [9:4] + - Cr\ :sub:`32`\ [7:0] + - Cb\ :sub:`34`\ [5:0] Cr\ :sub:`32`\ [9:8] + - Cr\ :sub:`34`\ [3:0] Cb\ :sub:`34`\ [9:6] + - `-`\ [1:0] Cr\ :sub:`34`\ [9:4] + + +.. _V4L2-PIX-FMT-NV12-12-2: +.. _V4L2-PIX-FMT-NV21-12-2: +.. _V4L2-PIX-FMT-NV16-12-2: +.. _V4L2-PIX-FMT-NV61-12-2: + +NV12_12_2, NV21_12_2, NV16_12_2 and NV61_12_2 +--------------------------------------------- + +Semi-planar YUV 4:2:0 and 4:2:2 formats with 12 bits per component, stored with +2 samples packed in 3 bytes. + +Within a plane, 2 samples are packed in a 24-bit word, with no padding bits. +The bits are organized as follows for the first two samples of a luma line +and a chroma line. + +.. flat-table:: + :header-rows: 0 + :stub-columns: 0 + + * - 23:12 + - 11:0 + * - Y'\ :sub:`1`\ [11:0] + - Y'\ :sub:`0`\ [11:0] + +.. flat-table:: + :header-rows: 0 + :stub-columns: 0 + + * - 23:12 + - 11:0 + * - Cr\ :sub:`0`\ [11:0] + - Cb\ :sub:`0`\ [11:0] + +Words are then stored in memory in little endian format. + +.. flat-table:: Sample 4x4 NV12_12_2 Image + :header-rows: 0 + :stub-columns: 0 + + * - start + 0: + - Y'\ :sub:`00`\ [7:0] + - Y'\ :sub:`01`\ [3:0] Y'\ :sub:`00`\ [11:8] + - Y'\ :sub:`01`\ [11:4] + - Y'\ :sub:`02`\ [7:0] + - Y'\ :sub:`03`\ [3:0] Y'\ :sub:`02`\ [11:8] + - Y'\ :sub:`03`\ [11:4] + * - start + 6: + - Y'\ :sub:`10`\ [7:0] + - Y'\ :sub:`11`\ [3:0] Y'\ :sub:`10`\ [11:8] + - Y'\ :sub:`11`\ [11:4] + - Y'\ :sub:`12`\ [7:0] + - Y'\ :sub:`13`\ [3:0] Y'\ :sub:`12`\ [11:8] + - Y'\ :sub:`13`\ [11:4] + * - start + 12: + - Y'\ :sub:`20`\ [7:0] + - Y'\ :sub:`21`\ [3:0] Y'\ :sub:`20`\ [11:8] + - Y'\ :sub:`21`\ [11:4] + - Y'\ :sub:`22`\ [7:0] + - Y'\ :sub:`23`\ [3:0] Y'\ :sub:`22`\ [11:8] + - Y'\ :sub:`23`\ [11:4] + * - start + 18: + - Y'\ :sub:`30`\ [7:0] + - Y'\ :sub:`31`\ [3:0] Y'\ :sub:`30`\ [11:8] + - Y'\ :sub:`31`\ [11:4] + - Y'\ :sub:`32`\ [7:0] + - Y'\ :sub:`33`\ [3:0] Y'\ :sub:`32`\ [11:8] + - Y'\ :sub:`33`\ [11:4] + * - start + 24: + - Cb\ :sub:`00`\ [7:0] + - Cr\ :sub:`00`\ [3:0] Cb\ :sub:`00`\ [11:8] + - Cr\ :sub:`00`\ [11:4] + - Cb\ :sub:`02`\ [7:0] + - Cr\ :sub:`02`\ [3:0] Cb\ :sub:`02`\ [11:8] + - Cr\ :sub:`02`\ [11:4] + * - start + 30: + - Cb\ :sub:`20`\ [7:0] + - Cr\ :sub:`20`\ [3:0] Cb\ :sub:`20`\ [11:8] + - Cr\ :sub:`20`\ [11:4] + - Cb\ :sub:`22`\ [7:0] + - Cr\ :sub:`22`\ [3:0] Cb\ :sub:`22`\ [11:8] + - Cr\ :sub:`22`\ [11:4] + +.. flat-table:: Sample 4x4 NV16_12_2 Image + :header-rows: 0 + :stub-columns: 0 + + * - start + 0: + - Y'\ :sub:`00`\ [7:0] + - Y'\ :sub:`01`\ [3:0] Y'\ :sub:`00`\ [11:8] + - Y'\ :sub:`01`\ [11:4] + - Y'\ :sub:`02`\ [7:0] + - Y'\ :sub:`03`\ [3:0] Y'\ :sub:`02`\ [11:8] + - Y'\ :sub:`03`\ [11:4] + * - start + 6: + - Y'\ :sub:`10`\ [7:0] + - Y'\ :sub:`11`\ [3:0] Y'\ :sub:`10`\ [11:8] + - Y'\ :sub:`11`\ [11:4] + - Y'\ :sub:`12`\ [7:0] + - Y'\ :sub:`13`\ [3:0] Y'\ :sub:`12`\ [11:8] + - Y'\ :sub:`13`\ [11:4] + * - start + 12: + - Y'\ :sub:`20`\ [7:0] + - Y'\ :sub:`21`\ [3:0] Y'\ :sub:`20`\ [11:8] + - Y'\ :sub:`21`\ [11:4] + - Y'\ :sub:`22`\ [7:0] + - Y'\ :sub:`23`\ [3:0] Y'\ :sub:`22`\ [11:8] + - Y'\ :sub:`23`\ [11:4] + * - start + 18: + - Y'\ :sub:`30`\ [7:0] + - Y'\ :sub:`31`\ [3:0] Y'\ :sub:`30`\ [11:8] + - Y'\ :sub:`31`\ [11:4] + - Y'\ :sub:`32`\ [7:0] + - Y'\ :sub:`33`\ [3:0] Y'\ :sub:`32`\ [11:8] + - Y'\ :sub:`33`\ [11:4] + * - start + 24: + - Cb\ :sub:`00`\ [7:0] + - Cr\ :sub:`00`\ [3:0] Cb\ :sub:`00`\ [11:8] + - Cr\ :sub:`00`\ [11:4] + - Cb\ :sub:`02`\ [7:0] + - Cr\ :sub:`02`\ [3:0] Cb\ :sub:`02`\ [11:8] + - Cr\ :sub:`02`\ [11:4] + * - start + 30: + - Cb\ :sub:`10`\ [7:0] + - Cr\ :sub:`10`\ [3:0] Cb\ :sub:`10`\ [11:8] + - Cr\ :sub:`10`\ [11:4] + - Cb\ :sub:`12`\ [7:0] + - Cr\ :sub:`12`\ [3:0] Cb\ :sub:`12`\ [11:8] + - Cr\ :sub:`12`\ [11:4] + * - start + 36: + - Cb\ :sub:`20`\ [7:0] + - Cr\ :sub:`20`\ [3:0] Cb\ :sub:`20`\ [11:8] + - Cr\ :sub:`20`\ [11:4] + - Cb\ :sub:`22`\ [7:0] + - Cr\ :sub:`22`\ [3:0] Cb\ :sub:`22`\ [11:8] + - Cr\ :sub:`22`\ [11:4] + * - start + 42: + - Cb\ :sub:`30`\ [7:0] + - Cr\ :sub:`30`\ [3:0] Cb\ :sub:`30`\ [11:8] + - Cr\ :sub:`30`\ [11:4] + - Cb\ :sub:`32`\ [7:0] + - Cr\ :sub:`32`\ [3:0] Cb\ :sub:`32`\ [11:8] + - Cr\ :sub:`32`\ [11:4] + + +.. _V4L2-PIX-FMT-NV12-16-1: +.. _V4L2-PIX-FMT-NV21-16-1: +.. _V4L2-PIX-FMT-NV16-16-1: +.. _V4L2-PIX-FMT-NV61-16-1: + +NV12_16_1, NV21_16_1, NV16_16_1 and NV61_16_1 +--------------------------------------------- + +Semi-planar YUV 4:2:0 and 4:2:2 formats with 16 bits per component. 16-bit +samples are stored in memory in little endian format. + +.. flat-table:: Sample 4x4 NV12_16_1 Image + :header-rows: 0 + :stub-columns: 0 + + * - start + 0: + - Y'\ :sub:`00`\ [7:0] + - Y'\ :sub:`00`\ [15:8] + - Y'\ :sub:`01`\ [7:0] + - Y'\ :sub:`01`\ [15:8] + - Y'\ :sub:`02`\ [7:0] + - Y'\ :sub:`02`\ [15:8] + - Y'\ :sub:`03`\ [7:0] + - Y'\ :sub:`03`\ [15:8] + * - start + 8: + - Y'\ :sub:`10`\ [7:0] + - Y'\ :sub:`10`\ [15:8] + - Y'\ :sub:`11`\ [7:0] + - Y'\ :sub:`11`\ [15:8] + - Y'\ :sub:`12`\ [7:0] + - Y'\ :sub:`12`\ [15:8] + - Y'\ :sub:`13`\ [7:0] + - Y'\ :sub:`13`\ [15:8] + * - start + 16: + - Y'\ :sub:`20`\ [7:0] + - Y'\ :sub:`20`\ [15:8] + - Y'\ :sub:`21`\ [7:0] + - Y'\ :sub:`21`\ [15:8] + - Y'\ :sub:`22`\ [7:0] + - Y'\ :sub:`22`\ [15:8] + - Y'\ :sub:`23`\ [7:0] + - Y'\ :sub:`23`\ [15:8] + * - start + 24: + - Y'\ :sub:`30`\ [7:0] + - Y'\ :sub:`30`\ [15:8] + - Y'\ :sub:`31`\ [7:0] + - Y'\ :sub:`31`\ [15:8] + - Y'\ :sub:`32`\ [7:0] + - Y'\ :sub:`32`\ [15:8] + - Y'\ :sub:`33`\ [7:0] + - Y'\ :sub:`33`\ [15:8] + * - start + 32: + - Cb\ :sub:`00`\ [7:0] + - Cb\ :sub:`00`\ [15:8] + - Cr\ :sub:`00`\ [7:0] + - Cr\ :sub:`00`\ [15:8] + - Cb\ :sub:`02`\ [7:0] + - Cb\ :sub:`02`\ [15:8] + - Cr\ :sub:`02`\ [7:0] + - Cr\ :sub:`02`\ [15:8] + * - start + 40: + - Cb\ :sub:`20`\ [7:0] + - Cb\ :sub:`20`\ [15:8] + - Cr\ :sub:`20`\ [7:0] + - Cr\ :sub:`20`\ [15:8] + - Cb\ :sub:`22`\ [7:0] + - Cb\ :sub:`22`\ [15:8] + - Cr\ :sub:`22`\ [7:0] + - Cr\ :sub:`22`\ [15:8] + +.. flat-table:: Sample 4x4 NV16_16_1 Image + :header-rows: 0 + :stub-columns: 0 + + * - start + 0: + - Y'\ :sub:`00`\ [7:0] + - Y'\ :sub:`00`\ [15:8] + - Y'\ :sub:`01`\ [7:0] + - Y'\ :sub:`01`\ [15:8] + - Y'\ :sub:`02`\ [7:0] + - Y'\ :sub:`02`\ [15:8] + - Y'\ :sub:`03`\ [7:0] + - Y'\ :sub:`03`\ [15:8] + * - start + 8: + - Y'\ :sub:`10`\ [7:0] + - Y'\ :sub:`10`\ [15:8] + - Y'\ :sub:`11`\ [7:0] + - Y'\ :sub:`11`\ [15:8] + - Y'\ :sub:`12`\ [7:0] + - Y'\ :sub:`12`\ [15:8] + - Y'\ :sub:`13`\ [7:0] + - Y'\ :sub:`13`\ [15:8] + * - start + 16: + - Y'\ :sub:`20`\ [7:0] + - Y'\ :sub:`20`\ [15:8] + - Y'\ :sub:`21`\ [7:0] + - Y'\ :sub:`21`\ [15:8] + - Y'\ :sub:`22`\ [7:0] + - Y'\ :sub:`22`\ [15:8] + - Y'\ :sub:`23`\ [7:0] + - Y'\ :sub:`23`\ [15:8] + * - start + 24: + - Y'\ :sub:`30`\ [7:0] + - Y'\ :sub:`30`\ [15:8] + - Y'\ :sub:`31`\ [7:0] + - Y'\ :sub:`31`\ [15:8] + - Y'\ :sub:`32`\ [7:0] + - Y'\ :sub:`32`\ [15:8] + - Y'\ :sub:`33`\ [7:0] + - Y'\ :sub:`33`\ [15:8] + * - start + 32: + - Cb\ :sub:`00`\ [7:0] + - Cb\ :sub:`00`\ [15:8] + - Cr\ :sub:`00`\ [7:0] + - Cr\ :sub:`00`\ [15:8] + - Cb\ :sub:`02`\ [7:0] + - Cb\ :sub:`02`\ [15:8] + - Cr\ :sub:`02`\ [7:0] + - Cr\ :sub:`02`\ [15:8] + * - start + 40: + - Cb\ :sub:`10`\ [7:0] + - Cb\ :sub:`10`\ [15:8] + - Cr\ :sub:`10`\ [7:0] + - Cr\ :sub:`10`\ [15:8] + - Cb\ :sub:`12`\ [7:0] + - Cb\ :sub:`12`\ [15:8] + - Cr\ :sub:`12`\ [7:0] + - Cr\ :sub:`12`\ [15:8] + * - start + 48: + - Cb\ :sub:`20`\ [7:0] + - Cb\ :sub:`20`\ [15:8] + - Cr\ :sub:`20`\ [7:0] + - Cr\ :sub:`20`\ [15:8] + - Cb\ :sub:`22`\ [7:0] + - Cb\ :sub:`22`\ [15:8] + - Cr\ :sub:`22`\ [7:0] + - Cr\ :sub:`22`\ [15:8] + * - start + 56: + - Cb\ :sub:`30`\ [7:0] + - Cb\ :sub:`30`\ [15:8] + - Cr\ :sub:`30`\ [7:0] + - Cr\ :sub:`30`\ [15:8] + - Cb\ :sub:`32`\ [7:0] + - Cb\ :sub:`32`\ [15:8] + - Cr\ :sub:`32`\ [7:0] + - Cr\ :sub:`32`\ [15:8] + + Fully Planar YUV Formats ======================== diff --git a/include/uapi/linux/videodev2.h b/include/uapi/linux/videodev2.h index cf9288d270c6..3c4609ff83d6 100644 --- a/include/uapi/linux/videodev2.h +++ b/include/uapi/linux/videodev2.h @@ -616,6 +616,18 @@ struct v4l2_pix_format { #define V4L2_PIX_FMT_NV24 v4l2_fourcc('N', 'V', '2', '4') /* 24 Y/CbCr 4:4:4 */ #define V4L2_PIX_FMT_NV42 v4l2_fourcc('N', 'V', '4', '2') /* 24 Y/CrCb 4:4:4 */ #define V4L2_PIX_FMT_HM12 v4l2_fourcc('H', 'M', '1', '2') /* 8 YUV 4:2:0 16x16 macroblocks */ +#define V4L2_PIX_FMT_NV12_10_3 v4l2_fourcc('N', '0', '1', '2') /* 16 Y/CbCr 4:2:0 10b */ +#define V4L2_PIX_FMT_NV21_10_3 v4l2_fourcc('N', '0', '2', '1') /* 16 Y/CrCb 4:2:0 10b */ +#define V4L2_PIX_FMT_NV16_10_3 v4l2_fourcc('N', '0', '1', '6') /* 64/3 Y/CbCr 4:2:2 10b */ +#define V4L2_PIX_FMT_NV61_10_3 v4l2_fourcc('N', '0', '6', '1') /* 64/3 Y/CrCb 4:2:2 10b */ +#define V4L2_PIX_FMT_NV12_12_2 v4l2_fourcc('N', '2', '1', '2') /* 18 Y/CbCr 4:2:0 12b */ +#define V4L2_PIX_FMT_NV21_12_2 v4l2_fourcc('N', '2', '2', '1') /* 18 Y/CrCb 4:2:0 12b */ +#define V4L2_PIX_FMT_NV16_12_2 v4l2_fourcc('N', '2', '1', '6') /* 24 Y/CbCr 4:2:2 12b */ +#define V4L2_PIX_FMT_NV61_12_2 v4l2_fourcc('N', '2', '6', '1') /* 24 Y/CrCb 4:2:2 12b */ +#define V4L2_PIX_FMT_NV12_16_1 v4l2_fourcc('N', '6', '1', '2') /* 24 Y/CbCr 4:2:0 16b */ +#define V4L2_PIX_FMT_NV21_16_1 v4l2_fourcc('N', '6', '2', '1') /* 24 Y/CrCb 4:2:0 16b */ +#define V4L2_PIX_FMT_NV16_16_1 v4l2_fourcc('N', '6', '1', '6') /* 32 Y/CbCr 4:2:2 16b */ +#define V4L2_PIX_FMT_NV61_16_1 v4l2_fourcc('N', '6', '6', '1') /* 32 Y/CrCb 4:2:2 16b */ /* two non contiguous planes - one Y, one Cr + Cb interleaved */ #define V4L2_PIX_FMT_NV12M v4l2_fourcc('N', 'M', '1', '2') /* 12 Y/CbCr 4:2:0 */
Add semi-planar YUV formats with 10, 12 and 16 bits per components, in both 4:2:0 (NV12) and 4:2:2 (NV16) subsampling, and with both chroma orderings. They are used by the Xilinx Video Frame Buffer Read/Write IP cores. Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com> --- Changes since v2: - Replace 'Cr, Cr' with 'Cr, Cb' --- .../media/v4l/pixfmt-yuv-planar.rst | 574 +++++++++++++++++- include/uapi/linux/videodev2.h | 12 + 2 files changed, 580 insertions(+), 6 deletions(-)