Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update documentation for LPLA -> LA #163

Merged
merged 1 commit into from
Aug 10, 2023
Merged

Update documentation for LPLA -> LA #163

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions ...chmarks/intel-data-center-gpu-flex-series/intel-data-center-gpu-flex-series.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -330,7 +330,7 @@ designed to boost GPU video quality for AVC, HEVC and (coming soon) AV1 using va
compression efficiency technologies and content adaptive quality optimization
tools while at the same time having minimal impact on the coding performance
(speed). EncTools technology includes tools such as adaptive pyramid quantization,
persistence adaptive quantization, low power look ahead, advanced scene change
persistence adaptive quantization, look ahead, advanced scene change
detection and `more <../../quality.rst#enctools-and-extbrc>`_.

The recommended random access transcoding ffmpeg-qsv (Intel GPU integration with
Expand Down Expand Up @@ -364,7 +364,7 @@ ffmpeg) command lines optimized for high quality and performance are given below
-rc_init_occupancy $(($bufsize / 2)) -b_strategy 1 -bf 7 -g 256 \
-fps_mode passthrough -y $output

Extra quality boost can be achieved with use of low power look ahead (by setting
Extra quality boost can be achieved with use of look ahead (by setting
“-look_ahead_depth 40” option) at the expense of a slight performance impact (10-20%).
The use of "-extra_hw_frames" option is currently required for transcoding with look ahead
due to the increased GPU memory requirements. Please set the value for "-extra_hw_frames"
Expand Down
2 changes: 1 addition & 1 deletion doc/man/measure-quality.asciidoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -353,7 +353,7 @@ ENCODING OPTIONS
for AVC/HEVC and `500` for AV1).

--enctools-lad <int>::
Sets the EncTools low power look ahead depth (default: `40`).
Sets the EncTools look ahead depth (default: `40`).
To use EncTools with boosted performance, set depth to 8. Minimum value is 1.

--ref-preset veryslow|slower|slow|medium|fast|faster|veryfast::
Expand Down
28 changes: 14 additions & 14 deletions doc/performance.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -166,19 +166,19 @@ designed to improve video quality (thus a name EncTools).

**ExtBRC** is Intel’s legacy SW BRC.

EncTools are engaged automatically with enabling external BRC (extbrc 1) and setting lookahead depth >= 1.
Positive lookahead depth will automatically enable EncTools BRC and all adaptive encoding tools. For low
power lookahead to engage with EncTools BRC, lookahead depth should be > mini-GoP size. Several adaptive
EncTools are engaged automatically with enabling external BRC (extbrc 1) and setting look ahead depth >= 1.
Positive look ahead depth will automatically enable EncTools BRC and all adaptive encoding tools. For low
power look ahead to engage with EncTools BRC, look ahead depth should be > mini-GoP size. Several adaptive
encoding tools can be disabled by engaging SMT or FFmpeg-QSV flags, such as, for example, AdaptiveI off
(disable scene cut detection) and AdaptiveB off (disable adaptive mini-GoP). More information on
the individual coding tools of EncTools BRC can be found `here <quality.rst#enctools-and-extbrc>`_.

::

# triggers EncTools without low power lookahead (performance boost):
# triggers EncTools without look ahead (performance boost):
ffmpeg <...> -g 256 -bf 7 -extbrc 1 -look_ahead_depth 8 <...>

# triggers EncTools with low power lookahead (quality boost):
# triggers EncTools with look ahead (quality boost):
ffmpeg <...> -g 256 -bf 7 -extbrc 1 -look_ahead_depth 40 <...>

# triggers ExtBRC:
Expand Down Expand Up @@ -218,9 +218,9 @@ To achieve better performance with Intel GPU H.264/AVC encoder running EncTools
| | | AVC encoding |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
| ``-extbrc 1 -look_ahead_depth $lad`` | n3.0 | This enables EncTools Software BRC when look ahead depth > than 0. Need |
| | | to have look ahead depth > than miniGOP size to enable low power look |
| | | ahead too (miniGOP size is equal to bf+1). The recommended values for |
| | | `$lad` are: 8 (for performance boost) and 40 (for quality boost) |
| | | to have look ahead depth > than miniGOP size to enable look ahead too |
| | | (miniGOP size is equal to bf+1). The recommended values for `$lad` |
| | | are: 8 (for performance boost) and 40 (for quality boost) |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
| ``-b_strategy 1 -bf 7`` | n3.0 | These 2 settings activate full 3 level B-Pyramid. |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
Expand Down Expand Up @@ -329,9 +329,9 @@ To achieve performance with Intel GPU H.265/HEVC encoder running EncTools BRC we
| | | Recommendation is to use 1/2 of bufsize. |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
| ``-extbrc 1 -look_ahead_depth $lad`` | n5.0 | This enables EncTools Software BRC when look ahead depth > than 0. Need |
| | | to have look ahead depth > than miniGOP size to enable low power look |
| | | ahead too (miniGOP size is equal to bf+1). The recommended values for |
| | | `$lad` are: 8 (for performance boost) and 40 (for quality boost) |
| | | to have look ahead depth > than miniGOP size to enable look ahead too |
| | | (miniGOP size is equal to bf+1). The recommended values for `$lad` |
| | | are: 8 (for performance boost) and 40 (for quality boost) |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
| ``-b_strategy 1 -bf 7`` | n6.0 | These 2 settings activate full 3 level B-Pyramid. |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
Expand Down Expand Up @@ -440,9 +440,9 @@ To achieve performance with Intel GPU AV1 encoder running EncTools BRC we recomm
| | | Recommendation is to use 1/2 of bufsize. |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
| ``-extbrc 1 -look_ahead_depth $lad`` | n6.0 | This enables EncTools Software BRC when look ahead depth > than 0. Need |
| | | to have look ahead depth > than miniGOP size to enable low power look |
| | | ahead too (miniGOP size is equal to bf+1). The recommended values for |
| | | `$lad` are: 8 (for performance boost) and 40 (for quality boost) |
| | | to have look ahead depth > than miniGOP size to enable look ahead too |
| | | (miniGOP size is equal to bf+1). The recommended values for `$lad` |
| | | are: 8 (for performance boost) and 40 (for quality boost) |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
| ``-b_strategy 1 -bf 7`` | n6.0 | These 2 settings activate full 3 level B-Pyramid. |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
Expand Down
30 changes: 15 additions & 15 deletions doc/quality.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -323,18 +323,18 @@ designed to improve video quality (thus a name EncTools).

**ExtBRC** is Intel’s legacy SW BRC.

EncTools are engaged automatically with enabling external BRC (extbrc 1) and setting lookahead depth >= 1.
Positive lookahead depth will automatically enable EncTools BRC and all adaptive encoding tools. For low
power lookahead to engage with EncTools BRC, lookahead depth should be > mini-GoP size. Several adaptive
EncTools are engaged automatically with enabling external BRC (extbrc 1) and setting look ahead depth >= 1.
Positive look ahead depth will automatically enable EncTools BRC and all adaptive encoding tools. For low
power look ahead to engage with EncTools BRC, look ahead depth should be > mini-GoP size. Several adaptive
encoding tools can be disabled by engaging SMT or FFmpeg-QSV flags, such as, for example, AdaptiveI off
(disable scene cut detection) and AdaptiveB off (disable adaptive mini-GoP).

::

# triggers EncTools without low power lookahead (performance boost):
# triggers EncTools without look ahead (performance boost):
ffmpeg <...> -g 256 -bf 7 -extbrc 1 -look_ahead_depth 8 <...>

# triggers EncTools with low power lookahead (quality boost):
# triggers EncTools with look ahead (quality boost):
ffmpeg <...> -g 256 -bf 7 -extbrc 1 -look_ahead_depth 40 <...>

# triggers ExtBRC:
Expand All @@ -359,7 +359,7 @@ Below table summarizes which tools are available in EncTools and ExtBRC SW BRCs.
+-------------------------------------------------------+---------+----------+
| Adaptive Custom Quantizer Matrix (ACQM) | |cross| | |check| |
+-------------------------------------------------------+---------+----------+
| Low Power Look Ahead (LPLA) | |cross| | |check| |
| Look Ahead (LA) | |cross| | |check| |
+-------------------------------------------------------+---------+----------+
| Persistance Adaptive Quantization (PAQ) | |cross| | |check| |
+-------------------------------------------------------+---------+----------+
Expand Down Expand Up @@ -448,9 +448,9 @@ To achieve better quality with Intel GPU H.264/AVC encoder running EncTools BRC
| | | AVC encoding |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
| ``-extbrc 1 -look_ahead_depth $lad`` | n3.0 | This enables EncTools Software BRC when look ahead depth > than 0. Need |
| | | to have look ahead depth > than miniGOP size to enable low power look |
| | | ahead too (miniGOP size is equal to bf+1). The recommended values for |
| | | `$lad` are: 8 (for performance boost) and 40 (for quality boost) |
| | | to have look ahead depth > than miniGOP size to enable look ahead too |
| | | (miniGOP size is equal to bf+1). The recommended values for `$lad` |
| | | are: 8 (for performance boost) and 40 (for quality boost) |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
| ``-b_strategy 1 -bf 7`` | n3.0 | These 2 settings activate full 3 level B-Pyramid. |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
Expand Down Expand Up @@ -678,9 +678,9 @@ To achieve better quality with Intel GPU H.265/HEVC encoder running EncTools BRC
| CBR & VBR common settings |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
| ``-extbrc 1 -look_ahead_depth $lad`` | n5.0 | This enables EncTools Software BRC when look ahead depth > than 0. Need |
| | | to have look ahead depth > than miniGOP size to enable low power look |
| | | ahead too (miniGOP size is equal to bf+1). The recommended values for |
| | | `$lad` are: 8 (for performance boost) and 40 (for quality boost) |
| | | to have look ahead depth > than miniGOP size to enable look ahead too |
| | | (miniGOP size is equal to bf+1). The recommended values for `$lad` |
| | | are: 8 (for performance boost) and 40 (for quality boost) |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
| ``-b_strategy 1 -bf 7`` | n6.0 | These 2 settings activate full 3 level B-Pyramid. |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
Expand Down Expand Up @@ -906,9 +906,9 @@ To achieve better quality with Intel GPU AV1 encoder running EncTools BRC we rec
| CBR & VBR common settings |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
| ``-extbrc 1 -look_ahead_depth $lad`` | n6.0 | This enables EncTools Software BRC when look ahead depth > than 0. Need |
| | | to have look ahead depth > than miniGOP size to enable low power look |
| | | ahead too (miniGOP size is equal to bf+1). The recommended values for |
| | | `$lad` are: 8 (for performance boost) and 40 (for quality boost) |
| | | to have look ahead depth > than miniGOP size to enable look ahead too |
| | | (miniGOP size is equal to bf+1). The recommended values for `$lad` |
| | | are: 8 (for performance boost) and 40 (for quality boost) |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
| ``-b_strategy 1 -bf 7`` | n6.0 | These 2 settings activate full 3 level B-Pyramid. |
+-------------------------------------------------------+----------------+--------------------------------------------------------------------------+
Expand Down
6 changes: 3 additions & 3 deletions doc/reference-command-lines.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ designed to boost GPU video quality for AVC, HEVC and AV1 using various
compression efficiency technologies and content adaptive quality optimization
tools while at the same time having minimal impact on the coding performance
(speed). EncTools technology includes tools such as adaptive pyramid quantization,
persistence adaptive quantization, low power look ahead, advanced scene change
persistence adaptive quantization, look ahead, advanced scene change
detection and `more <quality.rst#enctools-and-extbrc>`_.

The recommended random access transcoding `ffmpeg-qsv <https://trac.ffmpeg.org/wiki/Hardware/QuickSync>`_
Expand Down Expand Up @@ -42,11 +42,11 @@ optimized for high quality and performance are given below:
-b_strategy 1 -adaptive_i 1 -adaptive_b 1 -bf 7 -g 256 -strict -1 \
-fps_mode passthrough -y $output

Extra quality boost can be achieved with use of low power look ahead (by setting
Extra quality boost can be achieved with use of look ahead (by setting
``-look_ahead_depth 40`` option) at the expense of a slight performance impact (10-20%).
The use of ``-extra_hw_frames`` option is currently required for transcoding with look ahead
due to the increased GPU memory requirements. Please set the value for ``-extra_hw_frames``
to be the same as the number of lookahead frames.
to be the same as the number of look ahead frames.

For best single stream performance or low density use case with high resolutions such as
4K, ``-async_depth 2`` option is recommended (yielding only negligible quality loss
Expand Down