Documentation

osgPlugins

There are 45 plugins in the core OpenSceneGraph distribution, and these provide the support for reading and writing both native and 3rd party file formats, details of these are below. Other plugins are available in the Community Plugins section.

Invoking a plugin to load or save data

The OpenSceneGraph database plugin library osgDB automatically loads plugins on demand, using the extension of the file being loaded/saved to determine which plugin to load.

For example,

> osgviewer cow.osg

loads the osgdb_osg plugin to read a .osg file, while

> osgviewer model.flt

loads the osgdb_flt plugin to read a .flt file.

If the plugin supports more than one extension, it may be necessary to pre-load the plugin before loading the file by using the standard osgViewer '-e ext' option:

> osgviewer -e lwo model.lw

loads the osgdb_lwo plugin to read a .lw file.

When programming use the follow API to read a file:

#include <osgDB/ReadFile>

osg::ref_ptr<Node> node = osgDB::readNodeFile("cow.osg");
osg::ref_ptr<Image> image = osgDB::readImageFile("lz.rgb");

Or, to write a file:

#include <osgDB/WriteFile>
osgDB::writeNodeFile(*node, "saved.osg");

The loading of the necessary plugins by osgDB is transparent and in practice you shouldn't have to do anything special to load a certain file type. The only factors to keep in mind are that OSG needs to support the file format (as determined by the file's extension) and that you should have compiled the necessary plugin.

List of available 3d database plugins

List of available movie & image plugins

List of available archive/networking plugins

List of available font plugins

List of available pseudo loader plugins

• Prev
• Next