Home

Building the OpenSG browser plugin

Dependences

The utilities required to build the browser plugin are:

  • moc-qt4

  • g++

  • make

  • svn (for development version)

Libraries required to run/build the Browser plugin are:

Installation

You need to install the plugin into the plugin directory of your
browser. This can either be done via the browser plugin installation methods, or adjust the install target to install it to the correct place. At runtime it needs to be able to access all of the libraries it has dynamically linked against, or it needs to be statically linked.

To debug the plugin, on Linux you can launch your browser from the command line, where the out messages from it will be displayed, including any problems it has starting up.

Installation is the usual configure/make/make install which is used on UNIX systems.

./autogen (if svn version)
./configure --prefix=/usr
make
make install (as root per your system install options)
cp /usr/lib/lib3dviewer.so.0.0.0 /path/to/plugin/dir/of/your/browser/lib3dviewer.so (as root)

Known Issues

1

The plugin doesn't run on the following Ubuntu systems (The Kbuntu derivative is fine):
Ubutnu 8.10
Ubuntu 9.04

It has been reported as a bug on Ubuntu. https://bugs.launchpad.net/ubuntu/+source/qt4-x11/+bug/389441

2

You are currently unable to load multiple models or close the tab without the browser crashing. This is due to the underlying library OpenSG not currently closing cleanly.