This repository contains source code for Capoc, an OpenGL/wxWindows application for immersive visualization and angle/distance measurements within 3D point clouds and meshes.
Capoc was specifically developed for visualizing caves and research on 3D models of tectonic features (so-called Digital Outcrop Models) sourced by the means of Structure from Motion. As such, the program also can load and visualize NVM files and includes features for aligning the 3D data with ground control points. After alignment, dip and strike measurements can be readily performed manually on the model cross sections (tomography) or through optimal plane fitting to fragments of the point cloud.
A reference guide is not available yet, however we do have an online tutorial: http://pliki.jaszczur.org/.capoc/
Capoc works on both Microsoft Windows and Linux platforms.
Binaries not requiring an installation are provided for 32-bit and 64-bit Windows; see links at the beginning of the tutorial
For building under Linux, the following steps should be generally sufficient. Please install wxWidgets development packages beforehand and make sure you have a working OpenGL installation on your system. We did not test the
git clone https://github.com/mteg/capoc
cd capoc
cmake .
make
This code is released under Apache License version 2.0.
Most of Capoc code was adapted from an earlier C project, and thus would benefit from a more C++ oriented refactoring. It is conceptually separated into few loosely connected parts:
- capEngine and accompanying classes (capModel, capNvm, capNvmCam, capCli, capCliThread) load, represent and process 3D models and NVM files.
- capRender_AncientGL (implementing an abstract class capRenderer) - draws point clouds, meshes and NVM files using legacy OpenGL (display lists, glVertex3f and similar)
- wxCapoc_* classes implement a rudimentary GUI on top of the wxWidgets library and specifically wxGLCanvas class
- utility classes (capServer, capCli, tcpServer)
capEngine provides two interfaces for the GUI part, namely a scripting command and native C++ interface, through which it receives commands from the GUI module. It does not make any assumptions on the GUI toolkit in use.
Most of the functions are invoked with scripting commands, by calling capEngine::execStringf(). These commands take the form of short, one line keyword combinations, such as camera retreat or model 0 nvm camera P8192012.JPG reproject throw-cursor.
The native interface is used rarely. Its purpose is to serve timing sensitive operations (such as setting view angles selection of 3D points with mouse - capEngine::mouseAction), as well as for character-set sensitive operations (i.e. opening files with Unicode characters - for example capEngine::loadModel or capModel::saveSelection
The capRenderer_AncientGL class accesses capModel/capNvm public properties to visualize the mesh and the NVM file. It would be advisable to refactor this into modern OpenGL with vertex buffers and shaders. This is a standalone task, since other parts of code do not make any assumptions on the 3D graphics toolkit in use.
These classes are the youngest and probably cleanest native C++. The first version of Capoc implemented a simplistic but somewhat confusing keyboard shortcut interface over the FreeGLUT toolkit. This has subsequently been rewritten into modern wxWidgets with menus, tree for browsing the loaded models and NVM photographs etc. However not all functions available from capEngine were implemented in the GUI - control over artificial shading and lighting being one of the examples. A scripting console is provided for advanced users to access these features before they are implemented in further versions of the GUI
- capAffineMatrix implements rudimentary affine matrix operations (such as inverting 3D affine matrices or constructing transformation matrices for basic geometric operations)
- capCli is a C++ wrap up of a former C code for building command line interfaces on embedded systems. Capoc uses it to implement the scripting interface.
Capoc uses:
- img.c from Survex for reading Survex 3D files https://survex.com/
- ply_io.c by Greg Turk https://people.sc.fsu.edu/~jburkardt/c_src/ply_io/ply_io.html
- Nanojpeg from Martin Fiedler https://keyj.emphy.de/nanojpeg/
- LodePNG from Lode Vandevenne https://lodev.org/lodepng/
- Commonly used SVD code from svdecomp.c in XLISP-STAT 2.1 (from Numerical Recipes, adapted by Luke Tierney and David Betz)
Within our own code, we also implement a canonical algorithm for registering 3D meshes using singular value decomposition by Besl and McKay (https://ieeexplore.ieee.org/document/121791).
- Mateusz Golicz github.com/mteg authored the code
- Jacek Szczygieł provided conceptual guidance, especially for the research features