SoXt_Build_Instructions_For_Linux

This page descibes how to build the SoXt GUI for Coin 3D.

• SoXt Build Instructions
  • Building from Coin3D-SoXt Sourceforge Project
  • Building from tar Package
    • Dependencies
    • Unpack the tar File
    • Configure the Build Directory
    • Build the SoXt Library
    • Install the SoXt Library
• Viewer Example Code

---

SoXt Build Instructions

This page describes how to build the SoXt GUI library for the Ubuntu 14.04 LTS operating system. There are two approaches that may be taken:

• Build from SoXt Sourceforge project sponsored by Wizzer Works (https://sourceforge.net/projects/coin3d-soxt/).
• Build from the original source code tar package distribution.

The first approach is strongly reccomended because it is based on the tar package distribution from the last official release, prior to moving the source to the open source community. The Wizzer Works code base also contains all the modifcations made to work with the Magic Lantern Inventor and Rehearsal Player tagets.

Building from Coin3D-SoXt Sourceforge Project

The build instuctions for utilizing the WizzerWorks sponsored code base can be found at https://sourceforge.net/p/coin3d-soxt/wiki/SoXt_Build_Environment/.

Building from tar Package

These instructions focus on building the SoXt GUI library from a tar distribution package. The instructions are geared towards an Ubuntu 14.04 LTS host development platform.

The SoXt package can be downloaded from the Bitbucket account: https://bitbucket.org/Coin3D/coin/downloads. The package is SoXt-1.3.0.tar.gz.

Dependencies

SoXt has the following dependencies:

sudo apt-get install libmotif-dev libxmu-dev libxpm-dev 

Unpack the tar File

Do the following to extract the source:

tar -xvzf SoXt-1.3.0.tar.gz

Configure the Build Directory

Build the libraries and distribution elements (i.e. documentation) in a separate directory. Be sure to enable the HTML and man page generation.

mkdir soxt-build
cd soxt-build
../SoXt-1.3.0/configure --enable-html --enable-man

Build the SoXt Library

Build the SoXt library, libSoXt.so:

make

Install the SoXt Library

To install the library, header files and documentation, do the following:

make install

The library will be installed in /usr/local/lib/libSoXt.so. The header files will be installed in the /usr/local/include directory. HTML pages are populated in the /usr/local/share/doc/soxt/html directory. The manual pages are installed into /usr/local/man.

---

Viewer Example Code

The following is an example on how to use the SoXt library

  #include <Inventor/Xt/SoXt.h>
  #include <Inventor/Xt/viewers/SoXtExaminerViewer.h>
  #include <Inventor/nodes/SoBaseColor.h>
  #include <Inventor/nodes/SoCone.h>
  #include <Inventor/nodes/SoSeparator.h>

  int
  main(int argc, char ** argv)
  {
    // Initialize SoXt and Inventor API libraries. This returns a main
    // window to use.
    Widget mainwin = SoXt::init(argc, argv, argv[0]);

    // Make a dead simple scene graph, only containing a single
    // yellow cone under the scenegraph root.
    SoSeparator * root = new SoSeparator;
    root->ref();

    SoBaseColor * col = new SoBaseColor;
    col->rgb = SbColor(1, 1, 0);
    root->addChild(col);

    root->addChild(new SoCone);

    // Use one of the convenient viewer classes.
    SoXtExaminerViewer * eviewer = new SoXtExaminerViewer(mainwin);
    eviewer->setSceneGraph(root);
    eviewer->show();

    // Pop up the main window.
    SoXt::show(mainwin);
    // Loop until exit.
    SoXt::mainLoop();

    // Clean up resources.
    delete eviewer;
    root->unref();

    return 0;
  }

[Mark Millard]

Attaching an Eclipse CDT (Mars) project that builds the above example code.