Docs: Make the Video Presets, Tunes, Levels, Profile pages generic.

This commit is contained in:
sr55 2019-01-23 21:01:25 +00:00
parent 7f6139a795
commit 9def597300
No known key found for this signature in database
GPG Key ID: DC68C9CE6FEC775F
5 changed files with 121 additions and 135 deletions

View File

@ -0,0 +1,39 @@
---
Type: article
State: [ draft ]
Title: Presets and Tunes
Project: HandBrake
Project_URL: https://handbrake.fr/
Project_Version: Latest
Language: English
Language_Code: en
Authors: [ Scott (s55) ]
Copyright: 2019 HandBrake Team
License: Creative Commons Attribution-ShareAlike 4.0 International
License_Abbr: CC BY-SA 4.0
License_URL: https://handbrake.fr/docs/license.html
---
Encoder Presets and Tunes
==========================
Presets
--------------
Some encoders expose a preset and tune system. These can be adjusted from the Video Tab.
These provide a means of adjusting the encoder parameters to trade encoding speed for better quality and / or filesize.
Changes to the preset may also require changes to the quality slider or bitrate for optimium results.
Specific encoder settings can be overridden via the "Extra Options" box but this is typically not required.
Best practice is to use a preset around the middle. in
Tunes
--------------
The x264 and x265 tune options assign some additional options which will optimize the
encoder for certain types of content.
If you are unsure or your content doesn't really fit into one of the following
tunes, you can simply leave this option at "None".

View File

@ -0,0 +1,48 @@
---
Type: article
State: [ draft ]
Title: Profiles and Levels
Project: HandBrake
Project_URL: https://handbrake.fr/
Project_Version: Latest
Language: English
Language_Code: en
Authors: [ Scott (s55) ]
Copyright: 2019 HandBrake Team
License: Creative Commons Attribution-ShareAlike 4.0 International
License_Abbr: CC BY-SA 4.0
License_URL: https://handbrake.fr/docs/license.html
---
Profiles and Levels
==========================
Video Profiles
--------------
Define the features / capabilities that the encoder can use.
You can think of the profile as the level of complexity required in encode / decode. The higher the complexity, the more CPU power is needed to encode/decode. Setting a profile, constrains the encode to using settings that are allowed for that profile level.
Typically, devices will advertise that they are compatible for a particular profile and level, so you can simply set the option that matches your device for the best chance of compatibility.
Note that setting a profile does not mean your encoded file will end up being that profile. It simply prevents options being used that would breach that profile constraint.
Levels
------------
The levels are another form of constraints that define things like maximum bitrates, framerates and resolution etc. The following wikipedia articles lists the relevant information for each level.
| Status | Description |
|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|
| H.264 | https://en.wikipedia.org/wiki/H.264/MPEG-4_AVC#Levels |
| HEVC / H.265| https://en.wikipedia.org/wiki/High_Efficiency_Video_Coding_tiers_and_levels |
Most devices (and sometimes, software decoders) support a "maximum" level. When
the video's specifications exceed that level's constraints, the decoder won't be
able to decode the video properly (it may simply refuse to play the file).
HandBrake's encoders, set the appropriate level automatically based on all the other settings. To make sure your video doesn't exceed a specific level, you simply have to make sure the other parameters fit within the constraints imposed by the level.
It is recommended that you leave this setting on "Auto" unless you require to set it for device compatibility.

View File

@ -14,20 +14,44 @@ License_Abbr: CC BY-SA 4.0
License_URL: https://handbrake.fr/docs/license.html
---
Intel Quick Sync Video Advanced Configuration
Intel Quick Sync Video
==========================
Supported Hardware and Configurations
--------------
- Intel Sandy Bridge (2nd Generation Core) CPU's with Intel HD Graphics better
- Windows 10 (GUI and CLI)
- Linux (CLI Only when compiled from source with --enable-qsv. Considered experimental)
Please note, these are not hard limits and the feature *may* work on older cards and operating systems, but this is not officially supported.
Enabling support
--------------
Support for the QuickSync encoder can be enabled in preferences under the video tab. If your system is not supported, the option will be greyed out.
Performance
--------------
Take note that only the decode (when enabled) and encode portions of the pipeline is done on the Intel hardware.
Every stage in the pipeline in-between including (decoding, filters, a/v sync, muxing etc.) all happen on the CPU. As a result, it is normal to have high, or 100% CPU utilisation during encodes.
It is common, particularly on lower end hardware that the CPU may be a bottleneck for the encoder. To minimise this effect, turn off any filters that you do not require.
Using the Advanced Options
--------------
QuickSync does have a limited set of advanced encoder options that can be used. Generally speaking is is not recommended to change these parameters.
The built-in presets offer a good range of options.
From the command line, you can use the --encopts parameter as follows:
--encopts="option1=value1:option2=value2"
--encopts="option1=value1:option2=value2"
From the graphical user interface, just set the options in the dedicated text box:
option1=value1:option2=value2
option1=value1:option2=value2
Option Types
--------------
@ -36,16 +60,20 @@ The following value types are supported (each option only accepts one value type
- integer
A number that can be written without a fractional or decimal component.
- float
The finite decimal representation of a real number.
- boolean
0 means off (or disabled).
1 means on (or enabled).
- string
Takes a setting defined as s string. See comment for details.
Available Options
--------------
Available Options
--------------
- target-usage (or tu) <integer>
- Sets the trade-off between quality and speed, from 1 (best quality) to 7 (best speed).
- Default: 2

View File

@ -1,58 +0,0 @@
---
Type: article
State: [ draft ]
Title: x264 Presets and Tunes
Project: HandBrake
Project_URL: https://handbrake.fr/
Project_Version: Latest
Language: English
Language_Code: en
Authors: [ Scott (s55) ]
Copyright: 2019 HandBrake Team
License: Creative Commons Attribution-ShareAlike 4.0 International
License_Abbr: CC BY-SA 4.0
License_URL: https://handbrake.fr/docs/license.html
---
x264 Presets and Tunes
======================
## x264 Presets
x264 exposes a preset and tune system. Presets range from:
- UltraFast - Very high speed encoding, but requires much higher bit-rates to
maintain quality. This means you can expect much larger file sizes.
- Placebo - Extremely slow encoding but provides the best Quality and/or
filesize for a given source. - This option is often considered a placebo
because it offers diminishing returns in terms of quality and filesize.
Typically, it's recommended to use the Very Fast to Slow settings range for best
results, or one of the slower options if you don't mind the speed loss. Medium
is a good balance and most of HandBrakes presets use this option.
## x264 Tunes
The x264 tune options assign some additional options which will optimize the
encoder for certain types of content.
If you are unsure or your content doesn't really fit into one of the following
tunes, you can simply leave this option at "None".
- Film
- Real life footage, films etc may benefit. (Not Cartoons or Anime).
Typically won't do any harm to if left on for most content.
- Animation
- Used for hand-drawn animated content.
- Grain
- Typically used for very grainy or old content.
- Still Image
- Can be used for Slideshows, Presentations etc where there is very little
moving content.
- PSNR
- Used for benchmarking quality. Should not be used for normal use.
- SSIM
- Used for benchmarking quality. Should not be used for normal use.
- Fast Decode
- Optimise for faster decoding. Useful for low power devices that struggle
to decode the video.

View File

@ -1,71 +0,0 @@
---
Type: article
State: [ draft ]
Title: x264 Profiles and Levels
Project: HandBrake
Project_URL: https://handbrake.fr/
Project_Version: Latest
Language: English
Language_Code: en
Authors: [ Scott (s55) ]
Copyright: 2019 HandBrake Team
License: Creative Commons Attribution-ShareAlike 4.0 International
License_Abbr: CC BY-SA 4.0
License_URL: https://handbrake.fr/docs/license.html
---
Profiles and Levels
==========================
H.264 profiles
--------------
Define the features / capabilities that the encoder can use.
HandBrake exposes 3 profiles for H.264 Encodes. You can think of the profile as
the level of complexity required in encode / decode. The higher the complexity,
the more CPU power is needed to encode/decode. Setting a profile, constrains the
encode to using settings that are allowed for that profile level.
Typically, devices will advertise that they are compatible for a particular
profile and level, so you can simply set the option that matches your device for
the best chance of compatibility.
- Auto (Recommended)
- This will automatically set the profile based on all the options that
have been selected.
- It is recommended that you use this option unless you need to set a
profile to ensure compatibility for a particular device.
- Baseline
- Baseline encodes are the most basic form of encoding. While decoding is
much easier, it may also require much higher bit-rates to maintain the
same level of quality.
- Main
- The middle ground. Most modern / current devices will support this
profile.
- High Profile
- For best quality and filesize at the expense of CPU time in both decode
and encode.
Note that setting a profile does not mean your encoded file will end up being
that profile. It simply prevents options being used that would breach that
profile constraint.
H.264 Levels
------------
The levels are another form of constraints that define things like maximum
bitrates, framerates and resolution etc. The wikipedia article lists the
relevant information for each level.
https://en.wikipedia.org/wiki/H.264/MPEG-4_AVC#Levels
Most devices (and sometimes, software decoders) support a "maximum" level. When
the video's specifications exceed that level's constraints, the decoder won't be
able to decode the video properly (it may simply refuse to play the file).
HandBrake's H.264 encoder, x264, sets the appropriate level automatically based
on all the other settings. To make sure your video doesn't exceed a specific
level, you simply have to make sure the other parameters fit within the
constraints imposed by the level.
It is recommended that you leave this setting on "Auto" unless you require to
set it for device compatibility.