Documentation/userspace-api/media/v4l/pixfmt-srggb14p.rst

   1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
   2
   3 .. _V4L2-PIX-FMT-SRGGB14P:
   4 .. _v4l2-pix-fmt-sbggr14p:
   5 .. _v4l2-pix-fmt-sgbrg14p:
   6 .. _v4l2-pix-fmt-sgrbg14p:
   7
   8 *******************************************************************************************************************************
   9 V4L2_PIX_FMT_SRGGB14P ('pREE'), V4L2_PIX_FMT_SGRBG14P ('pgEE'), V4L2_PIX_FMT_SGBRG14P ('pGEE'), V4L2_PIX_FMT_SBGGR14P ('pBEE'),
  10 *******************************************************************************************************************************
  11
  12 *man V4L2_PIX_FMT_SRGGB14P(2)*
  13
  14 V4L2_PIX_FMT_SGRBG14P
  15 V4L2_PIX_FMT_SGBRG14P
  16 V4L2_PIX_FMT_SBGGR14P
  17 14-bit packed Bayer formats
  18
  19
  20 Description
  21 ===========
  22
  23 These four pixel formats are packed raw sRGB / Bayer formats with 14
  24 bits per colour. Every four consecutive samples are packed into seven
  25 bytes. Each of the first four bytes contain the eight high order bits
  26 of the pixels, and the three following bytes contains the six least
  27 significants bits of each pixel, in the same order.
  28
  29 Each n-pixel row contains n/2 green samples and n/2 blue or red samples,
  30 with alternating green-red and green-blue rows. They are conventionally
  31 described as GRGR... BGBG..., RGRG... GBGB..., etc. Below is an example
  32 of one of these formats:
  33
  34 **Byte Order.**
  35 Each cell is one byte.
  36
  37 .. raw:: latex
  38
  39     \begingroup
  40     \footnotesize
  41     \setlength{\tabcolsep}{2pt}
  42
  43 .. tabularcolumns:: |p{1.6cm}|p{1.0cm}|p{1.0cm}|p{1.0cm}|p{1.0cm}|p{3.5cm}|p{3.5cm}|p{3.5cm}|
  44
  45 .. flat-table::
  46     :header-rows:  0
  47     :stub-columns: 0
  48     :widths:       2 1 1 1 1 3 3 3
  49
  50
  51     -  .. row 1
  52
  53        -  start + 0
  54
  55        -  B\ :sub:`00high`
  56
  57        -  G\ :sub:`01high`
  58
  59        -  B\ :sub:`02high`
  60
  61        -  G\ :sub:`03high`
  62
  63        -  G\ :sub:`01low bits 1--0`\ (bits 7--6)
  64
  65           B\ :sub:`00low bits 5--0`\ (bits 5--0)
  66
  67        -  B\ :sub:`02low bits 3--0`\ (bits 7--4)
  68
  69           G\ :sub:`01low bits 5--2`\ (bits 3--0)
  70
  71        -  G\ :sub:`03low bits 5--0`\ (bits 7--2)
  72
  73           B\ :sub:`02low bits 5--4`\ (bits 1--0)
  74
  75     -  .. row 2
  76
  77        -  start + 7
  78
  79        -  G\ :sub:`10high`
  80
  81        -  R\ :sub:`11high`
  82
  83        -  G\ :sub:`12high`
  84
  85        -  R\ :sub:`13high`
  86
  87        -  R\ :sub:`11low bits 1--0`\ (bits 7--6)
  88
  89           G\ :sub:`10low bits 5--0`\ (bits 5--0)
  90
  91        -  G\ :sub:`12low bits 3--0`\ (bits 7--4)
  92
  93           R\ :sub:`11low bits 5--2`\ (bits 3--0)
  94
  95        -  R\ :sub:`13low bits 5--0`\ (bits 7--2)
  96
  97           G\ :sub:`12low bits 5--4`\ (bits 1--0)
  98
  99     -  .. row 3
 100
 101        -  start + 14
 102
 103        -  B\ :sub:`20high`
 104
 105        -  G\ :sub:`21high`
 106
 107        -  B\ :sub:`22high`
 108
 109        -  G\ :sub:`23high`
 110
 111        -  G\ :sub:`21low bits 1--0`\ (bits 7--6)
 112
 113           B\ :sub:`20low bits 5--0`\ (bits 5--0)
 114
 115        -  B\ :sub:`22low bits 3--0`\ (bits 7--4)
 116
 117           G\ :sub:`21low bits 5--2`\ (bits 3--0)
 118
 119        -  G\ :sub:`23low bits 5--0`\ (bits 7--2)
 120
 121           B\ :sub:`22low bits 5--4`\ (bits 1--0)
 122
 123     -  .. row 4
 124
 125        -  start + 21
 126
 127        -  G\ :sub:`30high`
 128
 129        -  R\ :sub:`31high`
 130
 131        -  G\ :sub:`32high`
 132
 133        -  R\ :sub:`33high`
 134
 135        -  R\ :sub:`31low bits 1--0`\ (bits 7--6)
 136           G\ :sub:`30low bits 5--0`\ (bits 5--0)
 137
 138        -  G\ :sub:`32low bits 3--0`\ (bits 7--4)
 139           R\ :sub:`31low bits 5--2`\ (bits 3--0)
 140
 141        -  R\ :sub:`33low bits 5--0`\ (bits 7--2)
 142           G\ :sub:`32low bits 5--4`\ (bits 1--0)
 143
 144 .. raw:: latex
 145
 146     \endgroup
 147