61 lines
1.9 KiB
ReStructuredText
Executable file
61 lines
1.9 KiB
ReStructuredText
Executable file
.. -*- coding: utf-8; mode: rst -*-
|
|
|
|
.. _V4L2-PIX-FMT-NV12MT:
|
|
|
|
****************************
|
|
V4L2_PIX_FMT_NV12MT ('TM12')
|
|
****************************
|
|
|
|
Formats with ½ horizontal and vertical chroma resolution. This format
|
|
has two planes - one for luminance and one for chrominance. Chroma
|
|
samples are interleaved. The difference to ``V4L2_PIX_FMT_NV12`` is the
|
|
memory layout. Pixels are grouped in macroblocks of 64x32 size. The
|
|
order of macroblocks in memory is also not standard.
|
|
|
|
|
|
Description
|
|
===========
|
|
|
|
This is the two-plane versions of the YUV 4:2:0 format where data is
|
|
grouped into 64x32 macroblocks. The three components are separated into
|
|
two sub-images or planes. The Y plane has one byte per pixel and pixels
|
|
are grouped into 64x32 macroblocks. The CbCr plane has the same width,
|
|
in bytes, as the Y plane (and the image), but is half as tall in pixels.
|
|
The chroma plane is also grouped into 64x32 macroblocks.
|
|
|
|
Width of the buffer has to be aligned to the multiple of 128, and height
|
|
alignment is 32. Every four adjacent buffers - two horizontally and two
|
|
vertically are grouped together and are located in memory in Z or
|
|
flipped Z order.
|
|
|
|
Layout of macroblocks in memory is presented in the following figure.
|
|
|
|
|
|
.. _nv12mt:
|
|
|
|
.. kernel-figure:: nv12mt.svg
|
|
:alt: nv12mt.svg
|
|
:align: center
|
|
|
|
V4L2_PIX_FMT_NV12MT macroblock Z shape memory layout
|
|
|
|
The requirement that width is multiple of 128 is implemented because,
|
|
the Z shape cannot be cut in half horizontally. In case the vertical
|
|
resolution of macroblocks is odd then the last row of macroblocks is
|
|
arranged in a linear order.
|
|
|
|
In case of chroma the layout is identical. Cb and Cr samples are
|
|
interleaved. Height of the buffer is aligned to 32.
|
|
|
|
|
|
.. _nv12mt_ex:
|
|
|
|
.. kernel-figure:: nv12mt_example.svg
|
|
:alt: nv12mt_example.svg
|
|
:align: center
|
|
|
|
Example V4L2_PIX_FMT_NV12MT memory layout of macroblocks
|
|
|
|
Memory layout of macroblocks of ``V4L2_PIX_FMT_NV12MT`` format in most
|
|
extreme case.
|