ProtonectSR: Make initial implementation of streamer-recorder.

@PyrApple:
  - first implementation of the real-time streamer:
    send kinect image via UDP socket to third party
    (e.g. to use in python).

    ## ONLY DEPTH FRAME SENT FOR NOW ##

    added example Blender (BGE) scene applying
    received image to object texture.

  - first implementation of the frame recorder:
    record kinect captured images to disk
    + time stamp for video creation.

  - ProtonectSR standalone toolbox creation: moved all code related
    to streamer and recorder to ./tools directory, reset of all
    changes made to other parts of the original libfreenect code.

  - ProtonectSR standalone toolbox creation:
    finished reset of original libfreenect code.

@smokhov:
  - Remove .keep files, per @xlz.

  - [streamer] move .cpp our of include

  - [streamer][recorder] primarily copy-edited headers to match better
    project conventions; move data members to private sections

  - [docs] arrange include better with a comment

  - [sockets] add necessary include

  - [recorder] format better with project's coding conventions

Author: PyrApple

tools/streamer_recorder/CMakeLists.txt

@@ -0,0 +1,105 @@
+CMAKE_MINIMUM_REQUIRED(VERSION 2.8.12.1)
+
+if(WIN32 AND NOT MINGW)
+  if(NOT DEFINED CMAKE_DEBUG_POSTFIX)
+    set(CMAKE_DEBUG_POSTFIX "d")
+  endif()
+endif()
+
+IF(NOT DEFINED CMAKE_BUILD_TYPE)
+  # No effect for multi-configuration generators (e.g. for Visual Studio)
+  SET(CMAKE_BUILD_TYPE RelWithDebInfo CACHE STRING "Choose: RelWithDebInfo Release Debug MinSizeRel None")
+ENDIF()
+
+PROJECT(libfreenect2_tools_SR)
+
+SET(MY_DIR ${libfreenect2_tools_SR_SOURCE_DIR})
+SET(DEPENDS_DIR "${MY_DIR}/../../depends" CACHE STRING "Dependency directory")
+
+OPTION(ENABLE_OPENGL "Enable OpenGL support" ON)
+
+# The example build system is standalone and will work out-of-tree with these files copied
+SET(freenect2_ROOT_DIR ${MY_DIR}/../..)
+SET(flextGL_SOURCES ${freenect2_ROOT_DIR}/src/flextGL.cpp)
+SET(flextGL_INCLUDE_DIRS ${freenect2_ROOT_DIR}/src) # for flextGL.h
+SET(tools_SR_INCLUDE_DIRS ${MY_DIR}/include) # for local include
+SET(example_INCLUDE_DIRS ${freenect2_ROOT_DIR}/examples) # for protonect viewer
+
+
+FIND_PACKAGE(PkgConfig)    # try find PKGConfig as it will be used if found
+LIST(APPEND CMAKE_MODULE_PATH ${freenect2_ROOT_DIR}/cmake_modules) # FindGLFW3.cmake
+
+IF(TARGET freenect2)
+  MESSAGE(STATUS "Using in-tree freenect2 target")
+  SET(freenect2_LIBRARIES freenect2)
+  SET(freenect2_DLLS ${LIBFREENECT2_DLLS})
+ELSE()
+  FIND_PACKAGE(freenect2 REQUIRED)
+  # Out-of-tree build will have to have DLLs manually copied.
+ENDIF()
+
+INCLUDE_DIRECTORIES(
+  ${freenect2_INCLUDE_DIR}
+)
+
+SET(ProtonectSR_src
+  ProtonectSR.cpp
+)
+
+SET(ProtonectSR_LIBRARIES
+  ${freenect2_LIBRARIES}
+)
+
+SET(ProtonectSR_DLLS
+  ${freenect2_DLLS}
+)
+
+IF(ENABLE_OPENGL)
+  FIND_PACKAGE(GLFW3)
+  FIND_PACKAGE(OpenGL)
+  IF(GLFW3_FOUND AND OPENGL_FOUND)
+    INCLUDE_DIRECTORIES(
+      ${GLFW3_INCLUDE_DIRS}
+      ${flextGL_INCLUDE_DIRS}
+      ${tools_SR_INCLUDE_DIRS}
+      ${example_INCLUDE_DIRS}
+    )
+
+    LIST(APPEND ProtonectSR_DLLS ${GLFW3_DLL})
+    LIST(APPEND ProtonectSR_src
+      ${example_INCLUDE_DIRS}/viewer.cpp
+      ${tools_SR_INCLUDE_DIRS}/PracticalSocket.cpp
+      ${tools_SR_INCLUDE_DIRS}/streamer.cpp
+      ${tools_SR_INCLUDE_DIRS}/recorder.cpp
+      ${flextGL_SOURCES}
+    )
+    LIST(APPEND ProtonectSR_LIBRARIES
+      ${GLFW3_LIBRARIES}
+      ${OPENGL_gl_LIBRARY}
+    )
+    ADD_DEFINITIONS(-DEXAMPLES_WITH_OPENGL_SUPPORT=1)
+  ENDIF()
+ENDIF(ENABLE_OPENGL)
+
+ADD_EXECUTABLE(ProtonectSR
+  ${ProtonectSR_src}
+)
+
+TARGET_LINK_LIBRARIES(ProtonectSR
+  ${ProtonectSR_LIBRARIES}
+)
+
+IF(WIN32)
+  INSTALL(TARGETS ProtonectSR DESTINATION bin)
+  LIST(REMOVE_DUPLICATES ProtonectSR_DLLS)
+  FOREACH(FILEI ${ProtonectSR_DLLS})
+    ADD_CUSTOM_COMMAND(TARGET ProtonectSR POST_BUILD
+      COMMAND ${CMAKE_COMMAND} -E copy_if_different ${FILEI} $<TARGET_FILE_DIR:ProtonectSR>
+    )
+  ENDFOREACH(FILEI)
+  INSTALL(FILES ${ProtonectSR_DLLS} DESTINATION bin)
+ENDIF()
+
+# Add OpenCV package dependency for udp-image-streaming
+find_package( OpenCV REQUIRED )
+target_link_libraries( ProtonectSR ${OpenCV_LIBS} )