Facebook Surround 360 环境配置指南（3D立体全景）

FaceBook 开源的surround360系统，3D沉浸式全景VR。

开源的软件系统配置在文档里有记录，这里看到该博主做了测试，转载后参照博主文章做测试，关于文章转载如有不妥之处，请联系本文。

----python2.7 配置PyQt5----

安装好Qt之后，下一步要安装的是SIP，SIP也是安装PyQt的必备组件，我安装的是sip-4.17，下载地址https://www.riverbankcomputing.com/software/sip/download 。将下载好的sip的压缩包解压到你的电脑里，打开解压后的文件，你会在里边发现一个doc 文件夹，这个文件夹就是sip文档，里边有详细的不同平台下的安装教程，ubuntu14.04LTS下，只需要简单的三个步骤。

$python configure.py
$make
$sudo make install

安装完SIP之后就是PyQt的安装了，同样下载PyQt5安装包，下载地址https://www.riverbankcomputing.com/software/pyqt/download5
下载之后与sip一样，解压后在解压包中寻找doc文档，里边有详细的安装教程，类似的三个命令

$python configure.py --qmake /path/to/you/Qt/5.5/gcc_64/bin/qmake
$make
$sudo make install

python2.7+PyQt5: http://blog.csdn.net/healthy_coder/article/details/50370316

原文：http://blog.csdn.net/sunyolanda_cs/article/details/52448399

参考资料：https://code.facebook.com/posts/265413023819735/surround-360-is-now-open-source/

---------------------------------------------------------------------------------------------------------------------------------

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 有问题可留言或邮件：sunyolanda@163.com