|author||Martin Storsjö <email@example.com>||Mon Mar 21 01:57:18 2022|
|committer||GitHub <firstname.lastname@example.org>||Mon Mar 21 01:57:18 2022|
Revert "Makefile, pkg-config: Add INCLUDE_PREFIX variable, use include/openh264 as default, include correct default for pkg-config (#3415)" (#3488) This reverts commit ccf65bc7b1eb257980b02528133b3a5a65e1497c. This change broke the existing official way of including the headers.
OpenH264 is a codec library which supports H.264 encoding and decoding. It is suitable for use in real time applications such as WebRTC. See http://www.openh264.org/ for more details.
NASM needed to be installed for assembly code: workable version 2.10.06 or above, NASM can be downloaded from http://www.nasm.us/. For Mac OSX 64-bit NASM needed to be below version 2.11.08 as NASM 2.11.08 will introduce error when using RIP-relative addresses in Mac OSX 64-bit
To build the arm assembly for Windows Phone, gas-preprocessor is required. It can be downloaded from git://git.libav.org/gas-preprocessor.git
To build for android platform, You need to install android sdk and ndk. You also need to export
**ANDROID_SDK**/tools to PATH. On Linux, this can be done by
The codec and demo can be built by
make OS=android NDKROOT=**ANDROID_NDK** TARGET=**ANDROID_TARGET**
**ANDROID_TARGET** can be found in
**ANDROID_SDK**/platforms, such as
android-12. You can also set
NDKLEVEL according to your device and NDK version.
ARCH specifies the architecture of android device. Currently
x86_64 are supported, the default is
mips64 can also be used, but there's no specific optimization for those architectures.)
NDKLEVEL specifies android api level, the default is 12. Available possibilities can be found in
**ANDROID_NDK**/platforms, such as
android-21 (strip away the
By default these commands build for the
armeabi-v7a ABI. To build for the other android ABIs, add
ARCH=mips64. To build for the older
armeabi ABI (which has armv5te as baseline), add
ARCH=arm is implicit). To build for 64-bit ABI, such as
arm64, explicitly set
NDKLEVEL to 21 or higher.
You can build the libraries and demo applications using xcode project files located in
You can also build the libraries (but not the demo applications) using the make based build system from the command line. Build with
make OS=ios ARCH=**ARCH**
Valid values for
**ARCH** are the normal iOS architecture names such as
x86_64 for the simulator. Another settable iOS specific parameter is
SDK_MIN, specifying the minimum deployment target for the built library. For other details on building using make on the command line, see ‘For All Platforms’ below.
You can build the libraries (but not the demo applications) using the make based build system from the command line. Build with
make OS=linux ARCH=**ARCH**
You can set
ARCH according to your linux device .
ARCH specifies the architecture of the device. Currently
x86_64 are supported
NOTICE: If your computer is x86 architecture, for build the libnary which be used on arm/aarch64 machine, you may need to use cross-compiler, for example: make OS=linux CC=aarch64-linux-gnu-gcc CXX=aarch64-linux-gnu-g++ ARCH=arm64 or make OS=linux CC=arm-linux-gnueabi-gcc CXX=arm-linux-gnueabi-g++ ARCH=arm
“make” must be installed. It is recommended to install the Cygwin and “make” must be selected to be included in the installation. After the installation, please add the Cygwin bin path to your PATH.
openh264/build/AutoBuildForWindows.bat is provided to help compile the libraries on Windows platform.
Usage of the .bat script:
`AutoBuildForWindows.bat Win32-Release-ASM` for x86 Release build `AutoBuildForWindows.bat Win64-Release-ASM` for x86_64 Release build `AutoBuildForWindows.bat ARM64-Release-ASM` for arm64 release build
for more usage, please refer to the .bat script help.
From the main project directory:
makefor automatically detecting architecture and building accordingly
make ARCH=i386for x86 32-bit builds
make ARCH=x86_64for x86 64-bit builds
make ARCH=arm64for arm64 Mac 64-bit builds
make V=Nofor a silent build (not showing the actual compiler commands)
make DEBUGSYMBOLS=Truefor two libraries, one is normal libraries, another one is removed the debugging symbol table entries (those created by the -g option)
The command line programs
h264dec will appear in the main project directory.
A shell script to run the command-line apps is in
Usage information can be found in
Meson build definitions have been added, and are known to work on Linux and Windows, for x86 and x86 64-bit.
See http://mesonbuild.com/Installing.html for instructions on how to install meson, then:
meson builddir ninja -C builddir
Run the tests with:
meson test -C builddir -v
ninja -C builddir install
codec- encoder, decoder, console (test app), build (makefile, vcproj)
build- scripts for Makefile build system
test- GTest unittest files
testbin- autobuild scripts, test app config files
res- yuv and bitstream test files
See the issue tracker on https://github.com/cisco/openh264/issues
LICENSE file for details.