xref: /openbmc/linux/Documentation/userspace-api/media/v4l/pixfmt-srggb10.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-SRGGB10:
454f38fcaSMauro Carvalho Chehab.. _v4l2-pix-fmt-sbggr10:
554f38fcaSMauro Carvalho Chehab.. _v4l2-pix-fmt-sgbrg10:
654f38fcaSMauro Carvalho Chehab.. _v4l2-pix-fmt-sgrbg10:
754f38fcaSMauro Carvalho Chehab
854f38fcaSMauro Carvalho Chehab***************************************************************************************************************************
954f38fcaSMauro Carvalho ChehabV4L2_PIX_FMT_SRGGB10 ('RG10'), V4L2_PIX_FMT_SGRBG10 ('BA10'), V4L2_PIX_FMT_SGBRG10 ('GB10'), V4L2_PIX_FMT_SBGGR10 ('BG10'),
1054f38fcaSMauro Carvalho Chehab***************************************************************************************************************************
1154f38fcaSMauro Carvalho Chehab
1254f38fcaSMauro Carvalho Chehab
1354f38fcaSMauro Carvalho ChehabV4L2_PIX_FMT_SGRBG10
1454f38fcaSMauro Carvalho ChehabV4L2_PIX_FMT_SGBRG10
1554f38fcaSMauro Carvalho ChehabV4L2_PIX_FMT_SBGGR10
1654f38fcaSMauro Carvalho Chehab10-bit Bayer formats expanded to 16 bits
1754f38fcaSMauro Carvalho Chehab
1854f38fcaSMauro Carvalho Chehab
1954f38fcaSMauro Carvalho ChehabDescription
2054f38fcaSMauro Carvalho Chehab===========
2154f38fcaSMauro Carvalho Chehab
2254f38fcaSMauro Carvalho ChehabThese four pixel formats are raw sRGB / Bayer formats with 10 bits per
2354f38fcaSMauro Carvalho Chehabsample. Each sample is stored in a 16-bit word, with 6 unused
2454f38fcaSMauro Carvalho Chehabhigh bits filled with zeros. Each n-pixel row contains n/2 green samples and
2554f38fcaSMauro Carvalho Chehabn/2 blue or red samples, with alternating red and blue rows. Bytes are
2654f38fcaSMauro Carvalho Chehabstored in memory in little endian order. They are conventionally described
2754f38fcaSMauro Carvalho Chehabas GRGR... BGBG..., RGRG... GBGB..., etc. Below is an example of one of
2854f38fcaSMauro Carvalho Chehabthese formats:
2954f38fcaSMauro Carvalho Chehab
3054f38fcaSMauro Carvalho Chehab**Byte Order.**
3154f38fcaSMauro Carvalho ChehabEach cell is one byte, the 6 most significant bits in the high bytes
3254f38fcaSMauro Carvalho Chehabare 0.
3354f38fcaSMauro Carvalho Chehab
3454f38fcaSMauro Carvalho Chehab
3554f38fcaSMauro Carvalho Chehab
3654f38fcaSMauro Carvalho Chehab
3754f38fcaSMauro Carvalho Chehab.. flat-table::
3854f38fcaSMauro Carvalho Chehab    :header-rows:  0
3954f38fcaSMauro Carvalho Chehab    :stub-columns: 0
4054f38fcaSMauro Carvalho Chehab
4154f38fcaSMauro Carvalho Chehab    * - start + 0:
4254f38fcaSMauro Carvalho Chehab      - B\ :sub:`00low`
4354f38fcaSMauro Carvalho Chehab      - B\ :sub:`00high`
4454f38fcaSMauro Carvalho Chehab      - G\ :sub:`01low`
4554f38fcaSMauro Carvalho Chehab      - G\ :sub:`01high`
4654f38fcaSMauro Carvalho Chehab      - B\ :sub:`02low`
4754f38fcaSMauro Carvalho Chehab      - B\ :sub:`02high`
4854f38fcaSMauro Carvalho Chehab      - G\ :sub:`03low`
4954f38fcaSMauro Carvalho Chehab      - G\ :sub:`03high`
5054f38fcaSMauro Carvalho Chehab    * - start + 8:
5154f38fcaSMauro Carvalho Chehab      - G\ :sub:`10low`
5254f38fcaSMauro Carvalho Chehab      - G\ :sub:`10high`
5354f38fcaSMauro Carvalho Chehab      - R\ :sub:`11low`
5454f38fcaSMauro Carvalho Chehab      - R\ :sub:`11high`
5554f38fcaSMauro Carvalho Chehab      - G\ :sub:`12low`
5654f38fcaSMauro Carvalho Chehab      - G\ :sub:`12high`
5754f38fcaSMauro Carvalho Chehab      - R\ :sub:`13low`
5854f38fcaSMauro Carvalho Chehab      - R\ :sub:`13high`
5954f38fcaSMauro Carvalho Chehab    * - start + 16:
6054f38fcaSMauro Carvalho Chehab      - B\ :sub:`20low`
6154f38fcaSMauro Carvalho Chehab      - B\ :sub:`20high`
6254f38fcaSMauro Carvalho Chehab      - G\ :sub:`21low`
6354f38fcaSMauro Carvalho Chehab      - G\ :sub:`21high`
6454f38fcaSMauro Carvalho Chehab      - B\ :sub:`22low`
6554f38fcaSMauro Carvalho Chehab      - B\ :sub:`22high`
6654f38fcaSMauro Carvalho Chehab      - G\ :sub:`23low`
6754f38fcaSMauro Carvalho Chehab      - G\ :sub:`23high`
6854f38fcaSMauro Carvalho Chehab    * - start + 24:
6954f38fcaSMauro Carvalho Chehab      - G\ :sub:`30low`
7054f38fcaSMauro Carvalho Chehab      - G\ :sub:`30high`
7154f38fcaSMauro Carvalho Chehab      - R\ :sub:`31low`
7254f38fcaSMauro Carvalho Chehab      - R\ :sub:`31high`
7354f38fcaSMauro Carvalho Chehab      - G\ :sub:`32low`
7454f38fcaSMauro Carvalho Chehab      - G\ :sub:`32high`
7554f38fcaSMauro Carvalho Chehab      - R\ :sub:`33low`
7654f38fcaSMauro Carvalho Chehab      - R\ :sub:`33high`
77