Added osgText::String implementation to better handle decoding of encoded text.

include/osgText/String

@@ -0,0 +1,75 @@
+/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2003 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 OSGTEXT_STRING
+#define OSGTEXT_STRING 1
+
+#include <osg/Referenced>
+#include <osgText/Export>
+
+#include <vector>
+#include <set>
+#include <string>
+
+namespace osgText {
+
+class Text;
+
+class OSGTEXT_EXPORT String : public osg::Referenced, public std::vector<unsigned int>
+{
+public:
+
+    String() {}
+    String(const String& str);
+    virtual ~String() {} // public temporily while osgText is still in flux.
+
+    String& operator = (const String& str);
+
+    void set(const std::string& str);
+
+    /** Set the text using a wchar_t string, 
+      * which is converted to an internal TextString.*/
+    void set(const wchar_t* text);
+
+    /**
+     * Types of string encodings supported
+     */
+    enum Encoding
+    {
+        ENCODING_UNDEFINED,                 /// not using Unicode
+        ENCODING_ASCII = ENCODING_UNDEFINED,/// unsigned char ASCII
+        ENCODING_UTF8,                      /// 8-bit unicode transformation format
+        ENCODING_UTF16,                     /// 16-bit signature
+        ENCODING_UTF16_BE,                  /// 16-bit big-endian
+        ENCODING_UTF16_LE,                  /// 16-bit little-endian
+        ENCODING_UTF32,                     /// 32-bit signature
+        ENCODING_UTF32_BE,                  /// 32-bit big-endian
+        ENCODING_UTF32_LE,                  /// 32-bit little-endian
+        ENCODING_SIGNATURE                  /// detect encoding from signature
+    };
+
+    /** Set the text using a Unicode encoded std::string, which is converted to an internal TextString.
+      * The encoding parameter specificies which Unicode encodeding is used in the std::string. */
+    void set(const std::string& text,Encoding encoding);
+
+    /** returns a UTF8 encoded version of this osgText::String.*/
+    std::string createUTF8EncodedString() const;
+
+protected:
+
+};
+
+}
+
+
+#endif