aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/DocBook
diff options
context:
space:
mode:
authorKamil Debski <k.debski@samsung.com>2011-06-14 09:31:04 -0400
committerMauro Carvalho Chehab <mchehab@redhat.com>2011-07-27 16:55:40 -0400
commite65e4f134db36c70f13e9703d8e253e6b196ca47 (patch)
treeeea3b847710e3fea27d6484aa6176f4812a30815 /Documentation/DocBook
parent4fa64dae8c55ea9d3be4eb5f23ad0c9a60fa6d95 (diff)
[media] v4l: add control definitions for codec devices
Add control definitions and documentation for controls specific to codec devices. Signed-off-by: Kamil Debski <k.debski@samsung.com> Signed-off-by: Kyungmin Park <kyungmin.park@samsung.com> Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
Diffstat (limited to 'Documentation/DocBook')
-rw-r--r--Documentation/DocBook/media/v4l/controls.xml969
1 files changed, 969 insertions, 0 deletions
diff --git a/Documentation/DocBook/media/v4l/controls.xml b/Documentation/DocBook/media/v4l/controls.xml
index e2046754e871..85164016ed26 100644
--- a/Documentation/DocBook/media/v4l/controls.xml
+++ b/Documentation/DocBook/media/v4l/controls.xml
@@ -329,6 +329,22 @@ minimum value disables backlight compensation.</entry>
329<constant>V4L2_CID_ILLUMINATORS_2</constant> + 1).</entry> 329<constant>V4L2_CID_ILLUMINATORS_2</constant> + 1).</entry>
330 </row> 330 </row>
331 <row> 331 <row>
332 <entry><constant>V4L2_CID_MIN_BUFFERS_FOR_CAPTURE</constant></entry>
333 <entry>integer</entry>
334 <entry>This is a read-only control that can be read by the application
335and used as a hint to determine the number of CAPTURE buffers to pass to REQBUFS.
336The value is the minimum number of CAPTURE buffers that is necessary for hardware
337to work.</entry>
338 </row>
339 <row>
340 <entry><constant>V4L2_CID_MIN_BUFFERS_FOR_OUTPUT</constant></entry>
341 <entry>integer</entry>
342 <entry>This is a read-only control that can be read by the application
343and used as a hint to determine the number of OUTPUT buffers to pass to REQBUFS.
344The value is the minimum number of OUTPUT buffers that is necessary for hardware
345to work.</entry>
346 </row>
347 <row>
332 <entry><constant>V4L2_CID_PRIVATE_BASE</constant></entry> 348 <entry><constant>V4L2_CID_PRIVATE_BASE</constant></entry>
333 <entry></entry> 349 <entry></entry>
334 <entry>ID of the first custom (driver specific) control. 350 <entry>ID of the first custom (driver specific) control.
@@ -1417,6 +1433,959 @@ of the video. The supplied 32-bit integer is interpreted as follows (bit
1417 </tbody> 1433 </tbody>
1418 </entrytbl> 1434 </entrytbl>
1419 </row> 1435 </row>
1436
1437
1438 <row><entry></entry></row>
1439 <row>
1440 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_DECODER_SLICE_INTERFACE</constant>&nbsp;</entry>
1441 <entry>boolean</entry>
1442 </row>
1443 <row><entry spanname="descr">If enabled the decoder expects to receive a single slice per buffer, otherwise
1444the decoder expects a single frame in per buffer. Applicable to the decoder, all codecs.
1445</entry>
1446 </row>
1447
1448 <row><entry></entry></row>
1449 <row>
1450 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_ENABLE</constant>&nbsp;</entry>
1451 <entry>boolean</entry>
1452 </row>
1453 <row><entry spanname="descr">Enable writing sample aspect ratio in the Video Usability Information.
1454Applicable to the H264 encoder.</entry>
1455 </row>
1456
1457 <row><entry></entry></row>
1458 <row>
1459 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_VUI_SAR_IDC</constant>&nbsp;</entry>
1460 <entry>enum&nbsp;v4l2_mpeg_video_h264_vui_sar_idc</entry>
1461 </row>
1462 <row><entry spanname="descr">VUI sample aspect ratio indicator for H.264 encoding. The value
1463is defined in the table E-1 in the standard. Applicable to the H264 encoder.</entry>
1464 </row>
1465 <row>
1466 <entrytbl spanname="descr" cols="2">
1467 <tbody valign="top">
1468
1469 <row>
1470 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_UNSPECIFIED</constant>&nbsp;</entry>
1471 <entry>Unspecified</entry>
1472 </row>
1473 <row>
1474 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_1x1</constant>&nbsp;</entry>
1475 <entry>1x1</entry>
1476 </row>
1477 <row>
1478 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_12x11</constant>&nbsp;</entry>
1479 <entry>12x11</entry>
1480 </row>
1481 <row>
1482 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_10x11</constant>&nbsp;</entry>
1483 <entry>10x11</entry>
1484 </row>
1485 <row>
1486 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_16x11</constant>&nbsp;</entry>
1487 <entry>16x11</entry>
1488 </row>
1489 <row>
1490 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_40x33</constant>&nbsp;</entry>
1491 <entry>40x33</entry>
1492 </row>
1493 <row>
1494 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_24x11</constant>&nbsp;</entry>
1495 <entry>24x11</entry>
1496 </row>
1497 <row>
1498 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_20x11</constant>&nbsp;</entry>
1499 <entry>20x11</entry>
1500 </row>
1501 <row>
1502 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_32x11</constant>&nbsp;</entry>
1503 <entry>32x11</entry>
1504 </row>
1505 <row>
1506 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_80x33</constant>&nbsp;</entry>
1507 <entry>80x33</entry>
1508 </row>
1509 <row>
1510 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_18x11</constant>&nbsp;</entry>
1511 <entry>18x11</entry>
1512 </row>
1513 <row>
1514 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_15x11</constant>&nbsp;</entry>
1515 <entry>15x11</entry>
1516 </row>
1517 <row>
1518 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_64x33</constant>&nbsp;</entry>
1519 <entry>64x33</entry>
1520 </row>
1521 <row>
1522 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_160x99</constant>&nbsp;</entry>
1523 <entry>160x99</entry>
1524 </row>
1525 <row>
1526 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_4x3</constant>&nbsp;</entry>
1527 <entry>4x3</entry>
1528 </row>
1529 <row>
1530 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_3x2</constant>&nbsp;</entry>
1531 <entry>3x2</entry>
1532 </row>
1533 <row>
1534 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_2x1</constant>&nbsp;</entry>
1535 <entry>2x1</entry>
1536 </row>
1537 <row>
1538 <entry><constant>V4L2_MPEG_VIDEO_H264_VUI_SAR_IDC_EXTENDED</constant>&nbsp;</entry>
1539 <entry>Extended SAR</entry>
1540 </row>
1541 </tbody>
1542 </entrytbl>
1543 </row>
1544
1545 <row><entry></entry></row>
1546 <row>
1547 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_WIDTH</constant>&nbsp;</entry>
1548 <entry>integer</entry>
1549 </row>
1550 <row><entry spanname="descr">Extended sample aspect ratio width for H.264 VUI encoding.
1551Applicable to the H264 encoder.</entry>
1552 </row>
1553
1554 <row><entry></entry></row>
1555 <row>
1556 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_VUI_EXT_SAR_HEIGHT</constant>&nbsp;</entry>
1557 <entry>integer</entry>
1558 </row>
1559 <row><entry spanname="descr">Extended sample aspect ratio height for H.264 VUI encoding.
1560Applicable to the H264 encoder.</entry>
1561 </row>
1562
1563 <row><entry></entry></row>
1564 <row>
1565 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_LEVEL</constant>&nbsp;</entry>
1566 <entry>enum&nbsp;v4l2_mpeg_video_h264_level</entry>
1567 </row>
1568 <row><entry spanname="descr">The level information for the H264 video elementary stream.
1569Applicable to the H264 encoder.
1570Possible values are:</entry>
1571 </row>
1572 <row>
1573 <entrytbl spanname="descr" cols="2">
1574 <tbody valign="top">
1575 <row>
1576 <entry><constant>V4L2_MPEG_VIDEO_H264_LEVEL_1_0</constant>&nbsp;</entry>
1577 <entry>Level 1.0</entry>
1578 </row>
1579 <row>
1580 <entry><constant>V4L2_MPEG_VIDEO_H264_LEVEL_1B</constant>&nbsp;</entry>
1581 <entry>Level 1B</entry>
1582 </row>
1583 <row>
1584 <entry><constant>V4L2_MPEG_VIDEO_H264_LEVEL_1_1</constant>&nbsp;</entry>
1585 <entry>Level 1.1</entry>
1586 </row>
1587 <row>
1588 <entry><constant>V4L2_MPEG_VIDEO_H264_LEVEL_1_2</constant>&nbsp;</entry>
1589 <entry>Level 1.2</entry>
1590 </row>
1591 <row>
1592 <entry><constant>V4L2_MPEG_VIDEO_H264_LEVEL_1_3</constant>&nbsp;</entry>
1593 <entry>Level 1.3</entry>
1594 </row>
1595 <row>
1596 <entry><constant>V4L2_MPEG_VIDEO_H264_LEVEL_2_0</constant>&nbsp;</entry>
1597 <entry>Level 2.0</entry>
1598 </row>
1599 <row>
1600 <entry><constant>V4L2_MPEG_VIDEO_H264_LEVEL_2_1</constant>&nbsp;</entry>
1601 <entry>Level 2.1</entry>
1602 </row>
1603 <row>
1604 <entry><constant>V4L2_MPEG_VIDEO_H264_LEVEL_2_2</constant>&nbsp;</entry>
1605 <entry>Level 2.2</entry>
1606 </row>
1607 <row>
1608 <entry><constant>V4L2_MPEG_VIDEO_H264_LEVEL_3_0</constant>&nbsp;</entry>
1609 <entry>Level 3.0</entry>
1610 </row>
1611 <row>
1612 <entry><constant>V4L2_MPEG_VIDEO_H264_LEVEL_3_1</constant>&nbsp;</entry>
1613 <entry>Level 3.1</entry>
1614 </row>
1615 <row>
1616 <entry><constant>V4L2_MPEG_VIDEO_H264_LEVEL_3_2</constant>&nbsp;</entry>
1617 <entry>Level 3.2</entry>
1618 </row>
1619 <row>
1620 <entry><constant>V4L2_MPEG_VIDEO_H264_LEVEL_4_0</constant>&nbsp;</entry>
1621 <entry>Level 4.0</entry>
1622 </row>
1623 <row>
1624 <entry><constant>V4L2_MPEG_VIDEO_H264_LEVEL_4_1</constant>&nbsp;</entry>
1625 <entry>Level 4.1</entry>
1626 </row>
1627 <row>
1628 <entry><constant>V4L2_MPEG_VIDEO_H264_LEVEL_4_2</constant>&nbsp;</entry>
1629 <entry>Level 4.2</entry>
1630 </row>
1631 <row>
1632 <entry><constant>V4L2_MPEG_VIDEO_H264_LEVEL_5_0</constant>&nbsp;</entry>
1633 <entry>Level 5.0</entry>
1634 </row>
1635 <row>
1636 <entry><constant>V4L2_MPEG_VIDEO_H264_LEVEL_5_1</constant>&nbsp;</entry>
1637 <entry>Level 5.1</entry>
1638 </row>
1639 </tbody>
1640 </entrytbl>
1641 </row>
1642
1643 <row><entry></entry></row>
1644 <row>
1645 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_MPEG4_LEVEL</constant>&nbsp;</entry>
1646 <entry>enum&nbsp;v4l2_mpeg_video_mpeg4_level</entry>
1647 </row>
1648 <row><entry spanname="descr">The level information for the MPEG4 elementary stream.
1649Applicable to the MPEG4 encoder.
1650Possible values are:</entry>
1651 </row>
1652 <row>
1653 <entrytbl spanname="descr" cols="2">
1654 <tbody valign="top">
1655 <row>
1656 <entry><constant>V4L2_MPEG_VIDEO_LEVEL_0</constant>&nbsp;</entry>
1657 <entry>Level 0</entry>
1658 </row>
1659 <row>
1660 <entry><constant>V4L2_MPEG_VIDEO_LEVEL_0B</constant>&nbsp;</entry>
1661 <entry>Level 0b</entry>
1662 </row>
1663 <row>
1664 <entry><constant>V4L2_MPEG_VIDEO_LEVEL_1</constant>&nbsp;</entry>
1665 <entry>Level 1</entry>
1666 </row>
1667 <row>
1668 <entry><constant>V4L2_MPEG_VIDEO_LEVEL_2</constant>&nbsp;</entry>
1669 <entry>Level 2</entry>
1670 </row>
1671 <row>
1672 <entry><constant>V4L2_MPEG_VIDEO_LEVEL_3</constant>&nbsp;</entry>
1673 <entry>Level 3</entry>
1674 </row>
1675 <row>
1676 <entry><constant>V4L2_MPEG_VIDEO_LEVEL_3B</constant>&nbsp;</entry>
1677 <entry>Level 3b</entry>
1678 </row>
1679 <row>
1680 <entry><constant>V4L2_MPEG_VIDEO_LEVEL_4</constant>&nbsp;</entry>
1681 <entry>Level 4</entry>
1682 </row>
1683 <row>
1684 <entry><constant>V4L2_MPEG_VIDEO_LEVEL_5</constant>&nbsp;</entry>
1685 <entry>Level 5</entry>
1686 </row>
1687 </tbody>
1688 </entrytbl>
1689 </row>
1690
1691 <row><entry></entry></row>
1692 <row>
1693 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_PROFILE</constant>&nbsp;</entry>
1694 <entry>enum&nbsp;v4l2_mpeg_h264_profile</entry>
1695 </row>
1696 <row><entry spanname="descr">The profile information for H264.
1697Applicable to the H264 encoder.
1698Possible values are:</entry>
1699 </row>
1700 <row>
1701 <entrytbl spanname="descr" cols="2">
1702 <tbody valign="top">
1703 <row>
1704 <entry><constant>V4L2_MPEG_VIDEO_H264_PROFILE_BASELINE</constant>&nbsp;</entry>
1705 <entry>Baseline profile</entry>
1706 </row>
1707 <row>
1708 <entry><constant>V4L2_MPEG_VIDEO_H264_PROFILE_CONSTRAINED_BASELINE</constant>&nbsp;</entry>
1709 <entry>Constrained Baseline profile</entry>
1710 </row>
1711 <row>
1712 <entry><constant>V4L2_MPEG_VIDEO_H264_PROFILE_MAIN</constant>&nbsp;</entry>
1713 <entry>Main profile</entry>
1714 </row>
1715 <row>
1716 <entry><constant>V4L2_MPEG_VIDEO_H264_PROFILE_EXTENDED</constant>&nbsp;</entry>
1717 <entry>Extended profile</entry>
1718 </row>
1719 <row>
1720 <entry><constant>V4L2_MPEG_VIDEO_H264_PROFILE_HIGH</constant>&nbsp;</entry>
1721 <entry>High profile</entry>
1722 </row>
1723 <row>
1724 <entry><constant>V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10</constant>&nbsp;</entry>
1725 <entry>High 10 profile</entry>
1726 </row>
1727 <row>
1728 <entry><constant>V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422</constant>&nbsp;</entry>
1729 <entry>High 422 profile</entry>
1730 </row>
1731 <row>
1732 <entry><constant>V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_PREDICTIVE</constant>&nbsp;</entry>
1733 <entry>High 444 Predictive profile</entry>
1734 </row>
1735 <row>
1736 <entry><constant>V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_10_INTRA</constant>&nbsp;</entry>
1737 <entry>High 10 Intra profile</entry>
1738 </row>
1739 <row>
1740 <entry><constant>V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_422_INTRA</constant>&nbsp;</entry>
1741 <entry>High 422 Intra profile</entry>
1742 </row>
1743 <row>
1744 <entry><constant>V4L2_MPEG_VIDEO_H264_PROFILE_HIGH_444_INTRA</constant>&nbsp;</entry>
1745 <entry>High 444 Intra profile</entry>
1746 </row>
1747 <row>
1748 <entry><constant>V4L2_MPEG_VIDEO_H264_PROFILE_CAVLC_444_INTRA</constant>&nbsp;</entry>
1749 <entry>CAVLC 444 Intra profile</entry>
1750 </row>
1751 <row>
1752 <entry><constant>V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_BASELINE</constant>&nbsp;</entry>
1753 <entry>Scalable Baseline profile</entry>
1754 </row>
1755 <row>
1756 <entry><constant>V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH</constant>&nbsp;</entry>
1757 <entry>Scalable High profile</entry>
1758 </row>
1759 <row>
1760 <entry><constant>V4L2_MPEG_VIDEO_H264_PROFILE_SCALABLE_HIGH_INTRA</constant>&nbsp;</entry>
1761 <entry>Scalable High Intra profile</entry>
1762 </row>
1763 <row>
1764 <entry><constant>V4L2_MPEG_VIDEO_H264_PROFILE_STEREO_HIGH</constant>&nbsp;</entry>
1765 <entry>Stereo High profile</entry>
1766 </row>
1767 <row>
1768 <entry><constant>V4L2_MPEG_VIDEO_H264_PROFILE_MULTIVIEW_HIGH</constant>&nbsp;</entry>
1769 <entry>Multiview High profile</entry>
1770 </row>
1771
1772 </tbody>
1773 </entrytbl>
1774 </row>
1775
1776 <row><entry></entry></row>
1777 <row>
1778 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_MPEG4_PROFILE</constant>&nbsp;</entry>
1779 <entry>enum&nbsp;v4l2_mpeg_mpeg4_profile</entry>
1780 </row>
1781 <row><entry spanname="descr">The profile information for MPEG4.
1782Applicable to the MPEG4 encoder.
1783Possible values are:</entry>
1784 </row>
1785 <row>
1786 <entrytbl spanname="descr" cols="2">
1787 <tbody valign="top">
1788 <row>
1789 <entry><constant>V4L2_MPEG_VIDEO_PROFILE_SIMPLE</constant>&nbsp;</entry>
1790 <entry>Simple profile</entry>
1791 </row>
1792 <row>
1793 <entry><constant>V4L2_MPEG_VIDEO_PROFILE_ADVANCED_SIMPLE</constant>&nbsp;</entry>
1794 <entry>Advanced Simple profile</entry>
1795 </row>
1796 <row>
1797 <entry><constant>V4L2_MPEG_VIDEO_PROFILE_CORE</constant>&nbsp;</entry>
1798 <entry>Core profile</entry>
1799 </row>
1800 <row>
1801 <entry><constant>V4L2_MPEG_VIDEO_PROFILE_SIMPLE_SCALABLE</constant>&nbsp;</entry>
1802 <entry>Simple Scalable profile</entry>
1803 </row>
1804 <row>
1805 <entry><constant>V4L2_MPEG_VIDEO_PROFILE_ADVANCED_CODING_EFFICIENCY</constant>&nbsp;</entry>
1806 <entry></entry>
1807 </row>
1808 </tbody>
1809 </entrytbl>
1810 </row>
1811
1812 <row><entry></entry></row>
1813 <row>
1814 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_MAX_REF_PIC</constant>&nbsp;</entry>
1815 <entry>integer</entry>
1816 </row>
1817 <row><entry spanname="descr">The maximum number of reference pictures used for encoding.
1818Applicable to the encoder.
1819</entry>
1820 </row>
1821
1822 <row><entry></entry></row>
1823 <row>
1824 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE</constant>&nbsp;</entry>
1825 <entry>enum&nbsp;v4l2_mpeg_multi_slice_mode</entry>
1826 </row>
1827 <row><entry spanname="descr">Determines how the encoder should handle division of frame into slices.
1828Applicable to the encoder.
1829Possible values are:</entry>
1830 </row>
1831 <row>
1832 <entrytbl spanname="descr" cols="2">
1833 <tbody valign="top">
1834 <row>
1835 <entry><constant>V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_SINGLE</constant>&nbsp;</entry>
1836 <entry>Single slice per frame.</entry>
1837 </row>
1838 <row>
1839 <entry><constant>V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_MB</constant>&nbsp;</entry>
1840 <entry>Multiple slices with set maximum number of macroblocks per slice.</entry>
1841 </row>
1842 <row>
1843 <entry><constant>V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_BYTES</constant>&nbsp;</entry>
1844 <entry>Multiple slice with set maximum size in bytes per slice.</entry>
1845 </row>
1846 </tbody>
1847 </entrytbl>
1848 </row>
1849
1850 <row><entry></entry></row>
1851 <row>
1852 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_MB</constant>&nbsp;</entry>
1853 <entry>integer</entry>
1854 </row>
1855 <row><entry spanname="descr">The maximum number of macroblocks in a slice. Used when
1856<constant>V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE</constant> is set to <constant>V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_MB</constant>.
1857Applicable to the encoder.</entry>
1858 </row>
1859
1860 <row><entry></entry></row>
1861 <row>
1862 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MAX_BYTES</constant>&nbsp;</entry>
1863 <entry>integer</entry>
1864 </row>
1865 <row><entry spanname="descr">The maximum size of a slice in bytes. Used when
1866<constant>V4L2_CID_MPEG_VIDEO_MULTI_SLICE_MODE</constant> is set to <constant>V4L2_MPEG_VIDEO_MULTI_SLICE_MODE_MAX_BYTES</constant>.
1867Applicable to the encoder.</entry>
1868 </row>
1869
1870 <row><entry></entry></row>
1871 <row>
1872 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_MODE</constant>&nbsp;</entry>
1873 <entry>enum&nbsp;v4l2_mpeg_h264_loop_filter_mode</entry>
1874 </row>
1875 <row><entry spanname="descr">Loop filter mode for H264 encoder.
1876Possible values are:</entry>
1877 </row>
1878 <row>
1879 <entrytbl spanname="descr" cols="2">
1880 <tbody valign="top">
1881 <row>
1882 <entry><constant>V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_ENABLED</constant>&nbsp;</entry>
1883 <entry>Loop filter is enabled.</entry>
1884 </row>
1885 <row>
1886 <entry><constant>V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED</constant>&nbsp;</entry>
1887 <entry>Loop filter is disabled.</entry>
1888 </row>
1889 <row>
1890 <entry><constant>V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_DISABLED_AT_SLICE_BOUNDARY</constant>&nbsp;</entry>
1891 <entry>Loop filter is disabled at the slice boundary.</entry>
1892 </row>
1893 </tbody>
1894 </entrytbl>
1895 </row>
1896
1897 <row><entry></entry></row>
1898 <row>
1899 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_ALPHA</constant>&nbsp;</entry>
1900 <entry>integer</entry>
1901 </row>
1902 <row><entry spanname="descr">Loop filter alpha coefficient, defined in the H264 standard.
1903Applicable to the H264 encoder.</entry>
1904 </row>
1905
1906 <row><entry></entry></row>
1907 <row>
1908 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_LOOP_FILTER_BETA</constant>&nbsp;</entry>
1909 <entry>integer</entry>
1910 </row>
1911 <row><entry spanname="descr">Loop filter beta coefficient, defined in the H264 standard.
1912Applicable to the H264 encoder.</entry>
1913 </row>
1914
1915 <row><entry></entry></row>
1916 <row>
1917 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_ENTROPY_MODE</constant>&nbsp;</entry>
1918 <entry>enum&nbsp;v4l2_mpeg_h264_symbol_mode</entry>
1919 </row>
1920 <row><entry spanname="descr">Entropy coding mode for H264 - CABAC/CAVALC.
1921Applicable to the H264 encoder.
1922Possible values are:</entry>
1923 </row>
1924 <row>
1925 <entrytbl spanname="descr" cols="2">
1926 <tbody valign="top">
1927 <row>
1928 <entry><constant>V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CAVLC</constant>&nbsp;</entry>
1929 <entry>Use CAVLC entropy coding.</entry>
1930 </row>
1931 <row>
1932 <entry><constant>V4L2_MPEG_VIDEO_H264_ENTROPY_MODE_CABAC</constant>&nbsp;</entry>
1933 <entry>Use CABAC entropy coding.</entry>
1934 </row>
1935 </tbody>
1936 </entrytbl>
1937 </row>
1938
1939 <row><entry></entry></row>
1940 <row>
1941 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_8X8_TRANSFORM</constant>&nbsp;</entry>
1942 <entry>boolean</entry>
1943 </row>
1944 <row><entry spanname="descr">Enable 8X8 transform for H264. Applicable to the H264 encoder.</entry>
1945 </row>
1946
1947 <row><entry></entry></row>
1948 <row>
1949 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_CYCLIC_INTRA_REFRESH_MB</constant>&nbsp;</entry>
1950 <entry>integer</entry>
1951 </row>
1952 <row><entry spanname="descr">Cyclic intra macroblock refresh. This is the number of continuous macroblocks
1953refreshed every frame. Each frame a succesive set of macroblocks is refreshed until the cycle completes and starts from the
1954top of the frame. Applicable to H264, H263 and MPEG4 encoder.</entry>
1955 </row>
1956
1957 <row><entry></entry></row>
1958 <row>
1959 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_FRAME_RC_ENABLE</constant>&nbsp;</entry>
1960 <entry>boolean</entry>
1961 </row>
1962 <row><entry spanname="descr">Frame level rate control enable.
1963If this control is disabled then the quantization parameter for each frame type is constant and set with appropriate controls
1964(e.g. <constant>V4L2_CID_MPEG_VIDEO_H263_I_FRAME_QP</constant>).
1965If frame rate control is enabled then quantization parameter is adjusted to meet the chosen bitrate. Minimum and maximum value
1966for the quantization parameter can be set with appropriate controls (e.g. <constant>V4L2_CID_MPEG_VIDEO_H263_MIN_QP</constant>).
1967Applicable to encoders.</entry>
1968 </row>
1969
1970 <row><entry></entry></row>
1971 <row>
1972 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE</constant>&nbsp;</entry>
1973 <entry>boolean</entry>
1974 </row>
1975 <row><entry spanname="descr">Macroblock level rate control enable.
1976Applicable to the MPEG4 and H264 encoders.</entry>
1977 </row>
1978
1979 <row><entry></entry></row>
1980 <row>
1981 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_MPEG4_QPEL</constant>&nbsp;</entry>
1982 <entry>boolean</entry>
1983 </row>
1984 <row><entry spanname="descr">Quarter pixel motion estimation for MPEG4. Applicable to the MPEG4 encoder.</entry>
1985 </row>
1986
1987 <row><entry></entry></row>
1988 <row>
1989 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H263_I_FRAME_QP</constant>&nbsp;</entry>
1990 <entry>integer</entry>
1991 </row>
1992 <row><entry spanname="descr">Quantization parameter for an I frame for H263. Valid range: from 1 to 31.</entry>
1993 </row>
1994
1995 <row><entry></entry></row>
1996 <row>
1997 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H263_MIN_QP</constant>&nbsp;</entry>
1998 <entry>integer</entry>
1999 </row>
2000 <row><entry spanname="descr">Minimum quantization parameter for H263. Valid range: from 1 to 31.</entry>
2001 </row>
2002
2003 <row><entry></entry></row>
2004 <row>
2005 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H263_MAX_QP</constant>&nbsp;</entry>
2006 <entry>integer</entry>
2007 </row>
2008 <row><entry spanname="descr">Maximum quantization parameter for H263. Valid range: from 1 to 31.</entry>
2009 </row>
2010
2011 <row><entry></entry></row>
2012 <row>
2013 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H263_P_FRAME_QP</constant>&nbsp;</entry>
2014 <entry>integer</entry>
2015 </row>
2016 <row><entry spanname="descr">Quantization parameter for an P frame for H263. Valid range: from 1 to 31.</entry>
2017 </row>
2018
2019 <row><entry></entry></row>
2020 <row>
2021 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H263_B_FRAME_QP</constant>&nbsp;</entry>
2022 <entry>integer</entry>
2023 </row>
2024 <row><entry spanname="descr">Quantization parameter for an B frame for H263. Valid range: from 1 to 31.</entry>
2025 </row>
2026
2027 <row><entry></entry></row>
2028 <row>
2029 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_I_FRAME_QP</constant>&nbsp;</entry>
2030 <entry>integer</entry>
2031 </row>
2032 <row><entry spanname="descr">Quantization parameter for an I frame for H264. Valid range: from 0 to 51.</entry>
2033 </row>
2034
2035 <row><entry></entry></row>
2036 <row>
2037 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_MIN_QP</constant>&nbsp;</entry>
2038 <entry>integer</entry>
2039 </row>
2040 <row><entry spanname="descr">Minimum quantization parameter for H264. Valid range: from 0 to 51.</entry>
2041 </row>
2042
2043 <row><entry></entry></row>
2044 <row>
2045 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_MAX_QP</constant>&nbsp;</entry>
2046 <entry>integer</entry>
2047 </row>
2048 <row><entry spanname="descr">Maximum quantization parameter for H264. Valid range: from 0 to 51.</entry>
2049 </row>
2050
2051 <row><entry></entry></row>
2052 <row>
2053 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_P_FRAME_QP</constant>&nbsp;</entry>
2054 <entry>integer</entry>
2055 </row>
2056 <row><entry spanname="descr">Quantization parameter for an P frame for H264. Valid range: from 0 to 51.</entry>
2057 </row>
2058
2059 <row><entry></entry></row>
2060 <row>
2061 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_B_FRAME_QP</constant>&nbsp;</entry>
2062 <entry>integer</entry>
2063 </row>
2064 <row><entry spanname="descr">Quantization parameter for an B frame for H264. Valid range: from 0 to 51.</entry>
2065 </row>
2066
2067 <row><entry></entry></row>
2068 <row>
2069 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_MPEG4_I_FRAME_QP</constant>&nbsp;</entry>
2070 <entry>integer</entry>
2071 </row>
2072 <row><entry spanname="descr">Quantization parameter for an I frame for MPEG4. Valid range: from 1 to 31.</entry>
2073 </row>
2074
2075 <row><entry></entry></row>
2076 <row>
2077 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_MPEG4_MIN_QP</constant>&nbsp;</entry>
2078 <entry>integer</entry>
2079 </row>
2080 <row><entry spanname="descr">Minimum quantization parameter for MPEG4. Valid range: from 1 to 31.</entry>
2081 </row>
2082
2083 <row><entry></entry></row>
2084 <row>
2085 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_MPEG4_MAX_QP</constant>&nbsp;</entry>
2086 <entry>integer</entry>
2087 </row>
2088 <row><entry spanname="descr">Maximum quantization parameter for MPEG4. Valid range: from 1 to 31.</entry>
2089 </row>
2090
2091 <row><entry></entry></row>
2092 <row>
2093 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_MPEG4_P_FRAME_QP</constant>&nbsp;</entry>
2094 <entry>integer</entry>
2095 </row>
2096 <row><entry spanname="descr">Quantization parameter for an P frame for MPEG4. Valid range: from 1 to 31.</entry>
2097 </row>
2098
2099 <row><entry></entry></row>
2100 <row>
2101 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_MPEG4_B_FRAME_QP</constant>&nbsp;</entry>
2102 <entry>integer</entry>
2103 </row>
2104 <row><entry spanname="descr">Quantization parameter for an B frame for MPEG4. Valid range: from 1 to 31.</entry>
2105 </row>
2106
2107 <row><entry></entry></row>
2108 <row>
2109 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_VBV_SIZE</constant>&nbsp;</entry>
2110 <entry>integer</entry>
2111 </row>
2112 <row><entry spanname="descr">The Video Buffer Verifier size in kilobytes, it is used as a limitation of frame skip.
2113The VBV is defined in the standard as a mean to verify that the produced stream will be succesfully decoded.
2114The standard describes it as "Part of a hypothetical decoder that is conceptually connected to the
2115output of the encoder. Its purpose is to provide a constraint on the variability of the data rate that an
2116encoder or editing process may produce.".
2117Applicable to the MPEG1, MPEG2, MPEG4 encoders.</entry>
2118 </row>
2119
2120 <row><entry></entry></row>
2121 <row>
2122 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_CPB_SIZE</constant>&nbsp;</entry>
2123 <entry>integer</entry>
2124 </row>
2125 <row><entry spanname="descr">The Coded Picture Buffer size in kilobytes, it is used as a limitation of frame skip.
2126The CPB is defined in the H264 standard as a mean to verify that the produced stream will be succesfully decoded.
2127Applicable to the H264 encoder.</entry>
2128 </row>
2129
2130 <row><entry></entry></row>
2131 <row>
2132 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_H264_I_PERIOD</constant>&nbsp;</entry>
2133 <entry>integer</entry>
2134 </row>
2135 <row><entry spanname="descr">Period between I-frames in the open GOP for H264. In case of an open GOP
2136this is the period between two I-frames. The period between IDR (Instantaneous Decoding Refresh) frames is taken from the GOP_SIZE control.
2137An IDR frame, which stands for Instantaneous Decoding Refresh is an I-frame after which no prior frames are
2138referenced. This means that a stream can be restarted from an IDR frame without the need to store or decode any
2139previous frames. Applicable to the H264 encoder.</entry>
2140 </row>
2141
2142 <row><entry></entry></row>
2143 <row>
2144 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_HEADER_MODE</constant>&nbsp;</entry>
2145 <entry>enum&nbsp;v4l2_mpeg_header_mode</entry>
2146 </row>
2147 <row><entry spanname="descr">Determines whether the header is returned as the first buffer or is
2148it returned together with the first frame. Applicable to encoders.
2149Possible values are:</entry>
2150 </row>
2151 <row>
2152 <entrytbl spanname="descr" cols="2">
2153 <tbody valign="top">
2154 <row>
2155 <entry><constant>V4L2_MPEG_VIDEO_HEADER_MODE_SEPARATE</constant>&nbsp;</entry>
2156 <entry>The stream header is returned separately in the first buffer.</entry>
2157 </row>
2158 <row>
2159 <entry><constant>V4L2_MPEG_VIDEO_HEADER_MODE_JOINED_WITH_1ST_FRAME</constant>&nbsp;</entry>
2160 <entry>The stream header is returned together with the first encoded frame.</entry>
2161 </row>
2162 </tbody>
2163 </entrytbl>
2164 </row>
2165 <row><entry></entry></row>
2166 <row>
2167 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_DECODER_MPEG4_DEBLOCK_FILTER</constant>&nbsp;</entry>
2168 <entry>boolean</entry>
2169 </row><row><entry spanname="descr">Enabled the deblocking post processing filter for MPEG4 decoder.
2170Applicable to the MPEG4 decoder.</entry>
2171 </row>
2172 <row><entry></entry></row>
2173 <row>
2174 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_MPEG4_VOP_TIME_RES</constant>&nbsp;</entry>
2175 <entry>integer</entry>
2176 </row><row><entry spanname="descr">vop_time_increment_resolution value for MPEG4. Applicable to the MPEG4 encoder.</entry>
2177 </row>
2178 <row><entry></entry></row>
2179 <row>
2180 <entry spanname="id"><constant>V4L2_CID_MPEG_VIDEO_MPEG4_VOP_TIME_INC</constant>&nbsp;</entry>
2181 <entry>integer</entry>
2182 </row><row><entry spanname="descr">vop_time_increment value for MPEG4. Applicable to the MPEG4 encoder.</entry>
2183 </row>
2184
2185 </tbody>
2186 </tgroup>
2187 </table>
2188 </section>
2189
2190 <section>
2191 <title>MFC 5.1 MPEG Controls</title>
2192
2193 <para>The following MPEG class controls deal with MPEG
2194decoding and encoding settings that are specific to the Multi Format Codec 5.1 device present
2195in the S5P family of SoCs by Samsung.
2196</para>
2197
2198 <table pgwide="1" frame="none" id="mfc51-control-id">
2199 <title>MFC 5.1 Control IDs</title>
2200 <tgroup cols="4">
2201 <colspec colname="c1" colwidth="1*" />
2202 <colspec colname="c2" colwidth="6*" />
2203 <colspec colname="c3" colwidth="2*" />
2204 <colspec colname="c4" colwidth="6*" />
2205 <spanspec namest="c1" nameend="c2" spanname="id" />
2206 <spanspec namest="c2" nameend="c4" spanname="descr" />
2207 <thead>
2208 <row>
2209 <entry spanname="id" align="left">ID</entry>
2210 <entry align="left">Type</entry>
2211 </row><row><entry spanname="descr" align="left">Description</entry>
2212 </row>
2213 </thead>
2214 <tbody valign="top">
2215 <row><entry></entry></row>
2216 <row>
2217 <entry spanname="id"><constant>V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY_ENABLE</constant>&nbsp;</entry>
2218 <entry>integer</entry>
2219 </row><row><entry spanname="descr">If the display delay is enabled then the decoder has to return a
2220CAPTURE buffer after processing a certain number of OUTPUT buffers. If this number is low, then it may result in
2221buffers not being dequeued in display order. In addition hardware may still use those buffers as reference, thus
2222application should not write to those buffers. This feature can be used for example for generating thumbnails of videos.
2223Applicable to the H264 decoder.
2224 </entry>
2225 </row>
2226 <row><entry></entry></row>
2227 <row>
2228 <entry spanname="id"><constant>V4L2_CID_MPEG_MFC51_VIDEO_DECODER_H264_DISPLAY_DELAY</constant>&nbsp;</entry>
2229 <entry>integer</entry>
2230 </row><row><entry spanname="descr">Display delay value for H264 decoder.
2231The decoder is forced to return a decoded frame after the set 'display delay' number of frames. If this number is
2232low it may result in frames returned out of dispaly order, in addition the hardware may still be using the returned buffer
2233as a reference picture for subsequent frames.
2234</entry>
2235 </row>
2236 <row><entry></entry></row>
2237 <row>
2238 <entry spanname="id"><constant>V4L2_CID_MPEG_MFC51_VIDEO_H264_NUM_REF_PIC_FOR_P</constant>&nbsp;</entry>
2239 <entry>integer</entry>
2240 </row><row><entry spanname="descr">The number of reference pictures used for encoding a P picture.
2241Applicable to the H264 encoder.</entry>
2242 </row>
2243 <row><entry></entry></row>
2244 <row>
2245 <entry spanname="id"><constant>V4L2_CID_MPEG_MFC51_VIDEO_PADDING</constant>&nbsp;</entry>
2246 <entry>boolean</entry>
2247 </row><row><entry spanname="descr">Padding enable in the encoder - use a color instead of repeating border pixels.
2248Applicable to encoders.</entry>
2249 </row>
2250 <row><entry></entry></row>
2251 <row>
2252 <entry spanname="id"><constant>V4L2_CID_MPEG_MFC51_VIDEO_PADDING_YUV</constant>&nbsp;</entry>
2253 <entry>integer</entry>
2254 </row><row><entry spanname="descr">Padding color in the encoder. Applicable to encoders. The supplied 32-bit integer is interpreted as follows (bit
22550 = least significant bit):</entry>
2256 </row>
2257 <row>
2258 <entrytbl spanname="descr" cols="2">
2259 <tbody valign="top">
2260 <row>
2261 <entry>Bit 0:7</entry>
2262 <entry>V chrominance information</entry>
2263 </row>
2264 <row>
2265 <entry>Bit 8:15</entry>
2266 <entry>U chrominance information</entry>
2267 </row>
2268 <row>
2269 <entry>Bit 16:23</entry>
2270 <entry>Y luminance information</entry>
2271 </row>
2272 <row>
2273 <entry>Bit 24:31</entry>
2274 <entry>Must be zero.</entry>
2275 </row>
2276 </tbody>
2277 </entrytbl>
2278 </row>
2279 <row><entry></entry></row>
2280 <row>
2281 <entry spanname="id"><constant>V4L2_CID_MPEG_MFC51_VIDEO_RC_REACTION_COEFF</constant>&nbsp;</entry>
2282 <entry>integer</entry>
2283 </row><row><entry spanname="descr">Reaction coefficient for MFC rate control. Applicable to encoders.
2284<para>Note 1: Valid only when the frame level RC is enabled.</para>
2285<para>Note 2: For tight CBR, this field must be small (ex. 2 ~ 10).
2286For VBR, this field must be large (ex. 100 ~ 1000).</para>
2287<para>Note 3: It is not recommended to use the greater number than FRAME_RATE * (10^9 / BIT_RATE).</para>
2288</entry>
2289 </row>
2290 <row><entry></entry></row>
2291 <row>
2292 <entry spanname="id"><constant>V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_DARK</constant>&nbsp;</entry>
2293 <entry>boolean</entry>
2294 </row><row><entry spanname="descr">Adaptive rate control for dark region.
2295Valid only when H.264 and macroblock level RC is enabled (<constant>V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE</constant>).
2296Applicable to the H264 encoder.</entry>
2297 </row>
2298 <row><entry></entry></row>
2299 <row>
2300 <entry spanname="id"><constant>V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_SMOOTH</constant>&nbsp;</entry>
2301 <entry>boolean</entry>
2302 </row><row><entry spanname="descr">Adaptive rate control for smooth region.
2303Valid only when H.264 and macroblock level RC is enabled (<constant>V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE</constant>).
2304Applicable to the H264 encoder.</entry>
2305 </row>
2306 <row><entry></entry></row>
2307 <row>
2308 <entry spanname="id"><constant>V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_STATIC</constant>&nbsp;</entry>
2309 <entry>boolean</entry>
2310 </row><row><entry spanname="descr">Adaptive rate control for static region.
2311Valid only when H.264 and macroblock level RC is enabled (<constant>V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE</constant>).
2312Applicable to the H264 encoder.</entry>
2313 </row>
2314 <row><entry></entry></row>
2315 <row>
2316 <entry spanname="id"><constant>V4L2_CID_MPEG_MFC51_VIDEO_H264_ADAPTIVE_RC_ACTIVITY</constant>&nbsp;</entry>
2317 <entry>boolean</entry>
2318 </row><row><entry spanname="descr">Adaptive rate control for activity region.
2319Valid only when H.264 and macroblock level RC is enabled (<constant>V4L2_CID_MPEG_VIDEO_MB_RC_ENABLE</constant>).
2320Applicable to the H264 encoder.</entry>
2321 </row>
2322 <row><entry></entry></row>
2323 <row>
2324 <entry spanname="id"><constant>V4L2_CID_MPEG_MFC51_VIDEO_FRAME_SKIP_MODE</constant>&nbsp;</entry>
2325 <entry>enum&nbsp;v4l2_mpeg_mfc51_frame_skip_mode</entry>
2326 </row>
2327 <row><entry spanname="descr">
2328Indicates in what conditions the encoder should skip frames. If encoding a frame would cause the encoded stream to be larger then
2329a chosen data limit then the frame will be skipped.
2330Possible values are:</entry>
2331 </row>
2332 <row>
2333 <entrytbl spanname="descr" cols="2">
2334 <tbody valign="top">
2335 <row>
2336 <entry><constant>V4L2_MPEG_MFC51_FRAME_SKIP_MODE_DISABLED</constant>&nbsp;</entry>
2337 <entry>Frame skip mode is disabled.</entry>
2338 </row>
2339 <row>
2340 <entry><constant>V4L2_MPEG_MFC51_FRAME_SKIP_MODE_LEVEL_LIMIT</constant>&nbsp;</entry>
2341 <entry>Frame skip mode enabled and buffer limit is set by the chosen level and is defined by the standard.</entry>
2342 </row>
2343 <row>
2344 <entry><constant>V4L2_MPEG_MFC51_FRAME_SKIP_MODE_BUF_LIMIT</constant>&nbsp;</entry>
2345 <entry>Frame skip mode enabled and buffer limit is set by the VBV (MPEG1/2/4) or CPB (H264) buffer size control.</entry>
2346 </row>
2347 </tbody>
2348 </entrytbl>
2349 </row>
2350 <row><entry></entry></row>
2351 <row>
2352 <entry spanname="id"><constant>V4L2_CID_MPEG_MFC51_VIDEO_RC_FIXED_TARGET_BIT</constant>&nbsp;</entry>
2353 <entry>integer</entry>
2354 </row><row><entry spanname="descr">Enable rate-control with fixed target bit.
2355If this setting is enabled, then the rate control logic of the encoder will calculate the average bitrate
2356for a GOP and keep it below or equal the set bitrate target. Otherwise the rate control logic calculates the
2357overall average bitrate for the stream and keeps it below or equal to the set bitrate. In the first case
2358the average bitrate for the whole stream will be smaller then the set bitrate. This is caused because the
2359average is calculated for smaller number of frames, on the other hand enabling this setting will ensure that
2360the stream will meet tight bandwidth contraints. Applicable to encoders.
2361</entry>
2362 </row>
2363 <row><entry></entry></row>
2364 <row>
2365 <entry spanname="id"><constant>V4L2_CID_MPEG_MFC51_VIDEO_FORCE_FRAME_TYPE</constant>&nbsp;</entry>
2366 <entry>enum&nbsp;v4l2_mpeg_mfc51_force_frame_type</entry>
2367 </row>
2368 <row><entry spanname="descr">Force a frame type for the next queued buffer. Applicable to encoders.
2369Possible values are:</entry>
2370 </row>
2371 <row>
2372 <entrytbl spanname="descr" cols="2">
2373 <tbody valign="top">
2374 <row>
2375 <entry><constant>V4L2_MPEG_MFC51_FORCE_FRAME_TYPE_DISABLED</constant>&nbsp;</entry>
2376 <entry>Forcing a specific frame type disabled.</entry>
2377 </row>
2378 <row>
2379 <entry><constant>V4L2_MPEG_MFC51_FORCE_FRAME_TYPE_I_FRAME</constant>&nbsp;</entry>
2380 <entry>Force an I-frame.</entry>
2381 </row>
2382 <row>
2383 <entry><constant>V4L2_MPEG_MFC51_FORCE_FRAME_TYPE_NOT_CODED</constant>&nbsp;</entry>
2384 <entry>Force a non-coded frame.</entry>
2385 </row>
2386 </tbody>
2387 </entrytbl>
2388 </row>
1420 </tbody> 2389 </tbody>
1421 </tgroup> 2390 </tgroup>
1422 </table> 2391 </table>
generated by cgit v1.2.2 (git 2.25.0) at 2025-01-03 08:53:10 -0500