opencv/modules/matlab/CMakeLists.txt

# ----------------------------------------------------------------------------
#  CMake file for Matlab/Octave support
#
#  Matlab code generation and compilation is broken down into two distinct
#  stages: configure time and build time. The idea is that we want to give
#  the user reasonable guarantees that once they type 'make', wrapper
#  generation is unlikely to fail. Therefore we run a series of tests at
#  configure time to check the working status of the core components.
#
#  Configure Time
#  During configure time, the script attempts to ascertain whether the
#  generator and mex compiler are working for a given architecture.
#  Currently this involves:
#   1) Generating a simple CV_EXPORTS_W symbol and checking whether a file
#      of the symbol name is generated
#   2) Compiling a simple mex gateway to check that Bridge.hpp and mex.h
#      can be found, and that a file with the mexext is produced
#
#  Build Time
#  If the configure time tests pass, then we assume Matlab wrapper generation
#  will not fail during build time. We simply glob all of the symbols in
#  the OpenCV module headers, generate intermediate .cpp files, then compile
#  them with mex.
# ----------------------------------------------------------------------------

# PREPEND
# Given a list of strings IN and a TOKEN, prepend the token to each string
# and append to OUT. This is used for passing command line "-I", "-L" and "-l"
# arguments to mex. e.g.
# prepend("-I" OUT /path/to/include/dir) --> -I/path/to/include/dir
macro(PREPEND TOKEN OUT IN)
    foreach(VAR ${IN})
        list(APPEND ${OUT} "${TOKEN}${VAR}")
    endforeach()
endmacro()

# make sure we're on a supported architecture with Matlab and python installed
if (IOS OR ANDROID OR NOT MATLAB_FOUND OR NOT PYTHONLIBS_FOUND)
    ocv_module_disable(matlab)
    return()
endif()

# TODO: matlab bindings should depend on python (maybe)
set(the_description "The Matlab/Octave bindings")
ocv_add_module(matlab   BINDINGS opencv_core #TODO: does it actually NEED to depend on core?
                        OPTIONAL opencv_objdetect opencv_features2d opencv_video
                                 opencv_highgui opencv_ml opencv_calib3d opencv_photo
                                 opencv_nonfree opencv_calib opencv_imgproc)

# TODO: Undo this when building all modules to find python properly
#set(HDR_PARSER_PATH ${OPENCV_MODULE_opencv_python_LOCATION}/src2)
set(HDR_PARSER_PATH ${CMAKE_CURRENT_SOURCE_DIR}/../python/src2)
prepend("-I" MEX_INCLUDES ${CMAKE_CURRENT_SOURCE_DIR}/include)

if (BUILD_TESTS)
    add_subdirectory(test)
endif()

# ----------------------------------------------------------------------------
#  Configure time components
# ----------------------------------------------------------------------------
message("-- Trying to generate Matlab code")
execute_process(
    COMMAND ${PYTHON_EXECUTABLE} 
            ${CMAKE_CURRENT_SOURCE_DIR}/generator/gen_matlab_caller.py ${HDR_PARSER_PATH}
            ${CMAKE_CURRENT_SOURCE_DIR}/test/test_generator.hpp ${CMAKE_CURRENT_BINARY_DIR}
    ERROR_VARIABLE GEN_ERROR
    OUTPUT_QUIET 
)

if (GEN_ERROR)
    message(${GEN_ERROR})
    message("-- Error generating Matlab code. Disabling Matlab bindings...")
    return()
else()
    message("-- Trying to generate Matlab code - OK")
endif()

# attempt to compile the file using mex
message("-- Trying to compile mex file")
execute_process(
    COMMAND ${MATLAB_MEX_SCRIPT} ${MEX_INCLUDES} 
            ${CMAKE_CURRENT_SOURCE_DIR}/test/test_compiler.cpp
    WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/src
    ERROR_VARIABLE MEX_ERROR
    OUTPUT_QUIET
)

if (MEX_ERROR)
    message(${MEX_ERROR})
    message("-- Error compiling mex file. Disabling Matlab bindings...")
    return()
else()
    message("-- Trying to compile mex file - OK")
endif()

# if we make it here, mex works!
set_property(GLOBAL PROPERTY MEX_WORKS TRUE)

# ----------------------------------------------------------------------------
#  Build time components
# ----------------------------------------------------------------------------
string(REPLACE "opencv_" "" OPENCV_MATLAB_MODULES "${OPENCV_MODULE_${the_module}_REQ_DEPS};
                                                   ${OPENCV_MODULE_${the_module}_OPT_DEPS}")
foreach(module ${OPENCV_MATLAB_MODULES})
    if (HAVE_opencv_${module})
        list(APPEND opencv_hdrs "${OPENCV_MODULE_opencv_${module}_LOCATION}/include/opencv2/${module}.hpp")
    endif()
endforeach()

# synthesise the matlab sources
add_custom_target(opencv_matlab_sources
    COMMAND ${PYTHON_EXECUTABLE} 
            ${CMAKE_CURRENT_SOURCE_DIR}/generator/gen_matlab_caller.py ${HDR_PARSER_PATH}
            ${opencv_hdrs} ${CMAKE_CURRENT_BINARY_DIR}
)

# compile the matlab sources to mex
add_custom_target(opencv_matlab ALL DEPENDS opencv_matlab_sources)
file(GLOB SOURCE_FILES "${CMAKE_CURRENT_BINARY_DIR}/src/*.cpp")
foreach(SOURCE_FILE ${SOURCE_FILES})
  get_filename_component(FILENAME ${SOURCE_FILE} NAME_WE)
  # compile the source file using mex
  add_custom_command(TARGET opencv_matlab PRE_BUILD
      COMMAND echo ${MATLAB_MEX_SCRIPT} ${MEX_INCLUDES}
              ${SOURCE_FILE}
      WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/src
  )
endforeach()

# ----------------------------------------------------------------------------
#  Install time components
# ----------------------------------------------------------------------------