xref: /openbmc/linux/Documentation/userspace-api/media/v4l/pixfmt-srggb12.rst (revision cbecf716ca618fd44feda6bd9a64a8179d031fc5)
1*059b1c5bSMauro Carvalho Chehab.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
254f38fcaSMauro Carvalho Chehab
354f38fcaSMauro Carvalho Chehab.. _V4L2-PIX-FMT-SRGGB12:
454f38fcaSMauro Carvalho Chehab.. _v4l2-pix-fmt-sbggr12:
554f38fcaSMauro Carvalho Chehab.. _v4l2-pix-fmt-sgbrg12:
654f38fcaSMauro Carvalho Chehab.. _v4l2-pix-fmt-sgrbg12:
754f38fcaSMauro Carvalho Chehab
854f38fcaSMauro Carvalho Chehab
954f38fcaSMauro Carvalho Chehab***************************************************************************************************************************
1054f38fcaSMauro Carvalho ChehabV4L2_PIX_FMT_SRGGB12 ('RG12'), V4L2_PIX_FMT_SGRBG12 ('BA12'), V4L2_PIX_FMT_SGBRG12 ('GB12'), V4L2_PIX_FMT_SBGGR12 ('BG12'),
1154f38fcaSMauro Carvalho Chehab***************************************************************************************************************************
1254f38fcaSMauro Carvalho Chehab
1354f38fcaSMauro Carvalho Chehab
1454f38fcaSMauro Carvalho ChehabV4L2_PIX_FMT_SGRBG12
1554f38fcaSMauro Carvalho ChehabV4L2_PIX_FMT_SGBRG12
1654f38fcaSMauro Carvalho ChehabV4L2_PIX_FMT_SBGGR12
1754f38fcaSMauro Carvalho Chehab12-bit Bayer formats expanded to 16 bits
1854f38fcaSMauro Carvalho Chehab
1954f38fcaSMauro Carvalho Chehab
2054f38fcaSMauro Carvalho ChehabDescription
2154f38fcaSMauro Carvalho Chehab===========
2254f38fcaSMauro Carvalho Chehab
2354f38fcaSMauro Carvalho ChehabThese four pixel formats are raw sRGB / Bayer formats with 12 bits per
2454f38fcaSMauro Carvalho Chehabcolour. Each colour component is stored in a 16-bit word, with 4 unused
2554f38fcaSMauro Carvalho Chehabhigh bits filled with zeros. Each n-pixel row contains n/2 green samples
2654f38fcaSMauro Carvalho Chehaband n/2 blue or red samples, with alternating red and blue rows. Bytes
2754f38fcaSMauro Carvalho Chehabare stored in memory in little endian order. They are conventionally
2854f38fcaSMauro Carvalho Chehabdescribed as GRGR... BGBG..., RGRG... GBGB..., etc. Below is an example
2954f38fcaSMauro Carvalho Chehabof a small V4L2_PIX_FMT_SBGGR12 image:
3054f38fcaSMauro Carvalho Chehab
3154f38fcaSMauro Carvalho Chehab**Byte Order.**
3254f38fcaSMauro Carvalho ChehabEach cell is one byte, the 4 most significant bits in the high bytes are
3354f38fcaSMauro Carvalho Chehab0.
3454f38fcaSMauro Carvalho Chehab
3554f38fcaSMauro Carvalho Chehab
3654f38fcaSMauro Carvalho Chehab
3754f38fcaSMauro Carvalho Chehab
3854f38fcaSMauro Carvalho Chehab.. flat-table::
3954f38fcaSMauro Carvalho Chehab    :header-rows:  0
4054f38fcaSMauro Carvalho Chehab    :stub-columns: 0
4154f38fcaSMauro Carvalho Chehab
4254f38fcaSMauro Carvalho Chehab    * - start + 0:
4354f38fcaSMauro Carvalho Chehab      - B\ :sub:`00low`
4454f38fcaSMauro Carvalho Chehab      - B\ :sub:`00high`
4554f38fcaSMauro Carvalho Chehab      - G\ :sub:`01low`
4654f38fcaSMauro Carvalho Chehab      - G\ :sub:`01high`
4754f38fcaSMauro Carvalho Chehab      - B\ :sub:`02low`
4854f38fcaSMauro Carvalho Chehab      - B\ :sub:`02high`
4954f38fcaSMauro Carvalho Chehab      - G\ :sub:`03low`
5054f38fcaSMauro Carvalho Chehab      - G\ :sub:`03high`
5154f38fcaSMauro Carvalho Chehab    * - start + 8:
5254f38fcaSMauro Carvalho Chehab      - G\ :sub:`10low`
5354f38fcaSMauro Carvalho Chehab      - G\ :sub:`10high`
5454f38fcaSMauro Carvalho Chehab      - R\ :sub:`11low`
5554f38fcaSMauro Carvalho Chehab      - R\ :sub:`11high`
5654f38fcaSMauro Carvalho Chehab      - G\ :sub:`12low`
5754f38fcaSMauro Carvalho Chehab      - G\ :sub:`12high`
5854f38fcaSMauro Carvalho Chehab      - R\ :sub:`13low`
5954f38fcaSMauro Carvalho Chehab      - R\ :sub:`13high`
6054f38fcaSMauro Carvalho Chehab    * - start + 16:
6154f38fcaSMauro Carvalho Chehab      - B\ :sub:`20low`
6254f38fcaSMauro Carvalho Chehab      - B\ :sub:`20high`
6354f38fcaSMauro Carvalho Chehab      - G\ :sub:`21low`
6454f38fcaSMauro Carvalho Chehab      - G\ :sub:`21high`
6554f38fcaSMauro Carvalho Chehab      - B\ :sub:`22low`
6654f38fcaSMauro Carvalho Chehab      - B\ :sub:`22high`
6754f38fcaSMauro Carvalho Chehab      - G\ :sub:`23low`
6854f38fcaSMauro Carvalho Chehab      - G\ :sub:`23high`
6954f38fcaSMauro Carvalho Chehab    * - start + 24:
7054f38fcaSMauro Carvalho Chehab      - G\ :sub:`30low`
7154f38fcaSMauro Carvalho Chehab      - G\ :sub:`30high`
7254f38fcaSMauro Carvalho Chehab      - R\ :sub:`31low`
7354f38fcaSMauro Carvalho Chehab      - R\ :sub:`31high`
7454f38fcaSMauro Carvalho Chehab      - G\ :sub:`32low`
7554f38fcaSMauro Carvalho Chehab      - G\ :sub:`32high`
7654f38fcaSMauro Carvalho Chehab      - R\ :sub:`33low`
7754f38fcaSMauro Carvalho Chehab      - R\ :sub:`33high`
78