Linux

Install dependencies using your package manager. Here's a handy list of dependencies for several distributions:

# Ubuntu >= 14.04 (and probably other debian-based distributions)
sudo apt-get install git g++ cmake qt5-default python-docutils

# Mint
sudo apt-get install git g++ cmake qt5-default libqt5opengl5-dev python-docutils

# Older ubuntu (qt4 based - add cmake flag -DDISPLAZ_USE_QT4=TRUE)
sudo apt-get install git g++ cmake libqt4-dev libqt4-opengl-dev python-docutils

# Fedora 23
sudo yum install git gcc-c++ make patch cmake qt5-qtbase-devel python-docutils

# OpenSuse
sudo zypper install git gcc-c++ libqt5-qtbase-devel glu-devel python-docutils

The following commands may be used to build displaz on linux:

# Get the source code
git clone https://github.com/c42f/displaz.git
cd displaz

# Build LASlib and ilmbase
mkdir build_external
cd build_external
cmake ../thirdparty/external
make -j4
cd ..

# Build displaz
mkdir build
cd build
cmake ..
make -j4

# Install into CMAKE_INSTALL_PREFIX=/usr/local
sudo make install

Troubleshooting:

• Some people have had issues with a version of qt in their path clashing with the qt headers installed on the system. This may give an error such as "undefined reference to qt_version_tag", or some other qt library-related link error. For example having the qt version distributed with the python package system conda has been known to cause issues, which can be solved by unloading it from the path before calling the make steps in the script above.

Windows x64

The windows releases are built using cmake and Visual Studio. To install the dependencies on windows, manually download and install the following tools:

• cmake
• msysgit
• qt5 (ensure you get the correct version for your compiler)
• nsis (only required for installable package creation)

To build, first clone the repository using the msysgit command line:

# Get the source code
git clone https://github.com/c42f/displaz.git

You can build displaz with various supported cmake build system generators. For the continuous integration build (and probably future releases), the Visual Studio generator "Visual Studio 14 Win64" is used:

rem Build LASlib and ilmbase
mkdir build_external
cd build_external
cmake -G "Visual Studio 14 Win64" -D CMAKE_BUILD_TYPE=Release ..\thirdparty\external
cmake --build . --config Release
cd ..

rem Build displaz.
rem Assumes that Qt has been installed into C:\Qt\Qt5.5.1\5.5\msvc2015_64
mkdir build
cd build
cmake -G "Visual Studio 14 Win64" ^
    -D CMAKE_PREFIX_PATH=C:\Qt\Qt5.5.1\5.5\msvc2015_64 ^
    -D CMAKE_INSTALL_PREFIX:PATH=dist ^
    ..
cmake --build . --config Release

rem Optionally, create the installer package
cmake --build . --config Release --target package

Some of the cmake generators such as NMake Makefiles" won't find visual studio unless it's in the path. In that case you'd need to launch the steps above from the x64 cross tools command prompt.

OSX

TODO - for the moment see the generic build instructions below. Also note that displaz is regularly built on OSX via travis-CI, so the commands in the file .travis.yml in the repository should more or less work.

Generic build

To build displaz, install the following tools:

• cmake >= 2.8.8
• Python docutils (optional - required to build the html documentation)

Displaz also depends on several libraries. For simplicity, the smaller dependencies are bundled in the thirdparty directory. There's also an automated download/build system for some of the larger ones (LASlib and ilmbase) available at thirdparty/external/CMakeLists.txt. However, you will need to install the following manually:

• Qt >= 5.0 (qt-4.8 is still semi-supported on linux)
• OpenGL >= 3.2
• ilmbase >= 1.0.1 (You don't need to install this if you're using the automated thirdparty build)

Both the LASlib and IlmBase libraries may be built using the separate third party build system in thirdparty/external/CMakeLists.txt.

Build options

To read the .las and .laz file formats, you'll need one of the following:

• LASlib >= something-recent (known to work with 150406). This is the default because it's reasonably fast and has no additional library dependencies.
• PDAL >= something-recent (known to work with 0.1.0-3668-gff73c08). You may select PDAL by setting the build option DISPLAZ_USE_PDAL=TRUE. Note that building PDAL also requires several libraries including boost, laszip and GDAL.

If you only want to read ply files (for example, to use the scripting language bindings), and don't care about las you may set the build option DISPLAZ_USE_LAS=FALSE.