README.md

🐗 Appa

GUI for TheiaSfM multiview geometry and structure from motion library.

Implemented as a part of uladbohdan and drapegnik coursework on FAMCS, BSU and UIIP, NASB.

Supported platforms:

• macOS
• Linux
• Windows

macOS Sierra 10.12.4

ubuntu 16.04

project status:

• create new project / open project
• extract features
• build model
• visualize model
• search image on 3d model

for details, check the issues

install:

git clone https://github.com/lybros/Appa.git
git submodule update --init

dependencies:

• OpenImageIO ~ v1.7.11
• TheiaSfM ~ v0.7
• Qt ~ v5.7
• QGLViewer ~ v2.6.4
• OpenGL (seems that you already have installed it on your computer)
• cpplint (optional)
• Ninja (optional) for build, check the instruction

setup:

• set DYLD_LIBRARY_PATH environment variable to path/to/openimageio/lib
• set OPENIMAGEIO_INCLUDE_DIR environment variable path/to/openimageio/include
• set OPENIMAGEIO_LIBRARY environment variable to path/to/openimageio/lib
• set QT_CMAKE_DIR environment variable to path/to/Qt/lib/cmake/
• add path/to/openimageio/bin to $PATH
• add path/to/theiaSfM/build/bin to $PATH

usage:

• build the code
• run ./appa from build/ directory
• create new project and run BuildToBinary action
• or download and open prebuilt quarry-project and run VisualizeBinary to see the result

development:

• use LOG(INFO) from glog instead of std::cout. set GLOG_logtostderr=1 env variable to enable logging
• use bash cpplint.sh to check the accordance with style preferences