Views and Viewers

Basic Description

There is a history and rationale behind the osgViewer library. This page is meant to describe how to use the current Viewers and Views.

When choosing an OpenSceneGraph provided Viewer, one has two choices: Viewer or CompositeViewer. Both are derived off of osgViewer::ViewerBase. ViewerBase provides functionality such as controlling stats, threading, and frame calls.

Views themselves can contain multiple Cameras. Among other things, Views control a Scene, DisplaySettings, Event Handlers, and Camera Manipulators.

osgViewer::Viewer along with being a ViewerBase is also a View. This simplifies the setup and interface if one is interested in a single view.

osgViewer::CompositeViewer, in contrast with Viewer, actually contains a list of multiple Views. This gives more versatility to the programmer but with more work to access View functionality.

Which Viewer to Use

So which Viewer class is right for your app? This is discussed in detail on this page.

Event and Pick Handling

TODO: This is just a stub.