examples.mk 17.9 KB
Newer Older
John Koleszar's avatar
John Koleszar committed
1
##
2
##  Copyright (c) 2010 The WebM project authors. All Rights Reserved.
John Koleszar's avatar
John Koleszar committed
3
##
4
##  Use of this source code is governed by a BSD-style license
5 6
##  that can be found in the LICENSE file in the root of the source
##  tree. An additional intellectual property rights grant can be found
7
##  in the file PATENTS.  All contributing project authors may
8
##  be found in the AUTHORS file in the root of the source tree.
John Koleszar's avatar
John Koleszar committed
9 10
##

11
LIBYUV_SRCS +=  third_party/libyuv/include/libyuv/basic_types.h  \
James Zern's avatar
James Zern committed
12 13 14
                third_party/libyuv/include/libyuv/convert.h \
                third_party/libyuv/include/libyuv/convert_argb.h \
                third_party/libyuv/include/libyuv/convert_from.h \
15
                third_party/libyuv/include/libyuv/cpu_id.h  \
16
                third_party/libyuv/include/libyuv/planar_functions.h  \
James Zern's avatar
James Zern committed
17
                third_party/libyuv/include/libyuv/rotate.h  \
18
                third_party/libyuv/include/libyuv/row.h  \
19
                third_party/libyuv/include/libyuv/scale.h  \
20 21 22 23 24
                third_party/libyuv/include/libyuv/scale_row.h  \
                third_party/libyuv/source/cpu_id.cc \
                third_party/libyuv/source/planar_functions.cc \
                third_party/libyuv/source/row_any.cc \
                third_party/libyuv/source/row_common.cc \
James Zern's avatar
James Zern committed
25
                third_party/libyuv/source/row_gcc.cc \
26 27
                third_party/libyuv/source/row_mips.cc \
                third_party/libyuv/source/row_neon.cc \
James Zern's avatar
James Zern committed
28
                third_party/libyuv/source/row_neon64.cc \
29
                third_party/libyuv/source/row_win.cc \
James Zern's avatar
James Zern committed
30
                third_party/libyuv/source/scale.cc \
James Zern's avatar
James Zern committed
31
                third_party/libyuv/source/scale_any.cc \
32
                third_party/libyuv/source/scale_common.cc \
James Zern's avatar
James Zern committed
33
                third_party/libyuv/source/scale_gcc.cc \
34 35
                third_party/libyuv/source/scale_mips.cc \
                third_party/libyuv/source/scale_neon.cc \
James Zern's avatar
James Zern committed
36
                third_party/libyuv/source/scale_neon64.cc \
James Zern's avatar
James Zern committed
37
                third_party/libyuv/source/scale_win.cc \
John Koleszar's avatar
John Koleszar committed
38

39 40
LIBWEBM_COMMON_SRCS += third_party/libwebm/webmids.hpp

41 42 43 44 45 46 47
LIBWEBM_MUXER_SRCS += third_party/libwebm/mkvmuxer.cpp \
                      third_party/libwebm/mkvmuxerutil.cpp \
                      third_party/libwebm/mkvwriter.cpp \
                      third_party/libwebm/mkvmuxer.hpp \
                      third_party/libwebm/mkvmuxertypes.hpp \
                      third_party/libwebm/mkvmuxerutil.hpp \
                      third_party/libwebm/mkvparser.hpp \
48
                      third_party/libwebm/mkvwriter.hpp
49

50 51 52 53 54
LIBWEBM_PARSER_SRCS = third_party/libwebm/mkvparser.cpp \
                      third_party/libwebm/mkvreader.cpp \
                      third_party/libwebm/mkvparser.hpp \
                      third_party/libwebm/mkvreader.hpp

55 56
# List of examples to build. UTILS are tools meant for distribution
# while EXAMPLES demonstrate specific portions of the API.
57 58
UTILS-$(CONFIG_DECODERS)    += vpxdec.c
vpxdec.SRCS                 += md5_utils.c md5_utils.h
59 60
vpxdec.SRCS                 += vpx_ports/mem_ops.h
vpxdec.SRCS                 += vpx_ports/mem_ops_aligned.h
61
vpxdec.SRCS                 += vpx_ports/msvc.h
62 63
vpxdec.SRCS                 += vpx_ports/vpx_timer.h
vpxdec.SRCS                 += vpx/vpx_integer.h
64
vpxdec.SRCS                 += args.c args.h
65
vpxdec.SRCS                 += ivfdec.c ivfdec.h
66
vpxdec.SRCS                 += tools_common.c tools_common.h
67
vpxdec.SRCS                 += y4menc.c y4menc.h
68 69 70
ifeq ($(CONFIG_LIBYUV),yes)
  vpxdec.SRCS                 += $(LIBYUV_SRCS)
endif
71
ifeq ($(CONFIG_WEBM_IO),yes)
72
  vpxdec.SRCS                 += $(LIBWEBM_COMMON_SRCS)
73 74
  vpxdec.SRCS                 += $(LIBWEBM_PARSER_SRCS)
  vpxdec.SRCS                 += webmdec.cc webmdec.h
75
endif
76 77 78
vpxdec.GUID                  = BA5FE66F-38DD-E034-F542-B1578C5FB950
vpxdec.DESCRIPTION           = Full featured decoder
UTILS-$(CONFIG_ENCODERS)    += vpxenc.c
79
vpxenc.SRCS                 += args.c args.h y4minput.c y4minput.h vpxenc.h
80 81
vpxenc.SRCS                 += ivfdec.c ivfdec.h
vpxenc.SRCS                 += ivfenc.c ivfenc.h
82
vpxenc.SRCS                 += rate_hist.c rate_hist.h
83
vpxenc.SRCS                 += tools_common.c tools_common.h
84
vpxenc.SRCS                 += warnings.c warnings.h
85
vpxenc.SRCS                 += vpx_ports/mem_ops.h
86
vpxenc.SRCS                 += vpx_ports/mem_ops_aligned.h
87
vpxenc.SRCS                 += vpx_ports/msvc.h
Johann's avatar
Johann committed
88
vpxenc.SRCS                 += vpx_ports/vpx_timer.h
89
vpxenc.SRCS                 += vpxstats.c vpxstats.h
90 91 92
ifeq ($(CONFIG_LIBYUV),yes)
  vpxenc.SRCS                 += $(LIBYUV_SRCS)
endif
93
ifeq ($(CONFIG_WEBM_IO),yes)
94
  vpxenc.SRCS                 += $(LIBWEBM_COMMON_SRCS)
95 96
  vpxenc.SRCS                 += $(LIBWEBM_MUXER_SRCS)
  vpxenc.SRCS                 += webmenc.cc webmenc.h
97
endif
98 99
vpxenc.GUID                  = 548DEC74-7A15-4B2B-AFC3-AA102E7C25C1
vpxenc.DESCRIPTION           = Full featured encoder
100 101 102 103 104 105 106
ifeq ($(CONFIG_SPATIAL_SVC),yes)
  EXAMPLES-$(CONFIG_VP9_ENCODER)      += vp9_spatial_svc_encoder.c
  vp9_spatial_svc_encoder.SRCS        += args.c args.h
  vp9_spatial_svc_encoder.SRCS        += ivfenc.c ivfenc.h
  vp9_spatial_svc_encoder.SRCS        += tools_common.c tools_common.h
  vp9_spatial_svc_encoder.SRCS        += video_common.h
  vp9_spatial_svc_encoder.SRCS        += video_writer.h video_writer.c
107
  vp9_spatial_svc_encoder.SRCS        += vpx_ports/msvc.h
108 109 110 111
  vp9_spatial_svc_encoder.SRCS        += vpxstats.c vpxstats.h
  vp9_spatial_svc_encoder.GUID        = 4A38598D-627D-4505-9C7B-D4020C84100D
  vp9_spatial_svc_encoder.DESCRIPTION = VP9 Spatial SVC Encoder
endif
112

113
ifneq ($(CONFIG_SHARED),yes)
114
EXAMPLES-$(CONFIG_VP9_ENCODER)    += resize_util.c
115 116
endif

117 118 119 120 121
EXAMPLES-$(CONFIG_ENCODERS)          += vpx_temporal_svc_encoder.c
vpx_temporal_svc_encoder.SRCS        += ivfenc.c ivfenc.h
vpx_temporal_svc_encoder.SRCS        += tools_common.c tools_common.h
vpx_temporal_svc_encoder.SRCS        += video_common.h
vpx_temporal_svc_encoder.SRCS        += video_writer.h video_writer.c
122
vpx_temporal_svc_encoder.SRCS        += vpx_ports/msvc.h
123 124
vpx_temporal_svc_encoder.GUID        = B18C08F2-A439-4502-A78E-849BE3D60947
vpx_temporal_svc_encoder.DESCRIPTION = Temporal SVC Encoder
125
EXAMPLES-$(CONFIG_DECODERS)        += simple_decoder.c
126
simple_decoder.GUID                 = D3BBF1E9-2427-450D-BBFF-B2843C1D44CC
127 128
simple_decoder.SRCS                += ivfdec.h ivfdec.c
simple_decoder.SRCS                += tools_common.h tools_common.c
129 130
simple_decoder.SRCS                += video_common.h
simple_decoder.SRCS                += video_reader.h video_reader.c
131 132
simple_decoder.SRCS                += vpx_ports/mem_ops.h
simple_decoder.SRCS                += vpx_ports/mem_ops_aligned.h
133
simple_decoder.SRCS                += vpx_ports/msvc.h
134
simple_decoder.DESCRIPTION          = Simplified decoder loop
135
EXAMPLES-$(CONFIG_DECODERS)        += postproc.c
136 137
postproc.SRCS                      += ivfdec.h ivfdec.c
postproc.SRCS                      += tools_common.h tools_common.c
138 139
postproc.SRCS                      += video_common.h
postproc.SRCS                      += video_reader.h video_reader.c
140 141
postproc.SRCS                      += vpx_ports/mem_ops.h
postproc.SRCS                      += vpx_ports/mem_ops_aligned.h
142
postproc.SRCS                      += vpx_ports/msvc.h
143 144
postproc.GUID                       = 65E33355-F35E-4088-884D-3FD4905881D7
postproc.DESCRIPTION                = Decoder postprocessor control
145
EXAMPLES-$(CONFIG_DECODERS)        += decode_to_md5.c
146 147 148
decode_to_md5.SRCS                 += md5_utils.h md5_utils.c
decode_to_md5.SRCS                 += ivfdec.h ivfdec.c
decode_to_md5.SRCS                 += tools_common.h tools_common.c
149 150
decode_to_md5.SRCS                 += video_common.h
decode_to_md5.SRCS                 += video_reader.h video_reader.c
151 152
decode_to_md5.SRCS                 += vpx_ports/mem_ops.h
decode_to_md5.SRCS                 += vpx_ports/mem_ops_aligned.h
153
decode_to_md5.SRCS                 += vpx_ports/msvc.h
154 155
decode_to_md5.GUID                  = 59120B9B-2735-4BFE-B022-146CA340FE42
decode_to_md5.DESCRIPTION           = Frame by frame MD5 checksum
156
EXAMPLES-$(CONFIG_ENCODERS)     += simple_encoder.c
157 158 159 160
simple_encoder.SRCS             += ivfenc.h ivfenc.c
simple_encoder.SRCS             += tools_common.h tools_common.c
simple_encoder.SRCS             += video_common.h
simple_encoder.SRCS             += video_writer.h video_writer.c
161
simple_encoder.SRCS             += vpx_ports/msvc.h
John Koleszar's avatar
John Koleszar committed
162 163
simple_encoder.GUID              = 4607D299-8A71-4D2C-9B1D-071899B6FBFD
simple_encoder.DESCRIPTION       = Simplified encoder loop
164 165 166 167 168
EXAMPLES-$(CONFIG_VP9_ENCODER)  += vp9_lossless_encoder.c
vp9_lossless_encoder.SRCS       += ivfenc.h ivfenc.c
vp9_lossless_encoder.SRCS       += tools_common.h tools_common.c
vp9_lossless_encoder.SRCS       += video_common.h
vp9_lossless_encoder.SRCS       += video_writer.h video_writer.c
169
vp9_lossless_encoder.SRCS       += vpx_ports/msvc.h
170 171
vp9_lossless_encoder.GUID        = B63C7C88-5348-46DC-A5A6-CC151EF93366
vp9_lossless_encoder.DESCRIPTION = Simplified lossless VP9 encoder
172
EXAMPLES-$(CONFIG_ENCODERS)     += twopass_encoder.c
173 174 175 176
twopass_encoder.SRCS            += ivfenc.h ivfenc.c
twopass_encoder.SRCS            += tools_common.h tools_common.c
twopass_encoder.SRCS            += video_common.h
twopass_encoder.SRCS            += video_writer.h video_writer.c
177
twopass_encoder.SRCS            += vpx_ports/msvc.h
John Koleszar's avatar
John Koleszar committed
178 179
twopass_encoder.GUID             = 73494FA6-4AF9-4763-8FBB-265C92402FD8
twopass_encoder.DESCRIPTION      = Two-pass encoder loop
180
EXAMPLES-$(CONFIG_DECODERS)     += decode_with_drops.c
181 182
decode_with_drops.SRCS          += ivfdec.h ivfdec.c
decode_with_drops.SRCS          += tools_common.h tools_common.c
183 184
decode_with_drops.SRCS          += video_common.h
decode_with_drops.SRCS          += video_reader.h video_reader.c
185 186
decode_with_drops.SRCS          += vpx_ports/mem_ops.h
decode_with_drops.SRCS          += vpx_ports/mem_ops_aligned.h
187
decode_with_drops.SRCS          += vpx_ports/msvc.h
John Koleszar's avatar
John Koleszar committed
188 189
decode_with_drops.GUID           = CE5C53C4-8DDA-438A-86ED-0DDD3CDB8D26
decode_with_drops.DESCRIPTION    = Drops frames while decoding
190 191 192 193 194
EXAMPLES-$(CONFIG_ENCODERS)        += set_maps.c
set_maps.SRCS                      += ivfenc.h ivfenc.c
set_maps.SRCS                      += tools_common.h tools_common.c
set_maps.SRCS                      += video_common.h
set_maps.SRCS                      += video_writer.h video_writer.c
195
set_maps.SRCS                      += vpx_ports/msvc.h
196 197
set_maps.GUID                       = ECB2D24D-98B8-4015-A465-A4AF3DCC145F
set_maps.DESCRIPTION                = Set active and ROI maps
198
EXAMPLES-$(CONFIG_VP8_ENCODER)     += vp8cx_set_ref.c
199 200 201 202
vp8cx_set_ref.SRCS                 += ivfenc.h ivfenc.c
vp8cx_set_ref.SRCS                 += tools_common.h tools_common.c
vp8cx_set_ref.SRCS                 += video_common.h
vp8cx_set_ref.SRCS                 += video_writer.h video_writer.c
203
vp8cx_set_ref.SRCS                 += vpx_ports/msvc.h
John Koleszar's avatar
John Koleszar committed
204 205 206
vp8cx_set_ref.GUID                  = C5E31F7F-96F6-48BD-BD3E-10EBF6E8057A
vp8cx_set_ref.DESCRIPTION           = VP8 set encoder reference frame

207 208

ifeq ($(CONFIG_MULTI_RES_ENCODING),yes)
209
ifeq ($(CONFIG_LIBYUV),yes)
210
EXAMPLES-$(CONFIG_VP8_ENCODER)          += vp8_multi_resolution_encoder.c
211
vp8_multi_resolution_encoder.SRCS       += ivfenc.h ivfenc.c
212
vp8_multi_resolution_encoder.SRCS       += tools_common.h tools_common.c
213
vp8_multi_resolution_encoder.SRCS       += video_writer.h video_writer.c
214
vp8_multi_resolution_encoder.SRCS       += vpx_ports/msvc.h
215 216 217 218
vp8_multi_resolution_encoder.SRCS       += $(LIBYUV_SRCS)
vp8_multi_resolution_encoder.GUID        = 04f8738e-63c8-423b-90fa-7c2703a374de
vp8_multi_resolution_encoder.DESCRIPTION = VP8 Multiple-resolution Encoding
endif
219
endif
John Koleszar's avatar
John Koleszar committed
220 221 222

# Handle extra library flags depending on codec configuration

223 224 225 226
# 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
227
CODEC_EXTRA_LIBS-$(CONFIG_VP9)         += m
228 229 230
else
    ifeq ($(CONFIG_GCC), yes)
    CODEC_EXTRA_LIBS-$(CONFIG_VP8)         += m
231
    CODEC_EXTRA_LIBS-$(CONFIG_VP9)         += m
232 233
    endif
endif
John Koleszar's avatar
John Koleszar committed
234 235 236 237 238 239 240 241 242 243
#
# 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)
James Zern's avatar
James Zern committed
244 245
    LIB_PATH-yes := $(SRC_PATH_BARE)/../lib
    INC_PATH-yes := $(SRC_PATH_BARE)/../include
John Koleszar's avatar
John Koleszar committed
246 247 248 249
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
250 251
    INC_PATH-$(CONFIG_VP9_DECODER)   += $(SRC_PATH_BARE)/vp9
    INC_PATH-$(CONFIG_VP9_ENCODER)   += $(SRC_PATH_BARE)/vp9
John Koleszar's avatar
John Koleszar committed
252
endif
James Zern's avatar
James Zern committed
253 254 255
INC_PATH-$(CONFIG_LIBYUV) += $(SRC_PATH_BARE)/third_party/libyuv/include
LIB_PATH := $(call enabled,LIB_PATH)
INC_PATH := $(call enabled,INC_PATH)
256 257
INTERNAL_CFLAGS = $(addprefix -I,$(INC_PATH))
INTERNAL_LDFLAGS += $(addprefix -L,$(LIB_PATH))
John Koleszar's avatar
John Koleszar committed
258 259 260 261


# Expand list of selected examples to build (as specified above)
UTILS           = $(call enabled,UTILS)
262 263
EXAMPLES        = $(addprefix examples/,$(call enabled,EXAMPLES))
ALL_EXAMPLES    = $(UTILS) $(EXAMPLES)
264
UTIL_SRCS       = $(foreach ex,$(UTILS),$($(ex:.c=).SRCS))
265
ALL_SRCS        = $(foreach ex,$(ALL_EXAMPLES),$($(notdir $(ex:.c=)).SRCS))
John Koleszar's avatar
John Koleszar committed
266 267 268 269
CODEC_EXTRA_LIBS=$(sort $(call enabled,CODEC_EXTRA_LIBS))


# Expand all example sources into a variable containing all sources
270
# for that example (not just them main one specified in UTILS/EXAMPLES)
John Koleszar's avatar
John Koleszar committed
271
# and add this file to the list (for MSVS workspace generation)
272
$(foreach ex,$(ALL_EXAMPLES),$(eval $(notdir $(ex:.c=)).SRCS += $(ex) examples.mk))
John Koleszar's avatar
John Koleszar committed
273 274 275 276 277


# 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)
KO Myung-Hun's avatar
KO Myung-Hun committed
278 279
DIST-BINS-$(NOT_MSVS)      += $(addprefix bin/,$(ALL_EXAMPLES:.c=$(EXE_SFX)))
INSTALL-BINS-$(NOT_MSVS)   += $(addprefix bin/,$(UTILS:.c=$(EXE_SFX)))
280 281
DIST-SRCS-yes              += $(ALL_SRCS)
INSTALL-SRCS-yes           += $(UTIL_SRCS)
282
OBJS-$(NOT_MSVS)           += $(call objs,$(ALL_SRCS))
KO Myung-Hun's avatar
KO Myung-Hun committed
283
BINS-$(NOT_MSVS)           += $(addprefix $(BUILD_PFX),$(ALL_EXAMPLES:.c=$(EXE_SFX)))
John Koleszar's avatar
John Koleszar committed
284 285 286 287


# Instantiate linker template for all examples.
CODEC_LIB=$(if $(CONFIG_DEBUG_LIBS),vpx_g,vpx)
288 289 290 291 292 293 294 295 296
ifneq ($(filter darwin%,$(TGT_OS)),)
SHARED_LIB_SUF=.dylib
else
ifneq ($(filter os2%,$(TGT_OS)),)
SHARED_LIB_SUF=_dll.a
else
SHARED_LIB_SUF=.so
endif
endif
jimbankoski's avatar
jimbankoski committed
297
CODEC_LIB_SUF=$(if $(CONFIG_SHARED),$(SHARED_LIB_SUF),.a)
John Koleszar's avatar
John Koleszar committed
298
$(foreach bin,$(BINS-yes),\
299 300
    $(eval $(bin):$(LIB_PATH)/lib$(CODEC_LIB)$(CODEC_LIB_SUF))\
    $(eval $(call linker_template,$(bin),\
KO Myung-Hun's avatar
KO Myung-Hun committed
301
        $(call objs,$($(notdir $(bin:$(EXE_SFX)=)).SRCS)) \
John Koleszar's avatar
John Koleszar committed
302
        -l$(CODEC_LIB) $(addprefix -l,$(CODEC_EXTRA_LIBS))\
303
        )))
John Koleszar's avatar
John Koleszar committed
304 305 306 307 308 309 310 311 312 313 314

# 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)
Jim Bankoski's avatar
Jim Bankoski committed
315
CODEC_LIB=$(if $(CONFIG_SHARED),vpx,$(if $(CONFIG_STATIC_MSVCRT),vpxmt,vpxmd))
John Koleszar's avatar
John Koleszar committed
316 317 318 319 320 321 322 323 324 325 326 327 328 329
# 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
330
$(1): $($(1:.$(VCPROJ_SFX)=).SRCS) vpx.$(VCPROJ_SFX)
331 332
	$(if $(quiet),@echo "    [vcproj] $$@")
	$(qexec)$$(GEN_VCPROJ)\
John Koleszar's avatar
John Koleszar committed
333 334
            --exe\
            --target=$$(TOOLCHAIN)\
335
            --name=$$(@:.$(VCPROJ_SFX)=)\
John Koleszar's avatar
John Koleszar committed
336
            --ver=$$(CONFIG_VS_VERSION)\
337
            --proj-guid=$$($$(@:.$(VCPROJ_SFX)=).GUID)\
338
            --src-path-bare="$(SRC_PATH_BARE)" \
John Koleszar's avatar
John Koleszar committed
339
            $$(if $$(CONFIG_STATIC_MSVCRT),--static-crt) \
340
            --out=$$@ $$(INTERNAL_CFLAGS) $$(CFLAGS) \
341
            $$(INTERNAL_LDFLAGS) $$(LDFLAGS) -l$$(CODEC_LIB) $$^
John Koleszar's avatar
John Koleszar committed
342
endef
343 344
ALL_EXAMPLES_BASENAME := $(notdir $(ALL_EXAMPLES))
PROJECTS-$(CONFIG_MSVS) += $(ALL_EXAMPLES_BASENAME:.c=.$(VCPROJ_SFX))
John Koleszar's avatar
John Koleszar committed
345
INSTALL-BINS-$(CONFIG_MSVS) += $(foreach p,$(VS_PLATFORMS),\
346
                               $(addprefix bin/$(p)/,$(ALL_EXAMPLES_BASENAME:.c=.exe)))
John Koleszar's avatar
John Koleszar committed
347 348
$(foreach proj,$(call enabled,PROJECTS),\
    $(eval $(call vcproj_template,$(proj))))
349 350 351 352 353 354

#
# Documentation Rules
#
%.dox: %.c
	@echo "    [DOXY] $@"
355
	@mkdir -p $(dir $@)
356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382
	@echo "/*!\page example_$(@F:.dox=) $(@F:.dox=)" > $@
	@echo "   \includelineno $(<F)" >> $@
	@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."\
	      "The following samples are included: ">>$@
	@$(foreach ex,$(sort $(notdir $(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. Their source is included here"\
              "for reference. The following utilities are included:" >> $@
	@$(foreach ex,$(sort $(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
examples.doxy: samples.dox $(ALL_EXAMPLES:.c=.dox)
	@echo "INPUT += $^" > $@