prevent outright fail on Linux systems

.gitignore

@@ -16,4 +16,5 @@ build/*
 config.log
 config.status
 .DS_Store
-*~
+*~
+/_build*

CMakeLists.txt

@@ -5,25 +5,29 @@ cmake_minimum_required(VERSION 2.8)
 
 #set(CMAKE_VERBOSE_MAKEFILE true)
 
-# Default values for options
-if(NOT DEFINED OpenCV_PREFIX)
-  set(OpenCV_PREFIX ${CMAKE_INSTALL_PREFIX})
-endif()
-
 # Configurable options
 OPTION(WITH_GUI "Build the GUI" OFF)
 
+
 # Third party libraries
-find_package(OpenCV REQUIRED core highgui imgproc objdetect
-  PATHS ${OpenCV_PREFIX}/lib/cmake/
-        ${OpenCV_PREFIX}/share/OpenCV/
-  NO_DEFAULT_PATH) # For some reason CMake uses its defaults before the above paths.
+find_package(OpenCV REQUIRED core highgui imgproc objdetect)
 
 IF(APPLE)
-find_library(FOUNDATION Foundation)
-SET(EXTRA_LIBS ${FOUNDATION})
+  find_library(FOUNDATION Foundation)
+  SET(EXTRA_LIBS ${FOUNDATION})
 ENDIF()
 
+IF(UNIX AND NOT APPLE)
+  FIND_PROGRAM(HAVE_GNUSTEP NAMES gnustep-config)
+  IF(HAVE_GNUSTEP)
+    SET(WITH_GUI "Build the GUI" ON)
+    MESSAGE(STATUS "Found GnuStep")
+  ELSE(HAVE_GNUSTEP)
+    MESSAGE(STATUS "Cannot find GnuStep")
+  ENDIF(HAVE_GNUSTEP)
+ENDIF(UNIX AND NOT APPLE)
+
+
 # Third party programs
 if(NOT DEFINED FFMPEG)
   find_program(FFMPEG ffmpeg)
@@ -46,23 +50,28 @@ endif()
 SET(CMAKE_BUILD_TYPE Release CACHE STRING "")
 
 # - flags
-SET(CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS} -g -O0  -Wall -Wextra -DDEBUG")
-SET(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS} -O0 -g  -Wall -Wextra -DDEBUG")
+if(NOT WIN32)
+    SET(CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS} -g -O0  -Wall -Wextra -DDEBUG")
+    SET(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS} -O0 -g  -Wall -Wextra -DDEBUG")
 
-SET(CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS} -O3  -Wall -Wextra")
-SET(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS} -Wall -O3  -Wextra")
+    SET(CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS} -O3  -Wall -Wextra")
+    SET(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS} -Wall -O3  -Wextra")
+endif()
 
 SET(LIBS ${OpenCV_LIBS} ${EXTRA_LIBS})
+INCLUDE_DIRECTORIES(${OpenCV_INCLUDE_DIRS})
 
 # Build paths
 SET(CMAKE_LIBRARY_OUTPUT_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/lib")
-#SET(CMAKE_ARCHIVE_OUTPUT_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/lib")
+SET(CMAKE_ARCHIVE_OUTPUT_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/lib")
 SET(CMAKE_RUNTIME_OUTPUT_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/bin")
 
 # Include directories
 INCLUDE_DIRECTORIES("src/")
 INCLUDE_DIRECTORIES("src/avatar/")
 INCLUDE_DIRECTORIES("${CMAKE_CURRENT_BINARY_DIR}/src/")
+INCLUDE_DIRECTORIES(OpenCV_INCLUDE_DIRS)
+
 
 # Subdirectories with CMakeLists.txt
 ADD_SUBDIRECTORY(src/utils)
@@ -79,6 +88,9 @@ ADD_SUBDIRECTORY(src/display-tracking)
 ADD_SUBDIRECTORY(src/create-avatar-model)
 ADD_SUBDIRECTORY(src/display-3d-points)
 
+# install(EXPORT CSIRO DESTINATION ${CMAKE_INSTALL_PREFIX})
+install(FILES src/CSIROConfig.cmake DESTINATION "${CMAKE_INSTALL_PREFIX}")
+
 IF(WITH_GUI)
   SET(CPACK_PACKAGE_NAME "clm")
   SET(CPACK_PACKAGE_VENDOR "CI2CV-CSIRO ci2cv.net")
@@ -91,7 +103,9 @@ IF(WITH_GUI)
   SET(CPACK_BINARY_PACKAGEMAKER OFF)
   SET(CPACK_SOURCE_TGZ OFF)
   ADD_SUBDIRECTORY(src/qt-gui)
+  MESSAGE(STATUS "Will build the GUI")
+else()
+  MESSAGE(STATUS "Missing GUI components - will NOT build the GUI")
 endif()
 
 #cpack stuff goes here
-

INSTALL.md

@@ -0,0 +1,39 @@
+Make sure you have Bash, Cmake, Git, FFmpeg and OpenCV installed.
+
+If you're on Ubuntu, this should be enough:
+
+```sh
+    # this installs a prebuilt opencv with python bindings along with some other tools
+    sudo apt-get install -y \
+      git \
+      pkg-config \
+      build-essential \
+      cmake \
+      libopencv-dev \
+      python-opencv \
+      ffmpeg
+```
+
+Otherwise check:
+
+* http://milq.github.io/install-opencv-ubuntu-debian/
+* http://docs.opencv.org/2.4/doc/tutorials/introduction/linux_install/linux_install.html
+* http://askubuntu.com/questions/432542/is-ffmpeg-missing-from-the-official-repositories-in-14-04
+* https://help.ubuntu.com/community/OpenCV
+
+After you have all the dependencies, the build is simple:
+
+```sh
+# assuming you installed from libopencv-dev in ubuntu/debian
+# if not, look for the directory that contains OpenCVConfig.cmake
+path_to_opencv=$(dpkg --listfiles libopencv-dev | grep --max-count=1 'OpenCVConfig.cmake$')
+
+git clone https://github.com/MatrixAI/face-analysis-sdk
+pushd face-analysis-sdk
+    mkdir -p build
+    pushd build
+        cmake -DOpenCV_DIR="$path_to_opencv" -DFFMPEG=$(which ffmpeg) -DBASH=$(which bash) ..
+        make
+    popd
+popd
+```

README.md

@@ -0,0 +1,32 @@
+Welcome to the CSIRO Face Analysis SDK. Documentation for the SDK can
+be found in doc/documentation.html.
+
+All code in this SDK is provided according to the license found in
+LICENSE.
+
+If you use the CSIRO Face Analysis SDK in any publications, we ask
+that you reference our works.
+
+The face tracking component is based on the publication: 
+J. Saragih, S. Lucey and J. Cohn, "Deformable Model Fitting by
+Regularized Landmark Mean-Shift", IJCV 2011.
+
+The expression transfer component is based on the publication:
+J. Saragih, S. Lucey and J. Cohn, "Real-time Avatar Animation from a
+Single Image", AFGR Workshop 2011.
+
+If you use the SDK, we ask that you reference the following paper:
+M. Cox, J. Nuevo, J. Saragih and S. Lucey, "CSIRO Face Analysis SDK",
+AFGR 2013.
+
+---
+
+Here are the updates in the original code included in this fork of the project:
+
+- The dependency of Qt in the qt-gui project was upgraded from Qt4 to Qt5.
+- Some OpenCV missing includes were added (perhaps they are due to changes in version used).
+- The type casts were made explicit to remove related warning messages.
+- Some static array allocations were replaced with the operator `new[]`.
+- The Windows/POSIX-specific function calls were enclosed in `#ifdefs` based on the operating system defined at compilation time, and the the best corresponding functions were used for Windows (for instance: `PathRemoveFileSpec` and `PathStripPath` respectively replaced `dirname` and `basename` in Windows).
+- The class `ForkRunner` was completely replaced in Windows by the implementation proposed by Ben Howell [here](http://www.benhowell.net/guide/2015/03/16/porting-face-analysis-sdk-to-windows/). Although, [there is no direct equivalent of `fork` (used by the original class) on Windows](http://stackoverflow.com/a/9148072/2896619) and [`CreateProcess` does not have the same behaviour](http://stackoverflow.com/q/985281/2896619) (further tests required).
+- The libraries `utilities`, `clmTracker` and `avatarAnim`, that were originally created as shared libraries, were transformed into static libraries only for the Windows configuration. This was just simpler to do at this time, because the use of the `__declspec(dllexport)` directive (to export the functions/classes to be usable through a DLL) was causing problems related to third part objects not being equally exported (for instance, in some classes/functions, the compiler was producing messages like: "warning C4251: class 'cv::Mat' needs to have dll-interface to be used by clients of class <the class in which cv::Mat was used>").

src/CSIROConfig.cmake

@@ -0,0 +1,2 @@
+set(CSIRO_INCLUDE_DIRS "${CMAKE_CURRENT_LIST_DIR}/include")
+include("${CMAKE_CURRENT_LIST_DIR}/CSIRO.cmake")

src/avatar/CMakeLists.txt

@@ -8,5 +8,15 @@ CONFIGURE_FILE("Config.h.in" "Config.h")
 
 SET(AVATAR_FILES "Avatar.cpp" "myAvatar.cpp")
 
-ADD_LIBRARY(avatarAnim SHARED ${AVATAR_FILES})
-TARGET_LINK_LIBRARIES(avatarAnim ${LIBS} utilities clmTracker)
+if(WIN32)
+    set(LIBTYPE STATIC)
+else()
+    set(LIBTYPE SHARED)
+endif()
+
+ADD_LIBRARY(avatarAnim ${LIBTYPE} ${AVATAR_FILES})
+set_target_properties(avatarAnim PROPERTIES DEBUG_POSTFIX "d")
+TARGET_LINK_LIBRARIES(avatarAnim ${LIBS} utilities clmTracker)
+
+install(TARGETS avatarAnim EXPORT CSIRO DESTINATION lib)
+install(FILES Avatar.hpp IO.hpp DESTINATION include/avatar)