Documentation/userspace-api/media/v4l/pixfmt-mtisp-sbggr12f.rst

.. SPDX-License-Identifier: GPL-2.0

.. _v4l2-pix-fmt-mtisp-sbggr12f:
.. _v4l2-pix-fmt-mtisp-sgbrg12f:
.. _v4l2-pix-fmt-mtisp-sgrbg12f:
.. _v4l2-pix-fmt-mtisp-srggb12f:

*******************************
V4L2_PIX_FMT_MTISP_SBGGR12F ('MFBC'), V4L2_PIX_FMT_MTISP_SGBRG12F('MFGC'), V4L2_PIX_FMT_MTISP_SGRBG12F('MFgC'), V4L2_PIX_FMT_MTISP_SRGGB12F('MFRC')
*******************************

12-bit Packed Full-G Bayer formats.

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

These four pixel formats are used by Mediatek ISP P1.
This is a packed format with a depth of 12 bits per sample with every 4 pixels.
Full-G means 1 more pixel for green channel every 2 pixels.
The least significant byte is stored at lower memory addresses (little-endian).
The RGB byte order follows raw sRGB / Bayer format from sensor. They are conventionally
described as GRGR... BGBG..., RGRG... GBGB..., etc. Below is an example of conventional
RGB byte order BGGR.

**Bit-packed representation.**

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

    * - B\ :sub:`00`
      - FG\ :sub:`01`
      - G\ :sub:`02`
      - B\ :sub:`03`
      - FG\ :sub:`04`
      - G\ :sub:`05`
    * - G\ :sub:`10`
      - R\ :sub:`11`
      - FG\ :sub:`12`
      - G\ :sub:`13`
      - R\ :sub:`14`
      - FG\ :sub:`15`

**Byte Order.**
Each cell is one byte.

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

    * - start + 0:
      - B\ :sub:`00low bits 7--0`
      - FG\ :sub:`01low bits 3--0`\ (bits 7--4) B\ :sub:`00high bits 11--8`\ (bits 3--0)
    * - start + 2:
      - FG\ :sub:`01high bits 7--0`
      - G\ :sub:`02low bits 7--0`
    * - start + 4:
      - B\ :sub:`03low bits 3--0`\ (bits 7--4) G\ :sub:`02high bits 11--8`\ (bits 3--0)
      - B\ :sub:`03high bits 7--0`
    * - start + 6:
      - FG\ :sub:`04low bits 7--0`
      - G\ :sub:`05low bits 3--0`\ (bits 7--4) FG\ :sub:`04high bits 11--8`\ (bits 3--0)
    * - start + 8:
      - G\ :sub:`05high bits 7--0`
      -
    * - start + 10:
      - G\ :sub:`10low bits 7--0`
      - R\ :sub:`11low bits 3--0`\ (bits 7--4) G\ :sub:`10high bits 11--8`\ (bits 3--0)
    * - start + 12:
      - R\ :sub:`11high bits 7--0`
      - FG\ :sub:`12low bits 7--0`
    * - start + 14:
      - G\ :sub:`13low bits 3--0`\ (bits 7--4) FG\ :sub:`12high bits 11--8`\ (bits 3--0)
      - G\ :sub:`13high bits 7--0`
    * - start + 16:
      - R\ :sub:`14low bits 7--0`
      - FG\ :sub:`15low bits 3--0`\ (bits 7--4) R\ :sub:`14high bits 11--8`\ (bits 3--0)
    * - start + 18:
      - FG\ :sub:`15high bits 7--0`
      -
    * - start + 20:
      - B\ :sub:`20low bits 7--0`
      - FG\ :sub:`21low bits 3--0`\ (bits 7--4) B\ :sub:`20high bits 11--8`\ (bits 3--0)
    * - start + 22:
      - FG\ :sub:`21high bits 7--0`
      - G\ :sub:`22low bits 7--0`
    * - start + 24:
      - B\ :sub:`23low bits 3--0`\ (bits 7--4) G\ :sub:`22high bits 11--8`\ (bits 3--0)
      - B\ :sub:`23high bits 7--0`
    * - start + 26:
      - FG\ :sub:`24low bits 7--0`
      - G\ :sub:`25low bits 3--0`\ (bits 7--4) FG\ :sub:`24high bits 11--8`\ (bits 3--0)
    * - start + 28:
      - G\ :sub:`25high bits 7--0`
      -
    * - start + 30:
      - G\ :sub:`30low bits 7--0`
      - R\ :sub:`31low bits 3--0`\ (bits 7--4) G\ :sub:`30high bits 11--8`\ (bits 3--0)
    * - start + 32:
      - R\ :sub:`31high bits 7--0`
      - FG\ :sub:`32low bits 7--0`
    * - start + 34:
      - G\ :sub:`33low bits 3--0`\ (bits 7--4) FG\ :sub:`32high bits 11--8`\ (bits 3--0)
      - G\ :sub:`33high bits 7--0`
    * - start + 36:
      - R\ :sub:`34low bits 7--0`
      - FG\ :sub:`35low bits 3--0`\ (bits 7--4) R\ :sub:`34high bits 11--8`\ (bits 3--0)
    * - start + 38:
      - FG\ :sub:`35high bits 7--0`
      -