ParaViewWeb Source Configure and Build
Introduction
This document describes the process of configuring and building ParaView from source.
Useful information can always be found on the ParaView homepage.
Required Tools
The CMake cross-platform, open-source build system.
CMake binaries and source code are available here: CMake Releases.
Many Linux style distributions include CMake in their package management systems.
Git
The ParaView source code is hosted in a git repository. It can also be obtained in archived format. If you intend to edit the source code and submit patches/features, you will need git.
Linux
Git is usually available through the package management systems. You can also build from the source code found Here.
Windows
Install msysgit
Obtaining source code
Zip/Tar file
With Git
Further information is provided at the ParaView/Git Wiki.
##Configure with CMake
Create a build directory - The preferred structure when building ParaView is to separate your source code from your build directory.
####Linux users:
- In a terminal cd to your build_dir.
- Run
ccmake path/to/source-code
that opens a curses dialog - Press ‘c’ to configure. Configuration needs to occur until issues are resolved and CMake presents the option to generate ‘g’.
####Windows users:
- Open cmake-gui.
- Select your compiler.
- Fill in the path to your source code and build directories in the appropriate boxes.
- Click the configure button. Configuration needs to occur until issues are resolved and CMake presents the generate button.
From this point forward, the process between Linux and Windows is basically the same. The following options provide minor deviations from the default configuration and are sufficient to build ParaView for the web.
CMake option | Recommended value | Comment |
---|---|---|
BUILD_TESTING | OFF | While the testing code is very useful, it can take a long time to compile. Users looking for a shorter build time can disable the testing code by setting this option to OFF. |
CMAKE_BUILD_TYPE | Release | Options include Debug, Release and RelWithDebInfo. |
PARAVIEW_BUILD_QT_GUI | OFF | Used to build the Qt user interface. Web developers can safely set this option to OFF. Setting to ON will require a build of Qt 4.8, which is out of the scope of this document. |
PARAVIEW_ENABLE_CATALYST | OFF | |
PARAVIEW_ENABLE_PYTHON | ON | Builds ParaView’s python bindings. You will need python 2.7 binaries and header files (devel packages )installed for this option. |
PARAVIEW_BUILD_WEB_DOCUMENTATION | ON (Advanced) | To build ParaView’s Web Documentation. Requires jsduck. |
PLUGIN_* | OFF | Turn off plugins - If not required, it can be helpful to turn off plugins you do not need. |
CMake Configure
Build using your compiler.