From e1b4d71c60f0d1d2a88bf9e1b6d2fe11730c5eb9 Mon Sep 17 00:00:00 2001 From: Karsten Suehring Date: Tue, 24 Nov 2020 00:07:33 +0100 Subject: [PATCH] Merge VTM readme file with build instructions. --- README | 8 ---- README.md | 136 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 136 insertions(+), 8 deletions(-) delete mode 100644 README create mode 100644 README.md diff --git a/README b/README deleted file mode 100644 index 65082a24..00000000 --- a/README +++ /dev/null @@ -1,8 +0,0 @@ -This software package is the reference software for Rec. ITU-T H.265 | ISO/IEC 23008-2 High efficiency video coding (HEVC). The reference software includes both encoder and decoder functionality. - -Reference software is useful in aiding users of a video coding standard to establish and test conformance and interoperability, and to educate users and demonstrate the capabilities of the standard. For these purposes, this software is provided as an aid for the study and implementation of Rec. ITU-T H.265 | ISO/IEC 23008-2 High efficiency video coding. - -The software has been jointly developed by the ITU-T Video Coding Experts Group (VCEG, Question 6 of ITU-T Study Group 16) and the ISO/IEC Moving Picture Experts Group (MPEG, Working Group 11 of Subcommittee 29 of ISO/IEC Joint Technical Committee 1). - -A software manual, which contains usage instructions, can be found in the "doc" subdirectory of this software package. - diff --git a/README.md b/README.md new file mode 100644 index 00000000..36f2a701 --- /dev/null +++ b/README.md @@ -0,0 +1,136 @@ +HM reference software for HEVC +============================== + +This software package is the reference software for Rec. ITU-T H.265 | ISO/IEC 23008-2 High Efficiency Video Coding (HEVC). The reference software includes both encoder and decoder functionality. + +Reference software is useful in aiding users of a video coding standard to establish and test conformance and interoperability, and to educate users and demonstrate the capabilities of the standard. For these purposes, this software is provided as an aid for the study and implementation of Rec. ITU-T H.265 | ISO/IEC 23008-2 High Efficiency Video Coding. + +The software has been jointly developed by the ITU-T Video Coding Experts Group (VCEG, Question 6 of ITU-T Study Group 16) and the ISO/IEC Moving Picture Experts Group (MPEG, Working Group 11 of Subcommittee 29 of ISO/IEC Joint Technical Committee 1). + +The software is maintained by the Joint Video Experts Team (JVET) which is a joint collaboration of ITU-T Video Coding Experts Group (VCEG, Question 6 of ITU-T Study Group 16) and the ISO/IEC Moving Picture Experts Group (MPEG, Working Group 5 of Subcommittee 29 of ISO/IEC Joint Technical Committee 1). + +A software manual, which contains usage instructions, can be found in the "doc" subdirectory of this software package. + +Build instructions +================== + +The CMake tool is used to create platform-specific build files. + +Although CMake may be able to generate 32-bit binaries, **it is generally suggested to build 64-bit binaries**. 32-bit binaries are not able to access more than 2GB of RAM, which will not be sufficient for coding larger image formats. Building in 32-bit environments is not tested and will not be supported. + + +Build instructions for plain CMake (suggested) +---------------------------------------------- + +**Note:** A working CMake installation is required for building the software. + +CMake generates configuration files for the compiler environment/development environment on each platform. +The following is a list of examples for Windows (MS Visual Studio), macOS (Xcode) and Linux (make). + +Open a command prompt on your system and change into the root directory of this project. + +Create a build directory in the root directory: +```bash +mkdir build +``` + +Use one of the following CMake commands, based on your platform. Feel free to change the commands to satisfy +your needs. + +**Windows Visual Studio 2015/17/19 64 Bit:** + +Use the proper generator string for generating Visual Studio files, e.g. for VS 2015: + +```bash +cd build +cmake .. -G "Visual Studio 14 2015 Win64" +``` + +Then open the generated solution file in MS Visual Studio. + +For VS 2017 use "Visual Studio 15 2017 Win64", for VS 2019 use "Visual Studio 16 2019". + +Visual Studio 2019 also allows you to open the CMake directory directly. Choose "File->Open->CMake" for this option. + +**macOS Xcode:** + +For generating an Xcode workspace type: +```bash +cd build +cmake .. -G "Xcode" +``` +Then open the generated work space in Xcode. + +For generating Makefiles with optional non-default compilers, use the following commands: + +```bash +cd build +cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_C_COMPILER=gcc-9 -DCMAKE_CXX_COMPILER=g++-9 +``` +In this example the brew installed GCC 9 is used for a release build. + +**Linux** + +For generating Linux Release Makefile: +```bash +cd build +cmake .. -DCMAKE_BUILD_TYPE=Release +``` +For generating Linux Debug Makefile: +```bash +cd build +cmake .. -DCMAKE_BUILD_TYPE=Debug +``` + +Then type +```bash +make -j +``` + +For more details, refer to the CMake documentation: https://cmake.org/cmake/help/latest/ + +Build instructions for make +--------------------------- + +**Note:** The build instructions in this section require the make tool and Python to be installed, which are +part of usual Linux and macOS environments. See below for installation instruction for Python and GnuWin32 +on Windows. + +Open a command prompt on your system and change into the root directory of this project. + +To use the default system compiler simply call: +```bash +make all +``` + + +**MSYS2 and MinGW (Windows)** + +**Note:** Build files for MSYS MinGW were added on request. The build platform is not regularily tested and can't be supported. + +Open an MSYS MinGW 64-Bit terminal and change into the root directory of this project. + +Call: +```bash +make all toolset=gcc +``` + +The following tools need to be installed for MSYS2 and MinGW: + +Download CMake: http://www.cmake.org/ and install it. + +Python and GnuWin32 are not mandatory, but they simplify the build process for the user. + +python: https://www.python.org/downloads/release/python-371/ + +gnuwin32: https://sourceforge.net/projects/getgnuwin32/files/getgnuwin32/0.6.30/GetGnuWin32-0.6.3.exe/download + +To use MinGW, install MSYS2: http://repo.msys2.org/distrib/msys2-x86_64-latest.exe + +Installation instructions: https://www.msys2.org/ + +Install the needed toolchains: +```bash +pacman -S --needed base-devel mingw-w64-i686-toolchain mingw-w64-x86_64-toolchain git subversion mingw-w64-i686-cmake mingw-w64-x86_64-cmake +``` + -- GitLab