[deliverable/linux.git] / Documentation / media / uapi / v4l / pixfmt-srggb10.rst

.. -*- coding: utf-8; mode: rst -*-

.. _V4L2-PIX-FMT-SRGGB10:
.. _v4l2-pix-fmt-sbggr10:
.. _v4l2-pix-fmt-sgbrg10:
.. _v4l2-pix-fmt-sgrbg10:

***************************************************************************************************************************
V4L2_PIX_FMT_SRGGB10 ('RG10'), V4L2_PIX_FMT_SGRBG10 ('BA10'), V4L2_PIX_FMT_SGBRG10 ('GB10'), V4L2_PIX_FMT_SBGGR10 ('BG10'),
***************************************************************************************************************************


V4L2_PIX_FMT_SGRBG10
V4L2_PIX_FMT_SGBRG10
V4L2_PIX_FMT_SBGGR10
10-bit Bayer formats expanded to 16 bits


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

These four pixel formats are raw sRGB / Bayer formats with 10 bits per
sample. Each sample is stored in a 16-bit word, with 6 unused
high bits filled with zeros. Each n-pixel row contains n/2 green samples and
n/2 blue or red samples, with alternating red and blue rows. Bytes are
stored in memory in little endian order. They are conventionally described
as GRGR... BGBG..., RGRG... GBGB..., etc. Below is an example of one of
these formats:

**Byte Order.**
Each cell is one byte, the 6 most significant bits in the high bytes
are 0.


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


    -  .. row 1

       -  start + 0:

       -  B\ :sub:`00low`

       -  B\ :sub:`00high`

       -  G\ :sub:`01low`

       -  G\ :sub:`01high`

       -  B\ :sub:`02low`

       -  B\ :sub:`02high`

       -  G\ :sub:`03low`

       -  G\ :sub:`03high`

    -  .. row 2

       -  start + 8:

       -  G\ :sub:`10low`

       -  G\ :sub:`10high`

       -  R\ :sub:`11low`

       -  R\ :sub:`11high`

       -  G\ :sub:`12low`

       -  G\ :sub:`12high`

       -  R\ :sub:`13low`

       -  R\ :sub:`13high`

    -  .. row 3

       -  start + 16:

       -  B\ :sub:`20low`

       -  B\ :sub:`20high`

       -  G\ :sub:`21low`

       -  G\ :sub:`21high`

       -  B\ :sub:`22low`

       -  B\ :sub:`22high`

       -  G\ :sub:`23low`

       -  G\ :sub:`23high`

    -  .. row 4

       -  start + 24:

       -  G\ :sub:`30low`

       -  G\ :sub:`30high`

       -  R\ :sub:`31low`

       -  R\ :sub:`31high`

       -  G\ :sub:`32low`

       -  G\ :sub:`32high`

       -  R\ :sub:`33low`

       -  R\ :sub:`33high`
Commit	Line	Data
	1	.. -- coding: utf-8; mode: rst --
	2
	3	.. _V4L2-PIX-FMT-SRGGB10:
	4	.. _v4l2-pix-fmt-sbggr10:
	5	.. _v4l2-pix-fmt-sgbrg10:
	6	.. _v4l2-pix-fmt-sgrbg10:
	7
	8	***************************************************************************************************************************
	9	V4L2_PIX_FMT_SRGGB10 ('RG10'), V4L2_PIX_FMT_SGRBG10 ('BA10'), V4L2_PIX_FMT_SGBRG10 ('GB10'), V4L2_PIX_FMT_SBGGR10 ('BG10'),
	10	***************************************************************************************************************************
	11
	12
	13	V4L2_PIX_FMT_SGRBG10
	14	V4L2_PIX_FMT_SGBRG10
	15	V4L2_PIX_FMT_SBGGR10
	16	10-bit Bayer formats expanded to 16 bits
	17
	18
	19	Description
	20	===========
	21
	22	These four pixel formats are raw sRGB / Bayer formats with 10 bits per
	23	sample. Each sample is stored in a 16-bit word, with 6 unused
	24	high bits filled with zeros. Each n-pixel row contains n/2 green samples and
	25	n/2 blue or red samples, with alternating red and blue rows. Bytes are
	26	stored in memory in little endian order. They are conventionally described
	27	as GRGR... BGBG..., RGRG... GBGB..., etc. Below is an example of one of
	28	these formats:
	29
	30	Byte Order.
	31	Each cell is one byte, the 6 most significant bits in the high bytes
	32	are 0.
	33
	34
	35
	36
	37	.. flat-table::
	38	:header-rows: 0
	39	:stub-columns: 0
	40
	41
	42	- .. row 1
	43
	44	- start + 0:
	45
	46	- B\ :sub:`00low`
	47
	48	- B\ :sub:`00high`
	49
	50	- G\ :sub:`01low`
	51
	52	- G\ :sub:`01high`
	53
	54	- B\ :sub:`02low`
	55
	56	- B\ :sub:`02high`
	57
	58	- G\ :sub:`03low`
	59
	60	- G\ :sub:`03high`
	61
	62	- .. row 2
	63
	64	- start + 8:
	65
	66	- G\ :sub:`10low`
	67
	68	- G\ :sub:`10high`
	69
	70	- R\ :sub:`11low`
	71
	72	- R\ :sub:`11high`
	73
	74	- G\ :sub:`12low`
	75
	76	- G\ :sub:`12high`
	77
	78	- R\ :sub:`13low`
	79
	80	- R\ :sub:`13high`
	81
	82	- .. row 3
	83
	84	- start + 16:
	85
	86	- B\ :sub:`20low`
	87
	88	- B\ :sub:`20high`
	89
	90	- G\ :sub:`21low`
	91
	92	- G\ :sub:`21high`
	93
	94	- B\ :sub:`22low`
	95
	96	- B\ :sub:`22high`
	97
	98	- G\ :sub:`23low`
	99
	100	- G\ :sub:`23high`
	101
	102	- .. row 4
	103
	104	- start + 24:
	105
	106	- G\ :sub:`30low`
	107
	108	- G\ :sub:`30high`
	109
	110	- R\ :sub:`31low`
	111
	112	- R\ :sub:`31high`
	113
	114	- G\ :sub:`32low`
	115
	116	- G\ :sub:`32high`
	117
	118	- R\ :sub:`33low`
	119
	120	- R\ :sub:`33high`