5 ## This script is the front-end to the build system. It provides a similar
6 ## interface to standard configure scripts with some extra bits for dealing
7 ## with toolchains that differ from the standard POSIX interface and
8 ## for extracting subsets of the source tree. In theory, reusable parts
9 ## of this script were intended to live in build/make/configure.sh,
10 ## but in practice, the line is pretty blurry.
12 ## This build system is based in part on the FFmpeg configure script.
15 #source_path="`dirname \"$0\"`"
17 . "${source_path}/build/make/configure.sh"
23 ${toggle_libs} libraries
24 ${toggle_examples} examples
26 ${toggle_docs} documentation
27 ${toggle_unit_tests} unit tests
28 ${toggle_decode_perf_tests} build decoder perf tests with unit tests
29 ${toggle_encode_perf_tests} build encoder perf tests with unit tests
30 --cpu=CPU tune for the specified CPU (ARM: cortex-a8, X86: sse3)
31 --libc=PATH path to alternate libc
32 --size-limit=WxH max size to allow in the decoder
33 --as={yasm|nasm|auto} use specified assembler [auto, yasm preferred]
34 ${toggle_codec_srcs} in/exclude codec library source code
35 ${toggle_debug_libs} in/exclude debug version of libraries
36 ${toggle_static_msvcrt} use static MSVCRT (VS builds only)
37 ${toggle_vp9_highbitdepth} use VP9 high bit depth (10/12) profiles
38 ${toggle_better_hw_compatibility}
39 enable encoder to produce streams with better
40 hardware decoder compatibility
41 ${toggle_vp8} VP8 codec support
42 ${toggle_vp9} VP9 codec support
43 ${toggle_internal_stats} output of encoder internal stats for debug, if supported (encoders)
44 ${toggle_postproc} postprocessing
45 ${toggle_vp9_postproc} vp9 specific postprocessing
46 ${toggle_multithread} multithreaded encoding and decoding
47 ${toggle_spatial_resampling} spatial sampling (scaling) support
48 ${toggle_realtime_only} enable this option while building for real-time encoding
49 ${toggle_onthefly_bitpacking} enable on-the-fly bitpacking in real-time encoding
50 ${toggle_error_concealment} enable this option to get a decoder which is able to conceal losses
51 ${toggle_coefficient_range_checking}
52 enable decoder to check if intermediate
53 transform coefficients are in valid range
54 ${toggle_runtime_cpu_detect} runtime cpu detection
55 ${toggle_shared} shared library support
56 ${toggle_static} static library support
57 ${toggle_small} favor smaller size over speed
58 ${toggle_postproc_visualizer} macro block / block level visualizers
59 ${toggle_multi_res_encoding} enable multiple-resolution encoding
60 ${toggle_temporal_denoising} enable temporal denoising and disable the spatial denoiser
61 ${toggle_vp9_temporal_denoising}
62 enable vp9 temporal denoising
63 ${toggle_webm_io} enable input from and output to WebM container
64 ${toggle_libyuv} enable libyuv
67 Codecs can be selectively enabled or disabled individually, or by family:
70 --disable-<codec>-encoder
71 --disable-<codec>-decoder
73 Codecs available in this distribution:
75 #restore editor state '
81 for c in ${CODECS}; do
83 if [ "${family}" != "${last_family}" ]; then
84 [ -z "${str}" ] || echo "${str}"
85 str="$(printf ' %10s:' ${family})"
87 str="${str} $(printf '%10s' ${c#*_})"
95 ## BEGIN APPLICATION SPECIFIC CONFIGURATION
98 # all_platforms is a list of all supported target platforms. Maintain
99 # alphabetically by architecture, generic-gnu last.
100 all_platforms="${all_platforms} arm64-android-gcc"
101 all_platforms="${all_platforms} arm64-darwin-gcc"
102 all_platforms="${all_platforms} arm64-darwin20-gcc"
103 all_platforms="${all_platforms} arm64-darwin21-gcc"
104 all_platforms="${all_platforms} arm64-linux-gcc"
105 all_platforms="${all_platforms} arm64-win64-gcc"
106 all_platforms="${all_platforms} arm64-win64-vs15"
107 all_platforms="${all_platforms} armv7-android-gcc" #neon Cortex-A8
108 all_platforms="${all_platforms} armv7-darwin-gcc" #neon Cortex-A8
109 all_platforms="${all_platforms} armv7-linux-rvct" #neon Cortex-A8
110 all_platforms="${all_platforms} armv7-linux-gcc" #neon Cortex-A8
111 all_platforms="${all_platforms} armv7-none-rvct" #neon Cortex-A8
112 all_platforms="${all_platforms} armv7-win32-gcc"
113 all_platforms="${all_platforms} armv7-win32-vs14"
114 all_platforms="${all_platforms} armv7-win32-vs15"
115 all_platforms="${all_platforms} armv7s-darwin-gcc"
116 all_platforms="${all_platforms} armv8-linux-gcc"
117 all_platforms="${all_platforms} mips32-linux-gcc"
118 all_platforms="${all_platforms} mips64-linux-gcc"
119 all_platforms="${all_platforms} ppc64le-linux-gcc"
120 all_platforms="${all_platforms} sparc-solaris-gcc"
121 all_platforms="${all_platforms} x86-android-gcc"
122 all_platforms="${all_platforms} x86-darwin8-gcc"
123 all_platforms="${all_platforms} x86-darwin8-icc"
124 all_platforms="${all_platforms} x86-darwin9-gcc"
125 all_platforms="${all_platforms} x86-darwin9-icc"
126 all_platforms="${all_platforms} x86-darwin10-gcc"
127 all_platforms="${all_platforms} x86-darwin11-gcc"
128 all_platforms="${all_platforms} x86-darwin12-gcc"
129 all_platforms="${all_platforms} x86-darwin13-gcc"
130 all_platforms="${all_platforms} x86-darwin14-gcc"
131 all_platforms="${all_platforms} x86-darwin15-gcc"
132 all_platforms="${all_platforms} x86-darwin16-gcc"
133 all_platforms="${all_platforms} x86-darwin17-gcc"
134 all_platforms="${all_platforms} x86-iphonesimulator-gcc"
135 all_platforms="${all_platforms} x86-linux-gcc"
136 all_platforms="${all_platforms} x86-linux-icc"
137 all_platforms="${all_platforms} x86-os2-gcc"
138 all_platforms="${all_platforms} x86-solaris-gcc"
139 all_platforms="${all_platforms} x86-win32-gcc"
140 all_platforms="${all_platforms} x86-win32-vs14"
141 all_platforms="${all_platforms} x86-win32-vs15"
142 all_platforms="${all_platforms} x86-win32-vs16"
143 all_platforms="${all_platforms} x86_64-android-gcc"
144 all_platforms="${all_platforms} x86_64-darwin9-gcc"
145 all_platforms="${all_platforms} x86_64-darwin10-gcc"
146 all_platforms="${all_platforms} x86_64-darwin11-gcc"
147 all_platforms="${all_platforms} x86_64-darwin12-gcc"
148 all_platforms="${all_platforms} x86_64-darwin13-gcc"
149 all_platforms="${all_platforms} x86_64-darwin14-gcc"
150 all_platforms="${all_platforms} x86_64-darwin15-gcc"
151 all_platforms="${all_platforms} x86_64-darwin16-gcc"
152 all_platforms="${all_platforms} x86_64-darwin17-gcc"
153 all_platforms="${all_platforms} x86_64-darwin18-gcc"
154 all_platforms="${all_platforms} x86_64-darwin19-gcc"
155 all_platforms="${all_platforms} x86_64-darwin20-gcc"
156 all_platforms="${all_platforms} x86_64-darwin21-gcc"
157 all_platforms="${all_platforms} x86_64-iphonesimulator-gcc"
158 all_platforms="${all_platforms} x86_64-linux-gcc"
159 all_platforms="${all_platforms} x86_64-linux-icc"
160 all_platforms="${all_platforms} x86_64-solaris-gcc"
161 all_platforms="${all_platforms} x86_64-win64-gcc"
162 all_platforms="${all_platforms} x86_64-win64-vs14"
163 all_platforms="${all_platforms} x86_64-win64-vs15"
164 all_platforms="${all_platforms} x86_64-win64-vs16"
165 all_platforms="${all_platforms} generic-gnu"
167 # all_targets is a list of all targets that can be configured
168 # note that these should be in dependency order for now.
169 all_targets="libs examples tools docs"
171 # all targets available are enabled, by default.
172 for t in ${all_targets}; do
173 [ -f "${source_path}/${t}.mk" ] && enable_feature ${t}
176 if ! diff --version >/dev/null; then
177 die "diff missing: Try installing diffutils via your package manager."
180 if ! perl --version >/dev/null; then
181 die "Perl is required to build"
184 if [ "`cd \"${source_path}\" && pwd`" != "`pwd`" ]; then
185 # test to see if source_path already configured
186 if [ -f "${source_path}/vpx_config.h" ]; then
187 die "source directory already configured; run 'make distclean' there first"
191 # check installed doxygen version
192 doxy_version=$(doxygen --version 2>/dev/null)
193 doxy_major=${doxy_version%%.*}
194 if [ ${doxy_major:-0} -ge 1 ]; then
195 doxy_version=${doxy_version#*.}
196 doxy_minor=${doxy_version%%.*}
197 doxy_patch=${doxy_version##*.}
199 [ $doxy_major -gt 1 ] && enable_feature doxygen
200 [ $doxy_minor -gt 5 ] && enable_feature doxygen
201 [ $doxy_minor -eq 5 ] && [ $doxy_patch -ge 3 ] && enable_feature doxygen
204 # disable codecs when their source directory does not exist
205 [ -d "${source_path}/vp8" ] || disable_codec vp8
206 [ -d "${source_path}/vp9" ] || disable_codec vp9
208 # install everything except the sources, by default. sources will have
209 # to be enabled when doing dist builds, since that's no longer a common
211 enabled doxygen && enable_feature install_docs
212 enable_feature install_bins
213 enable_feature install_libs
215 enable_feature static
216 enable_feature optimizations
217 enable_feature dependency_tracking
218 enable_feature spatial_resampling
219 enable_feature multithread
220 enable_feature os_support
221 enable_feature temporal_denoising
253 ARCH_EXT_LIST_LOONGSON="
270 ${ARCH_EXT_LIST_LOONGSON}
331 vp9_temporal_denoising
333 coefficient_range_checking
335 better_hw_compatibility
395 vp9_temporal_denoising
397 coefficient_range_checking
398 better_hw_compatibility
411 for c in ${CODEC_FAMILIES}; do disable_codec $c; done
413 --enable-?*|--disable-?*)
414 eval `echo "$opt" | sed 's/--/action=/;s/-/ option=/;s/-/_/g'`
415 if is_in ${option} ${EXPERIMENT_LIST}; then
416 if enabled experimental; then
417 ${action}_feature $option
419 log_echo "Ignoring $opt -- not in experimental mode."
421 elif is_in ${option} "${CODECS} ${CODEC_FAMILIES}"; then
422 ${action}_codec ${option}
424 process_common_cmdline $opt
427 *) process_common_cmdline "$opt"
433 post_process_cmdline() {
434 if enabled coefficient_range_checking; then
435 echo "coefficient-range-checking is for decoders only, disabling encoders:"
436 soft_disable vp8_encoder
437 soft_disable vp9_encoder
442 # Enable all detected codecs, if they haven't been disabled
443 for c in ${CODECS}; do soft_enable $c; done
445 # Enable the codec family if any component of that family is enabled
446 for c in ${CODECS}; do
447 enabled $c && enable_feature ${c%_*}
450 # Set the {en,de}coders variable if any algorithm in that class is enabled
451 for c in ${CODECS}; do
452 enabled ${c} && enable_feature ${c##*_}s
458 enabled child || write_common_config_banner
459 write_common_target_config_h ${BUILD_PFX}vpx_config.h
460 write_common_config_targets
461 enabled win_arm64_neon_h_workaround && write_win_arm64_neon_h_workaround ${BUILD_PFX}arm_neon.h
463 # Calculate the default distribution name, based on the enabled features
466 for cf in $CODEC_FAMILIES; do
467 if enabled ${cf}_encoder && enabled ${cf}_decoder; then
468 DIST_DIR="${DIST_DIR}-${cf}"
469 elif enabled ${cf}_encoder; then
470 DIST_DIR="${DIST_DIR}-${cf}cx"
471 elif enabled ${cf}_decoder; then
472 DIST_DIR="${DIST_DIR}-${cf}dx"
475 enabled debug_libs && DIST_DIR="${DIST_DIR}-debug"
476 enabled codec_srcs && DIST_DIR="${DIST_DIR}-src"
477 ! enabled postproc && ! enabled vp9_postproc && DIST_DIR="${DIST_DIR}-nopost"
478 ! enabled multithread && DIST_DIR="${DIST_DIR}-nomt"
479 ! enabled install_docs && DIST_DIR="${DIST_DIR}-nodocs"
480 DIST_DIR="${DIST_DIR}-${tgt_isa}-${tgt_os}"
482 win*) enabled static_msvcrt && DIST_DIR="${DIST_DIR}mt" || DIST_DIR="${DIST_DIR}md"
483 DIST_DIR="${DIST_DIR}-${tgt_cc}"
486 if [ -f "${source_path}/build/make/version.sh" ]; then
487 ver=`"$source_path/build/make/version.sh" --bare "$source_path"`
488 DIST_DIR="${DIST_DIR}-${ver}"
489 VERSION_STRING=${ver}
491 VERSION_PATCH=${ver##*.}
493 VERSION_MINOR=${ver##*.}
495 VERSION_MAJOR=${ver%.*}
497 enabled child || cat <<EOF >> config.mk
500 ifeq (\$(MAKECMDGOALS),dist)
501 DIST_DIR?=${DIST_DIR}
503 DIST_DIR?=\$(DESTDIR)${prefix}
505 LIBSUBDIR=${libdir##${prefix}/}
507 VERSION_STRING=${VERSION_STRING}
509 VERSION_MAJOR=${VERSION_MAJOR}
510 VERSION_MINOR=${VERSION_MINOR}
511 VERSION_PATCH=${VERSION_PATCH}
513 CONFIGURE_ARGS=${CONFIGURE_ARGS}
515 enabled child || echo "CONFIGURE_ARGS?=${CONFIGURE_ARGS}" >> config.mk
518 # Write makefiles for all enabled targets
520 for tgt in libs examples tools docs solution; do
521 tgt_fn="$tgt-$toolchain.mk"
523 if enabled $tgt; then
524 echo "Creating makefiles for ${toolchain} ${tgt}"
525 write_common_target_config_mk $tgt_fn ${BUILD_PFX}vpx_config.h
533 if enabled shared; then
534 # Can only build shared libs on a subset of platforms. Doing this check
535 # here rather than at option parse time because the target auto-detect
536 # magic happens after the command line has been parsed.
538 linux|os2|solaris|darwin*|iphonesimulator*)
539 # Supported platforms
543 echo "--enable-shared is only supported on ELF; assuming this is OK"
545 die "--enable-shared only supported on ELF, OS/2, and Darwin for now"
550 if [ -z "$CC" ] || enabled external_build; then
551 echo "Bypassing toolchain for environment detection."
552 enable_feature external_build
554 log fake_check_header "$@"
557 var=`echo $header | sed 's/[^A-Za-z0-9_]/_/g'`
559 # Headers common to all environments
567 [ -f "${d##-I}/$header" ] && result=true && break
570 esac && enable_feature $var
572 # Specialize windows and POSIX environments.
575 # Don't check for any headers in Windows builds.
583 esac && enable_feature $var
594 check_header stdio.h || die "Unable to invoke compiler: ${CC} ${CFLAGS}"
595 check_ld <<EOF || die "Toolchain is unable to link executables"
596 int main(void) {return 0;}
598 # check system headers
600 # Use both check_header and check_lib here, since check_lib
601 # could be a stub that always returns true.
602 check_header pthread.h && check_lib -lpthread <<EOF || disable_feature pthread_h
605 int main(void) { return pthread_create(NULL, NULL, NULL, NULL); }
607 check_header unistd.h # for sysconf(3) and friends.
609 check_header vpx/vpx_integer.h -I${source_path} && enable_feature vpx_ports
611 if enabled neon && ! enabled external_build; then
612 check_header arm_neon.h || die "Unable to find arm_neon.h"
616 process_toolchain() {
617 process_common_toolchain
619 # Enable some useful compiler flags
621 enabled werror && check_add_cflags -Werror
622 check_add_cflags -Wall
623 check_add_cflags -Wdeclaration-after-statement
624 check_add_cflags -Wdisabled-optimization
625 check_add_cflags -Wfloat-conversion
626 check_add_cflags -Wformat=2
627 check_add_cflags -Wparentheses-equality
628 check_add_cflags -Wpointer-arith
629 check_add_cflags -Wtype-limits
630 check_add_cflags -Wcast-qual
631 check_add_cflags -Wvla
632 check_add_cflags -Wimplicit-function-declaration
633 check_add_cflags -Wmissing-declarations
634 check_add_cflags -Wmissing-prototypes
635 check_add_cflags -Wuninitialized
636 check_add_cflags -Wunreachable-code-loop-increment
637 check_add_cflags -Wunused
638 check_add_cflags -Wextra
639 # check_add_cflags also adds to cxxflags. gtest does not do well with
640 # these flags so add them explicitly to CFLAGS only.
641 check_cflags -Wundef && add_cflags_only -Wundef
642 check_cflags -Wframe-larger-than=52000 && \
643 add_cflags_only -Wframe-larger-than=52000
644 if enabled mips || [ -z "${INLINE}" ]; then
645 enabled extra_warnings || check_add_cflags -Wno-unused-function
647 # Enforce c89 for c files. Don't be too strict about it though. Allow
648 # gnu extensions like "//" for comments.
649 check_cflags -std=gnu89 && add_cflags_only -std=gnu89
650 # Avoid this warning for third_party C++ sources. Some reorganization
651 # would be needed to apply this only to test/*.cc.
652 check_cflags -Wshorten-64-to-32 && add_cflags_only -Wshorten-64-to-32
654 # Quiet gcc 6 vs 7 abi warnings:
655 # https://gcc.gnu.org/bugzilla/show_bug.cgi?id=77728
657 check_add_cxxflags -Wno-psabi
660 # disable some warnings specific to libyuv.
661 check_cxxflags -Wno-missing-declarations \
662 && LIBYUV_CXXFLAGS="${LIBYUV_CXXFLAGS} -Wno-missing-declarations"
663 check_cxxflags -Wno-missing-prototypes \
664 && LIBYUV_CXXFLAGS="${LIBYUV_CXXFLAGS} -Wno-missing-prototypes"
665 check_cxxflags -Wno-unused-parameter \
666 && LIBYUV_CXXFLAGS="${LIBYUV_CXXFLAGS} -Wno-unused-parameter"
670 enabled werror && check_add_cflags -Werror
671 check_add_cflags -Wall
672 check_add_cflags -Wpointer-arith
674 # ICC has a number of floating point optimizations that we disable
675 # in favor of deterministic output WRT to other compilers
676 add_cflags -fp-model precise
679 # Enable extra, harmless warnings. These might provide additional insight
680 # to what the compiler is doing and why, but in general, but they shouldn't
681 # be treated as fatal, even if we're treating warnings as errors.
683 -Wdisabled-optimization
686 enabled gcc && EXTRA_WARNINGS="${GCC_EXTRA_WARNINGS}"
687 RVCT_EXTRA_WARNINGS="
690 enabled rvct && EXTRA_WARNINGS="${RVCT_EXTRA_WARNINGS}"
691 if enabled extra_warnings; then
692 for w in ${EXTRA_WARNINGS}; do
693 check_add_cflags ${w}
694 enabled gcc && enabled werror && check_add_cflags -Wno-error=${w}
698 # ccache only really works on gcc toolchains
699 enabled gcc || soft_disable ccache
700 if enabled mips; then
701 enable_feature dequant_tokens
702 enable_feature dc_recon
705 if enabled internal_stats; then
706 enable_feature vp9_postproc
709 # Enable the postbuild target if building for visual studio.
711 vs*) enable_feature msvs
712 enable_feature solution
713 vs_version=${tgt_cc##vs}
715 gen_vcproj_cmd=${source_path}/build/make/gen_msvs_vcxproj.sh
716 enabled werror && gen_vcproj_cmd="${gen_vcproj_cmd} --enable-werror"
717 all_targets="${all_targets} solution"
722 # Other toolchain specific defaults
723 case $toolchain in x86*) soft_enable postproc;; esac
725 if enabled postproc_visualizer; then
726 enabled postproc || die "postproc_visualizer requires postproc to be enabled"
729 # Enable unit tests by default if we have a working C++ compiler.
732 soft_enable unit_tests
737 check_add_cxxflags -std=gnu++11 && soft_enable webm_io
739 # GTestLog must be modified to use Android logging utilities.
742 check_add_cxxflags -std=gnu++11
743 # iOS/ARM builds do not work with gtest. This does not match
747 check_add_cxxflags -std=gnu++11 && soft_enable webm_io
751 # Some mingw toolchains don't have pthread available by default.
752 # Treat these more like visual studio where threading in gtest
753 # would be disabled for the same reason.
754 check_add_cxxflags -std=gnu++11 && soft_enable unit_tests \
755 && soft_enable webm_io
756 check_cxx "$@" <<EOF && soft_enable libyuv
761 enabled pthread_h && check_add_cxxflags -std=gnu++11 \
762 && soft_enable unit_tests
763 check_add_cxxflags -std=gnu++11 && soft_enable webm_io
764 check_cxx "$@" <<EOF && soft_enable libyuv
769 # libwebm needs to be linked with C++ standard library
770 enabled webm_io && LD=${CXX}
772 # append any user defined extra cflags
773 if [ -n "${extra_cflags}" ] ; then
774 check_add_cflags ${extra_cflags} || \
775 die "Requested extra CFLAGS '${extra_cflags}' not supported by compiler"
777 if [ -n "${extra_cxxflags}" ]; then
778 check_add_cxxflags ${extra_cxxflags} || \
779 die "Requested extra CXXFLAGS '${extra_cxxflags}' not supported by compiler"
785 ## END APPLICATION SPECIFIC CONFIGURATION
789 print_webm_license ${BUILD_PFX}vpx_config.c "/*" " */"
790 cat <<EOF >> ${BUILD_PFX}vpx_config.c
791 #include "vpx/vpx_codec.h"
792 static const char* const cfg = "$CONFIGURE_ARGS";
793 const char *vpx_codec_build_config(void) {return cfg;}