Skip to content

L
linux
Commit c2b66caf authored by Laurent Pinchart's avatar Laurent Pinchart Committed by Mauro Carvalho Chehab
1 Browse files
Options

[media] v4l: doc: Remove row numbers from tables 

Shorten the tables by removing row numbers in comments, allowing for
later insertion of rows with minimal diffs.

All changes have been generated by the following script.

import io
import re
import sys

def process_table(fname, data):
	if fname.endswith('hist-v4l2.rst'):
		data = re.sub(u'\n{1,2}\t( ?)  -( ?) ?', u'\n\t\\1 -\\2', data, flags = re.MULTILINE)
		data = re.sub(u'\n(\t|       )-  \.\. row [0-9]+\n\t  ?-( ?) ?', u'\\1* -\\2', data, flags = re.MULTILINE)
	else:
		data = re.sub(u'\n{1,2}       -( ?) ?', u'\n      -\\1', data, flags = re.MULTILINE)
		data = re.sub(u'(\n?)(\n\n    -  \.\. row 1\n)', u'\n\\2', data, flags = re.MULTILINE)
		data = re.sub(u'\n    -  \.\. row [0-9]+\n      -( ?) ?', u'    * -\\1', data, flags = re.MULTILINE)
		data = re.sub(u'\n    -  \.\. row [0-9]+\n       \.\. (_[A-Z0-9_`-]*:)', u'\n    -  .. \\1', data, flags = re.MULTILINE)
		data = re.sub(u'\n    -  \.\. (_[A-Z0-9_`-]*:)\n      -', u'    * .. \\1\n\n      -', data, flags = re.MULTILINE)
		data = re.sub(u'^       - ', u'      -', data, flags = re.MULTILINE)
		data = re.sub(u'^(\t{1,2})  ', u'\\1', data, flags = re.MULTILINE)

	return data

def process_file(fname, data):
	buf = io.StringIO(data)
	output = ''
	in_table = False
	table_separator = 0

	for line in buf.readlines():
		if line.find('.. flat-table::') != -1:
			in_table = True
			table = ''
		elif in_table and not re.match('^[\t\n]|(    )', line):
			in_table = False
			output += process_table(fname, table)

		if in_table:
			table += line
		else:
			output += line

	if in_table:
		in_table = False
		output += process_table(fname, table)

	return output

fname = sys.argv[1]

data = file(fname, 'rb').read().decode('utf-8')
data = process_file(fname, data)
file(fname, 'wb').write(data.encode('utf-8'))
Signed-off-by: default avatarLaurent Pinchart <laurent.pinchart@ideasonboard.com>
parent c1958488
Expand all Show whitespace changes
Inline Side-by-side
Showing with 15726 additions and 31353 deletions
Documentation/media/uapi/v4l/buffer.rst
View file @ c2b66caf
This diff is collapsed.
Documentation/media/uapi/v4l/control.rst
View file @ c2b66caf
...@@ -198,102 +198,39 @@ Control IDs ...@@ -198,102 +198,39 @@ Control IDs
:stub-columns: 0 :stub-columns: 0
:widths: 11 24 :widths: 11 24
- .. row 1 * - ``V4L2_COLORFX_NONE``
- ``V4L2_COLORFX_NONE``
- Color effect is disabled. - Color effect is disabled.
* - ``V4L2_COLORFX_ANTIQUE``
- .. row 2
- ``V4L2_COLORFX_ANTIQUE``
- An aging (old photo) effect. - An aging (old photo) effect.
* - ``V4L2_COLORFX_ART_FREEZE``
- .. row 3
- ``V4L2_COLORFX_ART_FREEZE``
- Frost color effect. - Frost color effect.
* - ``V4L2_COLORFX_AQUA``
- .. row 4
- ``V4L2_COLORFX_AQUA``
- Water color, cool tone. - Water color, cool tone.
* - ``V4L2_COLORFX_BW``
- .. row 5
- ``V4L2_COLORFX_BW``
- Black and white. - Black and white.
* - ``V4L2_COLORFX_EMBOSS``
- .. row 6
- ``V4L2_COLORFX_EMBOSS``
- Emboss, the highlights and shadows replace light/dark boundaries - Emboss, the highlights and shadows replace light/dark boundaries
and low contrast areas are set to a gray background. and low contrast areas are set to a gray background.
* - ``V4L2_COLORFX_GRASS_GREEN``
- .. row 7
- ``V4L2_COLORFX_GRASS_GREEN``
- Grass green. - Grass green.
* - ``V4L2_COLORFX_NEGATIVE``
- .. row 8
- ``V4L2_COLORFX_NEGATIVE``
- Negative. - Negative.
* - ``V4L2_COLORFX_SEPIA``
- .. row 9
- ``V4L2_COLORFX_SEPIA``
- Sepia tone. - Sepia tone.
* - ``V4L2_COLORFX_SKETCH``
- .. row 10
- ``V4L2_COLORFX_SKETCH``
- Sketch. - Sketch.
* - ``V4L2_COLORFX_SKIN_WHITEN``
- .. row 11
- ``V4L2_COLORFX_SKIN_WHITEN``
- Skin whiten. - Skin whiten.
* - ``V4L2_COLORFX_SKY_BLUE``
- .. row 12
- ``V4L2_COLORFX_SKY_BLUE``
- Sky blue. - Sky blue.
* - ``V4L2_COLORFX_SOLARIZATION``
- .. row 13
- ``V4L2_COLORFX_SOLARIZATION``
- Solarization, the image is partially reversed in tone, only color - Solarization, the image is partially reversed in tone, only color
values above or below a certain threshold are inverted. values above or below a certain threshold are inverted.
* - ``V4L2_COLORFX_SILHOUETTE``
- .. row 14
- ``V4L2_COLORFX_SILHOUETTE``
- Silhouette (outline). - Silhouette (outline).
* - ``V4L2_COLORFX_VIVID``
- .. row 15
- ``V4L2_COLORFX_VIVID``
- Vivid colors. - Vivid colors.
* - ``V4L2_COLORFX_SET_CBCR``
- .. row 16
- ``V4L2_COLORFX_SET_CBCR``
- The Cb and Cr chroma components are replaced by fixed coefficients - The Cb and Cr chroma components are replaced by fixed coefficients
determined by ``V4L2_CID_COLORFX_CBCR`` control. determined by ``V4L2_CID_COLORFX_CBCR`` control.
......
Documentation/media/uapi/v4l/dev-raw-vbi.rst
View file @ c2b66caf
...@@ -110,41 +110,21 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does ...@@ -110,41 +110,21 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does
:stub-columns: 0 :stub-columns: 0
:widths: 1 1 2 :widths: 1 1 2
* - __u32
- .. row 1
- __u32
- ``sampling_rate`` - ``sampling_rate``
- Samples per second, i. e. unit 1 Hz. - Samples per second, i. e. unit 1 Hz.
* - __u32
- .. row 2
- __u32
- ``offset`` - ``offset``
- Horizontal offset of the VBI image, relative to the leading edge - Horizontal offset of the VBI image, relative to the leading edge
of the line synchronization pulse and counted in samples: The of the line synchronization pulse and counted in samples: The
first sample in the VBI image will be located ``offset`` / first sample in the VBI image will be located ``offset`` /
``sampling_rate`` seconds following the leading edge. See also ``sampling_rate`` seconds following the leading edge. See also
:ref:`vbi-hsync`. :ref:`vbi-hsync`.
* - __u32
- .. row 3
- __u32
- ``samples_per_line`` - ``samples_per_line``
- -
* - __u32
- .. row 4
- __u32
- ``sample_format`` - ``sample_format``
- Defines the sample format as in :ref:`pixfmt`, a - Defines the sample format as in :ref:`pixfmt`, a
four-character-code. [#f2]_ Usually this is ``V4L2_PIX_FMT_GREY``, four-character-code. [#f2]_ Usually this is ``V4L2_PIX_FMT_GREY``,
i. e. each sample consists of 8 bits with lower values oriented i. e. each sample consists of 8 bits with lower values oriented
...@@ -153,13 +133,8 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does ...@@ -153,13 +133,8 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does
necessarily indicate if the signal is 'high' or 'low' because 128 necessarily indicate if the signal is 'high' or 'low' because 128
may not be the mean value of the signal. Drivers shall not convert may not be the mean value of the signal. Drivers shall not convert
the sample format by software. the sample format by software.
* - __u32
- .. row 5
- __u32
- ``start``\ [#f2]_ - ``start``\ [#f2]_
- This is the scanning system line number associated with the first - This is the scanning system line number associated with the first
line of the VBI image, of the first and the second field line of the VBI image, of the first and the second field
respectively. See :ref:`vbi-525` and :ref:`vbi-625` for valid respectively. See :ref:`vbi-525` and :ref:`vbi-625` for valid
...@@ -171,19 +146,11 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does ...@@ -171,19 +146,11 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does
drivers can return start values 0 if the hardware cannot reliable drivers can return start values 0 if the hardware cannot reliable
identify scanning lines, VBI acquisition may not require this identify scanning lines, VBI acquisition may not require this
information. information.
* - __u32
- .. row 6
- __u32
- ``count``\ [#f2]_ - ``count``\ [#f2]_
- The number of lines in the first and second field image, - The number of lines in the first and second field image,
respectively. respectively.
* - :cspan:`2`
- .. row 7
- :cspan:`2`
Drivers should be as flexibility as possible. For example, it may Drivers should be as flexibility as possible. For example, it may
be possible to extend or move the VBI capture window down to the be possible to extend or move the VBI capture window down to the
...@@ -206,22 +173,12 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does ...@@ -206,22 +173,12 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does
:ref:`v4l2_std_id <v4l2-std-id>` or the ``framelines`` field :ref:`v4l2_std_id <v4l2-std-id>` or the ``framelines`` field
of struct :c:type:`v4l2_standard` can be evaluated of struct :c:type:`v4l2_standard` can be evaluated
for this purpose. for this purpose.
* - __u32
- .. row 8
- __u32
- ``flags`` - ``flags``
- See :ref:`vbifmt-flags` below. Currently only drivers set flags, - See :ref:`vbifmt-flags` below. Currently only drivers set flags,
applications must set this field to zero. applications must set this field to zero.
* - __u32
- .. row 9
- __u32
- ``reserved``\ [#f2]_ - ``reserved``\ [#f2]_
- This array is reserved for future extensions. Drivers and - This array is reserved for future extensions. Drivers and
applications must set it to zero. applications must set it to zero.
...@@ -235,13 +192,8 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does ...@@ -235,13 +192,8 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does
:stub-columns: 0 :stub-columns: 0
:widths: 3 1 4 :widths: 3 1 4
* - ``V4L2_VBI_UNSYNC``
- .. row 1
- ``V4L2_VBI_UNSYNC``
- 0x0001 - 0x0001
- This flag indicates hardware which does not properly distinguish - This flag indicates hardware which does not properly distinguish
between fields. Normally the VBI image stores the first field between fields. Normally the VBI image stores the first field
(lower scanning line numbers) first in memory. This may be a top (lower scanning line numbers) first in memory. This may be a top
...@@ -249,13 +201,8 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does ...@@ -249,13 +201,8 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does
set the first or second field may be stored first, however the set the first or second field may be stored first, however the
fields are still in correct temporal order with the older field fields are still in correct temporal order with the older field
first in memory. [#f3]_ first in memory. [#f3]_
* - ``V4L2_VBI_INTERLACED``
- .. row 2
- ``V4L2_VBI_INTERLACED``
- 0x0002 - 0x0002
- By default the two field images will be passed sequentially; all - By default the two field images will be passed sequentially; all
lines of the first field followed by all lines of the second field lines of the first field followed by all lines of the second field
(compare :ref:`field-order` ``V4L2_FIELD_SEQ_TB`` and (compare :ref:`field-order` ``V4L2_FIELD_SEQ_TB`` and
......
Documentation/media/uapi/v4l/dev-rds.rst
View file @ c2b66caf
...@@ -102,29 +102,14 @@ RDS datastructures ...@@ -102,29 +102,14 @@ RDS datastructures
:stub-columns: 0 :stub-columns: 0
:widths: 1 1 5 :widths: 1 1 5
* - __u8
- .. row 1
- __u8
- ``lsb`` - ``lsb``
- Least Significant Byte of RDS Block - Least Significant Byte of RDS Block
* - __u8
- .. row 2
- __u8
- ``msb`` - ``msb``
- Most Significant Byte of RDS Block - Most Significant Byte of RDS Block
* - __u8
- .. row 3
- __u8
- ``block`` - ``block``
- Block description - Block description
...@@ -138,31 +123,15 @@ RDS datastructures ...@@ -138,31 +123,15 @@ RDS datastructures
:stub-columns: 0 :stub-columns: 0
:widths: 1 5 :widths: 1 5
* - Bits 0-2
- .. row 1
- Bits 0-2
- Block (aka offset) of the received data. - Block (aka offset) of the received data.
* - Bits 3-5
- .. row 2
- Bits 3-5
- Deprecated. Currently identical to bits 0-2. Do not use these - Deprecated. Currently identical to bits 0-2. Do not use these
bits. bits.
* - Bit 6
- .. row 3
- Bit 6
- Corrected bit. Indicates that an error was corrected for this data - Corrected bit. Indicates that an error was corrected for this data
block. block.
* - Bit 7
- .. row 4
- Bit 7
- Error bit. Indicates that an uncorrectable error occurred during - Error bit. Indicates that an uncorrectable error occurred during
reception of this block. reception of this block.
...@@ -177,87 +146,39 @@ RDS datastructures ...@@ -177,87 +146,39 @@ RDS datastructures
:stub-columns: 0 :stub-columns: 0
:widths: 1 1 1 5 :widths: 1 1 1 5
* - V4L2_RDS_BLOCK_MSK
- .. row 1
- V4L2_RDS_BLOCK_MSK
- -
- 7 - 7
- Mask for bits 0-2 to get the block ID. - Mask for bits 0-2 to get the block ID.
* - V4L2_RDS_BLOCK_A
- .. row 2
- V4L2_RDS_BLOCK_A
- -
- 0 - 0
- Block A. - Block A.
* - V4L2_RDS_BLOCK_B
- .. row 3
- V4L2_RDS_BLOCK_B
- -
- 1 - 1
- Block B. - Block B.
* - V4L2_RDS_BLOCK_C
- .. row 4
- V4L2_RDS_BLOCK_C
- -
- 2 - 2
- Block C. - Block C.
* - V4L2_RDS_BLOCK_D
- .. row 5
- V4L2_RDS_BLOCK_D
- -
- 3 - 3
- Block D. - Block D.
* - V4L2_RDS_BLOCK_C_ALT
- .. row 6
- V4L2_RDS_BLOCK_C_ALT
- -
- 4 - 4
- Block C'. - Block C'.
* - V4L2_RDS_BLOCK_INVALID
- .. row 7
- V4L2_RDS_BLOCK_INVALID
- read-only - read-only
- 7 - 7
- An invalid block. - An invalid block.
* - V4L2_RDS_BLOCK_CORRECTED
- .. row 8
- V4L2_RDS_BLOCK_CORRECTED
- read-only - read-only
- 0x40 - 0x40
- A bit error was detected but corrected. - A bit error was detected but corrected.
* - V4L2_RDS_BLOCK_ERROR
- .. row 9
- V4L2_RDS_BLOCK_ERROR
- read-only - read-only
- 0x80 - 0x80
- An uncorrectable error occurred. - An uncorrectable error occurred.
Documentation/media/uapi/v4l/dev-sdr.rst
View file @ c2b66caf
...@@ -87,33 +87,18 @@ data transfer, set by the driver in order to inform application. ...@@ -87,33 +87,18 @@ data transfer, set by the driver in order to inform application.
:stub-columns: 0 :stub-columns: 0
:widths: 1 1 2 :widths: 1 1 2
* - __u32
- .. row 1
- __u32
- ``pixelformat`` - ``pixelformat``
- The data format or type of compression, set by the application. - The data format or type of compression, set by the application.
This is a little endian This is a little endian
:ref:`four character code <v4l2-fourcc>`. V4L2 defines SDR :ref:`four character code <v4l2-fourcc>`. V4L2 defines SDR
formats in :ref:`sdr-formats`. formats in :ref:`sdr-formats`.
* - __u32
- .. row 2
- __u32
- ``buffersize`` - ``buffersize``
- Maximum size in bytes required for data. Value is set by the - Maximum size in bytes required for data. Value is set by the
driver. driver.
* - __u8
- .. row 3
- __u8
- ``reserved[24]`` - ``reserved[24]``
- This array is reserved for future extensions. Drivers and - This array is reserved for future extensions. Drivers and
applications must set it to zero. applications must set it to zero.
......
Documentation/media/uapi/v4l/dev-subdev.rst
View file @ c2b66caf
...@@ -215,84 +215,40 @@ list entity names and pad numbers). ...@@ -215,84 +215,40 @@ list entity names and pad numbers).
:stub-columns: 0 :stub-columns: 0
:widths: 5 5 5 5 5 5 5 :widths: 5 5 5 5 5 5 5
* -
- .. row 1
-
- Sensor/0 format - Sensor/0 format
- Frontend/0 format - Frontend/0 format
- Frontend/1 format - Frontend/1 format
- Scaler/0 format - Scaler/0 format
- Scaler/0 compose selection rectangle - Scaler/0 compose selection rectangle
- Scaler/1 format - Scaler/1 format
* - Initial state
- .. row 2
- Initial state
- 2048x1536/SGRBG8_1X8 - 2048x1536/SGRBG8_1X8
- (default) - (default)
- (default) - (default)
- (default) - (default)
- (default) - (default)
- (default) - (default)
* - Configure frontend sink format
- .. row 3
- Configure frontend sink format
- 2048x1536/SGRBG8_1X8 - 2048x1536/SGRBG8_1X8
- *2048x1536/SGRBG8_1X8* - *2048x1536/SGRBG8_1X8*
- *2046x1534/SGRBG8_1X8* - *2046x1534/SGRBG8_1X8*
- (default) - (default)
- (default) - (default)
- (default) - (default)
* - Configure scaler sink format
- .. row 4
- Configure scaler sink format
- 2048x1536/SGRBG8_1X8 - 2048x1536/SGRBG8_1X8
- 2048x1536/SGRBG8_1X8 - 2048x1536/SGRBG8_1X8
- 2046x1534/SGRBG8_1X8 - 2046x1534/SGRBG8_1X8
- *2046x1534/SGRBG8_1X8* - *2046x1534/SGRBG8_1X8*
- *0,0/2046x1534* - *0,0/2046x1534*
- *2046x1534/SGRBG8_1X8* - *2046x1534/SGRBG8_1X8*
* - Configure scaler sink compose selection
- .. row 5
- Configure scaler sink compose selection
- 2048x1536/SGRBG8_1X8 - 2048x1536/SGRBG8_1X8
- 2048x1536/SGRBG8_1X8 - 2048x1536/SGRBG8_1X8
- 2046x1534/SGRBG8_1X8 - 2046x1534/SGRBG8_1X8
- 2046x1534/SGRBG8_1X8 - 2046x1534/SGRBG8_1X8
- *0,0/1280x960* - *0,0/1280x960*
- *1280x960/SGRBG8_1X8* - *1280x960/SGRBG8_1X8*
.. raw:: latex .. raw:: latex
......
Documentation/media/uapi/v4l/diff-v4l.rst
View file @ c2b66caf
This diff is collapsed.
Documentation/media/uapi/v4l/field-order.rst
View file @ c2b66caf
...@@ -64,13 +64,8 @@ enum v4l2_field ...@@ -64,13 +64,8 @@ enum v4l2_field
:stub-columns: 0 :stub-columns: 0
:widths: 3 1 4 :widths: 3 1 4
* - ``V4L2_FIELD_ANY``
- .. row 1
- ``V4L2_FIELD_ANY``
- 0 - 0
- Applications request this field order when any one of the - Applications request this field order when any one of the
``V4L2_FIELD_NONE``, ``V4L2_FIELD_TOP``, ``V4L2_FIELD_BOTTOM``, or ``V4L2_FIELD_NONE``, ``V4L2_FIELD_TOP``, ``V4L2_FIELD_BOTTOM``, or
``V4L2_FIELD_INTERLACED`` formats is acceptable. Drivers choose ``V4L2_FIELD_INTERLACED`` formats is acceptable. Drivers choose
...@@ -82,76 +77,41 @@ enum v4l2_field ...@@ -82,76 +77,41 @@ enum v4l2_field
:ref:`VIDIOC_TRY_FMT <VIDIOC_G_FMT>`. struct :ref:`VIDIOC_TRY_FMT <VIDIOC_G_FMT>`. struct
:c:type:`v4l2_buffer` ``field`` can never be :c:type:`v4l2_buffer` ``field`` can never be
``V4L2_FIELD_ANY``. ``V4L2_FIELD_ANY``.
* - ``V4L2_FIELD_NONE``
- .. row 2
- ``V4L2_FIELD_NONE``
- 1 - 1
- Images are in progressive format, not interlaced. The driver may - Images are in progressive format, not interlaced. The driver may
also indicate this order when it cannot distinguish between also indicate this order when it cannot distinguish between
``V4L2_FIELD_TOP`` and ``V4L2_FIELD_BOTTOM``. ``V4L2_FIELD_TOP`` and ``V4L2_FIELD_BOTTOM``.
* - ``V4L2_FIELD_TOP``
- .. row 3
- ``V4L2_FIELD_TOP``
- 2 - 2
- Images consist of the top (aka odd) field only. - Images consist of the top (aka odd) field only.
* - ``V4L2_FIELD_BOTTOM``
- .. row 4
- ``V4L2_FIELD_BOTTOM``
- 3 - 3
- Images consist of the bottom (aka even) field only. Applications - Images consist of the bottom (aka even) field only. Applications
may wish to prevent a device from capturing interlaced images may wish to prevent a device from capturing interlaced images
because they will have "comb" or "feathering" artefacts around because they will have "comb" or "feathering" artefacts around
moving objects. moving objects.
* - ``V4L2_FIELD_INTERLACED``
- .. row 5
- ``V4L2_FIELD_INTERLACED``
- 4 - 4
- Images contain both fields, interleaved line by line. The temporal - Images contain both fields, interleaved line by line. The temporal
order of the fields (whether the top or bottom field is first order of the fields (whether the top or bottom field is first
transmitted) depends on the current video standard. M/NTSC transmitted) depends on the current video standard. M/NTSC
transmits the bottom field first, all other standards the top transmits the bottom field first, all other standards the top
field first. field first.
* - ``V4L2_FIELD_SEQ_TB``
- .. row 6
- ``V4L2_FIELD_SEQ_TB``
- 5 - 5
- Images contain both fields, the top field lines are stored first - Images contain both fields, the top field lines are stored first
in memory, immediately followed by the bottom field lines. Fields in memory, immediately followed by the bottom field lines. Fields
are always stored in temporal order, the older one first in are always stored in temporal order, the older one first in
memory. Image sizes refer to the frame, not fields. memory. Image sizes refer to the frame, not fields.
* - ``V4L2_FIELD_SEQ_BT``
- .. row 7
- ``V4L2_FIELD_SEQ_BT``
- 6 - 6
- Images contain both fields, the bottom field lines are stored - Images contain both fields, the bottom field lines are stored
first in memory, immediately followed by the top field lines. first in memory, immediately followed by the top field lines.
Fields are always stored in temporal order, the older one first in Fields are always stored in temporal order, the older one first in
memory. Image sizes refer to the frame, not fields. memory. Image sizes refer to the frame, not fields.
* - ``V4L2_FIELD_ALTERNATE``
- .. row 8
- ``V4L2_FIELD_ALTERNATE``
- 7 - 7
- The two fields of a frame are passed in separate buffers, in - The two fields of a frame are passed in separate buffers, in
temporal order, i. e. the older one first. To indicate the field temporal order, i. e. the older one first. To indicate the field
parity (whether the current field is a top or bottom field) the parity (whether the current field is a top or bottom field) the
...@@ -165,22 +125,12 @@ enum v4l2_field ...@@ -165,22 +125,12 @@ enum v4l2_field
format cannot be selected when using the read/write I/O method format cannot be selected when using the read/write I/O method
since there is no way to communicate if a field was a top or since there is no way to communicate if a field was a top or
bottom field. bottom field.
* - ``V4L2_FIELD_INTERLACED_TB``
- .. row 9
- ``V4L2_FIELD_INTERLACED_TB``
- 8 - 8
- Images contain both fields, interleaved line by line, top field - Images contain both fields, interleaved line by line, top field
first. The top field is transmitted first. first. The top field is transmitted first.
* - ``V4L2_FIELD_INTERLACED_BT``
- .. row 10
- ``V4L2_FIELD_INTERLACED_BT``
- 9 - 9
- Images contain both fields, interleaved line by line, top field - Images contain both fields, interleaved line by line, top field
first. The bottom field is transmitted first. first. The bottom field is transmitted first.
......
Documentation/media/uapi/v4l/hist-v4l2.rst
View file @ c2b66caf
...@@ -447,89 +447,33 @@ This unnamed version was finally merged into Linux 2.5.46. ...@@ -447,89 +447,33 @@ This unnamed version was finally merged into Linux 2.5.46.
:header-rows: 1 :header-rows: 1
:stub-columns: 0 :stub-columns: 0
* - Old defines
- .. row 1
- Old defines
- enum :c:type:`v4l2_buf_type` - enum :c:type:`v4l2_buf_type`
* - ``V4L2_BUF_TYPE_CAPTURE``
- .. row 2
- ``V4L2_BUF_TYPE_CAPTURE``
- ``V4L2_BUF_TYPE_VIDEO_CAPTURE`` - ``V4L2_BUF_TYPE_VIDEO_CAPTURE``
* - ``V4L2_BUF_TYPE_CODECIN``
- .. row 3
- ``V4L2_BUF_TYPE_CODECIN``
- Omitted for now - Omitted for now
* - ``V4L2_BUF_TYPE_CODECOUT``
- .. row 4
- ``V4L2_BUF_TYPE_CODECOUT``
- Omitted for now - Omitted for now
* - ``V4L2_BUF_TYPE_EFFECTSIN``
- .. row 5
- ``V4L2_BUF_TYPE_EFFECTSIN``
- Omitted for now - Omitted for now
* - ``V4L2_BUF_TYPE_EFFECTSIN2``
- .. row 6
- ``V4L2_BUF_TYPE_EFFECTSIN2``
- Omitted for now - Omitted for now
* - ``V4L2_BUF_TYPE_EFFECTSOUT``
- .. row 7
- ``V4L2_BUF_TYPE_EFFECTSOUT``
- Omitted for now - Omitted for now
* - ``V4L2_BUF_TYPE_VIDEOOUT``
- .. row 8
- ``V4L2_BUF_TYPE_VIDEOOUT``
- ``V4L2_BUF_TYPE_VIDEO_OUTPUT`` - ``V4L2_BUF_TYPE_VIDEO_OUTPUT``
* - ``-``
- .. row 9
- ``-``
- ``V4L2_BUF_TYPE_VIDEO_OVERLAY`` - ``V4L2_BUF_TYPE_VIDEO_OVERLAY``
* - ``-``
- .. row 10
- ``-``
- ``V4L2_BUF_TYPE_VBI_CAPTURE`` - ``V4L2_BUF_TYPE_VBI_CAPTURE``
* - ``-``
- .. row 11
- ``-``
- ``V4L2_BUF_TYPE_VBI_OUTPUT`` - ``V4L2_BUF_TYPE_VBI_OUTPUT``
* - ``-``
- .. row 12
- ``-``
- ``V4L2_BUF_TYPE_SLICED_VBI_CAPTURE`` - ``V4L2_BUF_TYPE_SLICED_VBI_CAPTURE``
* - ``-``
- .. row 13
- ``-``
- ``V4L2_BUF_TYPE_SLICED_VBI_OUTPUT`` - ``V4L2_BUF_TYPE_SLICED_VBI_OUTPUT``
* - ``V4L2_BUF_TYPE_PRIVATE_BASE``
- .. row 14
- ``V4L2_BUF_TYPE_PRIVATE_BASE``
- ``V4L2_BUF_TYPE_PRIVATE`` (but this is deprecated) - ``V4L2_BUF_TYPE_PRIVATE`` (but this is deprecated)
...@@ -564,53 +508,21 @@ This unnamed version was finally merged into Linux 2.5.46. ...@@ -564,53 +508,21 @@ This unnamed version was finally merged into Linux 2.5.46.
:header-rows: 1 :header-rows: 1
:stub-columns: 0 :stub-columns: 0
* - Old flag
- .. row 1
- Old flag
- enum :c:type:`v4l2_field` - enum :c:type:`v4l2_field`
* - ``V4L2_FMT_FLAG_NOT_INTERLACED``
- .. row 2
- ``V4L2_FMT_FLAG_NOT_INTERLACED``
- ? - ?
* - ``V4L2_FMT_FLAG_INTERLACED`` = ``V4L2_FMT_FLAG_COMBINED``
- .. row 3
- ``V4L2_FMT_FLAG_INTERLACED`` = ``V4L2_FMT_FLAG_COMBINED``
- ``V4L2_FIELD_INTERLACED`` - ``V4L2_FIELD_INTERLACED``
* - ``V4L2_FMT_FLAG_TOPFIELD`` = ``V4L2_FMT_FLAG_ODDFIELD``
- .. row 4
- ``V4L2_FMT_FLAG_TOPFIELD`` = ``V4L2_FMT_FLAG_ODDFIELD``
- ``V4L2_FIELD_TOP`` - ``V4L2_FIELD_TOP``
* - ``V4L2_FMT_FLAG_BOTFIELD`` = ``V4L2_FMT_FLAG_EVENFIELD``
- .. row 5
- ``V4L2_FMT_FLAG_BOTFIELD`` = ``V4L2_FMT_FLAG_EVENFIELD``
- ``V4L2_FIELD_BOTTOM`` - ``V4L2_FIELD_BOTTOM``
* - ``-``
- .. row 6
- ``-``
- ``V4L2_FIELD_SEQ_TB`` - ``V4L2_FIELD_SEQ_TB``
* - ``-``
- .. row 7
- ``-``
- ``V4L2_FIELD_SEQ_BT`` - ``V4L2_FIELD_SEQ_BT``
* - ``-``
- .. row 8
- ``-``
- ``V4L2_FIELD_ALTERNATE`` - ``V4L2_FIELD_ALTERNATE``
...@@ -768,45 +680,20 @@ V4L2 2003-11-05 ...@@ -768,45 +680,20 @@ V4L2 2003-11-05
:header-rows: 1 :header-rows: 1
:stub-columns: 0 :stub-columns: 0
* - Symbol
- .. row 1
- Symbol
- In this document prior to revision 0.5 - In this document prior to revision 0.5
- Corrected - Corrected
* - ``V4L2_PIX_FMT_RGB24``
- .. row 2
- ``V4L2_PIX_FMT_RGB24``
- B, G, R - B, G, R
- R, G, B - R, G, B
* - ``V4L2_PIX_FMT_BGR24``
- .. row 3
- ``V4L2_PIX_FMT_BGR24``
- R, G, B - R, G, B
- B, G, R - B, G, R
* - ``V4L2_PIX_FMT_RGB32``
- .. row 4
- ``V4L2_PIX_FMT_RGB32``
- B, G, R, X - B, G, R, X
- R, G, B, X - R, G, B, X
* - ``V4L2_PIX_FMT_BGR32``
- .. row 5
- ``V4L2_PIX_FMT_BGR32``
- R, G, B, X - R, G, B, X
- B, G, R, X - B, G, R, X
......
Documentation/media/uapi/v4l/pixfmt-002.rst
View file @ c2b66caf
...@@ -15,74 +15,43 @@ Single-planar format structure ...@@ -15,74 +15,43 @@ Single-planar format structure
:stub-columns: 0 :stub-columns: 0
:widths: 1 1 2 :widths: 1 1 2
* - __u32
- .. row 1
- __u32
- ``width`` - ``width``
- Image width in pixels. - Image width in pixels.
* - __u32
- .. row 2
- __u32
- ``height`` - ``height``
- Image height in pixels. If ``field`` is one of ``V4L2_FIELD_TOP``, - Image height in pixels. If ``field`` is one of ``V4L2_FIELD_TOP``,
``V4L2_FIELD_BOTTOM`` or ``V4L2_FIELD_ALTERNATE`` then height ``V4L2_FIELD_BOTTOM`` or ``V4L2_FIELD_ALTERNATE`` then height
refers to the number of lines in the field, otherwise it refers to refers to the number of lines in the field, otherwise it refers to
the number of lines in the frame (which is twice the field height the number of lines in the frame (which is twice the field height
for interlaced formats). for interlaced formats).
* - :cspan:`2` Applications set these fields to request an image
- .. row 3
- :cspan:`2` Applications set these fields to request an image
size, drivers return the closest possible values. In case of size, drivers return the closest possible values. In case of
planar formats the ``width`` and ``height`` applies to the largest planar formats the ``width`` and ``height`` applies to the largest
plane. To avoid ambiguities drivers must return values rounded up plane. To avoid ambiguities drivers must return values rounded up
to a multiple of the scale factor of any smaller planes. For to a multiple of the scale factor of any smaller planes. For
example when the image format is YUV 4:2:0, ``width`` and example when the image format is YUV 4:2:0, ``width`` and
``height`` must be multiples of two. ``height`` must be multiples of two.
* - __u32
- .. row 4
- __u32
- ``pixelformat`` - ``pixelformat``
- The pixel format or type of compression, set by the application. - The pixel format or type of compression, set by the application.
This is a little endian This is a little endian
:ref:`four character code <v4l2-fourcc>`. V4L2 defines standard :ref:`four character code <v4l2-fourcc>`. V4L2 defines standard
RGB formats in :ref:`rgb-formats`, YUV formats in RGB formats in :ref:`rgb-formats`, YUV formats in
:ref:`yuv-formats`, and reserved codes in :ref:`yuv-formats`, and reserved codes in
:ref:`reserved-formats` :ref:`reserved-formats`
* - enum :c:type::`v4l2_field`
- .. row 5
- enum :c:type::`v4l2_field`
- ``field`` - ``field``
- Video images are typically interlaced. Applications can request to - Video images are typically interlaced. Applications can request to
capture or output only the top or bottom field, or both fields capture or output only the top or bottom field, or both fields
interlaced or sequentially stored in one buffer or alternating in interlaced or sequentially stored in one buffer or alternating in
separate buffers. Drivers return the actual field order selected. separate buffers. Drivers return the actual field order selected.
For more details on fields see :ref:`field-order`. For more details on fields see :ref:`field-order`.
* - __u32
- .. row 6
- __u32
- ``bytesperline`` - ``bytesperline``
- Distance in bytes between the leftmost pixels in two adjacent - Distance in bytes between the leftmost pixels in two adjacent
lines. lines.
* - :cspan:`2`
- .. row 7
- :cspan:`2`
Both applications and drivers can set this field to request Both applications and drivers can set this field to request
padding bytes at the end of each line. Drivers however may ignore padding bytes at the end of each line. Drivers however may ignore
...@@ -107,34 +76,19 @@ Single-planar format structure ...@@ -107,34 +76,19 @@ Single-planar format structure
For compressed formats the ``bytesperline`` value makes no sense. For compressed formats the ``bytesperline`` value makes no sense.
Applications and drivers must set this to 0 in that case. Applications and drivers must set this to 0 in that case.
* - __u32
- .. row 8
- __u32
- ``sizeimage`` - ``sizeimage``
- Size in bytes of the buffer to hold a complete image, set by the - Size in bytes of the buffer to hold a complete image, set by the
driver. Usually this is ``bytesperline`` times ``height``. When driver. Usually this is ``bytesperline`` times ``height``. When
the image consists of variable length compressed data this is the the image consists of variable length compressed data this is the
maximum number of bytes required to hold an image. maximum number of bytes required to hold an image.
* - enum :c:type:`v4l2_colorspace`
- .. row 9
- enum :c:type:`v4l2_colorspace`
- ``colorspace`` - ``colorspace``
- This information supplements the ``pixelformat`` and must be set - This information supplements the ``pixelformat`` and must be set
by the driver for capture streams and by the application for by the driver for capture streams and by the application for
output streams, see :ref:`colorspaces`. output streams, see :ref:`colorspaces`.
* - __u32
- .. row 10
- __u32
- ``priv`` - ``priv``
- This field indicates whether the remaining fields of the - This field indicates whether the remaining fields of the
struct :c:type:`v4l2_pix_format`, also called the struct :c:type:`v4l2_pix_format`, also called the
extended fields, are valid. When set to extended fields, are valid. When set to
...@@ -159,41 +113,21 @@ Single-planar format structure ...@@ -159,41 +113,21 @@ Single-planar format structure
On return drivers must set the ``priv`` field to On return drivers must set the ``priv`` field to
``V4L2_PIX_FMT_PRIV_MAGIC`` and all the extended fields to ``V4L2_PIX_FMT_PRIV_MAGIC`` and all the extended fields to
applicable values. applicable values.
* - __u32
- .. row 11
- __u32
- ``flags`` - ``flags``
- Flags set by the application or driver, see :ref:`format-flags`. - Flags set by the application or driver, see :ref:`format-flags`.
* - enum :c:type:`v4l2_ycbcr_encoding`
- .. row 12
- enum :c:type:`v4l2_ycbcr_encoding`
- ``ycbcr_enc`` - ``ycbcr_enc``
- This information supplements the ``colorspace`` and must be set by - This information supplements the ``colorspace`` and must be set by
the driver for capture streams and by the application for output the driver for capture streams and by the application for output
streams, see :ref:`colorspaces`. streams, see :ref:`colorspaces`.
* - enum :c:type:`v4l2_quantization`
- .. row 13
- enum :c:type:`v4l2_quantization`
- ``quantization`` - ``quantization``
- This information supplements the ``colorspace`` and must be set by - This information supplements the ``colorspace`` and must be set by
the driver for capture streams and by the application for output the driver for capture streams and by the application for output
streams, see :ref:`colorspaces`. streams, see :ref:`colorspaces`.
* - enum :c:type:`v4l2_xfer_func`
- .. row 14
- enum :c:type:`v4l2_xfer_func`
- ``xfer_func`` - ``xfer_func``
- This information supplements the ``colorspace`` and must be set by - This information supplements the ``colorspace`` and must be set by
the driver for capture streams and by the application for output the driver for capture streams and by the application for output
streams, see :ref:`colorspaces`. streams, see :ref:`colorspaces`.
Documentation/media/uapi/v4l/pixfmt-003.rst
View file @ c2b66caf
...@@ -21,30 +21,15 @@ describing all planes of that format. ...@@ -21,30 +21,15 @@ describing all planes of that format.
:stub-columns: 0 :stub-columns: 0
:widths: 1 1 2 :widths: 1 1 2
* - __u32
- .. row 1
- __u32
- ``sizeimage`` - ``sizeimage``
- Maximum size in bytes required for image data in this plane. - Maximum size in bytes required for image data in this plane.
* - __u32
- .. row 2
- __u32
- ``bytesperline`` - ``bytesperline``
- Distance in bytes between the leftmost pixels in two adjacent - Distance in bytes between the leftmost pixels in two adjacent
lines. See struct :c:type:`v4l2_pix_format`. lines. See struct :c:type:`v4l2_pix_format`.
* - __u16
- .. row 3
- __u16
- ``reserved[6]`` - ``reserved[6]``
- Reserved for future extensions. Should be zeroed by drivers and - Reserved for future extensions. Should be zeroed by drivers and
applications. applications.
...@@ -58,112 +43,52 @@ describing all planes of that format. ...@@ -58,112 +43,52 @@ describing all planes of that format.
:stub-columns: 0 :stub-columns: 0
:widths: 1 1 2 :widths: 1 1 2
* - __u32
- .. row 1
- __u32
- ``width`` - ``width``
- Image width in pixels. See struct - Image width in pixels. See struct
:c:type:`v4l2_pix_format`. :c:type:`v4l2_pix_format`.
* - __u32
- .. row 2
- __u32
- ``height`` - ``height``
- Image height in pixels. See struct - Image height in pixels. See struct
:c:type:`v4l2_pix_format`. :c:type:`v4l2_pix_format`.
* - __u32
- .. row 3
- __u32
- ``pixelformat`` - ``pixelformat``
- The pixel format. Both single- and multi-planar four character - The pixel format. Both single- and multi-planar four character
codes can be used. codes can be used.
* - enum :c:type:`v4l2_field`
- .. row 4
- enum :c:type:`v4l2_field`
- ``field`` - ``field``
- See struct :c:type:`v4l2_pix_format`. - See struct :c:type:`v4l2_pix_format`.
* - enum :c:type:`v4l2_colorspace`
- .. row 5
- enum :c:type:`v4l2_colorspace`
- ``colorspace`` - ``colorspace``
- See struct :c:type:`v4l2_pix_format`. - See struct :c:type:`v4l2_pix_format`.
* - struct :c:type:`v4l2_plane_pix_format`
- .. row 6
- struct :c:type:`v4l2_plane_pix_format`
- ``plane_fmt[VIDEO_MAX_PLANES]`` - ``plane_fmt[VIDEO_MAX_PLANES]``
- An array of structures describing format of each plane this pixel - An array of structures describing format of each plane this pixel
format consists of. The number of valid entries in this array has format consists of. The number of valid entries in this array has
to be put in the ``num_planes`` field. to be put in the ``num_planes`` field.
* - __u8
- .. row 7
- __u8
- ``num_planes`` - ``num_planes``
- Number of planes (i.e. separate memory buffers) for this format - Number of planes (i.e. separate memory buffers) for this format
and the number of valid entries in the ``plane_fmt`` array. and the number of valid entries in the ``plane_fmt`` array.
* - __u8
- .. row 8
- __u8
- ``flags`` - ``flags``
- Flags set by the application or driver, see :ref:`format-flags`. - Flags set by the application or driver, see :ref:`format-flags`.
* - enum :c:type:`v4l2_ycbcr_encoding`
- .. row 9
- enum :c:type:`v4l2_ycbcr_encoding`
- ``ycbcr_enc`` - ``ycbcr_enc``
- This information supplements the ``colorspace`` and must be set by - This information supplements the ``colorspace`` and must be set by
the driver for capture streams and by the application for output the driver for capture streams and by the application for output
streams, see :ref:`colorspaces`. streams, see :ref:`colorspaces`.
* - enum :c:type:`v4l2_quantization`
- .. row 10
- enum :c:type:`v4l2_quantization`
- ``quantization`` - ``quantization``
- This information supplements the ``colorspace`` and must be set by - This information supplements the ``colorspace`` and must be set by
the driver for capture streams and by the application for output the driver for capture streams and by the application for output
streams, see :ref:`colorspaces`. streams, see :ref:`colorspaces`.
* - enum :c:type:`v4l2_xfer_func`
- .. row 11
- enum :c:type:`v4l2_xfer_func`
- ``xfer_func`` - ``xfer_func``
- This information supplements the ``colorspace`` and must be set by - This information supplements the ``colorspace`` and must be set by
the driver for capture streams and by the application for output the driver for capture streams and by the application for output
streams, see :ref:`colorspaces`. streams, see :ref:`colorspaces`.
* - __u8
- .. row 12
- __u8
- ``reserved[7]`` - ``reserved[7]``
- Reserved for future extensions. Should be zeroed by drivers and - Reserved for future extensions. Should be zeroed by drivers and
applications. applications.
Documentation/media/uapi/v4l/pixfmt-006.rst
View file @ c2b66caf
...@@ -33,84 +33,32 @@ needs to be filled in. ...@@ -33,84 +33,32 @@ needs to be filled in.
:header-rows: 1 :header-rows: 1
:stub-columns: 0 :stub-columns: 0
* - Identifier
- .. row 1
- Identifier
- Details - Details
* - ``V4L2_COLORSPACE_DEFAULT``
- .. row 2
- ``V4L2_COLORSPACE_DEFAULT``
- The default colorspace. This can be used by applications to let - The default colorspace. This can be used by applications to let
the driver fill in the colorspace. the driver fill in the colorspace.
* - ``V4L2_COLORSPACE_SMPTE170M``
- .. row 3
- ``V4L2_COLORSPACE_SMPTE170M``
- See :ref:`col-smpte-170m`. - See :ref:`col-smpte-170m`.
* - ``V4L2_COLORSPACE_REC709``
- .. row 4
- ``V4L2_COLORSPACE_REC709``
- See :ref:`col-rec709`. - See :ref:`col-rec709`.
* - ``V4L2_COLORSPACE_SRGB``
- .. row 5
- ``V4L2_COLORSPACE_SRGB``
- See :ref:`col-srgb`. - See :ref:`col-srgb`.
* - ``V4L2_COLORSPACE_ADOBERGB``
- .. row 6
- ``V4L2_COLORSPACE_ADOBERGB``
- See :ref:`col-adobergb`. - See :ref:`col-adobergb`.
* - ``V4L2_COLORSPACE_BT2020``
- .. row 7
- ``V4L2_COLORSPACE_BT2020``
- See :ref:`col-bt2020`. - See :ref:`col-bt2020`.
* - ``V4L2_COLORSPACE_DCI_P3``
- .. row 8
- ``V4L2_COLORSPACE_DCI_P3``
- See :ref:`col-dcip3`. - See :ref:`col-dcip3`.
* - ``V4L2_COLORSPACE_SMPTE240M``
- .. row 9
- ``V4L2_COLORSPACE_SMPTE240M``
- See :ref:`col-smpte-240m`. - See :ref:`col-smpte-240m`.
* - ``V4L2_COLORSPACE_470_SYSTEM_M``
- .. row 10
- ``V4L2_COLORSPACE_470_SYSTEM_M``
- See :ref:`col-sysm`. - See :ref:`col-sysm`.
* - ``V4L2_COLORSPACE_470_SYSTEM_BG``
- .. row 11
- ``V4L2_COLORSPACE_470_SYSTEM_BG``
- See :ref:`col-sysbg`. - See :ref:`col-sysbg`.
* - ``V4L2_COLORSPACE_JPEG``
- .. row 12
- ``V4L2_COLORSPACE_JPEG``
- See :ref:`col-jpeg`. - See :ref:`col-jpeg`.
* - ``V4L2_COLORSPACE_RAW``
- .. row 13
- ``V4L2_COLORSPACE_RAW``
- The raw colorspace. This is used for raw image capture where the - The raw colorspace. This is used for raw image capture where the
image is minimally processed and is using the internal colorspace image is minimally processed and is using the internal colorspace
of the device. The software that processes an image using this of the device. The software that processes an image using this
...@@ -125,59 +73,23 @@ needs to be filled in. ...@@ -125,59 +73,23 @@ needs to be filled in.
:header-rows: 1 :header-rows: 1
:stub-columns: 0 :stub-columns: 0
* - Identifier
- .. row 1
- Identifier
- Details - Details
* - ``V4L2_XFER_FUNC_DEFAULT``
- .. row 2
- ``V4L2_XFER_FUNC_DEFAULT``
- Use the default transfer function as defined by the colorspace. - Use the default transfer function as defined by the colorspace.
* - ``V4L2_XFER_FUNC_709``
- .. row 3
- ``V4L2_XFER_FUNC_709``
- Use the Rec. 709 transfer function. - Use the Rec. 709 transfer function.
* - ``V4L2_XFER_FUNC_SRGB``
- .. row 4
- ``V4L2_XFER_FUNC_SRGB``
- Use the sRGB transfer function. - Use the sRGB transfer function.
* - ``V4L2_XFER_FUNC_ADOBERGB``
- .. row 5
- ``V4L2_XFER_FUNC_ADOBERGB``
- Use the AdobeRGB transfer function. - Use the AdobeRGB transfer function.
* - ``V4L2_XFER_FUNC_SMPTE240M``
- .. row 6
- ``V4L2_XFER_FUNC_SMPTE240M``
- Use the SMPTE 240M transfer function. - Use the SMPTE 240M transfer function.
* - ``V4L2_XFER_FUNC_NONE``
- .. row 7
- ``V4L2_XFER_FUNC_NONE``
- Do not use a transfer function (i.e. use linear RGB values). - Do not use a transfer function (i.e. use linear RGB values).
* - ``V4L2_XFER_FUNC_DCI_P3``
- .. row 8
- ``V4L2_XFER_FUNC_DCI_P3``
- Use the DCI-P3 transfer function. - Use the DCI-P3 transfer function.
* - ``V4L2_XFER_FUNC_SMPTE2084``
- .. row 9
- ``V4L2_XFER_FUNC_SMPTE2084``
- Use the SMPTE 2084 transfer function. - Use the SMPTE 2084 transfer function.
...@@ -190,59 +102,23 @@ needs to be filled in. ...@@ -190,59 +102,23 @@ needs to be filled in.
:header-rows: 1 :header-rows: 1
:stub-columns: 0 :stub-columns: 0
* - Identifier
- .. row 1
- Identifier
- Details - Details
* - ``V4L2_YCBCR_ENC_DEFAULT``
- .. row 2
- ``V4L2_YCBCR_ENC_DEFAULT``
- Use the default Y'CbCr encoding as defined by the colorspace. - Use the default Y'CbCr encoding as defined by the colorspace.
* - ``V4L2_YCBCR_ENC_601``
- .. row 3
- ``V4L2_YCBCR_ENC_601``
- Use the BT.601 Y'CbCr encoding. - Use the BT.601 Y'CbCr encoding.
* - ``V4L2_YCBCR_ENC_709``
- .. row 4
- ``V4L2_YCBCR_ENC_709``
- Use the Rec. 709 Y'CbCr encoding. - Use the Rec. 709 Y'CbCr encoding.
* - ``V4L2_YCBCR_ENC_XV601``
- .. row 5
- ``V4L2_YCBCR_ENC_XV601``
- Use the extended gamut xvYCC BT.601 encoding. - Use the extended gamut xvYCC BT.601 encoding.
* - ``V4L2_YCBCR_ENC_XV709``
- .. row 6
- ``V4L2_YCBCR_ENC_XV709``
- Use the extended gamut xvYCC Rec. 709 encoding. - Use the extended gamut xvYCC Rec. 709 encoding.
* - ``V4L2_YCBCR_ENC_BT2020``
- .. row 7
- ``V4L2_YCBCR_ENC_BT2020``
- Use the default non-constant luminance BT.2020 Y'CbCr encoding. - Use the default non-constant luminance BT.2020 Y'CbCr encoding.
* - ``V4L2_YCBCR_ENC_BT2020_CONST_LUM``
- .. row 8
- ``V4L2_YCBCR_ENC_BT2020_CONST_LUM``
- Use the constant luminance BT.2020 Yc'CbcCrc encoding. - Use the constant luminance BT.2020 Yc'CbcCrc encoding.
* - ``V4L2_YCBCR_ENC_SMPTE_240M``
- .. row 9
- ``V4L2_YCBCR_ENC_SMPTE_240M``
- Use the SMPTE 240M Y'CbCr encoding. - Use the SMPTE 240M Y'CbCr encoding.
...@@ -255,35 +131,19 @@ needs to be filled in. ...@@ -255,35 +131,19 @@ needs to be filled in.
:header-rows: 1 :header-rows: 1
:stub-columns: 0 :stub-columns: 0
* - Identifier
- .. row 1
- Identifier
- Details - Details
* - ``V4L2_QUANTIZATION_DEFAULT``
- .. row 2
- ``V4L2_QUANTIZATION_DEFAULT``
- Use the default quantization encoding as defined by the - Use the default quantization encoding as defined by the
colorspace. This is always full range for R'G'B' (except for the colorspace. This is always full range for R'G'B' (except for the
BT.2020 colorspace) and usually limited range for Y'CbCr. BT.2020 colorspace) and usually limited range for Y'CbCr.
* - ``V4L2_QUANTIZATION_FULL_RANGE``
- .. row 3
- ``V4L2_QUANTIZATION_FULL_RANGE``
- Use the full range quantization encoding. I.e. the range [0…1] is - Use the full range quantization encoding. I.e. the range [0…1] is
mapped to [0…255] (with possible clipping to [1…254] to avoid the mapped to [0…255] (with possible clipping to [1…254] to avoid the
0x00 and 0xff values). Cb and Cr are mapped from [-0.5…0.5] to 0x00 and 0xff values). Cb and Cr are mapped from [-0.5…0.5] to
[0…255] (with possible clipping to [1…254] to avoid the 0x00 and [0…255] (with possible clipping to [1…254] to avoid the 0x00 and
0xff values). 0xff values).
* - ``V4L2_QUANTIZATION_LIM_RANGE``
- .. row 4
- ``V4L2_QUANTIZATION_LIM_RANGE``
- Use the limited range quantization encoding. I.e. the range [0…1] - Use the limited range quantization encoding. I.e. the range [0…1]
is mapped to [16…235]. Cb and Cr are mapped from [-0.5…0.5] to is mapped to [16…235]. Cb and Cr are mapped from [-0.5…0.5] to
[16…240]. [16…240].
Documentation/media/uapi/v4l/pixfmt-007.rst
View file @ c2b66caf
...@@ -26,45 +26,20 @@ are: ...@@ -26,45 +26,20 @@ are:
:stub-columns: 0 :stub-columns: 0
:widths: 1 1 2 :widths: 1 1 2
* - Color
- .. row 1
- Color
- x - x
- y - y
* - Red
- .. row 2
- Red
- 0.630 - 0.630
- 0.340 - 0.340
* - Green
- .. row 3
- Green
- 0.310 - 0.310
- 0.595 - 0.595
* - Blue
- .. row 4
- Blue
- 0.155 - 0.155
- 0.070 - 0.070
* - White Reference (D65)
- .. row 5
- White Reference (D65)
- 0.3127 - 0.3127
- 0.3290 - 0.3290
...@@ -132,45 +107,20 @@ and the white reference are: ...@@ -132,45 +107,20 @@ and the white reference are:
:stub-columns: 0 :stub-columns: 0
:widths: 1 1 2 :widths: 1 1 2
* - Color
- .. row 1
- Color
- x - x
- y - y
* - Red
- .. row 2
- Red
- 0.640 - 0.640
- 0.330 - 0.330
* - Green
- .. row 3
- Green
- 0.300 - 0.300
- 0.600 - 0.600
* - Blue
- .. row 4
- Blue
- 0.150 - 0.150
- 0.060 - 0.060
* - White Reference (D65)
- .. row 5
- White Reference (D65)
- 0.3127 - 0.3127
- 0.3290 - 0.3290
...@@ -273,45 +223,20 @@ The chromaticities of the primary colors and the white reference are: ...@@ -273,45 +223,20 @@ The chromaticities of the primary colors and the white reference are:
:stub-columns: 0 :stub-columns: 0
:widths: 1 1 2 :widths: 1 1 2
* - Color
- .. row 1
- Color
- x - x
- y - y
* - Red
- .. row 2
- Red
- 0.640 - 0.640
- 0.330 - 0.330
* - Green
- .. row 3
- Green
- 0.300 - 0.300
- 0.600 - 0.600
* - Blue
- .. row 4
- Blue
- 0.150 - 0.150
- 0.060 - 0.060
* - White Reference (D65)
- .. row 5
- White Reference (D65)
- 0.3127 - 0.3127
- 0.3290 - 0.3290
...@@ -376,45 +301,20 @@ are: ...@@ -376,45 +301,20 @@ are:
:stub-columns: 0 :stub-columns: 0
:widths: 1 1 2 :widths: 1 1 2
* - Color
- .. row 1
- Color
- x - x
- y - y
* - Red
- .. row 2
- Red
- 0.6400 - 0.6400
- 0.3300 - 0.3300
* - Green
- .. row 3
- Green
- 0.2100 - 0.2100
- 0.7100 - 0.7100
* - Blue
- .. row 4
- Blue
- 0.1500 - 0.1500
- 0.0600 - 0.0600
* - White Reference (D65)
- .. row 5
- White Reference (D65)
- 0.3127 - 0.3127
- 0.3290 - 0.3290
...@@ -468,45 +368,20 @@ of the primary colors and the white reference are: ...@@ -468,45 +368,20 @@ of the primary colors and the white reference are:
:stub-columns: 0 :stub-columns: 0
:widths: 1 1 2 :widths: 1 1 2
* - Color
- .. row 1
- Color
- x - x
- y - y
* - Red
- .. row 2
- Red
- 0.708 - 0.708
- 0.292 - 0.292
* - Green
- .. row 3
- Green
- 0.170 - 0.170
- 0.797 - 0.797
* - Blue
- .. row 4
- Blue
- 0.131 - 0.131
- 0.046 - 0.046
* - White Reference (D65)
- .. row 5
- White Reference (D65)
- 0.3127 - 0.3127
- 0.3290 - 0.3290
...@@ -592,45 +467,20 @@ The chromaticities of the primary colors and the white reference are: ...@@ -592,45 +467,20 @@ The chromaticities of the primary colors and the white reference are:
:stub-columns: 0 :stub-columns: 0
:widths: 1 1 2 :widths: 1 1 2
* - Color
- .. row 1
- Color
- x - x
- y - y
* - Red
- .. row 2
- Red
- 0.6800 - 0.6800
- 0.3200 - 0.3200
* - Green
- .. row 3
- Green
- 0.2650 - 0.2650
- 0.6900 - 0.6900
* - Blue
- .. row 4
- Blue
- 0.1500 - 0.1500
- 0.0600 - 0.0600
* - White Reference
- .. row 5
- White Reference
- 0.3140 - 0.3140
- 0.3510 - 0.3510
...@@ -671,45 +521,20 @@ and the white reference are: ...@@ -671,45 +521,20 @@ and the white reference are:
:stub-columns: 0 :stub-columns: 0
:widths: 1 1 2 :widths: 1 1 2
* - Color
- .. row 1
- Color
- x - x
- y - y
* - Red
- .. row 2
- Red
- 0.630 - 0.630
- 0.340 - 0.340
* - Green
- .. row 3
- Green
- 0.310 - 0.310
- 0.595 - 0.595
* - Blue
- .. row 4
- Blue
- 0.155 - 0.155
- 0.070 - 0.070
* - White Reference (D65)
- .. row 5
- White Reference (D65)
- 0.3127 - 0.3127
- 0.3290 - 0.3290
...@@ -767,45 +592,20 @@ reference are: ...@@ -767,45 +592,20 @@ reference are:
:stub-columns: 0 :stub-columns: 0
:widths: 1 1 2 :widths: 1 1 2
* - Color
- .. row 1
- Color
- x - x
- y - y
* - Red
- .. row 2
- Red
- 0.67 - 0.67
- 0.33 - 0.33
* - Green
- .. row 3
- Green
- 0.21 - 0.21
- 0.71 - 0.71
* - Blue
- .. row 4
- Blue
- 0.14 - 0.14
- 0.08 - 0.08
* - White Reference (C)
- .. row 5
- White Reference (C)
- 0.310 - 0.310
- 0.316 - 0.316
...@@ -871,45 +671,20 @@ are: ...@@ -871,45 +671,20 @@ are:
:stub-columns: 0 :stub-columns: 0
:widths: 1 1 2 :widths: 1 1 2
* - Color
- .. row 1
- Color
- x - x
- y - y
* - Red
- .. row 2
- Red
- 0.64 - 0.64
- 0.33 - 0.33
* - Green
- .. row 3
- Green
- 0.29 - 0.29
- 0.60 - 0.60
* - Blue
- .. row 4
- Blue
- 0.15 - 0.15
- 0.06 - 0.06
* - White Reference (D65)
- .. row 5
- White Reference (D65)
- 0.3127 - 0.3127
- 0.3290 - 0.3290
......
Documentation/media/uapi/v4l/pixfmt-013.rst
View file @ c2b66caf
...@@ -14,118 +14,74 @@ Compressed Formats ...@@ -14,118 +14,74 @@ Compressed Formats
:stub-columns: 0 :stub-columns: 0
:widths: 3 1 4 :widths: 3 1 4
* - Identifier
- .. row 1
- Identifier
- Code - Code
- Details - Details
* .. _V4L2-PIX-FMT-JPEG:
- .. _V4L2-PIX-FMT-JPEG:
- ``V4L2_PIX_FMT_JPEG`` - ``V4L2_PIX_FMT_JPEG``
- 'JPEG' - 'JPEG'
- TBD. See also :ref:`VIDIOC_G_JPEGCOMP <VIDIOC_G_JPEGCOMP>`, - TBD. See also :ref:`VIDIOC_G_JPEGCOMP <VIDIOC_G_JPEGCOMP>`,
:ref:`VIDIOC_S_JPEGCOMP <VIDIOC_G_JPEGCOMP>`. :ref:`VIDIOC_S_JPEGCOMP <VIDIOC_G_JPEGCOMP>`.
* .. _V4L2-PIX-FMT-MPEG:
- .. _V4L2-PIX-FMT-MPEG:
- ``V4L2_PIX_FMT_MPEG`` - ``V4L2_PIX_FMT_MPEG``
- 'MPEG' - 'MPEG'
- MPEG multiplexed stream. The actual format is determined by - MPEG multiplexed stream. The actual format is determined by
extended control ``V4L2_CID_MPEG_STREAM_TYPE``, see extended control ``V4L2_CID_MPEG_STREAM_TYPE``, see
:ref:`mpeg-control-id`. :ref:`mpeg-control-id`.
* .. _V4L2-PIX-FMT-H264:
- .. _V4L2-PIX-FMT-H264:
- ``V4L2_PIX_FMT_H264`` - ``V4L2_PIX_FMT_H264``
- 'H264' - 'H264'
- H264 video elementary stream with start codes. - H264 video elementary stream with start codes.
* .. _V4L2-PIX-FMT-H264-NO-SC:
- .. _V4L2-PIX-FMT-H264-NO-SC:
- ``V4L2_PIX_FMT_H264_NO_SC`` - ``V4L2_PIX_FMT_H264_NO_SC``
- 'AVC1' - 'AVC1'
- H264 video elementary stream without start codes. - H264 video elementary stream without start codes.
* .. _V4L2-PIX-FMT-H264-MVC:
- .. _V4L2-PIX-FMT-H264-MVC:
- ``V4L2_PIX_FMT_H264_MVC`` - ``V4L2_PIX_FMT_H264_MVC``
- 'M264' - 'M264'
- H264 MVC video elementary stream. - H264 MVC video elementary stream.
* .. _V4L2-PIX-FMT-H263:
- .. _V4L2-PIX-FMT-H263:
- ``V4L2_PIX_FMT_H263`` - ``V4L2_PIX_FMT_H263``
- 'H263' - 'H263'
- H263 video elementary stream. - H263 video elementary stream.
* .. _V4L2-PIX-FMT-MPEG1:
- .. _V4L2-PIX-FMT-MPEG1:
- ``V4L2_PIX_FMT_MPEG1`` - ``V4L2_PIX_FMT_MPEG1``
- 'MPG1' - 'MPG1'
- MPEG1 video elementary stream. - MPEG1 video elementary stream.
* .. _V4L2-PIX-FMT-MPEG2:
- .. _V4L2-PIX-FMT-MPEG2:
- ``V4L2_PIX_FMT_MPEG2`` - ``V4L2_PIX_FMT_MPEG2``
- 'MPG2' - 'MPG2'
- MPEG2 video elementary stream. - MPEG2 video elementary stream.
* .. _V4L2-PIX-FMT-MPEG4:
- .. _V4L2-PIX-FMT-MPEG4:
- ``V4L2_PIX_FMT_MPEG4`` - ``V4L2_PIX_FMT_MPEG4``
- 'MPG4' - 'MPG4'
- MPEG4 video elementary stream. - MPEG4 video elementary stream.
* .. _V4L2-PIX-FMT-XVID:
- .. _V4L2-PIX-FMT-XVID:
- ``V4L2_PIX_FMT_XVID`` - ``V4L2_PIX_FMT_XVID``
- 'XVID' - 'XVID'
- Xvid video elementary stream. - Xvid video elementary stream.
* .. _V4L2-PIX-FMT-VC1-ANNEX-G:
- .. _V4L2-PIX-FMT-VC1-ANNEX-G:
- ``V4L2_PIX_FMT_VC1_ANNEX_G`` - ``V4L2_PIX_FMT_VC1_ANNEX_G``
- 'VC1G' - 'VC1G'
- VC1, SMPTE 421M Annex G compliant stream. - VC1, SMPTE 421M Annex G compliant stream.
* .. _V4L2-PIX-FMT-VC1-ANNEX-L:
- .. _V4L2-PIX-FMT-VC1-ANNEX-L:
- ``V4L2_PIX_FMT_VC1_ANNEX_L`` - ``V4L2_PIX_FMT_VC1_ANNEX_L``
- 'VC1L' - 'VC1L'
- VC1, SMPTE 421M Annex L compliant stream. - VC1, SMPTE 421M Annex L compliant stream.
* .. _V4L2-PIX-FMT-VP8:
- .. _V4L2-PIX-FMT-VP8:
- ``V4L2_PIX_FMT_VP8`` - ``V4L2_PIX_FMT_VP8``
- 'VP80' - 'VP80'
- VP8 video elementary stream. - VP8 video elementary stream.
Documentation/media/uapi/v4l/pixfmt-grey.rst
View file @ c2b66caf
...@@ -22,51 +22,23 @@ Each cell is one byte. ...@@ -22,51 +22,23 @@ Each cell is one byte.
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
* - start + 0:
- .. row 1
- start + 0:
- Y'\ :sub:`00` - Y'\ :sub:`00`
- Y'\ :sub:`01` - Y'\ :sub:`01`
- Y'\ :sub:`02` - Y'\ :sub:`02`
- Y'\ :sub:`03` - Y'\ :sub:`03`
* - start + 4:
- .. row 2
- start + 4:
- Y'\ :sub:`10` - Y'\ :sub:`10`
- Y'\ :sub:`11` - Y'\ :sub:`11`
- Y'\ :sub:`12` - Y'\ :sub:`12`
- Y'\ :sub:`13` - Y'\ :sub:`13`
* - start + 8:
- .. row 3
- start + 8:
- Y'\ :sub:`20` - Y'\ :sub:`20`
- Y'\ :sub:`21` - Y'\ :sub:`21`
- Y'\ :sub:`22` - Y'\ :sub:`22`
- Y'\ :sub:`23` - Y'\ :sub:`23`
* - start + 12:
- .. row 4
- start + 12:
- Y'\ :sub:`30` - Y'\ :sub:`30`
- Y'\ :sub:`31` - Y'\ :sub:`31`
- Y'\ :sub:`32` - Y'\ :sub:`32`
- Y'\ :sub:`33` - Y'\ :sub:`33`
Documentation/media/uapi/v4l/pixfmt-indexed.rst
View file @ c2b66caf
...@@ -17,57 +17,31 @@ the palette, this must be done with ioctls of the Linux framebuffer API. ...@@ -17,57 +17,31 @@ the palette, this must be done with ioctls of the Linux framebuffer API.
:header-rows: 2 :header-rows: 2
:stub-columns: 0 :stub-columns: 0
* - Identifier
- .. row 1
- Identifier
- Code - Code
- -
- :cspan:`7` Byte 0 - :cspan:`7` Byte 0
* -
- .. row 2
-
- -
- Bit - Bit
- 7 - 7
- 6 - 6
- 5 - 5
- 4 - 4
- 3 - 3
- 2 - 2
- 1 - 1
- 0 - 0
* .. _V4L2-PIX-FMT-PAL8:
- .. _V4L2-PIX-FMT-PAL8:
- ``V4L2_PIX_FMT_PAL8`` - ``V4L2_PIX_FMT_PAL8``
- 'PAL8' - 'PAL8'
- -
- i\ :sub:`7` - i\ :sub:`7`
- i\ :sub:`6` - i\ :sub:`6`
- i\ :sub:`5` - i\ :sub:`5`
- i\ :sub:`4` - i\ :sub:`4`
- i\ :sub:`3` - i\ :sub:`3`
- i\ :sub:`2` - i\ :sub:`2`
- i\ :sub:`1` - i\ :sub:`1`
- i\ :sub:`0` - i\ :sub:`0`
Documentation/media/uapi/v4l/pixfmt-m420.rst
View file @ c2b66caf
...@@ -34,77 +34,35 @@ Each cell is one byte. ...@@ -34,77 +34,35 @@ Each cell is one byte.
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
* - start + 0:
- .. row 1
- start + 0:
- Y'\ :sub:`00` - Y'\ :sub:`00`
- Y'\ :sub:`01` - Y'\ :sub:`01`
- Y'\ :sub:`02` - Y'\ :sub:`02`
- Y'\ :sub:`03` - Y'\ :sub:`03`
* - start + 4:
- .. row 2
- start + 4:
- Y'\ :sub:`10` - Y'\ :sub:`10`
- Y'\ :sub:`11` - Y'\ :sub:`11`
- Y'\ :sub:`12` - Y'\ :sub:`12`
- Y'\ :sub:`13` - Y'\ :sub:`13`
* - start + 8:
- .. row 3
- start + 8:
- Cb\ :sub:`00` - Cb\ :sub:`00`
- Cr\ :sub:`00` - Cr\ :sub:`00`
- Cb\ :sub:`01` - Cb\ :sub:`01`
- Cr\ :sub:`01` - Cr\ :sub:`01`
* - start + 16:
- .. row 4
- start + 16:
- Y'\ :sub:`20` - Y'\ :sub:`20`
- Y'\ :sub:`21` - Y'\ :sub:`21`
- Y'\ :sub:`22` - Y'\ :sub:`22`
- Y'\ :sub:`23` - Y'\ :sub:`23`
* - start + 20:
- .. row 5
- start + 20:
- Y'\ :sub:`30` - Y'\ :sub:`30`
- Y'\ :sub:`31` - Y'\ :sub:`31`
- Y'\ :sub:`32` - Y'\ :sub:`32`
- Y'\ :sub:`33` - Y'\ :sub:`33`
* - start + 24:
- .. row 6
- start + 24:
- Cb\ :sub:`10` - Cb\ :sub:`10`
- Cr\ :sub:`10` - Cr\ :sub:`10`
- Cb\ :sub:`11` - Cb\ :sub:`11`
- Cr\ :sub:`11` - Cr\ :sub:`11`
...@@ -116,100 +74,53 @@ Each cell is one byte. ...@@ -116,100 +74,53 @@ Each cell is one byte.
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
* -
- .. row 1
-
- 0 - 0
- -
- 1 - 1
- 2 - 2
- -
- 3 - 3
* - 0
- .. row 2
- 0
- Y - Y
- -
- Y - Y
- Y - Y
- -
- Y - Y
* -
- .. row 3
-
- -
- C - C
- -
- -
- C - C
- -
* - 1
- .. row 4
- 1
- Y - Y
- -
- Y - Y
- Y - Y
- -
- Y - Y
* -
- .. row 5 * - 2
-
- .. row 6
- 2
- Y - Y
- -
- Y - Y
- Y - Y
- -
- Y - Y
* -
- .. row 7
-
- -
- C - C
- -
- -
- C - C
- -
* - 3
- .. row 8
- 3
- Y - Y
- -
- Y - Y
- Y - Y
- -
- Y - Y
Documentation/media/uapi/v4l/pixfmt-nv12.rst
View file @ c2b66caf
...@@ -39,76 +39,35 @@ Each cell is one byte. ...@@ -39,76 +39,35 @@ Each cell is one byte.
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
- .. row 1 * - start + 0:
- start + 0:
- Y'\ :sub:`00` - Y'\ :sub:`00`
- Y'\ :sub:`01` - Y'\ :sub:`01`
- Y'\ :sub:`02` - Y'\ :sub:`02`
- Y'\ :sub:`03` - Y'\ :sub:`03`
* - start + 4:
- .. row 2
- start + 4:
- Y'\ :sub:`10` - Y'\ :sub:`10`
- Y'\ :sub:`11` - Y'\ :sub:`11`
- Y'\ :sub:`12` - Y'\ :sub:`12`
- Y'\ :sub:`13` - Y'\ :sub:`13`
* - start + 8:
- .. row 3
- start + 8:
- Y'\ :sub:`20` - Y'\ :sub:`20`
- Y'\ :sub:`21` - Y'\ :sub:`21`
- Y'\ :sub:`22` - Y'\ :sub:`22`
- Y'\ :sub:`23` - Y'\ :sub:`23`
* - start + 12:
- .. row 4
- start + 12:
- Y'\ :sub:`30` - Y'\ :sub:`30`
- Y'\ :sub:`31` - Y'\ :sub:`31`
- Y'\ :sub:`32` - Y'\ :sub:`32`
- Y'\ :sub:`33` - Y'\ :sub:`33`
* - start + 16:
- .. row 5
- start + 16:
- Cb\ :sub:`00` - Cb\ :sub:`00`
- Cr\ :sub:`00` - Cr\ :sub:`00`
- Cb\ :sub:`01` - Cb\ :sub:`01`
- Cr\ :sub:`01` - Cr\ :sub:`01`
* - start + 20:
- .. row 6
- start + 20:
- Cb\ :sub:`10` - Cb\ :sub:`10`
- Cr\ :sub:`10` - Cr\ :sub:`10`
- Cb\ :sub:`11` - Cb\ :sub:`11`
- Cr\ :sub:`11` - Cr\ :sub:`11`
...@@ -118,100 +77,53 @@ Each cell is one byte. ...@@ -118,100 +77,53 @@ Each cell is one byte.
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
* -
- .. row 1
-
- 0 - 0
- -
- 1 - 1
- 2 - 2
- -
- 3 - 3
* - 0
- .. row 2
- 0
- Y - Y
- -
- Y - Y
- Y - Y
- -
- Y - Y
* -
- .. row 3
-
- -
- C - C
- -
- -
- C - C
- -
* - 1
- .. row 4
- 1
- Y - Y
- -
- Y - Y
- Y - Y
- -
- Y - Y
* -
- .. row 5 * - 2
-
- .. row 6
- 2
- Y - Y
- -
- Y - Y
- Y - Y
- -
- Y - Y
* -
- .. row 7
-
- -
- C - C
- -
- -
- C - C
- -
* - 3
- .. row 8
- 3
- Y - Y
- -
- Y - Y
- Y - Y
- -
- Y - Y
Documentation/media/uapi/v4l/pixfmt-nv12m.rst
View file @ c2b66caf
...@@ -50,80 +50,36 @@ Each cell is one byte. ...@@ -50,80 +50,36 @@ Each cell is one byte.
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
- .. row 1 * - start0 + 0:
- start0 + 0:
- Y'\ :sub:`00` - Y'\ :sub:`00`
- Y'\ :sub:`01` - Y'\ :sub:`01`
- Y'\ :sub:`02` - Y'\ :sub:`02`
- Y'\ :sub:`03` - Y'\ :sub:`03`
* - start0 + 4:
- .. row 2
- start0 + 4:
- Y'\ :sub:`10` - Y'\ :sub:`10`
- Y'\ :sub:`11` - Y'\ :sub:`11`
- Y'\ :sub:`12` - Y'\ :sub:`12`
- Y'\ :sub:`13` - Y'\ :sub:`13`
* - start0 + 8:
- .. row 3
- start0 + 8:
- Y'\ :sub:`20` - Y'\ :sub:`20`
- Y'\ :sub:`21` - Y'\ :sub:`21`
- Y'\ :sub:`22` - Y'\ :sub:`22`
- Y'\ :sub:`23` - Y'\ :sub:`23`
* - start0 + 12:
- .. row 4
- start0 + 12:
- Y'\ :sub:`30` - Y'\ :sub:`30`
- Y'\ :sub:`31` - Y'\ :sub:`31`
- Y'\ :sub:`32` - Y'\ :sub:`32`
- Y'\ :sub:`33` - Y'\ :sub:`33`
* -
- .. row 5 * - start1 + 0:
-
- .. row 6
- start1 + 0:
- Cb\ :sub:`00` - Cb\ :sub:`00`
- Cr\ :sub:`00` - Cr\ :sub:`00`
- Cb\ :sub:`01` - Cb\ :sub:`01`
- Cr\ :sub:`01` - Cr\ :sub:`01`
* - start1 + 4:
- .. row 7
- start1 + 4:
- Cb\ :sub:`10` - Cb\ :sub:`10`
- Cr\ :sub:`10` - Cr\ :sub:`10`
- Cb\ :sub:`11` - Cb\ :sub:`11`
- Cr\ :sub:`11` - Cr\ :sub:`11`
...@@ -135,101 +91,54 @@ Each cell is one byte. ...@@ -135,101 +91,54 @@ Each cell is one byte.
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
* -
- .. row 1
-
- 0 - 0
- -
- 1 - 1
- 2 - 2
- -
- 3 - 3
* - 0
- .. row 2
- 0
- Y - Y
- -
- Y - Y
- Y - Y
- -
- Y - Y
* -
- .. row 3
-
- -
- C - C
- -
- -
- C - C
- -
* - 1
- .. row 4
- 1
- Y - Y
- -
- Y - Y
- Y - Y
- -
- Y - Y
* -
- .. row 5 * - 2
-
- .. row 6
- 2
- Y - Y
- -
- Y - Y
- Y - Y
- -
- Y - Y
* -
- .. row 7
-
- -
- C - C
- -
- -
- -
- C - C
- -
* - 3
- .. row 8
- 3
- Y - Y
- -
- Y - Y
- Y - Y
- -
- Y - Y
Documentation/media/uapi/v4l/pixfmt-nv16.rst
View file @ c2b66caf
...@@ -37,100 +37,45 @@ Each cell is one byte. ...@@ -37,100 +37,45 @@ Each cell is one byte.
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
- .. row 1 * - start + 0:
- start + 0:
- Y'\ :sub:`00` - Y'\ :sub:`00`
- Y'\ :sub:`01` - Y'\ :sub:`01`
- Y'\ :sub:`02` - Y'\ :sub:`02`
- Y'\ :sub:`03` - Y'\ :sub:`03`
* - start + 4:
- .. row 2
- start + 4:
- Y'\ :sub:`10` - Y'\ :sub:`10`
- Y'\ :sub:`11` - Y'\ :sub:`11`
- Y'\ :sub:`12` - Y'\ :sub:`12`
- Y'\ :sub:`13` - Y'\ :sub:`13`
* - start + 8:
- .. row 3
- start + 8:
- Y'\ :sub:`20` - Y'\ :sub:`20`
- Y'\ :sub:`21` - Y'\ :sub:`21`
- Y'\ :sub:`22` - Y'\ :sub:`22`
- Y'\ :sub:`23` - Y'\ :sub:`23`
* - start + 12:
- .. row 4
- start + 12:
- Y'\ :sub:`30` - Y'\ :sub:`30`
- Y'\ :sub:`31` - Y'\ :sub:`31`
- Y'\ :sub:`32` - Y'\ :sub:`32`
- Y'\ :sub:`33` - Y'\ :sub:`33`
* - start + 16:
- .. row 5
- start + 16:
- Cb\ :sub:`00` - Cb\ :sub:`00`
- Cr\ :sub:`00` - Cr\ :sub:`00`
- Cb\ :sub:`01` - Cb\ :sub:`01`
- Cr\ :sub:`01` - Cr\ :sub:`01`
* - start + 20:
- .. row 6
- start + 20:
- Cb\ :sub:`10` - Cb\ :sub:`10`
- Cr\ :sub:`10` - Cr\ :sub:`10`
- Cb\ :sub:`11` - Cb\ :sub:`11`
- Cr\ :sub:`11` - Cr\ :sub:`11`
* - start + 24:
- .. row 7
- start + 24:
- Cb\ :sub:`20` - Cb\ :sub:`20`
- Cr\ :sub:`20` - Cr\ :sub:`20`
- Cb\ :sub:`21` - Cb\ :sub:`21`
- Cr\ :sub:`21` - Cr\ :sub:`21`
* - start + 28:
- .. row 8
- start + 28:
- Cb\ :sub:`30` - Cb\ :sub:`30`
- Cr\ :sub:`30` - Cr\ :sub:`30`
- Cb\ :sub:`31` - Cb\ :sub:`31`
- Cr\ :sub:`31` - Cr\ :sub:`31`
...@@ -142,124 +87,67 @@ Each cell is one byte. ...@@ -142,124 +87,67 @@ Each cell is one byte.
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
* -
- .. row 1
-
- 0 - 0
- -
- 1 - 1
- 2 - 2
- -
- 3 - 3
* - 0
- .. row 2
- 0
- Y - Y
- -
- Y - Y
- Y - Y
- -
- Y - Y
* -
- .. row 3
-
- -
- C - C
- -
- -
- C - C
- -
* - 1
- .. row 4
- 1
- Y - Y
- -
- Y - Y
- Y - Y
- -
- Y - Y
* -
- .. row 5
-
- -
- C - C
- -
- -
- C - C
-
- .. row 6
- -
* -
- .. row 7 * - 2
- 2
- Y - Y
- -
- Y - Y
- Y - Y
- -
- Y - Y
* -
- .. row 8
-
- -
- C - C
- -
- -
- C - C
- -
* - 3
- .. row 9
- 3
- Y - Y
- -
- Y - Y
- Y - Y
- -
- Y - Y
* -
- .. row 10
-
- -
- C - C
- -
- -
- C - C
- -
Documentation/media/uapi/v4l/pixfmt-sdr-cs08.rst
View file @ c2b66caf
...@@ -24,15 +24,7 @@ Each cell is one byte. ...@@ -24,15 +24,7 @@ Each cell is one byte.
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
* - start + 0:
- .. row 1
- start + 0:
- I'\ :sub:`0` - I'\ :sub:`0`
* - start + 1:
- .. row 2
- start + 1:
- Q'\ :sub:`0` - Q'\ :sub:`0`
Documentation/media/uapi/v4l/pixfmt-sdr-cs14le.rst
View file @ c2b66caf
...@@ -26,18 +26,9 @@ Each cell is one byte. ...@@ -26,18 +26,9 @@ Each cell is one byte.
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
- .. row 1 * - start + 0:
- start + 0:
- I'\ :sub:`0[7:0]` - I'\ :sub:`0[7:0]`
- I'\ :sub:`0[13:8]` - I'\ :sub:`0[13:8]`
* - start + 2:
- .. row 2
- start + 2:
- Q'\ :sub:`0[7:0]` - Q'\ :sub:`0[7:0]`
- Q'\ :sub:`0[13:8]` - Q'\ :sub:`0[13:8]`
Documentation/media/uapi/v4l/pixfmt-sdr-cu08.rst
View file @ c2b66caf
...@@ -24,14 +24,7 @@ Each cell is one byte. ...@@ -24,14 +24,7 @@ Each cell is one byte.
:header-rows: 0 :header-rows: 0
:stub-columns: 0 :stub-columns: 0
- .. row 1 * - start + 0:
- start + 0:
- I'\ :sub:`0` - I'\ :sub:`0`
* - start + 1:
- .. row 2
- start + 1:
- Q'\ :sub:`0` - Q'\ :sub:`0`
Documentation/media/uapi/v4l/pixfmt-uv8.rst
View file @ c2b66caf
This diff is collapsed.
Documentation/media/uapi/v4l/pixfmt-y10.rst
View file @ c2b66caf
This diff is collapsed.
Documentation/media/uapi/v4l/pixfmt-y12.rst
View file @ c2b66caf
This diff is collapsed.
Documentation/media/uapi/v4l/pixfmt-y16.rst
View file @ c2b66caf
This diff is collapsed.
Documentation/media/uapi/v4l/pixfmt-y8i.rst
View file @ c2b66caf
This diff is collapsed.
Documentation/media/uapi/v4l/pixfmt-z16.rst
View file @ c2b66caf
This diff is collapsed.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment
GitLab Nexedi Edition | About GitLab | About Nexedi | 沪ICP备2021021310号-2 | 沪ICP备2021021310号-7