FACEBOOK SURROUND360 源码解析 第一篇 源码环境搭建

surround360开源项目介绍：
surround360项目是一个综合软件和硬件的系统。该系统能够完成图像采集，并且对采集图像进行拼接得到360度的全景图像或者全景视频，同时也可以传输到VR设备中。下面给出两张图片，让大家对该项目有个直观的了解。


源码下载链接：https://github.com/facebook/Surround360
上面的链接主要给出了源码，除了源码之外还需要下载facebook提供的数据，该数据在下载链接页面的Sample Data中，下载Raw data即可，raw data给出了一些原始的图像，另外下面也给除了Sample data，该数据是经过处理的全景图。
开源代码中该项目被分为三个部分
/surround360_design –该模块主要描述了系统的硬件描述和装配过程
/surround360_camera_ctrl – 该模块描述了控制相机采集图像的软件
/surround360_render – 该模块给出了通过采集的图像获取全景图的软件
本文主要针对第三个模块，即 surround360_render进行调试工作。
下面开始环境搭建：
（1）系统需求
ubuntu 14.04LTS（CMake>=CMake 3.2.2）：该系统是facebook用于surround360代码的平台，在该平台下经过博主确认可以正确运行并得到结果，下面将介绍基于ubuntu的软件安装流程。哦对了，该软件同时在OS X 10.11.5（CMake 3.5.1）上运行过–来自facebook。
（2）基本环境
必备： Cmake
gflags
glog
OpenCV 3.0+
可选功能依赖：
ffmpeg
Gooey
wx
（3）开始安装
(a)安装CMake
需要管理员权限
sudo apt-get install software-properties-common
sudo add-apt-repository ppa:george-edison55/cmake-3.x
sudo apt-get update
sudo apt-get install cmake && sudo apt-get upgrade cmake
(b)安装git
安装git可以用来下载opencv 3+，不过博主未使用该方法安装opencv，博主按照facebook的文档安装opencv的时候一直没有成功，因此建议按照后面的流程单独安装opencv，不过仍然给出命令先。
sudo apt-get install git
安装python
python是用来跑源代码中的脚本文件的，这个后面会有介绍。安装python命令如下。
sudo apt-get install python
(c)安装gflags
google的命令行处理参数库
安装命令：sudo apt-get install libgflags2 libgflags-dev
(d)安装glog
google的日志工具
安装命令：sudo apt-get install libgoogle-glog-dev
(e)安装OpenCV
在opencv 的过程中博主参考了Rodrigo Berriel的文章，链接如下：http://rodrigoberriel.com/2014/10/installing-opencv-3-0-0-on-ubuntu-14-04/
下面博主将安装opencv 的流程提炼如下：
第一步：安装依赖文件
请在终端输入如下命令：
sudo apt-get -y install libopencv-dev build-essential cmake git libgtk2.0-dev pkg-config python-dev python-numpy libdc1394-22 libdc1394-22-dev libjpeg-dev libpng12-dev libtiff4-dev libjasper-dev libavcodec-dev libavformat-dev libswscale-dev libxine-dev libgstreamer0.10-dev libgstreamer-plugins-base0.10-dev libv4l-dev libtbb-dev libqt4-dev libfaac-dev libmp3lame-dev libopencore-amrnb-dev libopencore-amrwb-dev libtheora-dev libvorbis-dev libxvidcore-dev x264 v4l-utils unzip
第二步：下载opencv3.0+
请在终端输入如下命令：
mkdir opencv
cd opencv
wget https://github.com/Itseez/opencv/archive/3.0.0-alpha.zip -O opencv-3.0.0-alpha.zip
unzip opencv-3.0.0-alpha.zip
第三步：安装opencv
cd opencv-3.0.0-alpha
mkdir build
cd build
cmake -D CMAKE_BUILD_TYPE=RELEASE -D CMAKE_INSTALL_PREFIX=/usr/local -D WITH_TBB=ON -D WITH_V4L=ON -D WITH_QT=ON -D WITH_OPENGL=ON ..
make -j $(nproc)
sudo make install
第四步：完成安装

请在终端输入以下命令：
sudo /bin/bash -c ‘echo “/usr/local/lib” > /etc/ld.so.conf.d/opencv.conf’
sudo ldconfig
该步主要用于配置环境变量。
友情提示：安装之后系统需要重启
第五步：测试opencv是否安装成功
cd到opencv 的samples文件夹内，该文件夹内主要有opencv的一些功能的范例，运行一下命令：
sudo cmake .
sudo make -j $(nproc)
运行该命令之后进入sample/cpp，可以看生成了一些可执行文件，然后在该文件夹内运行一个可执行文件，例如：
cd cpp/
./cpp-example-facedetect lena.jpg
如果你看到了lena的图像以及她的脸被圈起来了，恭喜你，opencv已经安装成功了。
(f)安装ffmpeg
ffmpeg是一个优秀的记录、转换数字音视频，并能转化为流的开源计算机程序（来自百度百科），安装ffmpeg的过程比较繁琐，surround文档给出了一个链接，在该链接下给出了一个比较简单的安装ffmpeg 的方案，下载ffmpeg-3.1.4.tar.bz2,下载链接如下：http://ffmpeg.org/download.html#LinuxBuilds
下载后安装即可。需要说明的是：博主并未用该方法安装，这几天在写博客的过程中，无意看到了这个比较简便的方法。安装之后通过ffmpeg –-version来验证ffmpeg是否安装成功。如果大家安装出现问题，可以参考链接：https://trac.ffmpeg.org/wiki/CompilationGuide/Ubuntu
(g)安装Gooey
安装命令：sudo apt-get install python-pip
sudo pip install –upgrade pip
sudo pip install Gooey
sudo apt-get install python-wxgtk2.8
到此surround360的基本配置已经完毕。欢迎观看下一篇：源码编译，直击全景图！