| 1 |
.. SPDX-FileCopyrightText: 2019-2020 Intel Corporation |
| 2 |
.. |
| 3 |
.. SPDX-License-Identifier: CC-BY-4.0 |
| 4 |
|
| 5 |
================ |
| 6 |
Video Processing |
| 7 |
================ |
| 8 |
|
| 9 |
Video processing functions (:term:`VPP`) take raw frames as input and provide |
| 10 |
raw frames as output. |
| 11 |
|
| 12 |
The actual conversion process is a chain operation with many single-function |
| 13 |
filters. |
| 14 |
|
| 15 |
.. graphviz:: |
| 16 |
:caption: Video processing operation pipeline |
| 17 |
|
| 18 |
digraph { |
| 19 |
rankdir=LR; |
| 20 |
F1 [shape=record label="Function 1" ]; |
| 21 |
F2 [shape=record label="Function 2"]; |
| 22 |
F3 [shape=record label="Additional filters"]; |
| 23 |
F4 [shape=record label="Function N-1" ]; |
| 24 |
F5 [shape=record label="Function N"]; |
| 25 |
F1->F2->F3->F4->F5; |
| 26 |
} |
| 27 |
|
| 28 |
The application specifies the input and output format; |vpl_short_name| configures the |
| 29 |
pipeline according to the specified input and output formats. The application |
| 30 |
can also attach one or more hint structures |
| 31 |
to configure individual filters or turn them on and off. Unless specifically |
| 32 |
instructed, |vpl_short_name| builds the pipeline in a way that best utilizes hardware |
| 33 |
acceleration or generates the best video processing quality. |
| 34 |
|
| 35 |
The :ref:`Video Processing Features table <vid-processing-feat-table>` shows |vpl_short_name| |
| 36 |
video processing features. The application can configure supported video |
| 37 |
processing features through the video processing I/O parameters. The application |
| 38 |
can also configure optional features through hints. |
| 39 |
See :ref:`Video Processing Procedures <vid_process_procedure>` for more details |
| 40 |
on how to configure optional filters. |
| 41 |
|
| 42 |
.. _vid-processing-feat-table: |
| 43 |
|
| 44 |
.. list-table:: Video Processing Features |
| 45 |
:header-rows: 1 |
| 46 |
:widths: 70 30 |
| 47 |
|
| 48 |
* - **Video Processing Features** |
| 49 |
- **Configuration** |
| 50 |
* - Convert color format from input to output |
| 51 |
- I/O parameters |
| 52 |
* - De-interlace to produce progressive frames at the output |
| 53 |
- I/O parameters |
| 54 |
* - Crop and resize the input frames |
| 55 |
- I/O parameters |
| 56 |
* - Convert input frame rate to match the output |
| 57 |
- I/O parameters |
| 58 |
* - Perform inverse telecine operations |
| 59 |
- I/O parameters |
| 60 |
* - Fields weaving |
| 61 |
- I/O parameters |
| 62 |
* - Fields splitting |
| 63 |
- I/O parameters |
| 64 |
* - Remove noise |
| 65 |
- Hint (optional feature) |
| 66 |
* - Enhance picture details/edges |
| 67 |
- Hint (optional feature) |
| 68 |
* - Adjust the brightness, contrast, saturation, and hue settings |
| 69 |
- Hint (optional feature) |
| 70 |
* - Perform image stabilization |
| 71 |
- Hint (optional feature) |
| 72 |
* - Convert input frame rate to match the output, based on frame interpolation |
| 73 |
- Hint (optional feature) |
| 74 |
* - Perform detection of picture structure |
| 75 |
- Hint (optional feature) |