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
25 ${toggle_docs} documentation
26 ${toggle_unit_tests} unit tests
27 --libc=PATH path to alternate libc
28 --as={yasm|nasm|auto} use specified assembler [auto, yasm preferred]
29 --sdk-path=PATH path to root of sdk (iOS, android builds only)
30 ${toggle_fast_unaligned} don't use unaligned accesses, even when
31 supported by hardware [auto]
32 ${toggle_codec_srcs} in/exclude codec library source code
33 ${toggle_debug_libs} in/exclude debug version of libraries
34 ${toggle_md5} support for output of checksum data
35 ${toggle_static_msvcrt} use static MSVCRT (VS builds only)
36 ${toggle_vp8} VP8 codec support
37 ${toggle_vp9} VP9 codec support
38 ${toggle_internal_stats} output of encoder internal stats for debug, if supported (encoders)
39 ${toggle_mem_tracker} track memory usage
40 ${toggle_postproc} postprocessing
41 ${toggle_vp9_postproc} vp9 specific postprocessing
42 ${toggle_multithread} multithreaded encoding and decoding
43 ${toggle_spatial_resampling} spatial sampling (scaling) support
44 ${toggle_realtime_only} enable this option while building for real-time encoding
45 ${toggle_onthefly_bitpacking} enable on-the-fly bitpacking in real-time encoding
46 ${toggle_error_concealment} enable this option to get a decoder which is able to conceal losses
47 ${toggle_runtime_cpu_detect} runtime cpu detection
48 ${toggle_shared} shared library support
49 ${toggle_static} static library support
50 ${toggle_small} favor smaller size over speed
51 ${toggle_postproc_visualizer} macro block / block level visualizers
52 ${toggle_multi_res_encoding} enable multiple-resolution encoding
53 ${toggle_temporal_denoising} enable temporal denoising and disable the spatial denoiser
56 Codecs can be selectively enabled or disabled individually, or by family:
59 --disable-<codec>-encoder
60 --disable-<codec>-decoder
62 Codecs available in this distribution:
64 #restore editor state '
70 for c in ${CODECS}; do
72 if [ "${family}" != "${last_family}" ]; then
73 [ -z "${str}" ] || echo "${str}"
74 str="$(printf ' %10s:' ${family})"
76 str="${str} $(printf '%10s' ${c#*_})"
84 ## BEGIN APPLICATION SPECIFIC CONFIGURATION
87 # all_platforms is a list of all supported target platforms. Maintain
88 # alphabetically by architecture, generic-gnu last.
89 all_platforms="${all_platforms} armv5te-android-gcc"
90 all_platforms="${all_platforms} armv5te-linux-rvct"
91 all_platforms="${all_platforms} armv5te-linux-gcc"
92 all_platforms="${all_platforms} armv5te-none-rvct"
93 all_platforms="${all_platforms} armv6-darwin-gcc"
94 all_platforms="${all_platforms} armv6-linux-rvct"
95 all_platforms="${all_platforms} armv6-linux-gcc"
96 all_platforms="${all_platforms} armv6-none-rvct"
97 all_platforms="${all_platforms} armv7-android-gcc" #neon Cortex-A8
98 all_platforms="${all_platforms} armv7-darwin-gcc" #neon Cortex-A8
99 all_platforms="${all_platforms} armv7-linux-rvct" #neon Cortex-A8
100 all_platforms="${all_platforms} armv7-linux-gcc" #neon Cortex-A8
101 all_platforms="${all_platforms} armv7-none-rvct" #neon Cortex-A8
102 all_platforms="${all_platforms} armv7-win32-vs11"
103 all_platforms="${all_platforms} mips32-linux-gcc"
104 all_platforms="${all_platforms} ppc32-darwin8-gcc"
105 all_platforms="${all_platforms} ppc32-darwin9-gcc"
106 all_platforms="${all_platforms} ppc32-linux-gcc"
107 all_platforms="${all_platforms} ppc64-darwin8-gcc"
108 all_platforms="${all_platforms} ppc64-darwin9-gcc"
109 all_platforms="${all_platforms} ppc64-linux-gcc"
110 all_platforms="${all_platforms} sparc-solaris-gcc"
111 all_platforms="${all_platforms} x86-android-gcc"
112 all_platforms="${all_platforms} x86-darwin8-gcc"
113 all_platforms="${all_platforms} x86-darwin8-icc"
114 all_platforms="${all_platforms} x86-darwin9-gcc"
115 all_platforms="${all_platforms} x86-darwin9-icc"
116 all_platforms="${all_platforms} x86-darwin10-gcc"
117 all_platforms="${all_platforms} x86-darwin11-gcc"
118 all_platforms="${all_platforms} x86-darwin12-gcc"
119 all_platforms="${all_platforms} x86-darwin13-gcc"
120 all_platforms="${all_platforms} x86-linux-gcc"
121 all_platforms="${all_platforms} x86-linux-icc"
122 all_platforms="${all_platforms} x86-os2-gcc"
123 all_platforms="${all_platforms} x86-solaris-gcc"
124 all_platforms="${all_platforms} x86-win32-gcc"
125 all_platforms="${all_platforms} x86-win32-vs7"
126 all_platforms="${all_platforms} x86-win32-vs8"
127 all_platforms="${all_platforms} x86-win32-vs9"
128 all_platforms="${all_platforms} x86-win32-vs10"
129 all_platforms="${all_platforms} x86-win32-vs11"
130 all_platforms="${all_platforms} x86_64-darwin9-gcc"
131 all_platforms="${all_platforms} x86_64-darwin10-gcc"
132 all_platforms="${all_platforms} x86_64-darwin11-gcc"
133 all_platforms="${all_platforms} x86_64-darwin12-gcc"
134 all_platforms="${all_platforms} x86_64-darwin13-gcc"
135 all_platforms="${all_platforms} x86_64-linux-gcc"
136 all_platforms="${all_platforms} x86_64-linux-icc"
137 all_platforms="${all_platforms} x86_64-solaris-gcc"
138 all_platforms="${all_platforms} x86_64-win64-gcc"
139 all_platforms="${all_platforms} x86_64-win64-vs8"
140 all_platforms="${all_platforms} x86_64-win64-vs9"
141 all_platforms="${all_platforms} x86_64-win64-vs10"
142 all_platforms="${all_platforms} x86_64-win64-vs11"
143 all_platforms="${all_platforms} universal-darwin8-gcc"
144 all_platforms="${all_platforms} universal-darwin9-gcc"
145 all_platforms="${all_platforms} universal-darwin10-gcc"
146 all_platforms="${all_platforms} universal-darwin11-gcc"
147 all_platforms="${all_platforms} universal-darwin12-gcc"
148 all_platforms="${all_platforms} universal-darwin13-gcc"
149 all_platforms="${all_platforms} generic-gnu"
151 # all_targets is a list of all targets that can be configured
152 # note that these should be in dependency order for now.
153 all_targets="libs examples docs"
155 # all targets available are enabled, by default.
156 for t in ${all_targets}; do
157 [ -f ${source_path}/${t}.mk ] && enable_feature ${t}
160 # check installed doxygen version
161 doxy_version=$(doxygen --version 2>/dev/null)
162 doxy_major=${doxy_version%%.*}
163 if [ ${doxy_major:-0} -ge 1 ]; then
164 doxy_version=${doxy_version#*.}
165 doxy_minor=${doxy_version%%.*}
166 doxy_patch=${doxy_version##*.}
168 [ $doxy_major -gt 1 ] && enable_feature doxygen
169 [ $doxy_minor -gt 5 ] && enable_feature doxygen
170 [ $doxy_minor -eq 5 ] && [ $doxy_patch -ge 3 ] && enable_feature doxygen
173 # install everything except the sources, by default. sources will have
174 # to be enabled when doing dist builds, since that's no longer a common
176 enabled doxygen && php -v >/dev/null 2>&1 && enable_feature install_docs
177 enable_feature install_bins
178 enable_feature install_libs
180 enable_feature static
181 enable_feature optimizations
182 enable_feature fast_unaligned #allow unaligned accesses, if supported by hw
184 enable_feature spatial_resampling
185 enable_feature multithread
186 enable_feature os_support
187 enable_feature temporal_denoising
189 [ -d ${source_path}/../include ] && enable_feature alt_tree_layout
191 [ -d ${source_path}/${d} ] && disable_feature alt_tree_layout;
194 if ! enabled alt_tree_layout; then
195 # development environment
196 [ -d ${source_path}/vp8 ] && CODECS="${CODECS} vp8_encoder vp8_decoder"
197 [ -d ${source_path}/vp9 ] && CODECS="${CODECS} vp9_encoder vp9_decoder"
199 # customer environment
200 [ -f ${source_path}/../include/vpx/vp8cx.h ] && CODECS="${CODECS} vp8_encoder"
201 [ -f ${source_path}/../include/vpx/vp8dx.h ] && CODECS="${CODECS} vp8_decoder"
202 [ -f ${source_path}/../include/vpx/vp9cx.h ] && CODECS="${CODECS} vp9_encoder"
203 [ -f ${source_path}/../include/vpx/vp9dx.h ] && CODECS="${CODECS} vp9_decoder"
204 [ -f ${source_path}/../include/vpx/vp8cx.h ] || disable_feature vp8_encoder
205 [ -f ${source_path}/../include/vpx/vp8dx.h ] || disable_feature vp8_decoder
206 [ -f ${source_path}/../include/vpx/vp9cx.h ] || disable_feature vp9_encoder
207 [ -f ${source_path}/../include/vpx/vp9dx.h ] || disable_feature vp9_decoder
209 [ -f ${source_path}/../lib/*/*mt.lib ] && soft_enable static_msvcrt
212 CODECS="$(echo ${CODECS} | tr ' ' '\n')"
213 CODEC_FAMILIES="$(for c in ${CODECS}; do echo ${c%_*}; done | sort | uniq)"
364 --disable-codecs) for c in ${CODECS}; do disable_feature $c; done ;;
365 --enable-?*|--disable-?*)
366 eval `echo "$opt" | sed 's/--/action=/;s/-/ option=/;s/-/_/g'`
367 if echo "${EXPERIMENT_LIST}" | grep "^ *$option\$" >/dev/null; then
368 if enabled experimental; then
369 ${action}_feature $option
371 log_echo "Ignoring $opt -- not in experimental mode."
374 process_common_cmdline $opt
377 *) process_common_cmdline "$opt"
383 post_process_cmdline() {
386 # If the codec family is disabled, disable all components of that family.
387 # If the codec family is enabled, enable all components of that family.
388 log_echo "Configuring selected codecs"
389 for c in ${CODECS}; do
390 disabled ${c%%_*} && disable_feature ${c}
391 enabled ${c%%_*} && enable_feature ${c}
394 # Enable all detected codecs, if they haven't been disabled
395 for c in ${CODECS}; do soft_enable $c; done
397 # Enable the codec family if any component of that family is enabled
398 for c in ${CODECS}; do
399 enabled $c && enable_feature ${c%_*}
402 # Set the {en,de}coders variable if any algorithm in that class is enabled
403 for c in ${CODECS}; do
404 enabled ${c} && enable_feature ${c##*_}s
410 enabled child || write_common_config_banner
411 enabled universal || write_common_target_config_h ${BUILD_PFX}vpx_config.h
413 # TODO: add host tools target (obj_int_extract, etc)
415 # For fat binaries, call configure recursively to configure for each
416 # binary architecture to be included.
417 if enabled universal; then
418 # Call configure (ourselves) for each subarchitecture
419 for arch in $fat_bin_archs; do
420 BUILD_PFX=${arch}/ toolchain=${arch} $self --child $cmdline_args || exit $?
424 # The write_common_config (config.mk) logic is deferred until after the
425 # recursive calls to configure complete, becuase we want our universal
426 # targets to be executed last.
427 write_common_config_targets
428 enabled universal && echo "FAT_ARCHS=${fat_bin_archs}" >> config.mk
430 # Calculate the default distribution name, based on the enabled features
433 for cf in $CODEC_FAMILIES; do
434 if enabled ${cf}_encoder && enabled ${cf}_decoder; then
435 DIST_DIR="${DIST_DIR}-${cf}"
436 elif enabled ${cf}_encoder; then
437 DIST_DIR="${DIST_DIR}-${cf}cx"
438 elif enabled ${cf}_decoder; then
439 DIST_DIR="${DIST_DIR}-${cf}dx"
442 enabled debug_libs && DIST_DIR="${DIST_DIR}-debug"
443 enabled codec_srcs && DIST_DIR="${DIST_DIR}-src"
444 ! enabled postproc && ! enabled vp9_postproc && DIST_DIR="${DIST_DIR}-nopost"
445 ! enabled multithread && DIST_DIR="${DIST_DIR}-nomt"
446 ! enabled install_docs && DIST_DIR="${DIST_DIR}-nodocs"
447 DIST_DIR="${DIST_DIR}-${tgt_isa}-${tgt_os}"
449 win*) enabled static_msvcrt && DIST_DIR="${DIST_DIR}mt" || DIST_DIR="${DIST_DIR}md"
450 DIST_DIR="${DIST_DIR}-${tgt_cc}"
453 if [ -f "${source_path}/build/make/version.sh" ]; then
454 local ver=`"$source_path/build/make/version.sh" --bare $source_path`
455 DIST_DIR="${DIST_DIR}-${ver}"
456 VERSION_STRING=${ver}
458 VERSION_PATCH=${ver##*.}
460 VERSION_MINOR=${ver##*.}
462 VERSION_MAJOR=${ver%.*}
464 enabled child || cat <<EOF >> config.mk
467 ifeq (\$(MAKECMDGOALS),dist)
468 DIST_DIR?=${DIST_DIR}
470 DIST_DIR?=\$(DESTDIR)${prefix}
472 LIBSUBDIR=${libdir##${prefix}/}
474 VERSION_STRING=${VERSION_STRING}
476 VERSION_MAJOR=${VERSION_MAJOR}
477 VERSION_MINOR=${VERSION_MINOR}
478 VERSION_PATCH=${VERSION_PATCH}
480 CONFIGURE_ARGS=${CONFIGURE_ARGS}
482 enabled child || echo "CONFIGURE_ARGS?=${CONFIGURE_ARGS}" >> config.mk
485 # Write makefiles for all enabled targets
487 for tgt in libs examples docs solution; do
488 local tgt_fn="$tgt-$toolchain.mk"
490 if enabled $tgt; then
491 echo "Creating makefiles for ${toolchain} ${tgt}"
492 write_common_target_config_mk $tgt_fn ${BUILD_PFX}vpx_config.h
500 if enabled shared; then
501 # Can only build shared libs on a subset of platforms. Doing this check
502 # here rather than at option parse time because the target auto-detect
503 # magic happens after the command line has been parsed.
504 if ! enabled linux; then
506 echo "--enable-shared is only supported on ELF; assuming this is OK"
508 die "--enable-shared only supported on ELF for now"
512 if [ -z "$CC" ] || enabled external_build; then
513 echo "Bypassing toolchain for environment detection."
514 enable_feature external_build
516 log fake_check_header "$@"
519 var=`echo $header | sed 's/[^A-Za-z0-9_]/_/g'`
521 # Headers common to all environments
529 [ -f "${d##-I}/$header" ] && result=true && break
532 esac && enable_feature $var
534 # Specialize windows and POSIX environments.
537 case $header-$toolchain in
540 esac && enable_feature $var
549 esac && enable_feature $var
557 check_header stdio.h || die "Unable to invoke compiler: ${CC} ${CFLAGS}"
558 check_ld <<EOF || die "Toolchain is unable to link executables"
559 int main(void) {return 0;}
561 # check system headers
562 check_header stdint.h
563 check_header pthread.h
564 check_header sys/mman.h
565 check_header unistd.h # for sysconf(3) and friends.
567 check_header vpx/vpx_integer.h -I${source_path} && enable_feature vpx_ports
570 process_toolchain() {
571 process_common_toolchain
573 # Handle universal binaries for this architecture
576 local darwin_ver=${tgt_os##darwin}
578 # Snow Leopard (10.6/darwin10) dropped support for PPC
579 # Include PPC support for all prior versions
580 if [ $darwin_ver -lt 10 ]; then
581 fat_bin_archs="$fat_bin_archs ppc32-${tgt_os}-gcc"
584 # Tiger (10.4/darwin8) brought support for x86
585 if [ $darwin_ver -ge 8 ]; then
586 fat_bin_archs="$fat_bin_archs x86-${tgt_os}-${tgt_cc}"
589 # Leopard (10.5/darwin9) brought 64 bit support
590 if [ $darwin_ver -ge 9 ]; then
591 fat_bin_archs="$fat_bin_archs x86_64-${tgt_os}-${tgt_cc}"
597 # Enable some useful compiler flags
599 enabled werror && check_add_cflags -Werror
600 check_add_cflags -Wall
601 check_add_cflags -Wdeclaration-after-statement
602 check_add_cflags -Wdisabled-optimization
603 check_add_cflags -Wpointer-arith
604 check_add_cflags -Wtype-limits
605 check_add_cflags -Wcast-qual
606 check_add_cflags -Wvla
607 check_add_cflags -Wimplicit-function-declaration
608 check_add_cflags -Wuninitialized
609 check_add_cflags -Wunused-variable
612 *) check_add_cflags -Wunused-but-set-variable ;;
614 enabled extra_warnings || check_add_cflags -Wno-unused-function
618 enabled werror && check_add_cflags -Werror
619 check_add_cflags -Wall
620 check_add_cflags -Wpointer-arith
622 # ICC has a number of floating point optimizations that we disable
623 # in favor of deterministic output WRT to other compilers
624 add_cflags -fp-model precise
627 # Enable extra, harmless warnings. These might provide additional insight
628 # to what the compiler is doing and why, but in general, but they shouldn't
629 # be treated as fatal, even if we're treating warnings as errors.
631 -Wdisabled-optimization
634 enabled gcc && EXTRA_WARNINGS="${GCC_EXTRA_WARNINGS}"
635 RVCT_EXTRA_WARNINGS="
638 enabled rvct && EXTRA_WARNINGS="${RVCT_EXTRA_WARNINGS}"
639 if enabled extra_warnings; then
640 for w in ${EXTRA_WARNINGS}; do
641 check_add_cflags ${w}
642 enabled gcc && enabled werror && check_add_cflags -Wno-error=${w}
646 # ccache only really works on gcc toolchains
647 enabled gcc || soft_disable ccache
648 if enabled mips; then
649 enable_feature dequant_tokens
650 enable_feature dc_recon
653 if enabled internal_stats; then
654 enable_feature vp9_postproc
657 # Enable the postbuild target if building for visual studio.
659 vs*) enable_feature msvs
660 enable_feature solution
661 vs_version=${tgt_cc##vs}
665 gen_vcproj_cmd=${source_path}/build/make/gen_msvs_proj.sh
669 gen_vcproj_cmd=${source_path}/build/make/gen_msvs_vcxproj.sh
672 all_targets="${all_targets} solution"
673 INLINE="__forceinline"
677 # Other toolchain specific defaults
678 case $toolchain in x86*|ppc*|universal*) soft_enable postproc;; esac
680 if enabled postproc_visualizer; then
681 enabled postproc || die "postproc_visualizer requires postproc to be enabled"
684 # Enable unit tests by default if we have a working C++ compiler.
687 soft_enable unit_tests
690 # GTestLog must be modified to use Android logging utilities.
693 # iOS/ARM builds do not work with gtest. This does not match
697 # Some mingw toolchains don't have pthread available by default.
698 # Treat these more like visual studio where threading in gtest
699 # would be disabled for the same reason.
700 check_cxx "$@" <<EOF && soft_enable unit_tests
705 enabled pthread_h && check_cxx "$@" <<EOF && soft_enable unit_tests
714 ## END APPLICATION SPECIFIC CONFIGURATION
718 print_webm_license ${BUILD_PFX}vpx_config.c "/*" " */"
719 cat <<EOF >> ${BUILD_PFX}vpx_config.c
720 static const char* const cfg = "$CONFIGURE_ARGS";
721 const char *vpx_codec_build_config(void) {return cfg;}