2016-06-30 13:18:56 +00:00
|
|
|
.. -*- coding: utf-8; mode: rst -*-
|
|
|
|
|
|
|
|
|
|
******************
|
|
|
|
|
Compressed Formats
|
|
|
|
|
******************
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.. _compressed-formats:
|
|
|
|
|
|
[media] docs-rst: add tabularcolumns to all tables
LaTeX doesn't handle too well auto-width on tables, and ReST
markup requires an special tag to give it the needed hints.
As we're using A4 paper, we have 17cm of useful spaces. As
most media tables have widths, let's use it to generate the
needed via the following perl script:
my ($line_size, $table_header, $has_cols) = (17.5, 0, 0);
my $out;
my $header = "";
my @widths = ();
sub round { $_[0] > 0 ? int($_[0] + .5) : -int(-$_[0] + .5) }
while (<>) {
if (!$table_header) {
$has_cols = 1 if (m/..\s+tabularcolumns::/);
if (m/..\s+flat-table::/) {
$table_header = 1;
$header = $_;
next;
}
$out .= $_;
next;
}
$header .= $_;
@widths = split(/ /, $1) if (m/:widths:\s+(.*)/);
if (m/^\n$/) {
if (!$has_cols && @widths) {
my ($tot, $t, $i) = (0, 0, 0);
foreach my $v(@widths) { $tot += $v; };
$out .= ".. tabularcolumns:: |";
for ($i = 0; $i < scalar @widths - 1; $i++) {
my $v = $widths[$i];
my $w = round(10 * ($v * $line_size) / $tot) / 10;
$out .= sprintf "p{%.1fcm}|", $w;
$t += $w;
}
my $w = $line_size - $t;
$out .= sprintf "p{%.1fcm}|\n\n", $w;
}
$out .= $header;
$table_header = 0;
$has_cols = 0;
$header = "";
@widths = ();
}
}
print $out;
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-08-17 11:14:19 +00:00
|
|
|
.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
|
|
|
|
|
|
2016-06-30 13:18:56 +00:00
|
|
|
.. flat-table:: Compressed Image Formats
|
|
|
|
|
:header-rows: 1
|
|
|
|
|
:stub-columns: 0
|
|
|
|
|
:widths: 3 1 4
|
|
|
|
|
|
[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: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
2016-09-05 11:44:34 +00:00
|
|
|
* - Identifier
|
|
|
|
|
- Code
|
|
|
|
|
- Details
|
|
|
|
|
* .. _V4L2-PIX-FMT-JPEG:
|
|
|
|
|
|
|
|
|
|
- ``V4L2_PIX_FMT_JPEG``
|
|
|
|
|
- 'JPEG'
|
|
|
|
|
- TBD. See also :ref:`VIDIOC_G_JPEGCOMP <VIDIOC_G_JPEGCOMP>`,
|
|
|
|
|
:ref:`VIDIOC_S_JPEGCOMP <VIDIOC_G_JPEGCOMP>`.
|
|
|
|
|
* .. _V4L2-PIX-FMT-MPEG:
|
|
|
|
|
|
|
|
|
|
- ``V4L2_PIX_FMT_MPEG``
|
|
|
|
|
- 'MPEG'
|
|
|
|
|
- MPEG multiplexed stream. The actual format is determined by
|
|
|
|
|
extended control ``V4L2_CID_MPEG_STREAM_TYPE``, see
|
|
|
|
|
:ref:`mpeg-control-id`.
|
|
|
|
|
* .. _V4L2-PIX-FMT-H264:
|
|
|
|
|
|
|
|
|
|
- ``V4L2_PIX_FMT_H264``
|
|
|
|
|
- 'H264'
|
|
|
|
|
- H264 video elementary stream with start codes.
|
|
|
|
|
* .. _V4L2-PIX-FMT-H264-NO-SC:
|
|
|
|
|
|
|
|
|
|
- ``V4L2_PIX_FMT_H264_NO_SC``
|
|
|
|
|
- 'AVC1'
|
|
|
|
|
- H264 video elementary stream without start codes.
|
|
|
|
|
* .. _V4L2-PIX-FMT-H264-MVC:
|
|
|
|
|
|
|
|
|
|
- ``V4L2_PIX_FMT_H264_MVC``
|
|
|
|
|
- 'M264'
|
|
|
|
|
- H264 MVC video elementary stream.
|
|
|
|
|
* .. _V4L2-PIX-FMT-H263:
|
|
|
|
|
|
|
|
|
|
- ``V4L2_PIX_FMT_H263``
|
|
|
|
|
- 'H263'
|
|
|
|
|
- H263 video elementary stream.
|
|
|
|
|
* .. _V4L2-PIX-FMT-MPEG1:
|
|
|
|
|
|
|
|
|
|
- ``V4L2_PIX_FMT_MPEG1``
|
|
|
|
|
- 'MPG1'
|
|
|
|
|
- MPEG1 video elementary stream.
|
|
|
|
|
* .. _V4L2-PIX-FMT-MPEG2:
|
|
|
|
|
|
|
|
|
|
- ``V4L2_PIX_FMT_MPEG2``
|
|
|
|
|
- 'MPG2'
|
|
|
|
|
- MPEG2 video elementary stream.
|
2018-09-13 14:51:52 +00:00
|
|
|
* .. _V4L2-PIX-FMT-MPEG2-SLICE:
|
|
|
|
|
|
|
|
|
|
- ``V4L2_PIX_FMT_MPEG2_SLICE``
|
|
|
|
|
- 'MG2S'
|
|
|
|
|
- MPEG-2 parsed slice data, as extracted from the MPEG-2 bitstream.
|
|
|
|
|
This format is adapted for stateless video decoders that implement a
|
|
|
|
|
MPEG-2 pipeline (using the :ref:`codec` and :ref:`media-request-api`).
|
|
|
|
|
Metadata associated with the frame to decode is required to be passed
|
|
|
|
|
through the ``V4L2_CID_MPEG_VIDEO_MPEG2_SLICE_PARAMS`` control and
|
|
|
|
|
quantization matrices can optionally be specified through the
|
|
|
|
|
``V4L2_CID_MPEG_VIDEO_MPEG2_QUANTIZATION`` control.
|
|
|
|
|
See the :ref:`associated Codec Control IDs <v4l2-mpeg-mpeg2>`.
|
|
|
|
|
Exactly one output and one capture buffer must be provided for use with
|
|
|
|
|
this pixel format. The output buffer must contain the appropriate number
|
|
|
|
|
of macroblocks to decode a full corresponding frame to the matching
|
|
|
|
|
capture buffer.
|
[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: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
2016-09-05 11:44:34 +00:00
|
|
|
* .. _V4L2-PIX-FMT-MPEG4:
|
|
|
|
|
|
|
|
|
|
- ``V4L2_PIX_FMT_MPEG4``
|
|
|
|
|
- 'MPG4'
|
|
|
|
|
- MPEG4 video elementary stream.
|
|
|
|
|
* .. _V4L2-PIX-FMT-XVID:
|
|
|
|
|
|
|
|
|
|
- ``V4L2_PIX_FMT_XVID``
|
|
|
|
|
- 'XVID'
|
|
|
|
|
- Xvid video elementary stream.
|
|
|
|
|
* .. _V4L2-PIX-FMT-VC1-ANNEX-G:
|
|
|
|
|
|
|
|
|
|
- ``V4L2_PIX_FMT_VC1_ANNEX_G``
|
|
|
|
|
- 'VC1G'
|
|
|
|
|
- VC1, SMPTE 421M Annex G compliant stream.
|
|
|
|
|
* .. _V4L2-PIX-FMT-VC1-ANNEX-L:
|
|
|
|
|
|
|
|
|
|
- ``V4L2_PIX_FMT_VC1_ANNEX_L``
|
|
|
|
|
- 'VC1L'
|
|
|
|
|
- VC1, SMPTE 421M Annex L compliant stream.
|
|
|
|
|
* .. _V4L2-PIX-FMT-VP8:
|
|
|
|
|
|
|
|
|
|
- ``V4L2_PIX_FMT_VP8``
|
|
|
|
|
- 'VP80'
|
|
|
|
|
- VP8 video elementary stream.
|
2016-09-02 12:19:59 +00:00
|
|
|
* .. _V4L2-PIX-FMT-VP9:
|
|
|
|
|
|
|
|
|
|
- ``V4L2_PIX_FMT_VP9``
|
|
|
|
|
- 'VP90'
|
|
|
|
|
- VP9 video elementary stream.
|
2018-02-02 12:25:43 +00:00
|
|
|
* .. _V4L2-PIX-FMT-HEVC:
|
|
|
|
|
|
|
|
|
|
- ``V4L2_PIX_FMT_HEVC``
|
|
|
|
|
- 'HEVC'
|
|
|
|
|
- HEVC/H.265 video elementary stream.
|
2018-07-04 14:13:47 +00:00
|
|
|
* .. _V4L2-PIX-FMT-FWHT:
|
|
|
|
|
|
|
|
|
|
- ``V4L2_PIX_FMT_FWHT``
|
|
|
|
|
- 'FWHT'
|
|
|
|
|
- Video elementary stream using a codec based on the Fast Walsh Hadamard
|
|
|
|
|
Transform. This codec is implemented by the vicodec ('Virtual Codec')
|
2018-08-21 06:53:34 +00:00
|
|
|
driver. See the codec-fwht.h header for more details.
|
