Facebook Surround 360 Rendering Software 环境编译 软件安装 小白实测

https://github.com/facebook/Surround360/tree/master/surround360_render

一，要求

1. Linux 或者 Mac OS X系统。我使用 Ubuntu 16.04

2. 关键依赖项：

    a. CMAKE

    b. gflags

    c. glog

    d. OpenCV 3.0+

3. 其它可选功能

    a. ffmpeg

    b. Gooey

    c. wx

二，安装依赖项

1. CMAKE

    方法一：see https://cmake.org

    方法二（仅Linux）：

  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

cmake版本查看

cmake --version

2. Git

sudo apt-get install git

3. Subversion

sudo apt install subversion

4. Python

sudo apt-get install python python-dev

5. gflags

sudo apt-get install libgflags2v5 libgflags-dev

6. glog

sudo apt-get install libgoogle-glog-dev

7. folly

see https://github.com/facebook/folly

《folly的安装》https://blog.csdn.net/dancewine/article/details/81003469

8. Ceres

see http://ceres-solver.org/installation.html

  sudo apt-get install libatlas-base-dev
  sudo apt-get install libeigen3-dev
  cd ~
  git clone https://ceres-solver.googlesource.com/ceres-solver
  cd ceres-solver
  git checkout 85c6b5c
  mkdir ceres-bin
  cd ceres-bin
  cmake ..
  make -j3
  sudo make install
  sudo ln -s /usr/include/eigen3/Eigen /usr/local/include/Eigen

9. numpy

 sudo apt-get install python-numpy

10. OpenCV

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

11. COLMAP

see https://colmap.github.io/install.html

sudo apt-get install \
    cmake \
    build-essential \
    libboost-program-options-dev \
    libboost-filesystem-dev \
    libboost-graph-dev \
    libboost-regex-dev \
    libboost-system-dev \
    libboost-test-dev \
    libeigen3-dev \
    libsuitesparse-dev \
    libfreeimage-dev \
    libgoogle-glog-dev \
    libgflags-dev \
    libglew-dev \
    qtbase5-dev \
    libqt5opengl5-dev \
    libcgal-dev \
    libcgal-qt5-dev

git clone https://github.com/colmap/colmap.git
  cd colmap
  git checkout dev
  mkdir build
  cd build
  cmake ..
  make
  sudo make install

 colmap -h
 colmap gui

12. ffmpeg

see htt

ps://trac.ffmpeg.org/wiki/CompilationGuide

https://trac.ffmpeg.org/wiki/CompilationGuide/Ubuntu

13. Gooey

    方法一： see https://github.com/chriskiehl/Gooey

    方法二：

  sudo apt-get install python-pip
  sudo pip install --upgrade pip
  sudo pip install Gooey
  sudo apt-get install python-wxgtk2.8

If python-wxgtk2.8 not available (e.g. Ubuntu 16.04):

  echo "deb http://archive.ubuntu.com/ubuntu wily main universe" | sudo tee /etc/apt/sources.list.d/wily-copies.list
  sudo apt update
  sudo apt install python-wxgtk2.8
  sudo rm /etc/apt/sources.list.d/wily-copies.list
  sudo apt update

我是先安了

GTK+-2.0，https://askubuntu.com/questions/765526/how-to-install-gtk2-0

GTK+-3.0，https://blog.csdn.net/singleyellow/article/details/74628428

然后在wxPython网站中安装wxPython4 https://wxpython.org/pages/downloads/

pip install -U \
    -f https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-16.04 \
    wxPython

然后安装Gooey

git clone https://github.com/chriskiehl/Gooey.git
cd Gooey
python setup.py install

14. PIL 

sudo apt-get install python-pil

15. extra dependencies

sudo apt-get install libtinfo-dev libjpeg-dev

• (to use accelerated ISP) Install LLVM

  cd ~
  svn co https://llvm.org/svn/llvm-project/llvm/branches/release_37 llvm3.7
  svn co https://llvm.org/svn/llvm-project/cfe/branches/release_37 llvm3.7/tools/clang
  cd llvm3.7
  mkdir build
  cd build
  cmake -DLLVM_ENABLE_TERMINFO=OFF -DLLVM_TARGETS_TO_BUILD="X86;ARM;NVPTX;AArch64;Mips;PowerPC" -DLLVM_ENABLE_ASSERTIONS=ON -DCMAKE_BUILD_TYPE=Release ..
  make -j8
  export LLVM_CONFIG=$HOME/llvm3.7/build/bin/llvm-config
  export CLANG=$HOME/llvm3.7/build/bin/clang

• (to use accelerated ISP) Install Halide (last known version to work from Mar 15 2017) //Halide的安装会损坏Surround360的代码。https://github.com/facebook/Surround360/issues/187
• 根据建议，在这个链接下载Halide，https://github.com/halide/Halide/tree/970f74972529bbcf59917c6f7b8dd51703e2ce83，我直接下载解压到Home文件夹内。

  cd Halide
  make -f $HOME/Halide/Makefile

三，Surround360安装

  git clone https://github.com/facebook/Surround360.git

  cd Surround360/surround360_render
  cmake -DCMAKE_BUILD_TYPE=Release
  make

安装时遇到了类似这个问题：

https://stackoverflow.com/questions/50888726/unable-to-build-surround360-render-cmake-issue

并按照里面的回答的方式解决。

 

Halide的安装会损坏Surround360的代码，原本有一段安装Halid在surround360_render目录下的程序，不再执行。

https://github.com/facebook/Surround360/issues/187

测试Surround360环境编译是否成功

./bin/TestRenderStereoPanorama --help

后续测试请看：

step2 render https://blog.csdn.net/dancewine/article/details/81026885