docs: Minor documentation updates for latest changes.

This commit is contained in:
sr55 2021-03-05 23:13:05 +00:00
parent 2f5d366a85
commit c465a8a056
No known key found for this signature in database
GPG Key ID: DC68C9CE6FEC775F
7 changed files with 84 additions and 77 deletions

View File

@ -18,48 +18,12 @@ Building HandBrake for Windows
## Command line interface and LibHB ## Command line interface and LibHB
Building the HandBrake [CLI](abbr:Command Line Interface) and LibHB (`hb.dll`) for Windows requires Linux and a recent [MinGW-w64](https://mingw-w64.org/) toolchain. Fedora 28 or later, or Ubuntu 18.04 LTS (Bionic Beaver) or later are recommended; other distros may work as well. In all cases, we recommend you build the MinGW-w64 toolchain using our instructions and the included script, as some packaged versions have issues that can produce non-functioning builds. Building the HandBrake [CLI](abbr:Command Line Interface) and LibHB (`hb.dll`) for Windows requires Linux and a recent [MinGW-w64](https://mingw-w64.org/) toolchain. Ubuntu 20.04 LTS or later are recommended; other distros may work as well. In all cases, we recommend you build the MinGW-w64 toolchain using our instructions and the included script, as some packaged versions have issues that can produce non-functioning builds.
### Installing dependencies on Fedora
The following instructions are for [Fedora](https://getfedora.org) 30 through 32.
Basic requirements to run commands:
- sudo (for normal user accounts)
Dependencies:
- Development Tools
- C Development Tools and Libraries
- cmake
- gcc-c++
- git
- libtool
- m4
- make
- meson
- nasm
- ninja-build
- patch
- python
- tar
- zlib-devel
Install dependencies.
sudo dnf update
sudo dnf groupinstall "Development Tools" "C Development Tools and Libraries"
sudo dnf install cmake gcc-c++ git libtool m4 make meson nasm ninja-build patch python tar zlib-devel
Install the additional dependencies required to build the MinGW-w64 toolchain.
sudo dnf install bison bzip2 curl flex g++ gzip pax
### Installing dependencies on Ubuntu ### Installing dependencies on Ubuntu
The following instructions are for [Ubuntu](https://www.ubuntu.com) 20.04 (Focal Fossa). The following instructions are for [Ubuntu](https://www.ubuntu.com) 20.04 (Focal Fossa).
These should also work with Windows Subsystem for Linux.
Basic requirements to run commands: Basic requirements to run commands:
@ -139,9 +103,7 @@ The following tools are required to build and run the [GUI](abbr:Graphical User
- [Source Tree](https://www.sourcetreeapp.com) (recommended) - [Source Tree](https://www.sourcetreeapp.com) (recommended)
- Client included with Visual Studio 2015 or later - Client included with Visual Studio 2015 or later
- `hb.dll` (see the LibHB build instructions preceding these, or download from [https://handbrake.fr/nightly.php](https://handbrake.fr/nightly.php)) - `hb.dll` (see the LibHB build instructions preceding these, or download from [https://handbrake.fr/nightly.php](https://handbrake.fr/nightly.php))
- [JetBrains ReSharper](https://www.jetbrains.com/?from=HandBrake) (optional)
- Recommended for developers interested in working on the Windows UI
- Active, regular contributors may request a free for open source ReSharper license from the HandBrake Team, courtesy of JetBrains
Clone `https://github.com/HandBrake/HandBrake.git` using your git client. Clone `https://github.com/HandBrake/HandBrake.git` using your git client.

View File

@ -135,13 +135,14 @@ Table of contents
- [Profiles and levels](technical/video-profiles-levels.html)<span class="notice draft"><span>draft</span></span> - [Profiles and levels](technical/video-profiles-levels.html)<span class="notice draft"><span>draft</span></span>
- [Video angles](technical/video-angles.html)<span class="notice draft"><span>draft</span></span> - [Video angles](technical/video-angles.html)<span class="notice draft"><span>draft</span></span>
- [Anamorphic video](technical/anamorphic-guide.html)<span class="notice draft"><span>draft</span></span> - [Anamorphic video](technical/anamorphic-guide.html)<span class="notice draft"><span>draft</span></span>
- [Modulus](technical/modulus.html)<span class="notice draft"><span>draft</span></span> <!-- - [Modulus](technical/modulus.html)<span class="notice draft"><span>draft</span></span>-->
- [Frame rate](technical/frame-rates.html)<span class="notice draft"><span>draft</span></span> - [Frame rate](technical/frame-rates.html)<span class="notice draft"><span>draft</span></span>
- Hardware encoders - Hardware encoders
- [AMD VCE](technical/video-vce.html) - [AMD VCE](technical/video-vce.html)
- [Apple VideoToolbox](technical/video-videotoolbox.html) - [Apple VideoToolbox](technical/video-videotoolbox.html)
- [Intel Quick Sync Video](technical/video-qsv.html) - [Intel Quick Sync Video](technical/video-qsv.html)
- [NVIDIA NVENC](technical/video-nvenc.html) - [NVIDIA NVENC](technical/video-nvenc.html)
- [Media Foundation (ARM)](technical/video-mediafoundation.html)
- Audio - Audio
- [Dynamic range compression](technical/dynamic-range-compression.html)<span class="notice draft"><span>draft</span></span> - [Dynamic range compression](technical/dynamic-range-compression.html)<span class="notice draft"><span>draft</span></span>
- [Audio quality](technical/audio-quality.html)<span class="notice draft"><span>draft</span></span> - [Audio quality](technical/audio-quality.html)<span class="notice draft"><span>draft</span></span>
@ -149,10 +150,11 @@ Table of contents
- [Container formats](technical/containers.html)<span class="notice draft"><span>draft</span></span> - [Container formats](technical/containers.html)<span class="notice draft"><span>draft</span></span>
- [iPod 5th Generation support](technical/old-ipod-support.html)<span class="notice draft"><span>draft</span></span> - [iPod 5th Generation support](technical/old-ipod-support.html)<span class="notice draft"><span>draft</span></span>
- [Automatic file naming](technical/automatic-file-naming.html)<span class="notice draft"><span>draft</span></span> - [Automatic file naming](technical/automatic-file-naming.html)<span class="notice draft"><span>draft</span></span>
<!--
- Filters - Filters
- [Filters summary](technical/filters-summary.html)<span class="notice draft"><span>draft</span></span> - [Filters summary](technical/filters-summary.html)<span class="notice draft"><span>draft</span></span>
<!--
- [Web optimized](technical/web-optimised.html) - [Web optimized](technical/web-optimised.html)
- [Video source type](advanced/video-sources.html) - [Video source type](advanced/video-sources.html)
- Advanced Filter Settings - Advanced Filter Settings

View File

@ -64,12 +64,16 @@ Audio Encoders
- HandBrake offers Vorbis audio encoding as well, for which it uses the - HandBrake offers Vorbis audio encoding as well, for which it uses the
aoTuV branch that offers quality tweaks. aoTuV branch that offers quality tweaks.
- AC3: - AC3 and E-AC3:
- HandBrake can encode to AC3 using FFmpeg. - HandBrake can encode to AC3 using FFmpeg.
- This is not the same as Passthru. You can encode any audio track to AC3. - This is not the same as Passthru. You can encode any audio track to AC3.
- Opus (FFmpeg)
- Available in MKV files.
- Flac 16 and 24bit (FFmpeg) - Flac 16 and 24bit (FFmpeg)
- Loss-less audio compression. - Loss-less audio compression.
@ -85,7 +89,7 @@ Passthru options.
----------------- -----------------
HandBrake supports passthru for a limited number of popular source formats. HandBrake supports passthru for a limited number of popular source formats.
These are: AC3, DTS, DTS-HD, TrueHD, MP3 or AAC (Passthru) These are: AC3, E-AC3, DTS, DTS-HD, TrueHD, MP3, MP2, AAC or flac (Passthru)
This copies the audio bit-for-bit from the source so offers no loss in audio This copies the audio bit-for-bit from the source so offers no loss in audio
quality. These audio tracks can be quite large so can impact the final size of quality. These audio tracks can be quite large so can impact the final size of

View File

@ -21,14 +21,14 @@ System requirements
The following is the minimum level of hardware that HandBrake supports. The following is the minimum level of hardware that HandBrake supports.
- Processor: - Processor:
- Intel Core i3 or better - Intel Core (4th generation and newer) i3, i5, i7, i9 or equivalent Xeon
- AMD FX / 2014+ APU or better - AMD Ryzen, Threadripper or Epyc
- Free memory: - Free memory:
- 512 MB for transcoding standard definition video (480p/576p) - 1 GB for transcoding standard definition video (480p/576p)
- 1.5 GB for transcoding high definition video (720p/1080p) - 2 GB for transcoding high definition video (720p/1080p)
- 4 GB or more for transcoding ultra high definition video (2160p 4K) - 6 GB or more for transcoding ultra high definition video (2160p 4K)
- System storage: - System storage:
- 100 MB for the HandBrake app - 150 MB for the HandBrake app
- 2 GB or more recommended for processing and storing your new videos - 2 GB or more recommended for processing and storing your new videos
- Display resolution: - Display resolution:
- 1024x768 minimum, proportionately higher with display scaling - 1024x768 minimum, proportionately higher with display scaling
@ -88,7 +88,7 @@ Interim (non-LTS) versions are typically supported until their end of life.
| Ubuntu Version | Status | Last Compatible Version | Notes | | Ubuntu Version | Status | Last Compatible Version | Notes |
|-------------------------|---------------------|-------------------------|------------------------------------| |-------------------------|---------------------|-------------------------|------------------------------------|
| 20.04 LTS Focal Fossa | Supported | | Flatpak, PPA, and source. | | 20.04 LTS Focal Fossa | Supported | | Flatpak, PPA, and source. |
| 18.04 LTS Bionic Beaver | Deprecated in 1.3.0 | | Flatpak only. | | 18.04 LTS Bionic Beaver | Deprecated in 1.3.0 | HandBrake 1.3.0 | Flatpak only. |
| 16.04 LTS Xenial Xerus | Unsupported | HandBrake 1.1.2 | Various issues affect operability. | | 16.04 LTS Xenial Xerus | Unsupported | HandBrake 1.1.2 | Various issues affect operability. |
| 14.04 LTS Trusty Tahr | Unsupported | HandBrake 1.1.2 | End of life (standard support). | | 14.04 LTS Trusty Tahr | Unsupported | HandBrake 1.1.2 | End of life (standard support). |
@ -107,16 +107,17 @@ HandBrake is supported on recent versions of macOS[^apple-eol].
| macOS Version | Status | Last Compatible Version | Notes | | macOS Version | Status | Last Compatible Version | Notes |
|--------------------|---------------------|-------------------------|------------------------------------| |--------------------|---------------------|-------------------------|------------------------------------|
| 11 Big Sur | Supported | | Requires HandBrake 1.4 or later. |
| 10.15 Catalina | Supported | | Requires HandBrake 1.2.2 or later. | | 10.15 Catalina | Supported | | Requires HandBrake 1.2.2 or later. |
| 10.14 Mojave | Supported | | Requires HandBrake 1.1.2 or later. | | 10.14 Mojave | Supported | | Requires HandBrake 1.1.2 or later. |
| 10.13 High Sierra | Deprecated in 1.3.0 | | End of life expected Q4 2020. | | 10.13 High Sierra | Unsupported | 1.3.3 | End of life |
| 10.12 Sierra | Deprecated in 1.3.0 | | End of life. | | 10.12 Sierra | Unsupported | 1.3.3 | End of life. |
| 10.11 El Capitan | Deprecated in 1.2.0 | | End of life. | | 10.11 El Capitan | Unsupported | 1.2.0 | End of life. |
| 10.10 Yosemite | Unsupported | HandBrake 1.1.2 | End of life. | | 10.10 Yosemite | Unsupported | 1.1.2 | End of life. |
| 10.9 Mavericks | Unsupported | HandBrake 1.1.2 | End of life. | | 10.9 Mavericks | Unsupported | 1.1.2 | End of life. |
| 10.8 Mountain Lion | Unsupported | HandBrake 1.1.2 | End of life. | | 10.8 Mountain Lion | Unsupported | 1.1.2 | End of life. |
| 10.7 Lion | Unsupported | HandBrake 1.1.2 | End of life. | | 10.7 Lion | Unsupported | 1.1.2 | End of life. |
| 10.6 Snow Leopard | Unsupported | HandBrake 0.10.5 | End of life. | | 10.6 Snow Leopard | Unsupported | 0.10.5 | End of life. |
[VLC](https://www.videolan.org/vlc/) is recommended for viewing media files, notably Matroska (MKV), which is not natively supported on macOS. [VLC](https://www.videolan.org/vlc/) is recommended for viewing media files, notably Matroska (MKV), which is not natively supported on macOS.
@ -125,15 +126,15 @@ HandBrake is supported on recent versions of macOS[^apple-eol].
### Windows ### Windows
HandBrake is supported on recent Windows versions and requires [Microsoft .NET Framework](https://dotnet.microsoft.com/download/dotnet-framework) 4.8 or later. HandBrake requires the [.NET Desktop Runtime](https://dotnet.microsoft.com/download/dotnet/5.0) 5.0.x
| Windows Version | Status | Last Compatible Version | Notes | | Windows Version | Status | Last Compatible Version | Notes |
|-----------------|---------------------|-------------------------|--------------| |-----------------|---------------------|-------------------------|--------------|
| Windows 10 | Supported | | | | Windows 10 | Supported | | |
| Windows 8.1 | Supported | | | | Windows 8.1 | Unsupported | 1.3.3 | End of life. |
| Windows 7 SP1 | Deprecated in 1.1.0 | | End of life. | | Windows 7 SP1 | Unsupported | 1.3.3 | End of life. |
| Windows Vista | Unsupported | HandBrake 1.0.7 | End of life. | | Windows Vista | Unsupported | 1.0.7 | End of life. |
| Windows XP | Unsupported | HandBrake 0.9.9 | End of life. | | Windows XP | Unsupported | 0.9.9 | End of life. |
[VLC](https://www.videolan.org/vlc/) is recommended for viewing media files. [VLC](https://www.videolan.org/vlc/) is recommended for viewing media files.

View File

@ -18,26 +18,25 @@ Video codecs
The following video codecs are available for encoding in HandBrake. The following video codecs are available for encoding in HandBrake.
- H.264 (x264): - H.264:
- MPEG-4 Part 10, also known as H.264/AVC - MPEG-4 Part 10, also known as H.264/AVC
- Provides excellent quality, performance, and file size - Provides excellent quality, performance, and file size
- Widely supported by media players, including mobile devices - Widely supported by media players, including mobile devices
- Several different encoders are supported:
- In software: x264
- In hardware: Intel QuickSync, AMD VCE, Nvidia NVENC and ARM devices though MediaFoundation.
- H.264 (Intel QSV): - H.265 (HEVC)
- MPEG-4 Part 10, also known as H.264/AVC
- Hardware based encoder available on Intel processors with Intel HD Graphics (Haswell or newer series CPUs recommended for best quality and file size)
- Very fast with significantly lower CPU usage than software H.264 encoders such as x264
- Produces larger (but usually not significantly larger) file sizes and slightly lower quality to an equivalent x264 encode, a trade-off that is typically acceptable, especially on lower performance systems
- H.265 (x265)
- MPEG-H Part 2, also known as H.265/HEVC - MPEG-H Part 2, also known as H.265/HEVC
- Successor to H.264/AVC offering higher quality encodes and smaller file sizes - Successor to H.264/AVC offering higher quality encodes and smaller file sizes
- Current strengths of x265 are improved quality and compression for low bit rate encodes, and for ultra high definition content - Current strengths are improved quality and compression for low bit rate encodes, and for ultra high definition content
- Significantly slower than software H.264/AVC encoders - Significantly slower than software H.264/AVC encoders
- Limited device compatibility compared to H.264/AVC, but this is improving rapidly - Limited device compatibility compared to H.264/AVC, but this is improving rapidly
- Several different encoders are supported:
- In software: x265
- In hardware: Intel QuickSync, AMD VCE, Nvidia NVENC and ARM devices though MediaFoundation.
- MPEG-4 (ffmpeg): - MPEG-4 (ffmpeg):

View File

@ -0,0 +1,39 @@
---
Type: article
Title: Media Foundation Encoder
Project: HandBrake
Project_URL: https://handbrake.fr/
Project_Version: Latest
Language: English
Language_Code: en
Authors: [ Scott (s55) ]
Copyright: 2021 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
---
Apple VideoToolbox
==================
## Supported hardware
- Windows 10 for ARM with Qualcomm ARM processors. This encoder will not display on x86 based systems.
## Enabling support
If your computer is supported you will see one or more of the following video encoders added to the encoder control on the `Video` tab.
- H.264 (MediaFoundation)
- H.265 (MediaFoundation)
## Performance
Only video encoding is performed by the hardware encoder. Every stage prior to and after video encoding including decoding, filters, audio/video sync, audio encoding, muxing, etc., is performed by the CPU. As a result, it is normal to have high (even 100%) CPU utilisation during encodes.
It is common, particularly on lower-end hardware, for the CPU to be a bottleneck for the hardware video encoder. To minimize this effect, disable any filters that you do not require.
## Advanced options
There are no advanced options available for VideoToolbox encoders.

View File

@ -18,7 +18,7 @@ AMD VCE
## Supported Hardware and Configurations ## Supported Hardware and Configurations
- AMD Radeon RX 400, 500, Vega/II, Navi series GPU or better - AMD Radeon RX400, RX500, Vega, RX5000 and RX6000 series GPU or better
- Ubuntu Linux 20.04 or later - Ubuntu Linux 20.04 or later
- Windows 10 - Windows 10