[deliverable/linux.git] / Documentation / media / v4l-drivers / fourcc.rst

Guidelines for Linux4Linux pixel format 4CCs
============================================

Guidelines for Video4Linux 4CC codes defined using v4l2_fourcc() are
specified in this document. First of the characters defines the nature of
the pixel format, compression and colour space. The interpretation of the
other three characters depends on the first one.

Existing 4CCs may not obey these guidelines.

Raw bayer
---------

The following first characters are used by raw bayer formats:

- B: raw bayer, uncompressed
- b: raw bayer, DPCM compressed
- a: A-law compressed
- u: u-law compressed

2nd character: pixel order

- B: BGGR
- G: GBRG
- g: GRBG
- R: RGGB

3rd character: uncompressed bits-per-pixel 0--9, A--

4th character: compressed bits-per-pixel 0--9, A--
Commit	Line	Data
1e3afaea SA	1	Guidelines for Linux4Linux pixel format 4CCs
	2	============================================
	3
	4	Guidelines for Video4Linux 4CC codes defined using v4l2_fourcc() are
	5	specified in this document. First of the characters defines the nature of
	6	the pixel format, compression and colour space. The interpretation of the
	7	other three characters depends on the first one.
	8
	9	Existing 4CCs may not obey these guidelines.
	10
1e3afaea SA	11	Raw bayer
	12	---------
	13
	14	The following first characters are used by raw bayer formats:
	15
00748947 MCC	16	- B: raw bayer, uncompressed
	17	- b: raw bayer, DPCM compressed
	18	- a: A-law compressed
	19	- u: u-law compressed
1e3afaea SA	20
1e3afaea SA	21	2nd character: pixel order
00748947 MCC	22
	23	- B: BGGR
	24	- G: GBRG
	25	- g: GRBG
	26	- R: RGGB
1e3afaea SA	27
	28	3rd character: uncompressed bits-per-pixel 0--9, A--
	29
	30	4th character: compressed bits-per-pixel 0--9, A--