Compiling for Linux

In the following instructions, $ and # indicate to enter command at a command prompt, as either a normal user or as an administrator. Do not type the $ or # when entering the commands. Commands to enter into the command line, or code snippets, are listed in a fixed width font

If there are any problems or flaws with the instructions, please contact the author.

Installing dependencies

Automatic dependancy retrieval

An experimental script "getDeps" is supplied in the packaging/deps/ folder. Run this script to automatically detect your platform and download and install the required dependencies. This has been developed (but is not extensively tested) under Linux and OSX.

Alternately, use the following instructions:

Debian and derivatives

Debian Linux and its derivatives (Linux Mint, Ubuntu, etc), can use the following procedure. To build 3Depict, you need to install the following packages:

• build-essential
• libwxgtk3.0-dev
• libmgl-dev
• libxml2-dev
• libftgl-dev
• libqhull-dev
• libvigraimpex-dev

Optionally you can also enable volume rendering if you have libvd available. This is done by passing --enable-libvd to configure. Run ./configure --help to see all options - you can (for example) enable/disable debug, parallel and s-hull modes using these flags. This can be done through the command line (below), or using the gui (synaptic package manager). Most of these can be installed automatically using "apt-get build-dep 3depict", if 3depict is available in your repository

$ sudo apt-get build-dep 3depict

Fedora/RedHat:

• "Development Tools"  group package
• mathgl-devel
• libxml2-devel
• ftgl-devel
• wxgtk-devel
• qhull-devel
• vigra-devel

This can be done through either the command line, or through the GUI

$ dnf groupinstall "Development Tools"
$ dnf install mathgl-devel libxml2-devel ftgl-devel wxgtk-devel qhull-devel vigra-devel

OpenSuse:

These instructions may be slightly out of date

• wxGTK-devel
• libxml2-devel
• ftgl-devel
• qhull-devel
• vigra-devel
• mathgl-devel

Optionally you can also enable volume rendering if you have libvd available, which is not at this time available from repositories. This can be done either through the graphical interface (YaST) or at the command line.

    $ zypper install -t devel_C_C++
    $ zypper install wxGTK-devel libxml2-devel ftgl-devel qhull-devel vigra-devel mathgl-devel

Compiling

To compile 3Depict, ensure you have installed all the required dependencies (above), then use the following commands in the 3Depict/ directory:

    $ ./configure

Optionally, you may use --enable-openmp-parallel or --disable-debug-checks to enable parallelism or disable debug checks respectively.
    $ make
to build 3depict.

Once built, you can install the program with: make install

Compiling under eclipse

Although not officially supported, some users report being able to compile 3Depict under the eclipse IDE. It is a bit tricky however, and you probably need to set some build flags.