xref: /linux/Documentation/userspace-api/media/v4l/pixfmt-srggb14p.rst (revision c532de5a67a70f8533d495f8f2aaa9a0491c3ad0) 
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*******************************************************************************************************************************
9V4L2_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
14V4L2_PIX_FMT_SGRBG14P
15V4L2_PIX_FMT_SGBRG14P
16V4L2_PIX_FMT_SBGGR14P
1714-bit packed Bayer formats
18
19
20Description
21===========
22
23These four pixel formats are packed raw sRGB / Bayer formats with 14
24bits per colour. Every four consecutive samples are packed into seven
25bytes. Each of the first four bytes contain the eight high order bits
26of the pixels, and the three following bytes contains the six least
27significants bits of each pixel, in the same order.
28
29Each n-pixel row contains n/2 green samples and n/2 blue or red samples,
30with alternating green-red and green-blue rows. They are conventionally
31described as GRGR... BGBG..., RGRG... GBGB..., etc. Below is an example
32of one of these formats:
33
34**Byte Order.**
35Each 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
148