Facebook Surround 360 环境配置指南

Surround 360 是一套VR软硬件系统，用来捕捉和渲染3D立体的360度全景视频及图片。下载地址：https://github.com/facebook/Surround360。

• 系统要求：linux或Mac，本说明为linux系统操作步骤，在ubuntu 14.04和16.04 版本64位虚拟机系统上测试成功。
• 项目环境依赖4个： CMake / gflags / glog / OpenCV 3.0+
• 附加依赖3个： ffmpeg / Gooey / wx

1. Install CMake
CMake是一个跨平台的安装（编译）工具，可以用简单的语句来描述所有平台的安装(编译过程)。他能够输出各种各样的makefile或者project文件，能测试编译器所支持的C++特性,类似UNIX下的automake。

sudo apt-get install software-properties-common
sudo apt-get update
sudo apt-get install cmake && sudo apt-get upgrade cmake

2. Install Git & Python

sudo apt-get install git
sudo apt-get install python

3. Install gflags
google开源的gflags是一套命令行参数解析工具，比getopt功能更强大，使用起来更加方便，gflags还支持从环境变量、配置文件读取参数。

sudo apt-get install libgflags2v5 libgflags-dev

4. Install glog
Google glog是一个基于程序级记录日志信息的c++库，编程使用方式与c++的stream操作类似。

sudo apt-get install libgoogle-glog-dev

5. Install opencv

git clone https://github.com/Itseez/opencv.git
cd opencv
git checkout tags/3.1.0
cmake -DWITH_IPP=OFF
make
sudo make install

6. Install ffmpeg
安装教程https://trac.ffmpeg.org/wiki/CompilationGuide
获得依赖项

sudo apt-get update
sudo apt-get -y install autoconf automake build-essential libass-dev libfreetype6-dev libsdl1.2-dev libtheora-dev libtool libva-dev libvdpau-dev libvorbis-dev libxcb1-dev libxcb-shm0-dev libxcb-xfixes0-dev pkg-config texinfo zlib1g-dev
mkdir ~/ffmpeg_sources

安装yasm

sudo apt-get install yasm

ffmpeg有许多依赖包,需要依次安装6个：libx264/libx265/libfdk-aac /libmp3lame/libopus/libvpx，其中3个可直接使用apt-get安装，其余需下载安装。

• libx264

sudo apt-get install libx264-dev

• libx265

sudo apt-get install cmake mercurial
cd ~/ffmpeg_sources
hg clone https://bitbucket.org/multicoreware/x265
cd ~/ffmpeg_sources/x265/build/linux
PATH="$HOME/bin:$PATH" cmake -G "Unix Makefiles" -DCMAKE_INSTALL_PREFIX="$HOME/ffmpeg_build" -DENABLE_SHARED:bool=off ../../source
make
make install
make distclean

• libfdk-aac

cd ~/ffmpeg_sources
wget -O fdk-aac.tar.gz https://github.com/mstorsjo/fdk-aac/tarball/master
tar xzvf fdk-aac.tar.gz
cd mstorsjo-fdk-aac*
autoreconf -fiv
./configure --prefix="$HOME/ffmpeg_build" --disable-shared
make
make install
make distclean

• libmp3lame

sudo apt-get install libmp3lame-dev

• libopus

sudo apt-get install libopus-dev

• libvpx

cd ~/ffmpeg_sources
wget http://storage.googleapis.com/downloads.webmproject.org/releases/webm/libvpx-1.5.0.tar.bz2
tar xjvf libvpx-1.5.0.tar.bz2
cd libvpx-1.5.0
PATH="$HOME/bin:$PATH" ./configure --prefix="$HOME/ffmpeg_build" --disable-examples --disable-unit-tests
PATH="$HOME/bin:$PATH" make
make install
make clean

安装ffmpeg

cd ~/ffmpeg_sources
wget http://ffmpeg.org/releases/ffmpeg-snapshot.tar.bz2
tar xjvf ffmpeg-snapshot.tar.bz2
cd ffmpeg
PATH="$HOME/bin:$PATH" PKG_CONFIG_PATH="$HOME/ffmpeg_build/lib/pkgconfig" ./configure  --prefix="$HOME/ffmpeg_build" --pkg-config-flags="--static" --extra-cflags="-I$HOME/ffmpeg_build/include" --extra-ldflags="-L$HOME/ffmpeg_build/lib" bindir="$HOME/bin" --enable-gpl --enable-libass --enable-libfdk-aac --enable-libfreetype --enable-libmp3lame --enable-libopus --enable-libtheora --enable-libvorbis --enable-libvpx --enable-libx264 --enable-libx265 --enable-nonfree
PATH="$HOME/bin:$PATH" make
make install
make distclean
hash –r

7. Gooey & wx
安装wx

sudo apt-get install python-wxtools

安装gooey

sudo apt-get install python-pip
sudo pip install --upgrade pip
sudo pip install Gooey

8. surround360
若make报错缺少c++config.h文件，在make前需要先安装gcc和g++。

cd <install path>/surround360/surround360_render
cmake -DCMAKE_BUILD_TYPE=Release
sudo apt-get install gcc-multilib g++-multilib
make

检测编译是否成功

./bin/TestRenderStereoPanorama --help 

9.surround 360 运行指南
如上配置好环境后，可参考另一篇博客运行surround 360
http://blog.csdn.net/sunyolanda_cs/article/details/52448606

作者：sunyolanda 有问题可留言或邮件：[e-mail]