OSGUIsh

OSGUIsh is a library that generates GUI-like events for nodes in a scene graph. So, a programmer can install callbacks that are executed when the mouse moves over a node, or when it is clicked, or double-clicked, or the mouse wheel moves, or... you got the idea.

Some OSGUIsh features are:

• Support for the following events: "mouse enter", "mouse leave", "mouse move", "mouse down", "mouse up", "click", "double click", "mouse wheel up", "mouse wheel down", "key up" and "key down"
• Supports differents policies to determine which node gets mouse wheel and keyboard events.
• Can help struggling with problems related to picking when using multiple osg::CameraNodes. This is particularly useful when using HUDs.

Assorted facts about OSGUIsh

• is currently in alpha stage, at best. "Release early", they say... (I can't promisse anything about the "release often" part, though.)
• works only when using an osgProducer::Viewer to view the scene. This may change in the future, but currently that's the way it's done.
• is somewhat documented, but there is no user's guide yet. Take a look on the demos on the source distribution for some working examples.
• was tested only under Linux with GCC 3.4.x, but should be reasonably portable.
• depends on the Open Scene Graph and Boost.
• has a build system based on SCons. A makefile for GNU/Linux systems with g++ is provided for convenience. Also, I suppose it is not hard to compile it with other build systems.
• is distributed under the OSGPL (the same license as the Open Scene Graph).
• has one of the worst names I could think.

Latest version

Latest version is 0.2, released on 02006-10-20. It can be downloaded here: OSGUIsh-0.2.tar.gz. Changes from previous version:

• Added a new picking scheme, with multiple "picking roots". Can be used to fix problems with picking with multiple CameraNodes. That's the case when using HUDs, for example.
• Added an option to ignore back faces when picking.
• Event handlers now take all their parameters as a single (struct) parameter. This will make the interface a little more stable, at least until I decide to make more radical changes to it.
• Added a quick and dirty Makefile for Linux systems using g++, just for convenience. The official build system is still based on SCons. This makefile will just compile the library (not the demos).
• Assorted code clean-ups, bug fixes, typo corrections and documentation improvements. (But still missing a user's guide.)

Old versions

Version is 0.1, the first public release, dated 02006-09-27: OSGUIsh-0.1.tar.gz.

Contact

OSGUIsh is developed by Leandro Motta Barros. Direct your inquiries to

   lmb@sta
         c
         k   es.or
         edbox   g