Makefile

#!/usr/bin/make -f

# ============================================================================
#                              mexopencv Makefile
# ============================================================================
#
# The following configuration parameters are recognized:
#
# WITH_OCTAVE           If set, enables Octave mode as opposed to MATLAB. The
#                       mode determines the default values of MATLAB/Octave
#                       programs. Not set by default, which implies MATLAB.
# MATLABDIR             MATLAB/Octave root directory.
# MATLAB                MATLAB/Octave executable.
# MEX                   MATLAB/Octave MEX compiler frontend.
# MEXEXT                MATLAB/Octave extension of MEX-files.
# PKG_CONFIG_CV_HACK    If set, attempts to fix the output of pkg-config with
#                       OpenCV. Not set by default (no hack).
# PKG_CONFIG_OPENCV     Name of OpenCV 3 pkg-config package. Default opencv.
# CXXFLAGS              Extra flags passed to the C++ MEX compiler.
# LDFLAGS               Extra flags passed to the linker by the compiler.
# WITH_CONTRIB          If set, enables opencv_contrib modules in addition
#                       to main opencv modules.
#
# The above settings can be defined as shell environment variables and/or
# specified on the command line as arguments to make:
#
#    export VAR=value
#    make VAR=value
#
# The following targets are available:
#
# all      Builds mexopencv.
# contrib  Builds the extra modules. Needs opencv_contrib.
# clean    Deletes temporary and generated files.
# doc      Generates source documentation using Doxygen.
# test     Run MATLAB unit-tests.
# testci   Similar to test, runs in batches (intended for CI).
#
# Note that the Makefile uses pkg-config to locate OpenCV, so you need to have
# the opencv.pc file accessible from the PKG_CONFIG_PATH environment variable.
#
# Required OpenCV version: >= 3.0.0
#
# ============================================================================

# programs
ifdef WITH_OCTAVE
MATLABDIR ?= /usr
MEX       ?= $(MATLABDIR)/bin/mkoctfile --mex
MATLAB    ?= $(MATLABDIR)/bin/octave-cli --no-gui --no-window-system --no-init-file --quiet
else
MATLABDIR ?= /usr/local/matlab
MEX       ?= $(MATLABDIR)/bin/mex
MATLAB    ?= $(MATLABDIR)/bin/matlab -nodesktop -nodisplay -noFigureWindows -nosplash
endif

# file extensions
OBJEXT ?= o
LIBEXT ?= a
ifdef WITH_OCTAVE
MEXEXT ?= mex
else
MEXEXT ?= $(shell $(MATLABDIR)/bin/mexext)
endif
ifeq ($(MEXEXT),)
    $(error "MEX extension not set")
endif

# options
PKG_CONFIG_OPENCV ?= opencv
ifneq (,$(findstring contrib,$(MAKECMDGOALS)))
WITH_CONTRIB       = true
endif

# OpenCV flags
ifneq ($(shell pkg-config --exists --atleast-version=3 $(PKG_CONFIG_OPENCV); echo $$?), 0)
    $(error "OpenCV 3 package was not found in pkg-config search path")
endif
CV_CFLAGS  := $(shell pkg-config --cflags $(PKG_CONFIG_OPENCV))
CV_LDFLAGS := $(shell pkg-config --libs $(PKG_CONFIG_OPENCV))
ifdef PKG_CONFIG_CV_HACK
LIB_SUFFIX := %.so %.dylib %.a %.la %.dll.a %.dll
CV_LDFLAGS := $(filter-out $(LIB_SUFFIX),$(CV_LDFLAGS)) \
              $(addprefix -L, \
                  $(sort $(dir $(filter $(LIB_SUFFIX),$(CV_LDFLAGS))))) \
              $(patsubst lib%, -l%, \
                  $(basename $(notdir $(filter $(LIB_SUFFIX),$(CV_LDFLAGS)))))
endif

# compiler/linker flags
ifdef WITH_OCTAVE
# -flto
# -fdata-sections -ffunction-sections -Wl,--gc-sections
# -Wl,--version-script=mexFunction.map
MX_CFLAGS  := -O2 -s -fpermissive
else
MX_CFLAGS  := -largeArrayDims -cxx
endif
MX_CFLAGS  += -Iinclude
ifdef WITH_CONTRIB
MX_CFLAGS  += -Iopencv_contrib/include
endif
MX_LDFLAGS := -Llib -lMxArray
override CXXFLAGS := $(MX_CFLAGS) $(CV_CFLAGS) $(CXXFLAGS)
override LDFLAGS  := $(MX_LDFLAGS) $(CV_LDFLAGS) $(LDFLAGS)

# mexopencv files and targets
HEADERS  := $(wildcard include/*.hpp)
SRCS0    := $(wildcard src/*.cpp)
ifdef WITH_CONTRIB
HEADERS  += $(wildcard opencv_contrib/include/*.hpp)
SRCS0    += $(wildcard opencv_contrib/src/*.cpp)
endif
SRCS1    := $(wildcard src/+cv/*.cpp) \
            $(wildcard src/+cv/private/*.cpp) \
            $(wildcard src/+cv/+test/private/*.cpp)
SRCS2    := $(wildcard opencv_contrib/src/+cv/*.cpp) \
            $(wildcard opencv_contrib/src/+cv/private/*.cpp)
OBJECTS0 := $(subst src,lib,$(SRCS0:.cpp=.$(OBJEXT)))
TARGETS0 := lib/libMxArray.$(LIBEXT)
TARGETS1 := $(subst src/+cv,+cv,$(SRCS1:.cpp=.$(MEXEXT)))
TARGETS2 := $(subst opencv_contrib/src/+cv,opencv_contrib/+cv,$(SRCS2:.cpp=.$(MEXEXT)))

# search path for prerequisites of pattern rules
# Note that VPATH/vpath are designed to find sources, not targets!
# (http://make.mad-scientist.net/papers/how-not-to-use-vpath/)
vpath %.cpp src
vpath %.cpp src/+cv
vpath %.cpp src/+cv/private
vpath %.cpp src/+cv/+test/private
ifdef WITH_CONTRIB
vpath %.cpp opencv_contrib/src
vpath %.cpp opencv_contrib/src/+cv
vpath %.cpp opencv_contrib/src/+cv/private
endif

# special targets
.PHONY: all contrib clean doc test testci
.SUFFIXES: .cpp .$(OBJEXT) .$(LIBEXT) .$(MEXEXT)

# main targets
all: $(TARGETS1)
contrib: $(TARGETS2)

# MxArray objects
lib/%.$(OBJEXT) \
opencv_contrib/lib/%.$(OBJEXT) \
: %.cpp $(HEADERS)
ifdef WITH_OCTAVE
	$(MEX) -c $(CXXFLAGS) -o $@ $<
else
	$(MEX) -c $(CXXFLAGS) -outdir $(dir $@) $<
endif

# MxArray library
$(TARGETS0): $(OBJECTS0)
	$(AR) -crs $@ $^

# MEX-files
+cv/%.$(MEXEXT) \
+cv/private/%.$(MEXEXT) \
+cv/+test/private/%.$(MEXEXT) \
opencv_contrib/+cv/%.$(MEXEXT) \
opencv_contrib/+cv/private/%.$(MEXEXT) \
: %.cpp $(TARGETS0)
ifdef WITH_OCTAVE
	$(MEX) $(CXXFLAGS) -o ${@:.$(MEXEXT)=} $< $(LDFLAGS) && \
        $(RM) ./$(notdir $(<:.cpp=.$(OBJEXT)))
else
	$(MEX) $(CXXFLAGS) -output ${@:.$(MEXEXT)=} $< $(LDFLAGS)
endif

# other targets
clean:
	$(RM) -r \
        *.$(OBJEXT) \
        lib/*.$(LIBEXT) lib/*.$(OBJEXT) \
        +cv/*.$(MEXEXT) \
        +cv/private/*.$(MEXEXT) \
        +cv/+test/private/*.$(MEXEXT) \
        opencv_contrib/lib/*.$(OBJEXT) \
        opencv_contrib/+cv/*.$(MEXEXT) \
        opencv_contrib/+cv/private/*.$(MEXEXT)

doc:
	doxygen Doxyfile

# test targets
ifdef WITH_CONTRIB
TEST_CONTRIB := true
else
TEST_CONTRIB := false
endif
TEST_CMD := \
	args = {'ContribModules',$(TEST_CONTRIB), 'Verbosity',2}; \
	letter = getenv('CI_TEST_LETTER'); if ~isempty(letter), \
	args = {args{:}, 'MatchPattern',['^Test' letter], 'XUnitFile','', \
	'LogFile',sprintf('UnitTest_%s.log', letter)}; end, \
	cvsetup(args{2}); [~,pass] = UnitTest(args{:}); exit(~pass);
ALPHABET := A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

testci:
ifdef WITH_OCTAVE
	cd .ci && for letter in $(ALPHABET); do \
		CI_TEST_LETTER=$$letter $(MATLAB) --eval "$(TEST_CMD)" || exit $$?; \
	done
else
	cd .ci && for letter in $(ALPHABET); do \
		CI_TEST_LETTER=$$letter $(MATLAB) -r "$(TEST_CMD)" || exit $$?; \
	done
endif

test:
ifdef WITH_OCTAVE
	cd .ci && $(MATLAB) --eval "$(TEST_CMD)"
else
	cd .ci && $(MATLAB) -r "$(TEST_CMD)"
endif