diff --git a/source/docs/en/latest/technical/video-presets-tunes.markdown b/source/docs/en/latest/technical/video-presets-tunes.markdown new file mode 100644 index 00000000..32b10aaa --- /dev/null +++ b/source/docs/en/latest/technical/video-presets-tunes.markdown @@ -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". diff --git a/source/docs/en/latest/technical/video-profiles-levels.markdown b/source/docs/en/latest/technical/video-profiles-levels.markdown new file mode 100644 index 00000000..dcebed91 --- /dev/null +++ b/source/docs/en/latest/technical/video-profiles-levels.markdown @@ -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. diff --git a/source/docs/en/latest/technical/video-qsv-options.markdown b/source/docs/en/latest/technical/video-qsv-options.markdown index 849ec07b..cac9ac67 100644 --- a/source/docs/en/latest/technical/video-qsv-options.markdown +++ b/source/docs/en/latest/technical/video-qsv-options.markdown @@ -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) - Sets the trade-off between quality and speed, from 1 (best quality) to 7 (best speed). - Default: 2 diff --git a/source/docs/en/latest/technical/video-x264-presets-tunes.markdown b/source/docs/en/latest/technical/video-x264-presets-tunes.markdown deleted file mode 100644 index 32c6f05a..00000000 --- a/source/docs/en/latest/technical/video-x264-presets-tunes.markdown +++ /dev/null @@ -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. diff --git a/source/docs/en/latest/technical/video-x264-profiles-levels.markdown b/source/docs/en/latest/technical/video-x264-profiles-levels.markdown deleted file mode 100644 index f565f860..00000000 --- a/source/docs/en/latest/technical/video-x264-profiles-levels.markdown +++ /dev/null @@ -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.