This page descibes how to build the simage library for Coin 3D.

[!NOTE] Magic Lantern currently uses version 1.8.0 of the simage library. Instructions for building this version may be found at simage 1.8.0 Build Instructions for Linux.

Table of Contents

• simage Build Instructions
  • Building from mle-simage Github Project
  • Build from tar package

---

simage Build Instructions

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

• Build from simage Github project sponsored by Wizzer Works (https://github.com/coin3d/mle-simage).
• Build from the original source code tar package distribution.

The first approach is strongly recommended 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 modifications made to work with the Magic Lantern Inventor and Rehearsal Player targets.

Building from mle-simage Github Project

The build instructions for utilizing the WizzerWorks sponsored code base can be found at https://github.com/coin3d/mle-simage/wiki/Coin3D-simage-Build-Instructions-for-Linux.

Building from tar Package

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

The simage package can be downloaded from the Github account: https://github.com/coin3d/mle-simage/releases. The package is simage-1.7.0.tar.gz.

Dependencies

simage has the following dependencies:

TBD

Unpack the tar File

Do the following to extract the source:

tar -xvzf simage-1.7.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 simage-build
cd simage-build
../simage-1.7.0/configure --enable-html --enable-man

Build the simage Library

Build the simage library, libsimage.so:

make

Install the simage Library

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

make install

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