Added initial cut of basic scripting support, introducing an osg::Script object to wrap up the individual scripts, osg::ScriptCallback for assigning a Script as node callback and an osg::ScriptEngine base class that plugins implement to provided support for specific scripting languages.

Provided are lua, python and V8 (for javascript) plugins that just open up enough of a link to the respective libs to run a script, there is no scene graph <-> script communication in current implementation.

include/osg/ScriptEngine

@@ -0,0 +1,108 @@
+/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2013 Robert Osfield
+ *
+ * This library is open source and may be redistributed and/or modified under
+ * the terms of the OpenSceneGraph Public License (OSGPL) version 0.0 or
+ * (at your option) any later version.  The full license is in LICENSE file
+ * included with this distribution, and on the openscenegraph.org website.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * OpenSceneGraph Public License for more details.
+*/
+
+#ifndef OSG_SCRIPTENGINE
+#define OSG_SCRIPTENGINE 1
+
+#include <osg/Object>
+#include <osg/NodeCallback>
+#include <osg/NodeVisitor>
+
+namespace osg
+{
+
+// forward declare
+class ScriptEngine;
+
+/* Script class for wrapping a script and the language used in the script.*/
+class Script : public osg::Object
+{
+    public:
+        Script():_modifiedCount(0) {}
+        Script(const std::string& language, const std::string& str): _language(language), _script(str), _modifiedCount(0)  {}
+        Script(const Script& rhs, const osg::CopyOp& copyop=osg::CopyOp::SHALLOW_COPY): _language(rhs._language), _script(rhs._script), _modifiedCount(0) {}
+
+        META_Object(osg, Script)
+
+        void setLanguage(const std::string& language) { _language = language; dirty(); }
+        const std::string& getLanguage() { return _language; }
+
+        void setScript(const std::string& str) { _script = str; dirty(); }
+        const std::string& getScript() const { return _script; }
+
+        void dirty() { ++_modifiedCount; }
+        unsigned int getModifiedCount() const { return _modifiedCount; }
+
+    protected:
+
+        virtual ~Script() {}
+
+        std::string _language;
+        std::string _script;
+        unsigned int _modifiedCount;
+};
+
+/** NodeCallback for attaching a script to a NodeCallback so that it can be called as an update or event callback.*/
+class OSG_EXPORT ScriptCallback : public osg::NodeCallback
+{
+    public:
+        ScriptCallback(Script* script=0) : _script(script) {}
+        ScriptCallback(const ScriptCallback& rhs, const osg::CopyOp& copyop=osg::CopyOp::SHALLOW_COPY): osg::NodeCallback(rhs,copyop), _script(rhs._script) {}
+
+        META_Object(osg, ScriptCallback)
+
+        /** Set the script to call.*/
+        void setScript(osg::Script* script) { _script  = script; }
+
+        /** Get the script to call.*/
+        osg::Script* getScript() { return _script.get(); }
+
+        /** Get the script to call.*/
+        const osg::Script* getScript() const { return _script.get(); }
+
+        /** find the ScriptEngine from looking at the UserDataContainers of nodes in scene graph above the ScriptCallback.*/
+        osg::ScriptEngine* getScriptEngine(osg::NodePath& nodePath);
+
+        /** NodeCallback method, calls the Script.*/
+        virtual void operator()(osg::Node* node, osg::NodeVisitor* nv);
+
+    protected:
+
+        virtual ~ScriptCallback() {}
+
+        osg::ref_ptr<Script> _script;
+};
+
+/** ScriptEngine base class for integrating different scripting languages.
+ *  Concrete ScriptEngine's are provided by osgDB::readFile<ScriptEngine> */
+class ScriptEngine : public osg::Object
+{
+    public:
+
+        /** get the scripting language supported by the ScriptEngine.*/
+        inline const std::string& getLanguage() const { return _language; }
+
+        /** run a Script.*/
+        virtual void run(osg::Script* script) = 0;
+
+    protected:
+
+        ScriptEngine(const std::string& language):_language(language) { setName(language); }
+        virtual ~ScriptEngine() {}
+
+        std::string _language;
+};
+
+}
+
+#endif