ref: 9dfd0060176ad0d6f5beb465ae75a67584169acd
dir: /examples.mk/
## ## Copyright (c) 2010 The WebM project authors. All Rights Reserved. ## ## Use of this source code is governed by a BSD-style license ## that can be found in the LICENSE file in the root of the source ## tree. An additional intellectual property rights grant can be found ## in the file PATENTS. All contributing project authors may ## be found in the AUTHORS file in the root of the source tree. ## # List of examples to build. UTILS are files that are taken from the source # tree directly, and GEN_EXAMPLES are files that are created from the # examples folder. UTILS-$(CONFIG_DECODERS) += vpxdec.c vpxdec.SRCS += md5_utils.c md5_utils.h vpxdec.SRCS += vpx_ports/vpx_timer.h vpxdec.SRCS += vpx/vpx_integer.h vpxdec.SRCS += args.c args.h vpx_ports/config.h vpxdec.SRCS += tools_common.c tools_common.h vpxdec.SRCS += nestegg/halloc/halloc.h vpxdec.SRCS += nestegg/halloc/src/align.h vpxdec.SRCS += nestegg/halloc/src/halloc.c vpxdec.SRCS += nestegg/halloc/src/hlist.h vpxdec.SRCS += nestegg/halloc/src/macros.h vpxdec.SRCS += nestegg/include/nestegg/nestegg.h vpxdec.SRCS += nestegg/src/nestegg.c vpxdec.GUID = BA5FE66F-38DD-E034-F542-B1578C5FB950 vpxdec.DESCRIPTION = Full featured decoder UTILS-$(CONFIG_ENCODERS) += vpxenc.c vpxenc.SRCS += args.c args.h y4minput.c y4minput.h vpxenc.SRCS += tools_common.c tools_common.h vpxenc.SRCS += vpx_ports/config.h vpx_ports/mem_ops.h vpxenc.SRCS += vpx_ports/mem_ops_aligned.h vpxenc.SRCS += libmkv/EbmlIDs.h vpxenc.SRCS += libmkv/EbmlWriter.c vpxenc.SRCS += libmkv/EbmlWriter.h vpxenc.GUID = 548DEC74-7A15-4B2B-AFC3-AA102E7C25C1 vpxenc.DESCRIPTION = Full featured encoder # Clean up old ivfenc, ivfdec binaries. ifeq ($(CONFIG_MSVS),yes) CLEAN-OBJS += $(foreach p,$(VS_PLATFORMS),$(p)/Release/ivfenc.exe) CLEAN-OBJS += $(foreach p,$(VS_PLATFORMS),$(p)/Release/ivfdec.exe) else CLEAN-OBJS += ivfenc{.c.o,.c.d,.dox,.exe,} CLEAN-OBJS += ivfdec{.c.o,.c.d,.dox,.exe,} endif # XMA example disabled for now, not used in VP8 #UTILS-$(CONFIG_DECODERS) += example_xma.c #example_xma.GUID = A955FC4A-73F1-44F7-135E-30D84D32F022 #example_xma.DESCRIPTION = External Memory Allocation mode usage GEN_EXAMPLES-$(CONFIG_DECODERS) += simple_decoder.c simple_decoder.GUID = D3BBF1E9-2427-450D-BBFF-B2843C1D44CC simple_decoder.DESCRIPTION = Simplified decoder loop GEN_EXAMPLES-$(CONFIG_DECODERS) += postproc.c postproc.GUID = 65E33355-F35E-4088-884D-3FD4905881D7 postproc.DESCRIPTION = Decoder postprocessor control GEN_EXAMPLES-$(CONFIG_DECODERS) += decode_to_md5.c decode_to_md5.SRCS += md5_utils.h md5_utils.c decode_to_md5.GUID = 59120B9B-2735-4BFE-B022-146CA340FE42 decode_to_md5.DESCRIPTION = Frame by frame MD5 checksum GEN_EXAMPLES-$(CONFIG_ENCODERS) += simple_encoder.c simple_encoder.GUID = 4607D299-8A71-4D2C-9B1D-071899B6FBFD simple_encoder.DESCRIPTION = Simplified encoder loop GEN_EXAMPLES-$(CONFIG_ENCODERS) += twopass_encoder.c twopass_encoder.GUID = 73494FA6-4AF9-4763-8FBB-265C92402FD8 twopass_encoder.DESCRIPTION = Two-pass encoder loop GEN_EXAMPLES-$(CONFIG_ENCODERS) += force_keyframe.c force_keyframe.GUID = 3C67CADF-029F-4C86-81F5-D6D4F51177F0 force_keyframe.DESCRIPTION = Force generation of keyframes ifeq ($(CONFIG_DECODERS),yes) GEN_EXAMPLES-$(CONFIG_ENCODERS) += decode_with_drops.c endif decode_with_drops.GUID = CE5C53C4-8DDA-438A-86ED-0DDD3CDB8D26 decode_with_drops.DESCRIPTION = Drops frames while decoding ifeq ($(CONFIG_DECODERS),yes) GEN_EXAMPLES-$(CONFIG_ERROR_CONCEALMENT) += decode_with_partial_drops.c endif decode_with_partial_drops.GUID = 61C2D026-5754-46AC-916F-1343ECC5537E decode_with_partial_drops.DESCRIPTION = Drops parts of frames while decoding GEN_EXAMPLES-$(CONFIG_ENCODERS) += error_resilient.c error_resilient.GUID = DF5837B9-4145-4F92-A031-44E4F832E00C error_resilient.DESCRIPTION = Error Resiliency Feature GEN_EXAMPLES-$(CONFIG_VP8_ENCODER) += vp8_scalable_patterns.c vp8_scalable_patterns.GUID = 0D6A210B-F482-4D6F-8570-4A9C01ACC88C vp8_scalable_patterns.DESCRIPTION = VP8 Scalable Bitstream Patterns GEN_EXAMPLES-$(CONFIG_VP8_ENCODER) += vp8_set_maps.c vp8_set_maps.GUID = ECB2D24D-98B8-4015-A465-A4AF3DCC145F vp8_set_maps.DESCRIPTION = VP8 set active and ROI maps GEN_EXAMPLES-$(CONFIG_VP8_ENCODER) += vp8cx_set_ref.c vp8cx_set_ref.GUID = C5E31F7F-96F6-48BD-BD3E-10EBF6E8057A vp8cx_set_ref.DESCRIPTION = VP8 set encoder reference frame # Handle extra library flags depending on codec configuration # We should not link to math library (libm) on RVCT # when building for bare-metal targets ifeq ($(CONFIG_OS_SUPPORT), yes) CODEC_EXTRA_LIBS-$(CONFIG_VP8) += m else ifeq ($(CONFIG_GCC), yes) CODEC_EXTRA_LIBS-$(CONFIG_VP8) += m endif endif # # End of specified files. The rest of the build rules should happen # automagically from here. # # Examples need different flags based on whether we're building # from an installed tree or a version controlled tree. Determine # the proper paths. ifeq ($(HAVE_ALT_TREE_LAYOUT),yes) LIB_PATH := $(SRC_PATH_BARE)/../lib INC_PATH := $(SRC_PATH_BARE)/../include else LIB_PATH-yes += $(if $(BUILD_PFX),$(BUILD_PFX),.) INC_PATH-$(CONFIG_VP8_DECODER) += $(SRC_PATH_BARE)/vp8 INC_PATH-$(CONFIG_VP8_ENCODER) += $(SRC_PATH_BARE)/vp8 LIB_PATH := $(call enabled,LIB_PATH) INC_PATH := $(call enabled,INC_PATH) endif INTERNAL_CFLAGS = $(addprefix -I,$(INC_PATH)) INTERNAL_LDFLAGS += $(addprefix -L,$(LIB_PATH)) # Expand list of selected examples to build (as specified above) UTILS = $(call enabled,UTILS) GEN_EXAMPLES = $(call enabled,GEN_EXAMPLES) ALL_EXAMPLES = $(UTILS) $(GEN_EXAMPLES) UTIL_SRCS = $(foreach ex,$(UTILS),$($(ex:.c=).SRCS)) ALL_SRCS = $(foreach ex,$(ALL_EXAMPLES),$($(ex:.c=).SRCS)) CODEC_EXTRA_LIBS=$(sort $(call enabled,CODEC_EXTRA_LIBS)) # Expand all example sources into a variable containing all sources # for that example (not just them main one specified in UTILS/GEN_EXAMPLES) # and add this file to the list (for MSVS workspace generation) $(foreach ex,$(ALL_EXAMPLES),$(eval $(ex:.c=).SRCS += $(ex) examples.mk)) # If this is a universal (fat) binary, then all the subarchitectures have # already been built and our job is to stitch them together. The # BUILD_OBJS variable indicates whether we should be building # (compiling, linking) the library. The LIPO_OBJS variable indicates # that we're stitching. $(eval $(if $(filter universal%,$(TOOLCHAIN)),LIPO_OBJS,BUILD_OBJS):=yes) # Create build/install dependencies for all examples. The common case # is handled here. The MSVS case is handled below. NOT_MSVS = $(if $(CONFIG_MSVS),,yes) DIST-BINS-$(NOT_MSVS) += $(addprefix bin/,$(ALL_EXAMPLES:.c=)) INSTALL-BINS-$(NOT_MSVS) += $(addprefix bin/,$(UTILS:.c=)) DIST-SRCS-yes += $(ALL_SRCS) INSTALL-SRCS-yes += $(UTIL_SRCS) OBJS-$(NOT_MSVS) += $(if $(BUILD_OBJS),$(call objs,$(ALL_SRCS))) BINS-$(NOT_MSVS) += $(addprefix $(BUILD_PFX),$(ALL_EXAMPLES:.c=)) # Instantiate linker template for all examples. CODEC_LIB=$(if $(CONFIG_DEBUG_LIBS),vpx_g,vpx) $(foreach bin,$(BINS-yes),\ $(if $(BUILD_OBJS),$(eval $(bin): $(LIB_PATH)/lib$(CODEC_LIB).a))\ $(if $(BUILD_OBJS),$(eval $(call linker_template,$(bin),\ $(call objs,$($(notdir $(bin)).SRCS)) \ -l$(CODEC_LIB) $(addprefix -l,$(CODEC_EXTRA_LIBS))\ )))\ $(if $(LIPO_OBJS),$(eval $(call lipo_bin_template,$(bin))))\ ) # Rules to generate the GEN_EXAMPLES sources .PRECIOUS: %.c CLEAN-OBJS += $(GEN_EXAMPLES) %.c: examples/%.txt @echo " [EXAMPLE] $@" @$(SRC_PATH_BARE)/examples/gen_example_code.sh $< > $@ # The following pairs define a mapping of locations in the distribution # tree to locations in the source/build trees. INSTALL_MAPS += src/%.c %.c INSTALL_MAPS += src/% $(SRC_PATH_BARE)/% INSTALL_MAPS += bin/% % INSTALL_MAPS += % % # Set up additional MSVS environment ifeq ($(CONFIG_MSVS),yes) CODEC_LIB=$(if $(CONFIG_STATIC_MSVCRT),vpxmt,vpxmd) # This variable uses deferred expansion intentionally, since the results of # $(wildcard) may change during the course of the Make. VS_PLATFORMS = $(foreach d,$(wildcard */Release/$(CODEC_LIB).lib),$(word 1,$(subst /, ,$(d)))) INSTALL_MAPS += $(foreach p,$(VS_PLATFORMS),bin/$(p)/% $(p)/Release/%) endif # Build Visual Studio Projects. We use a template here to instantiate # explicit rules rather than using an implicit rule because we want to # leverage make's VPATH searching rather than specifying the paths on # each file in ALL_EXAMPLES. This has the unfortunate side effect that # touching the source files trigger a rebuild of the project files # even though there is no real dependency there (the dependency is on # the makefiles). We may want to revisit this. define vcproj_template $(1): $($(1:.vcproj=).SRCS) @echo " [vcproj] $$@" $$(SRC_PATH_BARE)/build/make/gen_msvs_proj.sh\ --exe\ --target=$$(TOOLCHAIN)\ --name=$$(@:.vcproj=)\ --ver=$$(CONFIG_VS_VERSION)\ --proj-guid=$$($$(@:.vcproj=).GUID)\ $$(if $$(CONFIG_STATIC_MSVCRT),--static-crt) \ --out=$$@ $$(INTERNAL_CFLAGS) $$(CFLAGS) \ $$(INTERNAL_LDFLAGS) $$(LDFLAGS) -l$$(CODEC_LIB) -lwinmm $$^ endef PROJECTS-$(CONFIG_MSVS) += $(ALL_EXAMPLES:.c=.vcproj) INSTALL-BINS-$(CONFIG_MSVS) += $(foreach p,$(VS_PLATFORMS),\ $(addprefix bin/$(p)/,$(ALL_EXAMPLES:.c=.exe))) $(foreach proj,$(call enabled,PROJECTS),\ $(eval $(call vcproj_template,$(proj)))) # # Documentation Rules # %.dox: examples/%.txt @echo " [DOXY] $@" @$(SRC_PATH_BARE)/examples/gen_example_text.sh $< | \ $(SRC_PATH_BARE)/examples/gen_example_doxy.php \ example_$(@:.dox=) $(@:.dox=.c) > $@ %.dox: %.c @echo " [DOXY] $@" @echo "/*!\page example_$(@:.dox=) $(@:.dox=)" > $@ @echo " \includelineno $(notdir $<)" >> $@ @echo "*/" >> $@ samples.dox: examples.mk @echo " [DOXY] $@" @echo "/*!\page samples Sample Code" > $@ @echo " This SDK includes a number of sample applications."\ "each sample documents a feature of the SDK in both prose"\ "and the associated C code. In general, later samples"\ "build upon prior samples, so it is best to work through the"\ "list in order. The following samples are included: ">>$@ @$(foreach ex,$(GEN_EXAMPLES:.c=),\ echo " - \subpage example_$(ex) $($(ex).DESCRIPTION)" >> $@;) @echo >> $@ @echo " In addition, the SDK contains a number of utilities."\ "Since these utilities are built upon the concepts described"\ "in the sample code listed above, they are not documented in"\ "pieces like the samples are. Thir sourcre is included here"\ "for reference. The following utilities are included:" >> $@ @$(foreach ex,$(UTILS:.c=),\ echo " - \subpage example_$(ex) $($(ex).DESCRIPTION)" >> $@;) @echo "*/" >> $@ CLEAN-OBJS += examples.doxy samples.dox $(ALL_EXAMPLES:.c=.dox) DOCS-yes += examples.doxy samples.dox $(ALL_EXAMPLES:.c=.dox) examples.doxy: samples.dox $(ALL_EXAMPLES:.c=.dox) @echo "INPUT += $^" > $@